From a0a0fd6b3586529ddf4418f78ec7887ccf709dba Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Mon, 16 Mar 2026 17:30:00 -0400
Subject: [PATCH 01/37] beta: vanilaa 19'

---
 package.json                                  |  24 +-
 packages/gamut-icons/package.json             |   2 +-
 packages/gamut-illustrations/package.json     |   4 +-
 packages/gamut-patterns/package.json          |   4 +-
 packages/gamut-styles/package.json            |   4 +-
 .../src/__tests__/AssetProvider.test.tsx      |  60 +++-
 .../src/__tests__/fontLoading.test.tsx        |  41 ++-
 .../src/__tests__/fontUtilsMock.ts            |   1 +
 packages/gamut-styles/src/variance/utils.ts   |   7 +-
 packages/gamut-tests/package.json             |   2 +-
 packages/gamut-tests/src/index.tsx            |   2 +-
 packages/gamut/package.json                   |   6 +-
 packages/gamut/src/Button/shared/types.ts     |   2 +-
 packages/gamut/src/Card/styles.tsx            |  16 +-
 packages/gamut/src/Coachmark/index.tsx        |   2 +-
 .../gamut/src/ConnectedForm/ConnectedForm.tsx |   8 +-
 packages/gamut/src/ConnectedForm/utils.tsx    |   2 +-
 packages/gamut/src/FeatureShimmer/index.tsx   |   6 +-
 .../Form/SelectDropdown/SelectDropdown.tsx    |  10 +-
 packages/gamut/src/GridForm/GridForm.tsx      |   2 +-
 packages/gamut/src/Pagination/utils.tsx       |  19 +-
 packages/gamut/src/Popover/types.tsx          |   4 +-
 packages/gamut/src/PopoverContainer/hooks.ts  |   4 +-
 packages/gamut/src/PopoverContainer/types.ts  |   2 +-
 packages/gamut/src/Tip/__tests__/helpers.tsx  |   2 +-
 packages/gamut/src/Tip/shared/FloatingTip.tsx |   4 +-
 packages/gamut/src/Tip/shared/types.tsx       |   4 +-
 packages/gamut/src/utils/react.ts             |   3 +-
 .../integration/__tests__/component.test.tsx  |  24 +-
 yarn.lock                                     | 317 ++++++------------
 30 files changed, 277 insertions(+), 311 deletions(-)
 create mode 100644 packages/gamut-styles/src/__tests__/fontUtilsMock.ts

diff --git a/package.json b/package.json
index 6fe9d7a80b2..48253f8864c 100644
--- a/package.json
+++ b/package.json
@@ -9,8 +9,8 @@
     "@vidstack/react": "^1.12.12",
     "core-js": "3.7.0",
     "lodash": "^4.17.23",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "react-helmet-async": "^2.0.5"
   },
   "devDependencies": {
@@ -44,18 +44,18 @@
     "@storybook/react-webpack5": "^8.6.15",
     "@storybook/theming": "^8.6.15",
     "@svgr/cli": "5.5.0",
-    "@testing-library/dom": "^8.11.1",
+    "@testing-library/dom": "^10.0.0",
     "@testing-library/jest-dom": "^5.16.1",
-    "@testing-library/react": "15.0.6",
+    "@testing-library/react": "^16.0.0",
     "@testing-library/react-hooks": "^7.0.2",
     "@testing-library/user-event": "^14.5.2",
     "@types/classnames": "2.2.10",
     "@types/invariant": "2.2.29",
     "@types/konami-code-js": "^0.8.0",
     "@types/lodash": "4.17.23",
-    "@types/react": "18.3.27",
-    "@types/react-dom": "18.3.1",
-    "@types/react-test-renderer": "18.3.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/react-test-renderer": "^19.0.0",
     "@types/stylis": "^4.2.0",
     "@typescript-eslint/eslint-plugin": "^5.15.0",
     "@typescript-eslint/parser": "^5.15.0",
@@ -84,7 +84,7 @@
     "nx-cloud": "^19.1.0",
     "onchange": "^7.0.2",
     "prettier": "^2.8.7",
-    "react-test-renderer": "18.3.1",
+    "react-test-renderer": "^19.0.0",
     "storybook": "^8.6.15",
     "storybook-addon-deep-controls": "^0.9.5",
     "style-loader": "^4.0.0",
@@ -115,10 +115,10 @@
   "resolutions": {
     "@react-aria/interactions": "3.25.0",
     "@typescript-eslint/utils": "^5.15.0",
-    "@types/react": "18.3.27",
-    "@types/react-dom": "18.3.1",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "error-ex": "1.3.4"
   },
   "scripts": {
diff --git a/packages/gamut-icons/package.json b/packages/gamut-icons/package.json
index 79e375de093..a1d5a9e7839 100644
--- a/packages/gamut-icons/package.json
+++ b/packages/gamut-icons/package.json
@@ -17,7 +17,7 @@
     "@emotion/react": "^11.4.0",
     "@emotion/styled": "^11.3.0",
     "lodash": "^4.17.23",
-    "react": "^17.0.2 || ^18.3.0"
+    "react": "^17.0.2 || ^18.3.0 || ^19.0.0"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/gamut-illustrations/package.json b/packages/gamut-illustrations/package.json
index 39360d522a2..18daa3e52c4 100644
--- a/packages/gamut-illustrations/package.json
+++ b/packages/gamut-illustrations/package.json
@@ -18,8 +18,8 @@
   "peerDependencies": {
     "@emotion/react": "^11.4.0",
     "@emotion/styled": "^11.3.0",
-    "react": "^17.0.2 || ^18.3.0",
-    "react-dom": "^17.0.2 || ^18.3.0"
+    "react": "^17.0.2 || ^18.3.0 || ^19.0.0",
+    "react-dom": "^17.0.2 || ^18.3.0 || ^19.0.0"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/gamut-patterns/package.json b/packages/gamut-patterns/package.json
index 7d142f5fdb5..8ea6df449b7 100644
--- a/packages/gamut-patterns/package.json
+++ b/packages/gamut-patterns/package.json
@@ -19,8 +19,8 @@
   "peerDependencies": {
     "@emotion/react": "^11.4.0",
     "@emotion/styled": "^11.3.0",
-    "react": "^17.0.2 || ^18.3.0",
-    "react-dom": "^17.0.2 || ^18.3.0"
+    "react": "^17.0.2 || ^18.3.0 || ^19.0.0",
+    "react-dom": "^17.0.2 || ^18.3.0 || ^19.0.0"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/gamut-styles/package.json b/packages/gamut-styles/package.json
index 2d70876244f..880d55e2c19 100644
--- a/packages/gamut-styles/package.json
+++ b/packages/gamut-styles/package.json
@@ -6,7 +6,7 @@
   "dependencies": {
     "@codecademy/variance": "0.26.0",
     "@emotion/is-prop-valid": "^1.1.0",
-    "framer-motion": "^11.18.0",
+    "framer-motion": "^12.0.0",
     "get-nonce": "^1.0.0",
     "polished": "^4.1.2"
   },
@@ -26,7 +26,7 @@
     "@emotion/react": "^11.4.0",
     "@emotion/styled": "^11.3.0",
     "lodash": "^4.17.23",
-    "react": "^17.0.2 || ^18.3.0",
+    "react": "^17.0.2 || ^18.3.0 || ^19.0.0",
     "stylis": "^4.0.7"
   },
   "publishConfig": {
diff --git a/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx b/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
index 8588c23304d..a6cd30eb764 100644
--- a/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
+++ b/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
@@ -5,11 +5,12 @@ import { render } from '@testing-library/react';
 
 import { AssetProvider, createFontLinks } from '../AssetProvider';
 import { coreTheme, percipioTheme } from '../themes';
+import { getFontsMock } from './fontUtilsMock';
 
 const renderView = setupRtl(AssetProvider, {});
 
 jest.mock('../utils/fontUtils', () => ({
-  getFonts: jest.fn(),
+  getFonts: require('./fontUtilsMock').getFontsMock,
 }));
 
 jest.mock('../remoteAssets/fonts', () => ({
@@ -43,11 +44,36 @@ jest.mock('../remoteAssets/fonts', () => ({
   },
 }));
 
-const mockGetFonts = require('../utils/fontUtils').getFonts;
+const mockGetFonts = getFontsMock;
+
+function getPreloadLinks(container: HTMLElement): NodeListOf<Element> {
+  const inContainer = container.querySelectorAll('link[rel="preload"]');
+  if (inContainer.length > 0) return inContainer;
+  return document.querySelectorAll('link[rel="preload"]');
+}
+
+const defaultFonts = [
+  {
+    filePath: 'https://www.codecademy.com/gamut/apercu-regular-pro',
+    extensions: ['woff2', 'woff'],
+    name: 'Apercu',
+  },
+  {
+    filePath: 'https://www.codecademy.com/gamut/apercu-bold-pro',
+    extensions: ['woff2', 'woff'],
+    name: 'Apercu',
+    weight: 'bold',
+  },
+];
 
 describe('AssetProvider', () => {
   beforeEach(() => {
     jest.clearAllMocks();
+    mockGetFonts.mockReturnValue(defaultFonts);
+  });
+
+  afterEach(() => {
+    mockGetFonts.mockReturnValue(defaultFonts);
   });
 
   describe('createFontLinks', () => {
@@ -66,7 +92,7 @@ describe('AssetProvider', () => {
       ];
 
       const { container } = render(<>{createFontLinks(fonts)}</>);
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
 
       expect(links).toHaveLength(1);
       expect(links[0]).toHaveAttribute(
@@ -80,13 +106,13 @@ describe('AssetProvider', () => {
 
     it('should handle empty fonts array', () => {
       const { container } = render(<>{createFontLinks([])}</>);
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(0);
     });
 
     it('should handle undefined fonts parameter', () => {
       const { container } = render(<>{createFontLinks(undefined)}</>);
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(2);
     });
 
@@ -110,7 +136,7 @@ describe('AssetProvider', () => {
       ];
 
       const { container } = render(<>{createFontLinks(fonts)}</>);
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(1);
       expect(links[0]).toHaveAttribute(
         'href',
@@ -139,7 +165,7 @@ describe('AssetProvider', () => {
       ];
 
       const { container } = render(<>{createFontLinks(fonts)}</>);
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(2);
     });
   });
@@ -155,14 +181,14 @@ describe('AssetProvider', () => {
       ]);
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
 
+      expect(mockGetFonts).toHaveBeenCalledWith('core');
       expect(links).toHaveLength(1);
       expect(links[0]).toHaveAttribute(
         'href',
         'https://www.codecademy.com/gamut/apercu-regular-pro.woff2'
       );
-      expect(mockGetFonts).toHaveBeenCalledWith('core');
     });
 
     it('should render font links for percipio theme', () => {
@@ -175,7 +201,7 @@ describe('AssetProvider', () => {
       ]);
 
       const { view } = renderView({ theme: percipioTheme as any });
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
 
       expect(links).toHaveLength(1);
       expect(links[0]).toHaveAttribute(
@@ -207,7 +233,7 @@ describe('AssetProvider', () => {
       });
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
       expect(links).toHaveLength(0);
     });
 
@@ -215,7 +241,7 @@ describe('AssetProvider', () => {
       mockGetFonts.mockReturnValue(undefined);
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
       expect(links).toHaveLength(2);
     });
 
@@ -223,7 +249,7 @@ describe('AssetProvider', () => {
       mockGetFonts.mockReturnValue(null);
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
       expect(links).toHaveLength(2);
     });
 
@@ -231,7 +257,7 @@ describe('AssetProvider', () => {
       mockGetFonts.mockReturnValue('not-an-array');
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
       expect(links).toHaveLength(0);
     });
 
@@ -255,7 +281,7 @@ describe('AssetProvider', () => {
       ]);
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
 
       expect(links).toHaveLength(3);
       expect(links[0]).toHaveAttribute(
@@ -292,7 +318,7 @@ describe('AssetProvider', () => {
       ]);
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
 
       expect(links).toHaveLength(1);
       expect(links[0]).toHaveAttribute(
@@ -321,7 +347,7 @@ describe('AssetProvider', () => {
       ]);
 
       const { view } = renderView();
-      const links = view.container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(view.container);
 
       expect(links).toHaveLength(1);
       expect(links[0]).toHaveAttribute(
diff --git a/packages/gamut-styles/src/__tests__/fontLoading.test.tsx b/packages/gamut-styles/src/__tests__/fontLoading.test.tsx
index 6a46a50c3ab..c5cbdabed2c 100644
--- a/packages/gamut-styles/src/__tests__/fontLoading.test.tsx
+++ b/packages/gamut-styles/src/__tests__/fontLoading.test.tsx
@@ -2,12 +2,12 @@ import { render } from '@testing-library/react';
 
 import { AssetProvider } from '../AssetProvider';
 import { coreTheme, percipioTheme } from '../themes';
+import { getFontsMock } from './fontUtilsMock';
 
-// Type assertion to satisfy Theme interface in GamutProvider from theme.d.ts - this lib is typed to the CoreTheme interface
 const typedPercipioTheme = percipioTheme as any;
 
 jest.mock('../utils/fontUtils', () => ({
-  getFonts: jest.fn(),
+  getFonts: require('./fontUtilsMock').getFontsMock,
 }));
 
 jest.mock('../remoteAssets/fonts', () => ({
@@ -29,7 +29,13 @@ jest.mock('../remoteAssets/fonts', () => ({
   },
 }));
 
-const mockGetFonts = require('../utils/fontUtils').getFonts;
+const mockGetFonts = getFontsMock;
+
+function getPreloadLinks(container: HTMLElement): NodeListOf<Element> {
+  const inContainer = container.querySelectorAll('link[rel="preload"]');
+  if (inContainer.length > 0) return inContainer;
+  return document.querySelectorAll('link[rel="preload"]');
+}
 
 const mockDocumentFonts = {
   load: jest.fn(),
@@ -47,14 +53,27 @@ Object.defineProperty(document, 'fonts', {
 const mockFetch = jest.fn();
 global.fetch = mockFetch;
 
+const defaultFonts = [
+  {
+    filePath: 'https://www.codecademy.com/gamut/apercu-regular-pro',
+    extensions: ['woff2', 'woff'],
+    name: 'Apercu',
+  },
+];
+
 describe('Font Loading and Error Handling', () => {
   beforeEach(() => {
     jest.clearAllMocks();
+    mockGetFonts.mockReturnValue(defaultFonts);
     mockDocumentFonts.load.mockClear();
     mockDocumentFonts.check.mockClear();
     mockFetch.mockClear();
   });
 
+  afterEach(() => {
+    mockGetFonts.mockReturnValue(defaultFonts);
+  });
+
   describe('Font Preloading', () => {
     it('should create preload links for fonts', () => {
       mockGetFonts.mockReturnValue([
@@ -67,7 +86,7 @@ describe('Font Loading and Error Handling', () => {
 
       const { container } = render(<AssetProvider theme={coreTheme} />);
 
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(1);
       expect(links[0]).toHaveAttribute(
         'href',
@@ -93,7 +112,7 @@ describe('Font Loading and Error Handling', () => {
 
       const { container } = render(<AssetProvider theme={coreTheme} />);
 
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(2);
       expect(links[0]).toHaveAttribute(
         'href',
@@ -114,8 +133,7 @@ describe('Font Loading and Error Handling', () => {
 
       const { container } = render(<AssetProvider theme={coreTheme} />);
 
-      // Should not render any links when getFonts fails
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(0);
     });
 
@@ -141,7 +159,7 @@ describe('Font Loading and Error Handling', () => {
 
       const { container } = render(<AssetProvider theme={coreTheme} />);
 
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(2);
     });
   });
@@ -163,8 +181,7 @@ describe('Font Loading and Error Handling', () => {
 
       const { container } = render(<AssetProvider theme={coreTheme} />);
 
-      // Should render preload links for all fonts
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(2);
       expect(links[0]).toHaveAttribute(
         'href',
@@ -195,7 +212,7 @@ describe('Font Loading and Error Handling', () => {
 
       const { container } = render(<AssetProvider theme={coreTheme} />);
 
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(1);
 
       Object.defineProperty(document, 'fonts', {
@@ -218,7 +235,7 @@ describe('Font Loading and Error Handling', () => {
 
       const { container } = render(<AssetProvider theme={coreTheme} />);
 
-      const links = container.querySelectorAll('link[rel="preload"]');
+      const links = getPreloadLinks(container);
       expect(links).toHaveLength(1);
 
       global.fetch = originalFetch;
diff --git a/packages/gamut-styles/src/__tests__/fontUtilsMock.ts b/packages/gamut-styles/src/__tests__/fontUtilsMock.ts
new file mode 100644
index 00000000000..22501405fc9
--- /dev/null
+++ b/packages/gamut-styles/src/__tests__/fontUtilsMock.ts
@@ -0,0 +1 @@
+export const getFontsMock = jest.fn();
diff --git a/packages/gamut-styles/src/variance/utils.ts b/packages/gamut-styles/src/variance/utils.ts
index a88b1bfb116..01a1630c1bf 100644
--- a/packages/gamut-styles/src/variance/utils.ts
+++ b/packages/gamut-styles/src/variance/utils.ts
@@ -1,3 +1,4 @@
+import type React from 'react';
 import { ThemeProps } from '@codecademy/variance';
 import isPropValid from '@emotion/is-prop-valid';
 
@@ -17,10 +18,10 @@ const validPropnames = allPropnames.filter(isPropValid);
 
 export type SystemPropNames = (typeof allPropnames)[number];
 
-export type ElementOrProps = keyof JSX.IntrinsicElements | ThemeProps;
+export type ElementOrProps = keyof React.JSX.IntrinsicElements | ThemeProps;
 export type ForwardableProps<El extends ElementOrProps, Additional> = Exclude<
-  El extends keyof JSX.IntrinsicElements
-    ? keyof JSX.IntrinsicElements[El]
+  El extends keyof React.JSX.IntrinsicElements
+    ? keyof React.JSX.IntrinsicElements[El]
     : keyof Element,
   Additional | SystemPropNames
 >;
diff --git a/packages/gamut-tests/package.json b/packages/gamut-tests/package.json
index 5b67b691ee7..b6e580a224f 100644
--- a/packages/gamut-tests/package.json
+++ b/packages/gamut-tests/package.json
@@ -22,7 +22,7 @@
   "main": "dist/index.js",
   "module": "dist/index.js",
   "peerDependencies": {
-    "react": "^17.0.2 || ^18.3.0"
+    "react": "^17.0.2 || ^18.3.0 || ^19.0.0"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/gamut-tests/src/index.tsx b/packages/gamut-tests/src/index.tsx
index 700132e1cd4..ff5d61022f6 100644
--- a/packages/gamut-tests/src/index.tsx
+++ b/packages/gamut-tests/src/index.tsx
@@ -24,7 +24,7 @@ export const MockGamutProvider: React.FC<{
   );
 };
 
-function withMockGamutProvider<Props extends JSX.IntrinsicAttributes>(
+function withMockGamutProvider<Props extends React.JSX.IntrinsicAttributes>(
   WrappedComponent: React.ComponentType<Props>
 ) {
   const WithBoundaryComponent: React.FC<Props> = (props) => (
diff --git a/packages/gamut/package.json b/packages/gamut/package.json
index dc5dac782de..1dc19f8418e 100644
--- a/packages/gamut/package.json
+++ b/packages/gamut/package.json
@@ -13,7 +13,7 @@
     "@types/marked": "^4.0.8",
     "@vidstack/react": "^1.12.12",
     "classnames": "^2.2.5",
-    "framer-motion": "^11.18.0",
+    "framer-motion": "^12.0.0",
     "html-to-react": "^1.6.0",
     "invariant": "^2.2.4",
     "lodash": "^4.17.23",
@@ -40,8 +40,8 @@
   "peerDependencies": {
     "@emotion/react": "^11.4.0",
     "@emotion/styled": "^11.3.0",
-    "react": "^17.0.2 || ^18.3.0",
-    "react-dom": "^17.0.2 || ^18.3.0"
+    "react": "^17.0.2 || ^18.3.0 || ^19.0.0",
+    "react-dom": "^17.0.2 || ^18.3.0 || ^19.0.0"
   },
   "publishConfig": {
     "access": "public"
diff --git a/packages/gamut/src/Button/shared/types.ts b/packages/gamut/src/Button/shared/types.ts
index 02c84d4e278..053ccd9615b 100644
--- a/packages/gamut/src/Button/shared/types.ts
+++ b/packages/gamut/src/Button/shared/types.ts
@@ -23,7 +23,7 @@ export type ButtonProps = ButtonBaseProps & ComponentProps<typeof ButtonBase>;
 
 export type InlineIconButtonProps<
   BaseButtonType extends
-    | keyof JSX.IntrinsicElements
+    | keyof React.JSX.IntrinsicElements
     | React.JSXElementConstructor<any>
 > = ComponentProps<BaseButtonType> &
   Partial<IconComponentType> & {
diff --git a/packages/gamut/src/Card/styles.tsx b/packages/gamut/src/Card/styles.tsx
index 1a080095ea7..aa64aab6a30 100644
--- a/packages/gamut/src/Card/styles.tsx
+++ b/packages/gamut/src/Card/styles.tsx
@@ -49,14 +49,14 @@ export const patternFadeInOut = {
     opacity: 1,
     transition: {
       duration: timingValues.medium / 1000,
-      ease: 'easeOut',
+      ease: 'easeOut' as const,
     },
   },
   animate: {
     opacity: 0,
     transition: {
       duration: timingValues.medium / 1000,
-      ease: 'easeIn',
+      ease: 'easeIn' as const,
     },
   },
 };
@@ -67,7 +67,7 @@ export const hoverShadowLeft = (borderRadius?: string) => ({
     borderRadius,
     transition: {
       duration: timingValues.fast / 1000,
-      ease: 'easeOut',
+      ease: 'easeOut' as const,
     },
   },
   initialOutline: {
@@ -75,7 +75,7 @@ export const hoverShadowLeft = (borderRadius?: string) => ({
     borderRadius,
     transition: {
       duration: timingValues.fast / 1000,
-      ease: 'easeOut',
+      ease: 'easeOut' as const,
     },
   },
   animate: {
@@ -84,7 +84,7 @@ export const hoverShadowLeft = (borderRadius?: string) => ({
     borderRadius,
     transition: {
       duration: timingValues.fast / 1000,
-      ease: 'easeIn',
+      ease: 'easeIn' as const,
     },
   },
   animateOutline: {
@@ -93,7 +93,7 @@ export const hoverShadowLeft = (borderRadius?: string) => ({
     borderRadius,
     transition: {
       duration: timingValues.fast / 1000,
-      ease: 'easeIn',
+      ease: 'easeIn' as const,
     },
   },
 });
@@ -104,7 +104,7 @@ export const hoverShadowRight = (borderRadius?: string) => ({
     borderRadius,
     transition: {
       duration: timingValues.fast / 1000,
-      ease: 'easeOut',
+      ease: 'easeOut' as const,
     },
   },
   animate: {
@@ -113,7 +113,7 @@ export const hoverShadowRight = (borderRadius?: string) => ({
     borderRadius,
     transition: {
       duration: timingValues.fast / 1000,
-      ease: 'easeIn',
+      ease: 'easeIn' as const,
     },
   },
 });
diff --git a/packages/gamut/src/Coachmark/index.tsx b/packages/gamut/src/Coachmark/index.tsx
index a4316f6fde3..999c3c0a119 100644
--- a/packages/gamut/src/Coachmark/index.tsx
+++ b/packages/gamut/src/Coachmark/index.tsx
@@ -30,7 +30,7 @@ export type CoachmarkProps = PopoverFocusProps & {
   /**
    * Function that returns the contents of the coachmark.
    */
-  renderPopover: (onDismiss?: () => void) => JSX.Element;
+  renderPopover: (onDismiss?: () => void) => React.JSX.Element;
   /**
    * Props to be passed into the popover component.
    */
diff --git a/packages/gamut/src/ConnectedForm/ConnectedForm.tsx b/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
index 95575145d48..1525284e29b 100644
--- a/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
+++ b/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
@@ -181,7 +181,7 @@ export const ConnectedForm = forwardRef(
       </PropsProvider>
     );
   }
-) as <Values extends FormValues<Values>>(
-  props: ConnectedFormProps<Values>,
-  ref: React.ForwardedRef<HTMLFormElement>
-) => React.ReactElement;
+) as React.ForwardRefExoticComponent<
+  ConnectedFormProps<FormValues<Record<string, unknown>>> &
+    React.RefAttributes<HTMLFormElement>
+>;
diff --git a/packages/gamut/src/ConnectedForm/utils.tsx b/packages/gamut/src/ConnectedForm/utils.tsx
index 95560991c7f..caf917c27ff 100644
--- a/packages/gamut/src/ConnectedForm/utils.tsx
+++ b/packages/gamut/src/ConnectedForm/utils.tsx
@@ -71,7 +71,7 @@ export const useConnectedForm = <
     () => ({
       ConnectedFormGroup:
         ConnectedFormGroup as ConnectedGroupStrictProps<Values>,
-      ConnectedForm: ConnectedForm as ConnectedFormStrictProps<
+      ConnectedForm: ConnectedForm as unknown as ConnectedFormStrictProps<
         Values,
         ValidationRules
       >,
diff --git a/packages/gamut/src/FeatureShimmer/index.tsx b/packages/gamut/src/FeatureShimmer/index.tsx
index 78218b1ceca..21b2ad849c7 100644
--- a/packages/gamut/src/FeatureShimmer/index.tsx
+++ b/packages/gamut/src/FeatureShimmer/index.tsx
@@ -24,7 +24,7 @@ const boxVariants = {
     backgroundColor: 'rgba(0, 0, 0, 0)',
     borderColor: 'rgba(0, 0, 0, 0)',
     transition: {
-      ease: 'easeOut',
+      ease: 'easeOut' as const,
       duration: 0.3,
       delay: 4,
     },
@@ -37,12 +37,12 @@ const shimmerVariants = {
     backgroundColor: 'rgba(0, 0, 0, 0)',
     transition: {
       left: {
-        ease: 'easeInOut',
+        ease: 'easeInOut' as const,
         duration: 2,
         delay: 2,
       },
       backgroundColor: {
-        ease: 'easeOut',
+        ease: 'easeOut' as const,
         duration: 1,
         delay: 4,
       },
diff --git a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
index f31839eaa46..553d243604a 100644
--- a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
@@ -273,7 +273,9 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         inputWidth={inputWidth}
         isDisabled={disabled}
         isMulti={multiple}
-        isOptionDisabled={(option) => option.disabled}
+        isOptionDisabled={(option: OptionStrict & { disabled?: boolean }) =>
+          option.disabled
+        }
         isSearchable={isSearchable}
         menuAlignment={menuAlignment}
         name={name}
@@ -285,7 +287,11 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         styles={memoizedStyles}
         value={multiple ? multiValues : parsedValue}
         onChange={changeHandler}
-        onKeyDown={multiple ? (e) => keyPressHandler(e) : undefined}
+        onKeyDown={
+          multiple
+            ? (e: React.KeyboardEvent<HTMLDivElement>) => keyPressHandler(e)
+            : undefined
+        }
         {...rest}
       />
     </SelectDropdownContext.Provider>
diff --git a/packages/gamut/src/GridForm/GridForm.tsx b/packages/gamut/src/GridForm/GridForm.tsx
index 001e2ace889..d1d74d6df17 100644
--- a/packages/gamut/src/GridForm/GridForm.tsx
+++ b/packages/gamut/src/GridForm/GridForm.tsx
@@ -137,7 +137,7 @@ export function GridForm<Values extends FormValues<Values>>({
   const showRequiredText = hideRequiredText ? false : !hasComputedSoloField;
 
   return (
-    <ConnectedForm<Values>
+    <ConnectedForm
       defaultValues={defaultValues as DefaultValues<Values>}
       display="flex"
       flexDirection="column"
diff --git a/packages/gamut/src/Pagination/utils.tsx b/packages/gamut/src/Pagination/utils.tsx
index 930c3e9cdbe..8f16cbf92ae 100644
--- a/packages/gamut/src/Pagination/utils.tsx
+++ b/packages/gamut/src/Pagination/utils.tsx
@@ -1,3 +1,4 @@
+import { timingValues } from '@codecademy/gamut-styles';
 import { AnimatePresence, motion } from 'framer-motion';
 import { useEffect, useRef } from 'react';
 import * as React from 'react';
@@ -5,6 +6,8 @@ import * as React from 'react';
 import { BaseEllipsisButton } from './EllipsisButton';
 import { PaginationButton } from './PaginationButton';
 
+const FADE_DURATION_SECONDS = timingValues.base / 1000;
+
 type PaginationUtils = {
   chapterSize: number;
   currentPage: number;
@@ -76,7 +79,7 @@ export const wrapWithSlideAnimation = (
                 ? 'shown'
                 : 'hidden'
             }
-            transition={{ duration: 0.3 }}
+            transition={{ duration: FADE_DURATION_SECONDS }}
             variants={slideAnimationVariants}
           >
             <WrappedComponent {...props} />
@@ -98,6 +101,13 @@ const fadeAnimationVariants = {
   },
 };
 
+const fadeTransition = {
+  duration: FADE_DURATION_SECONDS,
+  ease: 'easeOut' as const,
+  transitionStart: { visibility: 'visible' as const },
+  transitionEnd: { visibility: 'hidden' as const },
+};
+
 export const createAnimatedFadeButton = (
   WrappedComponent: typeof PaginationButton
 ) => {
@@ -110,12 +120,7 @@ export const createAnimatedFadeButton = (
       }
       disabled={props.showButton === 'hidden'}
       initial={false}
-      transition={{
-        transitionStart: { visibility: 'visible' },
-        duration: 0.3,
-        ease: [0.04, 0.62, 0.23, 0.98],
-        transitionEnd: { visibility: 'hidden' },
-      }}
+      transition={fadeTransition}
       variants={fadeAnimationVariants}
       {...props}
     />
diff --git a/packages/gamut/src/Popover/types.tsx b/packages/gamut/src/Popover/types.tsx
index b85d4d4595c..562361bcc52 100755
--- a/packages/gamut/src/Popover/types.tsx
+++ b/packages/gamut/src/Popover/types.tsx
@@ -99,14 +99,14 @@ export type PopoverProps = PopoverBaseProps &
      * The target element around which the popover will be positioned.
      */
     targetRef: React.RefObject<
-      Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'>
+      Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'> | null
     >;
 
     /**
      * The PopoverContainer which contents will be rendered into.
      */
     popoverContainerRef?:
-      | React.RefObject<HTMLDivElement>
+      | React.RefObject<HTMLDivElement | null>
       | React.RefCallback<HTMLDivElement>;
 
     /**
diff --git a/packages/gamut/src/PopoverContainer/hooks.ts b/packages/gamut/src/PopoverContainer/hooks.ts
index 295591da7cd..16599224b93 100644
--- a/packages/gamut/src/PopoverContainer/hooks.ts
+++ b/packages/gamut/src/PopoverContainer/hooks.ts
@@ -4,7 +4,7 @@ import { findAllAdditionalScrollingParents, findResizingParent } from './utils';
 
 export const useScrollingParentsEffect = (
   targetRef: React.RefObject<
-    Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'>
+    Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'> | null
   >,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
@@ -40,7 +40,7 @@ export const useScrollingParentsEffect = (
 
 export const useResizingParentEffect = (
   targetRef: React.RefObject<
-    Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'>
+    Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'> | null
   >,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
diff --git a/packages/gamut/src/PopoverContainer/types.ts b/packages/gamut/src/PopoverContainer/types.ts
index 2c14f860579..e573ddf2313 100644
--- a/packages/gamut/src/PopoverContainer/types.ts
+++ b/packages/gamut/src/PopoverContainer/types.ts
@@ -82,7 +82,7 @@ export interface PopoverContainerProps
   /**
    * The target element around which the popover will be positioned.
    */
-  targetRef: RefObject<TargetRef>;
+  targetRef: RefObject<TargetRef | null>;
   /**
    * If true, it will allow outside page interaction. Popover container will still close when clicking outside of the popover or hitting the escape key.
    */
diff --git a/packages/gamut/src/Tip/__tests__/helpers.tsx b/packages/gamut/src/Tip/__tests__/helpers.tsx
index da836cbef31..0341dbbe056 100644
--- a/packages/gamut/src/Tip/__tests__/helpers.tsx
+++ b/packages/gamut/src/Tip/__tests__/helpers.tsx
@@ -17,7 +17,7 @@ type LinkTextParam = { linkText: string };
 type InfoParam = { info: string };
 type PlacementParam = { placement: TipPlacements };
 
-export const createFocusOnClick = (ref: RefObject<HTMLDivElement>) => {
+export const createFocusOnClick = (ref: RefObject<HTMLDivElement | null>) => {
   return ({ isTipHidden }: { isTipHidden: boolean }) => {
     if (!isTipHidden) ref.current?.focus();
   };
diff --git a/packages/gamut/src/Tip/shared/FloatingTip.tsx b/packages/gamut/src/Tip/shared/FloatingTip.tsx
index c3013661549..23ff041957b 100644
--- a/packages/gamut/src/Tip/shared/FloatingTip.tsx
+++ b/packages/gamut/src/Tip/shared/FloatingTip.tsx
@@ -43,8 +43,8 @@ export const FloatingTip: React.FC<TipWrapperProps> = ({
   const [isFocused, setIsFocused] = useState(false);
 
   // Use refs to store timeouts to prevent race conditions
-  const hoverDelayRef = useRef<NodeJS.Timeout | undefined>();
-  const focusDelayRef = useRef<NodeJS.Timeout | undefined>();
+  const hoverDelayRef = useRef<NodeJS.Timeout | undefined>(undefined);
+  const focusDelayRef = useRef<NodeJS.Timeout | undefined>(undefined);
 
   const commonPopoverProps = getPopoverAlignmentAndPattern({ alignment, type });
   const dims = getAlignmentStyles({ avatar, alignment, type });
diff --git a/packages/gamut/src/Tip/shared/types.tsx b/packages/gamut/src/Tip/shared/types.tsx
index 164ed1aaf37..2d828c05292 100644
--- a/packages/gamut/src/Tip/shared/types.tsx
+++ b/packages/gamut/src/Tip/shared/types.tsx
@@ -79,9 +79,9 @@ export type TipPlacementComponentProps = Omit<
   id?: string;
   isTipHidden?: boolean;
   contentRef?:
-    | React.RefObject<HTMLDivElement>
+    | React.RefObject<HTMLDivElement | null>
     | ((node: HTMLDivElement | null) => void);
   type: 'info' | 'tool' | 'preview';
-  wrapperRef?: React.RefObject<HTMLDivElement>;
+  wrapperRef?: React.RefObject<HTMLDivElement | null>;
   zIndex?: number;
 } & React.PropsWithChildren;
diff --git a/packages/gamut/src/utils/react.ts b/packages/gamut/src/utils/react.ts
index c0b673bb24d..00cdb340130 100644
--- a/packages/gamut/src/utils/react.ts
+++ b/packages/gamut/src/utils/react.ts
@@ -35,7 +35,8 @@ export const extractTextContent = (children: React.ReactNode): string => {
         return '';
       }
       if (isValidElement(child)) {
-        const textContent = child.props.children ?? child.props.text ?? '';
+        const props = child.props as { children?: React.ReactNode; text?: string };
+        const textContent = props.children ?? props.text ?? '';
         return extractTextContent(textContent);
       }
       return '';
diff --git a/packages/variance/integration/__tests__/component.test.tsx b/packages/variance/integration/__tests__/component.test.tsx
index bdc494b5fca..e3355484625 100644
--- a/packages/variance/integration/__tests__/component.test.tsx
+++ b/packages/variance/integration/__tests__/component.test.tsx
@@ -1,13 +1,13 @@
 import { matchers } from '@emotion/jest';
 import { ThemeProvider } from '@emotion/react';
 import styled from '@emotion/styled';
+import { render } from '@testing-library/react';
 import { ComponentProps } from 'react';
 import * as React from 'react';
-import renderer from 'react-test-renderer';
 
 import { variance } from '../../src/core';
 import { theme } from '../__fixtures__/theme';
-// Add the custom matchers provided by '@emotion/jest'
+
 expect.extend(matchers);
 
 const styles = variance.create({
@@ -27,16 +27,20 @@ const setupRender = <T extends React.ElementType, P extends ComponentProps<T>>(
   Component: T,
   defaultProps?: P
 ) => {
-  return (props?: P) => {
+  return (props?: P): HTMLElement => {
     const mergedProps = { ...defaultProps, ...props };
 
-    return renderer
-      .create(
-        <ThemeProvider theme={theme}>
-          <Component {...(mergedProps as P)} />
-        </ThemeProvider>
-      )
-      .toJSON();
+    const { container } = render(
+      <ThemeProvider theme={theme}>
+        <Component {...(mergedProps as P)} />
+      </ThemeProvider>
+    );
+
+    const el = container.firstElementChild;
+    if (!el || !(el instanceof HTMLElement)) {
+      throw new Error('Expected a styled root element');
+    }
+    return el;
   };
 };
 
diff --git a/yarn.lock b/yarn.lock
index a0ff84d0248..401179f261d 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1626,7 +1626,7 @@ __metadata:
     "@emotion/react": ^11.4.0
     "@emotion/styled": ^11.3.0
     lodash: ^4.17.23
-    react: ^17.0.2 || ^18.3.0
+    react: ^17.0.2 || ^18.3.0 || ^19.0.0
   languageName: unknown
   linkType: soft
 
@@ -1639,8 +1639,8 @@ __metadata:
   peerDependencies:
     "@emotion/react": ^11.4.0
     "@emotion/styled": ^11.3.0
-    react: ^17.0.2 || ^18.3.0
-    react-dom: ^17.0.2 || ^18.3.0
+    react: ^17.0.2 || ^18.3.0 || ^19.0.0
+    react-dom: ^17.0.2 || ^18.3.0 || ^19.0.0
   languageName: unknown
   linkType: soft
 
@@ -1669,8 +1669,8 @@ __metadata:
   peerDependencies:
     "@emotion/react": ^11.4.0
     "@emotion/styled": ^11.3.0
-    react: ^17.0.2 || ^18.3.0
-    react-dom: ^17.0.2 || ^18.3.0
+    react: ^17.0.2 || ^18.3.0 || ^19.0.0
+    react-dom: ^17.0.2 || ^18.3.0 || ^19.0.0
   languageName: unknown
   linkType: soft
 
@@ -1680,7 +1680,7 @@ __metadata:
   dependencies:
     "@codecademy/variance": "npm:0.26.0"
     "@emotion/is-prop-valid": "npm:^1.1.0"
-    framer-motion: "npm:^11.18.0"
+    framer-motion: "npm:^12.0.0"
     get-nonce: "npm:^1.0.0"
     polished: "npm:^4.1.2"
   peerDependencies:
@@ -1688,7 +1688,7 @@ __metadata:
     "@emotion/react": ^11.4.0
     "@emotion/styled": ^11.3.0
     lodash: ^4.17.23
-    react: ^17.0.2 || ^18.3.0
+    react: ^17.0.2 || ^18.3.0 || ^19.0.0
     stylis: ^4.0.7
   languageName: unknown
   linkType: soft
@@ -1701,7 +1701,7 @@ __metadata:
     component-test-setup: "npm:*"
     lodash: "npm:^4.17.23"
   peerDependencies:
-    react: ^17.0.2 || ^18.3.0
+    react: ^17.0.2 || ^18.3.0 || ^19.0.0
   languageName: unknown
   linkType: soft
 
@@ -1718,7 +1718,7 @@ __metadata:
     "@types/marked": "npm:^4.0.8"
     "@vidstack/react": "npm:^1.12.12"
     classnames: "npm:^2.2.5"
-    framer-motion: "npm:^11.18.0"
+    framer-motion: "npm:^12.0.0"
     html-to-react: "npm:^1.6.0"
     invariant: "npm:^2.2.4"
     lodash: "npm:^4.17.23"
@@ -1735,8 +1735,8 @@ __metadata:
   peerDependencies:
     "@emotion/react": ^11.4.0
     "@emotion/styled": ^11.3.0
-    react: ^17.0.2 || ^18.3.0
-    react-dom: ^17.0.2 || ^18.3.0
+    react: ^17.0.2 || ^18.3.0 || ^19.0.0
+    react-dom: ^17.0.2 || ^18.3.0 || ^19.0.0
   languageName: unknown
   linkType: soft
 
@@ -7686,22 +7686,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@testing-library/dom@npm:^8.11.1":
-  version: 8.20.1
-  resolution: "@testing-library/dom@npm:8.20.1"
-  dependencies:
-    "@babel/code-frame": "npm:^7.10.4"
-    "@babel/runtime": "npm:^7.12.5"
-    "@types/aria-query": "npm:^5.0.1"
-    aria-query: "npm:5.1.3"
-    chalk: "npm:^4.1.0"
-    dom-accessibility-api: "npm:^0.5.9"
-    lz-string: "npm:^1.5.0"
-    pretty-format: "npm:^27.0.2"
-  checksum: 10c0/614013756706467f2a7f3f693c18377048c210ec809884f0f9be866f7d865d075805ad15f5d100e8a699467fdde09085bf79e23a00ea0a6ab001d9583ef15e5d
-  languageName: node
-  linkType: hard
-
 "@testing-library/jest-dom@npm:^5.16.1":
   version: 5.17.0
   resolution: "@testing-library/jest-dom@npm:5.17.0"
@@ -7741,21 +7725,23 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@testing-library/react@npm:15.0.6":
-  version: 15.0.6
-  resolution: "@testing-library/react@npm:15.0.6"
+"@testing-library/react@npm:^16.0.0":
+  version: 16.3.2
+  resolution: "@testing-library/react@npm:16.3.2"
   dependencies:
     "@babel/runtime": "npm:^7.12.5"
-    "@testing-library/dom": "npm:^10.0.0"
-    "@types/react-dom": "npm:^18.0.0"
   peerDependencies:
-    "@types/react": ^18.0.0
-    react: ^18.0.0
-    react-dom: ^18.0.0
+    "@testing-library/dom": ^10.0.0
+    "@types/react": ^18.0.0 || ^19.0.0
+    "@types/react-dom": ^18.0.0 || ^19.0.0
+    react: ^18.0.0 || ^19.0.0
+    react-dom: ^18.0.0 || ^19.0.0
   peerDependenciesMeta:
     "@types/react":
       optional: true
-  checksum: 10c0/3705a2272f929f2f848f5d7e6ac9829bf7ecc1725a35733ffae7e7a261d4bdab470b080558e8544edb1f9ba25db9fbc4232527df9b4ec6ab6ae4462a902a7f95
+    "@types/react-dom":
+      optional: true
+  checksum: 10c0/f9c7f0915e1b5f7b750e6c7d8b51f091b8ae7ea99bacb761d7b8505ba25de9cfcb749a0f779f1650fb268b499dd79165dc7e1ee0b8b4cb63430d3ddc81ffe044
   languageName: node
   linkType: hard
 
@@ -8235,13 +8221,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/prop-types@npm:*":
-  version: 15.7.13
-  resolution: "@types/prop-types@npm:15.7.13"
-  checksum: 10c0/1b20fc67281902c6743379960247bc161f3f0406ffc0df8e7058745a85ea1538612109db0406290512947f9632fe9e10e7337bf0ce6338a91d6c948df16a7c61
-  languageName: node
-  linkType: hard
-
 "@types/q@npm:^1.5.1":
   version: 1.5.8
   resolution: "@types/q@npm:1.5.8"
@@ -8263,16 +8242,16 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/react-dom@npm:18.3.1":
-  version: 18.3.1
-  resolution: "@types/react-dom@npm:18.3.1"
-  dependencies:
-    "@types/react": "npm:*"
-  checksum: 10c0/8b416551c60bb6bd8ec10e198c957910cfb271bc3922463040b0d57cf4739cdcd24b13224f8d68f10318926e1ec3cd69af0af79f0291b599a992f8c80d47f1eb
+"@types/react-dom@npm:^19.0.0":
+  version: 19.2.3
+  resolution: "@types/react-dom@npm:19.2.3"
+  peerDependencies:
+    "@types/react": ^19.2.0
+  checksum: 10c0/b486ebe0f4e2fb35e2e108df1d8fc0927ca5d6002d5771e8a739de11239fe62d0e207c50886185253c99eb9dedfeeb956ea7429e5ba17f6693c7acb4c02f8cd1
   languageName: node
   linkType: hard
 
-"@types/react-test-renderer@npm:18.3.0, @types/react-test-renderer@npm:>=16.9.0":
+"@types/react-test-renderer@npm:>=16.9.0":
   version: 18.3.0
   resolution: "@types/react-test-renderer@npm:18.3.0"
   dependencies:
@@ -8281,6 +8260,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/react-test-renderer@npm:^19.0.0":
+  version: 19.1.0
+  resolution: "@types/react-test-renderer@npm:19.1.0"
+  dependencies:
+    "@types/react": "npm:*"
+  checksum: 10c0/799654e430df10aeaf267d71507fb64ec151359ead7e3774111bfd4abce7e0911dba461811195c06c22a6d17496ea92537d3185320ff4112fe29954cad1b9152
+  languageName: node
+  linkType: hard
+
 "@types/react-transition-group@npm:^4.4.0":
   version: 4.4.11
   resolution: "@types/react-transition-group@npm:4.4.11"
@@ -8290,13 +8278,12 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/react@npm:18.3.27":
-  version: 18.3.27
-  resolution: "@types/react@npm:18.3.27"
+"@types/react@npm:^19.0.0":
+  version: 19.2.14
+  resolution: "@types/react@npm:19.2.14"
   dependencies:
-    "@types/prop-types": "npm:*"
     csstype: "npm:^3.2.2"
-  checksum: 10c0/a761d2f58de03d0714806cc65d32bb3d73fb33a08dd030d255b47a295e5fff2a775cf1c20b786824d8deb6454eaccce9bc6998d9899c14fc04bbd1b0b0b72897
+  checksum: 10c0/7d25bf41b57719452d86d2ac0570b659210402707313a36ee612666bf11275a1c69824f8c3ee1fdca077ccfe15452f6da8f1224529b917050eb2d861e52b59b7
   languageName: node
   linkType: hard
 
@@ -9294,15 +9281,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"aria-query@npm:5.1.3":
-  version: 5.1.3
-  resolution: "aria-query@npm:5.1.3"
-  dependencies:
-    deep-equal: "npm:^2.0.5"
-  checksum: 10c0/edcbc8044c4663d6f88f785e983e6784f98cb62b4ba1e9dd8d61b725d0203e4cfca38d676aee984c31f354103461102a3d583aa4fbe4fd0a89b679744f4e5faf
-  languageName: node
-  linkType: hard
-
 "aria-query@npm:5.3.0":
   version: 5.3.0
   resolution: "aria-query@npm:5.3.0"
@@ -9319,7 +9297,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"array-buffer-byte-length@npm:^1.0.0, array-buffer-byte-length@npm:^1.0.1":
+"array-buffer-byte-length@npm:^1.0.1":
   version: 1.0.1
   resolution: "array-buffer-byte-length@npm:1.0.1"
   dependencies:
@@ -11949,32 +11927,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"deep-equal@npm:^2.0.5":
-  version: 2.2.3
-  resolution: "deep-equal@npm:2.2.3"
-  dependencies:
-    array-buffer-byte-length: "npm:^1.0.0"
-    call-bind: "npm:^1.0.5"
-    es-get-iterator: "npm:^1.1.3"
-    get-intrinsic: "npm:^1.2.2"
-    is-arguments: "npm:^1.1.1"
-    is-array-buffer: "npm:^3.0.2"
-    is-date-object: "npm:^1.0.5"
-    is-regex: "npm:^1.1.4"
-    is-shared-array-buffer: "npm:^1.0.2"
-    isarray: "npm:^2.0.5"
-    object-is: "npm:^1.1.5"
-    object-keys: "npm:^1.1.1"
-    object.assign: "npm:^4.1.4"
-    regexp.prototype.flags: "npm:^1.5.1"
-    side-channel: "npm:^1.0.4"
-    which-boxed-primitive: "npm:^1.0.2"
-    which-collection: "npm:^1.0.1"
-    which-typed-array: "npm:^1.1.13"
-  checksum: 10c0/a48244f90fa989f63ff5ef0cc6de1e4916b48ea0220a9c89a378561960814794a5800c600254482a2c8fd2e49d6c2e196131dc983976adb024c94a42dfe4949f
-  languageName: node
-  linkType: hard
-
 "deep-equal@npm:~1.0.1":
   version: 1.0.1
   resolution: "deep-equal@npm:1.0.1"
@@ -12699,23 +12651,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-get-iterator@npm:^1.1.3":
-  version: 1.1.3
-  resolution: "es-get-iterator@npm:1.1.3"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    get-intrinsic: "npm:^1.1.3"
-    has-symbols: "npm:^1.0.3"
-    is-arguments: "npm:^1.1.1"
-    is-map: "npm:^2.0.2"
-    is-set: "npm:^2.0.2"
-    is-string: "npm:^1.0.7"
-    isarray: "npm:^2.0.5"
-    stop-iteration-iterator: "npm:^1.0.0"
-  checksum: 10c0/ebd11effa79851ea75d7f079405f9d0dc185559fd65d986c6afea59a0ff2d46c2ed8675f19f03dce7429d7f6c14ff9aede8d121fbab78d75cfda6a263030bac0
-  languageName: node
-  linkType: hard
-
 "es-iterator-helpers@npm:^1.1.0":
   version: 1.1.0
   resolution: "es-iterator-helpers@npm:1.1.0"
@@ -14056,12 +13991,12 @@ __metadata:
   languageName: node
   linkType: hard
 
-"framer-motion@npm:^11.18.0":
-  version: 11.18.2
-  resolution: "framer-motion@npm:11.18.2"
+"framer-motion@npm:^12.0.0":
+  version: 12.37.0
+  resolution: "framer-motion@npm:12.37.0"
   dependencies:
-    motion-dom: "npm:^11.18.1"
-    motion-utils: "npm:^11.18.1"
+    motion-dom: "npm:^12.37.0"
+    motion-utils: "npm:^12.36.0"
     tslib: "npm:^2.4.0"
   peerDependencies:
     "@emotion/is-prop-valid": "*"
@@ -14074,7 +14009,7 @@ __metadata:
       optional: true
     react-dom:
       optional: true
-  checksum: 10c0/41b1ef1b4e54ea13adaf01d61812a8783d2352f74641c91b50519775704bc6274db6b6863ff494a1f705fa6c6ed8f4df3497292327c906d53ea0129cef3ec361
+  checksum: 10c0/6bdf132876e5a323c60ba3930bf2d894338f6235d942b219cf3068b330ecc7c915d9b8ee6631f89ddcde7a4ba7373bad3abf40d19d2c882b186697cbe11ee311
   languageName: node
   linkType: hard
 
@@ -14277,18 +14212,18 @@ __metadata:
     "@storybook/react-webpack5": "npm:^8.6.15"
     "@storybook/theming": "npm:^8.6.15"
     "@svgr/cli": "npm:5.5.0"
-    "@testing-library/dom": "npm:^8.11.1"
+    "@testing-library/dom": "npm:^10.0.0"
     "@testing-library/jest-dom": "npm:^5.16.1"
-    "@testing-library/react": "npm:15.0.6"
+    "@testing-library/react": "npm:^16.0.0"
     "@testing-library/react-hooks": "npm:^7.0.2"
     "@testing-library/user-event": "npm:^14.5.2"
     "@types/classnames": "npm:2.2.10"
     "@types/invariant": "npm:2.2.29"
     "@types/konami-code-js": "npm:^0.8.0"
     "@types/lodash": "npm:4.17.23"
-    "@types/react": "npm:18.3.27"
-    "@types/react-dom": "npm:18.3.1"
-    "@types/react-test-renderer": "npm:18.3.0"
+    "@types/react": "npm:^19.0.0"
+    "@types/react-dom": "npm:^19.0.0"
+    "@types/react-test-renderer": "npm:^19.0.0"
     "@types/stylis": "npm:^4.2.0"
     "@typescript-eslint/eslint-plugin": "npm:^5.15.0"
     "@typescript-eslint/parser": "npm:^5.15.0"
@@ -14320,10 +14255,10 @@ __metadata:
     nx-cloud: "npm:^19.1.0"
     onchange: "npm:^7.0.2"
     prettier: "npm:^2.8.7"
-    react: "npm:18.3.1"
-    react-dom: "npm:18.3.1"
+    react: "npm:^19.0.0"
+    react-dom: "npm:^19.0.0"
     react-helmet-async: "npm:^2.0.5"
-    react-test-renderer: "npm:18.3.1"
+    react-test-renderer: "npm:^19.0.0"
     storybook: "npm:^8.6.15"
     storybook-addon-deep-controls: "npm:^0.9.5"
     style-loader: "npm:^4.0.0"
@@ -14375,7 +14310,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"get-intrinsic@npm:^1.1.3, get-intrinsic@npm:^1.2.1, get-intrinsic@npm:^1.2.2, get-intrinsic@npm:^1.2.3, get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.6":
+"get-intrinsic@npm:^1.2.1, get-intrinsic@npm:^1.2.3, get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.6":
   version: 1.3.0
   resolution: "get-intrinsic@npm:1.3.0"
   dependencies:
@@ -15583,7 +15518,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"internal-slot@npm:^1.0.4, internal-slot@npm:^1.0.7":
+"internal-slot@npm:^1.0.7":
   version: 1.0.7
   resolution: "internal-slot@npm:1.0.7"
   dependencies:
@@ -15660,7 +15595,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-arguments@npm:^1.0.4, is-arguments@npm:^1.1.1":
+"is-arguments@npm:^1.0.4":
   version: 1.1.1
   resolution: "is-arguments@npm:1.1.1"
   dependencies:
@@ -15670,7 +15605,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-array-buffer@npm:^3.0.2, is-array-buffer@npm:^3.0.4":
+"is-array-buffer@npm:^3.0.4":
   version: 3.0.4
   resolution: "is-array-buffer@npm:3.0.4"
   dependencies:
@@ -15888,7 +15823,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-map@npm:^2.0.2, is-map@npm:^2.0.3":
+"is-map@npm:^2.0.3":
   version: 2.0.3
   resolution: "is-map@npm:2.0.3"
   checksum: 10c0/2c4d431b74e00fdda7162cd8e4b763d6f6f217edf97d4f8538b94b8702b150610e2c64961340015fe8df5b1fcee33ccd2e9b62619c4a8a3a155f8de6d6d355fc
@@ -16016,7 +15951,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-set@npm:^2.0.2, is-set@npm:^2.0.3":
+"is-set@npm:^2.0.3":
   version: 2.0.3
   resolution: "is-set@npm:2.0.3"
   checksum: 10c0/f73732e13f099b2dc879c2a12341cfc22ccaca8dd504e6edae26484bd5707a35d503fba5b4daad530a9b088ced1ae6c9d8200fd92e09b428fe14ea79ce8080b7
@@ -18014,7 +17949,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"loose-envify@npm:^1.0.0, loose-envify@npm:^1.1.0, loose-envify@npm:^1.4.0":
+"loose-envify@npm:^1.0.0, loose-envify@npm:^1.4.0":
   version: 1.4.0
   resolution: "loose-envify@npm:1.4.0"
   dependencies:
@@ -18796,19 +18731,19 @@ __metadata:
   languageName: node
   linkType: hard
 
-"motion-dom@npm:^11.18.1":
-  version: 11.18.1
-  resolution: "motion-dom@npm:11.18.1"
+"motion-dom@npm:^12.37.0":
+  version: 12.37.0
+  resolution: "motion-dom@npm:12.37.0"
   dependencies:
-    motion-utils: "npm:^11.18.1"
-  checksum: 10c0/98378bdf9d77870829cdf3624c5eff02e48cfa820dfc74450364d7421884700048d60e277bfbf477df33270fbae4c1980e5914586f5b6dff28d4921fdca8ac47
+    motion-utils: "npm:^12.36.0"
+  checksum: 10c0/e3b2be1e6796658d021921fed8f5ce690b833c4ce5f63d0ca11c86b5520b35a626d29ef9d97bd8551bd946333c3d4ab159d95aae9951c92ce8733039560b4c0c
   languageName: node
   linkType: hard
 
-"motion-utils@npm:^11.18.1":
-  version: 11.18.1
-  resolution: "motion-utils@npm:11.18.1"
-  checksum: 10c0/dac083bdeb6e433a277ac4362211b0fdce59ff09d6f7897f0f49d1e3561209c6481f676876daf99a33485054bc7e4b1d1b8d1de16f7b1e5c6f117fe76358ca00
+"motion-utils@npm:^12.36.0":
+  version: 12.36.0
+  resolution: "motion-utils@npm:12.36.0"
+  checksum: 10c0/fe08231759064eef5d351a869379246f1e1b2031bda357a6197d2a99ff6b472bce69f8250212713d8bff2ff46978f354ca8c3b8c8f0c5bd337d26a6793ba42fa
   languageName: node
   linkType: hard
 
@@ -19595,16 +19530,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object-is@npm:^1.1.5":
-  version: 1.1.6
-  resolution: "object-is@npm:1.1.6"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-  checksum: 10c0/506af444c4dce7f8e31f34fc549e2fb8152d6b9c4a30c6e62852badd7f520b579c679af433e7a072f9d78eb7808d230dc12e1cf58da9154dfbf8813099ea0fe0
-  languageName: node
-  linkType: hard
-
 "object-keys@npm:^1.1.1":
   version: 1.1.1
   resolution: "object-keys@npm:1.1.1"
@@ -21590,15 +21515,14 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react-dom@npm:18.3.1":
-  version: 18.3.1
-  resolution: "react-dom@npm:18.3.1"
+"react-dom@npm:^19.0.0":
+  version: 19.2.4
+  resolution: "react-dom@npm:19.2.4"
   dependencies:
-    loose-envify: "npm:^1.1.0"
-    scheduler: "npm:^0.23.2"
+    scheduler: "npm:^0.27.0"
   peerDependencies:
-    react: ^18.3.1
-  checksum: 10c0/a752496c1941f958f2e8ac56239172296fcddce1365ce45222d04a1947e0cc5547df3e8447f855a81d6d39f008d7c32eab43db3712077f09e3f67c4874973e85
+    react: ^19.2.4
+  checksum: 10c0/f0c63f1794dedb154136d4d0f59af00b41907f4859571c155940296808f4b94bf9c0c20633db75b5b2112ec13d8d7dd4f9bf57362ed48782f317b11d05a44f35
   languageName: node
   linkType: hard
 
@@ -21682,13 +21606,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react-is@npm:^16.12.0 || ^17.0.0 || ^18.0.0, react-is@npm:^18.0.0, react-is@npm:^18.3.1":
-  version: 18.3.1
-  resolution: "react-is@npm:18.3.1"
-  checksum: 10c0/f2f1e60010c683479e74c63f96b09fb41603527cd131a9959e2aee1e5a8b0caf270b365e5ca77d4a6b18aae659b60a86150bb3979073528877029b35aecd2072
-  languageName: node
-  linkType: hard
-
 "react-is@npm:^16.13.1, react-is@npm:^16.7.0":
   version: 16.13.1
   resolution: "react-is@npm:16.13.1"
@@ -21703,6 +21620,20 @@ __metadata:
   languageName: node
   linkType: hard
 
+"react-is@npm:^18.0.0, react-is@npm:^18.3.1":
+  version: 18.3.1
+  resolution: "react-is@npm:18.3.1"
+  checksum: 10c0/f2f1e60010c683479e74c63f96b09fb41603527cd131a9959e2aee1e5a8b0caf270b365e5ca77d4a6b18aae659b60a86150bb3979073528877029b35aecd2072
+  languageName: node
+  linkType: hard
+
+"react-is@npm:^19.2.4":
+  version: 19.2.4
+  resolution: "react-is@npm:19.2.4"
+  checksum: 10c0/477a7cfc900f24194606e315fa353856a3a13487ea8eca841678817cad4daef64339ea0d1e84e58459fc75dbe0d9ba00bb0cc626db3d07e0cf31edc64cb4fa37
+  languageName: node
+  linkType: hard
+
 "react-player@npm:^2.16.0":
   version: 2.16.0
   resolution: "react-player@npm:2.16.0"
@@ -21773,18 +21704,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react-shallow-renderer@npm:^16.15.0":
-  version: 16.15.0
-  resolution: "react-shallow-renderer@npm:16.15.0"
-  dependencies:
-    object-assign: "npm:^4.1.1"
-    react-is: "npm:^16.12.0 || ^17.0.0 || ^18.0.0"
-  peerDependencies:
-    react: ^16.0.0 || ^17.0.0 || ^18.0.0
-  checksum: 10c0/c194d741792e86043a4ae272f7353c1cb9412bc649945c4220c6a101a6ea5410cceb3d65d5a4d750f11a24f7426e8eec7977e8a4e3ad5d3ee235ca2b18166fa8
-  languageName: node
-  linkType: hard
-
 "react-stately@npm:^3.36.1":
   version: 3.44.0
   resolution: "react-stately@npm:3.44.0"
@@ -21837,16 +21756,15 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react-test-renderer@npm:18.3.1":
-  version: 18.3.1
-  resolution: "react-test-renderer@npm:18.3.1"
+"react-test-renderer@npm:^19.0.0":
+  version: 19.2.4
+  resolution: "react-test-renderer@npm:19.2.4"
   dependencies:
-    react-is: "npm:^18.3.1"
-    react-shallow-renderer: "npm:^16.15.0"
-    scheduler: "npm:^0.23.2"
+    react-is: "npm:^19.2.4"
+    scheduler: "npm:^0.27.0"
   peerDependencies:
-    react: ^18.3.1
-  checksum: 10c0/c633558ef9af33bc68f0c4dbb5163a004c4fb9eade7bd0a7cfc0355fb367f36bd9d96533c90b7e85a146be6c525113a15f58683d269e0177ad77e2b04d4fe51c
+    react: ^19.2.4
+  checksum: 10c0/76f0a419a8ca7776ac6fae7c25056b9326a92a3d79971817e8ffd262d9121d1e87fde058b4fd6d33c365b1001cd6236d9053816dabed20afa62fbfe2a1a59f1a
   languageName: node
   linkType: hard
 
@@ -21914,12 +21832,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react@npm:18.3.1":
-  version: 18.3.1
-  resolution: "react@npm:18.3.1"
-  dependencies:
-    loose-envify: "npm:^1.1.0"
-  checksum: 10c0/283e8c5efcf37802c9d1ce767f302dd569dd97a70d9bb8c7be79a789b9902451e0d16334b05d73299b20f048cbc3c7d288bbbde10b701fa194e2089c237dbea3
+"react@npm:^19.0.0":
+  version: 19.2.4
+  resolution: "react@npm:19.2.4"
+  checksum: 10c0/cd2c9ff67a720799cc3b38a516009986f7fc4cb8d3e15716c6211cf098d1357ee3e348ab05ad0600042bbb0fd888530ba92e329198c92eafa0994f5213396596
   languageName: node
   linkType: hard
 
@@ -22171,7 +22087,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"regexp.prototype.flags@npm:^1.5.1, regexp.prototype.flags@npm:^1.5.2":
+"regexp.prototype.flags@npm:^1.5.2":
   version: 1.5.3
   resolution: "regexp.prototype.flags@npm:1.5.3"
   dependencies:
@@ -23049,12 +22965,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"scheduler@npm:^0.23.2":
-  version: 0.23.2
-  resolution: "scheduler@npm:0.23.2"
-  dependencies:
-    loose-envify: "npm:^1.1.0"
-  checksum: 10c0/26383305e249651d4c58e6705d5f8425f153211aef95f15161c151f7b8de885f24751b377e4a0b3dd42cce09aad3f87a61dab7636859c0d89b7daf1a1e2a5c78
+"scheduler@npm:^0.27.0":
+  version: 0.27.0
+  resolution: "scheduler@npm:0.27.0"
+  checksum: 10c0/4f03048cb05a3c8fddc45813052251eca00688f413a3cee236d984a161da28db28ba71bd11e7a3dd02f7af84ab28d39fb311431d3b3772fed557945beb00c452
   languageName: node
   linkType: hard
 
@@ -23755,15 +23669,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"stop-iteration-iterator@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "stop-iteration-iterator@npm:1.0.0"
-  dependencies:
-    internal-slot: "npm:^1.0.4"
-  checksum: 10c0/c4158d6188aac510d9e92925b58709207bd94699e9c31186a040c80932a687f84a51356b5895e6dc72710aad83addb9411c22171832c9ae0e6e11b7d61b0dfb9
-  languageName: node
-  linkType: hard
-
 "storybook-addon-deep-controls@npm:^0.9.5":
   version: 0.9.5
   resolution: "storybook-addon-deep-controls@npm:0.9.5"
@@ -25942,7 +25847,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"which-collection@npm:^1.0.1, which-collection@npm:^1.0.2":
+"which-collection@npm:^1.0.2":
   version: 1.0.2
   resolution: "which-collection@npm:1.0.2"
   dependencies:
@@ -25954,7 +25859,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"which-typed-array@npm:^1.1.13, which-typed-array@npm:^1.1.14, which-typed-array@npm:^1.1.15, which-typed-array@npm:^1.1.2":
+"which-typed-array@npm:^1.1.14, which-typed-array@npm:^1.1.15, which-typed-array@npm:^1.1.2":
   version: 1.1.15
   resolution: "which-typed-array@npm:1.1.15"
   dependencies:

From 39d5707ef4316ede768c5ea01f024c039e4e3692 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Mon, 16 Mar 2026 17:39:44 -0400
Subject: [PATCH 02/37] format

---
 packages/gamut-styles/src/variance/utils.ts  |  2 +-
 packages/gamut/src/Popover/types.tsx         |  7 ++++---
 packages/gamut/src/PopoverContainer/hooks.ts | 14 ++++++++------
 packages/gamut/src/utils/react.ts            |  5 ++++-
 yarn.lock                                    | 11 +----------
 5 files changed, 18 insertions(+), 21 deletions(-)

diff --git a/packages/gamut-styles/src/variance/utils.ts b/packages/gamut-styles/src/variance/utils.ts
index 01a1630c1bf..efccefdd8cd 100644
--- a/packages/gamut-styles/src/variance/utils.ts
+++ b/packages/gamut-styles/src/variance/utils.ts
@@ -1,6 +1,6 @@
-import type React from 'react';
 import { ThemeProps } from '@codecademy/variance';
 import isPropValid from '@emotion/is-prop-valid';
+import type React from 'react';
 
 import { all as allProps } from './config';
 
diff --git a/packages/gamut/src/Popover/types.tsx b/packages/gamut/src/Popover/types.tsx
index 562361bcc52..1a605f43097 100755
--- a/packages/gamut/src/Popover/types.tsx
+++ b/packages/gamut/src/Popover/types.tsx
@@ -98,9 +98,10 @@ export type PopoverProps = PopoverBaseProps &
     /**
      * The target element around which the popover will be positioned.
      */
-    targetRef: React.RefObject<
-      Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'> | null
-    >;
+    targetRef: React.RefObject<Pick<
+      HTMLDivElement,
+      'getBoundingClientRect' | 'contains'
+    > | null>;
 
     /**
      * The PopoverContainer which contents will be rendered into.
diff --git a/packages/gamut/src/PopoverContainer/hooks.ts b/packages/gamut/src/PopoverContainer/hooks.ts
index 16599224b93..8ddd9c13d35 100644
--- a/packages/gamut/src/PopoverContainer/hooks.ts
+++ b/packages/gamut/src/PopoverContainer/hooks.ts
@@ -3,9 +3,10 @@ import { useEffect, useMemo } from 'react';
 import { findAllAdditionalScrollingParents, findResizingParent } from './utils';
 
 export const useScrollingParentsEffect = (
-  targetRef: React.RefObject<
-    Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'> | null
-  >,
+  targetRef: React.RefObject<Pick<
+    HTMLDivElement,
+    'getBoundingClientRect' | 'contains'
+  > | null>,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
   useEffect(() => {
@@ -39,9 +40,10 @@ export const useScrollingParentsEffect = (
 };
 
 export const useResizingParentEffect = (
-  targetRef: React.RefObject<
-    Pick<HTMLDivElement, 'getBoundingClientRect' | 'contains'> | null
-  >,
+  targetRef: React.RefObject<Pick<
+    HTMLDivElement,
+    'getBoundingClientRect' | 'contains'
+  > | null>,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
   useEffect(() => {
diff --git a/packages/gamut/src/utils/react.ts b/packages/gamut/src/utils/react.ts
index 00cdb340130..a3ebd4391cb 100644
--- a/packages/gamut/src/utils/react.ts
+++ b/packages/gamut/src/utils/react.ts
@@ -35,7 +35,10 @@ export const extractTextContent = (children: React.ReactNode): string => {
         return '';
       }
       if (isValidElement(child)) {
-        const props = child.props as { children?: React.ReactNode; text?: string };
+        const props = child.props as {
+          children?: React.ReactNode;
+          text?: string;
+        };
         const textContent = props.children ?? props.text ?? '';
         return extractTextContent(textContent);
       }
diff --git a/yarn.lock b/yarn.lock
index 401179f261d..175e77b08a8 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -8251,16 +8251,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/react-test-renderer@npm:>=16.9.0":
-  version: 18.3.0
-  resolution: "@types/react-test-renderer@npm:18.3.0"
-  dependencies:
-    "@types/react": "npm:*"
-  checksum: 10c0/3c9748be52e8e659e7adf91dea6939486463264e6f633bf21c4cb116de18af7bef0595568a1e588160420b2f65289473075dda1cb417c2875df8cf7a09f5d913
-  languageName: node
-  linkType: hard
-
-"@types/react-test-renderer@npm:^19.0.0":
+"@types/react-test-renderer@npm:>=16.9.0, @types/react-test-renderer@npm:^19.0.0":
   version: 19.1.0
   resolution: "@types/react-test-renderer@npm:19.1.0"
   dependencies:

From 3f687900567518928aa19861a9f49c65070f30cc Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Tue, 17 Mar 2026 10:39:04 -0400
Subject: [PATCH 03/37] .spec

---
 packages/gamut-styles/tsconfig.lib.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/gamut-styles/tsconfig.lib.json b/packages/gamut-styles/tsconfig.lib.json
index bf001194960..daaeddbd0e7 100644
--- a/packages/gamut-styles/tsconfig.lib.json
+++ b/packages/gamut-styles/tsconfig.lib.json
@@ -12,6 +12,7 @@
   ],
   "exclude": [
     "jest.config.ts",
+    "**/__tests__/**",
     "**/*.spec.ts",
     "**/*.test.ts",
     "**/*.spec.tsx",

From 2fa55ca2bc555749d9c98f25e68b13903f83c6b2 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Tue, 17 Mar 2026 10:51:13 -0400
Subject: [PATCH 04/37] test

---
 packages/gamut/src/Tip/__tests__/helpers.tsx | 23 ++++++--------------
 1 file changed, 7 insertions(+), 16 deletions(-)

diff --git a/packages/gamut/src/Tip/__tests__/helpers.tsx b/packages/gamut/src/Tip/__tests__/helpers.tsx
index 0341dbbe056..7f7461d2679 100644
--- a/packages/gamut/src/Tip/__tests__/helpers.tsx
+++ b/packages/gamut/src/Tip/__tests__/helpers.tsx
@@ -419,24 +419,15 @@ export const openInfoTipsWithKeyboard = async ({
 }) => {
   const buttons = view.getAllByLabelText('Show information');
 
-  await act(async () => {
-    buttons[0].focus();
-    await userEvent.keyboard('{Enter}');
-
-    for (let i = 1; i < count; i += 1) {
-      // eslint-disable-next-line no-await-in-loop
-      await userEvent.tab();
-      // eslint-disable-next-line no-await-in-loop
+  for (let i = 0; i < count; i += 1) {
+    await act(async () => {
+      buttons[i].focus();
       await userEvent.keyboard('{Enter}');
-    }
-  });
-
-  // Wait for all tips to finish opening
-  await waitFor(() => {
-    buttons.forEach((button) => {
-      expect(button).toHaveAttribute('aria-expanded', 'true');
     });
-  });
+    await waitFor(() => {
+      expect(buttons[i]).toHaveAttribute('aria-expanded', 'true');
+    });
+  }
 };
 
 export const expectTipsVisible = (tips: { text: string }[]) => {

From 91f5f46d140da0262dd2833ede086ab65d0f383c Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Wed, 18 Mar 2026 11:09:08 -0400
Subject: [PATCH 05/37] ref check

---
 .../src/Anchor/__tests__/Anchor.test.tsx      | 20 ++++-
 packages/gamut/src/Anchor/index.tsx           | 27 +++++--
 packages/gamut/src/ButtonBase/ButtonBase.tsx  | 21 +++--
 .../ButtonBase/__tests__/ButtonBase.test.tsx  | 18 +++++
 .../Form/SelectDropdown/elements/controls.tsx |  2 +-
 .../SelectDropdown/elements/multi-value.tsx   |  2 +-
 .../src/Form/SelectDropdown/types/internal.ts |  6 +-
 packages/gamut/src/Menu/MenuItem.tsx          | 31 ++++---
 .../gamut/src/Menu/__tests__/Menu.test.tsx    | 27 ++++++-
 packages/gamut/src/Popover/Popover.tsx        |  8 +-
 .../src/Popover/__tests__/Popover.test.tsx    | 20 ++++-
 packages/gamut/src/Popover/types.tsx          | 10 +--
 .../src/PopoverContainer/PopoverContainer.tsx | 33 ++++----
 .../__tests__/PopoverContainer.test.tsx       | 18 +++++
 packages/gamut/src/PopoverContainer/hooks.ts  | 80 +++++++++++--------
 packages/gamut/src/PopoverContainer/types.ts  |  5 +-
 packages/gamut/src/Tip/shared/types.tsx       |  6 +-
 17 files changed, 238 insertions(+), 96 deletions(-)

diff --git a/packages/gamut/src/Anchor/__tests__/Anchor.test.tsx b/packages/gamut/src/Anchor/__tests__/Anchor.test.tsx
index 7aedaca8f59..5e36e529d60 100644
--- a/packages/gamut/src/Anchor/__tests__/Anchor.test.tsx
+++ b/packages/gamut/src/Anchor/__tests__/Anchor.test.tsx
@@ -1,6 +1,7 @@
 import { MiniWarningTriangleIcon } from '@codecademy/gamut-icons';
 import { setupRtl } from '@codecademy/gamut-tests';
-import { screen } from '@testing-library/react';
+import { render, screen } from '@testing-library/react';
+import React from 'react';
 
 import { Anchor } from '..';
 
@@ -33,4 +34,21 @@ describe('Anchor', () => {
 
     expect(buttonElement).toHaveTextContent(anchorText);
   });
+
+  it('forwards ref to the anchor element', () => {
+    const ref = React.createRef<HTMLAnchorElement>();
+    render(
+      <Anchor href={href} ref={ref}>
+        {anchorText}
+      </Anchor>
+    );
+    expect(ref.current).toBeInstanceOf(HTMLAnchorElement);
+    expect(ref.current).toHaveAttribute('href', href);
+  });
+
+  it('forwards ref to the button when rendered without href', () => {
+    const ref = React.createRef<HTMLButtonElement>();
+    render(<Anchor ref={ref}>{anchorText}</Anchor>);
+    expect(ref.current).toBeInstanceOf(HTMLButtonElement);
+  });
 });
diff --git a/packages/gamut/src/Anchor/index.tsx b/packages/gamut/src/Anchor/index.tsx
index 287ff0e6d37..677074fac9a 100644
--- a/packages/gamut/src/Anchor/index.tsx
+++ b/packages/gamut/src/Anchor/index.tsx
@@ -1,9 +1,19 @@
 import { styledOptions, system, variant } from '@codecademy/gamut-styles';
 import { StyleProps, variance } from '@codecademy/variance';
 import styled from '@emotion/styled';
-import { ComponentProps, forwardRef, HTMLProps, RefObject } from 'react';
+import {
+  ComponentProps,
+  ComponentType,
+  forwardRef,
+  HTMLProps,
+  Ref,
+} from 'react';
 
-import { ButtonBase, ButtonSelectors } from '../ButtonBase/ButtonBase';
+import {
+  ButtonBase,
+  ButtonSelectors,
+  narrowButtonBaseRef,
+} from '../ButtonBase/ButtonBase';
 import { AppendedIconProps, appendIconToContent } from '../helpers';
 
 export interface AnchorProps
@@ -107,11 +117,18 @@ const anchorProps = variance.compose(
   system.typography
 );
 
-export const AnchorBase = styled('a', styledOptions<'a'>())<AnchorProps>(
+const AnchorBaseStyled = styled('a', styledOptions<'a'>())<AnchorProps>(
   anchorVariants,
   anchorProps
 );
 
+/** AnchorBase ref accepts anchor or button because it can render as ButtonBase when there is no href. */
+export const AnchorBase = AnchorBaseStyled as ComponentType<
+  Omit<ComponentProps<typeof AnchorBaseStyled>, 'ref'> & {
+    ref?: Ref<HTMLAnchorElement | HTMLButtonElement | null>;
+  }
+>;
+
 type AnchorBaseProps =
   | ComponentProps<typeof AnchorBase>
   | (Exclude<ComponentProps<typeof AnchorBase>, 'ref'> &
@@ -150,7 +167,7 @@ export const Anchor = forwardRef<
       return (
         <AnchorBase
           as={ButtonBase}
-          ref={ref as RefObject<HTMLAnchorElement>}
+          ref={narrowButtonBaseRef<HTMLButtonElement>(ref)}
           variant={variant}
           {...rest}
         >
@@ -161,7 +178,7 @@ export const Anchor = forwardRef<
 
     return (
       <AnchorBase
-        ref={ref as RefObject<HTMLAnchorElement>}
+        ref={narrowButtonBaseRef<HTMLAnchorElement>(ref)}
         variant={variant}
         {...rest}
       >
diff --git a/packages/gamut/src/ButtonBase/ButtonBase.tsx b/packages/gamut/src/ButtonBase/ButtonBase.tsx
index 3441636cf52..5c365befb3e 100644
--- a/packages/gamut/src/ButtonBase/ButtonBase.tsx
+++ b/packages/gamut/src/ButtonBase/ButtonBase.tsx
@@ -1,12 +1,9 @@
 import { css, styledOptions } from '@codecademy/gamut-styles';
 import styled from '@emotion/styled';
-import { ComponentProps, forwardRef, HTMLProps, MutableRefObject } from 'react';
+import { ComponentProps, forwardRef, HTMLProps, Ref } from 'react';
 
 export type ButtonBaseElements = HTMLAnchorElement | HTMLButtonElement;
-export type ButtonBaseRef =
-  | ((instance: ButtonBaseElements | null) => void)
-  | MutableRefObject<ButtonBaseElements | null>
-  | null;
+export type ButtonBaseRef = Ref<ButtonBaseElements | null>;
 
 export type ButtonBaseElementProps = HTMLProps<
   HTMLAnchorElement | HTMLButtonElement
@@ -62,6 +59,16 @@ type ButtonBaseProps =
   | (Exclude<ComponentProps<typeof ResetElement>, 'ref'> &
       ComponentProps<typeof ResetElementAnchor>);
 
+/**
+ * Narrows a ref union (anchor | button) to the element type for the current render branch.
+ * Use when forwarding refs from components that render either an anchor or a button (e.g. ButtonBase, Anchor).
+ */
+export function narrowButtonBaseRef<T extends ButtonBaseElements>(
+  ref: Ref<ButtonBaseElements | null>
+): Ref<T> {
+  return ref as Ref<T>;
+}
+
 export const ButtonBase = forwardRef<
   HTMLButtonElement | HTMLAnchorElement,
   ButtonBaseProps
@@ -76,7 +83,7 @@ export const ButtonBase = forwardRef<
         {...filteredProps}
         as="button"
         disabled={!!disabled}
-        ref={ref as MutableRefObject<HTMLButtonElement>}
+        ref={narrowButtonBaseRef<HTMLButtonElement>(ref)}
         role={role}
         type={type}
       >
@@ -90,7 +97,7 @@ export const ButtonBase = forwardRef<
       {...rest}
       as="a"
       href={rest?.href}
-      ref={ref as MutableRefObject<HTMLAnchorElement>}
+      ref={narrowButtonBaseRef<HTMLAnchorElement>(ref)}
       role={role}
     >
       {children}
diff --git a/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx b/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx
index 62eeff1b449..a6ed56503d2 100644
--- a/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx
+++ b/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx
@@ -1,4 +1,6 @@
 import { setupRtl } from '@codecademy/gamut-tests';
+import { render } from '@testing-library/react';
+import React from 'react';
 
 import { ButtonBase } from '../ButtonBase';
 
@@ -53,4 +55,20 @@ describe('ButtonBase', () => {
       expect(el.getAttribute('disabled')).toBe('');
     });
   });
+
+  it('forwards ref to the button element', () => {
+    const ref = React.createRef<HTMLButtonElement>();
+    render(<ButtonBase ref={ref}>{buttonText}</ButtonBase>);
+    expect(ref.current).toBeInstanceOf(HTMLButtonElement);
+  });
+
+  it('forwards ref to the anchor when href is provided', () => {
+    const ref = React.createRef<HTMLAnchorElement>();
+    render(
+      <ButtonBase ref={ref} href="https://www.codecademy.com">
+        {buttonText}
+      </ButtonBase>
+    );
+    expect(ref.current).toBeInstanceOf(HTMLAnchorElement);
+  });
 });
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx b/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
index 3152ed97e2c..422584fd0f5 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
@@ -90,7 +90,7 @@ export const RemoveAllButton = (props: SizedIndicatorProps) => {
       selectInputRef?.current &&
       (e.key === 'ArrowRight' || e.key === 'ArrowLeft' || e.key === 'ArrowDown')
     ) {
-      selectInputRef?.current.focus();
+      selectInputRef.current.focus();
     }
   };
 
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx b/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx
index bb1d2002565..716941d2a22 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx
@@ -109,7 +109,7 @@ export const RemoveAllButton = (props: SizedIndicatorProps) => {
       selectInputRef?.current &&
       (e.key === 'ArrowRight' || e.key === 'ArrowLeft' || e.key === 'ArrowDown')
     ) {
-      selectInputRef?.current.focus();
+      selectInputRef.current.focus();
     }
   };
 
diff --git a/packages/gamut/src/Form/SelectDropdown/types/internal.ts b/packages/gamut/src/Form/SelectDropdown/types/internal.ts
index 8a151e2102c..fabd1307227 100644
--- a/packages/gamut/src/Form/SelectDropdown/types/internal.ts
+++ b/packages/gamut/src/Form/SelectDropdown/types/internal.ts
@@ -14,12 +14,10 @@ export type InternalSelectProps = {
 };
 
 /**
- * Ref type for programmatic focus management.
+ * Ref type for programmatic focus management (internal refs from useRef).
  * Used for managing focus on select input and remove all button.
  */
-export type ProgramaticFocusRef =
-  | React.MutableRefObject<HTMLDivElement>
-  | React.MutableRefObject<null>;
+export type ProgramaticFocusRef = React.RefObject<HTMLDivElement | null>;
 
 /**
  * Context value for SelectDropdown internal state management.
diff --git a/packages/gamut/src/Menu/MenuItem.tsx b/packages/gamut/src/Menu/MenuItem.tsx
index 0429e639192..9669ee51866 100644
--- a/packages/gamut/src/Menu/MenuItem.tsx
+++ b/packages/gamut/src/Menu/MenuItem.tsx
@@ -4,7 +4,7 @@ import {
   ComponentProps,
   forwardRef,
   MouseEventHandler,
-  MutableRefObject,
+  Ref,
   useId,
 } from 'react';
 
@@ -60,6 +60,21 @@ interface MenuTextItem extends HTMLProps, ForwardListItemProps {
 
 type MenuItemTypes = MenuItemIconOnly | MenuTextItem;
 
+type MenuItemRefElement =
+  | HTMLLIElement
+  | HTMLAnchorElement
+  | HTMLButtonElement;
+
+/**
+ * Narrows the forwarded ref union to a specific element type for the current render branch.
+ * MenuItem renders exactly one of li, a, or button per call, so the ref is forwarded to that element.
+ */
+function narrowMenuItemRef<T extends MenuItemRefElement>(
+  ref: React.Ref<MenuItemRefElement | null>
+): Ref<T> {
+  return ref as Ref<T>;
+}
+
 export const MenuItem = forwardRef<
   HTMLLIElement | HTMLAnchorElement | HTMLButtonElement,
   MenuItemTypes
@@ -133,15 +148,13 @@ export const MenuItem = forwardRef<
     );
 
     if (listItemType === 'link' && !disabled) {
-      const linkRef = ref as MutableRefObject<HTMLAnchorElement>;
-
       return (
         <ListItem {...listItemProps}>
           <MenuToolTipWrapper label={label} tipId={tipId}>
             <ListLink
               {...(computed as ListLinkProps)}
               href={href}
-              ref={linkRef}
+              ref={narrowMenuItemRef<HTMLAnchorElement>(ref)}
               target={target}
             >
               {content}
@@ -152,7 +165,6 @@ export const MenuItem = forwardRef<
     }
 
     if (listItemType === 'button' || (listItemType === 'link' && disabled)) {
-      const buttonRef = ref as MutableRefObject<HTMLButtonElement>;
       const handleClick: MouseEventHandler<HTMLButtonElement> = disabled
         ? () => null
         : (props.onClick as any as MouseEventHandler<HTMLButtonElement>);
@@ -162,7 +174,7 @@ export const MenuItem = forwardRef<
           <MenuToolTipWrapper label={label} tipId={tipId}>
             <ListButton
               {...(computed as ListLinkProps)}
-              ref={buttonRef}
+              ref={narrowMenuItemRef<HTMLButtonElement>(ref)}
               onClick={handleClick}
             >
               {content}
@@ -172,11 +184,12 @@ export const MenuItem = forwardRef<
       );
     }
 
-    const liRef = ref as MutableRefObject<HTMLLIElement>;
-
     return (
       // These are non-interactive and will never have tooltips (nor should they).
-      <ListItem {...(computed as ListItemProps)} ref={liRef}>
+      <ListItem
+        {...(computed as ListItemProps)}
+        ref={narrowMenuItemRef<HTMLLIElement>(ref)}
+      >
         {content}
       </ListItem>
     );
diff --git a/packages/gamut/src/Menu/__tests__/Menu.test.tsx b/packages/gamut/src/Menu/__tests__/Menu.test.tsx
index 883c39d1604..bd8e0e50fa8 100644
--- a/packages/gamut/src/Menu/__tests__/Menu.test.tsx
+++ b/packages/gamut/src/Menu/__tests__/Menu.test.tsx
@@ -1,7 +1,8 @@
 import { MultipleUsersIcon } from '@codecademy/gamut-icons';
 import { setupRtl } from '@codecademy/gamut-tests';
-import { screen } from '@testing-library/react';
+import { render, screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
+import React from 'react';
 
 import { Menu } from '../Menu';
 import { MenuItem } from '../MenuItem';
@@ -32,6 +33,30 @@ describe('Menu', () => {
     screen.getByRole('link');
     expect(screen.queryByRole('menuitem')).toBeNull();
   });
+
+  it('forwards ref to the link when MenuItem has href', () => {
+    const ref = React.createRef<HTMLAnchorElement>();
+    render(
+      <Menu>
+        <MenuItem href="#link" ref={ref}>
+          Cool Town
+        </MenuItem>
+      </Menu>
+    );
+    expect(ref.current).toBeInstanceOf(HTMLAnchorElement);
+  });
+
+  it('forwards ref to the button when MenuItem has onClick', () => {
+    const ref = React.createRef<HTMLButtonElement>();
+    render(
+      <Menu>
+        <MenuItem ref={ref} onClick={() => null}>
+          Cool Town
+        </MenuItem>
+      </Menu>
+    );
+    expect(ref.current).toBeInstanceOf(HTMLButtonElement);
+  });
   it('renders MenuItems with onClicks as buttons within a li', () => {
     renderView({
       children: <MenuItem onClick={() => null}>Cool Town</MenuItem>,
diff --git a/packages/gamut/src/Popover/Popover.tsx b/packages/gamut/src/Popover/Popover.tsx
index 86bbb05d9ee..c83e4f7a6ac 100755
--- a/packages/gamut/src/Popover/Popover.tsx
+++ b/packages/gamut/src/Popover/Popover.tsx
@@ -3,6 +3,7 @@ import { useWindowScroll, useWindowSize } from 'react-use';
 
 import { FocusTrap } from '../FocusTrap';
 import {
+  getRefElement,
   useResizingParentEffect,
   useScrollingParentsEffect,
 } from '../PopoverContainer/hooks';
@@ -137,12 +138,12 @@ export const Popover: React.FC<PopoverProps> = ({
   ]);
 
   useEffect(() => {
-    setTargetRect(targetRef?.current?.getBoundingClientRect());
+    setTargetRect(getRefElement(targetRef)?.getBoundingClientRect());
   }, [targetRef, isOpen, width, height, x, y]);
 
   const updateTargetPosition = useCallback(
     (rect?: DOMRect) => {
-      const target = targetRef?.current;
+      const target = getRefElement(targetRef);
       if (!target) return;
 
       const newRect = rect || target.getBoundingClientRect();
@@ -152,7 +153,6 @@ export const Popover: React.FC<PopoverProps> = ({
   );
 
   useScrollingParentsEffect(targetRef, updateTargetPosition);
-
   useResizingParentEffect(targetRef, setTargetRect);
 
   useEffect(() => {
@@ -172,7 +172,7 @@ export const Popover: React.FC<PopoverProps> = ({
   const handleClickOutside = useCallback(
     (e: MouseEvent) => {
       const target = e.target as Node;
-      const targetElement = targetRef.current;
+      const targetElement = getRefElement(targetRef);
 
       if (!targetElement) return;
 
diff --git a/packages/gamut/src/Popover/__tests__/Popover.test.tsx b/packages/gamut/src/Popover/__tests__/Popover.test.tsx
index fe3700e3b9d..86575610a03 100644
--- a/packages/gamut/src/Popover/__tests__/Popover.test.tsx
+++ b/packages/gamut/src/Popover/__tests__/Popover.test.tsx
@@ -2,7 +2,8 @@ import { CheckerDense } from '@codecademy/gamut-patterns';
 import { theme } from '@codecademy/gamut-styles';
 import { setupRtl } from '@codecademy/gamut-tests';
 import { ThemeProvider } from '@emotion/react';
-import { fireEvent } from '@testing-library/react';
+import { fireEvent, render, screen } from '@testing-library/react';
+import React from 'react';
 
 import { Popover, PopoverProps } from '..';
 
@@ -57,6 +58,23 @@ describe('Popover', () => {
     expect(popoverIsRendered(view)).toBeTruthy();
   });
 
+  it('accepts targetRef from useRef and renders when open', () => {
+    const PopoverWithUseRefTarget = () => {
+      const targetRef = React.useRef<HTMLDivElement>(null);
+      return (
+        <ThemeProvider theme={theme}>
+          <div data-testid="popover-target" ref={targetRef} />
+          <Popover isOpen targetRef={targetRef}>
+            <div data-testid="popover-content">Content</div>
+          </Popover>
+          <div data-testid="outside-popover">outside</div>
+        </ThemeProvider>
+      );
+    };
+    render(<PopoverWithUseRefTarget />);
+    expect(screen.getByTestId('popover-content')).toBeInTheDocument();
+  });
+
   it('triggers onRequestClose callback when clicking outside', () => {
     const onRequestClose = jest.fn();
     const { view } = renderView({
diff --git a/packages/gamut/src/Popover/types.tsx b/packages/gamut/src/Popover/types.tsx
index 1a605f43097..e563b60b0b4 100755
--- a/packages/gamut/src/Popover/types.tsx
+++ b/packages/gamut/src/Popover/types.tsx
@@ -97,18 +97,14 @@ export type PopoverProps = PopoverBaseProps &
 
     /**
      * The target element around which the popover will be positioned.
+     * Only ref objects (e.g. from useRef) are supported at runtime; RefCallback is not.
      */
-    targetRef: React.RefObject<Pick<
-      HTMLDivElement,
-      'getBoundingClientRect' | 'contains'
-    > | null>;
+    targetRef: React.Ref<HTMLElement | null>;
 
     /**
      * The PopoverContainer which contents will be rendered into.
      */
-    popoverContainerRef?:
-      | React.RefObject<HTMLDivElement | null>
-      | React.RefCallback<HTMLDivElement>;
+    popoverContainerRef?: React.Ref<HTMLDivElement | null>;
 
     /**
      * Whether to add width restrictions to Popover.
diff --git a/packages/gamut/src/PopoverContainer/PopoverContainer.tsx b/packages/gamut/src/PopoverContainer/PopoverContainer.tsx
index 09c66536ff1..032364e2ae4 100644
--- a/packages/gamut/src/PopoverContainer/PopoverContainer.tsx
+++ b/packages/gamut/src/PopoverContainer/PopoverContainer.tsx
@@ -8,11 +8,13 @@ import { useWindowScroll, useWindowSize } from 'react-use';
 import { BodyPortal } from '../BodyPortal';
 import { FocusTrap } from '../FocusTrap';
 import {
+  getRefElement,
+  getTargetAsElement,
   useResizingParentEffect,
   useScrollingParents,
   useScrollingParentsEffect,
 } from './hooks';
-import { ContainerState, PopoverContainerProps } from './types';
+import { ContainerState, PopoverContainerProps, TargetRef } from './types';
 import { getContainers, getPosition, isOutOfView } from './utils';
 
 const PopoverContent = styled.div(
@@ -49,10 +51,7 @@ export const PopoverContainer: React.FC<PopoverContainerProps> = ({
   const [targetRect, setTargetRect] = useState<DOMRect>();
   const parent = containers?.parent;
 
-  // Memoize scrolling parents to avoid expensive DOM traversals
-  const scrollingParents = useScrollingParents(
-    targetRef as React.RefObject<HTMLElement | null>
-  );
+  const scrollingParents = useScrollingParents(targetRef);
 
   // Keep onRequestClose ref up to date
   useEffect(() => {
@@ -64,7 +63,7 @@ export const PopoverContainer: React.FC<PopoverContainerProps> = ({
   const [isRtl, setIsRtl] = useState(false);
   useEffect(() => {
     const checkDirection = () => {
-      const target = targetRef?.current;
+      const target = getRefElement(targetRef);
       const el = target instanceof Element ? target : document.documentElement;
       setIsRtl(getComputedStyle(el).direction === 'rtl');
     };
@@ -96,20 +95,22 @@ export const PopoverContainer: React.FC<PopoverContainerProps> = ({
   }, [parent, x, y, offset, alignment, invertAxis, isRtl]);
 
   useEffect(() => {
-    const target = targetRef?.current;
+    const target = getRefElement(targetRef);
     if (!target) return;
-    setContainers(getContainers(target, inline, { x: winX, y: winY }));
+    setContainers(
+      getContainers(target as TargetRef, inline, { x: winX, y: winY })
+    );
   }, [targetRef, inline, winW, winH, winX, winY, targetRect]);
 
   // Update target rectangle when window size/scroll changes
   useEffect(() => {
-    setTargetRect(targetRef?.current?.getBoundingClientRect());
+    setTargetRect(getRefElement(targetRef)?.getBoundingClientRect());
   }, [targetRef, isOpen, winW, winH, winX, winY]);
 
   // Update target rectangle when parent size/scroll changes
   const updateTargetPosition = useCallback(
     (rect?: DOMRect) => {
-      const target = targetRef?.current;
+      const target = getRefElement(targetRef);
       if (!target) return;
 
       const newRect = rect || target.getBoundingClientRect();
@@ -121,14 +122,16 @@ export const PopoverContainer: React.FC<PopoverContainerProps> = ({
         window.pageYOffset || document.documentElement.scrollTop;
 
       setContainers(
-        getContainers(target, inline, { x: currentScrollX, y: currentScrollY })
+        getContainers(target as TargetRef, inline, {
+          x: currentScrollX,
+          y: currentScrollY,
+        })
       );
     },
     [targetRef, inline]
   );
 
   useScrollingParentsEffect(targetRef, updateTargetPosition);
-
   useResizingParentEffect(targetRef, setTargetRect);
 
   // Handle closeOnViewportExit with cached scrolling parents for performance
@@ -140,7 +143,7 @@ export const PopoverContainer: React.FC<PopoverContainerProps> = ({
 
     const isOut = isOutOfView(
       rect,
-      targetRef?.current as HTMLElement,
+      getTargetAsElement(getRefElement(targetRef)) ?? undefined,
       scrollingParents
     );
 
@@ -165,7 +168,7 @@ export const PopoverContainer: React.FC<PopoverContainerProps> = ({
   const handleClickOutside = useCallback(
     (e: MouseEvent | TouchEvent) => {
       const target = e.target as Node;
-      const targetElement = targetRef.current;
+      const targetElement = getRefElement(targetRef);
 
       if (!targetElement) return;
       if (targetElement.contains(target)) return;
@@ -184,7 +187,7 @@ export const PopoverContainer: React.FC<PopoverContainerProps> = ({
   const handleGlobalClickOutside = useCallback(
     (e: MouseEvent) => {
       const target = e.target as Node;
-      const targetElement = targetRef.current;
+      const targetElement = getRefElement(targetRef);
 
       if (!targetElement || !isOpen) return;
 
diff --git a/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx b/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx
index ebb006d5ea0..964b69673c9 100644
--- a/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx
+++ b/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx
@@ -1,5 +1,6 @@
 import { MockGamutProvider, setupRtl } from '@codecademy/gamut-tests';
 import { cleanup, fireEvent, render, screen } from '@testing-library/react';
+import React from 'react';
 
 import { PopoverContainer } from '..';
 import { PopoverContainerProps, TargetRef } from '../types';
@@ -91,6 +92,23 @@ describe('Popover', () => {
     expect(popoverIsRendered()).toBeTruthy();
   });
 
+  it('accepts targetRef from useRef and renders when open', () => {
+    const ContainerWithUseRefTarget = () => {
+      const targetRef = React.useRef<HTMLDivElement>(null);
+      return (
+        <MockGamutProvider>
+          <div ref={targetRef} data-testid="popover-target" />
+          <PopoverContainer isOpen inline targetRef={targetRef}>
+            <div data-testid="popover-content">Content</div>
+          </PopoverContainer>
+          <div data-testid="outside-popover">outside</div>
+        </MockGamutProvider>
+      );
+    };
+    render(<ContainerWithUseRefTarget />);
+    expect(screen.getByTestId('popover-content')).toBeInTheDocument();
+  });
+
   it('triggers onRequestClose callback when clicking outside', () => {
     const onRequestClose = jest.fn();
     renderView({
diff --git a/packages/gamut/src/PopoverContainer/hooks.ts b/packages/gamut/src/PopoverContainer/hooks.ts
index 8ddd9c13d35..627640a9b1e 100644
--- a/packages/gamut/src/PopoverContainer/hooks.ts
+++ b/packages/gamut/src/PopoverContainer/hooks.ts
@@ -2,28 +2,50 @@ import { useEffect, useMemo } from 'react';
 
 import { findAllAdditionalScrollingParents, findResizingParent } from './utils';
 
+/**
+ * Minimal element shape required for popover positioning.
+ * Accepts both HTMLElement and TargetRef so Popover and PopoverContainer can share hooks.
+ */
+export interface PopoverTargetElement {
+  getBoundingClientRect(): DOMRect;
+  contains(other: Node | null): boolean;
+}
+
+/** Resolves Ref to current element; returns null for RefCallback or null ref. */
+export function getRefElement(
+  ref: React.Ref<PopoverTargetElement | null>
+): PopoverTargetElement | null {
+  if (ref == null) return null;
+  if (typeof ref === 'function') return null;
+  return ref.current;
+}
+
+/** Casts minimal target to HTMLElement for utils that need full DOM (e.g. parentElement). */
+export function getTargetAsElement(
+  target: PopoverTargetElement | null
+): HTMLElement | null {
+  return target as HTMLElement | null;
+}
+
 export const useScrollingParentsEffect = (
-  targetRef: React.RefObject<Pick<
-    HTMLDivElement,
-    'getBoundingClientRect' | 'contains'
-  > | null>,
+  targetRef: React.Ref<PopoverTargetElement | null>,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
   useEffect(() => {
-    if (!targetRef.current) {
-      return;
-    }
+    const target = getRefElement(targetRef);
+    if (!target) return;
 
-    const target = targetRef.current as unknown as HTMLElement;
-    const scrollingParents = findAllAdditionalScrollingParents(target);
+    const scrollingParents = findAllAdditionalScrollingParents(
+      getTargetAsElement(target)!
+    );
 
     const updatePosition = () => {
-      setTargetRect(targetRef?.current?.getBoundingClientRect());
+      const el = getRefElement(targetRef);
+      setTargetRect(el?.getBoundingClientRect());
     };
 
     const cleanup: (() => void)[] = [];
 
-    // Add listeners to all scrolling parents (window scroll handled by useWindowScroll)
     scrollingParents.forEach((parent) => {
       if (parent.addEventListener) {
         parent.addEventListener('scroll', updatePosition, { passive: true });
@@ -40,25 +62,18 @@ export const useScrollingParentsEffect = (
 };
 
 export const useResizingParentEffect = (
-  targetRef: React.RefObject<Pick<
-    HTMLDivElement,
-    'getBoundingClientRect' | 'contains'
-  > | null>,
+  targetRef: React.Ref<PopoverTargetElement | null>,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
   useEffect(() => {
-    // handles movement of target within a clipped container e.g. Drawer
-    if (!targetRef.current || typeof ResizeObserver === 'undefined') {
-      return;
-    }
-    const resizingParent = findResizingParent(
-      targetRef.current as unknown as HTMLElement
-    );
-    if (!resizingParent?.addEventListener) {
-      return;
-    }
+    const target = getRefElement(targetRef);
+    if (!target || typeof ResizeObserver === 'undefined') return;
+
+    const resizingParent = findResizingParent(getTargetAsElement(target)!);
+    if (!resizingParent?.addEventListener) return;
+
     const handler = () => {
-      setTargetRect(targetRef?.current?.getBoundingClientRect());
+      setTargetRect(getRefElement(targetRef)?.getBoundingClientRect());
     };
     const ro = new ResizeObserver(handler);
     ro.observe(resizingParent);
@@ -68,17 +83,14 @@ export const useResizingParentEffect = (
 
 /**
  * Memoizes the list of scrolling parent elements for a target element.
- * This avoids expensive DOM traversals and getComputedStyle calls on every render.
  * Returns an empty array if the target element is not available.
  */
 export const useScrollingParents = (
-  targetRef: React.RefObject<HTMLElement | null>
+  targetRef: React.Ref<PopoverTargetElement | null>
 ): HTMLElement[] => {
   return useMemo(() => {
-    if (!targetRef.current) {
-      return [];
-    }
-    return findAllAdditionalScrollingParents(targetRef.current);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [targetRef.current]);
+    const target = getRefElement(targetRef);
+    if (!target) return [];
+    return findAllAdditionalScrollingParents(getTargetAsElement(target)!);
+  }, [targetRef]);
 };
diff --git a/packages/gamut/src/PopoverContainer/types.ts b/packages/gamut/src/PopoverContainer/types.ts
index e573ddf2313..76935abe9fa 100644
--- a/packages/gamut/src/PopoverContainer/types.ts
+++ b/packages/gamut/src/PopoverContainer/types.ts
@@ -1,4 +1,4 @@
-import { RefObject } from 'react';
+import { Ref } from 'react';
 
 import { WithChildrenProp } from '../utils';
 
@@ -81,8 +81,9 @@ export interface PopoverContainerProps
   onRequestClose?: () => void;
   /**
    * The target element around which the popover will be positioned.
+   * Only ref objects (e.g. from useRef) are supported at runtime; RefCallback is not.
    */
-  targetRef: RefObject<TargetRef | null>;
+  targetRef: Ref<TargetRef | null>;
   /**
    * If true, it will allow outside page interaction. Popover container will still close when clicking outside of the popover or hitting the escape key.
    */
diff --git a/packages/gamut/src/Tip/shared/types.tsx b/packages/gamut/src/Tip/shared/types.tsx
index 2d828c05292..32299dd678e 100644
--- a/packages/gamut/src/Tip/shared/types.tsx
+++ b/packages/gamut/src/Tip/shared/types.tsx
@@ -78,10 +78,8 @@ export type TipPlacementComponentProps = Omit<
   escapeKeyPressHandler?: (event: React.KeyboardEvent<HTMLDivElement>) => void;
   id?: string;
   isTipHidden?: boolean;
-  contentRef?:
-    | React.RefObject<HTMLDivElement | null>
-    | ((node: HTMLDivElement | null) => void);
+  contentRef?: React.Ref<HTMLDivElement | null>;
   type: 'info' | 'tool' | 'preview';
-  wrapperRef?: React.RefObject<HTMLDivElement | null>;
+  wrapperRef?: React.Ref<HTMLDivElement | null>;
   zIndex?: number;
 } & React.PropsWithChildren;

From fc66bcc5890c2c5183f5e1c9d39f2b001812f096 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Wed, 18 Mar 2026 11:51:22 -0400
Subject: [PATCH 06/37] type widening + formatting

---
 packages/gamut/src/Box/Box.tsx                           | 9 ++++++++-
 packages/gamut/src/Box/FlexBox.tsx                       | 9 ++++++++-
 packages/gamut/src/Box/GridBox.tsx                       | 9 ++++++++-
 .../gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx   | 2 +-
 packages/gamut/src/Menu/MenuItem.tsx                     | 5 +----
 packages/gamut/src/Popover/types.tsx                     | 2 +-
 .../PopoverContainer/__tests__/PopoverContainer.test.tsx | 4 ++--
 packages/gamut/src/Tip/__tests__/helpers.tsx             | 7 +++++--
 8 files changed, 34 insertions(+), 13 deletions(-)

diff --git a/packages/gamut/src/Box/Box.tsx b/packages/gamut/src/Box/Box.tsx
index da6263f7e9b..58d5cce18f4 100644
--- a/packages/gamut/src/Box/Box.tsx
+++ b/packages/gamut/src/Box/Box.tsx
@@ -1,11 +1,18 @@
 import { styledOptions } from '@codecademy/gamut-styles';
 import styled from '@emotion/styled';
+import { ComponentProps, ComponentType, Ref } from 'react';
 
 import { BoxProps, boxProps, sharedStates } from './props';
 
-export const Box = styled('div', styledOptions(['fit']))<BoxProps>(
+const BoxStyled = styled('div', styledOptions(['fit']))<BoxProps>(
   sharedStates,
   boxProps
 );
 
+export const Box = BoxStyled as ComponentType<
+  Omit<ComponentProps<typeof BoxStyled>, 'ref'> & {
+    ref?: Ref<HTMLElement | null>;
+  }
+>;
+
 export type { BoxProps } from './props';
diff --git a/packages/gamut/src/Box/FlexBox.tsx b/packages/gamut/src/Box/FlexBox.tsx
index 8bb11d94fe1..c8bc2324da3 100644
--- a/packages/gamut/src/Box/FlexBox.tsx
+++ b/packages/gamut/src/Box/FlexBox.tsx
@@ -1,11 +1,18 @@
 import { css, styledOptions } from '@codecademy/gamut-styles';
 import styled from '@emotion/styled';
+import { ComponentProps, ComponentType, Ref } from 'react';
 
 import { boxProps, FlexBoxProps, flexStates, sharedStates } from './props';
 
-export const FlexBox = styled(
+const FlexBoxStyled = styled(
   'div',
   styledOptions(['fit', 'wrap', 'center', 'column', 'row', 'inline'])
 )<FlexBoxProps>(css({ display: 'flex' }), sharedStates, flexStates, boxProps);
 
+export const FlexBox = FlexBoxStyled as ComponentType<
+  Omit<ComponentProps<typeof FlexBoxStyled>, 'ref'> & {
+    ref?: Ref<HTMLElement | null>;
+  }
+>;
+
 export type { FlexBoxProps } from './props';
diff --git a/packages/gamut/src/Box/GridBox.tsx b/packages/gamut/src/Box/GridBox.tsx
index b005a768020..4df4eda99a9 100644
--- a/packages/gamut/src/Box/GridBox.tsx
+++ b/packages/gamut/src/Box/GridBox.tsx
@@ -1,9 +1,10 @@
 import { styledOptions, system } from '@codecademy/gamut-styles';
 import styled from '@emotion/styled';
+import { ComponentProps, ComponentType, Ref } from 'react';
 
 import { boxProps, GridBoxProps, gridStates, sharedStates } from './props';
 
-export const GridBox = styled(
+const GridBoxStyled = styled(
   'div',
   styledOptions(['fit', 'center', 'fitContent'])
 )<GridBoxProps>(
@@ -12,3 +13,9 @@ export const GridBox = styled(
   gridStates,
   boxProps
 );
+
+export const GridBox = GridBoxStyled as ComponentType<
+  Omit<ComponentProps<typeof GridBoxStyled>, 'ref'> & {
+    ref?: Ref<HTMLElement | null>;
+  }
+>;
diff --git a/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx b/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx
index a6ed56503d2..60aea38e8a4 100644
--- a/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx
+++ b/packages/gamut/src/ButtonBase/__tests__/ButtonBase.test.tsx
@@ -65,7 +65,7 @@ describe('ButtonBase', () => {
   it('forwards ref to the anchor when href is provided', () => {
     const ref = React.createRef<HTMLAnchorElement>();
     render(
-      <ButtonBase ref={ref} href="https://www.codecademy.com">
+      <ButtonBase href="https://www.codecademy.com" ref={ref}>
         {buttonText}
       </ButtonBase>
     );
diff --git a/packages/gamut/src/Menu/MenuItem.tsx b/packages/gamut/src/Menu/MenuItem.tsx
index 9669ee51866..87010792494 100644
--- a/packages/gamut/src/Menu/MenuItem.tsx
+++ b/packages/gamut/src/Menu/MenuItem.tsx
@@ -60,10 +60,7 @@ interface MenuTextItem extends HTMLProps, ForwardListItemProps {
 
 type MenuItemTypes = MenuItemIconOnly | MenuTextItem;
 
-type MenuItemRefElement =
-  | HTMLLIElement
-  | HTMLAnchorElement
-  | HTMLButtonElement;
+type MenuItemRefElement = HTMLLIElement | HTMLAnchorElement | HTMLButtonElement;
 
 /**
  * Narrows the forwarded ref union to a specific element type for the current render branch.
diff --git a/packages/gamut/src/Popover/types.tsx b/packages/gamut/src/Popover/types.tsx
index e563b60b0b4..be69f456b1a 100755
--- a/packages/gamut/src/Popover/types.tsx
+++ b/packages/gamut/src/Popover/types.tsx
@@ -104,7 +104,7 @@ export type PopoverProps = PopoverBaseProps &
     /**
      * The PopoverContainer which contents will be rendered into.
      */
-    popoverContainerRef?: React.Ref<HTMLDivElement | null>;
+    popoverContainerRef?: React.Ref<HTMLElement | null>;
 
     /**
      * Whether to add width restrictions to Popover.
diff --git a/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx b/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx
index 964b69673c9..ddd0c1505aa 100644
--- a/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx
+++ b/packages/gamut/src/PopoverContainer/__tests__/PopoverContainer.test.tsx
@@ -97,8 +97,8 @@ describe('Popover', () => {
       const targetRef = React.useRef<HTMLDivElement>(null);
       return (
         <MockGamutProvider>
-          <div ref={targetRef} data-testid="popover-target" />
-          <PopoverContainer isOpen inline targetRef={targetRef}>
+          <div data-testid="popover-target" ref={targetRef} />
+          <PopoverContainer inline isOpen targetRef={targetRef}>
             <div data-testid="popover-content">Content</div>
           </PopoverContainer>
           <div data-testid="outside-popover">outside</div>
diff --git a/packages/gamut/src/Tip/__tests__/helpers.tsx b/packages/gamut/src/Tip/__tests__/helpers.tsx
index 7f7461d2679..c8adbfbcaf2 100644
--- a/packages/gamut/src/Tip/__tests__/helpers.tsx
+++ b/packages/gamut/src/Tip/__tests__/helpers.tsx
@@ -419,7 +419,8 @@ export const openInfoTipsWithKeyboard = async ({
 }) => {
   const buttons = view.getAllByLabelText('Show information');
 
-  for (let i = 0; i < count; i += 1) {
+  const openNext = async (i: number): Promise<void> => {
+    if (i >= count) return;
     await act(async () => {
       buttons[i].focus();
       await userEvent.keyboard('{Enter}');
@@ -427,7 +428,9 @@ export const openInfoTipsWithKeyboard = async ({
     await waitFor(() => {
       expect(buttons[i]).toHaveAttribute('aria-expanded', 'true');
     });
-  }
+    await openNext(i + 1);
+  };
+  await openNext(0);
 };
 
 export const expectTipsVisible = (tips: { text: string }[]) => {

From 3bb18db93b94478480970d469a171417a25000f9 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Wed, 18 Mar 2026 12:00:57 -0400
Subject: [PATCH 07/37] revert type widening

---
 packages/gamut/src/Box/Box.tsx       | 9 +--------
 packages/gamut/src/Box/FlexBox.tsx   | 9 +--------
 packages/gamut/src/Box/GridBox.tsx   | 9 ++-------
 packages/gamut/src/Popover/types.tsx | 2 +-
 4 files changed, 5 insertions(+), 24 deletions(-)

diff --git a/packages/gamut/src/Box/Box.tsx b/packages/gamut/src/Box/Box.tsx
index 58d5cce18f4..da6263f7e9b 100644
--- a/packages/gamut/src/Box/Box.tsx
+++ b/packages/gamut/src/Box/Box.tsx
@@ -1,18 +1,11 @@
 import { styledOptions } from '@codecademy/gamut-styles';
 import styled from '@emotion/styled';
-import { ComponentProps, ComponentType, Ref } from 'react';
 
 import { BoxProps, boxProps, sharedStates } from './props';
 
-const BoxStyled = styled('div', styledOptions(['fit']))<BoxProps>(
+export const Box = styled('div', styledOptions(['fit']))<BoxProps>(
   sharedStates,
   boxProps
 );
 
-export const Box = BoxStyled as ComponentType<
-  Omit<ComponentProps<typeof BoxStyled>, 'ref'> & {
-    ref?: Ref<HTMLElement | null>;
-  }
->;
-
 export type { BoxProps } from './props';
diff --git a/packages/gamut/src/Box/FlexBox.tsx b/packages/gamut/src/Box/FlexBox.tsx
index c8bc2324da3..8bb11d94fe1 100644
--- a/packages/gamut/src/Box/FlexBox.tsx
+++ b/packages/gamut/src/Box/FlexBox.tsx
@@ -1,18 +1,11 @@
 import { css, styledOptions } from '@codecademy/gamut-styles';
 import styled from '@emotion/styled';
-import { ComponentProps, ComponentType, Ref } from 'react';
 
 import { boxProps, FlexBoxProps, flexStates, sharedStates } from './props';
 
-const FlexBoxStyled = styled(
+export const FlexBox = styled(
   'div',
   styledOptions(['fit', 'wrap', 'center', 'column', 'row', 'inline'])
 )<FlexBoxProps>(css({ display: 'flex' }), sharedStates, flexStates, boxProps);
 
-export const FlexBox = FlexBoxStyled as ComponentType<
-  Omit<ComponentProps<typeof FlexBoxStyled>, 'ref'> & {
-    ref?: Ref<HTMLElement | null>;
-  }
->;
-
 export type { FlexBoxProps } from './props';
diff --git a/packages/gamut/src/Box/GridBox.tsx b/packages/gamut/src/Box/GridBox.tsx
index 4df4eda99a9..67d562fb57c 100644
--- a/packages/gamut/src/Box/GridBox.tsx
+++ b/packages/gamut/src/Box/GridBox.tsx
@@ -1,10 +1,9 @@
 import { styledOptions, system } from '@codecademy/gamut-styles';
 import styled from '@emotion/styled';
-import { ComponentProps, ComponentType, Ref } from 'react';
 
 import { boxProps, GridBoxProps, gridStates, sharedStates } from './props';
 
-const GridBoxStyled = styled(
+export const GridBox = styled(
   'div',
   styledOptions(['fit', 'center', 'fitContent'])
 )<GridBoxProps>(
@@ -14,8 +13,4 @@ const GridBoxStyled = styled(
   boxProps
 );
 
-export const GridBox = GridBoxStyled as ComponentType<
-  Omit<ComponentProps<typeof GridBoxStyled>, 'ref'> & {
-    ref?: Ref<HTMLElement | null>;
-  }
->;
+export type { GridBoxProps } from './props';
diff --git a/packages/gamut/src/Popover/types.tsx b/packages/gamut/src/Popover/types.tsx
index be69f456b1a..e563b60b0b4 100755
--- a/packages/gamut/src/Popover/types.tsx
+++ b/packages/gamut/src/Popover/types.tsx
@@ -104,7 +104,7 @@ export type PopoverProps = PopoverBaseProps &
     /**
      * The PopoverContainer which contents will be rendered into.
      */
-    popoverContainerRef?: React.Ref<HTMLElement | null>;
+    popoverContainerRef?: React.Ref<HTMLDivElement | null>;
 
     /**
      * Whether to add width restrictions to Popover.

From fe532d0ab98c92a2e20e165c7026e2c805972ca0 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Thu, 19 Mar 2026 09:50:29 -0400
Subject: [PATCH 08/37] 18/19

---
 package.json | 10 +++++-----
 yarn.lock    | 43 ++++++++++++++++++++++++++++++-------------
 2 files changed, 35 insertions(+), 18 deletions(-)

diff --git a/package.json b/package.json
index 48253f8864c..92afb0612e5 100644
--- a/package.json
+++ b/package.json
@@ -53,9 +53,9 @@
     "@types/invariant": "2.2.29",
     "@types/konami-code-js": "^0.8.0",
     "@types/lodash": "4.17.23",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@types/react-test-renderer": "^19.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@types/react-test-renderer": "^18.2.0",
     "@types/stylis": "^4.2.0",
     "@typescript-eslint/eslint-plugin": "^5.15.0",
     "@typescript-eslint/parser": "^5.15.0",
@@ -115,8 +115,8 @@
   "resolutions": {
     "@react-aria/interactions": "3.25.0",
     "@typescript-eslint/utils": "^5.15.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "error-ex": "1.3.4"
diff --git a/yarn.lock b/yarn.lock
index 27ca6829700..c7a0bb99a94 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -8221,6 +8221,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/prop-types@npm:*":
+  version: 15.7.15
+  resolution: "@types/prop-types@npm:15.7.15"
+  checksum: 10c0/b59aad1ad19bf1733cf524fd4e618196c6c7690f48ee70a327eb450a42aab8e8a063fbe59ca0a5701aebe2d92d582292c0fb845ea57474f6a15f6994b0e260b2
+  languageName: node
+  linkType: hard
+
 "@types/q@npm:^1.5.1":
   version: 1.5.8
   resolution: "@types/q@npm:1.5.8"
@@ -8242,16 +8249,16 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/react-dom@npm:^19.0.0":
-  version: 19.2.3
-  resolution: "@types/react-dom@npm:19.2.3"
+"@types/react-dom@npm:^18.2.0":
+  version: 18.3.7
+  resolution: "@types/react-dom@npm:18.3.7"
   peerDependencies:
-    "@types/react": ^19.2.0
-  checksum: 10c0/b486ebe0f4e2fb35e2e108df1d8fc0927ca5d6002d5771e8a739de11239fe62d0e207c50886185253c99eb9dedfeeb956ea7429e5ba17f6693c7acb4c02f8cd1
+    "@types/react": ^18.0.0
+  checksum: 10c0/8bd309e2c3d1604a28a736a24f96cbadf6c05d5288cfef8883b74f4054c961b6b3a5e997fd5686e492be903c8f3380dba5ec017eff3906b1256529cd2d39603e
   languageName: node
   linkType: hard
 
-"@types/react-test-renderer@npm:>=16.9.0, @types/react-test-renderer@npm:^19.0.0":
+"@types/react-test-renderer@npm:>=16.9.0":
   version: 19.1.0
   resolution: "@types/react-test-renderer@npm:19.1.0"
   dependencies:
@@ -8260,6 +8267,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/react-test-renderer@npm:^18.2.0":
+  version: 18.3.1
+  resolution: "@types/react-test-renderer@npm:18.3.1"
+  dependencies:
+    "@types/react": "npm:^18"
+  checksum: 10c0/9fc8467ff1a3f14be6cc3498a75fc788d2c92c0fffa7bf21269ed5d9d82db9195bf2178ddc42ea16a0836995c1b77601c6be8abb27bd1864668c418c6d0e5a3b
+  languageName: node
+  linkType: hard
+
 "@types/react-transition-group@npm:^4.4.0":
   version: 4.4.11
   resolution: "@types/react-transition-group@npm:4.4.11"
@@ -8269,12 +8285,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/react@npm:^19.0.0":
-  version: 19.2.14
-  resolution: "@types/react@npm:19.2.14"
+"@types/react@npm:^18.2.0":
+  version: 18.3.28
+  resolution: "@types/react@npm:18.3.28"
   dependencies:
+    "@types/prop-types": "npm:*"
     csstype: "npm:^3.2.2"
-  checksum: 10c0/7d25bf41b57719452d86d2ac0570b659210402707313a36ee612666bf11275a1c69824f8c3ee1fdca077ccfe15452f6da8f1224529b917050eb2d861e52b59b7
+  checksum: 10c0/683e19cd12b5c691215529af2e32b5ffbaccae3bf0ba93bfafa0e460e8dfee18423afed568be2b8eadf4b837c3749dd296a4f64e2d79f68fa66962c05f5af661
   languageName: node
   linkType: hard
 
@@ -14212,9 +14229,9 @@ __metadata:
     "@types/invariant": "npm:2.2.29"
     "@types/konami-code-js": "npm:^0.8.0"
     "@types/lodash": "npm:4.17.23"
-    "@types/react": "npm:^19.0.0"
-    "@types/react-dom": "npm:^19.0.0"
-    "@types/react-test-renderer": "npm:^19.0.0"
+    "@types/react": "npm:^18.2.0"
+    "@types/react-dom": "npm:^18.2.0"
+    "@types/react-test-renderer": "npm:^18.2.0"
     "@types/stylis": "npm:^4.2.0"
     "@typescript-eslint/eslint-plugin": "npm:^5.15.0"
     "@typescript-eslint/parser": "npm:^5.15.0"

From 16e27695a52b7ac9195bf2edd4704e813f8275d7 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Thu, 19 Mar 2026 10:01:19 -0400
Subject: [PATCH 09/37] terst build

---
 packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx   | 2 +-
 .../gamut/src/Form/SelectDropdown/elements/controls.tsx     | 2 +-
 .../gamut/src/Form/SelectDropdown/elements/multi-value.tsx  | 2 +-
 packages/gamut/src/Popover/Popover.tsx                      | 6 ++++--
 packages/gamut/src/Tip/shared/FloatingTip.tsx               | 4 ++--
 packages/gamut/src/Tip/shared/InlineTip.tsx                 | 4 ++--
 6 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
index 553d243604a..51109ad1237 100644
--- a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
@@ -274,7 +274,7 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         isDisabled={disabled}
         isMulti={multiple}
         isOptionDisabled={(option: OptionStrict & { disabled?: boolean }) =>
-          option.disabled
+          option.disabled ?? false
         }
         isSearchable={isSearchable}
         menuAlignment={menuAlignment}
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx b/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
index 422584fd0f5..72dc722749c 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
@@ -102,7 +102,7 @@ export const RemoveAllButton = (props: SizedIndicatorProps) => {
       role="button"
       tabIndex={0}
       {...restInnerProps}
-      ref={removeAllButtonRef}
+      ref={removeAllButtonRef as React.Ref<HTMLDivElement>}
       // eslint-disable-next-line gamut/no-inline-style
       style={style}
       onKeyDown={onKeyPress}
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx b/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx
index 716941d2a22..3744a66e378 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/multi-value.tsx
@@ -121,7 +121,7 @@ export const RemoveAllButton = (props: SizedIndicatorProps) => {
       role="button"
       tabIndex={0}
       {...restInnerProps}
-      ref={removeAllButtonRef}
+      ref={removeAllButtonRef as React.Ref<HTMLDivElement>}
       // eslint-disable-next-line gamut/no-inline-style
       style={style}
       onKeyDown={onKeyPress}
diff --git a/packages/gamut/src/Popover/Popover.tsx b/packages/gamut/src/Popover/Popover.tsx
index c83e4f7a6ac..db41946bdb6 100755
--- a/packages/gamut/src/Popover/Popover.tsx
+++ b/packages/gamut/src/Popover/Popover.tsx
@@ -199,7 +199,9 @@ export const Popover: React.FC<PopoverProps> = ({
       data-floating="popover"
       data-testid="popover-content-container"
       position={position}
-      {...(popoverContainerRef ? { ref: popoverContainerRef } : {})}
+      {...(popoverContainerRef
+        ? { ref: popoverContainerRef as React.Ref<HTMLDivElement> }
+        : {})}
       role={role}
       // eslint-disable-next-line gamut/no-inline-style
       style={getPopoverPosition()}
@@ -208,7 +210,7 @@ export const Popover: React.FC<PopoverProps> = ({
       <RaisedDiv
         alignment={alignment}
         outline={outline ? 'outline' : 'boxShadow'}
-        ref={combinedRef}
+        ref={combinedRef as React.Ref<HTMLDivElement>}
         variant={variant}
         widthRestricted={widthRestricted}
       >
diff --git a/packages/gamut/src/Tip/shared/FloatingTip.tsx b/packages/gamut/src/Tip/shared/FloatingTip.tsx
index 23ff041957b..ce1a8541d49 100644
--- a/packages/gamut/src/Tip/shared/FloatingTip.tsx
+++ b/packages/gamut/src/Tip/shared/FloatingTip.tsx
@@ -142,13 +142,13 @@ export const FloatingTip: React.FC<TipWrapperProps> = ({
       display="inline-flex"
       height={inheritDims ? 'inherit' : undefined}
       position="relative"
-      ref={wrapperRef}
+      ref={wrapperRef as React.Ref<HTMLDivElement>}
       width={inheritDims ? 'inherit' : undefined}
       onMouseLeave={toolOnlyEventFunc}
     >
       <TargetContainer
         height={inheritDims ? 'inherit' : undefined}
-        ref={ref}
+        ref={ref as React.Ref<HTMLDivElement>}
         width={inheritDims ? 'inherit' : undefined}
         onBlur={toolOnlyEventFunc}
         onFocus={toolOnlyEventFunc}
diff --git a/packages/gamut/src/Tip/shared/InlineTip.tsx b/packages/gamut/src/Tip/shared/InlineTip.tsx
index 871cfaac1ac..230ef200950 100644
--- a/packages/gamut/src/Tip/shared/InlineTip.tsx
+++ b/packages/gamut/src/Tip/shared/InlineTip.tsx
@@ -44,7 +44,7 @@ export const InlineTip: React.FC<TipWrapperProps> = ({
   const target = (
     <TargetContainer
       height={inheritDims ? 'inherit' : undefined}
-      ref={wrapperRef}
+      ref={wrapperRef as React.Ref<HTMLDivElement>}
       width={inheritDims ? 'inherit' : undefined}
       onKeyDown={escapeKeyPressHandler}
     >
@@ -64,7 +64,7 @@ export const InlineTip: React.FC<TipWrapperProps> = ({
         color="currentColor"
         horizNarrow={narrow && isHorizontalCenter}
         id={id}
-        ref={contentRef}
+        ref={contentRef as React.Ref<HTMLDivElement>}
         role={type === 'tool' ? 'tooltip' : undefined}
         tabIndex={type === 'info' ? -1 : undefined}
         width={narrow && !isHorizontalCenter ? narrowWidth : 'max-content'}

From bd2e499e56584a13bbf5f83cf957e51cf24f377a Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Thu, 19 Mar 2026 11:06:10 -0400
Subject: [PATCH 10/37] update react-hook-form

---
 packages/gamut/package.json |  2 +-
 yarn.lock                   | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/gamut/package.json b/packages/gamut/package.json
index 37d8c9b63a8..cf912e6e887 100644
--- a/packages/gamut/package.json
+++ b/packages/gamut/package.json
@@ -21,7 +21,7 @@
     "polished": "^4.1.2",
     "react-aria-components": "1.7.1",
     "react-focus-on": "3.10.0",
-    "react-hook-form": "^7.65.0",
+    "react-hook-form": "^7.71.2",
     "react-player": "^2.16.0",
     "react-select": "^5.2.2",
     "react-truncate-markup": "^5.1.2",
diff --git a/yarn.lock b/yarn.lock
index c7a0bb99a94..11785dd02c4 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1726,7 +1726,7 @@ __metadata:
     polished: "npm:^4.1.2"
     react-aria-components: "npm:1.7.1"
     react-focus-on: "npm:3.10.0"
-    react-hook-form: "npm:^7.65.0"
+    react-hook-form: "npm:^7.71.2"
     react-player: "npm:^2.16.0"
     react-select: "npm:^5.2.2"
     react-truncate-markup: "npm:^5.1.2"
@@ -21605,12 +21605,12 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react-hook-form@npm:^7.65.0":
-  version: 7.66.0
-  resolution: "react-hook-form@npm:7.66.0"
+"react-hook-form@npm:^7.71.2":
+  version: 7.71.2
+  resolution: "react-hook-form@npm:7.71.2"
   peerDependencies:
     react: ^16.8.0 || ^17 || ^18 || ^19
-  checksum: 10c0/9faeafdaedfabfcbf5f8bb1aeefb81863b8e158eef4b089e2a32180fe474aec47d05fe3ed7d4faea085ca9f689118fb1135b94cdeed2022bd7d3fa3a56530c63
+  checksum: 10c0/bff61c229f5f2516e650325e0c450146cb8a08dc323e5e9aa0753eb937be0b66fe17f40a7b4be9aabc2b5cb770d03de07db7f4912c6c9452a86924072cc1cb46
   languageName: node
   linkType: hard
 

From 077f07b9218209ee8a357e3b2419e1bf0b898543 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Thu, 19 Mar 2026 11:22:04 -0400
Subject: [PATCH 11/37] put connected form back

---
 packages/gamut/src/ConnectedForm/ConnectedForm.tsx | 8 ++++----
 packages/gamut/src/ConnectedForm/utils.tsx         | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/gamut/src/ConnectedForm/ConnectedForm.tsx b/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
index 1525284e29b..95575145d48 100644
--- a/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
+++ b/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
@@ -181,7 +181,7 @@ export const ConnectedForm = forwardRef(
       </PropsProvider>
     );
   }
-) as React.ForwardRefExoticComponent<
-  ConnectedFormProps<FormValues<Record<string, unknown>>> &
-    React.RefAttributes<HTMLFormElement>
->;
+) as <Values extends FormValues<Values>>(
+  props: ConnectedFormProps<Values>,
+  ref: React.ForwardedRef<HTMLFormElement>
+) => React.ReactElement;
diff --git a/packages/gamut/src/ConnectedForm/utils.tsx b/packages/gamut/src/ConnectedForm/utils.tsx
index caf917c27ff..95560991c7f 100644
--- a/packages/gamut/src/ConnectedForm/utils.tsx
+++ b/packages/gamut/src/ConnectedForm/utils.tsx
@@ -71,7 +71,7 @@ export const useConnectedForm = <
     () => ({
       ConnectedFormGroup:
         ConnectedFormGroup as ConnectedGroupStrictProps<Values>,
-      ConnectedForm: ConnectedForm as unknown as ConnectedFormStrictProps<
+      ConnectedForm: ConnectedForm as ConnectedFormStrictProps<
         Values,
         ValidationRules
       >,

From 469095e8c09f53850fe516a37a551fc90ac82da9 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Thu, 19 Mar 2026 12:40:20 -0400
Subject: [PATCH 12/37] try re-creating ref type in cast;

---
 packages/gamut/src/ConnectedForm/ConnectedForm.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/gamut/src/ConnectedForm/ConnectedForm.tsx b/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
index 95575145d48..f9fa259d0a3 100644
--- a/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
+++ b/packages/gamut/src/ConnectedForm/ConnectedForm.tsx
@@ -182,6 +182,6 @@ export const ConnectedForm = forwardRef(
     );
   }
 ) as <Values extends FormValues<Values>>(
-  props: ConnectedFormProps<Values>,
-  ref: React.ForwardedRef<HTMLFormElement>
+  props: React.PropsWithoutRef<ConnectedFormProps<Values>> &
+    React.RefAttributes<HTMLFormElement>
 ) => React.ReactElement;

From 2df70b13cb435971d08001b98d8877a6be08c002 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Tue, 24 Mar 2026 13:40:51 -0400
Subject: [PATCH 13/37] ts upgrade test

---
 jest.config.base.ts                           |    3 +-
 package.json                                  |   12 +-
 packages/eslint-plugin-gamut/package.json     |    2 +-
 .../src/gamut-import-paths.ts                 |    1 -
 .../src/no-css-standalone.test.ts             |    6 +-
 .../src/no-css-standalone.ts                  |    1 -
 .../src/no-inline-style.test.ts               |    6 +-
 .../src/no-inline-style.ts                    |    8 +-
 .../src/no-kbd-element.test.ts                |    6 +-
 .../eslint-plugin-gamut/src/no-kbd-element.ts |    8 +-
 .../src/prefer-themed.test.ts                 |    6 +-
 .../eslint-plugin-gamut/src/prefer-themed.ts  |    1 -
 .../ButtonDeprecated/index.tsx                |    4 +-
 .../__tests__/FeatureShimmer.test.tsx         |    1 +
 .../gamut/src/Form/SelectDropdown/utils.tsx   |    4 +-
 .../__snapshots__/utils.test.tsx.snap         |   80 +-
 packages/gamut/src/PopoverContainer/hooks.ts  |    3 +-
 .../gamut/src/utils/__tests__/nullish.test.ts |   38 +
 packages/gamut/src/utils/nullish.ts           |   13 +
 packages/gamut/src/utils/react.ts             |    4 +-
 .../PopoverContainer.stories.tsx              |    2 +-
 .../src/lib/Molecules/Tips/TipsTable.tsx      |    4 +-
 .../Tips/ToolTip/ToolTip.stories.tsx          |    1 +
 .../ConnectedFormInputsTable.tsx              |    2 +-
 .../Lists & Tables/List/List.stories.tsx      |    6 +-
 .../variance/src/createTheme/createTheme.ts   |    3 +-
 yarn.lock                                     | 2886 +++++++++++++----
 27 files changed, 2340 insertions(+), 771 deletions(-)
 create mode 100644 packages/gamut/src/utils/__tests__/nullish.test.ts
 create mode 100644 packages/gamut/src/utils/nullish.ts

diff --git a/jest.config.base.ts b/jest.config.base.ts
index 2e38f7e7c85..e4e0e604713 100644
--- a/jest.config.base.ts
+++ b/jest.config.base.ts
@@ -1,6 +1,7 @@
-import type { Config } from 'jest';
 import path from 'node:path';
 
+import type { Config } from 'jest';
+
 const COVERAGE_PATH_IGNORE_PATTERNS = [
   '<rootDir>/node_modules/',
   '<rootDir>/dist/',
diff --git a/package.json b/package.json
index 92afb0612e5..6db58c6348e 100644
--- a/package.json
+++ b/package.json
@@ -19,7 +19,7 @@
     "@babel/preset-env": "^7.24.7",
     "@babel/preset-react": "^7.24.7",
     "@babel/preset-typescript": "^7.24.7",
-    "@codecademy/eslint-config": "8.0.0",
+    "@codecademy/eslint-config": "8.2.0",
     "@codecademy/prettier-config": "^0.2.0",
     "@codecademy/tsconfig": "^0.3.0",
     "@emotion/babel-plugin": "11.11.0",
@@ -57,15 +57,15 @@
     "@types/react-dom": "^18.2.0",
     "@types/react-test-renderer": "^18.2.0",
     "@types/stylis": "^4.2.0",
-    "@typescript-eslint/eslint-plugin": "^5.15.0",
-    "@typescript-eslint/parser": "^5.15.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
     "babel-jest": "29.6.4",
     "babel-plugin-macros": "3.0.1",
     "component-test-setup": "^0.3.1",
     "conventional-changelog-cli": "^2.0.34",
     "conventional-changelog-conventionalcommits": "^4.3.0",
     "cpy-cli": "^4.1.0",
-    "eslint": "^8.11.0",
+    "eslint": "^8.57.0",
     "eslint-plugin-gamut": "^2.0.0",
     "eslint-plugin-local-rules": "^1.1.0",
     "eslint-plugin-lodash": "^7.4.0",
@@ -93,7 +93,7 @@
     "ts-jest": "29.1.1",
     "ts-node": "10.9.1",
     "tslib": "2.4.0",
-    "typescript": "5.1.3"
+    "typescript": "5.9.3"
   },
   "engines": {
     "node": "^22.13.1",
@@ -114,7 +114,7 @@
   "repository": "git@github.com:Codecademy/gamut.git",
   "resolutions": {
     "@react-aria/interactions": "3.25.0",
-    "@typescript-eslint/utils": "^5.15.0",
+    "@typescript-eslint/utils": "^8.57.0",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "react": "^19.0.0",
diff --git a/packages/eslint-plugin-gamut/package.json b/packages/eslint-plugin-gamut/package.json
index 2c14378072c..d0a6c25e80b 100644
--- a/packages/eslint-plugin-gamut/package.json
+++ b/packages/eslint-plugin-gamut/package.json
@@ -4,7 +4,7 @@
   "version": "2.4.2",
   "author": "Codecademy Engineering <dev@codecademy.com>",
   "dependencies": {
-    "@typescript-eslint/utils": "^5.15.0"
+    "@typescript-eslint/utils": "^8.57.0"
   },
   "files": [
     "dist"
diff --git a/packages/eslint-plugin-gamut/src/gamut-import-paths.ts b/packages/eslint-plugin-gamut/src/gamut-import-paths.ts
index a7fcb9601fb..e2253ba7b64 100644
--- a/packages/eslint-plugin-gamut/src/gamut-import-paths.ts
+++ b/packages/eslint-plugin-gamut/src/gamut-import-paths.ts
@@ -59,7 +59,6 @@ export default createRule({
   meta: {
     docs: {
       description: 'Ensure Gamut import statements have proper module paths.',
-      recommended: 'error',
     },
     fixable: 'code',
     messages: {
diff --git a/packages/eslint-plugin-gamut/src/no-css-standalone.test.ts b/packages/eslint-plugin-gamut/src/no-css-standalone.test.ts
index cada3987044..1094f1e4993 100644
--- a/packages/eslint-plugin-gamut/src/no-css-standalone.test.ts
+++ b/packages/eslint-plugin-gamut/src/no-css-standalone.test.ts
@@ -1,9 +1,9 @@
-import { ESLintUtils } from '@typescript-eslint/utils';
+import { TSESLint } from '@typescript-eslint/utils';
 
 import rule from './no-css-standalone';
 
-const ruleTester = new ESLintUtils.RuleTester({
-  parser: '@typescript-eslint/parser',
+const ruleTester = new TSESLint.RuleTester({
+  parser: require.resolve('@typescript-eslint/parser'),
 });
 
 ruleTester.run('no-css-standalone', rule, {
diff --git a/packages/eslint-plugin-gamut/src/no-css-standalone.ts b/packages/eslint-plugin-gamut/src/no-css-standalone.ts
index fe1c66a8656..e6e2e55fd2f 100644
--- a/packages/eslint-plugin-gamut/src/no-css-standalone.ts
+++ b/packages/eslint-plugin-gamut/src/no-css-standalone.ts
@@ -15,7 +15,6 @@ export default createRule({
   meta: {
     docs: {
       description: 'Ensure no standalone .css or .scss files.',
-      recommended: 'error',
     },
     messages: {
       noCssStandalone:
diff --git a/packages/eslint-plugin-gamut/src/no-inline-style.test.ts b/packages/eslint-plugin-gamut/src/no-inline-style.test.ts
index a1c24e75981..ab7c5c53e13 100644
--- a/packages/eslint-plugin-gamut/src/no-inline-style.test.ts
+++ b/packages/eslint-plugin-gamut/src/no-inline-style.test.ts
@@ -1,9 +1,9 @@
-import { ESLintUtils } from '@typescript-eslint/utils';
+import { TSESLint } from '@typescript-eslint/utils';
 
 import rule from './no-inline-style';
 
-const ruleTester = new ESLintUtils.RuleTester({
-  parser: '@typescript-eslint/parser',
+const ruleTester = new TSESLint.RuleTester({
+  parser: require.resolve('@typescript-eslint/parser'),
   parserOptions: {
     ecmaFeatures: {
       jsx: true,
diff --git a/packages/eslint-plugin-gamut/src/no-inline-style.ts b/packages/eslint-plugin-gamut/src/no-inline-style.ts
index 8e063bbde13..df899dd38b4 100644
--- a/packages/eslint-plugin-gamut/src/no-inline-style.ts
+++ b/packages/eslint-plugin-gamut/src/no-inline-style.ts
@@ -1,10 +1,15 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+
 import { createRule } from './createRule';
 
 export default createRule({
   create(context) {
     return {
       JSXAttribute(node) {
-        if (node.name.type === 'JSXIdentifier' && node.name.name === 'style') {
+        if (
+          node.name.type === AST_NODE_TYPES.JSXIdentifier &&
+          node.name.name === 'style'
+        ) {
           context.report({
             messageId: 'noInlineStyle',
             node,
@@ -17,7 +22,6 @@ export default createRule({
   meta: {
     docs: {
       description: 'Disallow inline style props on JSX elements.',
-      recommended: 'error',
     },
     messages: {
       noInlineStyle:
diff --git a/packages/eslint-plugin-gamut/src/no-kbd-element.test.ts b/packages/eslint-plugin-gamut/src/no-kbd-element.test.ts
index fc2c7f13da1..30dee531773 100644
--- a/packages/eslint-plugin-gamut/src/no-kbd-element.test.ts
+++ b/packages/eslint-plugin-gamut/src/no-kbd-element.test.ts
@@ -1,9 +1,9 @@
-import { ESLintUtils } from '@typescript-eslint/utils';
+import { TSESLint } from '@typescript-eslint/utils';
 
 import rule from './no-kbd-element';
 
-const ruleTester = new ESLintUtils.RuleTester({
-  parser: '@typescript-eslint/parser',
+const ruleTester = new TSESLint.RuleTester({
+  parser: require.resolve('@typescript-eslint/parser'),
   parserOptions: {
     ecmaFeatures: {
       jsx: true,
diff --git a/packages/eslint-plugin-gamut/src/no-kbd-element.ts b/packages/eslint-plugin-gamut/src/no-kbd-element.ts
index f90de6d1cbc..1e644060933 100644
--- a/packages/eslint-plugin-gamut/src/no-kbd-element.ts
+++ b/packages/eslint-plugin-gamut/src/no-kbd-element.ts
@@ -1,10 +1,15 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+
 import { createRule } from './createRule';
 
 export default createRule({
   create(context) {
     return {
       JSXOpeningElement(node) {
-        if (node.name.type === 'JSXIdentifier' && node.name.name === 'kbd') {
+        if (
+          node.name.type === AST_NODE_TYPES.JSXIdentifier &&
+          node.name.name === 'kbd'
+        ) {
           context.report({
             messageId: 'noKbdElement',
             node,
@@ -18,7 +23,6 @@ export default createRule({
     docs: {
       description:
         'Intended to be used in Storybook docs to disallow use of the `kbd` HTML element in favor of the `KeyboardKey` component for styling purposes.',
-      recommended: 'error',
     },
     messages: {
       noKbdElement: 'Please use the `KeyboardKey` component instead.',
diff --git a/packages/eslint-plugin-gamut/src/prefer-themed.test.ts b/packages/eslint-plugin-gamut/src/prefer-themed.test.ts
index 1a438cd3247..3d9383afb0c 100644
--- a/packages/eslint-plugin-gamut/src/prefer-themed.test.ts
+++ b/packages/eslint-plugin-gamut/src/prefer-themed.test.ts
@@ -1,9 +1,9 @@
-import { ESLintUtils } from '@typescript-eslint/utils';
+import { TSESLint } from '@typescript-eslint/utils';
 
 import rule from './prefer-themed';
 
-const ruleTester = new ESLintUtils.RuleTester({
-  parser: '@typescript-eslint/parser',
+const ruleTester = new TSESLint.RuleTester({
+  parser: require.resolve('@typescript-eslint/parser'),
 });
 
 ruleTester.run('prefer-themed', rule, {
diff --git a/packages/eslint-plugin-gamut/src/prefer-themed.ts b/packages/eslint-plugin-gamut/src/prefer-themed.ts
index 45892f197e5..8e45b4d0502 100644
--- a/packages/eslint-plugin-gamut/src/prefer-themed.ts
+++ b/packages/eslint-plugin-gamut/src/prefer-themed.ts
@@ -48,7 +48,6 @@ export default createRule({
   meta: {
     docs: {
       description: 'Prefer themed style utility',
-      recommended: 'error',
     },
     fixable: 'code',
     messages: {
diff --git a/packages/gamut/src/AccordionButtonDeprecated/ButtonDeprecated/index.tsx b/packages/gamut/src/AccordionButtonDeprecated/ButtonDeprecated/index.tsx
index ae65e0f0dd5..ab55b5e7b72 100644
--- a/packages/gamut/src/AccordionButtonDeprecated/ButtonDeprecated/index.tsx
+++ b/packages/gamut/src/AccordionButtonDeprecated/ButtonDeprecated/index.tsx
@@ -21,7 +21,7 @@ export const buttonPresetThemes = {
   royalblue: 'brand-purple',
 } as const;
 
-const themes = [
+const _themes = [
   'hyper',
   'navy',
   'red',
@@ -39,7 +39,7 @@ const themes = [
 
 export type ButtonDeprecatedThemes =
   | keyof typeof buttonPresetThemes
-  | (typeof themes)[number];
+  | (typeof _themes)[number];
 
 const propKeys = [
   'theme',
diff --git a/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx b/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx
index c5bb6d7704a..d7a957fc253 100644
--- a/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx
+++ b/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx
@@ -18,6 +18,7 @@ describe('FeatureShimmer', () => {
     mockIntersectionObserver.mockReturnValue({
       observe: jest.fn(),
       disconnect: jest.fn(),
+      unobserve: jest.fn(),
     });
     window.IntersectionObserver = mockIntersectionObserver;
   });
diff --git a/packages/gamut/src/Form/SelectDropdown/utils.tsx b/packages/gamut/src/Form/SelectDropdown/utils.tsx
index bcf0fd7ac87..8ba920f20a6 100644
--- a/packages/gamut/src/Form/SelectDropdown/utils.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/utils.tsx
@@ -1,3 +1,4 @@
+import { isDefined } from '../../utils/nullish';
 import { SelectOptionBase } from '../utils';
 import {
   BaseOnChangeProps,
@@ -18,8 +19,9 @@ export const isSingleSelectProps = (
 ): props is SingleSelectDropdownProps => !props.multiple;
 
 export const isOptionGroup = (obj: unknown): obj is SelectDropdownGroup =>
-  obj != null &&
+  isDefined(obj) &&
   typeof obj === 'object' &&
+  obj !== null &&
   'options' in obj &&
   obj.options !== undefined;
 
diff --git a/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap b/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap
index 2690797df50..6db6a89db06 100644
--- a/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap
+++ b/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap
@@ -2,39 +2,63 @@
 
 exports[`parseSelectOptions creates an option list 1`] = `
 [
-  <option
-    data-testid="test-val"
-    label="Value"
-    value="val"
-  >
-    Value
-  </option>,
-  <option
-    data-testid="test-val2"
-    label="Value 2"
-    value="val2"
-  >
-    Value 2
-  </option>,
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val",
+    "props": {
+      "children": "Value",
+      "data-testid": "test-val",
+      "label": "Value",
+      "value": "val",
+    },
+    "type": "option",
+  },
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val2",
+    "props": {
+      "children": "Value 2",
+      "data-testid": "test-val2",
+      "label": "Value 2",
+      "value": "val2",
+    },
+    "type": "option",
+  },
 ]
 `;
 
 exports[`parseSelectOptions creates an option list 2`] = `
 [
-  <option
-    data-testid="test-val"
-    label="val"
-    value="val"
-  >
-    val
-  </option>,
-  <option
-    data-testid="test-val2"
-    label="val2"
-    value="val2"
-  >
-    val2
-  </option>,
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val",
+    "props": {
+      "children": "val",
+      "data-testid": "test-val",
+      "label": "val",
+      "value": "val",
+    },
+    "type": "option",
+  },
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val2",
+    "props": {
+      "children": "val2",
+      "data-testid": "test-val2",
+      "label": "val2",
+      "value": "val2",
+    },
+    "type": "option",
+  },
 ]
 `;
 
diff --git a/packages/gamut/src/PopoverContainer/hooks.ts b/packages/gamut/src/PopoverContainer/hooks.ts
index 627640a9b1e..8e74cdc545a 100644
--- a/packages/gamut/src/PopoverContainer/hooks.ts
+++ b/packages/gamut/src/PopoverContainer/hooks.ts
@@ -1,5 +1,6 @@
 import { useEffect, useMemo } from 'react';
 
+import { isNullish } from '../utils/nullish';
 import { findAllAdditionalScrollingParents, findResizingParent } from './utils';
 
 /**
@@ -15,7 +16,7 @@ export interface PopoverTargetElement {
 export function getRefElement(
   ref: React.Ref<PopoverTargetElement | null>
 ): PopoverTargetElement | null {
-  if (ref == null) return null;
+  if (isNullish(ref)) return null;
   if (typeof ref === 'function') return null;
   return ref.current;
 }
diff --git a/packages/gamut/src/utils/__tests__/nullish.test.ts b/packages/gamut/src/utils/__tests__/nullish.test.ts
new file mode 100644
index 00000000000..c44212e77eb
--- /dev/null
+++ b/packages/gamut/src/utils/__tests__/nullish.test.ts
@@ -0,0 +1,38 @@
+import { isDefined, isNullish } from '../nullish';
+
+describe('isNullish', () => {
+  it('is true for null and undefined', () => {
+    expect(isNullish(null)).toBe(true);
+    expect(isNullish(undefined)).toBe(true);
+  });
+
+  it('is false for other values', () => {
+    expect(isNullish(0)).toBe(false);
+    expect(isNullish('')).toBe(false);
+    expect(isNullish(false)).toBe(false);
+    expect(isNullish({})).toBe(false);
+  });
+});
+
+describe('isDefined', () => {
+  it('is false for null and undefined', () => {
+    expect(isDefined(null)).toBe(false);
+    expect(isDefined(undefined)).toBe(false);
+  });
+
+  it('is true for other values', () => {
+    expect(isDefined(0)).toBe(true);
+    expect(isDefined('')).toBe(true);
+    expect(isDefined(false)).toBe(true);
+    expect(isDefined({})).toBe(true);
+  });
+});
+
+describe('isNullish and isDefined', () => {
+  it('are opposites for typical inputs', () => {
+    const values: unknown[] = [null, undefined, 0, '', NaN, Symbol('x')];
+    for (const v of values) {
+      expect(isNullish(v)).toBe(!isDefined(v));
+    }
+  });
+});
diff --git a/packages/gamut/src/utils/nullish.ts b/packages/gamut/src/utils/nullish.ts
new file mode 100644
index 00000000000..b0a20d6ca4b
--- /dev/null
+++ b/packages/gamut/src/utils/nullish.ts
@@ -0,0 +1,13 @@
+/**
+ * True when `value` is `null` or `undefined`.
+ * Use instead of `value == null` when `eqeqeq` is enforced.
+ */
+export const isNullish = (value: unknown): value is null | undefined =>
+  value === null || value === undefined;
+
+/**
+ * True when `value` is neither `null` nor `undefined`.
+ * Use instead of `value != null` when `eqeqeq` is enforced.
+ */
+export const isDefined = <T>(value: T | null | undefined): value is T =>
+  value !== undefined && value !== null;
diff --git a/packages/gamut/src/utils/react.ts b/packages/gamut/src/utils/react.ts
index a3ebd4391cb..904f855cabd 100644
--- a/packages/gamut/src/utils/react.ts
+++ b/packages/gamut/src/utils/react.ts
@@ -1,5 +1,7 @@
 import { Children, isValidElement } from 'react';
 
+import { isNullish } from './nullish';
+
 /**
  * Recursively extracts plain text content from React children.
  *
@@ -31,7 +33,7 @@ export const extractTextContent = (children: React.ReactNode): string => {
       if (typeof child === 'string' || typeof child === 'number') {
         return String(child);
       }
-      if (typeof child === 'boolean' || child == null) {
+      if (typeof child === 'boolean' || isNullish(child)) {
         return '';
       }
       if (isValidElement(child)) {
diff --git a/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.stories.tsx b/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.stories.tsx
index eeb67f255b1..45da920597c 100644
--- a/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.stories.tsx
+++ b/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.stories.tsx
@@ -94,7 +94,7 @@ export const Alignment: React.FC<
                 justifyContent="center"
               >
                 {alignment.split('-').map((val) => (
-                  <Text as="p" variant="p-small">
+                  <Text as="p" key={val} variant="p-small">
                     {val}
                   </Text>
                 ))}
diff --git a/packages/styleguide/src/lib/Molecules/Tips/TipsTable.tsx b/packages/styleguide/src/lib/Molecules/Tips/TipsTable.tsx
index 34901b40b39..6be53f7eefe 100644
--- a/packages/styleguide/src/lib/Molecules/Tips/TipsTable.tsx
+++ b/packages/styleguide/src/lib/Molecules/Tips/TipsTable.tsx
@@ -77,7 +77,7 @@ const ComponentRow = ({ array }: { array: typeof colTitles }) => {
         const badgeVariant = status === 'New' ? 'accent' : 'tertiary';
 
         return (
-          <BorderRow size="xl">
+          <BorderRow key={title} size="xl">
             <FlexBox alignItems="center" flexWrap="wrap" pl={8}>
               <Text mr={8} variant="title-sm">
                 {!skipTitle && title} {component}
@@ -110,7 +110,7 @@ const FeatureRow = ({
         <Text fontWeight="bold">{title}</Text>
       </ListCol>
       {features.map((details) => (
-        <DetailRow size="xl">
+        <DetailRow key={details} size="xl">
           <Text>{details}</Text>
         </DetailRow>
       ))}
diff --git a/packages/styleguide/src/lib/Molecules/Tips/ToolTip/ToolTip.stories.tsx b/packages/styleguide/src/lib/Molecules/Tips/ToolTip/ToolTip.stories.tsx
index d4fa6f4133e..2d450b5a83e 100644
--- a/packages/styleguide/src/lib/Molecules/Tips/ToolTip/ToolTip.stories.tsx
+++ b/packages/styleguide/src/lib/Molecules/Tips/ToolTip/ToolTip.stories.tsx
@@ -48,6 +48,7 @@ export const Alignments: Story = {
         return (
           <IconButton
             icon={SparkleIcon}
+            key={alignment}
             tip={alignment}
             tipProps={{ alignment }}
           />
diff --git a/packages/styleguide/src/lib/Organisms/ConnectedForm/ConnectedFormInputs/ConnectedFormInputsTable.tsx b/packages/styleguide/src/lib/Organisms/ConnectedForm/ConnectedFormInputs/ConnectedFormInputsTable.tsx
index f3812164946..876308a325e 100644
--- a/packages/styleguide/src/lib/Organisms/ConnectedForm/ConnectedFormInputs/ConnectedFormInputsTable.tsx
+++ b/packages/styleguide/src/lib/Organisms/ConnectedForm/ConnectedFormInputs/ConnectedFormInputsTable.tsx
@@ -12,7 +12,7 @@ const ListRowRenderer: React.FC<ListRowRendererProps> = ({ inputs }) => {
     <>
       {inputs.map(({ name, counterpart }) => {
         return (
-          <ListRow>
+          <ListRow key={name}>
             <ListCol size="lg" type="header">
               <Text as="code" ml={8}>
                 {name}
diff --git a/packages/styleguide/src/lib/Organisms/Lists & Tables/List/List.stories.tsx b/packages/styleguide/src/lib/Organisms/Lists & Tables/List/List.stories.tsx
index 5bb383969f0..d1b5688f770 100644
--- a/packages/styleguide/src/lib/Organisms/Lists & Tables/List/List.stories.tsx	
+++ b/packages/styleguide/src/lib/Organisms/Lists & Tables/List/List.stories.tsx	
@@ -65,7 +65,7 @@ const ListExample: React.FC = (args) => {
   return (
     <List {...args}>
       {rows.map(({ name, ship }) => (
-        <ListRow>
+        <ListRow key={name}>
           <ListCol size="md" type="header">
             {name}
           </ListCol>
@@ -157,7 +157,7 @@ const ListCardExample: React.FC = (args) => {
   return (
     <List {...args}>
       {rows.map(({ name, ship, role }) => (
-        <ListRow>
+        <ListRow key={name}>
           <ListCol fill>
             <Text truncate="ellipsis" truncateLines={1} variant="title-lg">
               {name}
@@ -218,7 +218,7 @@ const ColumnExample: React.FC<ListProps> = (args) => {
   return (
     <List {...args}>
       {sizes.map((size: 'content' | 'sm' | 'md' | 'lg' | 'xl') => (
-        <ListRow>
+        <ListRow key={size}>
           <ListCol size={size}>
             <Box bg="background-selected" flex={1} height={1} p={8}>
               {size}
diff --git a/packages/variance/src/createTheme/createTheme.ts b/packages/variance/src/createTheme/createTheme.ts
index a1df5dc979e..d588d06b3e4 100644
--- a/packages/variance/src/createTheme/createTheme.ts
+++ b/packages/variance/src/createTheme/createTheme.ts
@@ -62,7 +62,8 @@ class ThemeBuilder<T extends AbstractTheme> {
   > {
     const flatColors = flattenScale(colors);
     const { variables, tokens } = serializeTokens(
-      flatColors,
+      // TS 5.9+ no longer resolves LiteralPaths<> as assignable to SerializedTokensInput; flattened scales are plain token maps at runtime.
+      flatColors as Record<string, string | number | CSSObject>,
       'color',
       this.#theme
     );
diff --git a/yarn.lock b/yarn.lock
index 11785dd02c4..cd710a00a5d 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -60,6 +60,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@babel/code-frame@npm:^7.21.4":
+  version: 7.29.0
+  resolution: "@babel/code-frame@npm:7.29.0"
+  dependencies:
+    "@babel/helper-validator-identifier": "npm:^7.28.5"
+    js-tokens: "npm:^4.0.0"
+    picocolors: "npm:^1.1.1"
+  checksum: 10c0/d34cc504e7765dfb576a663d97067afb614525806b5cad1a5cc1a7183b916fec8ff57fa233585e3926fd5a9e6b31aae6df91aa81ae9775fb7a28f658d3346f0d
+  languageName: node
+  linkType: hard
+
 "@babel/compat-data@npm:^7.22.6, @babel/compat-data@npm:^7.26.0, @babel/compat-data@npm:^7.27.2":
   version: 7.28.0
   resolution: "@babel/compat-data@npm:7.28.0"
@@ -67,30 +78,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/core@npm:7.12.9":
-  version: 7.12.9
-  resolution: "@babel/core@npm:7.12.9"
-  dependencies:
-    "@babel/code-frame": "npm:^7.10.4"
-    "@babel/generator": "npm:^7.12.5"
-    "@babel/helper-module-transforms": "npm:^7.12.1"
-    "@babel/helpers": "npm:^7.12.5"
-    "@babel/parser": "npm:^7.12.7"
-    "@babel/template": "npm:^7.12.7"
-    "@babel/traverse": "npm:^7.12.9"
-    "@babel/types": "npm:^7.12.7"
-    convert-source-map: "npm:^1.7.0"
-    debug: "npm:^4.1.0"
-    gensync: "npm:^1.0.0-beta.1"
-    json5: "npm:^2.1.2"
-    lodash: "npm:^4.17.19"
-    resolve: "npm:^1.3.2"
-    semver: "npm:^5.4.1"
-    source-map: "npm:^0.5.0"
-  checksum: 10c0/c11d26f5a33a29c94fdd1c492dfd723f48926c51e975448dda57c081c0d74c7b03298642b2651559e0d330ec868b5757b60f9648c71cf7f89fddf79a17cf006f
-  languageName: node
-  linkType: hard
-
 "@babel/core@npm:7.24.7":
   version: 7.24.7
   resolution: "@babel/core@npm:7.24.7"
@@ -137,7 +124,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/generator@npm:^7.12.5, @babel/generator@npm:^7.24.7, @babel/generator@npm:^7.27.5, @babel/generator@npm:^7.28.3, @babel/generator@npm:^7.7.2":
+"@babel/generator@npm:^7.24.7, @babel/generator@npm:^7.27.5, @babel/generator@npm:^7.28.3, @babel/generator@npm:^7.7.2":
   version: 7.28.3
   resolution: "@babel/generator@npm:7.28.3"
   dependencies:
@@ -254,7 +241,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-module-transforms@npm:^7.12.1, @babel/helper-module-transforms@npm:^7.24.7, @babel/helper-module-transforms@npm:^7.25.9, @babel/helper-module-transforms@npm:^7.28.3":
+"@babel/helper-module-transforms@npm:^7.24.7, @babel/helper-module-transforms@npm:^7.25.9, @babel/helper-module-transforms@npm:^7.28.3":
   version: 7.28.3
   resolution: "@babel/helper-module-transforms@npm:7.28.3"
   dependencies:
@@ -276,13 +263,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-plugin-utils@npm:7.10.4":
-  version: 7.10.4
-  resolution: "@babel/helper-plugin-utils@npm:7.10.4"
-  checksum: 10c0/113d0405281f5490658f7c1c3a81b4a37927375e1ebcccd2fd90be538a102da0c2d6024561aaf26bd1c71ef7688b5a8b96a87d938db8d9774454ab635011fc7f
-  languageName: node
-  linkType: hard
-
 "@babel/helper-plugin-utils@npm:^7.0.0, @babel/helper-plugin-utils@npm:^7.10.4, @babel/helper-plugin-utils@npm:^7.12.13, @babel/helper-plugin-utils@npm:^7.14.5, @babel/helper-plugin-utils@npm:^7.18.6, @babel/helper-plugin-utils@npm:^7.22.5, @babel/helper-plugin-utils@npm:^7.25.9, @babel/helper-plugin-utils@npm:^7.27.1, @babel/helper-plugin-utils@npm:^7.8.0":
   version: 7.27.1
   resolution: "@babel/helper-plugin-utils@npm:7.27.1"
@@ -350,6 +330,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@babel/helper-validator-identifier@npm:^7.28.5":
+  version: 7.28.5
+  resolution: "@babel/helper-validator-identifier@npm:7.28.5"
+  checksum: 10c0/42aaebed91f739a41f3d80b72752d1f95fd7c72394e8e4bd7cdd88817e0774d80a432451bcba17c2c642c257c483bf1d409dd4548883429ea9493a3bc4ab0847
+  languageName: node
+  linkType: hard
+
 "@babel/helper-validator-option@npm:^7.25.9, @babel/helper-validator-option@npm:^7.27.1":
   version: 7.27.1
   resolution: "@babel/helper-validator-option@npm:7.27.1"
@@ -368,7 +355,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helpers@npm:^7.12.5, @babel/helpers@npm:^7.24.7, @babel/helpers@npm:^7.28.4":
+"@babel/helpers@npm:^7.24.7, @babel/helpers@npm:^7.28.4":
   version: 7.28.4
   resolution: "@babel/helpers@npm:7.28.4"
   dependencies:
@@ -378,7 +365,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/parser@npm:^7.1.0, @babel/parser@npm:^7.12.7, @babel/parser@npm:^7.14.7, @babel/parser@npm:^7.20.7, @babel/parser@npm:^7.23.9, @babel/parser@npm:^7.24.7, @babel/parser@npm:^7.27.2, @babel/parser@npm:^7.28.3, @babel/parser@npm:^7.28.4":
+"@babel/parser@npm:^7.1.0, @babel/parser@npm:^7.14.7, @babel/parser@npm:^7.20.7, @babel/parser@npm:^7.23.9, @babel/parser@npm:^7.24.7, @babel/parser@npm:^7.27.2, @babel/parser@npm:^7.28.3, @babel/parser@npm:^7.28.4":
   version: 7.28.4
   resolution: "@babel/parser@npm:7.28.4"
   dependencies:
@@ -461,19 +448,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-proposal-object-rest-spread@npm:7.12.1":
-  version: 7.12.1
-  resolution: "@babel/plugin-proposal-object-rest-spread@npm:7.12.1"
-  dependencies:
-    "@babel/helper-plugin-utils": "npm:^7.10.4"
-    "@babel/plugin-syntax-object-rest-spread": "npm:^7.8.0"
-    "@babel/plugin-transform-parameters": "npm:^7.12.1"
-  peerDependencies:
-    "@babel/core": ^7.0.0-0
-  checksum: 10c0/f773d59ead8b056b646d585e95d610cca2f0aeaa2eeaad74b3eb9e25821b06f27e361dd0aac9a088a10c22fee1ead8863f82a2be073e28eb04ca9a330a00941e
-  languageName: node
-  linkType: hard
-
 "@babel/plugin-proposal-private-property-in-object@npm:7.21.0-placeholder-for-preset-env.2":
   version: 7.21.0-placeholder-for-preset-env.2
   resolution: "@babel/plugin-proposal-private-property-in-object@npm:7.21.0-placeholder-for-preset-env.2"
@@ -582,17 +556,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-syntax-jsx@npm:7.12.1":
-  version: 7.12.1
-  resolution: "@babel/plugin-syntax-jsx@npm:7.12.1"
-  dependencies:
-    "@babel/helper-plugin-utils": "npm:^7.10.4"
-  peerDependencies:
-    "@babel/core": ^7.0.0-0
-  checksum: 10c0/11d435f9e4e71c0f00e5bc295b40747c2c42341b7f38ddc5f8ac41d49ddfa247514dbe91932fa3dabd65581b4c7a9fe5b3d1c2b285e5ca32f4e5296cc185d40c
-  languageName: node
-  linkType: hard
-
 "@babel/plugin-syntax-jsx@npm:^7.25.9, @babel/plugin-syntax-jsx@npm:^7.27.1, @babel/plugin-syntax-jsx@npm:^7.7.2":
   version: 7.27.1
   resolution: "@babel/plugin-syntax-jsx@npm:7.27.1"
@@ -637,7 +600,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-syntax-object-rest-spread@npm:^7.8.0, @babel/plugin-syntax-object-rest-spread@npm:^7.8.3":
+"@babel/plugin-syntax-object-rest-spread@npm:^7.8.3":
   version: 7.8.3
   resolution: "@babel/plugin-syntax-object-rest-spread@npm:7.8.3"
   dependencies:
@@ -1119,7 +1082,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/plugin-transform-parameters@npm:^7.12.1, @babel/plugin-transform-parameters@npm:^7.25.9":
+"@babel/plugin-transform-parameters@npm:^7.25.9":
   version: 7.25.9
   resolution: "@babel/plugin-transform-parameters@npm:7.25.9"
   dependencies:
@@ -1525,7 +1488,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/template@npm:^7.12.7, @babel/template@npm:^7.24.7, @babel/template@npm:^7.25.9, @babel/template@npm:^7.27.2, @babel/template@npm:^7.3.3":
+"@babel/template@npm:^7.24.7, @babel/template@npm:^7.25.9, @babel/template@npm:^7.27.2, @babel/template@npm:^7.3.3":
   version: 7.27.2
   resolution: "@babel/template@npm:7.27.2"
   dependencies:
@@ -1536,7 +1499,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/traverse@npm:^7.12.9, @babel/traverse@npm:^7.16.0, @babel/traverse@npm:^7.18.9, @babel/traverse@npm:^7.24.7, @babel/traverse@npm:^7.25.9, @babel/traverse@npm:^7.27.1, @babel/traverse@npm:^7.28.3, @babel/traverse@npm:^7.28.4":
+"@babel/traverse@npm:^7.16.0, @babel/traverse@npm:^7.18.9, @babel/traverse@npm:^7.24.7, @babel/traverse@npm:^7.25.9, @babel/traverse@npm:^7.27.1, @babel/traverse@npm:^7.28.3, @babel/traverse@npm:^7.28.4":
   version: 7.28.4
   resolution: "@babel/traverse@npm:7.28.4"
   dependencies:
@@ -1551,7 +1514,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/types@npm:^7.0.0, @babel/types@npm:^7.12.6, @babel/types@npm:^7.12.7, @babel/types@npm:^7.18.9, @babel/types@npm:^7.20.7, @babel/types@npm:^7.21.3, @babel/types@npm:^7.24.7, @babel/types@npm:^7.25.9, @babel/types@npm:^7.27.1, @babel/types@npm:^7.27.3, @babel/types@npm:^7.28.2, @babel/types@npm:^7.28.4, @babel/types@npm:^7.3.3, @babel/types@npm:^7.4.4":
+"@babel/types@npm:^7.0.0, @babel/types@npm:^7.12.6, @babel/types@npm:^7.18.9, @babel/types@npm:^7.20.7, @babel/types@npm:^7.21.3, @babel/types@npm:^7.24.7, @babel/types@npm:^7.25.9, @babel/types@npm:^7.27.1, @babel/types@npm:^7.27.3, @babel/types@npm:^7.28.2, @babel/types@npm:^7.28.4, @babel/types@npm:^7.3.3, @babel/types@npm:^7.4.4":
   version: 7.28.4
   resolution: "@babel/types@npm:7.28.4"
   dependencies:
@@ -1589,30 +1552,28 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@codecademy/eslint-config@npm:8.0.0":
-  version: 8.0.0
-  resolution: "@codecademy/eslint-config@npm:8.0.0"
+"@codecademy/eslint-config@npm:8.2.0":
+  version: 8.2.0
+  resolution: "@codecademy/eslint-config@npm:8.2.0"
   dependencies:
-    "@typescript-eslint/eslint-plugin": "npm:^5.15.0"
-    "@typescript-eslint/parser": "npm:^5.15.0"
-    eslint-config-airbnb: "npm:^18.2.1"
-    eslint-config-prettier: "npm:^8.3.0"
-    eslint-mdx: "npm:^1.15.0"
+    "@typescript-eslint/eslint-plugin": "npm:^8.31.0"
+    "@typescript-eslint/parser": "npm:^8.31.0"
+    eslint-config-prettier: "npm:^10.1.2"
+    eslint-mdx: "npm:^3.4.1"
     eslint-plugin-import: "npm:^2.25.2"
-    eslint-plugin-jest: "npm:^25.2.4"
-    eslint-plugin-jest-react: "npm:^0.1.0"
-    eslint-plugin-jsx-a11y: "npm:^6.4.1"
-    eslint-plugin-no-only-tests: "npm:^2.6.0"
-    eslint-plugin-react: "npm:^7.26.1"
-    eslint-plugin-react-hooks: "npm:^4.3.0"
-    eslint-plugin-simple-import-sort: "npm:^7.0.0"
-    eslint-plugin-unused-imports: "npm:^1.1.5"
-    yargs: "npm:^17.1.1"
+    eslint-plugin-jest: "npm:^28.11.0"
+    eslint-plugin-jsx-a11y: "npm:^6.10.2"
+    eslint-plugin-no-only-tests: "npm:^3.3.0"
+    eslint-plugin-react: "npm:^7.37.5"
+    eslint-plugin-react-hooks: "npm:^5.2.0"
+    eslint-plugin-simple-import-sort: "npm:^12.1.1"
+    eslint-plugin-unused-imports: "npm:^4.1.4"
+    yargs: "npm:^17.7.2"
   peerDependencies:
     eslint: ^8.11.0
   bin:
-    eslint-fix: bin/eslint-fix.js
-  checksum: 10c0/58c427bcc226c528460bb7778eaf9cf0498ccba0ad8ae483eb74cebbb5fd389a710e0940dd4aa1d21d6df8a2030087ebb228ec30a9faa1bacb5e821b02ef1bd1
+    eslint-fix: ./bin/eslint-fix.js
+  checksum: 10c0/85b082128cb41f6286b4072268939b957071cea99dc6c951aef843535a7dee7ec2a121a1c8b7dbf7c890de9705f86ad3bf7e86ed2f51cca75f094e77d18ed946
   languageName: node
   linkType: hard
 
@@ -2434,7 +2395,25 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@eslint-community/regexpp@npm:^4.4.0, @eslint-community/regexpp@npm:^4.6.1":
+"@eslint-community/eslint-utils@npm:^4.9.1":
+  version: 4.9.1
+  resolution: "@eslint-community/eslint-utils@npm:4.9.1"
+  dependencies:
+    eslint-visitor-keys: "npm:^3.4.3"
+  peerDependencies:
+    eslint: ^6.0.0 || ^7.0.0 || >=8.0.0
+  checksum: 10c0/dc4ab5e3e364ef27e33666b11f4b86e1a6c1d7cbf16f0c6ff87b1619b3562335e9201a3d6ce806221887ff780ec9d828962a290bb910759fd40a674686503f02
+  languageName: node
+  linkType: hard
+
+"@eslint-community/regexpp@npm:^4.12.2":
+  version: 4.12.2
+  resolution: "@eslint-community/regexpp@npm:4.12.2"
+  checksum: 10c0/fddcbc66851b308478d04e302a4d771d6917a0b3740dc351513c0da9ca2eab8a1adf99f5e0aa7ab8b13fa0df005c81adeee7e63a92f3effd7d367a163b721c2d
+  languageName: node
+  linkType: hard
+
+"@eslint-community/regexpp@npm:^4.6.1":
   version: 4.12.1
   resolution: "@eslint-community/regexpp@npm:4.12.1"
   checksum: 10c0/a03d98c246bcb9109aec2c08e4d10c8d010256538dcb3f56610191607214523d4fb1b00aa81df830b6dffb74c5fa0be03642513a289c567949d3e550ca11cdf6
@@ -3375,13 +3354,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@mdx-js/util@npm:1.6.22":
-  version: 1.6.22
-  resolution: "@mdx-js/util@npm:1.6.22"
-  checksum: 10c0/2ee8da6afea0f42297ea31f52b1d50d228744d2895cce7cc9571b7d5ce97c7c96037c80b6dbcded9caa8099c9a994eda62980099eabe1c000aaa792816c66f10
-  languageName: node
-  linkType: hard
-
 "@modern-js/node-bundle-require@npm:2.68.2":
   version: 2.68.2
   resolution: "@modern-js/node-bundle-require@npm:2.68.2"
@@ -3794,6 +3766,22 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@npmcli/config@npm:^8.0.0":
+  version: 8.3.4
+  resolution: "@npmcli/config@npm:8.3.4"
+  dependencies:
+    "@npmcli/map-workspaces": "npm:^3.0.2"
+    "@npmcli/package-json": "npm:^5.1.1"
+    ci-info: "npm:^4.0.0"
+    ini: "npm:^4.1.2"
+    nopt: "npm:^7.2.1"
+    proc-log: "npm:^4.2.0"
+    semver: "npm:^7.3.5"
+    walk-up-path: "npm:^3.0.1"
+  checksum: 10c0/f44af54bd2cdb32b132a861863bfe7936599a4706490136082585ab71e37ef47f201f8d2013b9902b3ff30cc8264f5da70f834c80f0a29953b52a28da20f5ea7
+  languageName: node
+  linkType: hard
+
 "@npmcli/fs@npm:^2.1.0":
   version: 2.1.2
   resolution: "@npmcli/fs@npm:2.1.2"
@@ -3838,6 +3826,23 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@npmcli/git@npm:^5.0.0":
+  version: 5.0.8
+  resolution: "@npmcli/git@npm:5.0.8"
+  dependencies:
+    "@npmcli/promise-spawn": "npm:^7.0.0"
+    ini: "npm:^4.1.3"
+    lru-cache: "npm:^10.0.1"
+    npm-pick-manifest: "npm:^9.0.0"
+    proc-log: "npm:^4.0.0"
+    promise-inflight: "npm:^1.0.1"
+    promise-retry: "npm:^2.0.1"
+    semver: "npm:^7.3.5"
+    which: "npm:^4.0.0"
+  checksum: 10c0/892441c968404950809c7b515a93b78167ea1db2252f259f390feae22a2c5477f3e1629e105e19a084c05afc56e585bf3f13c2f13b54a06bfd6786f0c8429532
+  languageName: node
+  linkType: hard
+
 "@npmcli/installed-package-contents@npm:^2.0.1":
   version: 2.1.0
   resolution: "@npmcli/installed-package-contents@npm:2.1.0"
@@ -3850,6 +3855,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@npmcli/map-workspaces@npm:^3.0.2":
+  version: 3.0.6
+  resolution: "@npmcli/map-workspaces@npm:3.0.6"
+  dependencies:
+    "@npmcli/name-from-folder": "npm:^2.0.0"
+    glob: "npm:^10.2.2"
+    minimatch: "npm:^9.0.0"
+    read-package-json-fast: "npm:^3.0.0"
+  checksum: 10c0/6bfcf8ca05ab9ddc2bd19c0fd91e9982f03cc6e67b0c03f04ba4d2f29b7d83f96e759c0f8f1f4b6dbe3182272483643a0d1269788352edd0c883d6fbfa2f3f14
+  languageName: node
+  linkType: hard
+
 "@npmcli/move-file@npm:^2.0.0":
   version: 2.0.1
   resolution: "@npmcli/move-file@npm:2.0.1"
@@ -3860,6 +3877,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@npmcli/name-from-folder@npm:^2.0.0":
+  version: 2.0.0
+  resolution: "@npmcli/name-from-folder@npm:2.0.0"
+  checksum: 10c0/1aa551771d98ab366d4cb06b33efd3bb62b609942f6d9c3bb667c10e5bb39a223d3e330022bc980a44402133e702ae67603862099ac8254dad11f90e77409827
+  languageName: node
+  linkType: hard
+
 "@npmcli/node-gyp@npm:^3.0.0":
   version: 3.0.0
   resolution: "@npmcli/node-gyp@npm:3.0.0"
@@ -3867,6 +3891,21 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@npmcli/package-json@npm:^5.1.1":
+  version: 5.2.1
+  resolution: "@npmcli/package-json@npm:5.2.1"
+  dependencies:
+    "@npmcli/git": "npm:^5.0.0"
+    glob: "npm:^10.2.2"
+    hosted-git-info: "npm:^7.0.0"
+    json-parse-even-better-errors: "npm:^3.0.0"
+    normalize-package-data: "npm:^6.0.0"
+    proc-log: "npm:^4.0.0"
+    semver: "npm:^7.5.3"
+  checksum: 10c0/b852e31e3121a0afe5fa20bbf4faa701a59dbc9d9dd7141f7fd57b8e919ce22c1285dcdfea490851fe410fa0f7bc9c397cafba0d268aaa53420a12d7c561dde1
+  languageName: node
+  linkType: hard
+
 "@npmcli/promise-spawn@npm:^6.0.0, @npmcli/promise-spawn@npm:^6.0.1":
   version: 6.0.2
   resolution: "@npmcli/promise-spawn@npm:6.0.2"
@@ -3876,6 +3915,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@npmcli/promise-spawn@npm:^7.0.0":
+  version: 7.0.2
+  resolution: "@npmcli/promise-spawn@npm:7.0.2"
+  dependencies:
+    which: "npm:^4.0.0"
+  checksum: 10c0/8f2af5bc2c1b1ccfb9bcd91da8873ab4723616d8bd5af877c0daa40b1e2cbfa4afb79e052611284179cae918c945a1b99ae1c565d78a355bec1a461011e89f71
+  languageName: node
+  linkType: hard
+
 "@npmcli/run-script@npm:6.0.2, @npmcli/run-script@npm:^6.0.0":
   version: 6.0.2
   resolution: "@npmcli/run-script@npm:6.0.2"
@@ -7905,6 +7953,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/concat-stream@npm:^2.0.0":
+  version: 2.0.3
+  resolution: "@types/concat-stream@npm:2.0.3"
+  dependencies:
+    "@types/node": "npm:*"
+  checksum: 10c0/dd8bdf8061d275f30dc602e04c63ebc001d3a260e722c867916667a45f90fd22da62a2de0919a35f35969b84a14cb94c69d15bdb2c8a518ce8abf3a0e1a16e5d
+  languageName: node
+  linkType: hard
+
 "@types/connect-history-api-fallback@npm:^1.5.4":
   version: 1.5.4
   resolution: "@types/connect-history-api-fallback@npm:1.5.4"
@@ -7924,6 +7981,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/debug@npm:^4.0.0":
+  version: 4.1.13
+  resolution: "@types/debug@npm:4.1.13"
+  dependencies:
+    "@types/ms": "npm:*"
+  checksum: 10c0/e5e124021bbdb23a82727eee0a726ae0fc8a3ae1f57253cbcc47497f259afb357de7f6941375e773e1abbfa1604c1555b901a409d762ec2bb4c1612131d4afb7
+  languageName: node
+  linkType: hard
+
 "@types/doctrine@npm:^0.0.9":
   version: 0.0.9
   resolution: "@types/doctrine@npm:0.0.9"
@@ -7951,6 +8017,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/estree-jsx@npm:^1.0.0":
+  version: 1.0.5
+  resolution: "@types/estree-jsx@npm:1.0.5"
+  dependencies:
+    "@types/estree": "npm:*"
+  checksum: 10c0/07b354331516428b27a3ab99ee397547d47eb223c34053b48f84872fafb841770834b90cc1a0068398e7c7ccb15ec51ab00ec64b31dc5e3dbefd624638a35c6d
+  languageName: node
+  linkType: hard
+
 "@types/estree@npm:*, @types/estree@npm:1.0.8, @types/estree@npm:^1.0.0, @types/estree@npm:^1.0.6":
   version: 1.0.8
   resolution: "@types/estree@npm:1.0.8"
@@ -8034,6 +8109,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/hast@npm:^3.0.0":
+  version: 3.0.4
+  resolution: "@types/hast@npm:3.0.4"
+  dependencies:
+    "@types/unist": "npm:*"
+  checksum: 10c0/3249781a511b38f1d330fd1e3344eed3c4e7ea8eff82e835d35da78e637480d36fad37a78be5a7aed8465d237ad0446abc1150859d0fde395354ea634decf9f7
+  languageName: node
+  linkType: hard
+
 "@types/html-minifier-terser@npm:^6.0.0":
   version: 6.1.0
   resolution: "@types/html-minifier-terser@npm:6.1.0"
@@ -8064,6 +8148,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/is-empty@npm:^1.0.0":
+  version: 1.2.3
+  resolution: "@types/is-empty@npm:1.2.3"
+  checksum: 10c0/2ca9af27ce93cc0abe277178a69803e641d755152bf4fc415e1789451ff62f6e39cf15dbdc111d490171d757669937ad4789c7395af55f5e7d261f6bfe416974
+  languageName: node
+  linkType: hard
+
 "@types/istanbul-lib-coverage@npm:*, @types/istanbul-lib-coverage@npm:^2.0.0, @types/istanbul-lib-coverage@npm:^2.0.1, @types/istanbul-lib-coverage@npm:^2.0.6":
   version: 2.0.6
   resolution: "@types/istanbul-lib-coverage@npm:2.0.6"
@@ -8152,6 +8243,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/mdast@npm:^4.0.0":
+  version: 4.0.4
+  resolution: "@types/mdast@npm:4.0.4"
+  dependencies:
+    "@types/unist": "npm:*"
+  checksum: 10c0/84f403dbe582ee508fd9c7643ac781ad8597fcbfc9ccb8d4715a2c92e4545e5772cbd0dbdf18eda65789386d81b009967fdef01b24faf6640f817287f54d9c82
+  languageName: node
+  linkType: hard
+
 "@types/mdx@npm:^2.0.0":
   version: 2.0.13
   resolution: "@types/mdx@npm:2.0.13"
@@ -8189,6 +8289,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/ms@npm:*":
+  version: 2.1.0
+  resolution: "@types/ms@npm:2.1.0"
+  checksum: 10c0/5ce692ffe1549e1b827d99ef8ff71187457e0eb44adbae38fdf7b9a74bae8d20642ee963c14516db1d35fa2652e65f47680fdf679dcbde52bbfadd021f497225
+  languageName: node
+  linkType: hard
+
 "@types/node-forge@npm:^1.3.0":
   version: 1.3.11
   resolution: "@types/node-forge@npm:1.3.11"
@@ -8207,6 +8314,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/node@npm:^22.0.0":
+  version: 22.19.15
+  resolution: "@types/node@npm:22.19.15"
+  dependencies:
+    undici-types: "npm:~6.21.0"
+  checksum: 10c0/f17eaf3d0d1da5e93ad9e287efb78201f8a5282973c004c5f70d91675c5c6b926a23acaa7b158a42b3d7e27e36b349d65a531710c91c308fca53dd7fa280ef98
+  languageName: node
+  linkType: hard
+
 "@types/normalize-package-data@npm:^2.4.0":
   version: 2.4.4
   resolution: "@types/normalize-package-data@npm:2.4.4"
@@ -8316,7 +8432,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/semver@npm:7.5.8, @types/semver@npm:^7.3.12, @types/semver@npm:^7.3.4":
+"@types/semver@npm:7.5.8, @types/semver@npm:^7.3.4":
   version: 7.5.8
   resolution: "@types/semver@npm:7.5.8"
   checksum: 10c0/8663ff927234d1c5fcc04b33062cb2b9fcfbe0f5f351ed26c4d1e1581657deebd506b41ff7fdf89e787e3d33ce05854bc01686379b89e9c49b564c4cfa988efa
@@ -8376,6 +8492,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/supports-color@npm:^8.0.0":
+  version: 8.1.3
+  resolution: "@types/supports-color@npm:8.1.3"
+  checksum: 10c0/03aa3616b403f3deaeb774df6d3a3969845b0c9f449814a83c2c53eb6818f5f9b571ba205330b0ebe8e46f41fd550f581a34b4310b13f0e0448694cfff37ddbf
+  languageName: node
+  linkType: hard
+
 "@types/testing-library__jest-dom@npm:^5.9.1":
   version: 5.14.9
   resolution: "@types/testing-library__jest-dom@npm:5.14.9"
@@ -8399,7 +8522,14 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/unist@npm:^2.0.0, @types/unist@npm:^2.0.2":
+"@types/unist@npm:*, @types/unist@npm:^3.0.0":
+  version: 3.0.3
+  resolution: "@types/unist@npm:3.0.3"
+  checksum: 10c0/2b1e4adcab78388e088fcc3c0ae8700f76619dbcb4741d7d201f87e2cb346bfc29a89003cfea2d76c996e1061452e14fcd737e8b25aacf949c1f2d6b2bc3dd60
+  languageName: node
+  linkType: hard
+
+"@types/unist@npm:^2.0.0":
   version: 2.0.11
   resolution: "@types/unist@npm:2.0.11"
   checksum: 10c0/24dcdf25a168f453bb70298145eb043cfdbb82472db0bc0b56d6d51cd2e484b9ed8271d4ac93000a80da568f2402e9339723db262d0869e2bf13bc58e081768d
@@ -8438,135 +8568,138 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@typescript-eslint/eslint-plugin@npm:^5.15.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/eslint-plugin@npm:5.62.0"
+"@typescript-eslint/eslint-plugin@npm:^8.31.0, @typescript-eslint/eslint-plugin@npm:^8.57.0":
+  version: 8.57.2
+  resolution: "@typescript-eslint/eslint-plugin@npm:8.57.2"
   dependencies:
-    "@eslint-community/regexpp": "npm:^4.4.0"
-    "@typescript-eslint/scope-manager": "npm:5.62.0"
-    "@typescript-eslint/type-utils": "npm:5.62.0"
-    "@typescript-eslint/utils": "npm:5.62.0"
-    debug: "npm:^4.3.4"
-    graphemer: "npm:^1.4.0"
-    ignore: "npm:^5.2.0"
-    natural-compare-lite: "npm:^1.4.0"
-    semver: "npm:^7.3.7"
-    tsutils: "npm:^3.21.0"
+    "@eslint-community/regexpp": "npm:^4.12.2"
+    "@typescript-eslint/scope-manager": "npm:8.57.2"
+    "@typescript-eslint/type-utils": "npm:8.57.2"
+    "@typescript-eslint/utils": "npm:8.57.2"
+    "@typescript-eslint/visitor-keys": "npm:8.57.2"
+    ignore: "npm:^7.0.5"
+    natural-compare: "npm:^1.4.0"
+    ts-api-utils: "npm:^2.4.0"
   peerDependencies:
-    "@typescript-eslint/parser": ^5.0.0
-    eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
-  peerDependenciesMeta:
-    typescript:
-      optional: true
-  checksum: 10c0/3f40cb6bab5a2833c3544e4621b9fdacd8ea53420cadc1c63fac3b89cdf5c62be1e6b7bcf56976dede5db4c43830de298ced3db60b5494a3b961ca1b4bff9f2a
+    "@typescript-eslint/parser": ^8.57.2
+    eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+    typescript: ">=4.8.4 <6.0.0"
+  checksum: 10c0/92f3a45f6c2104cef5294bfba972c475b1d3fafb6070efa1178b38cb951e7dfbaf89eae50bfd95f4a476fe51783e218b115bd7cbc09fc9bc7c0ca6c5233861d2
   languageName: node
   linkType: hard
 
-"@typescript-eslint/experimental-utils@npm:^5.0.0, @typescript-eslint/experimental-utils@npm:^5.3.1":
-  version: 5.62.0
-  resolution: "@typescript-eslint/experimental-utils@npm:5.62.0"
+"@typescript-eslint/parser@npm:^8.31.0, @typescript-eslint/parser@npm:^8.57.0":
+  version: 8.57.2
+  resolution: "@typescript-eslint/parser@npm:8.57.2"
   dependencies:
-    "@typescript-eslint/utils": "npm:5.62.0"
+    "@typescript-eslint/scope-manager": "npm:8.57.2"
+    "@typescript-eslint/types": "npm:8.57.2"
+    "@typescript-eslint/typescript-estree": "npm:8.57.2"
+    "@typescript-eslint/visitor-keys": "npm:8.57.2"
+    debug: "npm:^4.4.3"
   peerDependencies:
-    eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
-  checksum: 10c0/f7037977e00849cd8c03677a88b0659a4f0e0b1e0151aebb47c49c92b8e57408578142df598eac08b364623d926343c724f42494f87662e437b1c89f0b2e815b
+    eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+    typescript: ">=4.8.4 <6.0.0"
+  checksum: 10c0/afd8a30bd42ac56b212f3182d1b60e4556542eb22147b5b7a9a606d3c79ee35e596baf0bd7672d7e236472d246efc86e06265a46be26150ac12b05e4c45d16a6
   languageName: node
   linkType: hard
 
-"@typescript-eslint/parser@npm:^5.15.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/parser@npm:5.62.0"
+"@typescript-eslint/project-service@npm:8.57.2":
+  version: 8.57.2
+  resolution: "@typescript-eslint/project-service@npm:8.57.2"
   dependencies:
-    "@typescript-eslint/scope-manager": "npm:5.62.0"
-    "@typescript-eslint/types": "npm:5.62.0"
-    "@typescript-eslint/typescript-estree": "npm:5.62.0"
-    debug: "npm:^4.3.4"
+    "@typescript-eslint/tsconfig-utils": "npm:^8.57.2"
+    "@typescript-eslint/types": "npm:^8.57.2"
+    debug: "npm:^4.4.3"
   peerDependencies:
-    eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
-  peerDependenciesMeta:
-    typescript:
-      optional: true
-  checksum: 10c0/315194b3bf39beb9bd16c190956c46beec64b8371e18d6bb72002108b250983eb1e186a01d34b77eb4045f4941acbb243b16155fbb46881105f65e37dc9e24d4
+    typescript: ">=4.8.4 <6.0.0"
+  checksum: 10c0/f84e3165b0a214318d4bc119018b87c044170d7638945e84bd4cee2d752b62c1797ce722ca1161cd06f48512d0115ef75500e6c8fc01005ad4bb39fb48dd77bf
   languageName: node
   linkType: hard
 
-"@typescript-eslint/scope-manager@npm:5.62.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/scope-manager@npm:5.62.0"
+"@typescript-eslint/scope-manager@npm:8.57.2":
+  version: 8.57.2
+  resolution: "@typescript-eslint/scope-manager@npm:8.57.2"
   dependencies:
-    "@typescript-eslint/types": "npm:5.62.0"
-    "@typescript-eslint/visitor-keys": "npm:5.62.0"
-  checksum: 10c0/861253235576c1c5c1772d23cdce1418c2da2618a479a7de4f6114a12a7ca853011a1e530525d0931c355a8fd237b9cd828fac560f85f9623e24054fd024726f
+    "@typescript-eslint/types": "npm:8.57.2"
+    "@typescript-eslint/visitor-keys": "npm:8.57.2"
+  checksum: 10c0/532b1a97a5c2fce51400fa1a94e09615b4df84ce1f2d107206a3f3935074cada396a3e30f155582a698981832868e1afea1641ff779ad9456fdc94169b7def64
+  languageName: node
+  linkType: hard
+
+"@typescript-eslint/tsconfig-utils@npm:8.57.2, @typescript-eslint/tsconfig-utils@npm:^8.57.2":
+  version: 8.57.2
+  resolution: "@typescript-eslint/tsconfig-utils@npm:8.57.2"
+  peerDependencies:
+    typescript: ">=4.8.4 <6.0.0"
+  checksum: 10c0/199dad2d96efc88ce94f5f3e12e97205537bf7a7152e56ef1d84dfbe7bd1babebea9b9f396c01b6c447505a4eb02c1cbbd2c28828c587b51b41b15d017a11d2f
   languageName: node
   linkType: hard
 
-"@typescript-eslint/type-utils@npm:5.62.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/type-utils@npm:5.62.0"
+"@typescript-eslint/type-utils@npm:8.57.2":
+  version: 8.57.2
+  resolution: "@typescript-eslint/type-utils@npm:8.57.2"
   dependencies:
-    "@typescript-eslint/typescript-estree": "npm:5.62.0"
-    "@typescript-eslint/utils": "npm:5.62.0"
-    debug: "npm:^4.3.4"
-    tsutils: "npm:^3.21.0"
+    "@typescript-eslint/types": "npm:8.57.2"
+    "@typescript-eslint/typescript-estree": "npm:8.57.2"
+    "@typescript-eslint/utils": "npm:8.57.2"
+    debug: "npm:^4.4.3"
+    ts-api-utils: "npm:^2.4.0"
   peerDependencies:
-    eslint: "*"
-  peerDependenciesMeta:
-    typescript:
-      optional: true
-  checksum: 10c0/93112e34026069a48f0484b98caca1c89d9707842afe14e08e7390af51cdde87378df29d213d3bbd10a7cfe6f91b228031b56218515ce077bdb62ddea9d9f474
+    eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+    typescript: ">=4.8.4 <6.0.0"
+  checksum: 10c0/9c479cd0e809d26b7da7b31e830520bc016aaf528bc10a8b8279374808cb76a27f1b4adc77c84156417dc70f6a9e8604f47717b555a27293da2b9b5cfda70411
   languageName: node
   linkType: hard
 
-"@typescript-eslint/types@npm:5.62.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/types@npm:5.62.0"
-  checksum: 10c0/7febd3a7f0701c0b927e094f02e82d8ee2cada2b186fcb938bc2b94ff6fbad88237afc304cbaf33e82797078bbbb1baf91475f6400912f8b64c89be79bfa4ddf
+"@typescript-eslint/types@npm:8.57.2, @typescript-eslint/types@npm:^8.57.2":
+  version: 8.57.2
+  resolution: "@typescript-eslint/types@npm:8.57.2"
+  checksum: 10c0/3cd87dd77d28b3ac2fed56a17909b0d11633628d4d733aa148dfd7af72e2cc3ec0e6114b72fac0ff538e8a47e907b4b10dab4095170ae1bd73719ef0b8eaf2e7
   languageName: node
   linkType: hard
 
-"@typescript-eslint/typescript-estree@npm:5.62.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/typescript-estree@npm:5.62.0"
+"@typescript-eslint/typescript-estree@npm:8.57.2":
+  version: 8.57.2
+  resolution: "@typescript-eslint/typescript-estree@npm:8.57.2"
   dependencies:
-    "@typescript-eslint/types": "npm:5.62.0"
-    "@typescript-eslint/visitor-keys": "npm:5.62.0"
-    debug: "npm:^4.3.4"
-    globby: "npm:^11.1.0"
-    is-glob: "npm:^4.0.3"
-    semver: "npm:^7.3.7"
-    tsutils: "npm:^3.21.0"
-  peerDependenciesMeta:
-    typescript:
-      optional: true
-  checksum: 10c0/d7984a3e9d56897b2481940ec803cb8e7ead03df8d9cfd9797350be82ff765dfcf3cfec04e7355e1779e948da8f02bc5e11719d07a596eb1cb995c48a95e38cf
+    "@typescript-eslint/project-service": "npm:8.57.2"
+    "@typescript-eslint/tsconfig-utils": "npm:8.57.2"
+    "@typescript-eslint/types": "npm:8.57.2"
+    "@typescript-eslint/visitor-keys": "npm:8.57.2"
+    debug: "npm:^4.4.3"
+    minimatch: "npm:^10.2.2"
+    semver: "npm:^7.7.3"
+    tinyglobby: "npm:^0.2.15"
+    ts-api-utils: "npm:^2.4.0"
+  peerDependencies:
+    typescript: ">=4.8.4 <6.0.0"
+  checksum: 10c0/2c5d143f0abbafd07a45f0b956aab5d6487b27f74fe93bee93e0a3f8edc8913f1522faf8d7d5215f3809a8d12f5729910ea522156552f2481b66e6d05ab311ae
   languageName: node
   linkType: hard
 
-"@typescript-eslint/utils@npm:^5.15.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/utils@npm:5.62.0"
+"@typescript-eslint/utils@npm:^8.57.0":
+  version: 8.57.2
+  resolution: "@typescript-eslint/utils@npm:8.57.2"
   dependencies:
-    "@eslint-community/eslint-utils": "npm:^4.2.0"
-    "@types/json-schema": "npm:^7.0.9"
-    "@types/semver": "npm:^7.3.12"
-    "@typescript-eslint/scope-manager": "npm:5.62.0"
-    "@typescript-eslint/types": "npm:5.62.0"
-    "@typescript-eslint/typescript-estree": "npm:5.62.0"
-    eslint-scope: "npm:^5.1.1"
-    semver: "npm:^7.3.7"
+    "@eslint-community/eslint-utils": "npm:^4.9.1"
+    "@typescript-eslint/scope-manager": "npm:8.57.2"
+    "@typescript-eslint/types": "npm:8.57.2"
+    "@typescript-eslint/typescript-estree": "npm:8.57.2"
   peerDependencies:
-    eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
-  checksum: 10c0/f09b7d9952e4a205eb1ced31d7684dd55cee40bf8c2d78e923aa8a255318d97279825733902742c09d8690f37a50243f4c4d383ab16bd7aefaf9c4b438f785e1
+    eslint: ^8.57.0 || ^9.0.0 || ^10.0.0
+    typescript: ">=4.8.4 <6.0.0"
+  checksum: 10c0/5771f3d4206004cc817a6556a472926b4c1c885dc448049c10ffab1d5aac7bd59450a391fb57ce8ef31a8367e9c8ddb3bc9370c4e83fc8b61f50fd5189390e8f
   languageName: node
   linkType: hard
 
-"@typescript-eslint/visitor-keys@npm:5.62.0":
-  version: 5.62.0
-  resolution: "@typescript-eslint/visitor-keys@npm:5.62.0"
+"@typescript-eslint/visitor-keys@npm:8.57.2":
+  version: 8.57.2
+  resolution: "@typescript-eslint/visitor-keys@npm:8.57.2"
   dependencies:
-    "@typescript-eslint/types": "npm:5.62.0"
-    eslint-visitor-keys: "npm:^3.3.0"
-  checksum: 10c0/7c3b8e4148e9b94d9b7162a596a1260d7a3efc4e65199693b8025c71c4652b8042501c0bc9f57654c1e2943c26da98c0f77884a746c6ae81389fcb0b513d995d
+    "@typescript-eslint/types": "npm:8.57.2"
+    eslint-visitor-keys: "npm:^5.0.0"
+  checksum: 10c0/8ceb8c228bf97b3e4b343bf6e42a91998d2522f459eb6b53c6bfad4898a9df74295660893dee6b698bdbbda537e968bfc13a3c56fc341089ebfba13db766a574
   languageName: node
   linkType: hard
 
@@ -8972,6 +9105,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"abbrev@npm:^2.0.0":
+  version: 2.0.0
+  resolution: "abbrev@npm:2.0.0"
+  checksum: 10c0/f742a5a107473946f426c691c08daba61a1d15942616f300b5d32fd735be88fef5cba24201757b6c407fd564555fb48c751cfa33519b2605c8a7aadd22baf372
+  languageName: node
+  linkType: hard
+
 "abbrev@npm:^4.0.0":
   version: 4.0.0
   resolution: "abbrev@npm:4.0.0"
@@ -8999,7 +9139,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"acorn-jsx@npm:^5.3.2":
+"acorn-jsx@npm:^5.0.0, acorn-jsx@npm:^5.3.2":
   version: 5.3.2
   resolution: "acorn-jsx@npm:5.3.2"
   peerDependencies:
@@ -9017,6 +9157,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"acorn@npm:^8.0.0, acorn@npm:^8.15.0":
+  version: 8.16.0
+  resolution: "acorn@npm:8.16.0"
+  bin:
+    acorn: bin/acorn
+  checksum: 10c0/c9c52697227661b68d0debaf972222d4f622aa06b185824164e153438afa7b08273432ca43ea792cadb24dada1d46f6f6bb1ef8de9956979288cc1b96bf9914e
+  languageName: node
+  linkType: hard
+
 "acorn@npm:^8.1.0, acorn@npm:^8.11.0, acorn@npm:^8.14.0, acorn@npm:^8.4.1, acorn@npm:^8.8.1, acorn@npm:^8.8.2, acorn@npm:^8.9.0":
   version: 8.15.0
   resolution: "acorn@npm:8.15.0"
@@ -9315,6 +9464,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"array-buffer-byte-length@npm:^1.0.2":
+  version: 1.0.2
+  resolution: "array-buffer-byte-length@npm:1.0.2"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    is-array-buffer: "npm:^3.0.5"
+  checksum: 10c0/74e1d2d996941c7a1badda9cabb7caab8c449db9086407cad8a1b71d2604cc8abf105db8ca4e02c04579ec58b7be40279ddb09aea4784832984485499f48432d
+  languageName: node
+  linkType: hard
+
 "array-differ@npm:^3.0.0":
   version: 3.0.0
   resolution: "array-differ@npm:3.0.0"
@@ -9432,6 +9591,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"array.prototype.flatmap@npm:^1.3.3":
+  version: 1.3.3
+  resolution: "array.prototype.flatmap@npm:1.3.3"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    define-properties: "npm:^1.2.1"
+    es-abstract: "npm:^1.23.5"
+    es-shim-unscopables: "npm:^1.0.2"
+  checksum: 10c0/ba899ea22b9dc9bf276e773e98ac84638ed5e0236de06f13d63a90b18ca9e0ec7c97d622d899796e3773930b946cd2413d098656c0c5d8cc58c6f25c21e6bd54
+  languageName: node
+  linkType: hard
+
 "array.prototype.reduce@npm:^1.0.6":
   version: 1.0.7
   resolution: "array.prototype.reduce@npm:1.0.7"
@@ -9476,6 +9647,21 @@ __metadata:
   languageName: node
   linkType: hard
 
+"arraybuffer.prototype.slice@npm:^1.0.4":
+  version: 1.0.4
+  resolution: "arraybuffer.prototype.slice@npm:1.0.4"
+  dependencies:
+    array-buffer-byte-length: "npm:^1.0.1"
+    call-bind: "npm:^1.0.8"
+    define-properties: "npm:^1.2.1"
+    es-abstract: "npm:^1.23.5"
+    es-errors: "npm:^1.3.0"
+    get-intrinsic: "npm:^1.2.6"
+    is-array-buffer: "npm:^3.0.4"
+  checksum: 10c0/2f2459caa06ae0f7f615003f9104b01f6435cc803e11bd2a655107d52a1781dc040532dc44d93026b694cc18793993246237423e13a5337e86b43ed604932c06
+  languageName: node
+  linkType: hard
+
 "arrify@npm:^1.0.1":
   version: 1.0.1
   resolution: "arrify@npm:1.0.1"
@@ -9520,6 +9706,20 @@ __metadata:
   languageName: node
   linkType: hard
 
+"async-function@npm:^1.0.0":
+  version: 1.0.0
+  resolution: "async-function@npm:1.0.0"
+  checksum: 10c0/669a32c2cb7e45091330c680e92eaeb791bc1d4132d827591e499cd1f776ff5a873e77e5f92d0ce795a8d60f10761dec9ddfe7225a5de680f5d357f67b1aac73
+  languageName: node
+  linkType: hard
+
+"async-generator-function@npm:^1.0.0":
+  version: 1.0.0
+  resolution: "async-generator-function@npm:1.0.0"
+  checksum: 10c0/2c50ef856c543ad500d8d8777d347e3c1ba623b93e99c9263ecc5f965c1b12d2a140e2ab6e43c3d0b85366110696f28114649411cbcd10b452a92a2318394186
+  languageName: node
+  linkType: hard
+
 "async@npm:^2.6.4":
   version: 2.6.4
   resolution: "async@npm:2.6.4"
@@ -9844,10 +10044,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"bail@npm:^1.0.0":
-  version: 1.0.5
-  resolution: "bail@npm:1.0.5"
-  checksum: 10c0/4cf7d0b5c82fdc69590b3fe85c17c4ec37647681b20875551fd6187a85c122b20178dc118001d3ebd5d0ab3dc0e95637c71f889f481882ee761db43c6b16fa05
+"bail@npm:^2.0.0":
+  version: 2.0.2
+  resolution: "bail@npm:2.0.2"
+  checksum: 10c0/25cbea309ef6a1f56214187004e8f34014eb015713ea01fa5b9b7e9e776ca88d0fdffd64143ac42dc91966c915a4b7b683411b56e14929fad16153fc026ffb8b
   languageName: node
   linkType: hard
 
@@ -9858,6 +10058,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"balanced-match@npm:^4.0.2":
+  version: 4.0.4
+  resolution: "balanced-match@npm:4.0.4"
+  checksum: 10c0/07e86102a3eb2ee2a6a1a89164f29d0dbaebd28f2ca3f5ca786f36b8b23d9e417eb3be45a4acf754f837be5ac0a2317de90d3fcb7f4f4dc95720a1f36b26a17b
+  languageName: node
+  linkType: hard
+
 "base64-js@npm:^1.3.1":
   version: 1.5.1
   resolution: "base64-js@npm:1.5.1"
@@ -9978,6 +10185,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"brace-expansion@npm:^5.0.2":
+  version: 5.0.4
+  resolution: "brace-expansion@npm:5.0.4"
+  dependencies:
+    balanced-match: "npm:^4.0.2"
+  checksum: 10c0/359cbcfa80b2eb914ca1f3440e92313fbfe7919ee6b274c35db55bec555aded69dac5ee78f102cec90c35f98c20fa43d10936d0cd9978158823c249257e1643a
+  languageName: node
+  linkType: hard
+
 "braces@npm:^3.0.2, braces@npm:^3.0.3, braces@npm:~3.0.2":
   version: 3.0.3
   resolution: "braces@npm:3.0.3"
@@ -10170,7 +10386,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"call-bind-apply-helpers@npm:^1.0.1, call-bind-apply-helpers@npm:^1.0.2":
+"call-bind-apply-helpers@npm:^1.0.0, call-bind-apply-helpers@npm:^1.0.1, call-bind-apply-helpers@npm:^1.0.2":
   version: 1.0.2
   resolution: "call-bind-apply-helpers@npm:1.0.2"
   dependencies:
@@ -10193,6 +10409,28 @@ __metadata:
   languageName: node
   linkType: hard
 
+"call-bind@npm:^1.0.8":
+  version: 1.0.8
+  resolution: "call-bind@npm:1.0.8"
+  dependencies:
+    call-bind-apply-helpers: "npm:^1.0.0"
+    es-define-property: "npm:^1.0.0"
+    get-intrinsic: "npm:^1.2.4"
+    set-function-length: "npm:^1.2.2"
+  checksum: 10c0/a13819be0681d915144467741b69875ae5f4eba8961eb0bf322aab63ec87f8250eb6d6b0dcbb2e1349876412a56129ca338592b3829ef4343527f5f18a0752d4
+  languageName: node
+  linkType: hard
+
+"call-bound@npm:^1.0.2, call-bound@npm:^1.0.3, call-bound@npm:^1.0.4":
+  version: 1.0.4
+  resolution: "call-bound@npm:1.0.4"
+  dependencies:
+    call-bind-apply-helpers: "npm:^1.0.2"
+    get-intrinsic: "npm:^1.3.0"
+  checksum: 10c0/f4796a6a0941e71c766aea672f63b72bc61234c4f4964dc6d7606e3664c307e7d77845328a8f3359ce39ddb377fed67318f9ee203dea1d47e46165dcf2917644
+  languageName: node
+  linkType: hard
+
 "callsites@npm:^3.0.0, callsites@npm:^3.1.0":
   version: 3.1.0
   resolution: "callsites@npm:3.1.0"
@@ -10273,10 +10511,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"ccount@npm:^1.0.0":
-  version: 1.1.0
-  resolution: "ccount@npm:1.1.0"
-  checksum: 10c0/9ccfddfa45c8d6d01411b8e30d2ce03c55c33f32a69bdb84ee44d743427cdb01b03159954917023d0dac960c34973ba42626bb9fa883491ebb663a53a6713d43
+"ccount@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "ccount@npm:2.0.1"
+  checksum: 10c0/3939b1664390174484322bc3f45b798462e6c07ee6384cb3d645e0aa2f318502d174845198c1561930e1d431087f74cf1fe291ae9a4722821a9f4ba67e574350
   languageName: node
   linkType: hard
 
@@ -10335,31 +10573,31 @@ __metadata:
   languageName: node
   linkType: hard
 
-"character-entities-html4@npm:^1.0.0":
-  version: 1.1.4
-  resolution: "character-entities-html4@npm:1.1.4"
-  checksum: 10c0/00fdcbe8ddb0c5e24718cdbfbbb989054effca87b32ddf92b1a48a7787b99dc1e66c51f5efdaa4d844a2b440618cd3e85ee30ecdc64b7c22a9b36b297452201d
+"character-entities-html4@npm:^2.0.0":
+  version: 2.1.0
+  resolution: "character-entities-html4@npm:2.1.0"
+  checksum: 10c0/fe61b553f083400c20c0b0fd65095df30a0b445d960f3bbf271536ae6c3ba676f39cb7af0b4bf2755812f08ab9b88f2feed68f9aebb73bb153f7a115fe5c6e40
   languageName: node
   linkType: hard
 
-"character-entities-legacy@npm:^1.0.0":
-  version: 1.1.4
-  resolution: "character-entities-legacy@npm:1.1.4"
-  checksum: 10c0/ea4ca9c29887335eed86d78fc67a640168342b1274da84c097abb0575a253d1265281a5052f9a863979e952bcc267b4ecaaf4fe233a7e1e0d8a47806c65b96c7
+"character-entities-legacy@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "character-entities-legacy@npm:3.0.0"
+  checksum: 10c0/ec4b430af873661aa754a896a2b55af089b4e938d3d010fad5219299a6b6d32ab175142699ee250640678cd64bdecd6db3c9af0b8759ab7b155d970d84c4c7d1
   languageName: node
   linkType: hard
 
-"character-entities@npm:^1.0.0":
-  version: 1.2.4
-  resolution: "character-entities@npm:1.2.4"
-  checksum: 10c0/ad015c3d7163563b8a0ee1f587fb0ef305ef344e9fd937f79ca51cccc233786a01d591d989d5bf7b2e66b528ac9efba47f3b1897358324e69932f6d4b25adfe1
+"character-entities@npm:^2.0.0":
+  version: 2.0.2
+  resolution: "character-entities@npm:2.0.2"
+  checksum: 10c0/b0c645a45bcc90ff24f0e0140f4875a8436b8ef13b6bcd31ec02cfb2ca502b680362aa95386f7815bdc04b6464d48cf191210b3840d7c04241a149ede591a308
   languageName: node
   linkType: hard
 
-"character-reference-invalid@npm:^1.0.0":
-  version: 1.1.4
-  resolution: "character-reference-invalid@npm:1.1.4"
-  checksum: 10c0/29f05081c5817bd1e975b0bf61e77b60a40f62ad371d0f0ce0fdb48ab922278bc744d1fbe33771dced751887a8403f265ff634542675c8d7375f6ff4811efd0e
+"character-reference-invalid@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "character-reference-invalid@npm:2.0.1"
+  checksum: 10c0/2ae0dec770cd8659d7e8b0ce24392d83b4c2f0eb4a3395c955dce5528edd4cc030a794cfa06600fcdd700b3f2de2f9b8e40e309c0011c4180e3be64a0b42e6a1
   languageName: node
   linkType: hard
 
@@ -10426,6 +10664,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"ci-info@npm:^4.0.0":
+  version: 4.4.0
+  resolution: "ci-info@npm:4.4.0"
+  checksum: 10c0/44156201545b8dde01aa8a09ee2fe9fc7a73b1bef9adbd4606c9f61c8caeeb73fb7a575c88b0443f7b4edb5ee45debaa59ed54ba5f99698339393ca01349eb3a
+  languageName: node
+  linkType: hard
+
 "ci-info@npm:^4.2.0":
   version: 4.3.0
   resolution: "ci-info@npm:4.3.0"
@@ -10607,13 +10852,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"collapse-white-space@npm:^1.0.2":
-  version: 1.0.6
-  resolution: "collapse-white-space@npm:1.0.6"
-  checksum: 10c0/7fd27a883eee1ddd5e39c53fbcd4a42dfe2a65dfac70e2c442d20827f5258202b360a12e99b4f0128c3addd2d64796bb2eb1bb8a3b75d5a2e9c061adb549c36b
-  languageName: node
-  linkType: hard
-
 "collect-v8-coverage@npm:^1.0.0, collect-v8-coverage@npm:^1.0.2":
   version: 1.0.2
   resolution: "collect-v8-coverage@npm:1.0.2"
@@ -10841,13 +11079,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"confusing-browser-globals@npm:^1.0.10":
-  version: 1.0.11
-  resolution: "confusing-browser-globals@npm:1.0.11"
-  checksum: 10c0/475d0a284fa964a5182b519af5738b5b64bf7e413cfd703c1b3496bf6f4df9f827893a9b221c0ea5873c1476835beb1e0df569ba643eff0734010c1eb780589e
-  languageName: node
-  linkType: hard
-
 "connect-history-api-fallback@npm:^2.0.0":
   version: 2.0.0
   resolution: "connect-history-api-fallback@npm:2.0.0"
@@ -11171,7 +11402,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"convert-source-map@npm:^1.5.0, convert-source-map@npm:^1.7.0":
+"convert-source-map@npm:^1.5.0":
   version: 1.9.0
   resolution: "convert-source-map@npm:1.9.0"
   checksum: 10c0/281da55454bf8126cbc6625385928c43479f2060984180c42f3a86c8b8c12720a24eac260624a7d1e090004028d2dee78602330578ceec1a08e27cb8bb0a8a5b
@@ -11807,6 +12038,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"data-view-buffer@npm:^1.0.2":
+  version: 1.0.2
+  resolution: "data-view-buffer@npm:1.0.2"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    es-errors: "npm:^1.3.0"
+    is-data-view: "npm:^1.0.2"
+  checksum: 10c0/7986d40fc7979e9e6241f85db8d17060dd9a71bd53c894fa29d126061715e322a4cd47a00b0b8c710394854183d4120462b980b8554012acc1c0fa49df7ad38c
+  languageName: node
+  linkType: hard
+
 "data-view-byte-length@npm:^1.0.1":
   version: 1.0.1
   resolution: "data-view-byte-length@npm:1.0.1"
@@ -11818,8 +12060,19 @@ __metadata:
   languageName: node
   linkType: hard
 
-"data-view-byte-offset@npm:^1.0.0":
-  version: 1.0.0
+"data-view-byte-length@npm:^1.0.2":
+  version: 1.0.2
+  resolution: "data-view-byte-length@npm:1.0.2"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    es-errors: "npm:^1.3.0"
+    is-data-view: "npm:^1.0.2"
+  checksum: 10c0/f8a4534b5c69384d95ac18137d381f18a5cfae1f0fc1df0ef6feef51ef0d568606d970b69e02ea186c6c0f0eac77fe4e6ad96fec2569cc86c3afcc7475068c55
+  languageName: node
+  linkType: hard
+
+"data-view-byte-offset@npm:^1.0.0":
+  version: 1.0.0
   resolution: "data-view-byte-offset@npm:1.0.0"
   dependencies:
     call-bind: "npm:^1.0.6"
@@ -11829,6 +12082,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"data-view-byte-offset@npm:^1.0.1":
+  version: 1.0.1
+  resolution: "data-view-byte-offset@npm:1.0.1"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    es-errors: "npm:^1.3.0"
+    is-data-view: "npm:^1.0.1"
+  checksum: 10c0/fa7aa40078025b7810dcffc16df02c480573b7b53ef1205aa6a61533011005c1890e5ba17018c692ce7c900212b547262d33279fde801ad9843edc0863bf78c4
+  languageName: node
+  linkType: hard
+
 "date-format@npm:^4.0.14":
   version: 4.0.14
   resolution: "date-format@npm:4.0.14"
@@ -11885,6 +12149,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"debug@npm:^4.0.0, debug@npm:^4.4.3":
+  version: 4.4.3
+  resolution: "debug@npm:4.4.3"
+  dependencies:
+    ms: "npm:^2.1.3"
+  peerDependenciesMeta:
+    supports-color:
+      optional: true
+  checksum: 10c0/d79136ec6c83ecbefd0f6a5593da6a9c91ec4d7ddc4b54c883d6e71ec9accb5f67a1a5e96d00a328196b5b5c86d365e98d8a3a70856aaf16b4e7b1985e67f5a6
+  languageName: node
+  linkType: hard
+
 "decamelize-keys@npm:^1.1.0":
   version: 1.1.1
   resolution: "decamelize-keys@npm:1.1.1"
@@ -11916,6 +12192,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"decode-named-character-reference@npm:^1.0.0":
+  version: 1.3.0
+  resolution: "decode-named-character-reference@npm:1.3.0"
+  dependencies:
+    character-entities: "npm:^2.0.0"
+  checksum: 10c0/787f4c87f3b82ea342aa7c2d7b1882b6fb9511bb77f72ae44dcaabea0470bacd1e9c6a0080ab886545019fa0cb3a7109573fad6b61a362844c3a0ac52b36e4bb
+  languageName: node
+  linkType: hard
+
 "dedent@npm:0.7.0, dedent@npm:^0.7.0":
   version: 0.7.0
   resolution: "dedent@npm:0.7.0"
@@ -12053,7 +12338,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"dequal@npm:^2.0.2, dequal@npm:^2.0.3":
+"dequal@npm:^2.0.0, dequal@npm:^2.0.2, dequal@npm:^2.0.3":
   version: 2.0.3
   resolution: "dequal@npm:2.0.3"
   checksum: 10c0/f98860cdf58b64991ae10205137c0e97d384c3a4edc7f807603887b7c4b850af1224a33d88012009f150861cbee4fa2d322c4cc04b9313bee312e47f6ecaa888
@@ -12117,6 +12402,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"devlop@npm:^1.0.0, devlop@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "devlop@npm:1.1.0"
+  dependencies:
+    dequal: "npm:^2.0.0"
+  checksum: 10c0/e0928ab8f94c59417a2b8389c45c55ce0a02d9ac7fd74ef62d01ba48060129e1d594501b77de01f3eeafc7cb00773819b0df74d96251cf20b31c5b3071f45c0e
+  languageName: node
+  linkType: hard
+
 "diff-sequences@npm:^29.6.3":
   version: 29.6.3
   resolution: "diff-sequences@npm:29.6.3"
@@ -12354,7 +12648,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"dunder-proto@npm:^1.0.1":
+"dunder-proto@npm:^1.0.0, dunder-proto@npm:^1.0.1":
   version: 1.0.1
   resolution: "dunder-proto@npm:1.0.1"
   dependencies:
@@ -12418,6 +12712,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"emoji-regex@npm:^10.2.1":
+  version: 10.6.0
+  resolution: "emoji-regex@npm:10.6.0"
+  checksum: 10c0/1e4aa097bb007301c3b4b1913879ae27327fdc48e93eeefefe3b87e495eb33c5af155300be951b4349ff6ac084f4403dc9eff970acba7c1c572d89396a9a32d7
+  languageName: node
+  linkType: hard
+
 "emoji-regex@npm:^8.0.0":
   version: 8.0.0
   resolution: "emoji-regex@npm:8.0.0"
@@ -12584,7 +12885,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-abstract@npm:^1.17.2, es-abstract@npm:^1.17.5, es-abstract@npm:^1.22.1, es-abstract@npm:^1.22.3, es-abstract@npm:^1.23.0, es-abstract@npm:^1.23.1, es-abstract@npm:^1.23.2, es-abstract@npm:^1.23.3":
+"es-abstract@npm:^1.17.2, es-abstract@npm:^1.17.5, es-abstract@npm:^1.22.1, es-abstract@npm:^1.22.3, es-abstract@npm:^1.23.0, es-abstract@npm:^1.23.2, es-abstract@npm:^1.23.3":
   version: 1.23.3
   resolution: "es-abstract@npm:1.23.3"
   dependencies:
@@ -12638,6 +12939,68 @@ __metadata:
   languageName: node
   linkType: hard
 
+"es-abstract@npm:^1.23.5, es-abstract@npm:^1.23.6, es-abstract@npm:^1.23.9, es-abstract@npm:^1.24.1":
+  version: 1.24.1
+  resolution: "es-abstract@npm:1.24.1"
+  dependencies:
+    array-buffer-byte-length: "npm:^1.0.2"
+    arraybuffer.prototype.slice: "npm:^1.0.4"
+    available-typed-arrays: "npm:^1.0.7"
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.4"
+    data-view-buffer: "npm:^1.0.2"
+    data-view-byte-length: "npm:^1.0.2"
+    data-view-byte-offset: "npm:^1.0.1"
+    es-define-property: "npm:^1.0.1"
+    es-errors: "npm:^1.3.0"
+    es-object-atoms: "npm:^1.1.1"
+    es-set-tostringtag: "npm:^2.1.0"
+    es-to-primitive: "npm:^1.3.0"
+    function.prototype.name: "npm:^1.1.8"
+    get-intrinsic: "npm:^1.3.0"
+    get-proto: "npm:^1.0.1"
+    get-symbol-description: "npm:^1.1.0"
+    globalthis: "npm:^1.0.4"
+    gopd: "npm:^1.2.0"
+    has-property-descriptors: "npm:^1.0.2"
+    has-proto: "npm:^1.2.0"
+    has-symbols: "npm:^1.1.0"
+    hasown: "npm:^2.0.2"
+    internal-slot: "npm:^1.1.0"
+    is-array-buffer: "npm:^3.0.5"
+    is-callable: "npm:^1.2.7"
+    is-data-view: "npm:^1.0.2"
+    is-negative-zero: "npm:^2.0.3"
+    is-regex: "npm:^1.2.1"
+    is-set: "npm:^2.0.3"
+    is-shared-array-buffer: "npm:^1.0.4"
+    is-string: "npm:^1.1.1"
+    is-typed-array: "npm:^1.1.15"
+    is-weakref: "npm:^1.1.1"
+    math-intrinsics: "npm:^1.1.0"
+    object-inspect: "npm:^1.13.4"
+    object-keys: "npm:^1.1.1"
+    object.assign: "npm:^4.1.7"
+    own-keys: "npm:^1.0.1"
+    regexp.prototype.flags: "npm:^1.5.4"
+    safe-array-concat: "npm:^1.1.3"
+    safe-push-apply: "npm:^1.0.0"
+    safe-regex-test: "npm:^1.1.0"
+    set-proto: "npm:^1.0.0"
+    stop-iteration-iterator: "npm:^1.1.0"
+    string.prototype.trim: "npm:^1.2.10"
+    string.prototype.trimend: "npm:^1.0.9"
+    string.prototype.trimstart: "npm:^1.0.8"
+    typed-array-buffer: "npm:^1.0.3"
+    typed-array-byte-length: "npm:^1.0.3"
+    typed-array-byte-offset: "npm:^1.0.4"
+    typed-array-length: "npm:^1.0.7"
+    unbox-primitive: "npm:^1.1.0"
+    which-typed-array: "npm:^1.1.19"
+  checksum: 10c0/fca062ef8b5daacf743732167d319a212d45cb655b0bb540821d38d715416ae15b04b84fc86da9e2c89135aa7b337337b6c867f84dcde698d75d55688d5d765c
+  languageName: node
+  linkType: hard
+
 "es-array-method-boxes-properly@npm:^1.0.0":
   version: 1.0.0
   resolution: "es-array-method-boxes-properly@npm:1.0.0"
@@ -12659,25 +13022,28 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-iterator-helpers@npm:^1.1.0":
-  version: 1.1.0
-  resolution: "es-iterator-helpers@npm:1.1.0"
+"es-iterator-helpers@npm:^1.2.1":
+  version: 1.3.1
+  resolution: "es-iterator-helpers@npm:1.3.1"
   dependencies:
-    call-bind: "npm:^1.0.7"
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.4"
     define-properties: "npm:^1.2.1"
-    es-abstract: "npm:^1.23.3"
+    es-abstract: "npm:^1.24.1"
     es-errors: "npm:^1.3.0"
-    es-set-tostringtag: "npm:^2.0.3"
+    es-set-tostringtag: "npm:^2.1.0"
     function-bind: "npm:^1.1.2"
-    get-intrinsic: "npm:^1.2.4"
+    get-intrinsic: "npm:^1.3.0"
     globalthis: "npm:^1.0.4"
+    gopd: "npm:^1.2.0"
     has-property-descriptors: "npm:^1.0.2"
-    has-proto: "npm:^1.0.3"
-    has-symbols: "npm:^1.0.3"
-    internal-slot: "npm:^1.0.7"
-    iterator.prototype: "npm:^1.1.3"
-    safe-array-concat: "npm:^1.1.2"
-  checksum: 10c0/84d6c240c7da6e62323b336cb1497781546dab16bebdbd879ccfdf588979712d3e941d41165b6c2ffce5a03a7b929d4e6131d3124d330da1a0e2bfa1da7cd99f
+    has-proto: "npm:^1.2.0"
+    has-symbols: "npm:^1.1.0"
+    internal-slot: "npm:^1.1.0"
+    iterator.prototype: "npm:^1.1.5"
+    math-intrinsics: "npm:^1.1.0"
+    safe-array-concat: "npm:^1.1.3"
+  checksum: 10c0/39837bb23bf6e53a066ae6a218c62bbc2c3cdd7da19336104bd7a16521675fcd9a61abe9cecf37992616584bee1d72f057bac66f2115fcf4840c934df6e96689
   languageName: node
   linkType: hard
 
@@ -12729,6 +13095,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"es-to-primitive@npm:^1.3.0":
+  version: 1.3.0
+  resolution: "es-to-primitive@npm:1.3.0"
+  dependencies:
+    is-callable: "npm:^1.2.7"
+    is-date-object: "npm:^1.0.5"
+    is-symbol: "npm:^1.0.4"
+  checksum: 10c0/c7e87467abb0b438639baa8139f701a06537d2b9bc758f23e8622c3b42fd0fdb5bde0f535686119e446dd9d5e4c0f238af4e14960f4771877cf818d023f6730b
+  languageName: node
+  linkType: hard
+
 "esbuild-register@npm:^3.5.0":
   version: 3.6.0
   resolution: "esbuild-register@npm:3.6.0"
@@ -12975,45 +13352,14 @@ __metadata:
   languageName: node
   linkType: hard
 
-"eslint-config-airbnb-base@npm:^14.2.1":
-  version: 14.2.1
-  resolution: "eslint-config-airbnb-base@npm:14.2.1"
-  dependencies:
-    confusing-browser-globals: "npm:^1.0.10"
-    object.assign: "npm:^4.1.2"
-    object.entries: "npm:^1.1.2"
-  peerDependencies:
-    eslint: ^5.16.0 || ^6.8.0 || ^7.2.0
-    eslint-plugin-import: ^2.22.1
-  checksum: 10c0/960654ae93f085800850ba5d54d745e576fb1c9e1fe46d0a64086586a1a6a78753ce6990b46c5543c35ba00ba4aee9018e4d3d3307dba8a0bf864a6ac803de16
-  languageName: node
-  linkType: hard
-
-"eslint-config-airbnb@npm:^18.2.1":
-  version: 18.2.1
-  resolution: "eslint-config-airbnb@npm:18.2.1"
-  dependencies:
-    eslint-config-airbnb-base: "npm:^14.2.1"
-    object.assign: "npm:^4.1.2"
-    object.entries: "npm:^1.1.2"
-  peerDependencies:
-    eslint: ^5.16.0 || ^6.8.0 || ^7.2.0
-    eslint-plugin-import: ^2.22.1
-    eslint-plugin-jsx-a11y: ^6.4.1
-    eslint-plugin-react: ^7.21.5
-    eslint-plugin-react-hooks: ^4 || ^3 || ^2.3.0 || ^1.7.0
-  checksum: 10c0/236ce3faf1c43079b441c8c5fe530d42f000d5abd9f5e55f0b7e559fcbe60f01b908a18977b0df6fdb9acd14961422fbf5e8c0734ffa380dea0dcd5dce78b8d2
-  languageName: node
-  linkType: hard
-
-"eslint-config-prettier@npm:^8.3.0":
-  version: 8.10.0
-  resolution: "eslint-config-prettier@npm:8.10.0"
+"eslint-config-prettier@npm:^10.1.2":
+  version: 10.1.8
+  resolution: "eslint-config-prettier@npm:10.1.8"
   peerDependencies:
     eslint: ">=7.0.0"
   bin:
     eslint-config-prettier: bin/cli.js
-  checksum: 10c0/19f8c497d9bdc111a17a61b25ded97217be3755bbc4714477dfe535ed539dddcaf42ef5cf8bb97908b058260cf89a3d7c565cb0be31096cbcd39f4c2fa5fe43c
+  checksum: 10c0/e1bcfadc9eccd526c240056b1e59c5cd26544fe59feb85f38f4f1f116caed96aea0b3b87868e68b3099e55caaac3f2e5b9f58110f85db893e83a332751192682
   languageName: node
   linkType: hard
 
@@ -13028,19 +13374,29 @@ __metadata:
   languageName: node
   linkType: hard
 
-"eslint-mdx@npm:^1.15.0":
-  version: 1.17.1
-  resolution: "eslint-mdx@npm:1.17.1"
+"eslint-mdx@npm:^3.4.1":
+  version: 3.7.0
+  resolution: "eslint-mdx@npm:3.7.0"
   dependencies:
-    cosmiconfig: "npm:^7.0.1"
-    remark-mdx: "npm:^1.6.22"
-    remark-parse: "npm:^8.0.3"
-    remark-stringify: "npm:^8.1.1"
-    tslib: "npm:^2.3.1"
-    unified: "npm:^9.2.2"
+    acorn: "npm:^8.15.0"
+    acorn-jsx: "npm:^5.3.2"
+    espree: "npm:^9.6.1 || ^10.4.0"
+    estree-util-visit: "npm:^2.0.0"
+    remark-mdx: "npm:^3.1.0"
+    remark-parse: "npm:^11.0.0"
+    remark-stringify: "npm:^11.0.0"
+    synckit: "npm:^0.11.8"
+    unified: "npm:^11.0.5"
+    unified-engine: "npm:^11.2.2"
+    unist-util-visit: "npm:^5.0.0"
+    vfile: "npm:^6.0.3"
   peerDependencies:
-    eslint: ">=5.0.0"
-  checksum: 10c0/8ffe6c7aa9fa703db68318eac96d0e590a42a65cd5d5e224b78cd3aa9bac090ce07ad66ae2c24077c327b300c3ca4c519159da7669fd2134868375c9f68139ab
+    eslint: ">=8.0.0"
+    remark-lint-file-extension: "*"
+  peerDependenciesMeta:
+    remark-lint-file-extension:
+      optional: true
+  checksum: 10c0/e8c4a4616f58ee73d59eb6bf30cbc334530548795855d770abe5377751a44c0cd86cbf534197c36c9f0b5e10cd62f9641e1ad9b9f38cbf8b43ac75fc3057e0bb
   languageName: node
   linkType: hard
 
@@ -13060,7 +13416,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "eslint-plugin-gamut@workspace:packages/eslint-plugin-gamut"
   dependencies:
-    "@typescript-eslint/utils": "npm:^5.15.0"
+    "@typescript-eslint/utils": "npm:^8.57.0"
   languageName: unknown
   linkType: soft
 
@@ -13093,35 +13449,25 @@ __metadata:
   languageName: node
   linkType: hard
 
-"eslint-plugin-jest-react@npm:^0.1.0":
-  version: 0.1.0
-  resolution: "eslint-plugin-jest-react@npm:0.1.0"
-  dependencies:
-    "@typescript-eslint/experimental-utils": "npm:^5.3.1"
-  peerDependencies:
-    eslint: ">=5.0.0"
-  checksum: 10c0/2f7e266afc91538c7641a2186e94f94790b3c008281ad8c7912015ec5167bece6b684d33ff8c0a5033098eb08536d4e127968aca0877f4a73bdfe380bda23a41
-  languageName: node
-  linkType: hard
-
-"eslint-plugin-jest@npm:^25.2.4":
-  version: 25.7.0
-  resolution: "eslint-plugin-jest@npm:25.7.0"
+"eslint-plugin-jest@npm:^28.11.0":
+  version: 28.14.0
+  resolution: "eslint-plugin-jest@npm:28.14.0"
   dependencies:
-    "@typescript-eslint/experimental-utils": "npm:^5.0.0"
+    "@typescript-eslint/utils": "npm:^6.0.0 || ^7.0.0 || ^8.0.0"
   peerDependencies:
-    "@typescript-eslint/eslint-plugin": ^4.0.0 || ^5.0.0
-    eslint: ^6.0.0 || ^7.0.0 || ^8.0.0
+    "@typescript-eslint/eslint-plugin": ^6.0.0 || ^7.0.0 || ^8.0.0
+    eslint: ^7.0.0 || ^8.0.0 || ^9.0.0
+    jest: "*"
   peerDependenciesMeta:
     "@typescript-eslint/eslint-plugin":
       optional: true
     jest:
       optional: true
-  checksum: 10c0/72dad05323d54e815c2bb10235bd5b77423796ef2e2940f7dba28bdb6cfac5a578793d3f0c7ac74618c41f9d8d6f345097a2a1f89f41aeec27bb873cb66ab270
+  checksum: 10c0/da9c99dd8a1a80aa0c126ff4558882451dcee61b7e4c88e2407ac27d0c86fad2951384a4b037748e26f8743890b4628c6917b0760b01b7017c53fb29768584bc
   languageName: node
   linkType: hard
 
-"eslint-plugin-jsx-a11y@npm:^6.4.1":
+"eslint-plugin-jsx-a11y@npm:^6.10.2":
   version: 6.10.2
   resolution: "eslint-plugin-jsx-a11y@npm:6.10.2"
   dependencies:
@@ -13164,82 +13510,73 @@ __metadata:
   languageName: node
   linkType: hard
 
-"eslint-plugin-no-only-tests@npm:^2.6.0":
-  version: 2.6.0
-  resolution: "eslint-plugin-no-only-tests@npm:2.6.0"
-  checksum: 10c0/23e0a65f7483fac71073535a12567dab1a32fa2fb1e993cac60bbb93409f669ee98a2a296c3a4f862aefa76850a1576c17511cb21e6e2470a58a8c6f9b6f3043
+"eslint-plugin-no-only-tests@npm:^3.3.0":
+  version: 3.3.0
+  resolution: "eslint-plugin-no-only-tests@npm:3.3.0"
+  checksum: 10c0/a04425d9d3bcd745267168782eb12a3a712b8357264ddd4e204204318975c2c21e2c1efe68113181de908548a85762205b61d8f92ec9dc5e0a5ae54c0240a24d
   languageName: node
   linkType: hard
 
-"eslint-plugin-react-hooks@npm:^4.3.0":
-  version: 4.6.2
-  resolution: "eslint-plugin-react-hooks@npm:4.6.2"
+"eslint-plugin-react-hooks@npm:^5.2.0":
+  version: 5.2.0
+  resolution: "eslint-plugin-react-hooks@npm:5.2.0"
   peerDependencies:
-    eslint: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0
-  checksum: 10c0/4844e58c929bc05157fb70ba1e462e34f1f4abcbc8dd5bbe5b04513d33e2699effb8bca668297976ceea8e7ebee4e8fc29b9af9d131bcef52886feaa2308b2cc
+    eslint: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0 || ^9.0.0
+  checksum: 10c0/1c8d50fa5984c6dea32470651807d2922cc3934cf3425e78f84a24c2dfd972e7f019bee84aefb27e0cf2c13fea0ac1d4473267727408feeb1c56333ca1489385
   languageName: node
   linkType: hard
 
-"eslint-plugin-react@npm:^7.26.1":
-  version: 7.37.2
-  resolution: "eslint-plugin-react@npm:7.37.2"
+"eslint-plugin-react@npm:^7.37.5":
+  version: 7.37.5
+  resolution: "eslint-plugin-react@npm:7.37.5"
   dependencies:
     array-includes: "npm:^3.1.8"
     array.prototype.findlast: "npm:^1.2.5"
-    array.prototype.flatmap: "npm:^1.3.2"
+    array.prototype.flatmap: "npm:^1.3.3"
     array.prototype.tosorted: "npm:^1.1.4"
     doctrine: "npm:^2.1.0"
-    es-iterator-helpers: "npm:^1.1.0"
+    es-iterator-helpers: "npm:^1.2.1"
     estraverse: "npm:^5.3.0"
     hasown: "npm:^2.0.2"
     jsx-ast-utils: "npm:^2.4.1 || ^3.0.0"
     minimatch: "npm:^3.1.2"
-    object.entries: "npm:^1.1.8"
+    object.entries: "npm:^1.1.9"
     object.fromentries: "npm:^2.0.8"
-    object.values: "npm:^1.2.0"
+    object.values: "npm:^1.2.1"
     prop-types: "npm:^15.8.1"
     resolve: "npm:^2.0.0-next.5"
     semver: "npm:^6.3.1"
-    string.prototype.matchall: "npm:^4.0.11"
+    string.prototype.matchall: "npm:^4.0.12"
     string.prototype.repeat: "npm:^1.0.0"
   peerDependencies:
     eslint: ^3 || ^4 || ^5 || ^6 || ^7 || ^8 || ^9.7
-  checksum: 10c0/01c498f263c201698bf653973760f86a07fa0cdec56c044f3eaa5ddaae71c64326015dfa5fde76ca8c5386ffe789fc79932624b614e13b6a1ad789fee3f7c491
+  checksum: 10c0/c850bfd556291d4d9234f5ca38db1436924a1013627c8ab1853f77cac73ec19b020e861e6c7b783436a48b6ffcdfba4547598235a37ad4611b6739f65fd8ad57
   languageName: node
   linkType: hard
 
-"eslint-plugin-simple-import-sort@npm:^7.0.0":
-  version: 7.0.0
-  resolution: "eslint-plugin-simple-import-sort@npm:7.0.0"
+"eslint-plugin-simple-import-sort@npm:^12.1.1":
+  version: 12.1.1
+  resolution: "eslint-plugin-simple-import-sort@npm:12.1.1"
   peerDependencies:
     eslint: ">=5.0.0"
-  checksum: 10c0/93259eb66e165a253c94241ea9a1f2e732accc3af1029fc1895e68135adc0c5895ad8c7350781d0bccc220248de8662ffc9fed603c344d5bab69b3ebe2af85aa
+  checksum: 10c0/0ad1907ad9ddbadd1db655db0a9d0b77076e274b793a77b982c8525d808d868e6ecfce24f3a411e8a1fa551077387f9ebb38c00956073970ebd7ee6a029ce2b3
   languageName: node
   linkType: hard
 
-"eslint-plugin-unused-imports@npm:^1.1.5":
-  version: 1.1.5
-  resolution: "eslint-plugin-unused-imports@npm:1.1.5"
-  dependencies:
-    eslint-rule-composer: "npm:^0.3.0"
+"eslint-plugin-unused-imports@npm:^4.1.4":
+  version: 4.4.1
+  resolution: "eslint-plugin-unused-imports@npm:4.4.1"
   peerDependencies:
-    "@typescript-eslint/eslint-plugin": ^4.14.2
-    eslint: ^6.0.0 || ^7.0.0
+    "@typescript-eslint/eslint-plugin": ^8.0.0-0 || ^7.0.0 || ^6.0.0 || ^5.0.0
+    eslint: ^10.0.0 || ^9.0.0 || ^8.0.0
   peerDependenciesMeta:
     "@typescript-eslint/eslint-plugin":
       optional: true
-  checksum: 10c0/57b390b3cb5804f71927b244e52701212c980644845de5bc9d20ef5850779c1395c7979c1886aad1c8797ea5ddbb511f5da8ea7503dc9bcfb6afee159737496a
-  languageName: node
-  linkType: hard
-
-"eslint-rule-composer@npm:^0.3.0":
-  version: 0.3.0
-  resolution: "eslint-rule-composer@npm:0.3.0"
-  checksum: 10c0/1f0c40d209e1503a955101a0dbba37e7fc67c8aaa47a5b9ae0b0fcbae7022c86e52b3df2b1b9ffd658e16cd80f31fff92e7222460a44d8251e61d49e0af79a07
+  checksum: 10c0/bef630eedc3c239ca1c0a11c6af60485310e3934bd0819d3eb51e0acabdafc722c97d35457750a957541f5cc6a99aa78abb359eb3837d3702d836b6d24cbd573
   languageName: node
   linkType: hard
 
-"eslint-scope@npm:5.1.1, eslint-scope@npm:^5.1.1":
+"eslint-scope@npm:5.1.1":
   version: 5.1.1
   resolution: "eslint-scope@npm:5.1.1"
   dependencies:
@@ -13259,14 +13596,28 @@ __metadata:
   languageName: node
   linkType: hard
 
-"eslint-visitor-keys@npm:^3.3.0, eslint-visitor-keys@npm:^3.4.1, eslint-visitor-keys@npm:^3.4.3":
+"eslint-visitor-keys@npm:^3.4.1, eslint-visitor-keys@npm:^3.4.3":
   version: 3.4.3
   resolution: "eslint-visitor-keys@npm:3.4.3"
   checksum: 10c0/92708e882c0a5ffd88c23c0b404ac1628cf20104a108c745f240a13c332a11aac54f49a22d5762efbffc18ecbc9a580d1b7ad034bf5f3cc3307e5cbff2ec9820
   languageName: node
   linkType: hard
 
-"eslint@npm:^8.11.0":
+"eslint-visitor-keys@npm:^4.2.1":
+  version: 4.2.1
+  resolution: "eslint-visitor-keys@npm:4.2.1"
+  checksum: 10c0/fcd43999199d6740db26c58dbe0c2594623e31ca307e616ac05153c9272f12f1364f5a0b1917a8e962268fdecc6f3622c1c2908b4fcc2e047a106fe6de69dc43
+  languageName: node
+  linkType: hard
+
+"eslint-visitor-keys@npm:^5.0.0":
+  version: 5.0.1
+  resolution: "eslint-visitor-keys@npm:5.0.1"
+  checksum: 10c0/16190bdf2cbae40a1109384c94450c526a79b0b9c3cb21e544256ed85ac48a4b84db66b74a6561d20fe6ab77447f150d711c2ad5ad74df4fcc133736bce99678
+  languageName: node
+  linkType: hard
+
+"eslint@npm:^8.57.0":
   version: 8.57.1
   resolution: "eslint@npm:8.57.1"
   dependencies:
@@ -13325,6 +13676,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"espree@npm:^9.6.1 || ^10.4.0":
+  version: 10.4.0
+  resolution: "espree@npm:10.4.0"
+  dependencies:
+    acorn: "npm:^8.15.0"
+    acorn-jsx: "npm:^5.3.2"
+    eslint-visitor-keys: "npm:^4.2.1"
+  checksum: 10c0/c63fe06131c26c8157b4083313cb02a9a54720a08e21543300e55288c40e06c3fc284bdecf108d3a1372c5934a0a88644c98714f38b6ae8ed272b40d9ea08d6b
+  languageName: node
+  linkType: hard
+
 "esprima@npm:^4.0.0, esprima@npm:^4.0.1, esprima@npm:~4.0.0":
   version: 4.0.1
   resolution: "esprima@npm:4.0.1"
@@ -13367,6 +13729,23 @@ __metadata:
   languageName: node
   linkType: hard
 
+"estree-util-is-identifier-name@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "estree-util-is-identifier-name@npm:3.0.0"
+  checksum: 10c0/d1881c6ed14bd588ebd508fc90bf2a541811dbb9ca04dec2f39d27dcaa635f85b5ed9bbbe7fc6fb1ddfca68744a5f7c70456b4b7108b6c4c52780631cc787c5b
+  languageName: node
+  linkType: hard
+
+"estree-util-visit@npm:^2.0.0":
+  version: 2.0.0
+  resolution: "estree-util-visit@npm:2.0.0"
+  dependencies:
+    "@types/estree-jsx": "npm:^1.0.0"
+    "@types/unist": "npm:^3.0.0"
+  checksum: 10c0/acda8b03cc8f890d79c7c7361f6c95331ba84b7ccc0c32b49f447fc30206b20002b37ffdfc97b6ad16e6fe065c63ecbae1622492e2b6b4775c15966606217f39
+  languageName: node
+  linkType: hard
+
 "estree-walker@npm:^0.6.1":
   version: 0.6.1
   resolution: "estree-walker@npm:0.6.1"
@@ -13691,6 +14070,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"fdir@npm:^6.5.0":
+  version: 6.5.0
+  resolution: "fdir@npm:6.5.0"
+  peerDependencies:
+    picomatch: ^3 || ^4
+  peerDependenciesMeta:
+    picomatch:
+      optional: true
+  checksum: 10c0/e345083c4306b3aed6cb8ec551e26c36bab5c511e99ea4576a16750ddc8d3240e63826cc624f5ae17ad4dc82e68a253213b60d556c11bfad064b7607847ed07f
+  languageName: node
+  linkType: hard
+
 "figures@npm:3.2.0, figures@npm:^3.0.0":
   version: 3.2.0
   resolution: "figures@npm:3.2.0"
@@ -13912,6 +14303,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"for-each@npm:^0.3.5":
+  version: 0.3.5
+  resolution: "for-each@npm:0.3.5"
+  dependencies:
+    is-callable: "npm:^1.2.7"
+  checksum: 10c0/0e0b50f6a843a282637d43674d1fb278dda1dd85f4f99b640024cfb10b85058aac0cc781bf689d5fe50b4b7f638e91e548560723a4e76e04fe96ae35ef039cee
+  languageName: node
+  linkType: hard
+
 "foreground-child@npm:^3.1.0":
   version: 3.3.0
   resolution: "foreground-child@npm:3.3.0"
@@ -14177,6 +14577,20 @@ __metadata:
   languageName: node
   linkType: hard
 
+"function.prototype.name@npm:^1.1.8":
+  version: 1.1.8
+  resolution: "function.prototype.name@npm:1.1.8"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.3"
+    define-properties: "npm:^1.2.1"
+    functions-have-names: "npm:^1.2.3"
+    hasown: "npm:^2.0.2"
+    is-callable: "npm:^1.2.7"
+  checksum: 10c0/e920a2ab52663005f3cbe7ee3373e3c71c1fb5558b0b0548648cdf3e51961085032458e26c71ff1a8c8c20e7ee7caeb03d43a5d1fa8610c459333323a2e71253
+  languageName: node
+  linkType: hard
+
 "functions-have-names@npm:^1.2.3":
   version: 1.2.3
   resolution: "functions-have-names@npm:1.2.3"
@@ -14193,7 +14607,7 @@ __metadata:
     "@babel/preset-env": "npm:^7.24.7"
     "@babel/preset-react": "npm:^7.24.7"
     "@babel/preset-typescript": "npm:^7.24.7"
-    "@codecademy/eslint-config": "npm:8.0.0"
+    "@codecademy/eslint-config": "npm:8.2.0"
     "@codecademy/prettier-config": "npm:^0.2.0"
     "@codecademy/tsconfig": "npm:^0.3.0"
     "@emotion/babel-plugin": "npm:11.11.0"
@@ -14233,8 +14647,8 @@ __metadata:
     "@types/react-dom": "npm:^18.2.0"
     "@types/react-test-renderer": "npm:^18.2.0"
     "@types/stylis": "npm:^4.2.0"
-    "@typescript-eslint/eslint-plugin": "npm:^5.15.0"
-    "@typescript-eslint/parser": "npm:^5.15.0"
+    "@typescript-eslint/eslint-plugin": "npm:^8.57.0"
+    "@typescript-eslint/parser": "npm:^8.57.0"
     "@vidstack/react": "npm:^1.12.12"
     babel-jest: "npm:29.6.4"
     babel-plugin-macros: "npm:3.0.1"
@@ -14243,7 +14657,7 @@ __metadata:
     conventional-changelog-conventionalcommits: "npm:^4.3.0"
     core-js: "npm:3.7.0"
     cpy-cli: "npm:^4.1.0"
-    eslint: "npm:^8.11.0"
+    eslint: "npm:^8.57.0"
     eslint-plugin-gamut: "npm:^2.0.0"
     eslint-plugin-local-rules: "npm:^1.1.0"
     eslint-plugin-lodash: "npm:^7.4.0"
@@ -14275,7 +14689,7 @@ __metadata:
     ts-jest: "npm:29.1.1"
     ts-node: "npm:10.9.1"
     tslib: "npm:2.4.0"
-    typescript: "npm:5.1.3"
+    typescript: "npm:5.9.3"
   languageName: unknown
   linkType: soft
 
@@ -14295,6 +14709,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"generator-function@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "generator-function@npm:2.0.1"
+  checksum: 10c0/8a9f59df0f01cfefafdb3b451b80555e5cf6d76487095db91ac461a0e682e4ff7a9dbce15f4ecec191e53586d59eece01949e05a4b4492879600bbbe8e28d6b8
+  languageName: node
+  linkType: hard
+
 "generic-names@npm:^4.0.0":
   version: 4.0.0
   resolution: "generic-names@npm:4.0.0"
@@ -14304,7 +14725,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"gensync@npm:^1.0.0-beta.1, gensync@npm:^1.0.0-beta.2":
+"gensync@npm:^1.0.0-beta.2":
   version: 1.0.0-beta.2
   resolution: "gensync@npm:1.0.0-beta.2"
   checksum: 10c0/782aba6cba65b1bb5af3b095d96249d20edbe8df32dbf4696fd49be2583faf676173bf4809386588828e4dd76a3354fcbeb577bab1c833ccd9fc4577f26103f8
@@ -14336,6 +14757,27 @@ __metadata:
   languageName: node
   linkType: hard
 
+"get-intrinsic@npm:^1.2.5, get-intrinsic@npm:^1.2.7, get-intrinsic@npm:^1.3.0":
+  version: 1.3.1
+  resolution: "get-intrinsic@npm:1.3.1"
+  dependencies:
+    async-function: "npm:^1.0.0"
+    async-generator-function: "npm:^1.0.0"
+    call-bind-apply-helpers: "npm:^1.0.2"
+    es-define-property: "npm:^1.0.1"
+    es-errors: "npm:^1.3.0"
+    es-object-atoms: "npm:^1.1.1"
+    function-bind: "npm:^1.1.2"
+    generator-function: "npm:^2.0.0"
+    get-proto: "npm:^1.0.1"
+    gopd: "npm:^1.2.0"
+    has-symbols: "npm:^1.1.0"
+    hasown: "npm:^2.0.2"
+    math-intrinsics: "npm:^1.1.0"
+  checksum: 10c0/9f4ab0cf7efe0fd2c8185f52e6f637e708f3a112610c88869f8f041bb9ecc2ce44bf285dfdbdc6f4f7c277a5b88d8e94a432374d97cca22f3de7fc63795deb5d
+  languageName: node
+  linkType: hard
+
 "get-nonce@npm:^1.0.0":
   version: 1.0.1
   resolution: "get-nonce@npm:1.0.1"
@@ -14371,7 +14813,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"get-proto@npm:^1.0.1":
+"get-proto@npm:^1.0.0, get-proto@npm:^1.0.1":
   version: 1.0.1
   resolution: "get-proto@npm:1.0.1"
   dependencies:
@@ -14406,6 +14848,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"get-symbol-description@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "get-symbol-description@npm:1.1.0"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    es-errors: "npm:^1.3.0"
+    get-intrinsic: "npm:^1.2.6"
+  checksum: 10c0/d6a7d6afca375779a4b307738c9e80dbf7afc0bdbe5948768d54ab9653c865523d8920e670991a925936eb524b7cb6a6361d199a760b21d0ca7620194455aa4b
+  languageName: node
+  linkType: hard
+
 "gh-pages@npm:^5.0.0":
   version: 5.0.0
   resolution: "gh-pages@npm:5.0.0"
@@ -14553,6 +15006,22 @@ __metadata:
   languageName: node
   linkType: hard
 
+"glob@npm:^10.0.0":
+  version: 10.5.0
+  resolution: "glob@npm:10.5.0"
+  dependencies:
+    foreground-child: "npm:^3.1.0"
+    jackspeak: "npm:^3.1.2"
+    minimatch: "npm:^9.0.4"
+    minipass: "npm:^7.1.2"
+    package-json-from-dist: "npm:^1.0.0"
+    path-scurry: "npm:^1.11.1"
+  bin:
+    glob: dist/esm/bin.mjs
+  checksum: 10c0/100705eddbde6323e7b35e1d1ac28bcb58322095bd8e63a7d0bef1a2cdafe0d0f7922a981b2b48369a4f8c1b077be5c171804534c3509dfe950dde15fbe6d828
+  languageName: node
+  linkType: hard
+
 "glob@npm:^10.2.2, glob@npm:^10.3.10":
   version: 10.4.5
   resolution: "glob@npm:10.4.5"
@@ -14685,7 +15154,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"globby@npm:11.1.0, globby@npm:^11.1.0":
+"globby@npm:11.1.0":
   version: 11.1.0
   resolution: "globby@npm:11.1.0"
   dependencies:
@@ -14836,6 +15305,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"has-proto@npm:^1.2.0":
+  version: 1.2.0
+  resolution: "has-proto@npm:1.2.0"
+  dependencies:
+    dunder-proto: "npm:^1.0.0"
+  checksum: 10c0/46538dddab297ec2f43923c3d35237df45d8c55a6fc1067031e04c13ed8a9a8f94954460632fd4da84c31a1721eefee16d901cbb1ae9602bab93bb6e08f93b95
+  languageName: node
+  linkType: hard
+
 "has-symbols@npm:^1.0.1, has-symbols@npm:^1.0.2, has-symbols@npm:^1.0.3, has-symbols@npm:^1.1.0":
   version: 1.1.0
   resolution: "has-symbols@npm:1.1.0"
@@ -15345,6 +15823,20 @@ __metadata:
   languageName: node
   linkType: hard
 
+"ignore@npm:^6.0.0":
+  version: 6.0.2
+  resolution: "ignore@npm:6.0.2"
+  checksum: 10c0/9a38feac1861906a78ba0f03e8ef3cd6b0526dce2a1a84e1009324b557763afeb9c3ebcc04666b21f7bbf71adda45e76781bb9e2eaa0903d45dcaded634454f5
+  languageName: node
+  linkType: hard
+
+"ignore@npm:^7.0.5":
+  version: 7.0.5
+  resolution: "ignore@npm:7.0.5"
+  checksum: 10c0/ae00db89fe873064a093b8999fe4cc284b13ef2a178636211842cceb650b9c3e390d3339191acb145d81ed5379d2074840cf0c33a20bdbd6f32821f79eb4ad5d
+  languageName: node
+  linkType: hard
+
 "image-size@npm:~0.5.0":
   version: 0.5.5
   resolution: "image-size@npm:0.5.5"
@@ -15413,6 +15905,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"import-meta-resolve@npm:^4.0.0":
+  version: 4.2.0
+  resolution: "import-meta-resolve@npm:4.2.0"
+  checksum: 10c0/3ee8aeecb61d19b49d2703987f977e9d1c7d4ba47db615a570eaa02fe414f40dfa63f7b953e842cbe8470d26df6371332bfcf21b2fd92b0112f9fea80dde2c4c
+  languageName: node
+  linkType: hard
+
 "imurmurhash@npm:^0.1.4":
   version: 0.1.4
   resolution: "imurmurhash@npm:0.1.4"
@@ -15451,7 +15950,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"inherits@npm:2, inherits@npm:2.0.4, inherits@npm:^2.0.0, inherits@npm:^2.0.1, inherits@npm:^2.0.3, inherits@npm:^2.0.4, inherits@npm:~2.0.3":
+"inherits@npm:2, inherits@npm:2.0.4, inherits@npm:^2.0.1, inherits@npm:^2.0.3, inherits@npm:^2.0.4, inherits@npm:~2.0.3":
   version: 2.0.4
   resolution: "inherits@npm:2.0.4"
   checksum: 10c0/4e531f648b29039fb7426fb94075e6545faa1eb9fe83c29f0b6d9e7263aceb4289d2d4557db0d428188eeb449cc7c5e77b0a0b2c4e248ff2a65933a0dee49ef2
@@ -15465,7 +15964,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"ini@npm:4.1.3":
+"ini@npm:4.1.3, ini@npm:^4.1.2, ini@npm:^4.1.3":
   version: 4.1.3
   resolution: "ini@npm:4.1.3"
   checksum: 10c0/0d27eff094d5f3899dd7c00d0c04ea733ca03a8eb6f9406ce15daac1a81de022cb417d6eaff7e4342451ffa663389c565ffc68d6825eaf686bf003280b945764
@@ -15537,6 +16036,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"internal-slot@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "internal-slot@npm:1.1.0"
+  dependencies:
+    es-errors: "npm:^1.3.0"
+    hasown: "npm:^2.0.2"
+    side-channel: "npm:^1.1.0"
+  checksum: 10c0/03966f5e259b009a9bf1a78d60da920df198af4318ec004f57b8aef1dd3fe377fbc8cce63a96e8c810010302654de89f9e19de1cd8ad0061d15be28a695465c7
+  languageName: node
+  linkType: hard
+
 "intl-messageformat@npm:^10.1.0":
   version: 10.7.16
   resolution: "intl-messageformat@npm:10.7.16"
@@ -15579,27 +16089,20 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-alphabetical@npm:1.0.4, is-alphabetical@npm:^1.0.0":
-  version: 1.0.4
-  resolution: "is-alphabetical@npm:1.0.4"
-  checksum: 10c0/1505b1de5a1fd74022c05fb21b0e683a8f5229366bac8dc4d34cf6935bcfd104d1125a5e6b083fb778847629f76e5bdac538de5367bdf2b927a1356164e23985
-  languageName: node
-  linkType: hard
-
-"is-alphanumeric@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "is-alphanumeric@npm:1.0.0"
-  checksum: 10c0/d9dfd10738ca922c84e3af6d4863e3f4fdcbb902e70d1f69fc95aca9f6a516c46f34bd58e26897f9e0abb78414b0f871cd39ad9912aa8f7e5a3d4435ff9839e3
+"is-alphabetical@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "is-alphabetical@npm:2.0.1"
+  checksum: 10c0/932367456f17237533fd1fc9fe179df77957271020b83ea31da50e5cc472d35ef6b5fb8147453274ffd251134472ce24eb6f8d8398d96dee98237cdb81a6c9a7
   languageName: node
   linkType: hard
 
-"is-alphanumerical@npm:^1.0.0":
-  version: 1.0.4
-  resolution: "is-alphanumerical@npm:1.0.4"
+"is-alphanumerical@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "is-alphanumerical@npm:2.0.1"
   dependencies:
-    is-alphabetical: "npm:^1.0.0"
-    is-decimal: "npm:^1.0.0"
-  checksum: 10c0/d623abae7130a7015c6bf33d99151d4e7005572fd170b86568ff4de5ae86ac7096608b87dd4a1d4dbbd497e392b6396930ba76c9297a69455909cebb68005905
+    is-alphabetical: "npm:^2.0.0"
+    is-decimal: "npm:^2.0.0"
+  checksum: 10c0/4b35c42b18e40d41378293f82a3ecd9de77049b476f748db5697c297f686e1e05b072a6aaae2d16f54d2a57f85b00cbbe755c75f6d583d1c77d6657bd0feb5a2
   languageName: node
   linkType: hard
 
@@ -15623,6 +16126,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-array-buffer@npm:^3.0.5":
+  version: 3.0.5
+  resolution: "is-array-buffer@npm:3.0.5"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.3"
+    get-intrinsic: "npm:^1.2.6"
+  checksum: 10c0/c5c9f25606e86dbb12e756694afbbff64bc8b348d1bc989324c037e1068695131930199d6ad381952715dad3a9569333817f0b1a72ce5af7f883ce802e49c83d
+  languageName: node
+  linkType: hard
+
 "is-arrayish@npm:^0.2.1":
   version: 0.2.1
   resolution: "is-arrayish@npm:0.2.1"
@@ -15648,6 +16162,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-bigint@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "is-bigint@npm:1.1.0"
+  dependencies:
+    has-bigints: "npm:^1.0.2"
+  checksum: 10c0/f4f4b905ceb195be90a6ea7f34323bf1c18e3793f18922e3e9a73c684c29eeeeff5175605c3a3a74cc38185fe27758f07efba3dbae812e5c5afbc0d2316b40e4
+  languageName: node
+  linkType: hard
+
 "is-binary-path@npm:~2.1.0":
   version: 2.1.0
   resolution: "is-binary-path@npm:2.1.0"
@@ -15667,10 +16190,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-buffer@npm:^2.0.0":
-  version: 2.0.5
-  resolution: "is-buffer@npm:2.0.5"
-  checksum: 10c0/e603f6fced83cf94c53399cff3bda1a9f08e391b872b64a73793b0928be3e5f047f2bcece230edb7632eaea2acdbfcb56c23b33d8a20c820023b230f1485679a
+"is-boolean-object@npm:^1.2.1":
+  version: 1.2.2
+  resolution: "is-boolean-object@npm:1.2.2"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    has-tostringtag: "npm:^1.0.2"
+  checksum: 10c0/36ff6baf6bd18b3130186990026f5a95c709345c39cd368468e6c1b6ab52201e9fd26d8e1f4c066357b4938b0f0401e1a5000e08257787c1a02f3a719457001e
   languageName: node
   linkType: hard
 
@@ -15710,6 +16236,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-data-view@npm:^1.0.2":
+  version: 1.0.2
+  resolution: "is-data-view@npm:1.0.2"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    get-intrinsic: "npm:^1.2.6"
+    is-typed-array: "npm:^1.1.13"
+  checksum: 10c0/ef3548a99d7e7f1370ce21006baca6d40c73e9f15c941f89f0049c79714c873d03b02dae1c64b3f861f55163ecc16da06506c5b8a1d4f16650b3d9351c380153
+  languageName: node
+  linkType: hard
+
 "is-date-object@npm:^1.0.1, is-date-object@npm:^1.0.5":
   version: 1.0.5
   resolution: "is-date-object@npm:1.0.5"
@@ -15719,10 +16256,20 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-decimal@npm:^1.0.0":
-  version: 1.0.4
-  resolution: "is-decimal@npm:1.0.4"
-  checksum: 10c0/a4ad53c4c5c4f5a12214e7053b10326711f6a71f0c63ba1314a77bd71df566b778e4ebd29f9fb6815f07a4dc50c3767fb19bd6fc9fa05e601410f1d64ffeac48
+"is-date-object@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "is-date-object@npm:1.1.0"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    has-tostringtag: "npm:^1.0.2"
+  checksum: 10c0/1a4d199c8e9e9cac5128d32e6626fa7805175af9df015620ac0d5d45854ccf348ba494679d872d37301032e35a54fc7978fba1687e8721b2139aea7870cafa2f
+  languageName: node
+  linkType: hard
+
+"is-decimal@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "is-decimal@npm:2.0.1"
+  checksum: 10c0/8085dd66f7d82f9de818fba48b9e9c0429cb4291824e6c5f2622e96b9680b54a07a624cfc663b24148b8e853c62a1c987cfe8b0b5a13f5156991afaf6736e334
   languageName: node
   linkType: hard
 
@@ -15744,6 +16291,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-empty@npm:^1.0.0":
+  version: 1.2.0
+  resolution: "is-empty@npm:1.2.0"
+  checksum: 10c0/f0dd6534716f2749586c35f1dcf37a0a5ac31e91d629ae2652b36c7f72c0ce71f0b68f082a6eed95b1af6f84ba31cd757c2343b19507878ed1e532a3383ebaaa
+  languageName: node
+  linkType: hard
+
 "is-extglob@npm:^2.1.1":
   version: 2.1.1
   resolution: "is-extglob@npm:2.1.1"
@@ -15751,12 +16305,12 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-finalizationregistry@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "is-finalizationregistry@npm:1.0.2"
+"is-finalizationregistry@npm:^1.1.0":
+  version: 1.1.1
+  resolution: "is-finalizationregistry@npm:1.1.1"
   dependencies:
-    call-bind: "npm:^1.0.2"
-  checksum: 10c0/81caecc984d27b1a35c68741156fc651fb1fa5e3e6710d21410abc527eb226d400c0943a167922b2e920f6b3e58b0dede9aa795882b038b85f50b3a4b877db86
+    call-bound: "npm:^1.0.3"
+  checksum: 10c0/818dff679b64f19e228a8205a1e2d09989a98e98def3a817f889208cfcbf918d321b251aadf2c05918194803ebd2eb01b14fc9d0b2bea53d984f4137bfca5e97
   languageName: node
   linkType: hard
 
@@ -15799,10 +16353,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-hexadecimal@npm:^1.0.0":
-  version: 1.0.4
-  resolution: "is-hexadecimal@npm:1.0.4"
-  checksum: 10c0/ec4c64e5624c0f240922324bc697e166554f09d3ddc7633fc526084502626445d0a871fbd8cae52a9844e83bd0bb414193cc5a66806d7b2867907003fc70c5ea
+"is-hexadecimal@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "is-hexadecimal@npm:2.0.1"
+  checksum: 10c0/3eb60fe2f1e2bbc760b927dcad4d51eaa0c60138cf7fc671803f66353ad90c301605b502c7ea4c6bb0548e1c7e79dfd37b73b632652e3b76030bba603a7e9626
   languageName: node
   linkType: hard
 
@@ -15868,6 +16422,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-number-object@npm:^1.1.1":
+  version: 1.1.1
+  resolution: "is-number-object@npm:1.1.1"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    has-tostringtag: "npm:^1.0.2"
+  checksum: 10c0/97b451b41f25135ff021d85c436ff0100d84a039bb87ffd799cbcdbea81ef30c464ced38258cdd34f080be08fc3b076ca1f472086286d2aa43521d6ec6a79f53
+  languageName: node
+  linkType: hard
+
 "is-number@npm:^7.0.0":
   version: 7.0.0
   resolution: "is-number@npm:7.0.0"
@@ -15896,13 +16460,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-plain-obj@npm:^2.0.0":
-  version: 2.1.0
-  resolution: "is-plain-obj@npm:2.1.0"
-  checksum: 10c0/e5c9814cdaa627a9ad0a0964ded0e0491bfd9ace405c49a5d63c88b30a162f1512c069d5b80997893c4d0181eadc3fed02b4ab4b81059aba5620bfcdfdeb9c53
-  languageName: node
-  linkType: hard
-
 "is-plain-obj@npm:^3.0.0":
   version: 3.0.0
   resolution: "is-plain-obj@npm:3.0.0"
@@ -15910,6 +16467,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-plain-obj@npm:^4.0.0":
+  version: 4.1.0
+  resolution: "is-plain-obj@npm:4.1.0"
+  checksum: 10c0/32130d651d71d9564dc88ba7e6fda0e91a1010a3694648e9f4f47bb6080438140696d3e3e15c741411d712e47ac9edc1a8a9de1fe76f3487b0d90be06ac9975e
+  languageName: node
+  linkType: hard
+
 "is-plain-object@npm:^2.0.4":
   version: 2.0.4
   resolution: "is-plain-object@npm:2.0.4"
@@ -15959,6 +16523,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-regex@npm:^1.2.1":
+  version: 1.2.1
+  resolution: "is-regex@npm:1.2.1"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    gopd: "npm:^1.2.0"
+    has-tostringtag: "npm:^1.0.2"
+    hasown: "npm:^2.0.2"
+  checksum: 10c0/1d3715d2b7889932349241680032e85d0b492cfcb045acb75ffc2c3085e8d561184f1f7e84b6f8321935b4aea39bc9c6ba74ed595b57ce4881a51dfdbc214e04
+  languageName: node
+  linkType: hard
+
 "is-set@npm:^2.0.3":
   version: 2.0.3
   resolution: "is-set@npm:2.0.3"
@@ -15975,6 +16551,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-shared-array-buffer@npm:^1.0.4":
+  version: 1.0.4
+  resolution: "is-shared-array-buffer@npm:1.0.4"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+  checksum: 10c0/65158c2feb41ff1edd6bbd6fd8403a69861cf273ff36077982b5d4d68e1d59278c71691216a4a64632bd76d4792d4d1d2553901b6666d84ade13bba5ea7bc7db
+  languageName: node
+  linkType: hard
+
 "is-ssh@npm:^1.4.0":
   version: 1.4.0
   resolution: "is-ssh@npm:1.4.0"
@@ -16014,6 +16599,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-string@npm:^1.1.1":
+  version: 1.1.1
+  resolution: "is-string@npm:1.1.1"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    has-tostringtag: "npm:^1.0.2"
+  checksum: 10c0/2f518b4e47886bb81567faba6ffd0d8a8333cf84336e2e78bf160693972e32ad00fe84b0926491cc598dee576fdc55642c92e62d0cbe96bf36f643b6f956f94d
+  languageName: node
+  linkType: hard
+
 "is-symbol@npm:^1.0.2, is-symbol@npm:^1.0.3":
   version: 1.0.4
   resolution: "is-symbol@npm:1.0.4"
@@ -16023,6 +16618,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-symbol@npm:^1.0.4, is-symbol@npm:^1.1.1":
+  version: 1.1.1
+  resolution: "is-symbol@npm:1.1.1"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    has-symbols: "npm:^1.1.0"
+    safe-regex-test: "npm:^1.1.0"
+  checksum: 10c0/f08f3e255c12442e833f75a9e2b84b2d4882fdfd920513cf2a4a2324f0a5b076c8fd913778e3ea5d258d5183e9d92c0cd20e04b03ab3df05316b049b2670af1e
+  languageName: node
+  linkType: hard
+
 "is-text-path@npm:^1.0.1":
   version: 1.0.1
   resolution: "is-text-path@npm:1.0.1"
@@ -16041,6 +16647,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-typed-array@npm:^1.1.14, is-typed-array@npm:^1.1.15":
+  version: 1.1.15
+  resolution: "is-typed-array@npm:1.1.15"
+  dependencies:
+    which-typed-array: "npm:^1.1.16"
+  checksum: 10c0/415511da3669e36e002820584e264997ffe277ff136643a3126cc949197e6ca3334d0f12d084e83b1994af2e9c8141275c741cf2b7da5a2ff62dd0cac26f76c4
+  languageName: node
+  linkType: hard
+
 "is-unicode-supported@npm:^0.1.0":
   version: 0.1.0
   resolution: "is-unicode-supported@npm:0.1.0"
@@ -16064,6 +16679,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"is-weakref@npm:^1.1.1":
+  version: 1.1.1
+  resolution: "is-weakref@npm:1.1.1"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+  checksum: 10c0/8e0a9c07b0c780949a100e2cab2b5560a48ecd4c61726923c1a9b77b6ab0aa0046c9e7fb2206042296817045376dee2c8ab1dabe08c7c3dfbf195b01275a085b
+  languageName: node
+  linkType: hard
+
 "is-weakset@npm:^2.0.3":
   version: 2.0.3
   resolution: "is-weakset@npm:2.0.3"
@@ -16081,13 +16705,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-whitespace-character@npm:^1.0.0":
-  version: 1.0.4
-  resolution: "is-whitespace-character@npm:1.0.4"
-  checksum: 10c0/20f02cf42eafb44ff1706a04338dc45095cd691ae6984adb9a211b6b6df8d01e91722129ce55555e4c7c7b0b7d48e217553767f22eb7ec019b9f8dd3bc12cdfb
-  languageName: node
-  linkType: hard
-
 "is-windows@npm:^1.0.1":
   version: 1.0.2
   resolution: "is-windows@npm:1.0.2"
@@ -16095,13 +16712,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-word-character@npm:^1.0.0":
-  version: 1.0.4
-  resolution: "is-word-character@npm:1.0.4"
-  checksum: 10c0/2247844064532986dc70869d961dccd1366932a147b52d4ec7f567f87edf7f9855a27b75f66b781db3b3175bbe05a76acbc6392a1a5c64c4c99fe3459dae33bd
-  languageName: node
-  linkType: hard
-
 "is-wsl@npm:^2.2.0":
   version: 2.2.0
   resolution: "is-wsl@npm:2.2.0"
@@ -16240,16 +16850,17 @@ __metadata:
   languageName: node
   linkType: hard
 
-"iterator.prototype@npm:^1.1.3":
-  version: 1.1.3
-  resolution: "iterator.prototype@npm:1.1.3"
+"iterator.prototype@npm:^1.1.5":
+  version: 1.1.5
+  resolution: "iterator.prototype@npm:1.1.5"
   dependencies:
-    define-properties: "npm:^1.2.1"
-    get-intrinsic: "npm:^1.2.1"
-    has-symbols: "npm:^1.0.3"
-    reflect.getprototypeof: "npm:^1.0.4"
-    set-function-name: "npm:^2.0.1"
-  checksum: 10c0/68b0320c14291fbb3d8ed5a17e255d3127e7971bec19108076667e79c9ff4c7d69f99de4b0b3075c789c3f318366d7a0a35bb086eae0f2cf832dd58465b2f9e6
+    define-data-property: "npm:^1.1.4"
+    es-object-atoms: "npm:^1.0.0"
+    get-intrinsic: "npm:^1.2.6"
+    get-proto: "npm:^1.0.0"
+    has-symbols: "npm:^1.1.0"
+    set-function-name: "npm:^2.0.2"
+  checksum: 10c0/f7a262808e1b41049ab55f1e9c29af7ec1025a000d243b83edf34ce2416eedd56079b117fa59376bb4a724110690f13aa8427f2ee29a09eec63a7e72367626d0
   languageName: node
   linkType: hard
 
@@ -17681,7 +18292,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"lines-and-columns@npm:~2.0.3":
+"lines-and-columns@npm:^2.0.3, lines-and-columns@npm:~2.0.3":
   version: 2.0.4
   resolution: "lines-and-columns@npm:2.0.4"
   checksum: 10c0/4db28bf065cd7ad897c0700f22d3d0d7c5ed6777e138861c601c496d545340df3fc19e18bd04ff8d95a246a245eb55685b82ca2f8c2ca53a008e9c5316250379
@@ -17782,6 +18393,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"load-plugin@npm:^6.0.0":
+  version: 6.0.3
+  resolution: "load-plugin@npm:6.0.3"
+  dependencies:
+    "@npmcli/config": "npm:^8.0.0"
+    import-meta-resolve: "npm:^4.0.0"
+  checksum: 10c0/cbbd4e18472a0ed543b6d60e867a1e2aae385205fcaa76d300ab5a72697e057422cd1e6ff2ba19755c55a86b3d53e53b81a814c757be720895ba525d05f75797
+  languageName: node
+  linkType: hard
+
 "load-script@npm:^1.0.0":
   version: 1.0.0
   resolution: "load-script@npm:1.0.0"
@@ -17900,7 +18521,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"lodash@npm:^4.17.14, lodash@npm:^4.17.15, lodash@npm:^4.17.19, lodash@npm:^4.17.20, lodash@npm:^4.17.21, lodash@npm:^4.17.23":
+"lodash@npm:^4.17.14, lodash@npm:^4.17.15, lodash@npm:^4.17.20, lodash@npm:^4.17.21, lodash@npm:^4.17.23":
   version: 4.17.23
   resolution: "lodash@npm:4.17.23"
   checksum: 10c0/1264a90469f5bb95d4739c43eb6277d15b6d9e186df4ac68c3620443160fc669e2f14c11e7d8b2ccf078b81d06147c01a8ccced9aab9f9f63d50dcf8cace6bf6
@@ -17950,10 +18571,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"longest-streak@npm:^2.0.1":
-  version: 2.0.4
-  resolution: "longest-streak@npm:2.0.4"
-  checksum: 10c0/918fb5104cde537757f44431776d6d828bc091a63ca38a3b3e59a08b88498b4421bf5fd9823ef22b4d186f0234d9943087fa96bd6117d26dedcf6008480fd46a
+"longest-streak@npm:^3.0.0":
+  version: 3.1.0
+  resolution: "longest-streak@npm:3.1.0"
+  checksum: 10c0/7c2f02d0454b52834d1bcedef79c557bd295ee71fdabb02d041ff3aa9da48a90b5df7c0409156dedbc4df9b65da18742652aaea4759d6ece01f08971af6a7eaa
   languageName: node
   linkType: hard
 
@@ -18172,22 +18793,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"markdown-escapes@npm:^1.0.0":
-  version: 1.0.4
-  resolution: "markdown-escapes@npm:1.0.4"
-  checksum: 10c0/cf3f2231191d9df61cd1d02a50a55a5c89ab9cebfe75572950f4844b93a41d561eed2d82e42732d55f2c55fa0d426b51df3a7f378b4068ae1e2923bb758a9cc8
-  languageName: node
-  linkType: hard
-
-"markdown-table@npm:^2.0.0":
-  version: 2.0.0
-  resolution: "markdown-table@npm:2.0.0"
-  dependencies:
-    repeat-string: "npm:^1.0.0"
-  checksum: 10c0/f257e0781ea50eb946919df84bdee4ba61f983971b277a369ca7276f89740fd0e2749b9b187163a42df4c48682b71962d4007215ce3523480028f06c11ddc2e6
-  languageName: node
-  linkType: hard
-
 "marked@npm:^4.3.0":
   version: 4.3.0
   resolution: "marked@npm:4.3.0"
@@ -18204,12 +18809,120 @@ __metadata:
   languageName: node
   linkType: hard
 
-"mdast-util-compact@npm:^2.0.0":
-  version: 2.0.1
-  resolution: "mdast-util-compact@npm:2.0.1"
+"mdast-util-from-markdown@npm:^2.0.0":
+  version: 2.0.3
+  resolution: "mdast-util-from-markdown@npm:2.0.3"
+  dependencies:
+    "@types/mdast": "npm:^4.0.0"
+    "@types/unist": "npm:^3.0.0"
+    decode-named-character-reference: "npm:^1.0.0"
+    devlop: "npm:^1.0.0"
+    mdast-util-to-string: "npm:^4.0.0"
+    micromark: "npm:^4.0.0"
+    micromark-util-decode-numeric-character-reference: "npm:^2.0.0"
+    micromark-util-decode-string: "npm:^2.0.0"
+    micromark-util-normalize-identifier: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+    unist-util-stringify-position: "npm:^4.0.0"
+  checksum: 10c0/d3eac9ac2b88e3b41fb85aa81c7bfd1f4f8a2fde497ad805e66fea7b2abfe486ffd94d2a20f9fd2951dcdebe4916f3bdcf851319891dd62d343e26c2f02583ba
+  languageName: node
+  linkType: hard
+
+"mdast-util-mdx-expression@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "mdast-util-mdx-expression@npm:2.0.1"
+  dependencies:
+    "@types/estree-jsx": "npm:^1.0.0"
+    "@types/hast": "npm:^3.0.0"
+    "@types/mdast": "npm:^4.0.0"
+    devlop: "npm:^1.0.0"
+    mdast-util-from-markdown: "npm:^2.0.0"
+    mdast-util-to-markdown: "npm:^2.0.0"
+  checksum: 10c0/9a1e57940f66431f10312fa239096efa7627f375e7933b5d3162c0b5c1712a72ac87447aff2b6838d2bbd5c1311b188718cc90b33b67dc67a88550e0a6ef6183
+  languageName: node
+  linkType: hard
+
+"mdast-util-mdx-jsx@npm:^3.0.0":
+  version: 3.2.0
+  resolution: "mdast-util-mdx-jsx@npm:3.2.0"
+  dependencies:
+    "@types/estree-jsx": "npm:^1.0.0"
+    "@types/hast": "npm:^3.0.0"
+    "@types/mdast": "npm:^4.0.0"
+    "@types/unist": "npm:^3.0.0"
+    ccount: "npm:^2.0.0"
+    devlop: "npm:^1.1.0"
+    mdast-util-from-markdown: "npm:^2.0.0"
+    mdast-util-to-markdown: "npm:^2.0.0"
+    parse-entities: "npm:^4.0.0"
+    stringify-entities: "npm:^4.0.0"
+    unist-util-stringify-position: "npm:^4.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/3acadaf3b962254f7ad2990fed4729961dc0217ca31fde9917986e880843f3ecf3392b1f22d569235cacd180d50894ad266db7af598aedca69d330d33c7ac613
+  languageName: node
+  linkType: hard
+
+"mdast-util-mdx@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "mdast-util-mdx@npm:3.0.0"
+  dependencies:
+    mdast-util-from-markdown: "npm:^2.0.0"
+    mdast-util-mdx-expression: "npm:^2.0.0"
+    mdast-util-mdx-jsx: "npm:^3.0.0"
+    mdast-util-mdxjs-esm: "npm:^2.0.0"
+    mdast-util-to-markdown: "npm:^2.0.0"
+  checksum: 10c0/4faea13f77d6bc9aa64ee41a5e4779110b73444a17fda363df6ebe880ecfa58b321155b71f8801c3faa6d70d6222a32a00cbd6dbf5fad8db417f4688bc9c74e1
+  languageName: node
+  linkType: hard
+
+"mdast-util-mdxjs-esm@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "mdast-util-mdxjs-esm@npm:2.0.1"
+  dependencies:
+    "@types/estree-jsx": "npm:^1.0.0"
+    "@types/hast": "npm:^3.0.0"
+    "@types/mdast": "npm:^4.0.0"
+    devlop: "npm:^1.0.0"
+    mdast-util-from-markdown: "npm:^2.0.0"
+    mdast-util-to-markdown: "npm:^2.0.0"
+  checksum: 10c0/5bda92fc154141705af2b804a534d891f28dac6273186edf1a4c5e3f045d5b01dbcac7400d27aaf91b7e76e8dce007c7b2fdf136c11ea78206ad00bdf9db46bc
+  languageName: node
+  linkType: hard
+
+"mdast-util-phrasing@npm:^4.0.0":
+  version: 4.1.0
+  resolution: "mdast-util-phrasing@npm:4.1.0"
+  dependencies:
+    "@types/mdast": "npm:^4.0.0"
+    unist-util-is: "npm:^6.0.0"
+  checksum: 10c0/bf6c31d51349aa3d74603d5e5a312f59f3f65662ed16c58017169a5fb0f84ca98578f626c5ee9e4aa3e0a81c996db8717096705521bddb4a0185f98c12c9b42f
+  languageName: node
+  linkType: hard
+
+"mdast-util-to-markdown@npm:^2.0.0":
+  version: 2.1.2
+  resolution: "mdast-util-to-markdown@npm:2.1.2"
+  dependencies:
+    "@types/mdast": "npm:^4.0.0"
+    "@types/unist": "npm:^3.0.0"
+    longest-streak: "npm:^3.0.0"
+    mdast-util-phrasing: "npm:^4.0.0"
+    mdast-util-to-string: "npm:^4.0.0"
+    micromark-util-classify-character: "npm:^2.0.0"
+    micromark-util-decode-string: "npm:^2.0.0"
+    unist-util-visit: "npm:^5.0.0"
+    zwitch: "npm:^2.0.0"
+  checksum: 10c0/4649722a6099f12e797bd8d6469b2b43b44e526b5182862d9c7766a3431caad2c0112929c538a972f214e63c015395e5d3f54bd81d9ac1b16e6d8baaf582f749
+  languageName: node
+  linkType: hard
+
+"mdast-util-to-string@npm:^4.0.0":
+  version: 4.0.0
+  resolution: "mdast-util-to-string@npm:4.0.0"
   dependencies:
-    unist-util-visit: "npm:^2.0.0"
-  checksum: 10c0/3d09cd1caedf6b95d0786c1fb1bbc9ef2de729cd9ee1b23119c2bbb03a9d6fcb2ce62ac28a7ca5db7cab25e9d803462ef2a7c4c929ed7798c7a9077699a49384
+    "@types/mdast": "npm:^4.0.0"
+  checksum: 10c0/2d3c1af29bf3fe9c20f552ee9685af308002488f3b04b12fa66652c9718f66f41a32f8362aa2d770c3ff464c034860b41715902ada2306bb0a055146cef064d7
   languageName: node
   linkType: hard
 
@@ -18373,6 +19086,350 @@ __metadata:
   languageName: node
   linkType: hard
 
+"micromark-core-commonmark@npm:^2.0.0":
+  version: 2.0.3
+  resolution: "micromark-core-commonmark@npm:2.0.3"
+  dependencies:
+    decode-named-character-reference: "npm:^1.0.0"
+    devlop: "npm:^1.0.0"
+    micromark-factory-destination: "npm:^2.0.0"
+    micromark-factory-label: "npm:^2.0.0"
+    micromark-factory-space: "npm:^2.0.0"
+    micromark-factory-title: "npm:^2.0.0"
+    micromark-factory-whitespace: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-chunked: "npm:^2.0.0"
+    micromark-util-classify-character: "npm:^2.0.0"
+    micromark-util-html-tag-name: "npm:^2.0.0"
+    micromark-util-normalize-identifier: "npm:^2.0.0"
+    micromark-util-resolve-all: "npm:^2.0.0"
+    micromark-util-subtokenize: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/bd4a794fdc9e88dbdf59eaf1c507ddf26e5f7ddf4e52566c72239c0f1b66adbcd219ba2cd42350debbe24471434d5f5e50099d2b3f4e5762ca222ba8e5b549ee
+  languageName: node
+  linkType: hard
+
+"micromark-extension-mdx-expression@npm:^3.0.0":
+  version: 3.0.1
+  resolution: "micromark-extension-mdx-expression@npm:3.0.1"
+  dependencies:
+    "@types/estree": "npm:^1.0.0"
+    devlop: "npm:^1.0.0"
+    micromark-factory-mdx-expression: "npm:^2.0.0"
+    micromark-factory-space: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-events-to-acorn: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/4d8cc5353b083b06bd51c98389de9c198261a5b2b440b75e85000a18d10511f21ba77538d6dfde0e0589df9de3fba9a1d14c2448d30c92d6b461c26d86e397f4
+  languageName: node
+  linkType: hard
+
+"micromark-extension-mdx-jsx@npm:^3.0.0":
+  version: 3.0.2
+  resolution: "micromark-extension-mdx-jsx@npm:3.0.2"
+  dependencies:
+    "@types/estree": "npm:^1.0.0"
+    devlop: "npm:^1.0.0"
+    estree-util-is-identifier-name: "npm:^3.0.0"
+    micromark-factory-mdx-expression: "npm:^2.0.0"
+    micromark-factory-space: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-events-to-acorn: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/5693b2e51934ac29a6aab521eaa2151f891d1fe092550bbd4ce24e4dd7567c1421a54f5e585a57dfa1769a79570f6df57ddd7a98bf0889dd11d495847a266dd7
+  languageName: node
+  linkType: hard
+
+"micromark-extension-mdx-md@npm:^2.0.0":
+  version: 2.0.0
+  resolution: "micromark-extension-mdx-md@npm:2.0.0"
+  dependencies:
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/bae91c61273de0e5ba80a980c03470e6cd9d7924aa936f46fbda15d780704d9386e945b99eda200e087b96254fbb4271a9545d5ce02676cd6ae67886a8bf82df
+  languageName: node
+  linkType: hard
+
+"micromark-extension-mdxjs-esm@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "micromark-extension-mdxjs-esm@npm:3.0.0"
+  dependencies:
+    "@types/estree": "npm:^1.0.0"
+    devlop: "npm:^1.0.0"
+    micromark-core-commonmark: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-events-to-acorn: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+    unist-util-position-from-estree: "npm:^2.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/13e3f726495a960650cdedcba39198ace5bdc953ccb12c14d71fc9ed9bb88e40cc3ba9231e973f6984da3b3573e7ddb23ce409f7c16f52a8d57b608bf46c748d
+  languageName: node
+  linkType: hard
+
+"micromark-extension-mdxjs@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "micromark-extension-mdxjs@npm:3.0.0"
+  dependencies:
+    acorn: "npm:^8.0.0"
+    acorn-jsx: "npm:^5.0.0"
+    micromark-extension-mdx-expression: "npm:^3.0.0"
+    micromark-extension-mdx-jsx: "npm:^3.0.0"
+    micromark-extension-mdx-md: "npm:^2.0.0"
+    micromark-extension-mdxjs-esm: "npm:^3.0.0"
+    micromark-util-combine-extensions: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/fd84f036ddad0aabbc12e7f1b3e9dcfe31573bbc413c5ae903779ef0366d7a4c08193547e7ba75718c9f45654e45f52e575cfc2f23a5f89205a8a70d9a506aea
+  languageName: node
+  linkType: hard
+
+"micromark-factory-destination@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-factory-destination@npm:2.0.1"
+  dependencies:
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/bbafcf869cee5bf511161354cb87d61c142592fbecea051000ff116068dc85216e6d48519d147890b9ea5d7e2864a6341c0c09d9948c203bff624a80a476023c
+  languageName: node
+  linkType: hard
+
+"micromark-factory-label@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-factory-label@npm:2.0.1"
+  dependencies:
+    devlop: "npm:^1.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/0137716b4ecb428114165505e94a2f18855c8bbea21b07a8b5ce514b32a595ed789d2b967125718fc44c4197ceaa48f6609d58807a68e778138d2e6b91b824e8
+  languageName: node
+  linkType: hard
+
+"micromark-factory-mdx-expression@npm:^2.0.0":
+  version: 2.0.3
+  resolution: "micromark-factory-mdx-expression@npm:2.0.3"
+  dependencies:
+    "@types/estree": "npm:^1.0.0"
+    devlop: "npm:^1.0.0"
+    micromark-factory-space: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-events-to-acorn: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+    unist-util-position-from-estree: "npm:^2.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/a6004ef6272dd01a5d718f2affd7bfb5e08f0849340f5fd96ac823fbc5e9d3b3343acedda50805873ccda5e3b8af4d5fbb302abc874544044ac90c217345cf97
+  languageName: node
+  linkType: hard
+
+"micromark-factory-space@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-factory-space@npm:2.0.1"
+  dependencies:
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/f9ed43f1c0652d8d898de0ac2be3f77f776fffe7dd96bdbba1e02d7ce33d3853c6ff5daa52568fc4fa32cdf3a62d86b85ead9b9189f7211e1d69ff2163c450fb
+  languageName: node
+  linkType: hard
+
+"micromark-factory-title@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-factory-title@npm:2.0.1"
+  dependencies:
+    micromark-factory-space: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/e72fad8d6e88823514916890099a5af20b6a9178ccf78e7e5e05f4de99bb8797acb756257d7a3a57a53854cb0086bf8aab15b1a9e9db8982500dd2c9ff5948b6
+  languageName: node
+  linkType: hard
+
+"micromark-factory-whitespace@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-factory-whitespace@npm:2.0.1"
+  dependencies:
+    micromark-factory-space: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/20a1ec58698f24b766510a309b23a10175034fcf1551eaa9da3adcbed3e00cd53d1ebe5f030cf873f76a1cec3c34eb8c50cc227be3344caa9ed25d56cf611224
+  languageName: node
+  linkType: hard
+
+"micromark-util-character@npm:^2.0.0":
+  version: 2.1.1
+  resolution: "micromark-util-character@npm:2.1.1"
+  dependencies:
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/d3fe7a5e2c4060fc2a076f9ce699c82a2e87190a3946e1e5eea77f563869b504961f5668d9c9c014724db28ac32fa909070ea8b30c3a39bd0483cc6c04cc76a1
+  languageName: node
+  linkType: hard
+
+"micromark-util-chunked@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-chunked@npm:2.0.1"
+  dependencies:
+    micromark-util-symbol: "npm:^2.0.0"
+  checksum: 10c0/b68c0c16fe8106949537bdcfe1be9cf36c0ccd3bc54c4007003cb0984c3750b6cdd0fd77d03f269a3382b85b0de58bde4f6eedbe7ecdf7244759112289b1ab56
+  languageName: node
+  linkType: hard
+
+"micromark-util-classify-character@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-classify-character@npm:2.0.1"
+  dependencies:
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/8a02e59304005c475c332f581697e92e8c585bcd45d5d225a66c1c1b14ab5a8062705188c2ccec33cc998d33502514121478b2091feddbc751887fc9c290ed08
+  languageName: node
+  linkType: hard
+
+"micromark-util-combine-extensions@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-combine-extensions@npm:2.0.1"
+  dependencies:
+    micromark-util-chunked: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/f15e282af24c8372cbb10b9b0b3e2c0aa681fea0ca323a44d6bc537dc1d9382c819c3689f14eaa000118f5a163245358ce6276b2cda9a84439cdb221f5d86ae7
+  languageName: node
+  linkType: hard
+
+"micromark-util-decode-numeric-character-reference@npm:^2.0.0":
+  version: 2.0.2
+  resolution: "micromark-util-decode-numeric-character-reference@npm:2.0.2"
+  dependencies:
+    micromark-util-symbol: "npm:^2.0.0"
+  checksum: 10c0/9c8a9f2c790e5593ffe513901c3a110e9ec8882a08f466da014112a25e5059b51551ca0aeb7ff494657d86eceb2f02ee556c6558b8d66aadc61eae4a240da0df
+  languageName: node
+  linkType: hard
+
+"micromark-util-decode-string@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-decode-string@npm:2.0.1"
+  dependencies:
+    decode-named-character-reference: "npm:^1.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-decode-numeric-character-reference: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+  checksum: 10c0/f24d75b2e5310be6e7b6dee532e0d17d3bf46996841d6295f2a9c87a2046fff4ab603c52ab9d7a7a6430a8b787b1574ae895849c603d262d1b22eef71736b5cb
+  languageName: node
+  linkType: hard
+
+"micromark-util-encode@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-encode@npm:2.0.1"
+  checksum: 10c0/b2b29f901093845da8a1bf997ea8b7f5e061ffdba85070dfe14b0197c48fda64ffcf82bfe53c90cf9dc185e69eef8c5d41cae3ba918b96bc279326921b59008a
+  languageName: node
+  linkType: hard
+
+"micromark-util-events-to-acorn@npm:^2.0.0":
+  version: 2.0.3
+  resolution: "micromark-util-events-to-acorn@npm:2.0.3"
+  dependencies:
+    "@types/estree": "npm:^1.0.0"
+    "@types/unist": "npm:^3.0.0"
+    devlop: "npm:^1.0.0"
+    estree-util-visit: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/a4e0716e943ffdd16a918edf51d4f8291ec2692f5c4d04693dbef3358716fba891f288197afd102c14f4d98dac09d52351046ab7aad1d50b74677bdd5fa683c0
+  languageName: node
+  linkType: hard
+
+"micromark-util-html-tag-name@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-html-tag-name@npm:2.0.1"
+  checksum: 10c0/ae80444db786fde908e9295f19a27a4aa304171852c77414516418650097b8afb401961c9edb09d677b06e97e8370cfa65638dde8438ebd41d60c0a8678b85b9
+  languageName: node
+  linkType: hard
+
+"micromark-util-normalize-identifier@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-normalize-identifier@npm:2.0.1"
+  dependencies:
+    micromark-util-symbol: "npm:^2.0.0"
+  checksum: 10c0/5299265fa360769fc499a89f40142f10a9d4a5c3dd8e6eac8a8ef3c2e4a6570e4c009cf75ea46dce5ee31c01f25587bde2f4a5cc0a935584ae86dd857f2babbd
+  languageName: node
+  linkType: hard
+
+"micromark-util-resolve-all@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-resolve-all@npm:2.0.1"
+  dependencies:
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/bb6ca28764696bb479dc44a2d5b5fe003e7177aeae1d6b0d43f24cc223bab90234092d9c3ce4a4d2b8df095ccfd820537b10eb96bb7044d635f385d65a4c984a
+  languageName: node
+  linkType: hard
+
+"micromark-util-sanitize-uri@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-sanitize-uri@npm:2.0.1"
+  dependencies:
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-encode: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+  checksum: 10c0/60e92166e1870fd4f1961468c2651013ff760617342918e0e0c3c4e872433aa2e60c1e5a672bfe5d89dc98f742d6b33897585cf86ae002cda23e905a3c02527c
+  languageName: node
+  linkType: hard
+
+"micromark-util-subtokenize@npm:^2.0.0":
+  version: 2.1.0
+  resolution: "micromark-util-subtokenize@npm:2.1.0"
+  dependencies:
+    devlop: "npm:^1.0.0"
+    micromark-util-chunked: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/bee69eece4393308e657c293ba80d92ebcb637e5f55e21dcf9c3fa732b91a8eda8ac248d76ff375e675175bfadeae4712e5158ef97eef1111789da1ce7ab5067
+  languageName: node
+  linkType: hard
+
+"micromark-util-symbol@npm:^2.0.0":
+  version: 2.0.1
+  resolution: "micromark-util-symbol@npm:2.0.1"
+  checksum: 10c0/f2d1b207771e573232436618e78c5e46cd4b5c560dd4a6d63863d58018abbf49cb96ec69f7007471e51434c60de3c9268ef2bf46852f26ff4aacd10f9da16fe9
+  languageName: node
+  linkType: hard
+
+"micromark-util-types@npm:^2.0.0":
+  version: 2.0.2
+  resolution: "micromark-util-types@npm:2.0.2"
+  checksum: 10c0/c8c15b96c858db781c4393f55feec10004bf7df95487636c9a9f7209e51002a5cca6a047c5d2a5dc669ff92da20e57aaa881e81a268d9ccadb647f9dce305298
+  languageName: node
+  linkType: hard
+
+"micromark@npm:^4.0.0":
+  version: 4.0.2
+  resolution: "micromark@npm:4.0.2"
+  dependencies:
+    "@types/debug": "npm:^4.0.0"
+    debug: "npm:^4.0.0"
+    decode-named-character-reference: "npm:^1.0.0"
+    devlop: "npm:^1.0.0"
+    micromark-core-commonmark: "npm:^2.0.0"
+    micromark-factory-space: "npm:^2.0.0"
+    micromark-util-character: "npm:^2.0.0"
+    micromark-util-chunked: "npm:^2.0.0"
+    micromark-util-combine-extensions: "npm:^2.0.0"
+    micromark-util-decode-numeric-character-reference: "npm:^2.0.0"
+    micromark-util-encode: "npm:^2.0.0"
+    micromark-util-normalize-identifier: "npm:^2.0.0"
+    micromark-util-resolve-all: "npm:^2.0.0"
+    micromark-util-sanitize-uri: "npm:^2.0.0"
+    micromark-util-subtokenize: "npm:^2.0.0"
+    micromark-util-symbol: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+  checksum: 10c0/07462287254219d6eda6eac8a3cebaff2994e0575499e7088027b825105e096e4f51e466b14b2a81b71933a3b6c48ee069049d87bc2c2127eee50d9cc69e8af6
+  languageName: node
+  linkType: hard
+
 "micromatch@npm:4.0.5":
   version: 4.0.5
   resolution: "micromatch@npm:4.0.5"
@@ -18509,6 +19566,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"minimatch@npm:^10.2.2":
+  version: 10.2.4
+  resolution: "minimatch@npm:10.2.4"
+  dependencies:
+    brace-expansion: "npm:^5.0.2"
+  checksum: 10c0/35f3dfb7b99b51efd46afd378486889f590e7efb10e0f6a10ba6800428cf65c9a8dedb74427d0570b318d749b543dc4e85f06d46d2858bc8cac7e1eb49a95945
+  languageName: node
+  linkType: hard
+
 "minimatch@npm:^3.0.4, minimatch@npm:^3.0.5, minimatch@npm:^3.1.1, minimatch@npm:^3.1.2":
   version: 3.1.2
   resolution: "minimatch@npm:3.1.2"
@@ -18859,13 +19925,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"natural-compare-lite@npm:^1.4.0":
-  version: 1.4.0
-  resolution: "natural-compare-lite@npm:1.4.0"
-  checksum: 10c0/f6cef26f5044515754802c0fc475d81426f3b90fe88c20fabe08771ce1f736ce46e0397c10acb569a4dd0acb84c7f1ee70676122f95d5bfdd747af3a6c6bbaa8
-  languageName: node
-  linkType: hard
-
 "natural-compare@npm:^1.4.0":
   version: 1.4.0
   resolution: "natural-compare@npm:1.4.0"
@@ -19085,6 +20144,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"nopt@npm:^7.2.1":
+  version: 7.2.1
+  resolution: "nopt@npm:7.2.1"
+  dependencies:
+    abbrev: "npm:^2.0.0"
+  bin:
+    nopt: bin/nopt.js
+  checksum: 10c0/a069c7c736767121242037a22a788863accfa932ab285a1eb569eb8cd534b09d17206f68c37f096ae785647435e0c5a5a0a67b42ec743e481a455e5ae6a6df81
+  languageName: node
+  linkType: hard
+
 "nopt@npm:^9.0.0":
   version: 9.0.0
   resolution: "nopt@npm:9.0.0"
@@ -19132,6 +20202,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"normalize-package-data@npm:^6.0.0":
+  version: 6.0.2
+  resolution: "normalize-package-data@npm:6.0.2"
+  dependencies:
+    hosted-git-info: "npm:^7.0.0"
+    semver: "npm:^7.3.5"
+    validate-npm-package-license: "npm:^3.0.4"
+  checksum: 10c0/7e32174e7f5575ede6d3d449593247183880122b4967d4ae6edb28cea5769ca025defda54fc91ec0e3c972fdb5ab11f9284606ba278826171b264cb16a9311ef
+  languageName: node
+  linkType: hard
+
 "normalize-path@npm:^3.0.0, normalize-path@npm:~3.0.0":
   version: 3.0.0
   resolution: "normalize-path@npm:3.0.0"
@@ -19229,6 +20310,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"npm-package-arg@npm:^11.0.0":
+  version: 11.0.3
+  resolution: "npm-package-arg@npm:11.0.3"
+  dependencies:
+    hosted-git-info: "npm:^7.0.0"
+    proc-log: "npm:^4.0.0"
+    semver: "npm:^7.3.5"
+    validate-npm-package-name: "npm:^5.0.0"
+  checksum: 10c0/e18333485e05c3a8774f4b5701ef74f4799533e650b70a68ca8dd697666c9a8d46932cb765fc593edce299521033bd4025a40323d5240cea8a393c784c0c285a
+  languageName: node
+  linkType: hard
+
 "npm-packlist@npm:5.1.1":
   version: 5.1.1
   resolution: "npm-packlist@npm:5.1.1"
@@ -19264,6 +20357,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"npm-pick-manifest@npm:^9.0.0":
+  version: 9.1.0
+  resolution: "npm-pick-manifest@npm:9.1.0"
+  dependencies:
+    npm-install-checks: "npm:^6.0.0"
+    npm-normalize-package-bin: "npm:^3.0.0"
+    npm-package-arg: "npm:^11.0.0"
+    semver: "npm:^7.3.5"
+  checksum: 10c0/8765f4199755b381323da2bff2202b4b15b59f59dba0d1be3f2f793b591321cd19e1b5a686ef48d9753a6bd4868550da632541a45dfb61809d55664222d73e44
+  languageName: node
+  linkType: hard
+
 "npm-registry-fetch@npm:^14.0.0, npm-registry-fetch@npm:^14.0.3, npm-registry-fetch@npm:^14.0.5":
   version: 14.0.5
   resolution: "npm-registry-fetch@npm:14.0.5"
@@ -19538,6 +20643,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"object-inspect@npm:^1.13.3, object-inspect@npm:^1.13.4":
+  version: 1.13.4
+  resolution: "object-inspect@npm:1.13.4"
+  checksum: 10c0/d7f8711e803b96ea3191c745d6f8056ce1f2496e530e6a19a0e92d89b0fa3c76d910c31f0aa270432db6bd3b2f85500a376a83aaba849a8d518c8845b3211692
+  languageName: node
+  linkType: hard
+
 "object-keys@npm:^1.1.1":
   version: 1.1.1
   resolution: "object-keys@npm:1.1.1"
@@ -19545,7 +20657,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object.assign@npm:^4.1.2, object.assign@npm:^4.1.4, object.assign@npm:^4.1.5":
+"object.assign@npm:^4.1.4, object.assign@npm:^4.1.5":
   version: 4.1.5
   resolution: "object.assign@npm:4.1.5"
   dependencies:
@@ -19557,14 +20669,29 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object.entries@npm:^1.1.2, object.entries@npm:^1.1.8":
-  version: 1.1.8
-  resolution: "object.entries@npm:1.1.8"
+"object.assign@npm:^4.1.7":
+  version: 4.1.7
+  resolution: "object.assign@npm:4.1.7"
   dependencies:
-    call-bind: "npm:^1.0.7"
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.3"
     define-properties: "npm:^1.2.1"
     es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/db9ea979d2956a3bc26c262da4a4d212d36f374652cc4c13efdd069c1a519c16571c137e2893d1c46e1cb0e15c88fd6419eaf410c945f329f09835487d7e65d3
+    has-symbols: "npm:^1.1.0"
+    object-keys: "npm:^1.1.1"
+  checksum: 10c0/3b2732bd860567ea2579d1567525168de925a8d852638612846bd8082b3a1602b7b89b67b09913cbb5b9bd6e95923b2ae73580baa9d99cb4e990564e8cbf5ddc
+  languageName: node
+  linkType: hard
+
+"object.entries@npm:^1.1.9":
+  version: 1.1.9
+  resolution: "object.entries@npm:1.1.9"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.4"
+    define-properties: "npm:^1.2.1"
+    es-object-atoms: "npm:^1.1.1"
+  checksum: 10c0/d4b8c1e586650407da03370845f029aa14076caca4e4d4afadbc69cfb5b78035fd3ee7be417141abdb0258fa142e59b11923b4c44d8b1255b28f5ffcc50da7db
   languageName: node
   linkType: hard
 
@@ -19617,6 +20744,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"object.values@npm:^1.2.1":
+  version: 1.2.1
+  resolution: "object.values@npm:1.2.1"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.3"
+    define-properties: "npm:^1.2.1"
+    es-object-atoms: "npm:^1.0.0"
+  checksum: 10c0/3c47814fdc64842ae3d5a74bc9d06bdd8d21563c04d9939bf6716a9c00596a4ebc342552f8934013d1ec991c74e3671b26710a0c51815f0b603795605ab6b2c9
+  languageName: node
+  linkType: hard
+
 "objectorarray@npm:^1.0.5":
   version: 1.0.5
   resolution: "objectorarray@npm:1.0.5"
@@ -19777,6 +20916,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"own-keys@npm:^1.0.1":
+  version: 1.0.1
+  resolution: "own-keys@npm:1.0.1"
+  dependencies:
+    get-intrinsic: "npm:^1.2.6"
+    object-keys: "npm:^1.1.1"
+    safe-push-apply: "npm:^1.0.0"
+  checksum: 10c0/6dfeb3455bff92ec3f16a982d4e3e65676345f6902d9f5ded1d8265a6318d0200ce461956d6d1c70053c7fe9f9fe65e552faac03f8140d37ef0fdd108e67013a
+  languageName: node
+  linkType: hard
+
 "p-event@npm:^4.1.0":
   version: 4.2.0
   resolution: "p-event@npm:4.2.0"
@@ -20027,17 +21177,18 @@ __metadata:
   languageName: node
   linkType: hard
 
-"parse-entities@npm:^2.0.0":
-  version: 2.0.0
-  resolution: "parse-entities@npm:2.0.0"
+"parse-entities@npm:^4.0.0":
+  version: 4.0.2
+  resolution: "parse-entities@npm:4.0.2"
   dependencies:
-    character-entities: "npm:^1.0.0"
-    character-entities-legacy: "npm:^1.0.0"
-    character-reference-invalid: "npm:^1.0.0"
-    is-alphanumerical: "npm:^1.0.0"
-    is-decimal: "npm:^1.0.0"
-    is-hexadecimal: "npm:^1.0.0"
-  checksum: 10c0/f85a22c0ea406ff26b53fdc28641f01cc36fa49eb2e3135f02693286c89ef0bcefc2262d99b3688e20aac2a14fd10b75c518583e875c1b9fe3d1f937795e0854
+    "@types/unist": "npm:^2.0.0"
+    character-entities-legacy: "npm:^3.0.0"
+    character-reference-invalid: "npm:^2.0.0"
+    decode-named-character-reference: "npm:^1.0.0"
+    is-alphanumerical: "npm:^2.0.0"
+    is-decimal: "npm:^2.0.0"
+    is-hexadecimal: "npm:^2.0.0"
+  checksum: 10c0/a13906b1151750b78ed83d386294066daf5fb559e08c5af9591b2d98cc209123103016a01df776f65f8219ad26652d6d6b210d0974d452049cddfc53a8916c34
   languageName: node
   linkType: hard
 
@@ -20063,6 +21214,19 @@ __metadata:
   languageName: node
   linkType: hard
 
+"parse-json@npm:^7.0.0":
+  version: 7.1.1
+  resolution: "parse-json@npm:7.1.1"
+  dependencies:
+    "@babel/code-frame": "npm:^7.21.4"
+    error-ex: "npm:^1.3.2"
+    json-parse-even-better-errors: "npm:^3.0.0"
+    lines-and-columns: "npm:^2.0.3"
+    type-fest: "npm:^3.8.0"
+  checksum: 10c0/a85ebc7430af7763fa52eb456d7efd35c35be5b06f04d8d80c37d0d33312ac6cdff12647acb9c95448dcc8b907dfafa81fb126e094aa132b0abc2a71b9df51d5
+  languageName: node
+  linkType: hard
+
 "parse-node-version@npm:^1.0.1":
   version: 1.0.1
   resolution: "parse-node-version@npm:1.0.1"
@@ -20248,6 +21412,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"picomatch@npm:^4.0.3":
+  version: 4.0.4
+  resolution: "picomatch@npm:4.0.4"
+  checksum: 10c0/e2c6023372cc7b5764719a5ffb9da0f8e781212fa7ca4bd0562db929df8e117460f00dff3cb7509dacfc06b86de924b247f504d0ce1806a37fac4633081466b0
+  languageName: node
+  linkType: hard
+
 "pidtree@npm:0.6.0":
   version: 0.6.0
   resolution: "pidtree@npm:0.6.0"
@@ -21173,6 +22344,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"proc-log@npm:^4.0.0, proc-log@npm:^4.2.0":
+  version: 4.2.0
+  resolution: "proc-log@npm:4.2.0"
+  checksum: 10c0/17db4757c2a5c44c1e545170e6c70a26f7de58feb985091fb1763f5081cab3d01b181fb2dd240c9f4a4255a1d9227d163d5771b7e69c9e49a561692db865efb9
+  languageName: node
+  linkType: hard
+
 "proc-log@npm:^6.0.0":
   version: 6.1.0
   resolution: "proc-log@npm:6.1.0"
@@ -22055,18 +23233,19 @@ __metadata:
   languageName: node
   linkType: hard
 
-"reflect.getprototypeof@npm:^1.0.4":
-  version: 1.0.6
-  resolution: "reflect.getprototypeof@npm:1.0.6"
+"reflect.getprototypeof@npm:^1.0.6, reflect.getprototypeof@npm:^1.0.9":
+  version: 1.0.10
+  resolution: "reflect.getprototypeof@npm:1.0.10"
   dependencies:
-    call-bind: "npm:^1.0.7"
+    call-bind: "npm:^1.0.8"
     define-properties: "npm:^1.2.1"
-    es-abstract: "npm:^1.23.1"
+    es-abstract: "npm:^1.23.9"
     es-errors: "npm:^1.3.0"
-    get-intrinsic: "npm:^1.2.4"
-    globalthis: "npm:^1.0.3"
-    which-builtin-type: "npm:^1.1.3"
-  checksum: 10c0/baf4ef8ee6ff341600f4720b251cf5a6cb552d6a6ab0fdc036988c451bf16f920e5feb0d46bd4f530a5cce568f1f7aca2d77447ca798920749cfc52783c39b55
+    es-object-atoms: "npm:^1.0.0"
+    get-intrinsic: "npm:^1.2.7"
+    get-proto: "npm:^1.0.1"
+    which-builtin-type: "npm:^1.2.1"
+  checksum: 10c0/7facec28c8008876f8ab98e80b7b9cb4b1e9224353fd4756dda5f2a4ab0d30fa0a5074777c6df24e1e0af463a2697513b0a11e548d99cf52f21f7bc6ba48d3ac
   languageName: node
   linkType: hard
 
@@ -22107,6 +23286,20 @@ __metadata:
   languageName: node
   linkType: hard
 
+"regexp.prototype.flags@npm:^1.5.3, regexp.prototype.flags@npm:^1.5.4":
+  version: 1.5.4
+  resolution: "regexp.prototype.flags@npm:1.5.4"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    define-properties: "npm:^1.2.1"
+    es-errors: "npm:^1.3.0"
+    get-proto: "npm:^1.0.1"
+    gopd: "npm:^1.2.0"
+    set-function-name: "npm:^2.0.2"
+  checksum: 10c0/83b88e6115b4af1c537f8dabf5c3744032cb875d63bc05c288b1b8c0ef37cbe55353f95d8ca817e8843806e3e150b118bc624e4279b24b4776b4198232735a77
+  languageName: node
+  linkType: hard
+
 "regexpu-core@npm:^6.1.1":
   version: 6.1.1
   resolution: "regexpu-core@npm:6.1.1"
@@ -22146,65 +23339,36 @@ __metadata:
   languageName: node
   linkType: hard
 
-"remark-mdx@npm:^1.6.22":
-  version: 1.6.22
-  resolution: "remark-mdx@npm:1.6.22"
+"remark-mdx@npm:^3.1.0":
+  version: 3.1.1
+  resolution: "remark-mdx@npm:3.1.1"
   dependencies:
-    "@babel/core": "npm:7.12.9"
-    "@babel/helper-plugin-utils": "npm:7.10.4"
-    "@babel/plugin-proposal-object-rest-spread": "npm:7.12.1"
-    "@babel/plugin-syntax-jsx": "npm:7.12.1"
-    "@mdx-js/util": "npm:1.6.22"
-    is-alphabetical: "npm:1.0.4"
-    remark-parse: "npm:8.0.3"
-    unified: "npm:9.2.0"
-  checksum: 10c0/3a964048e58cba7848d59fc920baa330a9b7f619fedb44d4d7985d84875eba8d92e0d0dd0617e28326c6086e21ef441664748526a2517a42555d44c648453b0a
+    mdast-util-mdx: "npm:^3.0.0"
+    micromark-extension-mdxjs: "npm:^3.0.0"
+  checksum: 10c0/3e5585d4c2448d8ac7548b1d148f04b89251ff47fbfc80be1428cecec2fc2530abe30a5da53bb031283f8a78933259df6120c1cd4cc7cc1d43978d508798ba88
   languageName: node
   linkType: hard
 
-"remark-parse@npm:8.0.3, remark-parse@npm:^8.0.3":
-  version: 8.0.3
-  resolution: "remark-parse@npm:8.0.3"
-  dependencies:
-    ccount: "npm:^1.0.0"
-    collapse-white-space: "npm:^1.0.2"
-    is-alphabetical: "npm:^1.0.0"
-    is-decimal: "npm:^1.0.0"
-    is-whitespace-character: "npm:^1.0.0"
-    is-word-character: "npm:^1.0.0"
-    markdown-escapes: "npm:^1.0.0"
-    parse-entities: "npm:^2.0.0"
-    repeat-string: "npm:^1.5.4"
-    state-toggle: "npm:^1.0.0"
-    trim: "npm:0.0.1"
-    trim-trailing-lines: "npm:^1.0.0"
-    unherit: "npm:^1.0.4"
-    unist-util-remove-position: "npm:^2.0.0"
-    vfile-location: "npm:^3.0.0"
-    xtend: "npm:^4.0.1"
-  checksum: 10c0/cbb859e2585864942823ce4d23a1b1514168a066ba91d47ca09ff45a5563b81bf17160c182ac7efed718712291c35a117db89b6ce603d04a845497ae7041c185
-  languageName: node
-  linkType: hard
-
-"remark-stringify@npm:^8.1.1":
-  version: 8.1.1
-  resolution: "remark-stringify@npm:8.1.1"
-  dependencies:
-    ccount: "npm:^1.0.0"
-    is-alphanumeric: "npm:^1.0.0"
-    is-decimal: "npm:^1.0.0"
-    is-whitespace-character: "npm:^1.0.0"
-    longest-streak: "npm:^2.0.1"
-    markdown-escapes: "npm:^1.0.0"
-    markdown-table: "npm:^2.0.0"
-    mdast-util-compact: "npm:^2.0.0"
-    parse-entities: "npm:^2.0.0"
-    repeat-string: "npm:^1.5.4"
-    state-toggle: "npm:^1.0.0"
-    stringify-entities: "npm:^3.0.0"
-    unherit: "npm:^1.0.4"
-    xtend: "npm:^4.0.1"
-  checksum: 10c0/1e63c6d0922355612bef51ffaf952767bc1d8816a8d8faa30cf18bf8b67efec772426c6103e5232f1fab758fba3e01074a38ac32f8c0c1dbb3de13b10da0b9c1
+"remark-parse@npm:^11.0.0":
+  version: 11.0.0
+  resolution: "remark-parse@npm:11.0.0"
+  dependencies:
+    "@types/mdast": "npm:^4.0.0"
+    mdast-util-from-markdown: "npm:^2.0.0"
+    micromark-util-types: "npm:^2.0.0"
+    unified: "npm:^11.0.0"
+  checksum: 10c0/6eed15ddb8680eca93e04fcb2d1b8db65a743dcc0023f5007265dda558b09db595a087f622062ccad2630953cd5cddc1055ce491d25a81f3317c858348a8dd38
+  languageName: node
+  linkType: hard
+
+"remark-stringify@npm:^11.0.0":
+  version: 11.0.0
+  resolution: "remark-stringify@npm:11.0.0"
+  dependencies:
+    "@types/mdast": "npm:^4.0.0"
+    mdast-util-to-markdown: "npm:^2.0.0"
+    unified: "npm:^11.0.0"
+  checksum: 10c0/0cdb37ce1217578f6f847c7ec9f50cbab35df5b9e3903d543e74b405404e67c07defcb23cd260a567b41b769400f6de03c2c3d9cd6ae7a6707d5c8d89ead489f
   languageName: node
   linkType: hard
 
@@ -22221,13 +23385,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"repeat-string@npm:^1.0.0, repeat-string@npm:^1.5.4":
-  version: 1.6.1
-  resolution: "repeat-string@npm:1.6.1"
-  checksum: 10c0/87fa21bfdb2fbdedc44b9a5b118b7c1239bdd2c2c1e42742ef9119b7d412a5137a1d23f1a83dc6bb686f4f27429ac6f542e3d923090b44181bafa41e8ac0174d
-  languageName: node
-  linkType: hard
-
 "require-directory@npm:^2.1.1":
   version: 2.1.1
   resolution: "require-directory@npm:2.1.1"
@@ -22309,7 +23466,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"resolve@npm:^1.1.7, resolve@npm:^1.10.0, resolve@npm:^1.14.2, resolve@npm:^1.19.0, resolve@npm:^1.20.0, resolve@npm:^1.22.1, resolve@npm:^1.22.4, resolve@npm:^1.22.8, resolve@npm:^1.3.2":
+"resolve@npm:^1.1.7, resolve@npm:^1.10.0, resolve@npm:^1.14.2, resolve@npm:^1.19.0, resolve@npm:^1.20.0, resolve@npm:^1.22.1, resolve@npm:^1.22.4, resolve@npm:^1.22.8":
   version: 1.22.10
   resolution: "resolve@npm:1.22.10"
   dependencies:
@@ -22348,7 +23505,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"resolve@patch:resolve@npm%3A^1.1.7#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.10.0#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.14.2#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.19.0#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.20.0#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.22.1#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.22.4#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.22.8#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.3.2#optional!builtin<compat/resolve>":
+"resolve@patch:resolve@npm%3A^1.1.7#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.10.0#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.14.2#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.19.0#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.20.0#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.22.1#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.22.4#optional!builtin<compat/resolve>, resolve@patch:resolve@npm%3A^1.22.8#optional!builtin<compat/resolve>":
   version: 1.22.10
   resolution: "resolve@patch:resolve@npm%3A1.22.10#optional!builtin<compat/resolve>::version=1.22.10&hash=c3c19d"
   dependencies:
@@ -22640,6 +23797,19 @@ __metadata:
   languageName: node
   linkType: hard
 
+"safe-array-concat@npm:^1.1.3":
+  version: 1.1.3
+  resolution: "safe-array-concat@npm:1.1.3"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.2"
+    get-intrinsic: "npm:^1.2.6"
+    has-symbols: "npm:^1.1.0"
+    isarray: "npm:^2.0.5"
+  checksum: 10c0/43c86ffdddc461fb17ff8a17c5324f392f4868f3c7dd2c6a5d9f5971713bc5fd755667212c80eab9567595f9a7509cc2f83e590ddaebd1bd19b780f9c79f9a8d
+  languageName: node
+  linkType: hard
+
 "safe-buffer@npm:5.1.2, safe-buffer@npm:~5.1.0, safe-buffer@npm:~5.1.1":
   version: 5.1.2
   resolution: "safe-buffer@npm:5.1.2"
@@ -22661,6 +23831,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"safe-push-apply@npm:^1.0.0":
+  version: 1.0.0
+  resolution: "safe-push-apply@npm:1.0.0"
+  dependencies:
+    es-errors: "npm:^1.3.0"
+    isarray: "npm:^2.0.5"
+  checksum: 10c0/831f1c9aae7436429e7862c7e46f847dfe490afac20d0ee61bae06108dbf5c745a0de3568ada30ccdd3eeb0864ca8331b2eef703abd69bfea0745b21fd320750
+  languageName: node
+  linkType: hard
+
 "safe-regex-test@npm:^1.0.3":
   version: 1.0.3
   resolution: "safe-regex-test@npm:1.0.3"
@@ -22672,6 +23852,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"safe-regex-test@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "safe-regex-test@npm:1.1.0"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    es-errors: "npm:^1.3.0"
+    is-regex: "npm:^1.2.1"
+  checksum: 10c0/f2c25281bbe5d39cddbbce7f86fca5ea9b3ce3354ea6cd7c81c31b006a5a9fff4286acc5450a3b9122c56c33eba69c56b9131ad751457b2b4a585825e6a10665
+  languageName: node
+  linkType: hard
+
 "safer-buffer@npm:>= 2.1.2 < 3, safer-buffer@npm:>= 2.1.2 < 3.0.0":
   version: 2.1.2
   resolution: "safer-buffer@npm:2.1.2"
@@ -23034,7 +24225,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"semver@npm:2 || 3 || 4 || 5, semver@npm:^5.4.1, semver@npm:^5.6.0":
+"semver@npm:2 || 3 || 4 || 5, semver@npm:^5.6.0":
   version: 5.7.2
   resolution: "semver@npm:5.7.2"
   bin:
@@ -23092,6 +24283,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"semver@npm:^7.7.3":
+  version: 7.7.4
+  resolution: "semver@npm:7.7.4"
+  bin:
+    semver: bin/semver.js
+  checksum: 10c0/5215ad0234e2845d4ea5bb9d836d42b03499546ddafb12075566899fc617f68794bb6f146076b6881d755de17d6c6cc73372555879ec7dce2c2feee947866ad2
+  languageName: node
+  linkType: hard
+
 "send@npm:0.19.0":
   version: 0.19.0
   resolution: "send@npm:0.19.0"
@@ -23156,7 +24356,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"set-function-length@npm:^1.2.1":
+"set-function-length@npm:^1.2.1, set-function-length@npm:^1.2.2":
   version: 1.2.2
   resolution: "set-function-length@npm:1.2.2"
   dependencies:
@@ -23170,7 +24370,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"set-function-name@npm:^2.0.1, set-function-name@npm:^2.0.2":
+"set-function-name@npm:^2.0.2":
   version: 2.0.2
   resolution: "set-function-name@npm:2.0.2"
   dependencies:
@@ -23189,6 +24389,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"set-proto@npm:^1.0.0":
+  version: 1.0.0
+  resolution: "set-proto@npm:1.0.0"
+  dependencies:
+    dunder-proto: "npm:^1.0.1"
+    es-errors: "npm:^1.3.0"
+    es-object-atoms: "npm:^1.0.0"
+  checksum: 10c0/ca5c3ccbba479d07c30460e367e66337cec825560b11e8ba9c5ebe13a2a0d6021ae34eddf94ff3dfe17a3104dc1f191519cb6c48378b503e5c3f36393938776a
+  languageName: node
+  linkType: hard
+
 "setprototypeof@npm:1.1.0":
   version: 1.1.0
   resolution: "setprototypeof@npm:1.1.0"
@@ -23242,6 +24453,41 @@ __metadata:
   languageName: node
   linkType: hard
 
+"side-channel-list@npm:^1.0.0":
+  version: 1.0.0
+  resolution: "side-channel-list@npm:1.0.0"
+  dependencies:
+    es-errors: "npm:^1.3.0"
+    object-inspect: "npm:^1.13.3"
+  checksum: 10c0/644f4ac893456c9490ff388bf78aea9d333d5e5bfc64cfb84be8f04bf31ddc111a8d4b83b85d7e7e8a7b845bc185a9ad02c052d20e086983cf59f0be517d9b3d
+  languageName: node
+  linkType: hard
+
+"side-channel-map@npm:^1.0.1":
+  version: 1.0.1
+  resolution: "side-channel-map@npm:1.0.1"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    es-errors: "npm:^1.3.0"
+    get-intrinsic: "npm:^1.2.5"
+    object-inspect: "npm:^1.13.3"
+  checksum: 10c0/010584e6444dd8a20b85bc926d934424bd809e1a3af941cace229f7fdcb751aada0fb7164f60c2e22292b7fa3c0ff0bce237081fd4cdbc80de1dc68e95430672
+  languageName: node
+  linkType: hard
+
+"side-channel-weakmap@npm:^1.0.2":
+  version: 1.0.2
+  resolution: "side-channel-weakmap@npm:1.0.2"
+  dependencies:
+    call-bound: "npm:^1.0.2"
+    es-errors: "npm:^1.3.0"
+    get-intrinsic: "npm:^1.2.5"
+    object-inspect: "npm:^1.13.3"
+    side-channel-map: "npm:^1.0.1"
+  checksum: 10c0/71362709ac233e08807ccd980101c3e2d7efe849edc51455030327b059f6c4d292c237f94dc0685031dd11c07dd17a68afde235d6cf2102d949567f98ab58185
+  languageName: node
+  linkType: hard
+
 "side-channel@npm:^1.0.4, side-channel@npm:^1.0.6":
   version: 1.0.6
   resolution: "side-channel@npm:1.0.6"
@@ -23254,6 +24500,19 @@ __metadata:
   languageName: node
   linkType: hard
 
+"side-channel@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "side-channel@npm:1.1.0"
+  dependencies:
+    es-errors: "npm:^1.3.0"
+    object-inspect: "npm:^1.13.3"
+    side-channel-list: "npm:^1.0.0"
+    side-channel-map: "npm:^1.0.1"
+    side-channel-weakmap: "npm:^1.0.2"
+  checksum: 10c0/cb20dad41eb032e6c24c0982e1e5a24963a28aa6122b4f05b3f3d6bf8ae7fd5474ef382c8f54a6a3ab86e0cac4d41a23bd64ede3970e5bfb50326ba02a7996e6
+  languageName: node
+  linkType: hard
+
 "signal-exit@npm:3.0.7, signal-exit@npm:^3.0.2, signal-exit@npm:^3.0.3, signal-exit@npm:^3.0.7":
   version: 3.0.7
   resolution: "signal-exit@npm:3.0.7"
@@ -23453,7 +24712,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"source-map@npm:^0.5.0, source-map@npm:^0.5.7":
+"source-map@npm:^0.5.7":
   version: 0.5.7
   resolution: "source-map@npm:0.5.7"
   checksum: 10c0/904e767bb9c494929be013017380cbba013637da1b28e5943b566031e29df04fba57edf3f093e0914be094648b577372bd8ad247fa98cfba9c600794cd16b599
@@ -23649,13 +24908,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"state-toggle@npm:^1.0.0":
-  version: 1.0.3
-  resolution: "state-toggle@npm:1.0.3"
-  checksum: 10c0/6051ee5654b39b0006911ae3130fa7f47675e07db16a711d8cd23d43b63f383e98f3bd9fa80e118a3f5964a11284d8eee180baef27a556146e628f8da74aba12
-  languageName: node
-  linkType: hard
-
 "statuses@npm:2.0.1":
   version: 2.0.1
   resolution: "statuses@npm:2.0.1"
@@ -23677,6 +24929,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"stop-iteration-iterator@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "stop-iteration-iterator@npm:1.1.0"
+  dependencies:
+    es-errors: "npm:^1.3.0"
+    internal-slot: "npm:^1.1.0"
+  checksum: 10c0/de4e45706bb4c0354a4b1122a2b8cc45a639e86206807ce0baf390ee9218d3ef181923fa4d2b67443367c491aa255c5fbaa64bb74648e3c5b48299928af86c09
+  languageName: node
+  linkType: hard
+
 "storybook-addon-deep-controls@npm:^0.9.5":
   version: 0.9.5
   resolution: "storybook-addon-deep-controls@npm:0.9.5"
@@ -23761,6 +25023,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"string-width@npm:^6.0.0":
+  version: 6.1.0
+  resolution: "string-width@npm:6.1.0"
+  dependencies:
+    eastasianwidth: "npm:^0.2.0"
+    emoji-regex: "npm:^10.2.1"
+    strip-ansi: "npm:^7.0.1"
+  checksum: 10c0/7b2991ea7c946a43042070787b85af454079116dfd6d853aab4ff8a6d4ac717cdc18656cfee15b7a7a78286669202a4a56385728f0740cb1e15001c71807b361
+  languageName: node
+  linkType: hard
+
 "string.prototype.includes@npm:^2.0.1":
   version: 2.0.1
   resolution: "string.prototype.includes@npm:2.0.1"
@@ -23772,23 +25045,24 @@ __metadata:
   languageName: node
   linkType: hard
 
-"string.prototype.matchall@npm:^4.0.11":
-  version: 4.0.11
-  resolution: "string.prototype.matchall@npm:4.0.11"
+"string.prototype.matchall@npm:^4.0.12":
+  version: 4.0.12
+  resolution: "string.prototype.matchall@npm:4.0.12"
   dependencies:
-    call-bind: "npm:^1.0.7"
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.3"
     define-properties: "npm:^1.2.1"
-    es-abstract: "npm:^1.23.2"
+    es-abstract: "npm:^1.23.6"
     es-errors: "npm:^1.3.0"
     es-object-atoms: "npm:^1.0.0"
-    get-intrinsic: "npm:^1.2.4"
-    gopd: "npm:^1.0.1"
-    has-symbols: "npm:^1.0.3"
-    internal-slot: "npm:^1.0.7"
-    regexp.prototype.flags: "npm:^1.5.2"
+    get-intrinsic: "npm:^1.2.6"
+    gopd: "npm:^1.2.0"
+    has-symbols: "npm:^1.1.0"
+    internal-slot: "npm:^1.1.0"
+    regexp.prototype.flags: "npm:^1.5.3"
     set-function-name: "npm:^2.0.2"
-    side-channel: "npm:^1.0.6"
-  checksum: 10c0/915a2562ac9ab5e01b7be6fd8baa0b2b233a0a9aa975fcb2ec13cc26f08fb9a3e85d5abdaa533c99c6fc4c5b65b914eba3d80c4aff9792a4c9fed403f28f7d9d
+    side-channel: "npm:^1.1.0"
+  checksum: 10c0/1a53328ada73f4a77f1fdf1c79414700cf718d0a8ef6672af5603e709d26a24f2181208144aed7e858b1bcc1a0d08567a570abfb45567db4ae47637ed2c2f85c
   languageName: node
   linkType: hard
 
@@ -23802,6 +25076,21 @@ __metadata:
   languageName: node
   linkType: hard
 
+"string.prototype.trim@npm:^1.2.10":
+  version: 1.2.10
+  resolution: "string.prototype.trim@npm:1.2.10"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.2"
+    define-data-property: "npm:^1.1.4"
+    define-properties: "npm:^1.2.1"
+    es-abstract: "npm:^1.23.5"
+    es-object-atoms: "npm:^1.0.0"
+    has-property-descriptors: "npm:^1.0.2"
+  checksum: 10c0/8a8854241c4b54a948e992eb7dd6b8b3a97185112deb0037a134f5ba57541d8248dd610c966311887b6c2fd1181a3877bffb14d873ce937a344535dabcc648f8
+  languageName: node
+  linkType: hard
+
 "string.prototype.trim@npm:^1.2.9":
   version: 1.2.9
   resolution: "string.prototype.trim@npm:1.2.9"
@@ -23825,6 +25114,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"string.prototype.trimend@npm:^1.0.9":
+  version: 1.0.9
+  resolution: "string.prototype.trimend@npm:1.0.9"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.2"
+    define-properties: "npm:^1.2.1"
+    es-object-atoms: "npm:^1.0.0"
+  checksum: 10c0/59e1a70bf9414cb4c536a6e31bef5553c8ceb0cf44d8b4d0ed65c9653358d1c64dd0ec203b100df83d0413bbcde38b8c5d49e14bc4b86737d74adc593a0d35b6
+  languageName: node
+  linkType: hard
+
 "string.prototype.trimstart@npm:^1.0.8":
   version: 1.0.8
   resolution: "string.prototype.trimstart@npm:1.0.8"
@@ -23854,14 +25155,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"stringify-entities@npm:^3.0.0":
-  version: 3.1.0
-  resolution: "stringify-entities@npm:3.1.0"
+"stringify-entities@npm:^4.0.0":
+  version: 4.0.4
+  resolution: "stringify-entities@npm:4.0.4"
   dependencies:
-    character-entities-html4: "npm:^1.0.0"
-    character-entities-legacy: "npm:^1.0.0"
-    xtend: "npm:^4.0.0"
-  checksum: 10c0/60d31e705285b614d1912cc40ba54146ada408ed42091ac04c2554ecb93819dee0165787172009f20dbb14f0bcfa84fbbb3f1bef11935a60afbbbb9cf7fe6c87
+    character-entities-html4: "npm:^2.0.0"
+    character-entities-legacy: "npm:^3.0.0"
+  checksum: 10c0/537c7e656354192406bdd08157d759cd615724e9d0873602d2c9b2f6a5c0a8d0b1d73a0a08677848105c5eebac6db037b57c0b3a4ec86331117fa7319ed50448
   languageName: node
   linkType: hard
 
@@ -24048,6 +25348,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"supports-color@npm:^9.0.0":
+  version: 9.4.0
+  resolution: "supports-color@npm:9.4.0"
+  checksum: 10c0/6c24e6b2b64c6a60e5248490cfa50de5924da32cf09ae357ad8ebbf305cc5d2717ba705a9d4cb397d80bbf39417e8fdc8d7a0ce18bd0041bf7b5b456229164e4
+  languageName: node
+  linkType: hard
+
 "supports-preserve-symlinks-flag@npm:^1.0.0":
   version: 1.0.0
   resolution: "supports-preserve-symlinks-flag@npm:1.0.0"
@@ -24407,6 +25714,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"tinyglobby@npm:^0.2.15":
+  version: 0.2.15
+  resolution: "tinyglobby@npm:0.2.15"
+  dependencies:
+    fdir: "npm:^6.5.0"
+    picomatch: "npm:^4.0.3"
+  checksum: 10c0/869c31490d0d88eedb8305d178d4c75e7463e820df5a9b9d388291daf93e8b1eb5de1dad1c1e139767e4269fe75f3b10d5009b2cc14db96ff98986920a186844
+  languageName: node
+  linkType: hard
+
 "tmp@npm:^0.0.33":
   version: 0.0.33
   resolution: "tmp@npm:0.0.33"
@@ -24522,24 +25839,19 @@ __metadata:
   languageName: node
   linkType: hard
 
-"trim-trailing-lines@npm:^1.0.0":
-  version: 1.1.4
-  resolution: "trim-trailing-lines@npm:1.1.4"
-  checksum: 10c0/95c35ece5fc806e626e7a93a2135c52932d1dee584963138dbefb1df6cb7adcb7a7c68e2c63f05c536f0681c9260e1d5262cb2e234242d23b9a31617b2c1d53c
-  languageName: node
-  linkType: hard
-
-"trim@npm:0.0.1":
-  version: 0.0.1
-  resolution: "trim@npm:0.0.1"
-  checksum: 10c0/d974971fc8b8629d13286f20ec6ccc48f480494ca9df358d452beb1fd7eea1b802be41cc7ee157be4abbdf1b3ca79cc6d04c34b14a7026037d437e8de9dacecb
+"trough@npm:^2.0.0":
+  version: 2.2.0
+  resolution: "trough@npm:2.2.0"
+  checksum: 10c0/58b671fc970e7867a48514168894396dd94e6d9d6456aca427cc299c004fe67f35ed7172a36449086b2edde10e78a71a284ec0076809add6834fb8f857ccb9b0
   languageName: node
   linkType: hard
 
-"trough@npm:^1.0.0":
-  version: 1.0.5
-  resolution: "trough@npm:1.0.5"
-  checksum: 10c0/f036d0d7f9bc7cfe5ee650d70b57bb1f048f3292adf6c81bb9b228e546b2b2e5b74ea04a060d21472108a8cda05ec4814bbe86f87ee35c182c50cb41b5c1810a
+"ts-api-utils@npm:^2.4.0":
+  version: 2.5.0
+  resolution: "ts-api-utils@npm:2.5.0"
+  peerDependencies:
+    typescript: ">=4.8.4"
+  checksum: 10c0/767849383c114e7f1971fa976b20e73ac28fd0c70d8d65c0004790bf4d8f89888c7e4cf6d5949f9c1beae9bc3c64835bef77bbe27fddf45a3c7b60cebcf85c8c
   languageName: node
   linkType: hard
 
@@ -24692,13 +26004,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"tslib@npm:^1.8.1":
-  version: 1.14.1
-  resolution: "tslib@npm:1.14.1"
-  checksum: 10c0/69ae09c49eea644bc5ebe1bca4fa4cc2c82b7b3e02f43b84bd891504edf66dbc6b2ec0eef31a957042de2269139e4acff911e6d186a258fb14069cd7f6febce2
-  languageName: node
-  linkType: hard
-
 "tslib@npm:^2.0.0, tslib@npm:^2.0.1, tslib@npm:^2.0.3, tslib@npm:^2.1.0, tslib@npm:^2.3.0, tslib@npm:^2.3.1, tslib@npm:^2.4.0, tslib@npm:^2.6.2, tslib@npm:^2.8.0":
   version: 2.8.1
   resolution: "tslib@npm:2.8.1"
@@ -24713,17 +26018,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"tsutils@npm:^3.21.0":
-  version: 3.21.0
-  resolution: "tsutils@npm:3.21.0"
-  dependencies:
-    tslib: "npm:^1.8.1"
-  peerDependencies:
-    typescript: ">=2.8.0 || >= 3.2.0-dev || >= 3.3.0-dev || >= 3.4.0-dev || >= 3.5.0-dev || >= 3.6.0-dev || >= 3.6.0-beta || >= 3.7.0-dev || >= 3.7.0-beta"
-  checksum: 10c0/02f19e458ec78ead8fffbf711f834ad8ecd2cc6ade4ec0320790713dccc0a412b99e7fd907c4cda2a1dc602c75db6f12e0108e87a5afad4b2f9e90a24cabd5a2
-  languageName: node
-  linkType: hard
-
 "tuf-js@npm:^1.1.7":
   version: 1.1.7
   resolution: "tuf-js@npm:1.1.7"
@@ -24800,6 +26094,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"type-fest@npm:^3.8.0":
+  version: 3.13.1
+  resolution: "type-fest@npm:3.13.1"
+  checksum: 10c0/547d22186f73a8c04590b70dcf63baff390078c75ea8acd366bbd510fd0646e348bd1970e47ecf795b7cff0b41d26e9c475c1fedd6ef5c45c82075fbf916b629
+  languageName: node
+  linkType: hard
+
 "type-is@npm:^2.0.1":
   version: 2.0.1
   resolution: "type-is@npm:2.0.1"
@@ -24832,6 +26133,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"typed-array-buffer@npm:^1.0.3":
+  version: 1.0.3
+  resolution: "typed-array-buffer@npm:1.0.3"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    es-errors: "npm:^1.3.0"
+    is-typed-array: "npm:^1.1.14"
+  checksum: 10c0/1105071756eb248774bc71646bfe45b682efcad93b55532c6ffa4518969fb6241354e4aa62af679ae83899ec296d69ef88f1f3763657cdb3a4d29321f7b83079
+  languageName: node
+  linkType: hard
+
 "typed-array-byte-length@npm:^1.0.1":
   version: 1.0.1
   resolution: "typed-array-byte-length@npm:1.0.1"
@@ -24845,6 +26157,19 @@ __metadata:
   languageName: node
   linkType: hard
 
+"typed-array-byte-length@npm:^1.0.3":
+  version: 1.0.3
+  resolution: "typed-array-byte-length@npm:1.0.3"
+  dependencies:
+    call-bind: "npm:^1.0.8"
+    for-each: "npm:^0.3.3"
+    gopd: "npm:^1.2.0"
+    has-proto: "npm:^1.2.0"
+    is-typed-array: "npm:^1.1.14"
+  checksum: 10c0/6ae083c6f0354f1fce18b90b243343b9982affd8d839c57bbd2c174a5d5dc71be9eb7019ffd12628a96a4815e7afa85d718d6f1e758615151d5f35df841ffb3e
+  languageName: node
+  linkType: hard
+
 "typed-array-byte-offset@npm:^1.0.2":
   version: 1.0.2
   resolution: "typed-array-byte-offset@npm:1.0.2"
@@ -24859,6 +26184,21 @@ __metadata:
   languageName: node
   linkType: hard
 
+"typed-array-byte-offset@npm:^1.0.4":
+  version: 1.0.4
+  resolution: "typed-array-byte-offset@npm:1.0.4"
+  dependencies:
+    available-typed-arrays: "npm:^1.0.7"
+    call-bind: "npm:^1.0.8"
+    for-each: "npm:^0.3.3"
+    gopd: "npm:^1.2.0"
+    has-proto: "npm:^1.2.0"
+    is-typed-array: "npm:^1.1.15"
+    reflect.getprototypeof: "npm:^1.0.9"
+  checksum: 10c0/3d805b050c0c33b51719ee52de17c1cd8e6a571abdf0fffb110e45e8dd87a657e8b56eee94b776b13006d3d347a0c18a730b903cf05293ab6d92e99ff8f77e53
+  languageName: node
+  linkType: hard
+
 "typed-array-length@npm:^1.0.6":
   version: 1.0.6
   resolution: "typed-array-length@npm:1.0.6"
@@ -24873,6 +26213,20 @@ __metadata:
   languageName: node
   linkType: hard
 
+"typed-array-length@npm:^1.0.7":
+  version: 1.0.7
+  resolution: "typed-array-length@npm:1.0.7"
+  dependencies:
+    call-bind: "npm:^1.0.7"
+    for-each: "npm:^0.3.3"
+    gopd: "npm:^1.0.1"
+    is-typed-array: "npm:^1.1.13"
+    possible-typed-array-names: "npm:^1.0.0"
+    reflect.getprototypeof: "npm:^1.0.6"
+  checksum: 10c0/e38f2ae3779584c138a2d8adfa8ecf749f494af3cd3cdafe4e688ce51418c7d2c5c88df1bd6be2bbea099c3f7cea58c02ca02ed438119e91f162a9de23f61295
+  languageName: node
+  linkType: hard
+
 "typed-assert@npm:^1.0.8":
   version: 1.0.9
   resolution: "typed-assert@npm:1.0.9"
@@ -24887,13 +26241,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typescript@npm:5.1.3":
-  version: 5.1.3
-  resolution: "typescript@npm:5.1.3"
+"typescript@npm:5.9.3":
+  version: 5.9.3
+  resolution: "typescript@npm:5.9.3"
   bin:
     tsc: bin/tsc
     tsserver: bin/tsserver
-  checksum: 10c0/1faba8d5ffd4717864ddce767613c5ab77c1c8510c1ce21dc9b112a4c662357b9338dc0a6121615266d3a44ebec699f115ef2dabf18d9d7341ea1675692b9b24
+  checksum: 10c0/6bd7552ce39f97e711db5aa048f6f9995b53f1c52f7d8667c1abdc1700c68a76a308f579cd309ce6b53646deb4e9a1be7c813a93baaf0a28ccd536a30270e1c5
   languageName: node
   linkType: hard
 
@@ -24907,13 +26261,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typescript@patch:typescript@npm%3A5.1.3#optional!builtin<compat/typescript>":
-  version: 5.1.3
-  resolution: "typescript@patch:typescript@npm%3A5.1.3#optional!builtin<compat/typescript>::version=5.1.3&hash=5da071"
+"typescript@patch:typescript@npm%3A5.9.3#optional!builtin<compat/typescript>":
+  version: 5.9.3
+  resolution: "typescript@patch:typescript@npm%3A5.9.3#optional!builtin<compat/typescript>::version=5.9.3&hash=5786d5"
   bin:
     tsc: bin/tsc
     tsserver: bin/tsserver
-  checksum: 10c0/769c5a11a9d5207ae5ce4c84b5c7a72ad92a28877a0061881ccfb326a43a1a1de79c4daff2f9d74720137744cfc9332fddbfbc4c3973c1e859b2f977f5d11b72
+  checksum: 10c0/ad09fdf7a756814dce65bc60c1657b40d44451346858eea230e10f2e95a289d9183b6e32e5c11e95acc0ccc214b4f36289dcad4bf1886b0adb84d711d336a430
   languageName: node
   linkType: hard
 
@@ -24948,6 +26302,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"unbox-primitive@npm:^1.1.0":
+  version: 1.1.0
+  resolution: "unbox-primitive@npm:1.1.0"
+  dependencies:
+    call-bound: "npm:^1.0.3"
+    has-bigints: "npm:^1.0.2"
+    has-symbols: "npm:^1.1.0"
+    which-boxed-primitive: "npm:^1.1.1"
+  checksum: 10c0/7dbd35ab02b0e05fe07136c72cb9355091242455473ec15057c11430129bab38b7b3624019b8778d02a881c13de44d63cd02d122ee782fb519e1de7775b5b982
+  languageName: node
+  linkType: hard
+
 "undici-types@npm:~6.19.8":
   version: 6.19.8
   resolution: "undici-types@npm:6.19.8"
@@ -24955,13 +26321,10 @@ __metadata:
   languageName: node
   linkType: hard
 
-"unherit@npm:^1.0.4":
-  version: 1.1.3
-  resolution: "unherit@npm:1.1.3"
-  dependencies:
-    inherits: "npm:^2.0.0"
-    xtend: "npm:^4.0.0"
-  checksum: 10c0/f953b548e56ef347b14c0897484ff22187acfeeb599afe2994cfdbfaddffe8731b999029e243fd40966b597bdffd541f3b5a54254797b98aebb760bb39dd8456
+"undici-types@npm:~6.21.0":
+  version: 6.21.0
+  resolution: "undici-types@npm:6.21.0"
+  checksum: 10c0/c01ed51829b10aa72fc3ce64b747f8e74ae9b60eafa19a7b46ef624403508a54c526ffab06a14a26b3120d055e1104d7abe7c9017e83ced038ea5cf52f8d5e04
   languageName: node
   linkType: hard
 
@@ -24996,31 +26359,47 @@ __metadata:
   languageName: node
   linkType: hard
 
-"unified@npm:9.2.0":
-  version: 9.2.0
-  resolution: "unified@npm:9.2.0"
+"unified-engine@npm:^11.2.2":
+  version: 11.2.2
+  resolution: "unified-engine@npm:11.2.2"
   dependencies:
-    bail: "npm:^1.0.0"
+    "@types/concat-stream": "npm:^2.0.0"
+    "@types/debug": "npm:^4.0.0"
+    "@types/is-empty": "npm:^1.0.0"
+    "@types/node": "npm:^22.0.0"
+    "@types/unist": "npm:^3.0.0"
+    concat-stream: "npm:^2.0.0"
+    debug: "npm:^4.0.0"
     extend: "npm:^3.0.0"
-    is-buffer: "npm:^2.0.0"
-    is-plain-obj: "npm:^2.0.0"
-    trough: "npm:^1.0.0"
-    vfile: "npm:^4.0.0"
-  checksum: 10c0/53aedb794b0ada002b72593d74633f45742e3dfe771a8091c0f51b59119f74f3f1bba0a24c5d72a35629793f992cf9e1debf21aa4689dc718482ffec3a633623
-  languageName: node
-  linkType: hard
-
-"unified@npm:^9.2.2":
-  version: 9.2.2
-  resolution: "unified@npm:9.2.2"
-  dependencies:
-    bail: "npm:^1.0.0"
+    glob: "npm:^10.0.0"
+    ignore: "npm:^6.0.0"
+    is-empty: "npm:^1.0.0"
+    is-plain-obj: "npm:^4.0.0"
+    load-plugin: "npm:^6.0.0"
+    parse-json: "npm:^7.0.0"
+    trough: "npm:^2.0.0"
+    unist-util-inspect: "npm:^8.0.0"
+    vfile: "npm:^6.0.0"
+    vfile-message: "npm:^4.0.0"
+    vfile-reporter: "npm:^8.0.0"
+    vfile-statistics: "npm:^3.0.0"
+    yaml: "npm:^2.0.0"
+  checksum: 10c0/daac3b2bf18fb79a052129958e104bddfb8241ef5ea51696a214864906a61a375c4d95b42958b7ed300ebaa028172f1e8b6515f1664a0fa765eb11ca06b891ee
+  languageName: node
+  linkType: hard
+
+"unified@npm:^11.0.0, unified@npm:^11.0.5":
+  version: 11.0.5
+  resolution: "unified@npm:11.0.5"
+  dependencies:
+    "@types/unist": "npm:^3.0.0"
+    bail: "npm:^2.0.0"
+    devlop: "npm:^1.0.0"
     extend: "npm:^3.0.0"
-    is-buffer: "npm:^2.0.0"
-    is-plain-obj: "npm:^2.0.0"
-    trough: "npm:^1.0.0"
-    vfile: "npm:^4.0.0"
-  checksum: 10c0/a66d71b039c24626802a4664a1f3210f29ab1f75b89fd41933e6ab00561e1ec43a5bec6de32c7ebc86544e5f00ef5836e8fe79a823e81e35825de4e35823eda9
+    is-plain-obj: "npm:^4.0.0"
+    trough: "npm:^2.0.0"
+    vfile: "npm:^6.0.0"
+  checksum: 10c0/53c8e685f56d11d9d458a43e0e74328a4d6386af51c8ac37a3dcabec74ce5026da21250590d4aff6733ccd7dc203116aae2b0769abc18cdf9639a54ae528dfc9
   languageName: node
   linkType: hard
 
@@ -25087,49 +26466,60 @@ __metadata:
   languageName: node
   linkType: hard
 
-"unist-util-is@npm:^4.0.0":
-  version: 4.1.0
-  resolution: "unist-util-is@npm:4.1.0"
-  checksum: 10c0/21ca3d7bacc88853b880b19cb1b133a056c501617d7f9b8cce969cd8b430ed7e1bc416a3a11b02540d5de6fb86807e169d00596108a459d034cf5faec97c055e
+"unist-util-inspect@npm:^8.0.0":
+  version: 8.1.0
+  resolution: "unist-util-inspect@npm:8.1.0"
+  dependencies:
+    "@types/unist": "npm:^3.0.0"
+  checksum: 10c0/d3dff256ffd77a1e8dd583be89070dc1ab124d424794fcc1105a38c2f0bb0538afc686e592699807c7d9fa612821961033fe38e26c11ba0bb51d19e8ae7c4119
   languageName: node
   linkType: hard
 
-"unist-util-remove-position@npm:^2.0.0":
-  version: 2.0.1
-  resolution: "unist-util-remove-position@npm:2.0.1"
+"unist-util-is@npm:^6.0.0":
+  version: 6.0.1
+  resolution: "unist-util-is@npm:6.0.1"
   dependencies:
-    unist-util-visit: "npm:^2.0.0"
-  checksum: 10c0/9aadc8e9fafc4eeb04462454ab084184b84b397a367cab3787c59411b16c8f03d13e80e9ffd6bdae68bf8e5175f42008f410288a041a6ee53bcac8ced45a12ed
+    "@types/unist": "npm:^3.0.0"
+  checksum: 10c0/5a487d390193811d37a68264e204dbc7c15c40b8fc29b5515a535d921d071134f571d7b5cbd59bcd58d5ce1c0ab08f20fc4a1f0df2287a249c979267fc32ce06
   languageName: node
   linkType: hard
 
-"unist-util-stringify-position@npm:^2.0.0":
-  version: 2.0.3
-  resolution: "unist-util-stringify-position@npm:2.0.3"
+"unist-util-position-from-estree@npm:^2.0.0":
+  version: 2.0.0
+  resolution: "unist-util-position-from-estree@npm:2.0.0"
   dependencies:
-    "@types/unist": "npm:^2.0.2"
-  checksum: 10c0/46fa03f840df173b7f032cbfffdb502fb05b79b3fb5451681c796cf4985d9087a537833f5afb75d55e79b46bbbe4b3d81dd75a1062f9289091c526aebe201d5d
+    "@types/unist": "npm:^3.0.0"
+  checksum: 10c0/39127bf5f0594e0a76d9241dec4f7aa26323517120ce1edd5ed91c8c1b9df7d6fb18af556e4b6250f1c7368825720ed892e2b6923be5cdc08a9bb16536dc37b3
   languageName: node
   linkType: hard
 
-"unist-util-visit-parents@npm:^3.0.0":
-  version: 3.1.1
-  resolution: "unist-util-visit-parents@npm:3.1.1"
+"unist-util-stringify-position@npm:^4.0.0":
+  version: 4.0.0
+  resolution: "unist-util-stringify-position@npm:4.0.0"
   dependencies:
-    "@types/unist": "npm:^2.0.0"
-    unist-util-is: "npm:^4.0.0"
-  checksum: 10c0/231c80c5ba8e79263956fcaa25ed2a11ad7fe77ac5ba0d322e9d51bbc4238501e3bb52f405e518bcdc5471e27b33eff520db0aa4a3b1feb9fb6e2de6ae385d49
+    "@types/unist": "npm:^3.0.0"
+  checksum: 10c0/dfe1dbe79ba31f589108cb35e523f14029b6675d741a79dea7e5f3d098785045d556d5650ec6a8338af11e9e78d2a30df12b1ee86529cded1098da3f17ee999e
   languageName: node
   linkType: hard
 
-"unist-util-visit@npm:^2.0.0":
-  version: 2.0.3
-  resolution: "unist-util-visit@npm:2.0.3"
+"unist-util-visit-parents@npm:^6.0.0":
+  version: 6.0.2
+  resolution: "unist-util-visit-parents@npm:6.0.2"
   dependencies:
-    "@types/unist": "npm:^2.0.0"
-    unist-util-is: "npm:^4.0.0"
-    unist-util-visit-parents: "npm:^3.0.0"
-  checksum: 10c0/7b11303d82271ca53a2ced2d56c87a689dd518596c99ff4a11cdff750f5cc5c0e4b64b146bd2363557cb29443c98713bfd1e8dc6d1c3f9d474b9eb1f23a60888
+    "@types/unist": "npm:^3.0.0"
+    unist-util-is: "npm:^6.0.0"
+  checksum: 10c0/f1e4019dbd930301825895e3737b1ee0cd682f7622ddd915062135cbb39f8c090aaece3a3b5eae1f2ea52ec33f0931abb8f8a8b5c48a511a4203e3d360a8cd49
+  languageName: node
+  linkType: hard
+
+"unist-util-visit@npm:^5.0.0":
+  version: 5.1.0
+  resolution: "unist-util-visit@npm:5.1.0"
+  dependencies:
+    "@types/unist": "npm:^3.0.0"
+    unist-util-is: "npm:^6.0.0"
+    unist-util-visit-parents: "npm:^6.0.0"
+  checksum: 10c0/a56e1bbbf63fcb55abe379e660b9a3367787e8be1e2473bdb7e86cfa6f32b6c1fa0092432d7040b8a30b2fc674bbbe024ffe6d03c3d6bf4839b064f584463a4e
   languageName: node
   linkType: hard
 
@@ -25513,32 +26903,59 @@ __metadata:
   languageName: node
   linkType: hard
 
-"vfile-location@npm:^3.0.0":
-  version: 3.2.0
-  resolution: "vfile-location@npm:3.2.0"
-  checksum: 10c0/d9513c738fcac26388f4ee04337663514434df718201309088377b53be3fdcfdb01a4a8f02f5a21ebf33690a670f31229e4c7c3991fb7af63f549fda3ec36836
+"vfile-message@npm:^4.0.0":
+  version: 4.0.3
+  resolution: "vfile-message@npm:4.0.3"
+  dependencies:
+    "@types/unist": "npm:^3.0.0"
+    unist-util-stringify-position: "npm:^4.0.0"
+  checksum: 10c0/33d9f219610d27987689bb14fa5573d2daa146941d1a05416dd7702c4215b23f44ed81d059e70d0e4e24f9a57d5f4dc9f18d35a993f04cf9446a7abe6d72d0c0
   languageName: node
   linkType: hard
 
-"vfile-message@npm:^2.0.0":
-  version: 2.0.4
-  resolution: "vfile-message@npm:2.0.4"
+"vfile-reporter@npm:^8.0.0":
+  version: 8.1.1
+  resolution: "vfile-reporter@npm:8.1.1"
   dependencies:
-    "@types/unist": "npm:^2.0.0"
-    unist-util-stringify-position: "npm:^2.0.0"
-  checksum: 10c0/ce50d90e0e5dc8f995f39602dd2404f1756388a54209c983d259b17c15e6f262a53546977a638065bc487d0657799fa96f4c1ba6b2915d9724a4968e9c7ff1c8
+    "@types/supports-color": "npm:^8.0.0"
+    string-width: "npm:^6.0.0"
+    supports-color: "npm:^9.0.0"
+    unist-util-stringify-position: "npm:^4.0.0"
+    vfile: "npm:^6.0.0"
+    vfile-message: "npm:^4.0.0"
+    vfile-sort: "npm:^4.0.0"
+    vfile-statistics: "npm:^3.0.0"
+  checksum: 10c0/5da85c67e4a26762d64d65d0aac5ef339a413cc051470d970eea7352f07afd24577d42780c3af93c109177078df1bbbdbcc3e82adcc34e1bb96d2665f3f0c2a1
   languageName: node
   linkType: hard
 
-"vfile@npm:^4.0.0":
-  version: 4.2.1
-  resolution: "vfile@npm:4.2.1"
+"vfile-sort@npm:^4.0.0":
+  version: 4.0.0
+  resolution: "vfile-sort@npm:4.0.0"
   dependencies:
-    "@types/unist": "npm:^2.0.0"
-    is-buffer: "npm:^2.0.0"
-    unist-util-stringify-position: "npm:^2.0.0"
-    vfile-message: "npm:^2.0.0"
-  checksum: 10c0/4816aecfedc794ba4d3131abff2032ef0e825632cfa8cd20dd9d83819ef260589924f4f3e8fa30e06da2d8e60d7ec8ef7d0af93e0483df62890738258daf098a
+    vfile: "npm:^6.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/fe1a4cbe24d03b81a7e7486be107eb029ac2631a3575e55a3f1d25cf54bcf2d60b3f76694dedf8a2f60793877e1d192234157cdfd50d1a0d18b9a4c1487cdf65
+  languageName: node
+  linkType: hard
+
+"vfile-statistics@npm:^3.0.0":
+  version: 3.0.0
+  resolution: "vfile-statistics@npm:3.0.0"
+  dependencies:
+    vfile: "npm:^6.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/3de51670329701e2cff75d979564087578844444d9b9d8619a2fdd2a904bc970bf4d05b58e7cee71e0f6f34087f1f7f2ea85cdfa5bf58f572c777432c156bd8f
+  languageName: node
+  linkType: hard
+
+"vfile@npm:^6.0.0, vfile@npm:^6.0.3":
+  version: 6.0.3
+  resolution: "vfile@npm:6.0.3"
+  dependencies:
+    "@types/unist": "npm:^3.0.0"
+    vfile-message: "npm:^4.0.0"
+  checksum: 10c0/e5d9eb4810623f23758cfc2205323e33552fb5972e5c2e6587babe08fe4d24859866277404fb9e2a20afb71013860d96ec806cb257536ae463c87d70022ab9ef
   languageName: node
   linkType: hard
 
@@ -25551,6 +26968,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"walk-up-path@npm:^3.0.1":
+  version: 3.0.1
+  resolution: "walk-up-path@npm:3.0.1"
+  checksum: 10c0/3184738e0cf33698dd58b0ee4418285b9c811e58698f52c1f025435a85c25cbc5a63fee599f1a79cb29ca7ef09a44ec9417b16bfd906b1a37c305f7aa20ee5bc
+  languageName: node
+  linkType: hard
+
 "walker@npm:^1.0.8":
   version: 1.0.8
   resolution: "walker@npm:1.0.8"
@@ -25835,23 +27259,37 @@ __metadata:
   languageName: node
   linkType: hard
 
-"which-builtin-type@npm:^1.1.3":
-  version: 1.1.4
-  resolution: "which-builtin-type@npm:1.1.4"
+"which-boxed-primitive@npm:^1.1.0, which-boxed-primitive@npm:^1.1.1":
+  version: 1.1.1
+  resolution: "which-boxed-primitive@npm:1.1.1"
+  dependencies:
+    is-bigint: "npm:^1.1.0"
+    is-boolean-object: "npm:^1.2.1"
+    is-number-object: "npm:^1.1.1"
+    is-string: "npm:^1.1.1"
+    is-symbol: "npm:^1.1.1"
+  checksum: 10c0/aceea8ede3b08dede7dce168f3883323f7c62272b49801716e8332ff750e7ae59a511ae088840bc6874f16c1b7fd296c05c949b0e5b357bfe3c431b98c417abe
+  languageName: node
+  linkType: hard
+
+"which-builtin-type@npm:^1.2.1":
+  version: 1.2.1
+  resolution: "which-builtin-type@npm:1.2.1"
   dependencies:
+    call-bound: "npm:^1.0.2"
     function.prototype.name: "npm:^1.1.6"
     has-tostringtag: "npm:^1.0.2"
     is-async-function: "npm:^2.0.0"
-    is-date-object: "npm:^1.0.5"
-    is-finalizationregistry: "npm:^1.0.2"
+    is-date-object: "npm:^1.1.0"
+    is-finalizationregistry: "npm:^1.1.0"
     is-generator-function: "npm:^1.0.10"
-    is-regex: "npm:^1.1.4"
+    is-regex: "npm:^1.2.1"
     is-weakref: "npm:^1.0.2"
     isarray: "npm:^2.0.5"
-    which-boxed-primitive: "npm:^1.0.2"
+    which-boxed-primitive: "npm:^1.1.0"
     which-collection: "npm:^1.0.2"
-    which-typed-array: "npm:^1.1.15"
-  checksum: 10c0/a4a76d20d869a81b1dbb4adea31edc7e6c1a4466d3ab7c2cd757c9219d48d3723b04076c85583257b0f0f8e3ebe5af337248b8ceed57b9051cb97bce5bd881d1
+    which-typed-array: "npm:^1.1.16"
+  checksum: 10c0/8dcf323c45e5c27887800df42fbe0431d0b66b1163849bb7d46b5a730ad6a96ee8bfe827d078303f825537844ebf20c02459de41239a0a9805e2fcb3cae0d471
   languageName: node
   linkType: hard
 
@@ -25880,6 +27318,21 @@ __metadata:
   languageName: node
   linkType: hard
 
+"which-typed-array@npm:^1.1.16, which-typed-array@npm:^1.1.19":
+  version: 1.1.20
+  resolution: "which-typed-array@npm:1.1.20"
+  dependencies:
+    available-typed-arrays: "npm:^1.0.7"
+    call-bind: "npm:^1.0.8"
+    call-bound: "npm:^1.0.4"
+    for-each: "npm:^0.3.5"
+    get-proto: "npm:^1.0.1"
+    gopd: "npm:^1.2.0"
+    has-tostringtag: "npm:^1.0.2"
+  checksum: 10c0/16fcdada95c8afb821cd1117f0ab50b4d8551677ac08187f21d4e444530913c9ffd2dac634f0c1183345f96344b69280f40f9a8bc52164ef409e555567c2604b
+  languageName: node
+  linkType: hard
+
 "which@npm:^1.2.14":
   version: 1.3.1
   resolution: "which@npm:1.3.1"
@@ -25913,6 +27366,17 @@ __metadata:
   languageName: node
   linkType: hard
 
+"which@npm:^4.0.0":
+  version: 4.0.0
+  resolution: "which@npm:4.0.0"
+  dependencies:
+    isexe: "npm:^3.1.1"
+  bin:
+    node-which: bin/which.js
+  checksum: 10c0/449fa5c44ed120ccecfe18c433296a4978a7583bf2391c50abce13f76878d2476defde04d0f79db8165bdf432853c1f8389d0485ca6e8ebce3bbcded513d5e6a
+  languageName: node
+  linkType: hard
+
 "which@npm:^6.0.0":
   version: 6.0.0
   resolution: "which@npm:6.0.0"
@@ -26094,7 +27558,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"xtend@npm:^4.0.0, xtend@npm:^4.0.1, xtend@npm:~4.0.1":
+"xtend@npm:~4.0.1":
   version: 4.0.2
   resolution: "xtend@npm:4.0.2"
   checksum: 10c0/366ae4783eec6100f8a02dff02ac907bf29f9a00b82ac0264b4d8b832ead18306797e283cf19de776538babfdcb2101375ec5646b59f08c52128ac4ab812ed0e
@@ -26143,6 +27607,15 @@ __metadata:
   languageName: node
   linkType: hard
 
+"yaml@npm:^2.0.0":
+  version: 2.8.3
+  resolution: "yaml@npm:2.8.3"
+  bin:
+    yaml: bin.mjs
+  checksum: 10c0/ddff0e11c1b467728d7eb4633db61c5f5de3d8e9373cf84d08fb0cdee03e1f58f02b9f1c51a4a8a865751695addbd465a77f73f1079be91fe5493b29c305fd77
+  languageName: node
+  linkType: hard
+
 "yaml@npm:^2.6.0":
   version: 2.7.1
   resolution: "yaml@npm:2.7.1"
@@ -26188,7 +27661,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"yargs@npm:^17.1.1, yargs@npm:^17.3.1, yargs@npm:^17.6.2":
+"yargs@npm:^17.3.1, yargs@npm:^17.6.2, yargs@npm:^17.7.2":
   version: 17.7.2
   resolution: "yargs@npm:17.7.2"
   dependencies:
@@ -26223,3 +27696,10 @@ __metadata:
   checksum: 10c0/cb287fe5e6acfa82690acb43c283de34e945c571a78a939774f6eaba7c285bacdf6c90fbc16ce530060863984c906d2b4c6ceb069c94d1e0a06d5f2b458e2a92
   languageName: node
   linkType: hard
+
+"zwitch@npm:^2.0.0":
+  version: 2.0.4
+  resolution: "zwitch@npm:2.0.4"
+  checksum: 10c0/3c7830cdd3378667e058ffdb4cf2bb78ac5711214e2725900873accb23f3dfe5f9e7e5a06dcdc5f29605da976fc45c26d9a13ca334d6eea2245a15e77b8fc06e
+  languageName: node
+  linkType: hard

From 3adb8cbf261a580858e275e4504b2035a6b53ece Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Wed, 25 Mar 2026 09:48:02 -0400
Subject: [PATCH 14/37] test typescript

---
 .eslintrc.js                                  |  22 +
 .../eslint-plugin-gamut/src/prefer-themed.ts  |   8 +-
 packages/gamut/src/Button/shared/types.ts     |   2 +
 .../src/ConnectedForm/ConnectedFormGroup.tsx  |   5 +-
 packages/gamut/src/ConnectedForm/utils.tsx    |   5 +-
 .../SelectDropdown/elements/containers.tsx    |   2 +-
 packages/gamut/src/Modals/Dialog.tsx          |   6 +-
 packages/gamut/src/Modals/Modal.tsx           |   7 +-
 packages/gamut/src/Tag/index.tsx              |   8 +-
 packages/gamut/src/Tip/shared/utils.tsx       |   2 +-
 .../SelectDropdown/SelectDropdown.mdx         |   5 +-
 .../PopoverContainer/PopoverContainer.mdx     |   2 +-
 .../DelayedRenderWrapper.mdx                  |   2 +-
 .../styleguide/src/lib/Foundations/Layout.mdx |   3 +-
 .../src/lib/Foundations/shared/elements.tsx   |   1 +
 .../src/lib/Layouts/LayoutGrid/examples.tsx   |   8 +-
 .../src/lib/Meta/Best Practices.mdx           |  13 +-
 packages/variance/src/types/config.ts         |   2 +-
 packages/variance/src/utils/responsive.ts     |   2 +-
 yarn.lock                                     | 785 ++----------------
 20 files changed, 123 insertions(+), 767 deletions(-)

diff --git a/.eslintrc.js b/.eslintrc.js
index 6aac8591e81..f151e2daa0d 100644
--- a/.eslintrc.js
+++ b/.eslintrc.js
@@ -10,6 +10,21 @@ module.exports = {
 
   ignorePatterns: ['packages/code-connect/**/*'],
 
+  settings: {
+    'import/parsers': {
+      [require.resolve('@typescript-eslint/parser')]: [
+        '.ts',
+        '.cts',
+        '.mts',
+        '.tsx',
+        '.js',
+        '.jsx',
+        '.mjs',
+        '.cjs',
+      ],
+    },
+  },
+
   rules: {
     'gamut/prefer-themed': 'error',
     'gamut/no-css-standalone': 'error',
@@ -38,6 +53,13 @@ module.exports = {
       // being applied to subsequent plugin imports/extensions. Wild.
       files: ['*.tsx', '*.ts'],
       rules: {
+        '@typescript-eslint/no-empty-object-type': [
+          'error',
+          {
+            allowInterfaces: 'with-single-extends',
+            allowObjectTypes: 'always',
+          },
+        ],
         // These rules could be useful, but we haven't gotten around to enabling them here
         // See WEB-2 for general tracking.
         '@typescript-eslint/no-explicit-any': 'off',
diff --git a/packages/eslint-plugin-gamut/src/prefer-themed.ts b/packages/eslint-plugin-gamut/src/prefer-themed.ts
index 8e45b4d0502..4d376421322 100644
--- a/packages/eslint-plugin-gamut/src/prefer-themed.ts
+++ b/packages/eslint-plugin-gamut/src/prefer-themed.ts
@@ -1,5 +1,3 @@
-import { AST_NODE_TYPES } from '@typescript-eslint/utils';
-
 import { createRule } from './createRule';
 import {
   checkArrowFuncBodyTypesAndReturnThemeVars,
@@ -10,14 +8,12 @@ export default createRule({
   create(context) {
     return {
       TaggedTemplateExpression(node) {
-        if (node.tag.type === AST_NODE_TYPES.MemberExpression) {
+        if (node.tag.type === 'MemberExpression') {
           if (node.tag.object.type !== 'Identifier') return;
           const expressionVariable = node.tag.object.name;
           const arrowFuncExpression = node.quasi.expressions[0];
 
-          if (
-            arrowFuncExpression?.type !== AST_NODE_TYPES.ArrowFunctionExpression
-          )
+          if (arrowFuncExpression?.type !== 'ArrowFunctionExpression')
             return;
 
           if (!isNamedVariableTheme(arrowFuncExpression)) return;
diff --git a/packages/gamut/src/Button/shared/types.ts b/packages/gamut/src/Button/shared/types.ts
index 053ccd9615b..95838ba097c 100644
--- a/packages/gamut/src/Button/shared/types.ts
+++ b/packages/gamut/src/Button/shared/types.ts
@@ -30,9 +30,11 @@ export type InlineIconButtonProps<
     iconPosition?: 'right' | 'left';
   };
 
+/* eslint-disable @typescript-eslint/no-duplicate-type-constituents -- createButtonComponent yields structurally identical typeofs; union documents distinct components */
 export type ButtonTypes =
   | typeof CTAButton
   | typeof FillButton
   | typeof IconButton
   | typeof StrokeButton
   | typeof TextButton;
+/* eslint-enable @typescript-eslint/no-duplicate-type-constituents */
diff --git a/packages/gamut/src/ConnectedForm/ConnectedFormGroup.tsx b/packages/gamut/src/ConnectedForm/ConnectedFormGroup.tsx
index 4e7ede387b2..efe99752c46 100644
--- a/packages/gamut/src/ConnectedForm/ConnectedFormGroup.tsx
+++ b/packages/gamut/src/ConnectedForm/ConnectedFormGroup.tsx
@@ -60,6 +60,7 @@ export function ConnectedFormGroup<T extends ConnectedField>({
   isSoloField,
   infotip,
 }: ConnectedFormGroupProps<T>) {
+  const fieldId = typeof id === 'string' && id !== '' ? id : name;
   const { error, isFirstError, isDisabled, setError, validation } = useField({
     name,
     disabled,
@@ -78,7 +79,7 @@ export function ConnectedFormGroup<T extends ConnectedField>({
   const renderedLabel = (
     <FormGroupLabel
       disabled={isDisabled}
-      htmlFor={id || name}
+      htmlFor={fieldId}
       infotip={infotip}
       isSoloField={isSoloField}
       required={!!validation?.required}
@@ -90,7 +91,7 @@ export function ConnectedFormGroup<T extends ConnectedField>({
 
   const textError = customError || getErrorMessage(error);
   const showError = !!(textError && !hideLabel);
-  const errorId = showError ? `${id || name}_error` : undefined;
+  const errorId = showError ? `${fieldId}_error` : undefined;
 
   return (
     <FormGroup spacing={hideLabel ? 'tight' : spacing}>
diff --git a/packages/gamut/src/ConnectedForm/utils.tsx b/packages/gamut/src/ConnectedForm/utils.tsx
index 95560991c7f..ef0a3fb9c31 100644
--- a/packages/gamut/src/ConnectedForm/utils.tsx
+++ b/packages/gamut/src/ConnectedForm/utils.tsx
@@ -177,9 +177,7 @@ export const useField = ({ name, disabled, loading }: useFieldProps) => {
   });
 
   const validation =
-    (validationRules &&
-      validationRules[name as keyof typeof validationRules]) ??
-    undefined;
+    validationRules?.[name as keyof typeof validationRules] ?? undefined;
 
   const ref = register(name, validation);
 
@@ -333,7 +331,6 @@ type InputTypes =
       | 'search'
       | 'month'
       | 'tel'
-      | 'time'
       | 'url'
       | 'week'
     >
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx b/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
index 47dd615a032..151fb9eb3b9 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
@@ -74,7 +74,7 @@ export const CustomValueContainer = ({
       const { inputId } = rest.selectProps;
       if (inputId) {
         const inputElement = document.getElementById(inputId);
-        if (inputElement && inputElement.getAttribute('role') === 'combobox') {
+        if (inputElement?.getAttribute('role') === 'combobox') {
           Object.entries(comboboxProps).forEach(([key, value]) => {
             inputElement.setAttribute(key, value);
           });
diff --git a/packages/gamut/src/Modals/Dialog.tsx b/packages/gamut/src/Modals/Dialog.tsx
index 7ad3acd7d09..4281c26f041 100644
--- a/packages/gamut/src/Modals/Dialog.tsx
+++ b/packages/gamut/src/Modals/Dialog.tsx
@@ -65,7 +65,11 @@ export const Dialog: React.FC<DialogProps> = ({
       <ModalContainer
         aria-hidden="false"
         aria-label="dialog"
-        aria-labelledby={String(title)}
+        aria-labelledby={
+          typeof title === 'string' || typeof title === 'number'
+            ? String(title)
+            : undefined
+        }
         aria-modal="true"
         data-autofocus
         layout="dialog"
diff --git a/packages/gamut/src/Modals/Modal.tsx b/packages/gamut/src/Modals/Modal.tsx
index dc3db860b29..ed025347fda 100644
--- a/packages/gamut/src/Modals/Modal.tsx
+++ b/packages/gamut/src/Modals/Modal.tsx
@@ -110,7 +110,12 @@ export const Modal: React.FC<ModalProps> = ({
       <ModalContainer
         aria-hidden="false"
         aria-label={ariaLabel}
-        aria-labelledby={titleText ? String(titleText) : undefined}
+        aria-labelledby={
+          titleText != null &&
+          (typeof titleText === 'string' || typeof titleText === 'number')
+            ? String(titleText)
+            : undefined
+        }
         aria-modal="true"
         className={className}
         data-autofocus
diff --git a/packages/gamut/src/Tag/index.tsx b/packages/gamut/src/Tag/index.tsx
index 29626f3dbe5..e90b4ead3f4 100644
--- a/packages/gamut/src/Tag/index.tsx
+++ b/packages/gamut/src/Tag/index.tsx
@@ -89,7 +89,13 @@ export const Tag: React.FC<TagProps> = ({
       {isSelection && (
         <DismissButton
           aria-disabled={disabled}
-          aria-label={disabled ? '' : `Dismiss ${children} Tag`}
+          aria-label={
+            disabled
+              ? ''
+              : typeof children === 'string' || typeof children === 'number'
+                ? `Dismiss ${children} Tag`
+                : 'Dismiss tag'
+          }
           disabled={disabled}
           icon={isLarge ? LargeMiniDeleteIcon : DefaultMiniDeleteIcon}
           isLarge={isLarge}
diff --git a/packages/gamut/src/Tip/shared/utils.tsx b/packages/gamut/src/Tip/shared/utils.tsx
index 2ca69443b09..0018f3ed33b 100755
--- a/packages/gamut/src/Tip/shared/utils.tsx
+++ b/packages/gamut/src/Tip/shared/utils.tsx
@@ -101,7 +101,7 @@ export const isFloatingElementOpen = (element: Element): boolean => {
   const toggleButton = element.querySelector(
     'button[aria-expanded], [role="button"][aria-expanded]'
   );
-  if (toggleButton && toggleButton.getAttribute('aria-expanded') === 'false') {
+  if (toggleButton?.getAttribute('aria-expanded') === 'false') {
     return false;
   }
 
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
index 1c7ae8962ec..85b595c1fec 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
@@ -136,10 +136,7 @@ Some of our forms require special props be passed directly onto the input compon
 - `hidden`: Props passed to the hidden input element (used for form submission)
 - `combobox`: Props passed to the visible react-select input element (useful for data-\* attributes, testing, etc.)
 
-<Callout
-  text="  These props are passed directly to the underlying elements, so they only
-  accept `data-*` and `aria-*` attributes to ensure validity."
-/>
+<Callout text="These props are passed directly to the underlying elements, so they only accept data-* and aria-* attributes to ensure validity." />
 
 <Canvas of={SelectDropdownStories.CustomInputProps} />
 
diff --git a/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.mdx b/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.mdx
index 1e798427472..ccedabf1968 100644
--- a/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.mdx
+++ b/packages/styleguide/src/lib/Atoms/PopoverContainer/PopoverContainer.mdx
@@ -75,7 +75,7 @@ Addition pixel offset from center in the direction of the alignment (e.g. top-le
 
 ### Individual axis offsets `x` and `y`
 
-Absolute offset values irrespective of the relative position. (e.g. x={-4} will be 4 pixels to the left in every position unlike offset).
+Absolute offset values irrespective of the relative position. (e.g. `x={-4}` will be 4 pixels to the left in every position unlike offset).
 
 <Canvas of={PopoverContainerStories.XandY} />
 
diff --git a/packages/styleguide/src/lib/Atoms/UtilityComponents/DelayedRenderWrapper/DelayedRenderWrapper.mdx b/packages/styleguide/src/lib/Atoms/UtilityComponents/DelayedRenderWrapper/DelayedRenderWrapper.mdx
index d701a35ca19..afd945f3d7e 100644
--- a/packages/styleguide/src/lib/Atoms/UtilityComponents/DelayedRenderWrapper/DelayedRenderWrapper.mdx
+++ b/packages/styleguide/src/lib/Atoms/UtilityComponents/DelayedRenderWrapper/DelayedRenderWrapper.mdx
@@ -24,7 +24,7 @@ export const parameters = {
 
 Use `DelayedRenderWrapper` to wrap around a component that you want to delay rendering for a specified amount of time.
 
-The `delay` prop accepts a number in milliseconds. If a `delay` {'>'} 0 is provided, `DelayedRenderWrapper` will use a `setTimeout()` to determine when to render its children. If `delay` is 0 or not provided, it will render its children immediately.
+The `delay` prop accepts a number in milliseconds. If a `delay` value greater than 0 is provided, `DelayedRenderWrapper` will use a `setTimeout()` to determine when to render its children. If `delay` is 0 or not provided, it will render its children immediately.
 
 ## Playground
 
diff --git a/packages/styleguide/src/lib/Foundations/Layout.mdx b/packages/styleguide/src/lib/Foundations/Layout.mdx
index bb4460d2589..ea9722147f9 100644
--- a/packages/styleguide/src/lib/Foundations/Layout.mdx
+++ b/packages/styleguide/src/lib/Foundations/Layout.mdx
@@ -154,6 +154,7 @@ For spacing between components and sections use these as a guide. Each of these
           >
             {sizes.map((size) => (
               <Box
+                key={`box-${size}`}
                 width={`${size}px`}
                 height={`${size}px`}
                 display="inline-block"
@@ -161,7 +162,7 @@ For spacing between components and sections use these as a guide. Each of these
               />
             ))}
             {sizes.map((size) => (
-              <Box textAlign="center" fontSize={14}>
+              <Box key={`label-${size}`} textAlign="center" fontSize={14}>
                 {size}
               </Box>
             ))}
diff --git a/packages/styleguide/src/lib/Foundations/shared/elements.tsx b/packages/styleguide/src/lib/Foundations/shared/elements.tsx
index 4d345df50be..f6bbb831032 100644
--- a/packages/styleguide/src/lib/Foundations/shared/elements.tsx
+++ b/packages/styleguide/src/lib/Foundations/shared/elements.tsx
@@ -499,6 +499,7 @@ export const defaultColumns = [
 ];
 
 export const getPropRows = (key: keyof typeof ALL_PROPS) =>
+  // eslint-disable-next-line import/namespace -- dynamic keyof on namespace import
   Object.entries(ALL_PROPS[key]).map(([prop, config]) => ({
     id: prop,
     ...config,
diff --git a/packages/styleguide/src/lib/Layouts/LayoutGrid/examples.tsx b/packages/styleguide/src/lib/Layouts/LayoutGrid/examples.tsx
index e85cc78fd0e..f5dbe5117ac 100644
--- a/packages/styleguide/src/lib/Layouts/LayoutGrid/examples.tsx
+++ b/packages/styleguide/src/lib/Layouts/LayoutGrid/examples.tsx
@@ -50,7 +50,13 @@ export const renderColumnChildren = (
       {...props}
       rowspan={span ? span[i] : undefined}
     >
-      <Example>{`${props?.size?.toString()}`}</Example>
+      <Example>
+        {props?.size !== undefined &&
+        props.size !== null &&
+        (typeof props.size === 'string' || typeof props.size === 'number')
+          ? String(props.size)
+          : ''}
+      </Example>
     </Column>
   ));
 };
diff --git a/packages/styleguide/src/lib/Meta/Best Practices.mdx b/packages/styleguide/src/lib/Meta/Best Practices.mdx
index 01fba299992..c6a49f05832 100644
--- a/packages/styleguide/src/lib/Meta/Best Practices.mdx	
+++ b/packages/styleguide/src/lib/Meta/Best Practices.mdx	
@@ -153,12 +153,12 @@ type BreakpointArray<T> = [
   T?, // sm
   T?, // md
   T?, // lg
-  T? // xl
+  T?, // xl
   T?, // c_xs
   T?, // c_sm
   T?, // c_md
   T?, // c_lg
-  T? // c_xl
+  T?, // c_xl
 ];
 
 type SystemProp<T> = T | BreakpointMap<T> | BreakpointArray<T>;
@@ -170,16 +170,13 @@ type SystemProp<T> = T | BreakpointMap<T> | BreakpointArray<T>;
 import { Box } from '@codecademy/gamut';
 
 // Object Syntax
-<Box width={{ _: "100%", sm: "50%" }} />
+<Box width={{ _: '100%', sm: '50%' }} />
 
 // Array Syntax
-<Box width={["100%", ,"50%"]} />
+<Box width={['100%', , '50%']} />
 ```
 
-<Callout
-  text="If you wish to skip a breakpoint in using the
-    array shorthand you may specify undefined at the index."
-/>
+<Callout text="If you wish to skip a breakpoint when using the array shorthand you may specify undefined at the index." />
 
 ## Real-world use cases
 
diff --git a/packages/variance/src/types/config.ts b/packages/variance/src/types/config.ts
index c4dc0be88eb..a6193bc9ec6 100644
--- a/packages/variance/src/types/config.ts
+++ b/packages/variance/src/types/config.ts
@@ -81,7 +81,7 @@ export type Scale<Config extends Prop> = ResponsiveProp<
 
 export interface TransformFn<P extends string, Config extends Prop> {
   (
-    value: Scale<Config> | Scale<Config>,
+    value: Scale<Config>,
     prop: P,
     props: ThemeProps<{ [K in P]?: Scale<Config> }>
   ): CSSObject;
diff --git a/packages/variance/src/utils/responsive.ts b/packages/variance/src/utils/responsive.ts
index e9348b0f5fe..69cdbb518f5 100644
--- a/packages/variance/src/utils/responsive.ts
+++ b/packages/variance/src/utils/responsive.ts
@@ -29,7 +29,7 @@ const BREAKPOINT_KEYS = [
  * Destructures the themes breakpoints into an ordered structure to traverse
  */
 export const parseBreakpoints = (
-  breakpoints?: Breakpoints | undefined
+  breakpoints?: Breakpoints
 ): BreakpointCache | null => {
   if (breakpoints === undefined) return null;
   const { xs, sm, md, lg, xl, c_base, c_xs, c_sm, c_md, c_lg, c_xl } =
diff --git a/yarn.lock b/yarn.lock
index cd710a00a5d..be76f46b70c 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -49,18 +49,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/code-frame@npm:^7.0.0, @babel/code-frame@npm:^7.10.4, @babel/code-frame@npm:^7.12.13, @babel/code-frame@npm:^7.16.7, @babel/code-frame@npm:^7.24.7, @babel/code-frame@npm:^7.27.1":
-  version: 7.27.1
-  resolution: "@babel/code-frame@npm:7.27.1"
-  dependencies:
-    "@babel/helper-validator-identifier": "npm:^7.27.1"
-    js-tokens: "npm:^4.0.0"
-    picocolors: "npm:^1.1.1"
-  checksum: 10c0/5dd9a18baa5fce4741ba729acc3a3272c49c25cb8736c4b18e113099520e7ef7b545a4096a26d600e4416157e63e87d66db46aa3fbf0a5f2286da2705c12da00
-  languageName: node
-  linkType: hard
-
-"@babel/code-frame@npm:^7.21.4":
+"@babel/code-frame@npm:^7.0.0, @babel/code-frame@npm:^7.10.4, @babel/code-frame@npm:^7.12.13, @babel/code-frame@npm:^7.16.7, @babel/code-frame@npm:^7.21.4, @babel/code-frame@npm:^7.24.7, @babel/code-frame@npm:^7.27.1":
   version: 7.29.0
   resolution: "@babel/code-frame@npm:7.29.0"
   dependencies:
@@ -323,14 +312,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-validator-identifier@npm:^7.25.9, @babel/helper-validator-identifier@npm:^7.27.1":
-  version: 7.27.1
-  resolution: "@babel/helper-validator-identifier@npm:7.27.1"
-  checksum: 10c0/c558f11c4871d526498e49d07a84752d1800bf72ac0d3dad100309a2eaba24efbf56ea59af5137ff15e3a00280ebe588560534b0e894a4750f8b1411d8f78b84
-  languageName: node
-  linkType: hard
-
-"@babel/helper-validator-identifier@npm:^7.28.5":
+"@babel/helper-validator-identifier@npm:^7.25.9, @babel/helper-validator-identifier@npm:^7.27.1, @babel/helper-validator-identifier@npm:^7.28.5":
   version: 7.28.5
   resolution: "@babel/helper-validator-identifier@npm:7.28.5"
   checksum: 10c0/42aaebed91f739a41f3d80b72752d1f95fd7c72394e8e4bd7cdd88817e0774d80a432451bcba17c2c642c257c483bf1d409dd4548883429ea9493a3bc4ab0847
@@ -2384,18 +2366,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@eslint-community/eslint-utils@npm:^4.2.0":
-  version: 4.4.1
-  resolution: "@eslint-community/eslint-utils@npm:4.4.1"
-  dependencies:
-    eslint-visitor-keys: "npm:^3.4.3"
-  peerDependencies:
-    eslint: ^6.0.0 || ^7.0.0 || >=8.0.0
-  checksum: 10c0/2aa0ac2fc50ff3f234408b10900ed4f1a0b19352f21346ad4cc3d83a1271481bdda11097baa45d484dd564c895e0762a27a8240be7a256b3ad47129e96528252
-  languageName: node
-  linkType: hard
-
-"@eslint-community/eslint-utils@npm:^4.9.1":
+"@eslint-community/eslint-utils@npm:^4.2.0, @eslint-community/eslint-utils@npm:^4.9.1":
   version: 4.9.1
   resolution: "@eslint-community/eslint-utils@npm:4.9.1"
   dependencies:
@@ -2406,20 +2377,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@eslint-community/regexpp@npm:^4.12.2":
+"@eslint-community/regexpp@npm:^4.12.2, @eslint-community/regexpp@npm:^4.6.1":
   version: 4.12.2
   resolution: "@eslint-community/regexpp@npm:4.12.2"
   checksum: 10c0/fddcbc66851b308478d04e302a4d771d6917a0b3740dc351513c0da9ca2eab8a1adf99f5e0aa7ab8b13fa0df005c81adeee7e63a92f3effd7d367a163b721c2d
   languageName: node
   linkType: hard
 
-"@eslint-community/regexpp@npm:^4.6.1":
-  version: 4.12.1
-  resolution: "@eslint-community/regexpp@npm:4.12.1"
-  checksum: 10c0/a03d98c246bcb9109aec2c08e4d10c8d010256538dcb3f56610191607214523d4fb1b00aa81df830b6dffb74c5fa0be03642513a289c567949d3e550ca11cdf6
-  languageName: node
-  linkType: hard
-
 "@eslint/eslintrc@npm:^2.1.4":
   version: 2.1.4
   resolution: "@eslint/eslintrc@npm:2.1.4"
@@ -2618,22 +2582,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@isaacs/balanced-match@npm:^4.0.1":
-  version: 4.0.1
-  resolution: "@isaacs/balanced-match@npm:4.0.1"
-  checksum: 10c0/7da011805b259ec5c955f01cee903da72ad97c5e6f01ca96197267d3f33103d5b2f8a1af192140f3aa64526c593c8d098ae366c2b11f7f17645d12387c2fd420
-  languageName: node
-  linkType: hard
-
-"@isaacs/brace-expansion@npm:^5.0.0":
-  version: 5.0.0
-  resolution: "@isaacs/brace-expansion@npm:5.0.0"
-  dependencies:
-    "@isaacs/balanced-match": "npm:^4.0.1"
-  checksum: 10c0/b4d4812f4be53afc2c5b6c545001ff7a4659af68d4484804e9d514e183d20269bb81def8682c01a22b17c4d6aed14292c8494f7d2ac664e547101c1a905aa977
-  languageName: node
-  linkType: hard
-
 "@isaacs/cliui@npm:^8.0.2":
   version: 8.0.2
   resolution: "@isaacs/cliui@npm:8.0.2"
@@ -8305,16 +8253,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/node@npm:*":
-  version: 22.8.1
-  resolution: "@types/node@npm:22.8.1"
-  dependencies:
-    undici-types: "npm:~6.19.8"
-  checksum: 10c0/83550fdf72a7db5b55eceac3f4fb038844eaee20202bdd2297a8248370cfa08317bda1605b781a8043eda4f173b75e73632e652fc85509eb14dfef78fa17337f
-  languageName: node
-  linkType: hard
-
-"@types/node@npm:^22.0.0":
+"@types/node@npm:*, @types/node@npm:^22.0.0":
   version: 22.19.15
   resolution: "@types/node@npm:22.19.15"
   dependencies:
@@ -9157,7 +9096,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"acorn@npm:^8.0.0, acorn@npm:^8.15.0":
+"acorn@npm:^8.0.0, acorn@npm:^8.1.0, acorn@npm:^8.11.0, acorn@npm:^8.14.0, acorn@npm:^8.15.0, acorn@npm:^8.4.1, acorn@npm:^8.8.1, acorn@npm:^8.8.2, acorn@npm:^8.9.0":
   version: 8.16.0
   resolution: "acorn@npm:8.16.0"
   bin:
@@ -9166,15 +9105,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"acorn@npm:^8.1.0, acorn@npm:^8.11.0, acorn@npm:^8.14.0, acorn@npm:^8.4.1, acorn@npm:^8.8.1, acorn@npm:^8.8.2, acorn@npm:^8.9.0":
-  version: 8.15.0
-  resolution: "acorn@npm:8.15.0"
-  bin:
-    acorn: bin/acorn
-  checksum: 10c0/dec73ff59b7d6628a01eebaece7f2bdb8bb62b9b5926dcad0f8931f2b8b79c2be21f6c68ac095592adb5adb15831a3635d9343e6a91d028bbe85d564875ec3ec
-  languageName: node
-  linkType: hard
-
 "add-stream@npm:^1.0.0":
   version: 1.0.0
   resolution: "add-stream@npm:1.0.0"
@@ -9454,17 +9384,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"array-buffer-byte-length@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "array-buffer-byte-length@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.5"
-    is-array-buffer: "npm:^3.0.4"
-  checksum: 10c0/f5cdf54527cd18a3d2852ddf73df79efec03829e7373a8322ef5df2b4ef546fb365c19c71d6b42d641cb6bfe0f1a2f19bc0ece5b533295f86d7c3d522f228917
-  languageName: node
-  linkType: hard
-
-"array-buffer-byte-length@npm:^1.0.2":
+"array-buffer-byte-length@npm:^1.0.1, array-buffer-byte-length@npm:^1.0.2":
   version: 1.0.2
   resolution: "array-buffer-byte-length@npm:1.0.2"
   dependencies:
@@ -9579,19 +9499,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"array.prototype.flatmap@npm:^1.3.2":
-  version: 1.3.2
-  resolution: "array.prototype.flatmap@npm:1.3.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    define-properties: "npm:^1.2.0"
-    es-abstract: "npm:^1.22.1"
-    es-shim-unscopables: "npm:^1.0.0"
-  checksum: 10c0/67b3f1d602bb73713265145853128b1ad77cc0f9b833c7e1e056b323fbeac41a4ff1c9c99c7b9445903caea924d9ca2450578d9011913191aa88cc3c3a4b54f4
-  languageName: node
-  linkType: hard
-
-"array.prototype.flatmap@npm:^1.3.3":
+"array.prototype.flatmap@npm:^1.3.2, array.prototype.flatmap@npm:^1.3.3":
   version: 1.3.3
   resolution: "array.prototype.flatmap@npm:1.3.3"
   dependencies:
@@ -9631,22 +9539,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"arraybuffer.prototype.slice@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "arraybuffer.prototype.slice@npm:1.0.3"
-  dependencies:
-    array-buffer-byte-length: "npm:^1.0.1"
-    call-bind: "npm:^1.0.5"
-    define-properties: "npm:^1.2.1"
-    es-abstract: "npm:^1.22.3"
-    es-errors: "npm:^1.2.1"
-    get-intrinsic: "npm:^1.2.3"
-    is-array-buffer: "npm:^3.0.4"
-    is-shared-array-buffer: "npm:^1.0.2"
-  checksum: 10c0/d32754045bcb2294ade881d45140a5e52bda2321b9e98fa514797b7f0d252c4c5ab0d1edb34112652c62fa6a9398def568da63a4d7544672229afea283358c36
-  languageName: node
-  linkType: hard
-
 "arraybuffer.prototype.slice@npm:^1.0.4":
   version: 1.0.4
   resolution: "arraybuffer.prototype.slice@npm:1.0.4"
@@ -10396,20 +10288,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"call-bind@npm:^1.0.2, call-bind@npm:^1.0.5, call-bind@npm:^1.0.6, call-bind@npm:^1.0.7":
-  version: 1.0.7
-  resolution: "call-bind@npm:1.0.7"
-  dependencies:
-    es-define-property: "npm:^1.0.0"
-    es-errors: "npm:^1.3.0"
-    function-bind: "npm:^1.1.2"
-    get-intrinsic: "npm:^1.2.4"
-    set-function-length: "npm:^1.2.1"
-  checksum: 10c0/a3ded2e423b8e2a265983dba81c27e125b48eefb2655e7dfab6be597088da3d47c47976c24bc51b8fd9af1061f8f87b4ab78a314f3c77784b2ae2ba535ad8b8d
-  languageName: node
-  linkType: hard
-
-"call-bind@npm:^1.0.8":
+"call-bind@npm:^1.0.2, call-bind@npm:^1.0.7, call-bind@npm:^1.0.8":
   version: 1.0.8
   resolution: "call-bind@npm:1.0.8"
   dependencies:
@@ -10664,20 +10543,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"ci-info@npm:^4.0.0":
+"ci-info@npm:^4.0.0, ci-info@npm:^4.2.0":
   version: 4.4.0
   resolution: "ci-info@npm:4.4.0"
   checksum: 10c0/44156201545b8dde01aa8a09ee2fe9fc7a73b1bef9adbd4606c9f61c8caeeb73fb7a575c88b0443f7b4edb5ee45debaa59ed54ba5f99698339393ca01349eb3a
   languageName: node
   linkType: hard
 
-"ci-info@npm:^4.2.0":
-  version: 4.3.0
-  resolution: "ci-info@npm:4.3.0"
-  checksum: 10c0/60d3dfe95d75c01454ec1cfd5108617dd598a28a2a3e148bd7e1523c1c208b5f5a3007cafcbe293e6fd0a5a310cc32217c5dc54743eeabc0a2bec80072fc055c
-  languageName: node
-  linkType: hard
-
 "cjs-module-lexer@npm:^1.0.0, cjs-module-lexer@npm:^1.2.3":
   version: 1.4.3
   resolution: "cjs-module-lexer@npm:1.4.3"
@@ -12027,17 +11899,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"data-view-buffer@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "data-view-buffer@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.6"
-    es-errors: "npm:^1.3.0"
-    is-data-view: "npm:^1.0.1"
-  checksum: 10c0/8984119e59dbed906a11fcfb417d7d861936f16697a0e7216fe2c6c810f6b5e8f4a5281e73f2c28e8e9259027190ac4a33e2a65fdd7fa86ac06b76e838918583
-  languageName: node
-  linkType: hard
-
 "data-view-buffer@npm:^1.0.2":
   version: 1.0.2
   resolution: "data-view-buffer@npm:1.0.2"
@@ -12049,17 +11910,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"data-view-byte-length@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "data-view-byte-length@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    es-errors: "npm:^1.3.0"
-    is-data-view: "npm:^1.0.1"
-  checksum: 10c0/b7d9e48a0cf5aefed9ab7d123559917b2d7e0d65531f43b2fd95b9d3a6b46042dd3fca597c42bba384e66b70d7ad66ff23932f8367b241f53d93af42cfe04ec2
-  languageName: node
-  linkType: hard
-
 "data-view-byte-length@npm:^1.0.2":
   version: 1.0.2
   resolution: "data-view-byte-length@npm:1.0.2"
@@ -12071,17 +11921,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"data-view-byte-offset@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "data-view-byte-offset@npm:1.0.0"
-  dependencies:
-    call-bind: "npm:^1.0.6"
-    es-errors: "npm:^1.3.0"
-    is-data-view: "npm:^1.0.1"
-  checksum: 10c0/21b0d2e53fd6e20cc4257c873bf6d36d77bd6185624b84076c0a1ddaa757b49aaf076254006341d35568e89f52eecd1ccb1a502cfb620f2beca04f48a6a62a8f
-  languageName: node
-  linkType: hard
-
 "data-view-byte-offset@npm:^1.0.1":
   version: 1.0.1
   resolution: "data-view-byte-offset@npm:1.0.1"
@@ -12116,15 +11955,15 @@ __metadata:
   languageName: node
   linkType: hard
 
-"debug@npm:4, debug@npm:^4.1.0, debug@npm:^4.1.1, debug@npm:^4.3.1, debug@npm:^4.3.2, debug@npm:^4.3.3, debug@npm:^4.3.4, debug@npm:^4.3.6":
-  version: 4.4.0
-  resolution: "debug@npm:4.4.0"
+"debug@npm:4, debug@npm:^4.0.0, debug@npm:^4.1.0, debug@npm:^4.1.1, debug@npm:^4.3.1, debug@npm:^4.3.2, debug@npm:^4.3.3, debug@npm:^4.3.4, debug@npm:^4.3.6, debug@npm:^4.4.3":
+  version: 4.4.3
+  resolution: "debug@npm:4.4.3"
   dependencies:
     ms: "npm:^2.1.3"
   peerDependenciesMeta:
     supports-color:
       optional: true
-  checksum: 10c0/db94f1a182bf886f57b4755f85b3a74c39b5114b9377b7ab375dc2cfa3454f09490cc6c30f829df3fc8042bc8b8995f6567ce5cd96f3bc3688bd24027197d9de
+  checksum: 10c0/d79136ec6c83ecbefd0f6a5593da6a9c91ec4d7ddc4b54c883d6e71ec9accb5f67a1a5e96d00a328196b5b5c86d365e98d8a3a70856aaf16b4e7b1985e67f5a6
   languageName: node
   linkType: hard
 
@@ -12149,18 +11988,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"debug@npm:^4.0.0, debug@npm:^4.4.3":
-  version: 4.4.3
-  resolution: "debug@npm:4.4.3"
-  dependencies:
-    ms: "npm:^2.1.3"
-  peerDependenciesMeta:
-    supports-color:
-      optional: true
-  checksum: 10c0/d79136ec6c83ecbefd0f6a5593da6a9c91ec4d7ddc4b54c883d6e71ec9accb5f67a1a5e96d00a328196b5b5c86d365e98d8a3a70856aaf16b4e7b1985e67f5a6
-  languageName: node
-  linkType: hard
-
 "decamelize-keys@npm:^1.1.0":
   version: 1.1.1
   resolution: "decamelize-keys@npm:1.1.1"
@@ -12885,61 +12712,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-abstract@npm:^1.17.2, es-abstract@npm:^1.17.5, es-abstract@npm:^1.22.1, es-abstract@npm:^1.22.3, es-abstract@npm:^1.23.0, es-abstract@npm:^1.23.2, es-abstract@npm:^1.23.3":
-  version: 1.23.3
-  resolution: "es-abstract@npm:1.23.3"
-  dependencies:
-    array-buffer-byte-length: "npm:^1.0.1"
-    arraybuffer.prototype.slice: "npm:^1.0.3"
-    available-typed-arrays: "npm:^1.0.7"
-    call-bind: "npm:^1.0.7"
-    data-view-buffer: "npm:^1.0.1"
-    data-view-byte-length: "npm:^1.0.1"
-    data-view-byte-offset: "npm:^1.0.0"
-    es-define-property: "npm:^1.0.0"
-    es-errors: "npm:^1.3.0"
-    es-object-atoms: "npm:^1.0.0"
-    es-set-tostringtag: "npm:^2.0.3"
-    es-to-primitive: "npm:^1.2.1"
-    function.prototype.name: "npm:^1.1.6"
-    get-intrinsic: "npm:^1.2.4"
-    get-symbol-description: "npm:^1.0.2"
-    globalthis: "npm:^1.0.3"
-    gopd: "npm:^1.0.1"
-    has-property-descriptors: "npm:^1.0.2"
-    has-proto: "npm:^1.0.3"
-    has-symbols: "npm:^1.0.3"
-    hasown: "npm:^2.0.2"
-    internal-slot: "npm:^1.0.7"
-    is-array-buffer: "npm:^3.0.4"
-    is-callable: "npm:^1.2.7"
-    is-data-view: "npm:^1.0.1"
-    is-negative-zero: "npm:^2.0.3"
-    is-regex: "npm:^1.1.4"
-    is-shared-array-buffer: "npm:^1.0.3"
-    is-string: "npm:^1.0.7"
-    is-typed-array: "npm:^1.1.13"
-    is-weakref: "npm:^1.0.2"
-    object-inspect: "npm:^1.13.1"
-    object-keys: "npm:^1.1.1"
-    object.assign: "npm:^4.1.5"
-    regexp.prototype.flags: "npm:^1.5.2"
-    safe-array-concat: "npm:^1.1.2"
-    safe-regex-test: "npm:^1.0.3"
-    string.prototype.trim: "npm:^1.2.9"
-    string.prototype.trimend: "npm:^1.0.8"
-    string.prototype.trimstart: "npm:^1.0.8"
-    typed-array-buffer: "npm:^1.0.2"
-    typed-array-byte-length: "npm:^1.0.1"
-    typed-array-byte-offset: "npm:^1.0.2"
-    typed-array-length: "npm:^1.0.6"
-    unbox-primitive: "npm:^1.0.2"
-    which-typed-array: "npm:^1.1.15"
-  checksum: 10c0/d27e9afafb225c6924bee9971a7f25f20c314f2d6cb93a63cada4ac11dcf42040896a6c22e5fb8f2a10767055ed4ddf400be3b1eb12297d281726de470b75666
-  languageName: node
-  linkType: hard
-
-"es-abstract@npm:^1.23.5, es-abstract@npm:^1.23.6, es-abstract@npm:^1.23.9, es-abstract@npm:^1.24.1":
+"es-abstract@npm:^1.17.2, es-abstract@npm:^1.17.5, es-abstract@npm:^1.22.1, es-abstract@npm:^1.23.2, es-abstract@npm:^1.23.3, es-abstract@npm:^1.23.5, es-abstract@npm:^1.23.6, es-abstract@npm:^1.23.9, es-abstract@npm:^1.24.1":
   version: 1.24.1
   resolution: "es-abstract@npm:1.24.1"
   dependencies:
@@ -13015,7 +12788,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-errors@npm:^1.2.1, es-errors@npm:^1.3.0":
+"es-errors@npm:^1.3.0":
   version: 1.3.0
   resolution: "es-errors@npm:1.3.0"
   checksum: 10c0/0a61325670072f98d8ae3b914edab3559b6caa980f08054a3b872052640d91da01d38df55df797fcc916389d77fc92b8d5906cf028f4db46d7e3003abecbca85
@@ -13063,7 +12836,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-set-tostringtag@npm:^2.0.3, es-set-tostringtag@npm:^2.1.0":
+"es-set-tostringtag@npm:^2.1.0":
   version: 2.1.0
   resolution: "es-set-tostringtag@npm:2.1.0"
   dependencies:
@@ -13084,17 +12857,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-to-primitive@npm:^1.2.1":
-  version: 1.2.1
-  resolution: "es-to-primitive@npm:1.2.1"
-  dependencies:
-    is-callable: "npm:^1.1.4"
-    is-date-object: "npm:^1.0.1"
-    is-symbol: "npm:^1.0.2"
-  checksum: 10c0/0886572b8dc075cb10e50c0af62a03d03a68e1e69c388bd4f10c0649ee41b1fbb24840a1b7e590b393011b5cdbe0144b776da316762653685432df37d6de60f1
-  languageName: node
-  linkType: hard
-
 "es-to-primitive@npm:^1.3.0":
   version: 1.3.0
   resolution: "es-to-primitive@npm:1.3.0"
@@ -14058,18 +13820,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"fdir@npm:^6.4.4":
-  version: 6.4.4
-  resolution: "fdir@npm:6.4.4"
-  peerDependencies:
-    picomatch: ^3 || ^4
-  peerDependenciesMeta:
-    picomatch:
-      optional: true
-  checksum: 10c0/6ccc33be16945ee7bc841e1b4178c0b4cf18d3804894cb482aa514651c962a162f96da7ffc6ebfaf0df311689fb70091b04dd6caffe28d56b9ebdc0e7ccadfdd
-  languageName: node
-  linkType: hard
-
 "fdir@npm:^6.5.0":
   version: 6.5.0
   resolution: "fdir@npm:6.5.0"
@@ -14294,16 +14044,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"for-each@npm:^0.3.3":
-  version: 0.3.3
-  resolution: "for-each@npm:0.3.3"
-  dependencies:
-    is-callable: "npm:^1.1.3"
-  checksum: 10c0/22330d8a2db728dbf003ec9182c2d421fbcd2969b02b4f97ec288721cda63eb28f2c08585ddccd0f77cb2930af8d958005c9e72f47141dc51816127a118f39aa
-  languageName: node
-  linkType: hard
-
-"for-each@npm:^0.3.5":
+"for-each@npm:^0.3.3, for-each@npm:^0.3.5":
   version: 0.3.5
   resolution: "for-each@npm:0.3.5"
   dependencies:
@@ -14565,19 +14306,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"function.prototype.name@npm:^1.1.6":
-  version: 1.1.6
-  resolution: "function.prototype.name@npm:1.1.6"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    define-properties: "npm:^1.2.0"
-    es-abstract: "npm:^1.22.1"
-    functions-have-names: "npm:^1.2.3"
-  checksum: 10c0/9eae11294905b62cb16874adb4fc687927cda3162285e0ad9612e6a1d04934005d46907362ea9cdb7428edce05a2f2c3dabc3b2d21e9fd343e9bb278230ad94b
-  languageName: node
-  linkType: hard
-
-"function.prototype.name@npm:^1.1.8":
+"function.prototype.name@npm:^1.1.6, function.prototype.name@npm:^1.1.8":
   version: 1.1.8
   resolution: "function.prototype.name@npm:1.1.8"
   dependencies:
@@ -14739,25 +14468,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"get-intrinsic@npm:^1.2.1, get-intrinsic@npm:^1.2.3, get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.6":
-  version: 1.3.0
-  resolution: "get-intrinsic@npm:1.3.0"
-  dependencies:
-    call-bind-apply-helpers: "npm:^1.0.2"
-    es-define-property: "npm:^1.0.1"
-    es-errors: "npm:^1.3.0"
-    es-object-atoms: "npm:^1.1.1"
-    function-bind: "npm:^1.1.2"
-    get-proto: "npm:^1.0.1"
-    gopd: "npm:^1.2.0"
-    has-symbols: "npm:^1.1.0"
-    hasown: "npm:^2.0.2"
-    math-intrinsics: "npm:^1.1.0"
-  checksum: 10c0/52c81808af9a8130f581e6a6a83e1ba4a9f703359e7a438d1369a5267a25412322f03dcbd7c549edaef0b6214a0630a28511d7df0130c93cfd380f4fa0b5b66a
-  languageName: node
-  linkType: hard
-
-"get-intrinsic@npm:^1.2.5, get-intrinsic@npm:^1.2.7, get-intrinsic@npm:^1.3.0":
+"get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.5, get-intrinsic@npm:^1.2.6, get-intrinsic@npm:^1.2.7, get-intrinsic@npm:^1.3.0":
   version: 1.3.1
   resolution: "get-intrinsic@npm:1.3.1"
   dependencies:
@@ -14837,17 +14548,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"get-symbol-description@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "get-symbol-description@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.5"
-    es-errors: "npm:^1.3.0"
-    get-intrinsic: "npm:^1.2.4"
-  checksum: 10c0/867be6d63f5e0eb026cb3b0ef695ec9ecf9310febb041072d2e142f260bd91ced9eeb426b3af98791d1064e324e653424afa6fd1af17dee373bea48ae03162bc
-  languageName: node
-  linkType: hard
-
 "get-symbol-description@npm:^1.1.0":
   version: 1.1.0
   resolution: "get-symbol-description@npm:1.1.0"
@@ -15006,7 +14706,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"glob@npm:^10.0.0":
+"glob@npm:^10.0.0, glob@npm:^10.2.2, glob@npm:^10.3.10":
   version: 10.5.0
   resolution: "glob@npm:10.5.0"
   dependencies:
@@ -15022,22 +14722,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"glob@npm:^10.2.2, glob@npm:^10.3.10":
-  version: 10.4.5
-  resolution: "glob@npm:10.4.5"
-  dependencies:
-    foreground-child: "npm:^3.1.0"
-    jackspeak: "npm:^3.1.2"
-    minimatch: "npm:^9.0.4"
-    minipass: "npm:^7.1.2"
-    package-json-from-dist: "npm:^1.0.0"
-    path-scurry: "npm:^1.11.1"
-  bin:
-    glob: dist/esm/bin.mjs
-  checksum: 10c0/19a9759ea77b8e3ca0a43c2f07ecddc2ad46216b786bb8f993c445aee80d345925a21e5280c7b7c6c59e860a0154b84e4b2b60321fea92cd3c56b4a7489f160e
-  languageName: node
-  linkType: hard
-
 "glob@npm:^13.0.0":
   version: 13.0.0
   resolution: "glob@npm:13.0.0"
@@ -15128,7 +14812,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"globalthis@npm:^1.0.3, globalthis@npm:^1.0.4":
+"globalthis@npm:^1.0.4":
   version: 1.0.4
   resolution: "globalthis@npm:1.0.4"
   dependencies:
@@ -15268,7 +14952,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"has-bigints@npm:^1.0.1, has-bigints@npm:^1.0.2":
+"has-bigints@npm:^1.0.2":
   version: 1.0.2
   resolution: "has-bigints@npm:1.0.2"
   checksum: 10c0/724eb1485bfa3cdff6f18d95130aa190561f00b3fcf9f19dc640baf8176b5917c143b81ec2123f8cddb6c05164a198c94b13e1377c497705ccc8e1a80306e83b
@@ -15298,13 +14982,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"has-proto@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "has-proto@npm:1.0.3"
-  checksum: 10c0/35a6989f81e9f8022c2f4027f8b48a552de714938765d019dbea6bb547bd49ce5010a3c7c32ec6ddac6e48fc546166a3583b128f5a7add8b058a6d8b4afec205
-  languageName: node
-  linkType: hard
-
 "has-proto@npm:^1.2.0":
   version: 1.2.0
   resolution: "has-proto@npm:1.2.0"
@@ -15314,7 +14991,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"has-symbols@npm:^1.0.1, has-symbols@npm:^1.0.2, has-symbols@npm:^1.0.3, has-symbols@npm:^1.1.0":
+"has-symbols@npm:^1.0.1, has-symbols@npm:^1.0.3, has-symbols@npm:^1.1.0":
   version: 1.1.0
   resolution: "has-symbols@npm:1.1.0"
   checksum: 10c0/dde0a734b17ae51e84b10986e651c664379018d10b91b6b0e9b293eddb32f0f069688c841fb40f19e9611546130153e0a2a48fd7f512891fb000ddfa36f5a20e
@@ -16025,17 +15702,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"internal-slot@npm:^1.0.7":
-  version: 1.0.7
-  resolution: "internal-slot@npm:1.0.7"
-  dependencies:
-    es-errors: "npm:^1.3.0"
-    hasown: "npm:^2.0.0"
-    side-channel: "npm:^1.0.4"
-  checksum: 10c0/f8b294a4e6ea3855fc59551bbf35f2b832cf01fd5e6e2a97f5c201a071cc09b49048f856e484b67a6c721da5e55736c5b6ddafaf19e2dbeb4a3ff1821680de6c
-  languageName: node
-  linkType: hard
-
 "internal-slot@npm:^1.1.0":
   version: 1.1.0
   resolution: "internal-slot@npm:1.1.0"
@@ -16116,17 +15782,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-array-buffer@npm:^3.0.4":
-  version: 3.0.4
-  resolution: "is-array-buffer@npm:3.0.4"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    get-intrinsic: "npm:^1.2.1"
-  checksum: 10c0/42a49d006cc6130bc5424eae113e948c146f31f9d24460fc0958f855d9d810e6fd2e4519bf19aab75179af9c298ea6092459d8cafdec523cd19e529b26eab860
-  languageName: node
-  linkType: hard
-
-"is-array-buffer@npm:^3.0.5":
+"is-array-buffer@npm:^3.0.4, is-array-buffer@npm:^3.0.5":
   version: 3.0.5
   resolution: "is-array-buffer@npm:3.0.5"
   dependencies:
@@ -16153,15 +15809,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-bigint@npm:^1.0.1":
-  version: 1.0.4
-  resolution: "is-bigint@npm:1.0.4"
-  dependencies:
-    has-bigints: "npm:^1.0.1"
-  checksum: 10c0/eb9c88e418a0d195ca545aff2b715c9903d9b0a5033bc5922fec600eb0c3d7b1ee7f882dbf2e0d5a6e694e42391be3683e4368737bd3c4a77f8ac293e7773696
-  languageName: node
-  linkType: hard
-
 "is-bigint@npm:^1.1.0":
   version: 1.1.0
   resolution: "is-bigint@npm:1.1.0"
@@ -16180,16 +15827,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-boolean-object@npm:^1.1.0":
-  version: 1.1.2
-  resolution: "is-boolean-object@npm:1.1.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/6090587f8a8a8534c0f816da868bc94f32810f08807aa72fa7e79f7e11c466d281486ffe7a788178809c2aa71fe3e700b167fe80dd96dad68026bfff8ebf39f7
-  languageName: node
-  linkType: hard
-
 "is-boolean-object@npm:^1.2.1":
   version: 1.2.2
   resolution: "is-boolean-object@npm:1.2.2"
@@ -16200,7 +15837,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-callable@npm:^1.1.3, is-callable@npm:^1.1.4, is-callable@npm:^1.2.7":
+"is-callable@npm:^1.2.7":
   version: 1.2.7
   resolution: "is-callable@npm:1.2.7"
   checksum: 10c0/ceebaeb9d92e8adee604076971dd6000d38d6afc40bb843ea8e45c5579b57671c3f3b50d7f04869618242c6cee08d1b67806a8cb8edaaaf7c0748b3720d6066f
@@ -16227,16 +15864,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-data-view@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "is-data-view@npm:1.0.1"
-  dependencies:
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/a3e6ec84efe303da859107aed9b970e018e2bee7ffcb48e2f8096921a493608134240e672a2072577e5f23a729846241d9634806e8a0e51d9129c56d5f65442d
-  languageName: node
-  linkType: hard
-
-"is-data-view@npm:^1.0.2":
+"is-data-view@npm:^1.0.1, is-data-view@npm:^1.0.2":
   version: 1.0.2
   resolution: "is-data-view@npm:1.0.2"
   dependencies:
@@ -16247,16 +15875,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-date-object@npm:^1.0.1, is-date-object@npm:^1.0.5":
-  version: 1.0.5
-  resolution: "is-date-object@npm:1.0.5"
-  dependencies:
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/eed21e5dcc619c48ccef804dfc83a739dbb2abee6ca202838ee1bd5f760fe8d8a93444f0d49012ad19bb7c006186e2884a1b92f6e1c056da7fd23d0a9ad5992e
-  languageName: node
-  linkType: hard
-
-"is-date-object@npm:^1.1.0":
+"is-date-object@npm:^1.0.5, is-date-object@npm:^1.1.0":
   version: 1.1.0
   resolution: "is-date-object@npm:1.1.0"
   dependencies:
@@ -16413,15 +16032,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-number-object@npm:^1.0.4":
-  version: 1.0.7
-  resolution: "is-number-object@npm:1.0.7"
-  dependencies:
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/aad266da1e530f1804a2b7bd2e874b4869f71c98590b3964f9d06cc9869b18f8d1f4778f838ecd2a11011bce20aeecb53cb269ba916209b79c24580416b74b1b
-  languageName: node
-  linkType: hard
-
 "is-number-object@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-number-object@npm:1.1.1"
@@ -16513,16 +16123,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-regex@npm:^1.1.4":
-  version: 1.1.4
-  resolution: "is-regex@npm:1.1.4"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/bb72aae604a69eafd4a82a93002058c416ace8cde95873589a97fc5dac96a6c6c78a9977d487b7b95426a8f5073969124dd228f043f9f604f041f32fcc465fc1
-  languageName: node
-  linkType: hard
-
 "is-regex@npm:^1.2.1":
   version: 1.2.1
   resolution: "is-regex@npm:1.2.1"
@@ -16542,15 +16142,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-shared-array-buffer@npm:^1.0.2, is-shared-array-buffer@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "is-shared-array-buffer@npm:1.0.3"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-  checksum: 10c0/adc11ab0acbc934a7b9e5e9d6c588d4ec6682f6fea8cda5180721704fa32927582ede5b123349e32517fdadd07958973d24716c80e7ab198970c47acc09e59c7
-  languageName: node
-  linkType: hard
-
 "is-shared-array-buffer@npm:^1.0.4":
   version: 1.0.4
   resolution: "is-shared-array-buffer@npm:1.0.4"
@@ -16590,16 +16181,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-string@npm:^1.0.5, is-string@npm:^1.0.7":
-  version: 1.0.7
-  resolution: "is-string@npm:1.0.7"
-  dependencies:
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/905f805cbc6eedfa678aaa103ab7f626aac9ebbdc8737abb5243acaa61d9820f8edc5819106b8fcd1839e33db21de9f0116ae20de380c8382d16dc2a601921f6
-  languageName: node
-  linkType: hard
-
-"is-string@npm:^1.1.1":
+"is-string@npm:^1.0.7, is-string@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-string@npm:1.1.1"
   dependencies:
@@ -16609,15 +16191,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-symbol@npm:^1.0.2, is-symbol@npm:^1.0.3":
-  version: 1.0.4
-  resolution: "is-symbol@npm:1.0.4"
-  dependencies:
-    has-symbols: "npm:^1.0.2"
-  checksum: 10c0/9381dd015f7c8906154dbcbf93fad769de16b4b961edc94f88d26eb8c555935caa23af88bda0c93a18e65560f6d7cca0fd5a3f8a8e1df6f1abbb9bead4502ef7
-  languageName: node
-  linkType: hard
-
 "is-symbol@npm:^1.0.4, is-symbol@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-symbol@npm:1.1.1"
@@ -16638,16 +16211,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-typed-array@npm:^1.1.13, is-typed-array@npm:^1.1.3":
-  version: 1.1.13
-  resolution: "is-typed-array@npm:1.1.13"
-  dependencies:
-    which-typed-array: "npm:^1.1.14"
-  checksum: 10c0/fa5cb97d4a80e52c2cc8ed3778e39f175a1a2ae4ddf3adae3187d69586a1fd57cfa0b095db31f66aa90331e9e3da79184cea9c6abdcd1abc722dc3c3edd51cca
-  languageName: node
-  linkType: hard
-
-"is-typed-array@npm:^1.1.14, is-typed-array@npm:^1.1.15":
+"is-typed-array@npm:^1.1.13, is-typed-array@npm:^1.1.14, is-typed-array@npm:^1.1.15, is-typed-array@npm:^1.1.3":
   version: 1.1.15
   resolution: "is-typed-array@npm:1.1.15"
   dependencies:
@@ -16670,16 +16234,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-weakref@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "is-weakref@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-  checksum: 10c0/1545c5d172cb690c392f2136c23eec07d8d78a7f57d0e41f10078aa4f5daf5d7f57b6513a67514ab4f073275ad00c9822fc8935e00229d0a2089e1c02685d4b1
-  languageName: node
-  linkType: hard
-
-"is-weakref@npm:^1.1.1":
+"is-weakref@npm:^1.0.2, is-weakref@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-weakref@npm:1.1.1"
   dependencies:
@@ -19539,12 +19094,12 @@ __metadata:
   languageName: node
   linkType: hard
 
-"minimatch@npm:*, minimatch@npm:^10.1.1":
-  version: 10.1.1
-  resolution: "minimatch@npm:10.1.1"
+"minimatch@npm:*, minimatch@npm:^10.1.1, minimatch@npm:^10.2.2":
+  version: 10.2.4
+  resolution: "minimatch@npm:10.2.4"
   dependencies:
-    "@isaacs/brace-expansion": "npm:^5.0.0"
-  checksum: 10c0/c85d44821c71973d636091fddbfbffe62370f5ee3caf0241c5b60c18cd289e916200acb2361b7e987558cd06896d153e25d505db9fc1e43e6b4b6752e2702902
+    brace-expansion: "npm:^5.0.2"
+  checksum: 10c0/35f3dfb7b99b51efd46afd378486889f590e7efb10e0f6a10ba6800428cf65c9a8dedb74427d0570b318d749b543dc4e85f06d46d2858bc8cac7e1eb49a95945
   languageName: node
   linkType: hard
 
@@ -19566,15 +19121,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"minimatch@npm:^10.2.2":
-  version: 10.2.4
-  resolution: "minimatch@npm:10.2.4"
-  dependencies:
-    brace-expansion: "npm:^5.0.2"
-  checksum: 10c0/35f3dfb7b99b51efd46afd378486889f590e7efb10e0f6a10ba6800428cf65c9a8dedb74427d0570b318d749b543dc4e85f06d46d2858bc8cac7e1eb49a95945
-  languageName: node
-  linkType: hard
-
 "minimatch@npm:^3.0.4, minimatch@npm:^3.0.5, minimatch@npm:^3.1.1, minimatch@npm:^3.1.2":
   version: 3.1.2
   resolution: "minimatch@npm:3.1.2"
@@ -20636,13 +20182,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object-inspect@npm:^1.13.1":
-  version: 1.13.2
-  resolution: "object-inspect@npm:1.13.2"
-  checksum: 10c0/b97835b4c91ec37b5fd71add84f21c3f1047d1d155d00c0fcd6699516c256d4fcc6ff17a1aced873197fe447f91a3964178fd2a67a1ee2120cdaf60e81a050b4
-  languageName: node
-  linkType: hard
-
 "object-inspect@npm:^1.13.3, object-inspect@npm:^1.13.4":
   version: 1.13.4
   resolution: "object-inspect@npm:1.13.4"
@@ -20657,19 +20196,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object.assign@npm:^4.1.4, object.assign@npm:^4.1.5":
-  version: 4.1.5
-  resolution: "object.assign@npm:4.1.5"
-  dependencies:
-    call-bind: "npm:^1.0.5"
-    define-properties: "npm:^1.2.1"
-    has-symbols: "npm:^1.0.3"
-    object-keys: "npm:^1.1.1"
-  checksum: 10c0/60108e1fa2706f22554a4648299b0955236c62b3685c52abf4988d14fffb0e7731e00aa8c6448397e3eb63d087dcc124a9f21e1980f36d0b2667f3c18bacd469
-  languageName: node
-  linkType: hard
-
-"object.assign@npm:^4.1.7":
+"object.assign@npm:^4.1.4, object.assign@npm:^4.1.7":
   version: 4.1.7
   resolution: "object.assign@npm:4.1.7"
   dependencies:
@@ -20733,18 +20260,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object.values@npm:^1.1.0, object.values@npm:^1.1.6, object.values@npm:^1.2.0":
-  version: 1.2.0
-  resolution: "object.values@npm:1.2.0"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/15809dc40fd6c5529501324fec5ff08570b7d70fb5ebbe8e2b3901afec35cf2b3dc484d1210c6c642cd3e7e0a5e18dd1d6850115337fef46bdae14ab0cb18ac3
-  languageName: node
-  linkType: hard
-
-"object.values@npm:^1.2.1":
+"object.values@npm:^1.1.0, object.values@npm:^1.1.6, object.values@npm:^1.2.0, object.values@npm:^1.2.1":
   version: 1.2.1
   resolution: "object.values@npm:1.2.1"
   dependencies:
@@ -21398,7 +20914,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"picomatch@npm:4.0.2, picomatch@npm:^4.0.2":
+"picomatch@npm:4.0.2":
   version: 4.0.2
   resolution: "picomatch@npm:4.0.2"
   checksum: 10c0/7c51f3ad2bb42c776f49ebf964c644958158be30d0a510efd5a395e8d49cb5acfed5b82c0c5b365523ce18e6ab85013c9ebe574f60305892ec3fa8eee8304ccc
@@ -21412,7 +20928,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"picomatch@npm:^4.0.3":
+"picomatch@npm:^4.0.2, picomatch@npm:^4.0.3":
   version: 4.0.4
   resolution: "picomatch@npm:4.0.4"
   checksum: 10c0/e2c6023372cc7b5764719a5ffb9da0f8e781212fa7ca4bd0562db929df8e117460f00dff3cb7509dacfc06b86de924b247f504d0ce1806a37fac4633081466b0
@@ -23274,18 +22790,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"regexp.prototype.flags@npm:^1.5.2":
-  version: 1.5.3
-  resolution: "regexp.prototype.flags@npm:1.5.3"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-errors: "npm:^1.3.0"
-    set-function-name: "npm:^2.0.2"
-  checksum: 10c0/e1a7c7dc42cc91abf73e47a269c4b3a8f225321b7f617baa25821f6a123a91d23a73b5152f21872c566e699207e1135d075d2251cd3e84cc96d82a910adf6020
-  languageName: node
-  linkType: hard
-
 "regexp.prototype.flags@npm:^1.5.3, regexp.prototype.flags@npm:^1.5.4":
   version: 1.5.4
   resolution: "regexp.prototype.flags@npm:1.5.4"
@@ -23785,19 +23289,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"safe-array-concat@npm:^1.1.2":
-  version: 1.1.2
-  resolution: "safe-array-concat@npm:1.1.2"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    get-intrinsic: "npm:^1.2.4"
-    has-symbols: "npm:^1.0.3"
-    isarray: "npm:^2.0.5"
-  checksum: 10c0/12f9fdb01c8585e199a347eacc3bae7b5164ae805cdc8c6707199dbad5b9e30001a50a43c4ee24dc9ea32dbb7279397850e9208a7e217f4d8b1cf5d90129dec9
-  languageName: node
-  linkType: hard
-
-"safe-array-concat@npm:^1.1.3":
+"safe-array-concat@npm:^1.1.2, safe-array-concat@npm:^1.1.3":
   version: 1.1.3
   resolution: "safe-array-concat@npm:1.1.3"
   dependencies:
@@ -23841,18 +23333,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"safe-regex-test@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "safe-regex-test@npm:1.0.3"
-  dependencies:
-    call-bind: "npm:^1.0.6"
-    es-errors: "npm:^1.3.0"
-    is-regex: "npm:^1.1.4"
-  checksum: 10c0/900bf7c98dc58f08d8523b7012b468e4eb757afa624f198902c0643d7008ba777b0bdc35810ba0b758671ce887617295fb742b3f3968991b178ceca54cb07603
-  languageName: node
-  linkType: hard
-
-"safe-regex-test@npm:^1.1.0":
+"safe-regex-test@npm:^1.0.3, safe-regex-test@npm:^1.1.0":
   version: 1.1.0
   resolution: "safe-regex-test@npm:1.1.0"
   dependencies:
@@ -24274,16 +23755,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"semver@npm:^7.0.0, semver@npm:^7.1.1, semver@npm:^7.3.4, semver@npm:^7.3.5, semver@npm:^7.3.7, semver@npm:^7.3.8, semver@npm:^7.5.3, semver@npm:^7.5.4, semver@npm:^7.6.2, semver@npm:^7.6.3, semver@npm:^7.7.2":
-  version: 7.7.2
-  resolution: "semver@npm:7.7.2"
-  bin:
-    semver: bin/semver.js
-  checksum: 10c0/aca305edfbf2383c22571cb7714f48cadc7ac95371b4b52362fb8eeffdfbc0de0669368b82b2b15978f8848f01d7114da65697e56cd8c37b0dab8c58e543f9ea
-  languageName: node
-  linkType: hard
-
-"semver@npm:^7.7.3":
+"semver@npm:^7.0.0, semver@npm:^7.1.1, semver@npm:^7.3.4, semver@npm:^7.3.5, semver@npm:^7.3.7, semver@npm:^7.3.8, semver@npm:^7.5.3, semver@npm:^7.5.4, semver@npm:^7.6.2, semver@npm:^7.6.3, semver@npm:^7.7.2, semver@npm:^7.7.3":
   version: 7.7.4
   resolution: "semver@npm:7.7.4"
   bin:
@@ -24356,7 +23828,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"set-function-length@npm:^1.2.1, set-function-length@npm:^1.2.2":
+"set-function-length@npm:^1.2.2":
   version: 1.2.2
   resolution: "set-function-length@npm:1.2.2"
   dependencies:
@@ -24488,19 +23960,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"side-channel@npm:^1.0.4, side-channel@npm:^1.0.6":
-  version: 1.0.6
-  resolution: "side-channel@npm:1.0.6"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    es-errors: "npm:^1.3.0"
-    get-intrinsic: "npm:^1.2.4"
-    object-inspect: "npm:^1.13.1"
-  checksum: 10c0/d2afd163dc733cc0a39aa6f7e39bf0c436293510dbccbff446733daeaf295857dbccf94297092ec8c53e2503acac30f0b78830876f0485991d62a90e9cad305f
-  languageName: node
-  linkType: hard
-
-"side-channel@npm:^1.1.0":
+"side-channel@npm:^1.0.6, side-channel@npm:^1.1.0":
   version: 1.1.0
   resolution: "side-channel@npm:1.1.0"
   dependencies:
@@ -25091,30 +24551,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"string.prototype.trim@npm:^1.2.9":
-  version: 1.2.9
-  resolution: "string.prototype.trim@npm:1.2.9"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-abstract: "npm:^1.23.0"
-    es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/dcef1a0fb61d255778155006b372dff8cc6c4394bc39869117e4241f41a2c52899c0d263ffc7738a1f9e61488c490b05c0427faa15151efad721e1a9fb2663c2
-  languageName: node
-  linkType: hard
-
-"string.prototype.trimend@npm:^1.0.8":
-  version: 1.0.8
-  resolution: "string.prototype.trimend@npm:1.0.8"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/0a0b54c17c070551b38e756ae271865ac6cc5f60dabf2e7e343cceae7d9b02e1a1120a824e090e79da1b041a74464e8477e2da43e2775c85392be30a6f60963c
-  languageName: node
-  linkType: hard
-
-"string.prototype.trimend@npm:^1.0.9":
+"string.prototype.trimend@npm:^1.0.8, string.prototype.trimend@npm:^1.0.9":
   version: 1.0.9
   resolution: "string.prototype.trimend@npm:1.0.9"
   dependencies:
@@ -25704,17 +25141,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"tinyglobby@npm:^0.2.12":
-  version: 0.2.14
-  resolution: "tinyglobby@npm:0.2.14"
-  dependencies:
-    fdir: "npm:^6.4.4"
-    picomatch: "npm:^4.0.2"
-  checksum: 10c0/f789ed6c924287a9b7d3612056ed0cda67306cd2c80c249fd280cf1504742b12583a2089b61f4abbd24605f390809017240e250241f09938054c9b363e51c0a6
-  languageName: node
-  linkType: hard
-
-"tinyglobby@npm:^0.2.15":
+"tinyglobby@npm:^0.2.12, tinyglobby@npm:^0.2.15":
   version: 0.2.15
   resolution: "tinyglobby@npm:0.2.15"
   dependencies:
@@ -26122,17 +25549,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-buffer@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "typed-array-buffer@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    es-errors: "npm:^1.3.0"
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/9e043eb38e1b4df4ddf9dde1aa64919ae8bb909571c1cc4490ba777d55d23a0c74c7d73afcdd29ec98616d91bb3ae0f705fad4421ea147e1daf9528200b562da
-  languageName: node
-  linkType: hard
-
 "typed-array-buffer@npm:^1.0.3":
   version: 1.0.3
   resolution: "typed-array-buffer@npm:1.0.3"
@@ -26144,19 +25560,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-byte-length@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "typed-array-byte-length@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-proto: "npm:^1.0.3"
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/fcebeffb2436c9f355e91bd19e2368273b88c11d1acc0948a2a306792f1ab672bce4cfe524ab9f51a0505c9d7cd1c98eff4235c4f6bfef6a198f6cfc4ff3d4f3
-  languageName: node
-  linkType: hard
-
 "typed-array-byte-length@npm:^1.0.3":
   version: 1.0.3
   resolution: "typed-array-byte-length@npm:1.0.3"
@@ -26170,20 +25573,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-byte-offset@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "typed-array-byte-offset@npm:1.0.2"
-  dependencies:
-    available-typed-arrays: "npm:^1.0.7"
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-proto: "npm:^1.0.3"
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/d2628bc739732072e39269389a758025f75339de2ed40c4f91357023c5512d237f255b633e3106c461ced41907c1bf9a533c7e8578066b0163690ca8bc61b22f
-  languageName: node
-  linkType: hard
-
 "typed-array-byte-offset@npm:^1.0.4":
   version: 1.0.4
   resolution: "typed-array-byte-offset@npm:1.0.4"
@@ -26199,20 +25588,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-length@npm:^1.0.6":
-  version: 1.0.6
-  resolution: "typed-array-length@npm:1.0.6"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-proto: "npm:^1.0.3"
-    is-typed-array: "npm:^1.1.13"
-    possible-typed-array-names: "npm:^1.0.0"
-  checksum: 10c0/74253d7dc488eb28b6b2711cf31f5a9dcefc9c41b0681fd1c178ed0a1681b4468581a3626d39cd4df7aee3d3927ab62be06aa9ca74e5baf81827f61641445b77
-  languageName: node
-  linkType: hard
-
 "typed-array-length@npm:^1.0.7":
   version: 1.0.7
   resolution: "typed-array-length@npm:1.0.7"
@@ -26241,7 +25616,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typescript@npm:5.9.3":
+"typescript@npm:5.9.3, typescript@npm:>=3 < 6":
   version: 5.9.3
   resolution: "typescript@npm:5.9.3"
   bin:
@@ -26251,7 +25626,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typescript@npm:>=3 < 6, typescript@npm:~5.8.2":
+"typescript@npm:~5.8.2":
   version: 5.8.3
   resolution: "typescript@npm:5.8.3"
   bin:
@@ -26261,7 +25636,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typescript@patch:typescript@npm%3A5.9.3#optional!builtin<compat/typescript>":
+"typescript@patch:typescript@npm%3A5.9.3#optional!builtin<compat/typescript>, typescript@patch:typescript@npm%3A>=3 < 6#optional!builtin<compat/typescript>":
   version: 5.9.3
   resolution: "typescript@patch:typescript@npm%3A5.9.3#optional!builtin<compat/typescript>::version=5.9.3&hash=5786d5"
   bin:
@@ -26271,7 +25646,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typescript@patch:typescript@npm%3A>=3 < 6#optional!builtin<compat/typescript>, typescript@patch:typescript@npm%3A~5.8.2#optional!builtin<compat/typescript>":
+"typescript@patch:typescript@npm%3A~5.8.2#optional!builtin<compat/typescript>":
   version: 5.8.3
   resolution: "typescript@patch:typescript@npm%3A5.8.3#optional!builtin<compat/typescript>::version=5.8.3&hash=5786d5"
   bin:
@@ -26290,18 +25665,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"unbox-primitive@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "unbox-primitive@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    has-bigints: "npm:^1.0.2"
-    has-symbols: "npm:^1.0.3"
-    which-boxed-primitive: "npm:^1.0.2"
-  checksum: 10c0/81ca2e81134167cc8f75fa79fbcc8a94379d6c61de67090986a2273850989dd3bae8440c163121b77434b68263e34787a675cbdcb34bb2f764c6b9c843a11b66
-  languageName: node
-  linkType: hard
-
 "unbox-primitive@npm:^1.1.0":
   version: 1.1.0
   resolution: "unbox-primitive@npm:1.1.0"
@@ -26314,13 +25677,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"undici-types@npm:~6.19.8":
-  version: 6.19.8
-  resolution: "undici-types@npm:6.19.8"
-  checksum: 10c0/078afa5990fba110f6824823ace86073b4638f1d5112ee26e790155f481f2a868cc3e0615505b6f4282bdf74a3d8caad715fd809e870c2bb0704e3ea6082f344
-  languageName: node
-  linkType: hard
-
 "undici-types@npm:~6.21.0":
   version: 6.21.0
   resolution: "undici-types@npm:6.21.0"
@@ -27246,19 +26602,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"which-boxed-primitive@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "which-boxed-primitive@npm:1.0.2"
-  dependencies:
-    is-bigint: "npm:^1.0.1"
-    is-boolean-object: "npm:^1.1.0"
-    is-number-object: "npm:^1.0.4"
-    is-string: "npm:^1.0.5"
-    is-symbol: "npm:^1.0.3"
-  checksum: 10c0/0a62a03c00c91dd4fb1035b2f0733c341d805753b027eebd3a304b9cb70e8ce33e25317add2fe9b5fea6f53a175c0633ae701ff812e604410ddd049777cd435e
-  languageName: node
-  linkType: hard
-
 "which-boxed-primitive@npm:^1.1.0, which-boxed-primitive@npm:^1.1.1":
   version: 1.1.1
   resolution: "which-boxed-primitive@npm:1.1.1"
@@ -27305,20 +26648,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"which-typed-array@npm:^1.1.14, which-typed-array@npm:^1.1.15, which-typed-array@npm:^1.1.2":
-  version: 1.1.15
-  resolution: "which-typed-array@npm:1.1.15"
-  dependencies:
-    available-typed-arrays: "npm:^1.0.7"
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-tostringtag: "npm:^1.0.2"
-  checksum: 10c0/4465d5348c044032032251be54d8988270e69c6b7154f8fcb2a47ff706fe36f7624b3a24246b8d9089435a8f4ec48c1c1025c5d6b499456b9e5eff4f48212983
-  languageName: node
-  linkType: hard
-
-"which-typed-array@npm:^1.1.16, which-typed-array@npm:^1.1.19":
+"which-typed-array@npm:^1.1.16, which-typed-array@npm:^1.1.19, which-typed-array@npm:^1.1.2":
   version: 1.1.20
   resolution: "which-typed-array@npm:1.1.20"
   dependencies:
@@ -27607,7 +26937,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"yaml@npm:^2.0.0":
+"yaml@npm:^2.0.0, yaml@npm:^2.6.0":
   version: 2.8.3
   resolution: "yaml@npm:2.8.3"
   bin:
@@ -27616,15 +26946,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"yaml@npm:^2.6.0":
-  version: 2.7.1
-  resolution: "yaml@npm:2.7.1"
-  bin:
-    yaml: bin.mjs
-  checksum: 10c0/ee2126398ab7d1fdde566b4013b68e36930b9e6d8e68b6db356875c99614c10d678b6f45597a145ff6d63814961221fc305bf9242af8bf7450177f8a68537590
-  languageName: node
-  linkType: hard
-
 "yargs-parser@npm:20.2.4":
   version: 20.2.4
   resolution: "yargs-parser@npm:20.2.4"

From 5d52f0d0bf75cdfcfe77dd60002f9adc1fd8966c Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Wed, 25 Mar 2026 11:25:15 -0400
Subject: [PATCH 15/37] lint + format

---
 packages/eslint-plugin-gamut/src/prefer-themed.ts   |  5 +++--
 packages/gamut/src/Breadcrumbs/index.tsx            | 10 +++++-----
 packages/gamut/src/Modals/Dialog.tsx                |  4 +++-
 packages/gamut/src/Modals/Modal.tsx                 |  3 ++-
 packages/gamut/src/Tag/index.tsx                    |  4 ++--
 packages/styleguide/src/lib/Meta/Best Practices.mdx |  2 +-
 6 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/packages/eslint-plugin-gamut/src/prefer-themed.ts b/packages/eslint-plugin-gamut/src/prefer-themed.ts
index 4d376421322..ebeca764c31 100644
--- a/packages/eslint-plugin-gamut/src/prefer-themed.ts
+++ b/packages/eslint-plugin-gamut/src/prefer-themed.ts
@@ -8,13 +8,14 @@ export default createRule({
   create(context) {
     return {
       TaggedTemplateExpression(node) {
+        /* eslint-disable @typescript-eslint/no-unsafe-enum-comparison -- @typescript-eslint/types use string enums; literals match ESTree */
         if (node.tag.type === 'MemberExpression') {
           if (node.tag.object.type !== 'Identifier') return;
           const expressionVariable = node.tag.object.name;
           const arrowFuncExpression = node.quasi.expressions[0];
 
-          if (arrowFuncExpression?.type !== 'ArrowFunctionExpression')
-            return;
+          if (arrowFuncExpression?.type !== 'ArrowFunctionExpression') return;
+          /* eslint-enable @typescript-eslint/no-unsafe-enum-comparison */
 
           if (!isNamedVariableTheme(arrowFuncExpression)) return;
 
diff --git a/packages/gamut/src/Breadcrumbs/index.tsx b/packages/gamut/src/Breadcrumbs/index.tsx
index e7134094ef3..9f8c66ce9c0 100644
--- a/packages/gamut/src/Breadcrumbs/index.tsx
+++ b/packages/gamut/src/Breadcrumbs/index.tsx
@@ -36,24 +36,24 @@ const BreadcrumbPart = styled(Box)(
 
 export type Crumb = { title: string };
 
-export type ClickableCrumb<T extends string | Object> = Crumb & {
+export type ClickableCrumb<T extends string | object> = Crumb & {
   href: string;
   payload: T;
 };
 
-export type Breadcrumb<T extends string | Object> = Crumb | ClickableCrumb<T>;
+export type Breadcrumb<T extends string | object> = Crumb | ClickableCrumb<T>;
 
-export const isClickableCrumb = <T extends string | Object>(
+export const isClickableCrumb = <T extends string | object>(
   crumb: Breadcrumb<T>
 ): crumb is ClickableCrumb<T> => !!(crumb as ClickableCrumb<T>).href;
 
-export type BreadcrumbsProps<T extends string | Object> = {
+export type BreadcrumbsProps<T extends string | object> = {
   crumbs: Breadcrumb<T>[];
   onClick?: (event: React.MouseEvent, crumb: ClickableCrumb<T>) => void;
   className?: string;
 };
 
-export const Breadcrumbs = <T extends string | Object>({
+export const Breadcrumbs = <T extends string | object>({
   crumbs,
   onClick,
   className,
diff --git a/packages/gamut/src/Modals/Dialog.tsx b/packages/gamut/src/Modals/Dialog.tsx
index 4281c26f041..c5bb58d2fa2 100644
--- a/packages/gamut/src/Modals/Dialog.tsx
+++ b/packages/gamut/src/Modals/Dialog.tsx
@@ -6,6 +6,7 @@ import { Box } from '../Box';
 import { FillButton, IconButton, TextButton } from '../Button';
 import { Overlay } from '../Overlay';
 import { Text } from '../Typography';
+import { isNullish } from '../utils/nullish';
 import { ModalContainer, ModalContainerProps } from './elements';
 import { ImageContainer } from './ImageContainer';
 import { CloseButtonProps, ModalBaseProps } from './types';
@@ -66,7 +67,8 @@ export const Dialog: React.FC<DialogProps> = ({
         aria-hidden="false"
         aria-label="dialog"
         aria-labelledby={
-          typeof title === 'string' || typeof title === 'number'
+          !isNullish(title) &&
+          (typeof title === 'string' || typeof title === 'number')
             ? String(title)
             : undefined
         }
diff --git a/packages/gamut/src/Modals/Modal.tsx b/packages/gamut/src/Modals/Modal.tsx
index ed025347fda..085bc516109 100644
--- a/packages/gamut/src/Modals/Modal.tsx
+++ b/packages/gamut/src/Modals/Modal.tsx
@@ -6,6 +6,7 @@ import { Box } from '../Box';
 import { ButtonProps, FillButton, IconButton, TextButton } from '../Button';
 import { Overlay } from '../Overlay';
 import { Text } from '../Typography';
+import { isNullish } from '../utils/nullish';
 import { ModalContainer } from './elements';
 import { ImageContainer } from './ImageContainer';
 import { CloseButtonProps, ModalBaseProps } from './types';
@@ -111,7 +112,7 @@ export const Modal: React.FC<ModalProps> = ({
         aria-hidden="false"
         aria-label={ariaLabel}
         aria-labelledby={
-          titleText != null &&
+          !isNullish(titleText) &&
           (typeof titleText === 'string' || typeof titleText === 'number')
             ? String(titleText)
             : undefined
diff --git a/packages/gamut/src/Tag/index.tsx b/packages/gamut/src/Tag/index.tsx
index e90b4ead3f4..76b96f95145 100644
--- a/packages/gamut/src/Tag/index.tsx
+++ b/packages/gamut/src/Tag/index.tsx
@@ -93,8 +93,8 @@ export const Tag: React.FC<TagProps> = ({
             disabled
               ? ''
               : typeof children === 'string' || typeof children === 'number'
-                ? `Dismiss ${children} Tag`
-                : 'Dismiss tag'
+              ? `Dismiss ${children} Tag`
+              : 'Dismiss tag'
           }
           disabled={disabled}
           icon={isLarge ? LargeMiniDeleteIcon : DefaultMiniDeleteIcon}
diff --git a/packages/styleguide/src/lib/Meta/Best Practices.mdx b/packages/styleguide/src/lib/Meta/Best Practices.mdx
index c6a49f05832..b04cc3f1239 100644
--- a/packages/styleguide/src/lib/Meta/Best Practices.mdx	
+++ b/packages/styleguide/src/lib/Meta/Best Practices.mdx	
@@ -158,7 +158,7 @@ type BreakpointArray<T> = [
   T?, // c_sm
   T?, // c_md
   T?, // c_lg
-  T?, // c_xl
+  T? // c_xl
 ];
 
 type SystemProp<T> = T | BreakpointMap<T> | BreakpointArray<T>;

From 7117ecc04a3bfc283e8a43421da060cab3425b0e Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Thu, 2 Apr 2026 16:59:13 -0400
Subject: [PATCH 16/37] test in ci

---
 .../src/__tests__/AssetProvider.test.tsx      |    3 -
 packages/gamut/src/BarChart/utils/hooks.ts    |    2 +-
 yarn.lock                                     | 1011 +----------------
 3 files changed, 20 insertions(+), 996 deletions(-)

diff --git a/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx b/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
index 3da949a3428..f8fe24cc464 100644
--- a/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
+++ b/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
@@ -4,11 +4,8 @@ import { render } from '@testing-library/react';
 
 import { AssetProvider, createFontLinks } from '../AssetProvider';
 import { coreTheme, percipioTheme } from '../themes';
-<<<<<<< HEAD
 import { getFontsMock } from './fontUtilsMock';
-=======
 import { setupRtl } from './testUtils';
->>>>>>> origin/main
 
 const renderView = setupRtl(AssetProvider, {});
 
diff --git a/packages/gamut/src/BarChart/utils/hooks.ts b/packages/gamut/src/BarChart/utils/hooks.ts
index 7615648926a..a255e9d8d5a 100644
--- a/packages/gamut/src/BarChart/utils/hooks.ts
+++ b/packages/gamut/src/BarChart/utils/hooks.ts
@@ -233,7 +233,7 @@ const useMeasureWidth = ({
     }
 
     const element = ref.current;
-    const width = element.getBoundingClientRect().width;
+    const { width } = element.getBoundingClientRect();
 
     if (width > 0) {
       onMeasure(width);
diff --git a/yarn.lock b/yarn.lock
index 9684cc6c51e..9d672d952d1 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -67,13 +67,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/compat-data@npm:^7.27.2":
-  version: 7.28.0
-  resolution: "@babel/compat-data@npm:7.28.0"
-  checksum: 10c0/c4e527302bcd61052423f757355a71c3bc62362bac13f7f130de16e439716f66091ff5bdecda418e8fa0271d4c725f860f0ee23ab7bf6e769f7a8bb16dfcb531
-  languageName: node
-  linkType: hard
-
 "@babel/core@npm:7.12.9":
   version: 7.12.9
   resolution: "@babel/core@npm:7.12.9"
@@ -121,30 +114,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/core@npm:^7.11.6, @babel/core@npm:^7.12.3, @babel/core@npm:^7.18.9, @babel/core@npm:^7.21.3, @babel/core@npm:^7.23.2, @babel/core@npm:^7.23.9, @babel/core@npm:^7.27.4":
-  version: 7.28.4
-  resolution: "@babel/core@npm:7.28.4"
-  dependencies:
-    "@babel/code-frame": "npm:^7.27.1"
-    "@babel/generator": "npm:^7.28.3"
-    "@babel/helper-compilation-targets": "npm:^7.27.2"
-    "@babel/helper-module-transforms": "npm:^7.28.3"
-    "@babel/helpers": "npm:^7.28.4"
-    "@babel/parser": "npm:^7.28.4"
-    "@babel/template": "npm:^7.27.2"
-    "@babel/traverse": "npm:^7.28.4"
-    "@babel/types": "npm:^7.28.4"
-    "@jridgewell/remapping": "npm:^2.3.5"
-    convert-source-map: "npm:^2.0.0"
-    debug: "npm:^4.1.0"
-    gensync: "npm:^1.0.0-beta.2"
-    json5: "npm:^2.2.3"
-    semver: "npm:^6.3.1"
-  checksum: 10c0/ef5a6c3c6bf40d3589b5593f8118cfe2602ce737412629fb6e26d595be2fcbaae0807b43027a5c42ec4fba5b895ff65891f2503b5918c8a3ea3542ab44d4c278
-  languageName: node
-  linkType: hard
-
-"@babel/core@npm:^7.22.5, @babel/core@npm:^7.26.0, @babel/core@npm:^7.28.0, @babel/core@npm:^7.7.5":
+"@babel/core@npm:^7.11.6, @babel/core@npm:^7.12.3, @babel/core@npm:^7.18.9, @babel/core@npm:^7.21.3, @babel/core@npm:^7.22.5, @babel/core@npm:^7.23.2, @babel/core@npm:^7.23.9, @babel/core@npm:^7.26.0, @babel/core@npm:^7.27.4, @babel/core@npm:^7.28.0, @babel/core@npm:^7.7.5":
   version: 7.29.0
   resolution: "@babel/core@npm:7.29.0"
   dependencies:
@@ -167,20 +137,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/generator@npm:^7.12.5, @babel/generator@npm:^7.24.7, @babel/generator@npm:^7.27.5, @babel/generator@npm:^7.28.3, @babel/generator@npm:^7.7.2":
-  version: 7.28.3
-  resolution: "@babel/generator@npm:7.28.3"
-  dependencies:
-    "@babel/parser": "npm:^7.28.3"
-    "@babel/types": "npm:^7.28.2"
-    "@jridgewell/gen-mapping": "npm:^0.3.12"
-    "@jridgewell/trace-mapping": "npm:^0.3.28"
-    jsesc: "npm:^3.0.2"
-  checksum: 10c0/0ff58bcf04f8803dcc29479b547b43b9b0b828ec1ee0668e92d79f9e90f388c28589056637c5ff2fd7bcf8d153c990d29c448d449d852bf9d1bc64753ca462bc
-  languageName: node
-  linkType: hard
-
-"@babel/generator@npm:^7.22.5, @babel/generator@npm:^7.29.0":
+"@babel/generator@npm:^7.12.5, @babel/generator@npm:^7.22.5, @babel/generator@npm:^7.24.7, @babel/generator@npm:^7.27.5, @babel/generator@npm:^7.29.0, @babel/generator@npm:^7.7.2":
   version: 7.29.1
   resolution: "@babel/generator@npm:7.29.1"
   dependencies:
@@ -225,19 +182,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-compilation-targets@npm:^7.27.2":
-  version: 7.27.2
-  resolution: "@babel/helper-compilation-targets@npm:7.27.2"
-  dependencies:
-    "@babel/compat-data": "npm:^7.27.2"
-    "@babel/helper-validator-option": "npm:^7.27.1"
-    browserslist: "npm:^4.24.0"
-    lru-cache: "npm:^5.1.1"
-    semver: "npm:^6.3.1"
-  checksum: 10c0/f338fa00dcfea931804a7c55d1a1c81b6f0a09787e528ec580d5c21b3ecb3913f6cb0f361368973ce953b824d910d3ac3e8a8ee15192710d3563826447193ad1
-  languageName: node
-  linkType: hard
-
 "@babel/helper-create-class-features-plugin@npm:^7.25.9":
   version: 7.25.9
   resolution: "@babel/helper-create-class-features-plugin@npm:7.25.9"
@@ -310,16 +254,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-module-imports@npm:^7.27.1":
-  version: 7.27.1
-  resolution: "@babel/helper-module-imports@npm:7.27.1"
-  dependencies:
-    "@babel/traverse": "npm:^7.27.1"
-    "@babel/types": "npm:^7.27.1"
-  checksum: 10c0/e00aace096e4e29290ff8648455c2bc4ed982f0d61dbf2db1b5e750b9b98f318bf5788d75a4f974c151bd318fd549e81dbcab595f46b14b81c12eda3023f51e8
-  languageName: node
-  linkType: hard
-
 "@babel/helper-module-transforms@npm:^7.12.1, @babel/helper-module-transforms@npm:^7.24.7, @babel/helper-module-transforms@npm:^7.25.9, @babel/helper-module-transforms@npm:^7.28.6":
   version: 7.28.6
   resolution: "@babel/helper-module-transforms@npm:7.28.6"
@@ -333,19 +267,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-module-transforms@npm:^7.28.3":
-  version: 7.28.3
-  resolution: "@babel/helper-module-transforms@npm:7.28.3"
-  dependencies:
-    "@babel/helper-module-imports": "npm:^7.27.1"
-    "@babel/helper-validator-identifier": "npm:^7.27.1"
-    "@babel/traverse": "npm:^7.28.3"
-  peerDependencies:
-    "@babel/core": ^7.0.0
-  checksum: 10c0/549be62515a6d50cd4cfefcab1b005c47f89bd9135a22d602ee6a5e3a01f27571868ada10b75b033569f24dc4a2bb8d04bfa05ee75c16da7ade2d0db1437fcdb
-  languageName: node
-  linkType: hard
-
 "@babel/helper-optimise-call-expression@npm:^7.25.9":
   version: 7.25.9
   resolution: "@babel/helper-optimise-call-expression@npm:7.25.9"
@@ -362,20 +283,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-plugin-utils@npm:^7.0.0, @babel/helper-plugin-utils@npm:^7.10.4, @babel/helper-plugin-utils@npm:^7.12.13, @babel/helper-plugin-utils@npm:^7.14.5, @babel/helper-plugin-utils@npm:^7.18.6, @babel/helper-plugin-utils@npm:^7.22.5, @babel/helper-plugin-utils@npm:^7.25.9, @babel/helper-plugin-utils@npm:^7.8.0":
+"@babel/helper-plugin-utils@npm:^7.0.0, @babel/helper-plugin-utils@npm:^7.10.4, @babel/helper-plugin-utils@npm:^7.12.13, @babel/helper-plugin-utils@npm:^7.14.5, @babel/helper-plugin-utils@npm:^7.18.6, @babel/helper-plugin-utils@npm:^7.22.5, @babel/helper-plugin-utils@npm:^7.25.9, @babel/helper-plugin-utils@npm:^7.27.1, @babel/helper-plugin-utils@npm:^7.8.0":
   version: 7.28.6
   resolution: "@babel/helper-plugin-utils@npm:7.28.6"
   checksum: 10c0/3f5f8acc152fdbb69a84b8624145ff4f9b9f6e776cb989f9f968f8606eb7185c5c3cfcf3ba08534e37e1e0e1c118ac67080610333f56baa4f7376c99b5f1143d
   languageName: node
   linkType: hard
 
-"@babel/helper-plugin-utils@npm:^7.27.1":
-  version: 7.27.1
-  resolution: "@babel/helper-plugin-utils@npm:7.27.1"
-  checksum: 10c0/94cf22c81a0c11a09b197b41ab488d416ff62254ce13c57e62912c85700dc2e99e555225787a4099ff6bae7a1812d622c80fbaeda824b79baa10a6c5ac4cf69b
-  languageName: node
-  linkType: hard
-
 "@babel/helper-remap-async-to-generator@npm:^7.25.9":
   version: 7.25.9
   resolution: "@babel/helper-remap-async-to-generator@npm:7.25.9"
@@ -436,13 +350,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helper-validator-identifier@npm:^7.27.1":
-  version: 7.27.1
-  resolution: "@babel/helper-validator-identifier@npm:7.27.1"
-  checksum: 10c0/c558f11c4871d526498e49d07a84752d1800bf72ac0d3dad100309a2eaba24efbf56ea59af5137ff15e3a00280ebe588560534b0e894a4750f8b1411d8f78b84
-  languageName: node
-  linkType: hard
-
 "@babel/helper-validator-option@npm:^7.25.9, @babel/helper-validator-option@npm:^7.27.1":
   version: 7.27.1
   resolution: "@babel/helper-validator-option@npm:7.27.1"
@@ -471,16 +378,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/helpers@npm:^7.28.4":
-  version: 7.28.4
-  resolution: "@babel/helpers@npm:7.28.4"
-  dependencies:
-    "@babel/template": "npm:^7.27.2"
-    "@babel/types": "npm:^7.28.4"
-  checksum: 10c0/aaa5fb8098926dfed5f223adf2c5e4c7fbba4b911b73dfec2d7d3083f8ba694d201a206db673da2d9b3ae8c01793e795767654558c450c8c14b4c2175b4fcb44
-  languageName: node
-  linkType: hard
-
 "@babel/parser@npm:^7.1.0, @babel/parser@npm:^7.12.7, @babel/parser@npm:^7.14.7, @babel/parser@npm:^7.20.7, @babel/parser@npm:^7.23.9, @babel/parser@npm:^7.24.7, @babel/parser@npm:^7.28.6, @babel/parser@npm:^7.29.0":
   version: 7.29.2
   resolution: "@babel/parser@npm:7.29.2"
@@ -492,17 +389,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/parser@npm:^7.27.2, @babel/parser@npm:^7.28.3, @babel/parser@npm:^7.28.4":
-  version: 7.28.4
-  resolution: "@babel/parser@npm:7.28.4"
-  dependencies:
-    "@babel/types": "npm:^7.28.4"
-  bin:
-    parser: ./bin/babel-parser.js
-  checksum: 10c0/58b239a5b1477ac7ed7e29d86d675cc81075ca055424eba6485872626db2dc556ce63c45043e5a679cd925e999471dba8a3ed4864e7ab1dbf64306ab72c52707
-  languageName: node
-  linkType: hard
-
 "@babel/plugin-bugfix-firefox-class-in-computed-class-key@npm:^7.25.9":
   version: 7.25.9
   resolution: "@babel/plugin-bugfix-firefox-class-in-computed-class-key@npm:7.25.9"
@@ -1639,18 +1525,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/template@npm:^7.12.7, @babel/template@npm:^7.24.7, @babel/template@npm:^7.25.9, @babel/template@npm:^7.27.2, @babel/template@npm:^7.3.3":
-  version: 7.27.2
-  resolution: "@babel/template@npm:7.27.2"
-  dependencies:
-    "@babel/code-frame": "npm:^7.27.1"
-    "@babel/parser": "npm:^7.27.2"
-    "@babel/types": "npm:^7.27.1"
-  checksum: 10c0/ed9e9022651e463cc5f2cc21942f0e74544f1754d231add6348ff1b472985a3b3502041c0be62dc99ed2d12cfae0c51394bf827452b98a2f8769c03b87aadc81
-  languageName: node
-  linkType: hard
-
-"@babel/template@npm:^7.22.5, @babel/template@npm:^7.28.6":
+"@babel/template@npm:^7.12.7, @babel/template@npm:^7.22.5, @babel/template@npm:^7.24.7, @babel/template@npm:^7.25.9, @babel/template@npm:^7.28.6, @babel/template@npm:^7.3.3":
   version: 7.28.6
   resolution: "@babel/template@npm:7.28.6"
   dependencies:
@@ -1676,32 +1551,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@babel/traverse@npm:^7.27.1, @babel/traverse@npm:^7.28.3, @babel/traverse@npm:^7.28.4":
-  version: 7.28.4
-  resolution: "@babel/traverse@npm:7.28.4"
-  dependencies:
-    "@babel/code-frame": "npm:^7.27.1"
-    "@babel/generator": "npm:^7.28.3"
-    "@babel/helper-globals": "npm:^7.28.0"
-    "@babel/parser": "npm:^7.28.4"
-    "@babel/template": "npm:^7.27.2"
-    "@babel/types": "npm:^7.28.4"
-    debug: "npm:^4.3.1"
-  checksum: 10c0/ee678fdd49c9f54a32e07e8455242390d43ce44887cea6567b233fe13907b89240c377e7633478a32c6cf1be0e17c2f7f3b0c59f0666e39c5074cc47b968489c
-  languageName: node
-  linkType: hard
-
-"@babel/types@npm:^7.0.0, @babel/types@npm:^7.12.6, @babel/types@npm:^7.12.7, @babel/types@npm:^7.18.9, @babel/types@npm:^7.20.7, @babel/types@npm:^7.21.3, @babel/types@npm:^7.24.7, @babel/types@npm:^7.25.9, @babel/types@npm:^7.27.1, @babel/types@npm:^7.27.3, @babel/types@npm:^7.28.2, @babel/types@npm:^7.28.4, @babel/types@npm:^7.3.3, @babel/types@npm:^7.4.4":
-  version: 7.28.4
-  resolution: "@babel/types@npm:7.28.4"
-  dependencies:
-    "@babel/helper-string-parser": "npm:^7.27.1"
-    "@babel/helper-validator-identifier": "npm:^7.27.1"
-  checksum: 10c0/ac6f909d6191319e08c80efbfac7bd9a25f80cc83b43cd6d82e7233f7a6b9d6e7b90236f3af7400a3f83b576895bcab9188a22b584eb0f224e80e6d4e95f4517
-  languageName: node
-  linkType: hard
-
-"@babel/types@npm:^7.22.5, @babel/types@npm:^7.28.6, @babel/types@npm:^7.29.0":
+"@babel/types@npm:^7.0.0, @babel/types@npm:^7.12.6, @babel/types@npm:^7.12.7, @babel/types@npm:^7.18.9, @babel/types@npm:^7.20.7, @babel/types@npm:^7.21.3, @babel/types@npm:^7.22.5, @babel/types@npm:^7.24.7, @babel/types@npm:^7.25.9, @babel/types@npm:^7.27.3, @babel/types@npm:^7.28.2, @babel/types@npm:^7.28.6, @babel/types@npm:^7.29.0, @babel/types@npm:^7.3.3, @babel/types@npm:^7.4.4":
   version: 7.29.0
   resolution: "@babel/types@npm:7.29.0"
   dependencies:
@@ -2686,20 +2536,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/console@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/console@npm:30.0.5"
-  dependencies:
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    chalk: "npm:^4.1.2"
-    jest-message-util: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    slash: "npm:^3.0.0"
-  checksum: 10c0/1400e9ee281dd070f543f8f8696b9aca4ba1f81d5cbfb3cae030664012ff5961c76ac2c8ccee172e416e15f88af3b10840548adbee4de0ec63100d44416b17ef
-  languageName: node
-  linkType: hard
-
 "@jest/console@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/console@npm:30.3.0"
@@ -2818,13 +2654,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/diff-sequences@npm:30.0.1":
-  version: 30.0.1
-  resolution: "@jest/diff-sequences@npm:30.0.1"
-  checksum: 10c0/3a840404e6021725ef7f86b11f7b2d13dd02846481264db0e447ee33b7ee992134e402cdc8b8b0ac969d37c6c0183044e382dedee72001cdf50cfb3c8088de74
-  languageName: node
-  linkType: hard
-
 "@jest/diff-sequences@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/diff-sequences@npm:30.3.0"
@@ -2832,18 +2661,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/environment@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/environment@npm:30.0.5"
-  dependencies:
-    "@jest/fake-timers": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    jest-mock: "npm:30.0.5"
-  checksum: 10c0/e403b6f98fa3e39dd6462fa192e3bd55e9ac9c2322ca4471b9342495913a90ecaa5fc53238d4ad8a0dca7d53aa4b9de122721234e36f3a0445031c25757a3178
-  languageName: node
-  linkType: hard
-
 "@jest/environment@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/environment@npm:30.3.0"
@@ -2868,15 +2685,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/expect-utils@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/expect-utils@npm:30.0.5"
-  dependencies:
-    "@jest/get-type": "npm:30.0.1"
-  checksum: 10c0/d0ee162a1d1816724580bea53e7b422b891af073bdae439e78d04d5db09e6557e334f4c3d2892b9de750a59e79605f55d3ca8dbec9fb2ba33d8b803ed98463ad
-  languageName: node
-  linkType: hard
-
 "@jest/expect-utils@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/expect-utils@npm:30.3.0"
@@ -2895,16 +2703,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/expect@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/expect@npm:30.0.5"
-  dependencies:
-    expect: "npm:30.0.5"
-    jest-snapshot: "npm:30.0.5"
-  checksum: 10c0/6ff40adf2f2cfa53f7a23bc2b85ae99d3264420e81202d45d1dc198009f4441ee575d910e79e589f69c2dd47e0ef9a3b66018f44760da02d98f474361f7c4d1c
-  languageName: node
-  linkType: hard
-
 "@jest/expect@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/expect@npm:30.3.0"
@@ -2925,20 +2723,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/fake-timers@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/fake-timers@npm:30.0.5"
-  dependencies:
-    "@jest/types": "npm:30.0.5"
-    "@sinonjs/fake-timers": "npm:^13.0.0"
-    "@types/node": "npm:*"
-    jest-message-util: "npm:30.0.5"
-    jest-mock: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-  checksum: 10c0/4c403e624d758780016c2012b23112ff421efd601def289b201c4a5e03c46f995c7c3509d7b0b56dbe17cd5cbc66920734bd976ebe12125d6fd864d71888a50d
-  languageName: node
-  linkType: hard
-
 "@jest/fake-timers@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/fake-timers@npm:30.3.0"
@@ -2967,13 +2751,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/get-type@npm:30.0.1":
-  version: 30.0.1
-  resolution: "@jest/get-type@npm:30.0.1"
-  checksum: 10c0/92437ae42d0df57e8acc2d067288151439db4752cde4f5e680c73c8a6e34568bbd8c1c81a2f2f9a637a619c2aac8bc87553fb80e31475b59e2ed789a71e5e540
-  languageName: node
-  linkType: hard
-
 "@jest/get-type@npm:30.1.0":
   version: 30.1.0
   resolution: "@jest/get-type@npm:30.1.0"
@@ -2981,18 +2758,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/globals@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/globals@npm:30.0.5"
-  dependencies:
-    "@jest/environment": "npm:30.0.5"
-    "@jest/expect": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    jest-mock: "npm:30.0.5"
-  checksum: 10c0/abe8e4b11f30c2885e42afa9e01d4364db8c6de4c3221f411b00a9081d3cc67226f84775efbbd17735dedb391222253f945ee260714d78b2a7304b7afa61b6d8
-  languageName: node
-  linkType: hard
-
 "@jest/globals@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/globals@npm:30.3.0"
@@ -3027,7 +2792,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/reporters@npm:30.3.0":
+"@jest/reporters@npm:30.3.0, @jest/reporters@npm:^30.0.2":
   version: 30.3.0
   resolution: "@jest/reporters@npm:30.3.0"
   dependencies:
@@ -3100,42 +2865,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/reporters@npm:^30.0.2":
-  version: 30.0.5
-  resolution: "@jest/reporters@npm:30.0.5"
-  dependencies:
-    "@bcoe/v8-coverage": "npm:^0.2.3"
-    "@jest/console": "npm:30.0.5"
-    "@jest/test-result": "npm:30.0.5"
-    "@jest/transform": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@jridgewell/trace-mapping": "npm:^0.3.25"
-    "@types/node": "npm:*"
-    chalk: "npm:^4.1.2"
-    collect-v8-coverage: "npm:^1.0.2"
-    exit-x: "npm:^0.2.2"
-    glob: "npm:^10.3.10"
-    graceful-fs: "npm:^4.2.11"
-    istanbul-lib-coverage: "npm:^3.0.0"
-    istanbul-lib-instrument: "npm:^6.0.0"
-    istanbul-lib-report: "npm:^3.0.0"
-    istanbul-lib-source-maps: "npm:^5.0.0"
-    istanbul-reports: "npm:^3.1.3"
-    jest-message-util: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    jest-worker: "npm:30.0.5"
-    slash: "npm:^3.0.0"
-    string-length: "npm:^4.0.2"
-    v8-to-istanbul: "npm:^9.0.1"
-  peerDependencies:
-    node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0
-  peerDependenciesMeta:
-    node-notifier:
-      optional: true
-  checksum: 10c0/9f8a214ff69427b644e26981fa92af49b77819d512ac17d0b4190d1dc110b0bebeb7791faa7548b8097f010b094c3b5e3244e18f3837a3fe8385ff60c7114539
-  languageName: node
-  linkType: hard
-
 "@jest/schemas@npm:30.0.5":
   version: 30.0.5
   resolution: "@jest/schemas@npm:30.0.5"
@@ -3154,18 +2883,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/snapshot-utils@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/snapshot-utils@npm:30.0.5"
-  dependencies:
-    "@jest/types": "npm:30.0.5"
-    chalk: "npm:^4.1.2"
-    graceful-fs: "npm:^4.2.11"
-    natural-compare: "npm:^1.4.0"
-  checksum: 10c0/db270c2d6e216d132c5e0b05d8ff5bbe4fbd4e65b2de4cf94eacb44152e8f17fbbba8bdd2cb83b5fc2b1094db6424c7e1507b7eaade518dbc815cfacbdf6598b
-  languageName: node
-  linkType: hard
-
 "@jest/snapshot-utils@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/snapshot-utils@npm:30.3.0"
@@ -3200,18 +2917,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/test-result@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/test-result@npm:30.0.5"
-  dependencies:
-    "@jest/console": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@types/istanbul-lib-coverage": "npm:^2.0.6"
-    collect-v8-coverage: "npm:^1.0.2"
-  checksum: 10c0/2a43134ee28616a178b5a6379c837f2fb054a5e4a6ab411b9d15b85224e5d459d88902cdbf83edf5821c2c77fe13e67d078eff64c6871f3b08ebff0548a9a2e4
-  languageName: node
-  linkType: hard
-
 "@jest/test-result@npm:30.3.0, @jest/test-result@npm:^30.0.2":
   version: 30.3.0
   resolution: "@jest/test-result@npm:30.3.0"
@@ -3236,18 +2941,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/test-sequencer@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/test-sequencer@npm:30.0.5"
-  dependencies:
-    "@jest/test-result": "npm:30.0.5"
-    graceful-fs: "npm:^4.2.11"
-    jest-haste-map: "npm:30.0.5"
-    slash: "npm:^3.0.0"
-  checksum: 10c0/3caaea0558474764cd616f38acdc22ff4ce6ef806d931134ed366429fdea7110352b89d702e9cc1d71fa142d79e86f2f4e6eb0441a76a1896682e124ed8f42b4
-  languageName: node
-  linkType: hard
-
 "@jest/test-sequencer@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/test-sequencer@npm:30.3.0"
@@ -3272,29 +2965,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/transform@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/transform@npm:30.0.5"
-  dependencies:
-    "@babel/core": "npm:^7.27.4"
-    "@jest/types": "npm:30.0.5"
-    "@jridgewell/trace-mapping": "npm:^0.3.25"
-    babel-plugin-istanbul: "npm:^7.0.0"
-    chalk: "npm:^4.1.2"
-    convert-source-map: "npm:^2.0.0"
-    fast-json-stable-stringify: "npm:^2.1.0"
-    graceful-fs: "npm:^4.2.11"
-    jest-haste-map: "npm:30.0.5"
-    jest-regex-util: "npm:30.0.1"
-    jest-util: "npm:30.0.5"
-    micromatch: "npm:^4.0.8"
-    pirates: "npm:^4.0.7"
-    slash: "npm:^3.0.0"
-    write-file-atomic: "npm:^5.0.1"
-  checksum: 10c0/771f57b1bede66049de80dcbf984c74b7d3c072e905f2516ff3f86dc01abd2f79d821b9a6ae21f27cb26d484cd539c13b1a51f71c15e1aed0c62314203c5a186
-  languageName: node
-  linkType: hard
-
 "@jest/transform@npm:30.3.0":
   version: 30.3.0
   resolution: "@jest/transform@npm:30.3.0"
@@ -3340,21 +3010,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@jest/types@npm:30.0.5":
-  version: 30.0.5
-  resolution: "@jest/types@npm:30.0.5"
-  dependencies:
-    "@jest/pattern": "npm:30.0.1"
-    "@jest/schemas": "npm:30.0.5"
-    "@types/istanbul-lib-coverage": "npm:^2.0.6"
-    "@types/istanbul-reports": "npm:^3.0.4"
-    "@types/node": "npm:*"
-    "@types/yargs": "npm:^17.0.33"
-    chalk: "npm:^4.1.2"
-  checksum: 10c0/fd097a390e36edacbd2c92a8378ec0cd67abec5e234bab7a80aec6eb8625568052b0c32acf472388d04c4cf384b8fa2871d0d12a56b4b06eaea93f2c6df0ec6c
-  languageName: node
-  linkType: hard
-
 "@jest/types@npm:30.3.0, @jest/types@npm:^30.0.1":
   version: 30.3.0
   resolution: "@jest/types@npm:30.3.0"
@@ -6820,15 +6475,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@sinonjs/fake-timers@npm:^13.0.0":
-  version: 13.0.5
-  resolution: "@sinonjs/fake-timers@npm:13.0.5"
-  dependencies:
-    "@sinonjs/commons": "npm:^3.0.1"
-  checksum: 10c0/a707476efd523d2138ef6bba916c83c4a377a8372ef04fad87499458af9f01afc58f4f245c5fd062793d6d70587309330c6f96947b5bd5697961c18004dc3e26
-  languageName: node
-  linkType: hard
-
 "@sinonjs/fake-timers@npm:^15.0.0":
   version: 15.1.1
   resolution: "@sinonjs/fake-timers@npm:15.1.1"
@@ -7951,7 +7597,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/estree@npm:*, @types/estree@npm:1.0.8, @types/estree@npm:^1.0.0, @types/estree@npm:^1.0.6, @types/estree@npm:^1.0.8":
+"@types/estree@npm:*, @types/estree@npm:1.0.8, @types/estree@npm:^1.0.0, @types/estree@npm:^1.0.8":
   version: 1.0.8
   resolution: "@types/estree@npm:1.0.8"
   checksum: 10c0/39d34d1afaa338ab9763f37ad6066e3f349444f9052b9676a7cc0252ef9485a41c6d81c9c4e0d26e9077993354edf25efc853f3224dd4b447175ef62bdcc86a5
@@ -8987,15 +8633,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"acorn@npm:^8.14.0":
-  version: 8.15.0
-  resolution: "acorn@npm:8.15.0"
-  bin:
-    acorn: bin/acorn
-  checksum: 10c0/dec73ff59b7d6628a01eebaece7f2bdb8bb62b9b5926dcad0f8931f2b8b79c2be21f6c68ac095592adb5adb15831a3635d9343e6a91d028bbe85d564875ec3ec
-  languageName: node
-  linkType: hard
-
 "address@npm:^1.0.1":
   version: 1.2.2
   resolution: "address@npm:1.2.2"
@@ -9558,23 +9195,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"babel-jest@npm:30.0.5":
-  version: 30.0.5
-  resolution: "babel-jest@npm:30.0.5"
-  dependencies:
-    "@jest/transform": "npm:30.0.5"
-    "@types/babel__core": "npm:^7.20.5"
-    babel-plugin-istanbul: "npm:^7.0.0"
-    babel-preset-jest: "npm:30.0.1"
-    chalk: "npm:^4.1.2"
-    graceful-fs: "npm:^4.2.11"
-    slash: "npm:^3.0.0"
-  peerDependencies:
-    "@babel/core": ^7.11.0
-  checksum: 10c0/48fcdbf97519216f8897c4d83c0d2a64dffd90e4876b386e4ea4530021aaedbd7253de65a71d554cb57fdeb7bd8509bed43a6c016eb150e49e1fbe1236248f0f
-  languageName: node
-  linkType: hard
-
 "babel-jest@npm:30.3.0":
   version: 30.3.0
   resolution: "babel-jest@npm:30.3.0"
@@ -9666,19 +9286,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"babel-plugin-istanbul@npm:^7.0.0":
-  version: 7.0.0
-  resolution: "babel-plugin-istanbul@npm:7.0.0"
-  dependencies:
-    "@babel/helper-plugin-utils": "npm:^7.0.0"
-    "@istanbuljs/load-nyc-config": "npm:^1.0.0"
-    "@istanbuljs/schema": "npm:^0.1.3"
-    istanbul-lib-instrument: "npm:^6.0.2"
-    test-exclude: "npm:^6.0.0"
-  checksum: 10c0/79c37bd59ea9bcb16218e874993621e24048776fac7ee72eabe78f0909200851bdb93b32f6eba5b463206f15a1ee7ad40a725af8447952321ae1fdf14e740fe9
-  languageName: node
-  linkType: hard
-
 "babel-plugin-istanbul@npm:^7.0.1":
   version: 7.0.1
   resolution: "babel-plugin-istanbul@npm:7.0.1"
@@ -9692,17 +9299,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"babel-plugin-jest-hoist@npm:30.0.1":
-  version: 30.0.1
-  resolution: "babel-plugin-jest-hoist@npm:30.0.1"
-  dependencies:
-    "@babel/template": "npm:^7.27.2"
-    "@babel/types": "npm:^7.27.3"
-    "@types/babel__core": "npm:^7.20.5"
-  checksum: 10c0/49087f45c8ac359d68c622f4bd471300376b0ca2b6bd6ecaa1bd254ea87eda8fa3ce6144848e3bbabad337d276474a47e2ac3f6272f82e1f2337924ff49a02bd
-  languageName: node
-  linkType: hard
-
 "babel-plugin-jest-hoist@npm:30.3.0":
   version: 30.3.0
   resolution: "babel-plugin-jest-hoist@npm:30.3.0"
@@ -9791,7 +9387,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"babel-preset-current-node-syntax@npm:^1.0.0, babel-preset-current-node-syntax@npm:^1.1.0, babel-preset-current-node-syntax@npm:^1.2.0":
+"babel-preset-current-node-syntax@npm:^1.0.0, babel-preset-current-node-syntax@npm:^1.2.0":
   version: 1.2.0
   resolution: "babel-preset-current-node-syntax@npm:1.2.0"
   dependencies:
@@ -9816,18 +9412,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"babel-preset-jest@npm:30.0.1":
-  version: 30.0.1
-  resolution: "babel-preset-jest@npm:30.0.1"
-  dependencies:
-    babel-plugin-jest-hoist: "npm:30.0.1"
-    babel-preset-current-node-syntax: "npm:^1.1.0"
-  peerDependencies:
-    "@babel/core": ^7.11.0
-  checksum: 10c0/33da0094965929b1742b02e55272b544f189cd487d55bbba60e68d96d62d48f466264fe51f65950454829d4f2271541f2433e1c1c5e6a7ff5b9e91f1303471b7
-  languageName: node
-  linkType: hard
-
 "babel-preset-jest@npm:30.3.0":
   version: 30.3.0
   resolution: "babel-preset-jest@npm:30.3.0"
@@ -11419,19 +11003,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"debug@npm:4, debug@npm:^4.1.0, debug@npm:^4.1.1, debug@npm:^4.3.1, debug@npm:^4.3.2, debug@npm:^4.3.4, debug@npm:^4.3.6":
-  version: 4.4.0
-  resolution: "debug@npm:4.4.0"
-  dependencies:
-    ms: "npm:^2.1.3"
-  peerDependenciesMeta:
-    supports-color:
-      optional: true
-  checksum: 10c0/db94f1a182bf886f57b4755f85b3a74c39b5114b9377b7ab375dc2cfa3454f09490cc6c30f829df3fc8042bc8b8995f6567ce5cd96f3bc3688bd24027197d9de
-  languageName: node
-  linkType: hard
-
-"debug@npm:4.4.3, debug@npm:^4.4.1":
+"debug@npm:4, debug@npm:4.4.3, debug@npm:^4.1.0, debug@npm:^4.1.1, debug@npm:^4.3.1, debug@npm:^4.3.2, debug@npm:^4.3.4, debug@npm:^4.3.6, debug@npm:^4.4.1":
   version: 4.4.3
   resolution: "debug@npm:4.4.3"
   dependencies:
@@ -12056,16 +11628,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"enhanced-resolve@npm:^5.17.1":
-  version: 5.17.1
-  resolution: "enhanced-resolve@npm:5.17.1"
-  dependencies:
-    graceful-fs: "npm:^4.2.4"
-    tapable: "npm:^2.2.0"
-  checksum: 10c0/81a0515675eca17efdba2cf5bad87abc91a528fc1191aad50e275e74f045b41506167d420099022da7181c8d787170ea41e4a11a0b10b7a16f6237daecb15370
-  languageName: node
-  linkType: hard
-
 "enquirer@npm:2.4.1":
   version: 2.4.1
   resolution: "enquirer@npm:2.4.1"
@@ -12260,7 +11822,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-module-lexer@npm:^1.2.1, es-module-lexer@npm:^1.5.0":
+"es-module-lexer@npm:^1.5.0":
   version: 1.5.4
   resolution: "es-module-lexer@npm:1.5.4"
   checksum: 10c0/300a469488c2f22081df1e4c8398c78db92358496e639b0df7f89ac6455462aaf5d8893939087c1a1cbcbf20eed4610c70e0bcb8f3e4b0d80a5d2611c539408c
@@ -12976,23 +12538,9 @@ __metadata:
   languageName: node
   linkType: hard
 
-"expect@npm:30.0.5":
-  version: 30.0.5
-  resolution: "expect@npm:30.0.5"
-  dependencies:
-    "@jest/expect-utils": "npm:30.0.5"
-    "@jest/get-type": "npm:30.0.1"
-    jest-matcher-utils: "npm:30.0.5"
-    jest-message-util: "npm:30.0.5"
-    jest-mock: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-  checksum: 10c0/e08e4ced2856a0898b3a4e8d09aab7f8e2212cde701e41a560c3ab7e9053517947ff1a762fc425dbe0c48ed54e131aa7190de67a402f98b4e5ada23eb21c0a9f
-  languageName: node
-  linkType: hard
-
-"expect@npm:30.3.0":
-  version: 30.3.0
-  resolution: "expect@npm:30.3.0"
+"expect@npm:30.3.0":
+  version: 30.3.0
+  resolution: "expect@npm:30.3.0"
   dependencies:
     "@jest/expect-utils": "npm:30.3.0"
     "@jest/get-type": "npm:30.1.0"
@@ -13393,17 +12941,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"follow-redirects@npm:^1.0.0":
-  version: 1.15.9
-  resolution: "follow-redirects@npm:1.15.9"
-  peerDependenciesMeta:
-    debug:
-      optional: true
-  checksum: 10c0/5829165bd112c3c0e82be6c15b1a58fa9dcfaede3b3c54697a82fe4a62dd5ae5e8222956b448d2f98e331525f05d00404aba7d696de9e761ef6e42fdc780244f
-  languageName: node
-  linkType: hard
-
-"follow-redirects@npm:^1.15.11":
+"follow-redirects@npm:^1.0.0, follow-redirects@npm:^1.15.11":
   version: 1.15.11
   resolution: "follow-redirects@npm:1.15.11"
   peerDependenciesMeta:
@@ -13944,22 +13482,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"glob@npm:^10.3.10":
-  version: 10.4.5
-  resolution: "glob@npm:10.4.5"
-  dependencies:
-    foreground-child: "npm:^3.1.0"
-    jackspeak: "npm:^3.1.2"
-    minimatch: "npm:^9.0.4"
-    minipass: "npm:^7.1.2"
-    package-json-from-dist: "npm:^1.0.0"
-    path-scurry: "npm:^1.11.1"
-  bin:
-    glob: dist/esm/bin.mjs
-  checksum: 10c0/19a9759ea77b8e3ca0a43c2f07ecddc2ad46216b786bb8f993c445aee80d345925a21e5280c7b7c6c59e860a0154b84e4b2b60321fea92cd3c56b4a7489f160e
-  languageName: node
-  linkType: hard
-
 "glob@npm:^10.5.0":
   version: 10.5.0
   resolution: "glob@npm:10.5.0"
@@ -15420,7 +14942,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"istanbul-reports@npm:^3.0.2":
+"istanbul-reports@npm:^3.0.2, istanbul-reports@npm:^3.1.3":
   version: 3.2.0
   resolution: "istanbul-reports@npm:3.2.0"
   dependencies:
@@ -15430,16 +14952,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"istanbul-reports@npm:^3.1.3":
-  version: 3.1.7
-  resolution: "istanbul-reports@npm:3.1.7"
-  dependencies:
-    html-escaper: "npm:^2.0.0"
-    istanbul-lib-report: "npm:^3.0.0"
-  checksum: 10c0/a379fadf9cf8dc5dfe25568115721d4a7eb82fbd50b005a6672aff9c6989b20cc9312d7865814e0859cd8df58cbf664482e1d3604be0afde1f7fc3ccc1394a51
-  languageName: node
-  linkType: hard
-
 "iterator.prototype@npm:^1.1.3":
   version: 1.1.3
   resolution: "iterator.prototype@npm:1.1.3"
@@ -15502,34 +15014,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-circus@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-circus@npm:30.0.5"
-  dependencies:
-    "@jest/environment": "npm:30.0.5"
-    "@jest/expect": "npm:30.0.5"
-    "@jest/test-result": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    chalk: "npm:^4.1.2"
-    co: "npm:^4.6.0"
-    dedent: "npm:^1.6.0"
-    is-generator-fn: "npm:^2.1.0"
-    jest-each: "npm:30.0.5"
-    jest-matcher-utils: "npm:30.0.5"
-    jest-message-util: "npm:30.0.5"
-    jest-runtime: "npm:30.0.5"
-    jest-snapshot: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    p-limit: "npm:^3.1.0"
-    pretty-format: "npm:30.0.5"
-    pure-rand: "npm:^7.0.0"
-    slash: "npm:^3.0.0"
-    stack-utils: "npm:^2.0.6"
-  checksum: 10c0/028204897eee7bef2d04eea0216b48f94e3da77ff1d12b0e3a5e265e8e73bcd31192cec70282aa1ece91150c00fcb5662c2c68e86b3892cffbfbe7058fa7f4e5
-  languageName: node
-  linkType: hard
-
 "jest-circus@npm:30.3.0, jest-circus@npm:^30.0.4":
   version: 30.3.0
   resolution: "jest-circus@npm:30.3.0"
@@ -15637,7 +15121,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-config@npm:30.3.0":
+"jest-config@npm:30.3.0, jest-config@npm:^30.0.2":
   version: 30.3.0
   resolution: "jest-config@npm:30.3.0"
   dependencies:
@@ -15717,61 +15201,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-config@npm:^30.0.2":
-  version: 30.0.5
-  resolution: "jest-config@npm:30.0.5"
-  dependencies:
-    "@babel/core": "npm:^7.27.4"
-    "@jest/get-type": "npm:30.0.1"
-    "@jest/pattern": "npm:30.0.1"
-    "@jest/test-sequencer": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    babel-jest: "npm:30.0.5"
-    chalk: "npm:^4.1.2"
-    ci-info: "npm:^4.2.0"
-    deepmerge: "npm:^4.3.1"
-    glob: "npm:^10.3.10"
-    graceful-fs: "npm:^4.2.11"
-    jest-circus: "npm:30.0.5"
-    jest-docblock: "npm:30.0.1"
-    jest-environment-node: "npm:30.0.5"
-    jest-regex-util: "npm:30.0.1"
-    jest-resolve: "npm:30.0.5"
-    jest-runner: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    jest-validate: "npm:30.0.5"
-    micromatch: "npm:^4.0.8"
-    parse-json: "npm:^5.2.0"
-    pretty-format: "npm:30.0.5"
-    slash: "npm:^3.0.0"
-    strip-json-comments: "npm:^3.1.1"
-  peerDependencies:
-    "@types/node": "*"
-    esbuild-register: ">=3.4.0"
-    ts-node: ">=9.0.0"
-  peerDependenciesMeta:
-    "@types/node":
-      optional: true
-    esbuild-register:
-      optional: true
-    ts-node:
-      optional: true
-  checksum: 10c0/da68048801e6f6622bf6e9a361dcfb3859017bbd58fabcf53bade41157bdf31cc35a1bd3dab1e3cca86e69da23e2c27c7aa5e308efc04564a454e23de6f22062
-  languageName: node
-  linkType: hard
-
-"jest-diff@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-diff@npm:30.0.5"
-  dependencies:
-    "@jest/diff-sequences": "npm:30.0.1"
-    "@jest/get-type": "npm:30.0.1"
-    chalk: "npm:^4.1.2"
-    pretty-format: "npm:30.0.5"
-  checksum: 10c0/b218ced37b7676f578ea866762f04caa74901bdcf3f593872aa9a4991a586302651a1d16bb0386772adacc7580a452ec621359af75d733c0b50ea947fe1881d3
-  languageName: node
-  linkType: hard
-
 "jest-diff@npm:30.3.0, jest-diff@npm:^30.0.2":
   version: 30.3.0
   resolution: "jest-diff@npm:30.3.0"
@@ -15796,15 +15225,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-docblock@npm:30.0.1":
-  version: 30.0.1
-  resolution: "jest-docblock@npm:30.0.1"
-  dependencies:
-    detect-newline: "npm:^3.1.0"
-  checksum: 10c0/f9bad2651db8afa029867ea7a40f422c9d73c67657360297371846a314a40c8786424be00483261df9137499f52c2af28cd458fbd15a7bf7fac8775b4bcd6ee1
-  languageName: node
-  linkType: hard
-
 "jest-docblock@npm:30.2.0":
   version: 30.2.0
   resolution: "jest-docblock@npm:30.2.0"
@@ -15823,19 +15243,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-each@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-each@npm:30.0.5"
-  dependencies:
-    "@jest/get-type": "npm:30.0.1"
-    "@jest/types": "npm:30.0.5"
-    chalk: "npm:^4.1.2"
-    jest-util: "npm:30.0.5"
-    pretty-format: "npm:30.0.5"
-  checksum: 10c0/fe7509bfd8b0c8553bbdaffda5d3b674a4da870c5ce9fe69c1ca8111d9e0f21a8f265799eba0f927581d16f4810e5eb5bebfd7e51f5f137cbef08cc44d8fd9cd
-  languageName: node
-  linkType: hard
-
 "jest-each@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-each@npm:30.3.0"
@@ -15892,21 +15299,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-environment-node@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-environment-node@npm:30.0.5"
-  dependencies:
-    "@jest/environment": "npm:30.0.5"
-    "@jest/fake-timers": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    jest-mock: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    jest-validate: "npm:30.0.5"
-  checksum: 10c0/1b608597f0755814e7c24b9ed2a45abc2340cfd8f8d3691caf929f332facd9c62ac5092e7f01056708a0ca41ae0458b6d442fd1ae9f6d21b7b416b252e1ae210
-  languageName: node
-  linkType: hard
-
 "jest-environment-node@npm:30.3.0, jest-environment-node@npm:^30.0.4":
   version: 30.3.0
   resolution: "jest-environment-node@npm:30.3.0"
@@ -15943,28 +15335,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-haste-map@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-haste-map@npm:30.0.5"
-  dependencies:
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    anymatch: "npm:^3.1.3"
-    fb-watchman: "npm:^2.0.2"
-    fsevents: "npm:^2.3.3"
-    graceful-fs: "npm:^4.2.11"
-    jest-regex-util: "npm:30.0.1"
-    jest-util: "npm:30.0.5"
-    jest-worker: "npm:30.0.5"
-    micromatch: "npm:^4.0.8"
-    walker: "npm:^1.0.8"
-  dependenciesMeta:
-    fsevents:
-      optional: true
-  checksum: 10c0/eab5d85d820f149bcf4bf4e0c49316f48973c85d39b4c3a2e08f57504f069afe9b0f1665e556330a98c6fc6bd5a6932767b466c1c96124fa0161aef017ab17b3
-  languageName: node
-  linkType: hard
-
 "jest-haste-map@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-haste-map@npm:30.3.0"
@@ -16022,16 +15392,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-leak-detector@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-leak-detector@npm:30.0.5"
-  dependencies:
-    "@jest/get-type": "npm:30.0.1"
-    pretty-format: "npm:30.0.5"
-  checksum: 10c0/04207ab6f44dec22d3d656b5f3b4f334440f4c01ccd21c55474f26706530244d34b8dc9922c9449e00e8649e5da1b8de4aca58c9895c9de19951d5ecdc0ff113
-  languageName: node
-  linkType: hard
-
 "jest-leak-detector@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-leak-detector@npm:30.3.0"
@@ -16052,18 +15412,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-matcher-utils@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-matcher-utils@npm:30.0.5"
-  dependencies:
-    "@jest/get-type": "npm:30.0.1"
-    chalk: "npm:^4.1.2"
-    jest-diff: "npm:30.0.5"
-    pretty-format: "npm:30.0.5"
-  checksum: 10c0/231d891b29bfc218f2f5739c10873b6671426e31ad1c5538eed1531e62608fd3f60d32f41821332a6cf41f1614fd37361434c754fdd49c849b35ef2e5156c02e
-  languageName: node
-  linkType: hard
-
 "jest-matcher-utils@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-matcher-utils@npm:30.3.0"
@@ -16088,23 +15436,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-message-util@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-message-util@npm:30.0.5"
-  dependencies:
-    "@babel/code-frame": "npm:^7.27.1"
-    "@jest/types": "npm:30.0.5"
-    "@types/stack-utils": "npm:^2.0.3"
-    chalk: "npm:^4.1.2"
-    graceful-fs: "npm:^4.2.11"
-    micromatch: "npm:^4.0.8"
-    pretty-format: "npm:30.0.5"
-    slash: "npm:^3.0.0"
-    stack-utils: "npm:^2.0.6"
-  checksum: 10c0/38b710c127db6c79c36d690377d9f9f1e3c2e4b2d2e60f3b82a5b4da70efb1f4783c6cf0cf1f6be6e3b7fb2d2aed889583d2430f65afc09e7e6d68aa5fa981dc
-  languageName: node
-  linkType: hard
-
 "jest-message-util@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-message-util@npm:30.3.0"
@@ -16139,17 +15470,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-mock@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-mock@npm:30.0.5"
-  dependencies:
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    jest-util: "npm:30.0.5"
-  checksum: 10c0/207fd79297f514a8e26ede9b4b5035e70212b8850a2f460b51d3cc58e8e7c9585bd2dbc5df2475a3321c4cd114b90e0b24190f00d6eeb88c8f088a8ed00416d5
-  languageName: node
-  linkType: hard
-
 "jest-mock@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-mock@npm:30.3.0"
@@ -16236,22 +15556,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-resolve@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-resolve@npm:30.0.5"
-  dependencies:
-    chalk: "npm:^4.1.2"
-    graceful-fs: "npm:^4.2.11"
-    jest-haste-map: "npm:30.0.5"
-    jest-pnp-resolver: "npm:^1.2.3"
-    jest-util: "npm:30.0.5"
-    jest-validate: "npm:30.0.5"
-    slash: "npm:^3.0.0"
-    unrs-resolver: "npm:^1.7.11"
-  checksum: 10c0/6edea75db950131513cd642743d4c5dd36c209c94652e469eebc86fdf85eb579a7614c30262668fcd429e1c841f1d17a26831259db69c17dffd0718c37f69196
-  languageName: node
-  linkType: hard
-
 "jest-resolve@npm:30.3.0, jest-resolve@npm:^30.0.2":
   version: 30.3.0
   resolution: "jest-resolve@npm:30.3.0"
@@ -16285,36 +15589,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-runner@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-runner@npm:30.0.5"
-  dependencies:
-    "@jest/console": "npm:30.0.5"
-    "@jest/environment": "npm:30.0.5"
-    "@jest/test-result": "npm:30.0.5"
-    "@jest/transform": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    chalk: "npm:^4.1.2"
-    emittery: "npm:^0.13.1"
-    exit-x: "npm:^0.2.2"
-    graceful-fs: "npm:^4.2.11"
-    jest-docblock: "npm:30.0.1"
-    jest-environment-node: "npm:30.0.5"
-    jest-haste-map: "npm:30.0.5"
-    jest-leak-detector: "npm:30.0.5"
-    jest-message-util: "npm:30.0.5"
-    jest-resolve: "npm:30.0.5"
-    jest-runtime: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    jest-watcher: "npm:30.0.5"
-    jest-worker: "npm:30.0.5"
-    p-limit: "npm:^3.1.0"
-    source-map-support: "npm:0.5.13"
-  checksum: 10c0/5da84e4f393cc4b0c2b86a7058c154e524bc91947867f892d252300d06c595058690a61ffdbfa74381498f4ebb9cc7d8d967a62f53cb5f5383ec59fb5ed21d91
-  languageName: node
-  linkType: hard
-
 "jest-runner@npm:30.3.0, jest-runner@npm:^30.0.4":
   version: 30.3.0
   resolution: "jest-runner@npm:30.3.0"
@@ -16374,36 +15648,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-runtime@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-runtime@npm:30.0.5"
-  dependencies:
-    "@jest/environment": "npm:30.0.5"
-    "@jest/fake-timers": "npm:30.0.5"
-    "@jest/globals": "npm:30.0.5"
-    "@jest/source-map": "npm:30.0.1"
-    "@jest/test-result": "npm:30.0.5"
-    "@jest/transform": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    chalk: "npm:^4.1.2"
-    cjs-module-lexer: "npm:^2.1.0"
-    collect-v8-coverage: "npm:^1.0.2"
-    glob: "npm:^10.3.10"
-    graceful-fs: "npm:^4.2.11"
-    jest-haste-map: "npm:30.0.5"
-    jest-message-util: "npm:30.0.5"
-    jest-mock: "npm:30.0.5"
-    jest-regex-util: "npm:30.0.1"
-    jest-resolve: "npm:30.0.5"
-    jest-snapshot: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    slash: "npm:^3.0.0"
-    strip-bom: "npm:^4.0.0"
-  checksum: 10c0/c1afa36da0582172e9a73d69fcc23fd433efc8a7d0328ba5fee45858dc85cb01410b47ba53540bb3758277eb84bb5a42e872bc58d2e5a3cad533f4b33e3abe61
-  languageName: node
-  linkType: hard
-
 "jest-runtime@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-runtime@npm:30.3.0"
@@ -16473,35 +15717,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-snapshot@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-snapshot@npm:30.0.5"
-  dependencies:
-    "@babel/core": "npm:^7.27.4"
-    "@babel/generator": "npm:^7.27.5"
-    "@babel/plugin-syntax-jsx": "npm:^7.27.1"
-    "@babel/plugin-syntax-typescript": "npm:^7.27.1"
-    "@babel/types": "npm:^7.27.3"
-    "@jest/expect-utils": "npm:30.0.5"
-    "@jest/get-type": "npm:30.0.1"
-    "@jest/snapshot-utils": "npm:30.0.5"
-    "@jest/transform": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    babel-preset-current-node-syntax: "npm:^1.1.0"
-    chalk: "npm:^4.1.2"
-    expect: "npm:30.0.5"
-    graceful-fs: "npm:^4.2.11"
-    jest-diff: "npm:30.0.5"
-    jest-matcher-utils: "npm:30.0.5"
-    jest-message-util: "npm:30.0.5"
-    jest-util: "npm:30.0.5"
-    pretty-format: "npm:30.0.5"
-    semver: "npm:^7.7.2"
-    synckit: "npm:^0.11.8"
-  checksum: 10c0/2bda246367373003abfbd66de261bfd355618926c28261d7ffcdfac0c4c7a7f575c9f598745b0b59eb2cfa8907889dcc07db3ad65d940061275d490c1eb3e1fe
-  languageName: node
-  linkType: hard
-
 "jest-snapshot@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-snapshot@npm:30.3.0"
@@ -16559,20 +15774,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-util@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-util@npm:30.0.5"
-  dependencies:
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    chalk: "npm:^4.1.2"
-    ci-info: "npm:^4.2.0"
-    graceful-fs: "npm:^4.2.11"
-    picomatch: "npm:^4.0.2"
-  checksum: 10c0/d3808b5f7720044d0464664c795e2b795ed82edf3b5871db74b8b603c3a0a38107668730348d26f92920ca3b8245a99cbbc2c93e77d0abb1f5e27524079a4ba8
-  languageName: node
-  linkType: hard
-
 "jest-util@npm:30.3.0, jest-util@npm:^30.0.2":
   version: 30.3.0
   resolution: "jest-util@npm:30.3.0"
@@ -16601,20 +15802,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-validate@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-validate@npm:30.0.5"
-  dependencies:
-    "@jest/get-type": "npm:30.0.1"
-    "@jest/types": "npm:30.0.5"
-    camelcase: "npm:^6.3.0"
-    chalk: "npm:^4.1.2"
-    leven: "npm:^3.1.0"
-    pretty-format: "npm:30.0.5"
-  checksum: 10c0/739a5df57befd763ba40693c9c1d7e93234af44ca21226a42272fbf87dea076a23848072b46871ce02cc0f2614f8ad41542e98965b405320276102b4de35b063
-  languageName: node
-  linkType: hard
-
 "jest-validate@npm:30.3.0":
   version: 30.3.0
   resolution: "jest-validate@npm:30.3.0"
@@ -16660,22 +15847,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-watcher@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-watcher@npm:30.0.5"
-  dependencies:
-    "@jest/test-result": "npm:30.0.5"
-    "@jest/types": "npm:30.0.5"
-    "@types/node": "npm:*"
-    ansi-escapes: "npm:^4.3.2"
-    chalk: "npm:^4.1.2"
-    emittery: "npm:^0.13.1"
-    jest-util: "npm:30.0.5"
-    string-length: "npm:^4.0.2"
-  checksum: 10c0/5c26617c53e6314e2143806cbc8c1cdca7100cc8de3241c7debf7b5feb0df17bdc9a92ee4a4efa953a261d8806ffd7f6c89e72d567236e62492dd554eaa91f97
-  languageName: node
-  linkType: hard
-
 "jest-watcher@npm:30.3.0, jest-watcher@npm:^30.0.0":
   version: 30.3.0
   resolution: "jest-watcher@npm:30.3.0"
@@ -16708,19 +15879,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"jest-worker@npm:30.0.5":
-  version: 30.0.5
-  resolution: "jest-worker@npm:30.0.5"
-  dependencies:
-    "@types/node": "npm:*"
-    "@ungap/structured-clone": "npm:^1.3.0"
-    jest-util: "npm:30.0.5"
-    merge-stream: "npm:^2.0.0"
-    supports-color: "npm:^8.1.1"
-  checksum: 10c0/50a724b39b8691168a456544f32ef8e937c827cd6d326fa0bc27df786c80af1e1f16d9f2d9cc800af4baac85a0f9e9ed78fbd4a06f13eb32e72ec66d11b85f38
-  languageName: node
-  linkType: hard
-
 "jest-worker@npm:30.3.0, jest-worker@npm:^30.0.5":
   version: 30.3.0
   resolution: "jest-worker@npm:30.3.0"
@@ -17242,13 +16400,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"loader-runner@npm:^4.2.0":
-  version: 4.3.0
-  resolution: "loader-runner@npm:4.3.0"
-  checksum: 10c0/a44d78aae0907a72f73966fe8b82d1439c8c485238bd5a864b1b9a2a3257832effa858790241e6b37876b5446a78889adf2fcc8dd897ce54c089ecc0a0ce0bf0
-  languageName: node
-  linkType: hard
-
 "loader-runner@npm:^4.3.1":
   version: 4.3.1
   resolution: "loader-runner@npm:4.3.1"
@@ -19736,17 +18887,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"pretty-format@npm:30.0.5":
-  version: 30.0.5
-  resolution: "pretty-format@npm:30.0.5"
-  dependencies:
-    "@jest/schemas": "npm:30.0.5"
-    ansi-styles: "npm:^5.2.0"
-    react-is: "npm:^18.3.1"
-  checksum: 10c0/9f6cf1af5c3169093866c80adbfdad32f69c692b62f24ba3ca8cdec8519336123323f896396f9fa40346a41b197c5f6be15aec4d8620819f12496afaaca93f81
-  languageName: node
-  linkType: hard
-
 "pretty-format@npm:30.3.0":
   version: 30.3.0
   resolution: "pretty-format@npm:30.3.0"
@@ -19950,15 +19090,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"randombytes@npm:^2.1.0":
-  version: 2.1.0
-  resolution: "randombytes@npm:2.1.0"
-  dependencies:
-    safe-buffer: "npm:^5.1.0"
-  checksum: 10c0/50395efda7a8c94f5dffab564f9ff89736064d32addf0cc7e8bf5e4166f09f8ded7a0849ca6c2d2a59478f7d90f78f20d8048bca3cdf8be09d8e8a10790388f3
-  languageName: node
-  linkType: hard
-
 "range-parser@npm:^1.2.1, range-parser@npm:~1.2.1":
   version: 1.2.1
   resolution: "range-parser@npm:1.2.1"
@@ -21113,7 +20244,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"safe-buffer@npm:5.2.1, safe-buffer@npm:>=5.1.0, safe-buffer@npm:^5.1.0, safe-buffer@npm:~5.2.0":
+"safe-buffer@npm:5.2.1, safe-buffer@npm:>=5.1.0, safe-buffer@npm:~5.2.0":
   version: 5.2.1
   resolution: "safe-buffer@npm:5.2.1"
   checksum: 10c0/6501914237c0a86e9675d4e51d89ca3c21ffd6a31642efeba25ad65720bce6921c9e7e974e5be91a786b25aa058b5303285d3c15dbabf983a919f5f630d349f3
@@ -21462,18 +20593,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"schema-utils@npm:^4.3.2":
-  version: 4.3.2
-  resolution: "schema-utils@npm:4.3.2"
-  dependencies:
-    "@types/json-schema": "npm:^7.0.9"
-    ajv: "npm:^8.9.0"
-    ajv-formats: "npm:^2.1.1"
-    ajv-keywords: "npm:^5.1.0"
-  checksum: 10c0/981632f9bf59f35b15a9bcdac671dd183f4946fe4b055ae71a301e66a9797b95e5dd450de581eb6cca56fb6583ce8f24d67b2d9f8e1b2936612209697f6c277e
-  languageName: node
-  linkType: hard
-
 "screenfull@npm:^5.0.0":
   version: 5.2.0
   resolution: "screenfull@npm:5.2.0"
@@ -21573,15 +20692,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"serialize-javascript@npm:^6.0.2":
-  version: 6.0.2
-  resolution: "serialize-javascript@npm:6.0.2"
-  dependencies:
-    randombytes: "npm:^2.1.0"
-  checksum: 10c0/2dd09ef4b65a1289ba24a788b1423a035581bef60817bea1f01eda8e3bda623f86357665fe7ac1b50f6d4f583f97db9615b3f07b2a2e8cbcb75033965f771dd2
-  languageName: node
-  linkType: hard
-
 "serialize-javascript@npm:^7.0.3":
   version: 7.0.4
   resolution: "serialize-javascript@npm:7.0.4"
@@ -22649,20 +21759,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"tapable@npm:2.3.0, tapable@npm:^2.3.0":
+"tapable@npm:2.3.0, tapable@npm:^2.0.0, tapable@npm:^2.2.1, tapable@npm:^2.3.0":
   version: 2.3.0
   resolution: "tapable@npm:2.3.0"
   checksum: 10c0/cb9d67cc2c6a74dedc812ef3085d9d681edd2c1fa18e4aef57a3c0605fdbe44e6b8ea00bd9ef21bc74dd45314e39d31227aa031ebf2f5e38164df514136f2681
   languageName: node
   linkType: hard
 
-"tapable@npm:^2.0.0, tapable@npm:^2.1.1, tapable@npm:^2.2.0, tapable@npm:^2.2.1":
-  version: 2.2.1
-  resolution: "tapable@npm:2.2.1"
-  checksum: 10c0/bc40e6efe1e554d075469cedaba69a30eeb373552aaf41caeaaa45bf56ffacc2674261b106245bd566b35d8f3329b52d838e851ee0a852120acae26e622925c9
-  languageName: node
-  linkType: hard
-
 "tar-stream@npm:~2.2.0":
   version: 2.2.0
   resolution: "tar-stream@npm:2.2.0"
@@ -22703,28 +21806,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"terser-webpack-plugin@npm:^5.3.11":
-  version: 5.3.14
-  resolution: "terser-webpack-plugin@npm:5.3.14"
-  dependencies:
-    "@jridgewell/trace-mapping": "npm:^0.3.25"
-    jest-worker: "npm:^27.4.5"
-    schema-utils: "npm:^4.3.0"
-    serialize-javascript: "npm:^6.0.2"
-    terser: "npm:^5.31.1"
-  peerDependencies:
-    webpack: ^5.1.0
-  peerDependenciesMeta:
-    "@swc/core":
-      optional: true
-    esbuild:
-      optional: true
-    uglify-js:
-      optional: true
-  checksum: 10c0/9b060947241af43bd6fd728456f60e646186aef492163672a35ad49be6fbc7f63b54a7356c3f6ff40a8f83f00a977edc26f044b8e106cc611c053c8c0eaf8569
-  languageName: node
-  linkType: hard
-
 "terser-webpack-plugin@npm:^5.3.14, terser-webpack-plugin@npm:^5.3.17, terser-webpack-plugin@npm:^5.3.3":
   version: 5.4.0
   resolution: "terser-webpack-plugin@npm:5.4.0"
@@ -23845,16 +22926,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"watchpack@npm:^2.4.1":
-  version: 2.4.2
-  resolution: "watchpack@npm:2.4.2"
-  dependencies:
-    glob-to-regexp: "npm:^0.4.1"
-    graceful-fs: "npm:^4.1.2"
-  checksum: 10c0/ec60a5f0e9efaeca0102fd9126346b3b2d523e01c34030d3fddf5813a7125765121ebdc2552981136dcd2c852deb1af0b39340f2fcc235f292db5399d0283577
-  languageName: node
-  linkType: hard
-
 "watchpack@npm:^2.5.1":
   version: 2.5.1
   resolution: "watchpack@npm:2.5.1"
@@ -24004,13 +23075,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"webpack-sources@npm:^3.2.3":
-  version: 3.2.3
-  resolution: "webpack-sources@npm:3.2.3"
-  checksum: 10c0/2ef63d77c4fad39de4a6db17323d75eb92897b32674e97d76f0a1e87c003882fc038571266ad0ef581ac734cbe20952912aaa26155f1905e96ce251adbb1eb4e
-  languageName: node
-  linkType: hard
-
 "webpack-subresource-integrity@npm:^5.1.0":
   version: 5.1.0
   resolution: "webpack-subresource-integrity@npm:5.1.0"
@@ -24033,44 +23097,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"webpack@npm:5":
-  version: 5.99.9
-  resolution: "webpack@npm:5.99.9"
-  dependencies:
-    "@types/eslint-scope": "npm:^3.7.7"
-    "@types/estree": "npm:^1.0.6"
-    "@types/json-schema": "npm:^7.0.15"
-    "@webassemblyjs/ast": "npm:^1.14.1"
-    "@webassemblyjs/wasm-edit": "npm:^1.14.1"
-    "@webassemblyjs/wasm-parser": "npm:^1.14.1"
-    acorn: "npm:^8.14.0"
-    browserslist: "npm:^4.24.0"
-    chrome-trace-event: "npm:^1.0.2"
-    enhanced-resolve: "npm:^5.17.1"
-    es-module-lexer: "npm:^1.2.1"
-    eslint-scope: "npm:5.1.1"
-    events: "npm:^3.2.0"
-    glob-to-regexp: "npm:^0.4.1"
-    graceful-fs: "npm:^4.2.11"
-    json-parse-even-better-errors: "npm:^2.3.1"
-    loader-runner: "npm:^4.2.0"
-    mime-types: "npm:^2.1.27"
-    neo-async: "npm:^2.6.2"
-    schema-utils: "npm:^4.3.2"
-    tapable: "npm:^2.1.1"
-    terser-webpack-plugin: "npm:^5.3.11"
-    watchpack: "npm:^2.4.1"
-    webpack-sources: "npm:^3.2.3"
-  peerDependenciesMeta:
-    webpack-cli:
-      optional: true
-  bin:
-    webpack: bin/webpack.js
-  checksum: 10c0/34ec3f19b50bccaf27929e5e5b901b25047f2d414acba7d0967dc98eb4f404d107fb1a4b63095edbca2b006ff5815f1720b131e10b20664b074dfc86b7ffa717
-  languageName: node
-  linkType: hard
-
-"webpack@npm:^5.101.3":
+"webpack@npm:5, webpack@npm:^5.101.3":
   version: 5.105.4
   resolution: "webpack@npm:5.105.4"
   dependencies:

From d78affa611dfdad8c0996970e8dddedf0f2eabeb Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 3 Apr 2026 09:06:53 -0400
Subject: [PATCH 17/37] start fixing test failures

---
 .../__tests__/FeatureShimmer.test.tsx         |  1 +
 .../__snapshots__/utils.test.tsx.snap         | 80 ++++++++++++-------
 2 files changed, 53 insertions(+), 28 deletions(-)

diff --git a/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx b/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx
index c5bb6d7704a..5f1bb550589 100644
--- a/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx
+++ b/packages/gamut/src/FeatureShimmer/__tests__/FeatureShimmer.test.tsx
@@ -17,6 +17,7 @@ describe('FeatureShimmer', () => {
   beforeEach(() => {
     mockIntersectionObserver.mockReturnValue({
       observe: jest.fn(),
+      unobserve: jest.fn(),
       disconnect: jest.fn(),
     });
     window.IntersectionObserver = mockIntersectionObserver;
diff --git a/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap b/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap
index 2690797df50..6db6a89db06 100644
--- a/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap
+++ b/packages/gamut/src/Form/__tests__/__snapshots__/utils.test.tsx.snap
@@ -2,39 +2,63 @@
 
 exports[`parseSelectOptions creates an option list 1`] = `
 [
-  <option
-    data-testid="test-val"
-    label="Value"
-    value="val"
-  >
-    Value
-  </option>,
-  <option
-    data-testid="test-val2"
-    label="Value 2"
-    value="val2"
-  >
-    Value 2
-  </option>,
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val",
+    "props": {
+      "children": "Value",
+      "data-testid": "test-val",
+      "label": "Value",
+      "value": "val",
+    },
+    "type": "option",
+  },
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val2",
+    "props": {
+      "children": "Value 2",
+      "data-testid": "test-val2",
+      "label": "Value 2",
+      "value": "val2",
+    },
+    "type": "option",
+  },
 ]
 `;
 
 exports[`parseSelectOptions creates an option list 2`] = `
 [
-  <option
-    data-testid="test-val"
-    label="val"
-    value="val"
-  >
-    val
-  </option>,
-  <option
-    data-testid="test-val2"
-    label="val2"
-    value="val2"
-  >
-    val2
-  </option>,
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val",
+    "props": {
+      "children": "val",
+      "data-testid": "test-val",
+      "label": "val",
+      "value": "val",
+    },
+    "type": "option",
+  },
+  {
+    "$$typeof": Symbol(react.transitional.element),
+    "_owner": null,
+    "_store": {},
+    "key": "test-val2",
+    "props": {
+      "children": "val2",
+      "data-testid": "test-val2",
+      "label": "val2",
+      "value": "val2",
+    },
+    "type": "option",
+  },
 ]
 `;
 

From ad2809d22a92241543c6297e8f9fd40d98d574a2 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 3 Apr 2026 09:16:17 -0400
Subject: [PATCH 18/37] add release plan

---
 .nx/version-plans/version-plan-1775222101294.md | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 .nx/version-plans/version-plan-1775222101294.md

diff --git a/.nx/version-plans/version-plan-1775222101294.md b/.nx/version-plans/version-plan-1775222101294.md
new file mode 100644
index 00000000000..eb5fc9a63f4
--- /dev/null
+++ b/.nx/version-plans/version-plan-1775222101294.md
@@ -0,0 +1,11 @@
+---
+gamut-illustrations: major
+gamut-patterns: major
+gamut-styles: major
+gamut-icons: major
+gamut-tests: major
+variance: major
+gamut: major
+---
+
+Update to React 19 compatibility

From e6fd469348cda0f3797455b2d7cd5590402bcbb3 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 3 Apr 2026 11:42:03 -0400
Subject: [PATCH 19/37] chore: align babel-plugin-macros and
 component-test-setup for syncpack

Made-with: Cursor
---
 package.json                      |  2 +-
 packages/gamut-tests/package.json |  2 +-
 yarn.lock                         | 17 +++--------------
 3 files changed, 5 insertions(+), 16 deletions(-)

diff --git a/package.json b/package.json
index 2d201aca5ef..b1f8add5ec3 100644
--- a/package.json
+++ b/package.json
@@ -58,7 +58,7 @@
     "@typescript-eslint/eslint-plugin": "^8.57.0",
     "@typescript-eslint/parser": "^8.57.0",
     "babel-jest": "29.6.4",
-    "babel-plugin-macros": "3.0.1",
+    "babel-plugin-macros": "^3.0.1",
     "commander": "^14.0.3",
     "component-test-setup": "^0.3.1",
     "cpy-cli": "^4.1.0",
diff --git a/packages/gamut-tests/package.json b/packages/gamut-tests/package.json
index 3ccd636fd00..22f936b824b 100644
--- a/packages/gamut-tests/package.json
+++ b/packages/gamut-tests/package.json
@@ -5,7 +5,7 @@
   "author": "Codecademy Engineering <dev@codecademy.com>",
   "dependencies": {
     "@codecademy/gamut-styles": "17.13.1",
-    "component-test-setup": "*",
+    "component-test-setup": "^0.3.1",
     "lodash": "^4.17.23"
   },
   "files": [
diff --git a/yarn.lock b/yarn.lock
index 14f7cf08a7c..39da083fb38 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1641,7 +1641,7 @@ __metadata:
   resolution: "@codecademy/gamut-tests@workspace:packages/gamut-tests"
   dependencies:
     "@codecademy/gamut-styles": "npm:17.13.1"
-    component-test-setup: "npm:*"
+    component-test-setup: "npm:^0.3.1"
     lodash: "npm:^4.17.23"
   peerDependencies:
     react: ^17.0.2 || ^18.3.0 || ^19.0.0
@@ -9501,17 +9501,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"babel-plugin-macros@npm:3.0.1":
-  version: 3.0.1
-  resolution: "babel-plugin-macros@npm:3.0.1"
-  dependencies:
-    "@babel/runtime": "npm:^7.12.5"
-    cosmiconfig: "npm:^7.0.0"
-    resolve: "npm:^1.19.0"
-  checksum: 10c0/d9b89cbe63888dd417326160d1e3fdf8d0a19f8b4f760329e13faf0a780a9b0a847468b8a03978fbb562e665605a6ef65f17125867e5fdc6d65312f437a036ca
-  languageName: node
-  linkType: hard
-
 "babel-plugin-macros@npm:^3.0.1, babel-plugin-macros@npm:^3.1.0":
   version: 3.1.0
   resolution: "babel-plugin-macros@npm:3.1.0"
@@ -10501,7 +10490,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"component-test-setup@npm:*, component-test-setup@npm:^0.3.1":
+"component-test-setup@npm:^0.3.1":
   version: 0.3.3
   resolution: "component-test-setup@npm:0.3.3"
   checksum: 10c0/f85ee9a5bf5f65b8440cd6fe03a626e1222b1bba2f29798a4de1c1d7fdbf87397a5ad11e19b0ed20030033c7bede66d2ae6c5bfba426e00b9383adbe0dd0a584
@@ -13687,7 +13676,7 @@ __metadata:
     "@typescript-eslint/parser": "npm:^8.57.0"
     "@vidstack/react": "npm:^1.12.12"
     babel-jest: "npm:29.6.4"
-    babel-plugin-macros: "npm:3.0.1"
+    babel-plugin-macros: "npm:^3.0.1"
     commander: "npm:^14.0.3"
     component-test-setup: "npm:^0.3.1"
     core-js: "npm:3.7.0"

From d8b11d856fc29741d5ec1cea4d8acd7cce404685 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 3 Apr 2026 12:29:12 -0400
Subject: [PATCH 20/37] dedupe yrn

---
 yarn.lock | 665 +++---------------------------------------------------
 1 file changed, 33 insertions(+), 632 deletions(-)

diff --git a/yarn.lock b/yarn.lock
index 39da083fb38..061b1cbb2a3 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2174,18 +2174,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@eslint-community/eslint-utils@npm:^4.2.0":
-  version: 4.4.1
-  resolution: "@eslint-community/eslint-utils@npm:4.4.1"
-  dependencies:
-    eslint-visitor-keys: "npm:^3.4.3"
-  peerDependencies:
-    eslint: ^6.0.0 || ^7.0.0 || >=8.0.0
-  checksum: 10c0/2aa0ac2fc50ff3f234408b10900ed4f1a0b19352f21346ad4cc3d83a1271481bdda11097baa45d484dd564c895e0762a27a8240be7a256b3ad47129e96528252
-  languageName: node
-  linkType: hard
-
-"@eslint-community/eslint-utils@npm:^4.9.1":
+"@eslint-community/eslint-utils@npm:^4.2.0, @eslint-community/eslint-utils@npm:^4.9.1":
   version: 4.9.1
   resolution: "@eslint-community/eslint-utils@npm:4.9.1"
   dependencies:
@@ -2196,20 +2185,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@eslint-community/regexpp@npm:^4.12.2":
+"@eslint-community/regexpp@npm:^4.12.2, @eslint-community/regexpp@npm:^4.6.1":
   version: 4.12.2
   resolution: "@eslint-community/regexpp@npm:4.12.2"
   checksum: 10c0/fddcbc66851b308478d04e302a4d771d6917a0b3740dc351513c0da9ca2eab8a1adf99f5e0aa7ab8b13fa0df005c81adeee7e63a92f3effd7d367a163b721c2d
   languageName: node
   linkType: hard
 
-"@eslint-community/regexpp@npm:^4.6.1":
-  version: 4.12.1
-  resolution: "@eslint-community/regexpp@npm:4.12.1"
-  checksum: 10c0/a03d98c246bcb9109aec2c08e4d10c8d010256538dcb3f56610191607214523d4fb1b00aa81df830b6dffb74c5fa0be03642513a289c567949d3e550ca11cdf6
-  languageName: node
-  linkType: hard
-
 "@eslint/eslintrc@npm:^2.1.4":
   version: 2.1.4
   resolution: "@eslint/eslintrc@npm:2.1.4"
@@ -7898,16 +7880,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@types/node@npm:*":
-  version: 22.8.1
-  resolution: "@types/node@npm:22.8.1"
-  dependencies:
-    undici-types: "npm:~6.19.8"
-  checksum: 10c0/83550fdf72a7db5b55eceac3f4fb038844eaee20202bdd2297a8248370cfa08317bda1605b781a8043eda4f173b75e73632e652fc85509eb14dfef78fa17337f
-  languageName: node
-  linkType: hard
-
-"@types/node@npm:^22.0.0":
+"@types/node@npm:*, @types/node@npm:^22.0.0":
   version: 22.19.15
   resolution: "@types/node@npm:22.19.15"
   dependencies:
@@ -9032,17 +9005,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"array-buffer-byte-length@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "array-buffer-byte-length@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.5"
-    is-array-buffer: "npm:^3.0.4"
-  checksum: 10c0/f5cdf54527cd18a3d2852ddf73df79efec03829e7373a8322ef5df2b4ef546fb365c19c71d6b42d641cb6bfe0f1a2f19bc0ece5b533295f86d7c3d522f228917
-  languageName: node
-  linkType: hard
-
-"array-buffer-byte-length@npm:^1.0.2":
+"array-buffer-byte-length@npm:^1.0.1, array-buffer-byte-length@npm:^1.0.2":
   version: 1.0.2
   resolution: "array-buffer-byte-length@npm:1.0.2"
   dependencies:
@@ -9136,19 +9099,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"array.prototype.flatmap@npm:^1.3.2":
-  version: 1.3.2
-  resolution: "array.prototype.flatmap@npm:1.3.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    define-properties: "npm:^1.2.0"
-    es-abstract: "npm:^1.22.1"
-    es-shim-unscopables: "npm:^1.0.0"
-  checksum: 10c0/67b3f1d602bb73713265145853128b1ad77cc0f9b833c7e1e056b323fbeac41a4ff1c9c99c7b9445903caea924d9ca2450578d9011913191aa88cc3c3a4b54f4
-  languageName: node
-  linkType: hard
-
-"array.prototype.flatmap@npm:^1.3.3":
+"array.prototype.flatmap@npm:^1.3.2, array.prototype.flatmap@npm:^1.3.3":
   version: 1.3.3
   resolution: "array.prototype.flatmap@npm:1.3.3"
   dependencies:
@@ -9188,22 +9139,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"arraybuffer.prototype.slice@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "arraybuffer.prototype.slice@npm:1.0.3"
-  dependencies:
-    array-buffer-byte-length: "npm:^1.0.1"
-    call-bind: "npm:^1.0.5"
-    define-properties: "npm:^1.2.1"
-    es-abstract: "npm:^1.22.3"
-    es-errors: "npm:^1.2.1"
-    get-intrinsic: "npm:^1.2.3"
-    is-array-buffer: "npm:^3.0.4"
-    is-shared-array-buffer: "npm:^1.0.2"
-  checksum: 10c0/d32754045bcb2294ade881d45140a5e52bda2321b9e98fa514797b7f0d252c4c5ab0d1edb34112652c62fa6a9398def568da63a4d7544672229afea283358c36
-  languageName: node
-  linkType: hard
-
 "arraybuffer.prototype.slice@npm:^1.0.4":
   version: 1.0.4
   resolution: "arraybuffer.prototype.slice@npm:1.0.4"
@@ -9738,16 +9673,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"brace-expansion@npm:^2.0.1":
-  version: 2.0.1
-  resolution: "brace-expansion@npm:2.0.1"
-  dependencies:
-    balanced-match: "npm:^1.0.0"
-  checksum: 10c0/b358f2fe060e2d7a87aa015979ecea07f3c37d4018f8d6deb5bd4c229ad3a0384fe6029bb76cd8be63c81e516ee52d1a0673edbe2023d53a5191732ae3c3e49f
-  languageName: node
-  linkType: hard
-
-"brace-expansion@npm:^2.0.2":
+"brace-expansion@npm:^2.0.1, brace-expansion@npm:^2.0.2":
   version: 2.0.3
   resolution: "brace-expansion@npm:2.0.3"
   dependencies:
@@ -9904,20 +9830,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"call-bind@npm:^1.0.2, call-bind@npm:^1.0.5, call-bind@npm:^1.0.6, call-bind@npm:^1.0.7":
-  version: 1.0.7
-  resolution: "call-bind@npm:1.0.7"
-  dependencies:
-    es-define-property: "npm:^1.0.0"
-    es-errors: "npm:^1.3.0"
-    function-bind: "npm:^1.1.2"
-    get-intrinsic: "npm:^1.2.4"
-    set-function-length: "npm:^1.2.1"
-  checksum: 10c0/a3ded2e423b8e2a265983dba81c27e125b48eefb2655e7dfab6be597088da3d47c47976c24bc51b8fd9af1061f8f87b4ab78a314f3c77784b2ae2ba535ad8b8d
-  languageName: node
-  linkType: hard
-
-"call-bind@npm:^1.0.8":
+"call-bind@npm:^1.0.2, call-bind@npm:^1.0.7, call-bind@npm:^1.0.8":
   version: 1.0.8
   resolution: "call-bind@npm:1.0.8"
   dependencies:
@@ -10171,20 +10084,13 @@ __metadata:
   languageName: node
   linkType: hard
 
-"ci-info@npm:^4.0.0":
+"ci-info@npm:^4.0.0, ci-info@npm:^4.2.0":
   version: 4.4.0
   resolution: "ci-info@npm:4.4.0"
   checksum: 10c0/44156201545b8dde01aa8a09ee2fe9fc7a73b1bef9adbd4606c9f61c8caeeb73fb7a575c88b0443f7b4edb5ee45debaa59ed54ba5f99698339393ca01349eb3a
   languageName: node
   linkType: hard
 
-"ci-info@npm:^4.2.0":
-  version: 4.3.0
-  resolution: "ci-info@npm:4.3.0"
-  checksum: 10c0/60d3dfe95d75c01454ec1cfd5108617dd598a28a2a3e148bd7e1523c1c208b5f5a3007cafcbe293e6fd0a5a310cc32217c5dc54743eeabc0a2bec80072fc055c
-  languageName: node
-  linkType: hard
-
 "cjs-module-lexer@npm:^1.0.0, cjs-module-lexer@npm:^1.2.3":
   version: 1.4.3
   resolution: "cjs-module-lexer@npm:1.4.3"
@@ -11160,17 +11066,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"data-view-buffer@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "data-view-buffer@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.6"
-    es-errors: "npm:^1.3.0"
-    is-data-view: "npm:^1.0.1"
-  checksum: 10c0/8984119e59dbed906a11fcfb417d7d861936f16697a0e7216fe2c6c810f6b5e8f4a5281e73f2c28e8e9259027190ac4a33e2a65fdd7fa86ac06b76e838918583
-  languageName: node
-  linkType: hard
-
 "data-view-buffer@npm:^1.0.2":
   version: 1.0.2
   resolution: "data-view-buffer@npm:1.0.2"
@@ -11182,17 +11077,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"data-view-byte-length@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "data-view-byte-length@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    es-errors: "npm:^1.3.0"
-    is-data-view: "npm:^1.0.1"
-  checksum: 10c0/b7d9e48a0cf5aefed9ab7d123559917b2d7e0d65531f43b2fd95b9d3a6b46042dd3fca597c42bba384e66b70d7ad66ff23932f8367b241f53d93af42cfe04ec2
-  languageName: node
-  linkType: hard
-
 "data-view-byte-length@npm:^1.0.2":
   version: 1.0.2
   resolution: "data-view-byte-length@npm:1.0.2"
@@ -11204,17 +11088,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"data-view-byte-offset@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "data-view-byte-offset@npm:1.0.0"
-  dependencies:
-    call-bind: "npm:^1.0.6"
-    es-errors: "npm:^1.3.0"
-    is-data-view: "npm:^1.0.1"
-  checksum: 10c0/21b0d2e53fd6e20cc4257c873bf6d36d77bd6185624b84076c0a1ddaa757b49aaf076254006341d35568e89f52eecd1ccb1a502cfb620f2beca04f48a6a62a8f
-  languageName: node
-  linkType: hard
-
 "data-view-byte-offset@npm:^1.0.1":
   version: 1.0.1
   resolution: "data-view-byte-offset@npm:1.0.1"
@@ -11982,61 +11855,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-abstract@npm:^1.17.2, es-abstract@npm:^1.17.5, es-abstract@npm:^1.22.1, es-abstract@npm:^1.22.3, es-abstract@npm:^1.23.0, es-abstract@npm:^1.23.2, es-abstract@npm:^1.23.3":
-  version: 1.23.3
-  resolution: "es-abstract@npm:1.23.3"
-  dependencies:
-    array-buffer-byte-length: "npm:^1.0.1"
-    arraybuffer.prototype.slice: "npm:^1.0.3"
-    available-typed-arrays: "npm:^1.0.7"
-    call-bind: "npm:^1.0.7"
-    data-view-buffer: "npm:^1.0.1"
-    data-view-byte-length: "npm:^1.0.1"
-    data-view-byte-offset: "npm:^1.0.0"
-    es-define-property: "npm:^1.0.0"
-    es-errors: "npm:^1.3.0"
-    es-object-atoms: "npm:^1.0.0"
-    es-set-tostringtag: "npm:^2.0.3"
-    es-to-primitive: "npm:^1.2.1"
-    function.prototype.name: "npm:^1.1.6"
-    get-intrinsic: "npm:^1.2.4"
-    get-symbol-description: "npm:^1.0.2"
-    globalthis: "npm:^1.0.3"
-    gopd: "npm:^1.0.1"
-    has-property-descriptors: "npm:^1.0.2"
-    has-proto: "npm:^1.0.3"
-    has-symbols: "npm:^1.0.3"
-    hasown: "npm:^2.0.2"
-    internal-slot: "npm:^1.0.7"
-    is-array-buffer: "npm:^3.0.4"
-    is-callable: "npm:^1.2.7"
-    is-data-view: "npm:^1.0.1"
-    is-negative-zero: "npm:^2.0.3"
-    is-regex: "npm:^1.1.4"
-    is-shared-array-buffer: "npm:^1.0.3"
-    is-string: "npm:^1.0.7"
-    is-typed-array: "npm:^1.1.13"
-    is-weakref: "npm:^1.0.2"
-    object-inspect: "npm:^1.13.1"
-    object-keys: "npm:^1.1.1"
-    object.assign: "npm:^4.1.5"
-    regexp.prototype.flags: "npm:^1.5.2"
-    safe-array-concat: "npm:^1.1.2"
-    safe-regex-test: "npm:^1.0.3"
-    string.prototype.trim: "npm:^1.2.9"
-    string.prototype.trimend: "npm:^1.0.8"
-    string.prototype.trimstart: "npm:^1.0.8"
-    typed-array-buffer: "npm:^1.0.2"
-    typed-array-byte-length: "npm:^1.0.1"
-    typed-array-byte-offset: "npm:^1.0.2"
-    typed-array-length: "npm:^1.0.6"
-    unbox-primitive: "npm:^1.0.2"
-    which-typed-array: "npm:^1.1.15"
-  checksum: 10c0/d27e9afafb225c6924bee9971a7f25f20c314f2d6cb93a63cada4ac11dcf42040896a6c22e5fb8f2a10767055ed4ddf400be3b1eb12297d281726de470b75666
-  languageName: node
-  linkType: hard
-
-"es-abstract@npm:^1.23.5, es-abstract@npm:^1.23.6, es-abstract@npm:^1.23.9, es-abstract@npm:^1.24.1":
+"es-abstract@npm:^1.17.2, es-abstract@npm:^1.17.5, es-abstract@npm:^1.22.1, es-abstract@npm:^1.23.2, es-abstract@npm:^1.23.3, es-abstract@npm:^1.23.5, es-abstract@npm:^1.23.6, es-abstract@npm:^1.23.9, es-abstract@npm:^1.24.1":
   version: 1.24.1
   resolution: "es-abstract@npm:1.24.1"
   dependencies:
@@ -12112,7 +11931,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-errors@npm:^1.2.1, es-errors@npm:^1.3.0":
+"es-errors@npm:^1.3.0":
   version: 1.3.0
   resolution: "es-errors@npm:1.3.0"
   checksum: 10c0/0a61325670072f98d8ae3b914edab3559b6caa980f08054a3b872052640d91da01d38df55df797fcc916389d77fc92b8d5906cf028f4db46d7e3003abecbca85
@@ -12167,7 +11986,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-set-tostringtag@npm:^2.0.3, es-set-tostringtag@npm:^2.1.0":
+"es-set-tostringtag@npm:^2.1.0":
   version: 2.1.0
   resolution: "es-set-tostringtag@npm:2.1.0"
   dependencies:
@@ -12188,17 +12007,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"es-to-primitive@npm:^1.2.1":
-  version: 1.2.1
-  resolution: "es-to-primitive@npm:1.2.1"
-  dependencies:
-    is-callable: "npm:^1.1.4"
-    is-date-object: "npm:^1.0.1"
-    is-symbol: "npm:^1.0.2"
-  checksum: 10c0/0886572b8dc075cb10e50c0af62a03d03a68e1e69c388bd4f10c0649ee41b1fbb24840a1b7e590b393011b5cdbe0144b776da316762653685432df37d6de60f1
-  languageName: node
-  linkType: hard
-
 "es-to-primitive@npm:^1.3.0":
   version: 1.3.0
   resolution: "es-to-primitive@npm:1.3.0"
@@ -13051,18 +12859,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"fdir@npm:^6.4.4":
-  version: 6.4.4
-  resolution: "fdir@npm:6.4.4"
-  peerDependencies:
-    picomatch: ^3 || ^4
-  peerDependenciesMeta:
-    picomatch:
-      optional: true
-  checksum: 10c0/6ccc33be16945ee7bc841e1b4178c0b4cf18d3804894cb482aa514651c962a162f96da7ffc6ebfaf0df311689fb70091b04dd6caffe28d56b9ebdc0e7ccadfdd
-  languageName: node
-  linkType: hard
-
 "fdir@npm:^6.5.0":
   version: 6.5.0
   resolution: "fdir@npm:6.5.0"
@@ -13298,16 +13094,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"for-each@npm:^0.3.3":
-  version: 0.3.3
-  resolution: "for-each@npm:0.3.3"
-  dependencies:
-    is-callable: "npm:^1.1.3"
-  checksum: 10c0/22330d8a2db728dbf003ec9182c2d421fbcd2969b02b4f97ec288721cda63eb28f2c08585ddccd0f77cb2930af8d958005c9e72f47141dc51816127a118f39aa
-  languageName: node
-  linkType: hard
-
-"for-each@npm:^0.3.5":
+"for-each@npm:^0.3.3, for-each@npm:^0.3.5":
   version: 0.3.5
   resolution: "for-each@npm:0.3.5"
   dependencies:
@@ -13592,19 +13379,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"function.prototype.name@npm:^1.1.6":
-  version: 1.1.6
-  resolution: "function.prototype.name@npm:1.1.6"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    define-properties: "npm:^1.2.0"
-    es-abstract: "npm:^1.22.1"
-    functions-have-names: "npm:^1.2.3"
-  checksum: 10c0/9eae11294905b62cb16874adb4fc687927cda3162285e0ad9612e6a1d04934005d46907362ea9cdb7428edce05a2f2c3dabc3b2d21e9fd343e9bb278230ad94b
-  languageName: node
-  linkType: hard
-
-"function.prototype.name@npm:^1.1.8":
+"function.prototype.name@npm:^1.1.6, function.prototype.name@npm:^1.1.8":
   version: 1.1.8
   resolution: "function.prototype.name@npm:1.1.8"
   dependencies:
@@ -13756,25 +13531,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"get-intrinsic@npm:^1.2.1, get-intrinsic@npm:^1.2.3, get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.6":
-  version: 1.3.0
-  resolution: "get-intrinsic@npm:1.3.0"
-  dependencies:
-    call-bind-apply-helpers: "npm:^1.0.2"
-    es-define-property: "npm:^1.0.1"
-    es-errors: "npm:^1.3.0"
-    es-object-atoms: "npm:^1.1.1"
-    function-bind: "npm:^1.1.2"
-    get-proto: "npm:^1.0.1"
-    gopd: "npm:^1.2.0"
-    has-symbols: "npm:^1.1.0"
-    hasown: "npm:^2.0.2"
-    math-intrinsics: "npm:^1.1.0"
-  checksum: 10c0/52c81808af9a8130f581e6a6a83e1ba4a9f703359e7a438d1369a5267a25412322f03dcbd7c549edaef0b6214a0630a28511d7df0130c93cfd380f4fa0b5b66a
-  languageName: node
-  linkType: hard
-
-"get-intrinsic@npm:^1.2.5, get-intrinsic@npm:^1.2.7, get-intrinsic@npm:^1.3.0":
+"get-intrinsic@npm:^1.2.4, get-intrinsic@npm:^1.2.5, get-intrinsic@npm:^1.2.6, get-intrinsic@npm:^1.2.7, get-intrinsic@npm:^1.3.0":
   version: 1.3.1
   resolution: "get-intrinsic@npm:1.3.1"
   dependencies:
@@ -13826,17 +13583,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"get-symbol-description@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "get-symbol-description@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.5"
-    es-errors: "npm:^1.3.0"
-    get-intrinsic: "npm:^1.2.4"
-  checksum: 10c0/867be6d63f5e0eb026cb3b0ef695ec9ecf9310febb041072d2e142f260bd91ced9eeb426b3af98791d1064e324e653424afa6fd1af17dee373bea48ae03162bc
-  languageName: node
-  linkType: hard
-
 "get-symbol-description@npm:^1.1.0":
   version: 1.1.0
   resolution: "get-symbol-description@npm:1.1.0"
@@ -14007,7 +13753,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"globalthis@npm:^1.0.3, globalthis@npm:^1.0.4":
+"globalthis@npm:^1.0.4":
   version: 1.0.4
   resolution: "globalthis@npm:1.0.4"
   dependencies:
@@ -14099,7 +13845,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"has-bigints@npm:^1.0.1, has-bigints@npm:^1.0.2":
+"has-bigints@npm:^1.0.2":
   version: 1.0.2
   resolution: "has-bigints@npm:1.0.2"
   checksum: 10c0/724eb1485bfa3cdff6f18d95130aa190561f00b3fcf9f19dc640baf8176b5917c143b81ec2123f8cddb6c05164a198c94b13e1377c497705ccc8e1a80306e83b
@@ -14129,13 +13875,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"has-proto@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "has-proto@npm:1.0.3"
-  checksum: 10c0/35a6989f81e9f8022c2f4027f8b48a552de714938765d019dbea6bb547bd49ce5010a3c7c32ec6ddac6e48fc546166a3583b128f5a7add8b058a6d8b4afec205
-  languageName: node
-  linkType: hard
-
 "has-proto@npm:^1.2.0":
   version: 1.2.0
   resolution: "has-proto@npm:1.2.0"
@@ -14145,7 +13884,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"has-symbols@npm:^1.0.1, has-symbols@npm:^1.0.2, has-symbols@npm:^1.0.3, has-symbols@npm:^1.1.0":
+"has-symbols@npm:^1.0.1, has-symbols@npm:^1.0.3, has-symbols@npm:^1.1.0":
   version: 1.1.0
   resolution: "has-symbols@npm:1.1.0"
   checksum: 10c0/dde0a734b17ae51e84b10986e651c664379018d10b91b6b0e9b293eddb32f0f069688c841fb40f19e9611546130153e0a2a48fd7f512891fb000ddfa36f5a20e
@@ -14718,17 +14457,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"internal-slot@npm:^1.0.7":
-  version: 1.0.7
-  resolution: "internal-slot@npm:1.0.7"
-  dependencies:
-    es-errors: "npm:^1.3.0"
-    hasown: "npm:^2.0.0"
-    side-channel: "npm:^1.0.4"
-  checksum: 10c0/f8b294a4e6ea3855fc59551bbf35f2b832cf01fd5e6e2a97f5c201a071cc09b49048f856e484b67a6c721da5e55736c5b6ddafaf19e2dbeb4a3ff1821680de6c
-  languageName: node
-  linkType: hard
-
 "internal-slot@npm:^1.1.0":
   version: 1.1.0
   resolution: "internal-slot@npm:1.1.0"
@@ -14799,17 +14527,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-array-buffer@npm:^3.0.4":
-  version: 3.0.4
-  resolution: "is-array-buffer@npm:3.0.4"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    get-intrinsic: "npm:^1.2.1"
-  checksum: 10c0/42a49d006cc6130bc5424eae113e948c146f31f9d24460fc0958f855d9d810e6fd2e4519bf19aab75179af9c298ea6092459d8cafdec523cd19e529b26eab860
-  languageName: node
-  linkType: hard
-
-"is-array-buffer@npm:^3.0.5":
+"is-array-buffer@npm:^3.0.4, is-array-buffer@npm:^3.0.5":
   version: 3.0.5
   resolution: "is-array-buffer@npm:3.0.5"
   dependencies:
@@ -14836,15 +14554,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-bigint@npm:^1.0.1":
-  version: 1.0.4
-  resolution: "is-bigint@npm:1.0.4"
-  dependencies:
-    has-bigints: "npm:^1.0.1"
-  checksum: 10c0/eb9c88e418a0d195ca545aff2b715c9903d9b0a5033bc5922fec600eb0c3d7b1ee7f882dbf2e0d5a6e694e42391be3683e4368737bd3c4a77f8ac293e7773696
-  languageName: node
-  linkType: hard
-
 "is-bigint@npm:^1.1.0":
   version: 1.1.0
   resolution: "is-bigint@npm:1.1.0"
@@ -14863,16 +14572,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-boolean-object@npm:^1.1.0":
-  version: 1.1.2
-  resolution: "is-boolean-object@npm:1.1.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/6090587f8a8a8534c0f816da868bc94f32810f08807aa72fa7e79f7e11c466d281486ffe7a788178809c2aa71fe3e700b167fe80dd96dad68026bfff8ebf39f7
-  languageName: node
-  linkType: hard
-
 "is-boolean-object@npm:^1.2.1":
   version: 1.2.2
   resolution: "is-boolean-object@npm:1.2.2"
@@ -14883,7 +14582,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-callable@npm:^1.1.3, is-callable@npm:^1.1.4, is-callable@npm:^1.2.7":
+"is-callable@npm:^1.2.7":
   version: 1.2.7
   resolution: "is-callable@npm:1.2.7"
   checksum: 10c0/ceebaeb9d92e8adee604076971dd6000d38d6afc40bb843ea8e45c5579b57671c3f3b50d7f04869618242c6cee08d1b67806a8cb8edaaaf7c0748b3720d6066f
@@ -14899,16 +14598,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-data-view@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "is-data-view@npm:1.0.1"
-  dependencies:
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/a3e6ec84efe303da859107aed9b970e018e2bee7ffcb48e2f8096921a493608134240e672a2072577e5f23a729846241d9634806e8a0e51d9129c56d5f65442d
-  languageName: node
-  linkType: hard
-
-"is-data-view@npm:^1.0.2":
+"is-data-view@npm:^1.0.1, is-data-view@npm:^1.0.2":
   version: 1.0.2
   resolution: "is-data-view@npm:1.0.2"
   dependencies:
@@ -14919,16 +14609,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-date-object@npm:^1.0.1, is-date-object@npm:^1.0.5":
-  version: 1.0.5
-  resolution: "is-date-object@npm:1.0.5"
-  dependencies:
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/eed21e5dcc619c48ccef804dfc83a739dbb2abee6ca202838ee1bd5f760fe8d8a93444f0d49012ad19bb7c006186e2884a1b92f6e1c056da7fd23d0a9ad5992e
-  languageName: node
-  linkType: hard
-
-"is-date-object@npm:^1.1.0":
+"is-date-object@npm:^1.0.5, is-date-object@npm:^1.1.0":
   version: 1.1.0
   resolution: "is-date-object@npm:1.1.0"
   dependencies:
@@ -15080,15 +14761,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-number-object@npm:^1.0.4":
-  version: 1.0.7
-  resolution: "is-number-object@npm:1.0.7"
-  dependencies:
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/aad266da1e530f1804a2b7bd2e874b4869f71c98590b3964f9d06cc9869b18f8d1f4778f838ecd2a11011bce20aeecb53cb269ba916209b79c24580416b74b1b
-  languageName: node
-  linkType: hard
-
 "is-number-object@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-number-object@npm:1.1.1"
@@ -15157,16 +14829,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-regex@npm:^1.1.4":
-  version: 1.1.4
-  resolution: "is-regex@npm:1.1.4"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/bb72aae604a69eafd4a82a93002058c416ace8cde95873589a97fc5dac96a6c6c78a9977d487b7b95426a8f5073969124dd228f043f9f604f041f32fcc465fc1
-  languageName: node
-  linkType: hard
-
 "is-regex@npm:^1.2.1":
   version: 1.2.1
   resolution: "is-regex@npm:1.2.1"
@@ -15186,15 +14848,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-shared-array-buffer@npm:^1.0.2, is-shared-array-buffer@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "is-shared-array-buffer@npm:1.0.3"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-  checksum: 10c0/adc11ab0acbc934a7b9e5e9d6c588d4ec6682f6fea8cda5180721704fa32927582ede5b123349e32517fdadd07958973d24716c80e7ab198970c47acc09e59c7
-  languageName: node
-  linkType: hard
-
 "is-shared-array-buffer@npm:^1.0.4":
   version: 1.0.4
   resolution: "is-shared-array-buffer@npm:1.0.4"
@@ -15211,16 +14864,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-string@npm:^1.0.5, is-string@npm:^1.0.7":
-  version: 1.0.7
-  resolution: "is-string@npm:1.0.7"
-  dependencies:
-    has-tostringtag: "npm:^1.0.0"
-  checksum: 10c0/905f805cbc6eedfa678aaa103ab7f626aac9ebbdc8737abb5243acaa61d9820f8edc5819106b8fcd1839e33db21de9f0116ae20de380c8382d16dc2a601921f6
-  languageName: node
-  linkType: hard
-
-"is-string@npm:^1.1.1":
+"is-string@npm:^1.0.7, is-string@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-string@npm:1.1.1"
   dependencies:
@@ -15230,15 +14874,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-symbol@npm:^1.0.2, is-symbol@npm:^1.0.3":
-  version: 1.0.4
-  resolution: "is-symbol@npm:1.0.4"
-  dependencies:
-    has-symbols: "npm:^1.0.2"
-  checksum: 10c0/9381dd015f7c8906154dbcbf93fad769de16b4b961edc94f88d26eb8c555935caa23af88bda0c93a18e65560f6d7cca0fd5a3f8a8e1df6f1abbb9bead4502ef7
-  languageName: node
-  linkType: hard
-
 "is-symbol@npm:^1.0.4, is-symbol@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-symbol@npm:1.1.1"
@@ -15250,16 +14885,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-typed-array@npm:^1.1.13":
-  version: 1.1.13
-  resolution: "is-typed-array@npm:1.1.13"
-  dependencies:
-    which-typed-array: "npm:^1.1.14"
-  checksum: 10c0/fa5cb97d4a80e52c2cc8ed3778e39f175a1a2ae4ddf3adae3187d69586a1fd57cfa0b095db31f66aa90331e9e3da79184cea9c6abdcd1abc722dc3c3edd51cca
-  languageName: node
-  linkType: hard
-
-"is-typed-array@npm:^1.1.14, is-typed-array@npm:^1.1.15":
+"is-typed-array@npm:^1.1.13, is-typed-array@npm:^1.1.14, is-typed-array@npm:^1.1.15":
   version: 1.1.15
   resolution: "is-typed-array@npm:1.1.15"
   dependencies:
@@ -15289,16 +14915,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"is-weakref@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "is-weakref@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-  checksum: 10c0/1545c5d172cb690c392f2136c23eec07d8d78a7f57d0e41f10078aa4f5daf5d7f57b6513a67514ab4f073275ad00c9822fc8935e00229d0a2089e1c02685d4b1
-  languageName: node
-  linkType: hard
-
-"is-weakref@npm:^1.1.1":
+"is-weakref@npm:^1.0.2, is-weakref@npm:^1.1.1":
   version: 1.1.1
   resolution: "is-weakref@npm:1.1.1"
   dependencies:
@@ -18052,7 +17669,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"minimatch@npm:^9.0.0":
+"minimatch@npm:^9.0.0, minimatch@npm:^9.0.4":
   version: 9.0.9
   resolution: "minimatch@npm:9.0.9"
   dependencies:
@@ -18061,15 +17678,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"minimatch@npm:^9.0.4":
-  version: 9.0.5
-  resolution: "minimatch@npm:9.0.5"
-  dependencies:
-    brace-expansion: "npm:^2.0.1"
-  checksum: 10c0/de96cf5e35bdf0eab3e2c853522f98ffbe9a36c37797778d2665231ec1f20a9447a7e567cb640901f89e4daaa95ae5d70c65a9e8aa2bb0019b6facbc3c0575ed
-  languageName: node
-  linkType: hard
-
 "minimist-options@npm:4.1.0":
   version: 4.1.0
   resolution: "minimist-options@npm:4.1.0"
@@ -18738,13 +18346,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object-inspect@npm:^1.13.1":
-  version: 1.13.2
-  resolution: "object-inspect@npm:1.13.2"
-  checksum: 10c0/b97835b4c91ec37b5fd71add84f21c3f1047d1d155d00c0fcd6699516c256d4fcc6ff17a1aced873197fe447f91a3964178fd2a67a1ee2120cdaf60e81a050b4
-  languageName: node
-  linkType: hard
-
 "object-inspect@npm:^1.13.3, object-inspect@npm:^1.13.4":
   version: 1.13.4
   resolution: "object-inspect@npm:1.13.4"
@@ -18759,19 +18360,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object.assign@npm:^4.1.4, object.assign@npm:^4.1.5":
-  version: 4.1.5
-  resolution: "object.assign@npm:4.1.5"
-  dependencies:
-    call-bind: "npm:^1.0.5"
-    define-properties: "npm:^1.2.1"
-    has-symbols: "npm:^1.0.3"
-    object-keys: "npm:^1.1.1"
-  checksum: 10c0/60108e1fa2706f22554a4648299b0955236c62b3685c52abf4988d14fffb0e7731e00aa8c6448397e3eb63d087dcc124a9f21e1980f36d0b2667f3c18bacd469
-  languageName: node
-  linkType: hard
-
-"object.assign@npm:^4.1.7":
+"object.assign@npm:^4.1.4, object.assign@npm:^4.1.7":
   version: 4.1.7
   resolution: "object.assign@npm:4.1.7"
   dependencies:
@@ -18835,18 +18424,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"object.values@npm:^1.1.0, object.values@npm:^1.1.6, object.values@npm:^1.2.0":
-  version: 1.2.0
-  resolution: "object.values@npm:1.2.0"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/15809dc40fd6c5529501324fec5ff08570b7d70fb5ebbe8e2b3901afec35cf2b3dc484d1210c6c642cd3e7e0a5e18dd1d6850115337fef46bdae14ab0cb18ac3
-  languageName: node
-  linkType: hard
-
-"object.values@npm:^1.2.1":
+"object.values@npm:^1.1.0, object.values@npm:^1.1.6, object.values@npm:^1.2.0, object.values@npm:^1.2.1":
   version: 1.2.1
   resolution: "object.values@npm:1.2.1"
   dependencies:
@@ -20897,18 +20475,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"regexp.prototype.flags@npm:^1.5.2":
-  version: 1.5.3
-  resolution: "regexp.prototype.flags@npm:1.5.3"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-errors: "npm:^1.3.0"
-    set-function-name: "npm:^2.0.2"
-  checksum: 10c0/e1a7c7dc42cc91abf73e47a269c4b3a8f225321b7f617baa25821f6a123a91d23a73b5152f21872c566e699207e1135d075d2251cd3e84cc96d82a910adf6020
-  languageName: node
-  linkType: hard
-
 "regexp.prototype.flags@npm:^1.5.3, regexp.prototype.flags@npm:^1.5.4":
   version: 1.5.4
   resolution: "regexp.prototype.flags@npm:1.5.4"
@@ -21364,19 +20930,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"safe-array-concat@npm:^1.1.2":
-  version: 1.1.2
-  resolution: "safe-array-concat@npm:1.1.2"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    get-intrinsic: "npm:^1.2.4"
-    has-symbols: "npm:^1.0.3"
-    isarray: "npm:^2.0.5"
-  checksum: 10c0/12f9fdb01c8585e199a347eacc3bae7b5164ae805cdc8c6707199dbad5b9e30001a50a43c4ee24dc9ea32dbb7279397850e9208a7e217f4d8b1cf5d90129dec9
-  languageName: node
-  linkType: hard
-
-"safe-array-concat@npm:^1.1.3":
+"safe-array-concat@npm:^1.1.2, safe-array-concat@npm:^1.1.3":
   version: 1.1.3
   resolution: "safe-array-concat@npm:1.1.3"
   dependencies:
@@ -21413,18 +20967,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"safe-regex-test@npm:^1.0.3":
-  version: 1.0.3
-  resolution: "safe-regex-test@npm:1.0.3"
-  dependencies:
-    call-bind: "npm:^1.0.6"
-    es-errors: "npm:^1.3.0"
-    is-regex: "npm:^1.1.4"
-  checksum: 10c0/900bf7c98dc58f08d8523b7012b468e4eb757afa624f198902c0643d7008ba777b0bdc35810ba0b758671ce887617295fb742b3f3968991b178ceca54cb07603
-  languageName: node
-  linkType: hard
-
-"safe-regex-test@npm:^1.1.0":
+"safe-regex-test@npm:^1.0.3, safe-regex-test@npm:^1.1.0":
   version: 1.1.0
   resolution: "safe-regex-test@npm:1.1.0"
   dependencies:
@@ -21906,7 +21449,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"set-function-length@npm:^1.2.1, set-function-length@npm:^1.2.2":
+"set-function-length@npm:^1.2.2":
   version: 1.2.2
   resolution: "set-function-length@npm:1.2.2"
   dependencies:
@@ -22029,19 +21572,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"side-channel@npm:^1.0.4, side-channel@npm:^1.0.6":
-  version: 1.0.6
-  resolution: "side-channel@npm:1.0.6"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    es-errors: "npm:^1.3.0"
-    get-intrinsic: "npm:^1.2.4"
-    object-inspect: "npm:^1.13.1"
-  checksum: 10c0/d2afd163dc733cc0a39aa6f7e39bf0c436293510dbccbff446733daeaf295857dbccf94297092ec8c53e2503acac30f0b78830876f0485991d62a90e9cad305f
-  languageName: node
-  linkType: hard
-
-"side-channel@npm:^1.1.0":
+"side-channel@npm:^1.0.6, side-channel@npm:^1.1.0":
   version: 1.1.0
   resolution: "side-channel@npm:1.1.0"
   dependencies:
@@ -22674,30 +22205,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"string.prototype.trim@npm:^1.2.9":
-  version: 1.2.9
-  resolution: "string.prototype.trim@npm:1.2.9"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-abstract: "npm:^1.23.0"
-    es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/dcef1a0fb61d255778155006b372dff8cc6c4394bc39869117e4241f41a2c52899c0d263ffc7738a1f9e61488c490b05c0427faa15151efad721e1a9fb2663c2
-  languageName: node
-  linkType: hard
-
-"string.prototype.trimend@npm:^1.0.8":
-  version: 1.0.8
-  resolution: "string.prototype.trimend@npm:1.0.8"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    define-properties: "npm:^1.2.1"
-    es-object-atoms: "npm:^1.0.0"
-  checksum: 10c0/0a0b54c17c070551b38e756ae271865ac6cc5f60dabf2e7e343cceae7d9b02e1a1120a824e090e79da1b041a74464e8477e2da43e2775c85392be30a6f60963c
-  languageName: node
-  linkType: hard
-
-"string.prototype.trimend@npm:^1.0.9":
+"string.prototype.trimend@npm:^1.0.8, string.prototype.trimend@npm:^1.0.9":
   version: 1.0.9
   resolution: "string.prototype.trimend@npm:1.0.9"
   dependencies:
@@ -23190,17 +22698,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"tinyglobby@npm:^0.2.12":
-  version: 0.2.14
-  resolution: "tinyglobby@npm:0.2.14"
-  dependencies:
-    fdir: "npm:^6.4.4"
-    picomatch: "npm:^4.0.2"
-  checksum: 10c0/f789ed6c924287a9b7d3612056ed0cda67306cd2c80c249fd280cf1504742b12583a2089b61f4abbd24605f390809017240e250241f09938054c9b363e51c0a6
-  languageName: node
-  linkType: hard
-
-"tinyglobby@npm:^0.2.15":
+"tinyglobby@npm:^0.2.12, tinyglobby@npm:^0.2.15":
   version: 0.2.15
   resolution: "tinyglobby@npm:0.2.15"
   dependencies:
@@ -23557,17 +23055,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-buffer@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "typed-array-buffer@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    es-errors: "npm:^1.3.0"
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/9e043eb38e1b4df4ddf9dde1aa64919ae8bb909571c1cc4490ba777d55d23a0c74c7d73afcdd29ec98616d91bb3ae0f705fad4421ea147e1daf9528200b562da
-  languageName: node
-  linkType: hard
-
 "typed-array-buffer@npm:^1.0.3":
   version: 1.0.3
   resolution: "typed-array-buffer@npm:1.0.3"
@@ -23579,19 +23066,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-byte-length@npm:^1.0.1":
-  version: 1.0.1
-  resolution: "typed-array-byte-length@npm:1.0.1"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-proto: "npm:^1.0.3"
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/fcebeffb2436c9f355e91bd19e2368273b88c11d1acc0948a2a306792f1ab672bce4cfe524ab9f51a0505c9d7cd1c98eff4235c4f6bfef6a198f6cfc4ff3d4f3
-  languageName: node
-  linkType: hard
-
 "typed-array-byte-length@npm:^1.0.3":
   version: 1.0.3
   resolution: "typed-array-byte-length@npm:1.0.3"
@@ -23605,20 +23079,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-byte-offset@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "typed-array-byte-offset@npm:1.0.2"
-  dependencies:
-    available-typed-arrays: "npm:^1.0.7"
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-proto: "npm:^1.0.3"
-    is-typed-array: "npm:^1.1.13"
-  checksum: 10c0/d2628bc739732072e39269389a758025f75339de2ed40c4f91357023c5512d237f255b633e3106c461ced41907c1bf9a533c7e8578066b0163690ca8bc61b22f
-  languageName: node
-  linkType: hard
-
 "typed-array-byte-offset@npm:^1.0.4":
   version: 1.0.4
   resolution: "typed-array-byte-offset@npm:1.0.4"
@@ -23634,20 +23094,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"typed-array-length@npm:^1.0.6":
-  version: 1.0.6
-  resolution: "typed-array-length@npm:1.0.6"
-  dependencies:
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-proto: "npm:^1.0.3"
-    is-typed-array: "npm:^1.1.13"
-    possible-typed-array-names: "npm:^1.0.0"
-  checksum: 10c0/74253d7dc488eb28b6b2711cf31f5a9dcefc9c41b0681fd1c178ed0a1681b4468581a3626d39cd4df7aee3d3927ab62be06aa9ca74e5baf81827f61641445b77
-  languageName: node
-  linkType: hard
-
 "typed-array-length@npm:^1.0.7":
   version: 1.0.7
   resolution: "typed-array-length@npm:1.0.7"
@@ -23705,18 +23151,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"unbox-primitive@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "unbox-primitive@npm:1.0.2"
-  dependencies:
-    call-bind: "npm:^1.0.2"
-    has-bigints: "npm:^1.0.2"
-    has-symbols: "npm:^1.0.3"
-    which-boxed-primitive: "npm:^1.0.2"
-  checksum: 10c0/81ca2e81134167cc8f75fa79fbcc8a94379d6c61de67090986a2273850989dd3bae8440c163121b77434b68263e34787a675cbdcb34bb2f764c6b9c843a11b66
-  languageName: node
-  linkType: hard
-
 "unbox-primitive@npm:^1.1.0":
   version: 1.1.0
   resolution: "unbox-primitive@npm:1.1.0"
@@ -23729,13 +23163,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"undici-types@npm:~6.19.8":
-  version: 6.19.8
-  resolution: "undici-types@npm:6.19.8"
-  checksum: 10c0/078afa5990fba110f6824823ace86073b4638f1d5112ee26e790155f481f2a868cc3e0615505b6f4282bdf74a3d8caad715fd809e870c2bb0704e3ea6082f344
-  languageName: node
-  linkType: hard
-
 "undici-types@npm:~6.21.0":
   version: 6.21.0
   resolution: "undici-types@npm:6.21.0"
@@ -24593,19 +24020,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"which-boxed-primitive@npm:^1.0.2":
-  version: 1.0.2
-  resolution: "which-boxed-primitive@npm:1.0.2"
-  dependencies:
-    is-bigint: "npm:^1.0.1"
-    is-boolean-object: "npm:^1.1.0"
-    is-number-object: "npm:^1.0.4"
-    is-string: "npm:^1.0.5"
-    is-symbol: "npm:^1.0.3"
-  checksum: 10c0/0a62a03c00c91dd4fb1035b2f0733c341d805753b027eebd3a304b9cb70e8ce33e25317add2fe9b5fea6f53a175c0633ae701ff812e604410ddd049777cd435e
-  languageName: node
-  linkType: hard
-
 "which-boxed-primitive@npm:^1.1.0, which-boxed-primitive@npm:^1.1.1":
   version: 1.1.1
   resolution: "which-boxed-primitive@npm:1.1.1"
@@ -24659,19 +24073,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"which-typed-array@npm:^1.1.14, which-typed-array@npm:^1.1.15":
-  version: 1.1.15
-  resolution: "which-typed-array@npm:1.1.15"
-  dependencies:
-    available-typed-arrays: "npm:^1.0.7"
-    call-bind: "npm:^1.0.7"
-    for-each: "npm:^0.3.3"
-    gopd: "npm:^1.0.1"
-    has-tostringtag: "npm:^1.0.2"
-  checksum: 10c0/4465d5348c044032032251be54d8988270e69c6b7154f8fcb2a47ff706fe36f7624b3a24246b8d9089435a8f4ec48c1c1025c5d6b499456b9e5eff4f48212983
-  languageName: node
-  linkType: hard
-
 "which-typed-array@npm:^1.1.16, which-typed-array@npm:^1.1.19":
   version: 1.1.20
   resolution: "which-typed-array@npm:1.1.20"

From b6d3eeb8d06dbb035cbe79968771ac43bbe9b077 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 3 Apr 2026 12:40:34 -0400
Subject: [PATCH 21/37] lint fix

---
 tools/gamut-release/src/main.ts | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/tools/gamut-release/src/main.ts b/tools/gamut-release/src/main.ts
index d09983cbb80..2655c033a81 100644
--- a/tools/gamut-release/src/main.ts
+++ b/tools/gamut-release/src/main.ts
@@ -12,14 +12,15 @@
  *   npx nx run gamut-release:alpha --preid=alpha.abc123 [--manifest[=path]]
  */
 
+import { writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+
 import { Command } from '@commander-js/extra-typings';
 import {
   createProjectGraphAsync,
   readJsonFile,
   workspaceRoot,
 } from '@nx/devkit';
-import { writeFile } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
 import { releasePublish, releaseVersion } from 'nx/release/index.js';
 
 type AlphaReleaseOptions = {

From e103d5d1eb2741f9545c586d5f63916c84e4fbbc Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 3 Apr 2026 13:12:15 -0400
Subject: [PATCH 22/37] release plan update

---
 .nx/version-plans/version-plan-1775236316343.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 .nx/version-plans/version-plan-1775236316343.md

diff --git a/.nx/version-plans/version-plan-1775236316343.md b/.nx/version-plans/version-plan-1775236316343.md
new file mode 100644
index 00000000000..3297265a400
--- /dev/null
+++ b/.nx/version-plans/version-plan-1775236316343.md
@@ -0,0 +1,12 @@
+---
+eslint-plugin-gamut: major
+gamut-illustrations: major
+gamut-patterns: major
+gamut-styles: major
+gamut-icons: major
+gamut-tests: major
+variance: major
+gamut: major
+---
+
+React 18+19

From 71b5d00e63f6d18fc1ec69b8338153ec898f3ead Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Wed, 15 Apr 2026 17:13:29 -0400
Subject: [PATCH 23/37] update plan

---
 .nx/version-plans/version-plan-1775222101294.md | 11 -----------
 .nx/version-plans/version-plan-1775236316343.md |  2 +-
 2 files changed, 1 insertion(+), 12 deletions(-)
 delete mode 100644 .nx/version-plans/version-plan-1775222101294.md

diff --git a/.nx/version-plans/version-plan-1775222101294.md b/.nx/version-plans/version-plan-1775222101294.md
deleted file mode 100644
index eb5fc9a63f4..00000000000
--- a/.nx/version-plans/version-plan-1775222101294.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-gamut-illustrations: major
-gamut-patterns: major
-gamut-styles: major
-gamut-icons: major
-gamut-tests: major
-variance: major
-gamut: major
----
-
-Update to React 19 compatibility
diff --git a/.nx/version-plans/version-plan-1775236316343.md b/.nx/version-plans/version-plan-1775236316343.md
index 3297265a400..084c9eb4a58 100644
--- a/.nx/version-plans/version-plan-1775236316343.md
+++ b/.nx/version-plans/version-plan-1775236316343.md
@@ -9,4 +9,4 @@ variance: major
 gamut: major
 ---
 
-React 18+19
+React 18+19 compatibility: workspace on React 19; peers support React 18.3 and 19. Includes eslint-plugin-gamut and core Gamut packages (major bumps per plan).

From 60ded6f35d675a6901660099a2f1ef41fb4aa41a Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 1 May 2026 16:46:57 -0400
Subject: [PATCH 24/37] fix failing tests from merge

---
 .../src/__tests__/AssetProvider.test.tsx      |  2 +-
 .../src/__tests__/fontLoading.test.tsx        |  2 +-
 packages/gamut-tests/package.json             |  2 +-
 .../src/Popover/__tests__/Popover.test.tsx    |  2 +-
 yarn.lock                                     | 60 +------------------
 5 files changed, 5 insertions(+), 63 deletions(-)

diff --git a/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx b/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
index f8fe24cc464..738d1b3d243 100644
--- a/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
+++ b/packages/gamut-styles/src/__tests__/AssetProvider.test.tsx
@@ -9,7 +9,7 @@ import { setupRtl } from './testUtils';
 
 const renderView = setupRtl(AssetProvider, {});
 
-jest.mock('../utils/fontUtils', () => ({
+jest.mock('../utilities/fontUtils', () => ({
   getFonts: require('./fontUtilsMock').getFontsMock,
 }));
 
diff --git a/packages/gamut-styles/src/__tests__/fontLoading.test.tsx b/packages/gamut-styles/src/__tests__/fontLoading.test.tsx
index c5cbdabed2c..0d9ae7c3193 100644
--- a/packages/gamut-styles/src/__tests__/fontLoading.test.tsx
+++ b/packages/gamut-styles/src/__tests__/fontLoading.test.tsx
@@ -6,7 +6,7 @@ import { getFontsMock } from './fontUtilsMock';
 
 const typedPercipioTheme = percipioTheme as any;
 
-jest.mock('../utils/fontUtils', () => ({
+jest.mock('../utilities/fontUtils', () => ({
   getFonts: require('./fontUtilsMock').getFontsMock,
 }));
 
diff --git a/packages/gamut-tests/package.json b/packages/gamut-tests/package.json
index 55ee02cd840..64e2bc3d044 100644
--- a/packages/gamut-tests/package.json
+++ b/packages/gamut-tests/package.json
@@ -4,7 +4,7 @@
   "version": "5.3.4",
   "author": "Codecademy Engineering <dev@codecademy.com>",
   "dependencies": {
-    "@codecademy/gamut-styles": "17.13.1",
+    "@codecademy/gamut-styles": "17.14.0",
     "component-test-setup": "^0.3.1",
     "lodash": "^4.17.23"
   },
diff --git a/packages/gamut/src/Popover/__tests__/Popover.test.tsx b/packages/gamut/src/Popover/__tests__/Popover.test.tsx
index 625d79f98e0..a6881af6069 100644
--- a/packages/gamut/src/Popover/__tests__/Popover.test.tsx
+++ b/packages/gamut/src/Popover/__tests__/Popover.test.tsx
@@ -2,7 +2,7 @@ import { CheckerDense } from '@codecademy/gamut-patterns';
 import { theme } from '@codecademy/gamut-styles';
 import { setupRtl } from '@codecademy/gamut-tests';
 import { ThemeProvider } from '@emotion/react';
-import { fireEvent, render, screen } from '@testing-library/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
 import React from 'react';
 
 import { Popover, PopoverProps } from '..';
diff --git a/yarn.lock b/yarn.lock
index 67a476c8b8f..bc7185f860d 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1617,26 +1617,6 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@codecademy/gamut-styles@npm:17.13.1":
-  version: 17.13.1
-  resolution: "@codecademy/gamut-styles@npm:17.13.1"
-  dependencies:
-    "@codecademy/variance": "npm:0.26.1"
-    "@emotion/is-prop-valid": "npm:^1.1.0"
-    framer-motion: "npm:^11.18.0"
-    get-nonce: "npm:^1.0.0"
-    polished: "npm:^4.1.2"
-  peerDependencies:
-    "@emotion/cache": ^11.4.0
-    "@emotion/react": ^11.4.0
-    "@emotion/styled": ^11.3.0
-    lodash: ^4.17.23
-    react: ^17.0.2 || ^18.3.0
-    stylis: ^4.0.7
-  checksum: 10c0/bcfcbb2f8b40fd6635d1203545822b92ae3d3e2273e9e2a79138de577d1fe3812f5acc208da53e2fe6e81d1037fef5bb38e3b61b8cc3b805da09c422ece69407
-  languageName: node
-  linkType: hard
-
 "@codecademy/gamut-styles@npm:17.14.0, @codecademy/gamut-styles@workspace:packages/gamut-styles":
   version: 0.0.0-use.local
   resolution: "@codecademy/gamut-styles@workspace:packages/gamut-styles"
@@ -1660,7 +1640,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@codecademy/gamut-tests@workspace:packages/gamut-tests"
   dependencies:
-    "@codecademy/gamut-styles": "npm:17.13.1"
+    "@codecademy/gamut-styles": "npm:17.14.0"
     component-test-setup: "npm:^0.3.1"
     lodash: "npm:^4.17.23"
   peerDependencies:
@@ -13193,28 +13173,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"framer-motion@npm:^11.18.0":
-  version: 11.18.2
-  resolution: "framer-motion@npm:11.18.2"
-  dependencies:
-    motion-dom: "npm:^11.18.1"
-    motion-utils: "npm:^11.18.1"
-    tslib: "npm:^2.4.0"
-  peerDependencies:
-    "@emotion/is-prop-valid": "*"
-    react: ^18.0.0 || ^19.0.0
-    react-dom: ^18.0.0 || ^19.0.0
-  peerDependenciesMeta:
-    "@emotion/is-prop-valid":
-      optional: true
-    react:
-      optional: true
-    react-dom:
-      optional: true
-  checksum: 10c0/41b1ef1b4e54ea13adaf01d61812a8783d2352f74641c91b50519775704bc6274db6b6863ff494a1f705fa6c6ed8f4df3497292327c906d53ea0129cef3ec361
-  languageName: node
-  linkType: hard
-
 "framer-motion@npm:^12.0.0":
   version: 12.37.0
   resolution: "framer-motion@npm:12.37.0"
@@ -17850,15 +17808,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"motion-dom@npm:^11.18.1":
-  version: 11.18.1
-  resolution: "motion-dom@npm:11.18.1"
-  dependencies:
-    motion-utils: "npm:^11.18.1"
-  checksum: 10c0/98378bdf9d77870829cdf3624c5eff02e48cfa820dfc74450364d7421884700048d60e277bfbf477df33270fbae4c1980e5914586f5b6dff28d4921fdca8ac47
-  languageName: node
-  linkType: hard
-
 "motion-dom@npm:^12.37.0":
   version: 12.37.0
   resolution: "motion-dom@npm:12.37.0"
@@ -17868,13 +17817,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"motion-utils@npm:^11.18.1":
-  version: 11.18.1
-  resolution: "motion-utils@npm:11.18.1"
-  checksum: 10c0/dac083bdeb6e433a277ac4362211b0fdce59ff09d6f7897f0f49d1e3561209c6481f676876daf99a33485054bc7e4b1d1b8d1de16f7b1e5c6f117fe76358ca00
-  languageName: node
-  linkType: hard
-
 "motion-utils@npm:^12.36.0":
   version: 12.36.0
   resolution: "motion-utils@npm:12.36.0"

From 1e9898d59b554c4deff319ead48cc1606d589576 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 1 May 2026 17:24:11 -0400
Subject: [PATCH 25/37] fix popover refs + Dialog/Modal

---
 packages/gamut/src/Modals/Dialog.tsx          | 21 ++---
 packages/gamut/src/Modals/Modal.tsx           | 14 ++--
 packages/gamut/src/Popover/Popover.tsx        | 10 ++-
 packages/gamut/src/Popover/types.tsx          |  4 +-
 .../PopoverContainer/__tests__/hooks.test.tsx | 21 +++--
 packages/gamut/src/PopoverContainer/hooks.ts  | 77 +++++++++++++------
 6 files changed, 91 insertions(+), 56 deletions(-)

diff --git a/packages/gamut/src/Modals/Dialog.tsx b/packages/gamut/src/Modals/Dialog.tsx
index c5bb58d2fa2..ea8fe3698b2 100644
--- a/packages/gamut/src/Modals/Dialog.tsx
+++ b/packages/gamut/src/Modals/Dialog.tsx
@@ -1,5 +1,5 @@
 import { MiniDeleteIcon } from '@codecademy/gamut-icons';
-import { ComponentProps } from 'react';
+import { ComponentProps, useId } from 'react';
 import * as React from 'react';
 
 import { Box } from '../Box';
@@ -47,6 +47,8 @@ export const Dialog: React.FC<DialogProps> = ({
   size = 'small',
   ...rest
 }) => {
+  const titleId = useId();
+
   const onConfirm: DialogButtonProps['onClick'] = (
     e: React.MouseEvent<HTMLButtonElement, MouseEvent>
   ) => {
@@ -65,13 +67,8 @@ export const Dialog: React.FC<DialogProps> = ({
     <Overlay shroud onRequestClose={onCancel as () => void} {...rest}>
       <ModalContainer
         aria-hidden="false"
-        aria-label="dialog"
-        aria-labelledby={
-          !isNullish(title) &&
-          (typeof title === 'string' || typeof title === 'number')
-            ? String(title)
-            : undefined
-        }
+        aria-label={isNullish(title) ? 'dialog' : undefined}
+        aria-labelledby={!isNullish(title) ? titleId : undefined}
         aria-modal="true"
         data-autofocus
         layout="dialog"
@@ -80,7 +77,13 @@ export const Dialog: React.FC<DialogProps> = ({
         size={size}
         tabIndex={-1}
       >
-        <Text as="h2" fontSize={20} gridArea="title" lineHeight="base">
+        <Text
+          as="h2"
+          fontSize={20}
+          gridArea="title"
+          id={!isNullish(title) ? titleId : undefined}
+          lineHeight="base"
+        >
           {title}
         </Text>
         {!hideCloseButton && (
diff --git a/packages/gamut/src/Modals/Modal.tsx b/packages/gamut/src/Modals/Modal.tsx
index 085bc516109..550d8981ecb 100644
--- a/packages/gamut/src/Modals/Modal.tsx
+++ b/packages/gamut/src/Modals/Modal.tsx
@@ -1,12 +1,11 @@
 import { MiniDeleteIcon } from '@codecademy/gamut-icons';
-import { ComponentProps, useState } from 'react';
+import { ComponentProps, useId, useState } from 'react';
 import * as React from 'react';
 
 import { Box } from '../Box';
 import { ButtonProps, FillButton, IconButton, TextButton } from '../Button';
 import { Overlay } from '../Overlay';
 import { Text } from '../Typography';
-import { isNullish } from '../utils/nullish';
 import { ModalContainer } from './elements';
 import { ImageContainer } from './ImageContainer';
 import { CloseButtonProps, ModalBaseProps } from './types';
@@ -96,11 +95,14 @@ export const Modal: React.FC<ModalProps> = ({
   views,
   ...rest
 }) => {
+  const titleId = useId();
   const [currentView, setCurrentView] = useState(0);
   const view = views?.[currentView];
   const image = (view?.image || rest?.image) ?? null;
 
   const titleText = title || views?.[currentView].title;
+  const needsLabelledBy = titleText && !ariaLabel;
+
   return (
     <Overlay
       data-testid="modal"
@@ -111,12 +113,7 @@ export const Modal: React.FC<ModalProps> = ({
       <ModalContainer
         aria-hidden="false"
         aria-label={ariaLabel}
-        aria-labelledby={
-          !isNullish(titleText) &&
-          (typeof titleText === 'string' || typeof titleText === 'number')
-            ? String(titleText)
-            : undefined
-        }
+        aria-labelledby={needsLabelledBy ? titleId : undefined}
         aria-modal="true"
         className={className}
         data-autofocus
@@ -131,6 +128,7 @@ export const Modal: React.FC<ModalProps> = ({
             as={headingLevel}
             fontSize={20}
             gridArea="title"
+            id={titleId}
             lineHeight="base"
           >
             {titleText}
diff --git a/packages/gamut/src/Popover/Popover.tsx b/packages/gamut/src/Popover/Popover.tsx
index f3387aca88a..be8421842cb 100755
--- a/packages/gamut/src/Popover/Popover.tsx
+++ b/packages/gamut/src/Popover/Popover.tsx
@@ -1,5 +1,4 @@
 import { useElementDir, useLogicalProperties } from '@codecademy/gamut-styles';
-import type { RefObject } from 'react';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useWindowScroll, useWindowSize } from 'react-use';
 
@@ -55,7 +54,7 @@ export const Popover: React.FC<PopoverProps> = ({
   const popoverRef = useRef<HTMLDivElement>(null);
 
   const logicalPropsEnabled = useLogicalProperties();
-  const isRtl = useElementDir(targetRef as RefObject<Element | null>) === 'rtl';
+  const isRtl = useElementDir(targetRef) === 'rtl';
 
   // This only needs to resolve the positioning - the beak uses logical properties so will automatically mirror in RTL.
   const resolvedSideAlign = useMemo(() => {
@@ -201,7 +200,7 @@ export const Popover: React.FC<PopoverProps> = ({
     },
     [onRequestClose, targetRef]
   );
-  if ((!isOpen || !targetRef) && !animation) return null;
+  if ((!isOpen || !targetRef.current) && !animation) return null;
   const alignment =
     (variant === 'primary' || beak) && beak !== 'center'
       ? 'aligned'
@@ -255,7 +254,10 @@ export const Popover: React.FC<PopoverProps> = ({
   );
 
   return (
-    <PopoverPortal animation={animation} isOpen={Boolean(isOpen && targetRef)}>
+    <PopoverPortal
+      animation={animation}
+      isOpen={Boolean(isOpen && targetRef.current)}
+    >
       {skipFocusTrap ? (
         <>{contents}</>
       ) : (
diff --git a/packages/gamut/src/Popover/types.tsx b/packages/gamut/src/Popover/types.tsx
index c2d9ab52670..6c931a6e284 100755
--- a/packages/gamut/src/Popover/types.tsx
+++ b/packages/gamut/src/Popover/types.tsx
@@ -1,5 +1,5 @@
 import { PatternProps } from '@codecademy/gamut-patterns';
-import { HTMLAttributes } from 'react';
+import { HTMLAttributes, type RefObject } from 'react';
 
 import { PopoverVariants } from './elements';
 
@@ -106,7 +106,7 @@ export type PopoverProps = PopoverBaseProps &
      * The target element around which the popover will be positioned.
      * Only ref objects (e.g. from useRef) are supported at runtime; RefCallback is not.
      */
-    targetRef: React.Ref<HTMLElement | null>;
+    targetRef: RefObject<HTMLElement | null>;
 
     /**
      * The PopoverContainer which contents will be rendered into.
diff --git a/packages/gamut/src/PopoverContainer/__tests__/hooks.test.tsx b/packages/gamut/src/PopoverContainer/__tests__/hooks.test.tsx
index b97fa2718ed..eb56581b968 100644
--- a/packages/gamut/src/PopoverContainer/__tests__/hooks.test.tsx
+++ b/packages/gamut/src/PopoverContainer/__tests__/hooks.test.tsx
@@ -1,6 +1,7 @@
 import { cleanup, render, screen } from '@testing-library/react';
-import React, { useLayoutEffect, useRef, useState } from 'react';
+import { useLayoutEffect, useRef, useState } from 'react';
 
+import { Box } from '../../Box';
 import { useScrollingParents } from '../hooks';
 
 /**
@@ -21,19 +22,17 @@ const ScrollingParentsFixture = ({ showTarget }: { showTarget: boolean }) => {
   }, [showTarget]);
 
   return (
-    <div
+    <Box
       data-testid="scrollable-root"
-      style={{
-        overflow: 'auto',
-        height: 200,
-        width: 500,
-        position: 'relative',
-      }}
+      height={200}
+      overflow="auto"
+      position="relative"
+      width={500}
     >
-      <div style={{ height: 2000, width: 500 }} />
-      {showTarget && <div ref={ref} data-testid="inner-target" />}
+      <Box height={2000} width={500} />
+      {showTarget && <div data-testid="inner-target" ref={ref} />}
       <span data-testid="parent-count">{parents.length}</span>
-    </div>
+    </Box>
   );
 };
 
diff --git a/packages/gamut/src/PopoverContainer/hooks.ts b/packages/gamut/src/PopoverContainer/hooks.ts
index 8e74cdc545a..7a20d6b838e 100644
--- a/packages/gamut/src/PopoverContainer/hooks.ts
+++ b/packages/gamut/src/PopoverContainer/hooks.ts
@@ -1,4 +1,10 @@
-import { useEffect, useMemo } from 'react';
+import {
+  type RefObject,
+  useEffect,
+  useLayoutEffect,
+  useMemo,
+  useState,
+} from 'react';
 
 import { isNullish } from '../utils/nullish';
 import { findAllAdditionalScrollingParents, findResizingParent } from './utils';
@@ -12,12 +18,11 @@ export interface PopoverTargetElement {
   contains(other: Node | null): boolean;
 }
 
-/** Resolves Ref to current element; returns null for RefCallback or null ref. */
+/** Resolves ref object to current element; returns null when unset. */
 export function getRefElement(
-  ref: React.Ref<PopoverTargetElement | null>
+  ref: RefObject<PopoverTargetElement | null>
 ): PopoverTargetElement | null {
   if (isNullish(ref)) return null;
-  if (typeof ref === 'function') return null;
   return ref.current;
 }
 
@@ -28,21 +33,43 @@ export function getTargetAsElement(
   return target as HTMLElement | null;
 }
 
+/**
+ * Syncs ref.current to React state after each commit so hooks can depend on the
+ * resolved element when ref object identity is stable but .current updates.
+ */
+function useResolvedRefTarget(
+  targetRef: RefObject<PopoverTargetElement | null>
+): PopoverTargetElement | null {
+  const [resolved, setResolved] = useState<PopoverTargetElement | null>(() =>
+    getRefElement(targetRef)
+  );
+
+  // ref.current updates do not change targetRef identity; run after every commit
+  // to sync. Functional setState bails out when the resolved node is unchanged.
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional post-commit ref sync
+  useLayoutEffect(() => {
+    const el = getRefElement(targetRef);
+    setResolved((prev) => (prev === el ? prev : el));
+  });
+
+  return resolved;
+}
+
 export const useScrollingParentsEffect = (
-  targetRef: React.Ref<PopoverTargetElement | null>,
+  targetRef: RefObject<PopoverTargetElement | null>,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
+  const resolvedTarget = useResolvedRefTarget(targetRef);
+
   useEffect(() => {
-    const target = getRefElement(targetRef);
-    if (!target) return;
+    if (!resolvedTarget) return;
 
     const scrollingParents = findAllAdditionalScrollingParents(
-      getTargetAsElement(target)!
+      getTargetAsElement(resolvedTarget)!
     );
 
     const updatePosition = () => {
-      const el = getRefElement(targetRef);
-      setTargetRect(el?.getBoundingClientRect());
+      setTargetRect(resolvedTarget.getBoundingClientRect());
     };
 
     const cleanup: (() => void)[] = [];
@@ -59,27 +86,30 @@ export const useScrollingParentsEffect = (
     return () => {
       cleanup.forEach((fn) => fn());
     };
-  }, [targetRef, setTargetRect]);
+  }, [resolvedTarget, setTargetRect]);
 };
 
 export const useResizingParentEffect = (
-  targetRef: React.Ref<PopoverTargetElement | null>,
+  targetRef: RefObject<PopoverTargetElement | null>,
   setTargetRect: (rect: DOMRect | undefined) => void
 ) => {
+  const resolvedTarget = useResolvedRefTarget(targetRef);
+
   useEffect(() => {
-    const target = getRefElement(targetRef);
-    if (!target || typeof ResizeObserver === 'undefined') return;
+    if (!resolvedTarget || typeof ResizeObserver === 'undefined') return;
 
-    const resizingParent = findResizingParent(getTargetAsElement(target)!);
+    const resizingParent = findResizingParent(
+      getTargetAsElement(resolvedTarget)!
+    );
     if (!resizingParent?.addEventListener) return;
 
     const handler = () => {
-      setTargetRect(getRefElement(targetRef)?.getBoundingClientRect());
+      setTargetRect(resolvedTarget.getBoundingClientRect());
     };
     const ro = new ResizeObserver(handler);
     ro.observe(resizingParent);
     return () => ro.unobserve(resizingParent);
-  }, [targetRef, setTargetRect]);
+  }, [resolvedTarget, setTargetRect]);
 };
 
 /**
@@ -87,11 +117,14 @@ export const useResizingParentEffect = (
  * Returns an empty array if the target element is not available.
  */
 export const useScrollingParents = (
-  targetRef: React.Ref<PopoverTargetElement | null>
+  targetRef: RefObject<PopoverTargetElement | null>
 ): HTMLElement[] => {
+  const resolvedTarget = useResolvedRefTarget(targetRef);
+
   return useMemo(() => {
-    const target = getRefElement(targetRef);
-    if (!target) return [];
-    return findAllAdditionalScrollingParents(getTargetAsElement(target)!);
-  }, [targetRef]);
+    if (!resolvedTarget) return [];
+    return findAllAdditionalScrollingParents(
+      getTargetAsElement(resolvedTarget)!
+    );
+  }, [resolvedTarget]);
 };

From 2bdb59b18a3fd82dad320cf388a832b59a1ca3df Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Mon, 4 May 2026 15:08:34 -0400
Subject: [PATCH 26/37] chore: add beta dist-tag publish workflow

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .github/actions/prerelease-publish/action.yml | 127 ++++++++++++++++++
 .github/workflows/publish-alpha.yml           | 102 +++-----------
 .github/workflows/publish-beta.yml            |  41 ++++++
 README.md                                     |  14 +-
 tools/gamut-release/README.md                 |  18 ++-
 tools/gamut-release/project.json              |   2 +-
 tools/gamut-release/src/main.ts               |  18 ++-
 7 files changed, 220 insertions(+), 102 deletions(-)
 create mode 100644 .github/actions/prerelease-publish/action.yml
 create mode 100644 .github/workflows/publish-beta.yml

diff --git a/.github/actions/prerelease-publish/action.yml b/.github/actions/prerelease-publish/action.yml
new file mode 100644
index 00000000000..ac33186c08f
--- /dev/null
+++ b/.github/actions/prerelease-publish/action.yml
@@ -0,0 +1,127 @@
+name: PR prerelease npm publish
+description: Checkout, setup, build publish targets, gamut-release, and sticky PR comment
+
+inputs:
+  node-auth-token:
+    description: NPM token value (pass secrets.NODE_AUTH_TOKEN)
+    required: true
+  gh-token:
+    description: GitHub token for release tooling (pass secrets.ACTIONS_GITHUB_TOKEN)
+    required: true
+  ignore-commit-message:
+    description: Commit message prefix to skip (chore release commits)
+    required: true
+  manifest-path:
+    description: JSON manifest path written by gamut-release
+    required: true
+  comment-path:
+    description: Markdown file path for the PR comment body
+    required: true
+  comment-title:
+    description: Title line after the emoji (e.g. Published Alpha Packages)
+    required: true
+  sticky-header:
+    description: Sticky comment header key
+    required: true
+  publish-run:
+    description: Bash to set PREID and run gamut-release:pre-release
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        filter: tree:0
+        ref: ${{ github.event.pull_request.head.ref }}
+
+    - name: Setup and Build
+      id: setup
+      uses: ./.github/actions/yarn
+
+    - name: Set git user
+      uses: ./.github/actions/set-git-user
+
+    - name: Set npm token
+      uses: ./.github/actions/set-npm-token
+      with:
+        token-secret: ${{ inputs.node-auth-token }}
+
+    - name: Ensure workflow is associated with a pull request
+      uses: ./.github/actions/validate-pr-context
+
+    - name: Skip build from automated commit
+      uses: ./.github/actions/skip-automated-commits
+      with:
+        ignore-commit-message: ${{ inputs.ignore-commit-message }}
+
+    - run: npx nx run-many --target=publish-build --parallel=3
+      shell: bash
+
+    - name: Publish prerelease packages
+      id: publish-prerelease
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.gh-token }}
+        NODE_AUTH_TOKEN: ${{ inputs.node-auth-token }}
+      run: |
+        ${{ inputs.publish-run }}
+
+    - name: Build prerelease packages comment
+      id: build-comment
+      continue-on-error: true
+      uses: actions/github-script@v7
+      env:
+        MANIFEST_PATH: ${{ inputs.manifest-path }}
+        OUTPUT_PATH: ${{ inputs.comment-path }}
+        COMMENT_TITLE: ${{ inputs.comment-title }}
+      with:
+        script: |
+          const fs = require('fs');
+          const core = require('@actions/core');
+          const manifestPath = process.env.MANIFEST_PATH;
+          const outputPath = process.env.OUTPUT_PATH;
+          const commentTitle = process.env.COMMENT_TITLE;
+          if (!fs.existsSync(manifestPath)) {
+            fs.writeFileSync(outputPath, '');
+            core.setOutput('has_comment', 'false');
+            return;
+          }
+
+          const entries = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+          if (!Array.isArray(entries) || entries.length === 0) {
+            fs.writeFileSync(outputPath, '');
+            core.setOutput('has_comment', 'false');
+            return;
+          }
+
+          const tableLines = [
+            '| Package | Version | npm | Diff |',
+            '| --- | --- | --- | --- |',
+            ...entries.map((entry) => {
+              const pkgUrl = `https://www.npmjs.com/package/${entry.name}`;
+              const versionUrl = `${pkgUrl}/v/${entry.version}`;
+              const baseVersion = entry.previousVersion || null;
+              const diffUrl = baseVersion
+                ? `https://npmdiff.dev/${encodeURIComponent(
+                    entry.name
+                  )}/${baseVersion}/${entry.version}/`
+                : null;
+              const npmLink = `[npm](${versionUrl})`;
+              const diffLink = diffUrl ? `[diff](${diffUrl})` : 'N/A';
+
+              return `| \`${entry.name}\` | \`${entry.version}\` | ${npmLink} | ${diffLink} |`;
+            }),
+          ];
+          const comment = `📬 ${commentTitle}\n\n${tableLines.join('\n')}\n`;
+          fs.writeFileSync(outputPath, comment);
+          core.setOutput('has_comment', 'true');
+
+    - name: Comment with published packages
+      uses: ./.github/actions/sticky-comment
+      if: ${{ !cancelled() && steps.build-comment.outputs.has_comment == 'true' }}
+      with:
+        github-token: ${{ inputs.gh-token }}
+        header: ${{ inputs.sticky-header }}
+        message-path: ${{ inputs.comment-path }}
diff --git a/.github/workflows/publish-alpha.yml b/.github/workflows/publish-alpha.yml
index b1d926c845c..b968dd17558 100644
--- a/.github/workflows/publish-alpha.yml
+++ b/.github/workflows/publish-alpha.yml
@@ -17,94 +17,26 @@ permissions:
   issues: write
   actions: write
 
+concurrency:
+  group: npm-prerelease-${{ github.event.pull_request.number }}
+  cancel-in-progress: false
+
 jobs:
   publish-alpha:
+    if: ${{ !contains(github.event.pull_request.labels.*.name, 'beta') }}
     runs-on: ubuntu-22.04
+    timeout-minutes: 30
     steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          ref: ${{  github.event.pull_request.head.ref }}
-
-      - name: Setup and Build
-        id: setup
-        uses: ./.github/actions/yarn
-
-      - name: Set git user
-        uses: ./.github/actions/set-git-user
-
-      - name: Set npm token
-        uses: ./.github/actions/set-npm-token
-        with:
-          token-secret: ${{ secrets.NODE_AUTH_TOKEN }}
-
-      - name: Ensure workflow is associated with a pull request
-        uses: ./.github/actions/validate-pr-context
-
-      - name: Skip build from automated commit
-        uses: ./.github/actions/skip-automated-commits
+      - uses: ./.github/actions/prerelease-publish
         with:
+          node-auth-token: ${{ secrets.NODE_AUTH_TOKEN }}
+          gh-token: ${{ secrets.ACTIONS_GITHUB_TOKEN }}
           ignore-commit-message: ${{ env.IGNORE_COMMIT_MESSAGE }}
-
-      - run: npx nx run-many --target=publish-build --parallel=3
-
-      - name: Publish alpha packages
-        id: publish-alpha
-        run: |
-          SHORT_SHA=${GITHUB_SHA:0:6}
-          PREID="alpha.${SHORT_SHA}"
-          npx nx run gamut-release:alpha --preid="${PREID}" --manifest
-        env:
-          GH_TOKEN: ${{ secrets.ACTIONS_GITHUB_TOKEN }}
-          NODE_AUTH_TOKEN: ${{ secrets.NODE_AUTH_TOKEN  }}
-
-      - name: List alpha packages versions
-        id: published
-        continue-on-error: true
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const fs = require('fs');
-            const manifestPath = 'alpha-publish-manifest.json';
-            const outputPath = 'alpha-publish-comment.md';
-            if (!fs.existsSync(manifestPath)) {
-              fs.writeFileSync(outputPath, '');
-              return;
-            }
-
-            const entries = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-            if (!Array.isArray(entries) || entries.length === 0) {
-              fs.writeFileSync(outputPath, '');
-              return;
-            }
-
-            const tableLines = [
-              '| Package | Version | npm | Diff |',
-              '| --- | --- | --- | --- |',
-              ...entries.map((entry) => {
-                const pkgUrl = `https://www.npmjs.com/package/${entry.name}`;
-                const versionUrl = `${pkgUrl}/v/${entry.version}`;
-                const baseVersion = entry.previousVersion || null;
-                const diffUrl = baseVersion
-                  ? `https://npmdiff.dev/${encodeURIComponent(
-                      entry.name
-                    )}/${baseVersion}/${entry.version}/`
-                  : null;
-                const npmLink = `[npm](${versionUrl})`;
-                const diffLink = diffUrl ? `[diff](${diffUrl})` : 'N/A';
-
-                return `| \`${entry.name}\` | \`${entry.version}\` | ${npmLink} | ${diffLink} |`;
-              }),
-            ];
-            const comment = `📬 Published Alpha Packages:\n\n${tableLines.join(
-              '\n'
-            )}\n`;
-            fs.writeFileSync(outputPath, comment);
-
-      - name: Comment with published alpha packages
-        uses: ./.github/actions/sticky-comment
-        if: ${{ !cancelled() && hashFiles('alpha-publish-comment.md') != '' }}
-        with:
-          github-token: ${{ secrets.ACTIONS_GITHUB_TOKEN }}
-          header: Alpha Packages
-          message-path: alpha-publish-comment.md
+          manifest-path: alpha-publish-manifest.json
+          comment-path: alpha-publish-comment.md
+          comment-title: Published Alpha Packages
+          sticky-header: Alpha Packages
+          publish-run: |
+            SHORT_SHA=${GITHUB_SHA:0:6}
+            PREID="alpha.${SHORT_SHA}"
+            npx nx run gamut-release:pre-release --preid="${PREID}" --manifest
diff --git a/.github/workflows/publish-beta.yml b/.github/workflows/publish-beta.yml
new file mode 100644
index 00000000000..b99c09cb970
--- /dev/null
+++ b/.github/workflows/publish-beta.yml
@@ -0,0 +1,41 @@
+name: Publish Beta
+
+on:
+  pull_request:
+    types: [labeled]
+
+env:
+  NODE_VERSION: '22.13.1'
+  NODE_OPTIONS: '--max_old_space_size=8196'
+  NX_CLOUD: false
+  IGNORE_COMMIT_MESSAGE: 'chore(release): publish'
+
+permissions:
+  id-token: write
+  contents: read
+  pull-requests: write
+  issues: write
+  actions: write
+
+concurrency:
+  group: npm-prerelease-${{ github.event.pull_request.number }}
+  cancel-in-progress: false
+
+jobs:
+  publish-beta:
+    if: github.event.label.name == 'beta' && github.event.pull_request.head.ref == 'cass-gmt-1473-beta'
+    runs-on: ubuntu-22.04
+    timeout-minutes: 30
+    steps:
+      - uses: ./.github/actions/prerelease-publish
+        with:
+          node-auth-token: ${{ secrets.NODE_AUTH_TOKEN }}
+          gh-token: ${{ secrets.ACTIONS_GITHUB_TOKEN }}
+          ignore-commit-message: ${{ env.IGNORE_COMMIT_MESSAGE }}
+          manifest-path: beta-publish-manifest.json
+          comment-path: beta-publish-comment.md
+          comment-title: 'Published Beta Packages (install with `@beta`):'
+          sticky-header: Beta Packages
+          publish-run: |
+            PREID="beta.pr${{ github.event.pull_request.number }}.${{ github.run_id }}"
+            npx nx run gamut-release:pre-release --preid="${PREID}" --publish-tag=beta --manifest=beta-publish-manifest.json
diff --git a/README.md b/README.md
index 84f0e396661..0d3957b39ad 100644
--- a/README.md
+++ b/README.md
@@ -108,17 +108,21 @@ Add new Button variant and fix spacing issues
     - It will create git tags and GitHub releases
 1.  You can find the new version number on npmjs.com/package/<package-name>, or find it in that package's `package.json` on the `main` branch
 
-### Publishing an alpha version of a module
+### Publishing an pre-release version of a module
 
-Every PR that changes files in a package publishes alpha releases that you can use to test your changes across applications.
+You can consume prerelease packages from npm before your PR merges. Two flows are available; **alpha** and **beta** are mutually exclusive on a PR.
+
+**Alpha (default):** On each push to the PR branch, CI publishes alpha releases (per-commit prerelease versions on npm). This does **not** run while the PR has the **`beta`** label.
+
+**Beta:** Add the **`beta`** label to the PR (create the label in the repo if it does not exist). That triggers a one-time publish to npm under the **`beta`** dist-tag (install with e.g. `yarn add @codecademy/gamut@beta`). Pushing new commits does **not** republish beta automatically; remove the **`beta`** label and add it again after your changes to trigger another publish.
 
 > NOTE: in case an alpha build is not published upon opening of the PR or Draft PR, re-run the `build-test` check and that will re-run the alpha build publishing flows
 
 1.  Create a PR or Draft PR.
-    - This will kickoff a Github Action workflow which will publish an alpha build. (This will appear in Github as the "Deploy")
-1.  After the alpha build is published, the `codecademydev` bot should comment on your PR with the names of the published alpha packages. <br/>
+    - Without the **`beta`** label, each push kicks off the workflow that publishes an alpha build. (This will appear in Github as the "Deploy")
+1.  After packages are published, the `codecademydev` bot should comment on your PR with the names of the published packages (separate comments for alpha vs beta). <br/>
     <img width="290" height="auto" src="https://user-images.githubusercontent.com/4298857/114948632-3fa88a80-9e04-11eb-89ef-d016a1c9c572.png">
-1.  Install this version of the package in your application you wish to test your changes on.
+1.  Install that version in the application where you want to test your changes (alpha by exact version from the table, or beta via `@beta` when using the beta flow).
 
 ### Working with pre-published changes
 
diff --git a/tools/gamut-release/README.md b/tools/gamut-release/README.md
index 4c5fd9dd87e..a5f622aa5b4 100644
--- a/tools/gamut-release/README.md
+++ b/tools/gamut-release/README.md
@@ -1,25 +1,31 @@
 # Gamut Release
 
-A CLI tool for publishing alpha versions of packages in the gamut repo using Nx release.
+A CLI tool for publishing prerelease versions of packages in the gamut repo using Nx release.
 
 Mainly meant to be run in CI.
 
 ## Overview
 
-This tool automates the process of publishing alpha versions of packages in the gamut repo. This is mainly meant to be run in CI for pull requests, but can be run manually using the same Nx target.
+This tool automates publishing alpha or beta prereleases of packages. It is run in CI on pull requests via the Nx target `gamut-release:pre-release`, which injects the required Node experimental flags.
 
-CI is responsible for validating the presence of a version plan before running alpha publishes.
+The Release Plan workflow (`release-plan-check.yml`) enforces version plans on PRs separately from these prerelease publishes.
 
 ## Usage
 
-### Alpha Release
+### Prerelease publish
 
 ```bash
-npx nx run gamut-release:alpha --preid=alpha.abc123
+npx nx run gamut-release:pre-release --preid=alpha.abc123
+```
+
+By default, the **npm dist-tag** is the same as `--preid`. To publish under a standard tag such as `beta` while using a unique semver prerelease id, pass **`--publish-tag`**:
+
+```bash
+npx nx run gamut-release:pre-release --preid=beta.pr123.456789 --publish-tag=beta
 ```
 
 ### Manifest output (optional)
 
 ```bash
-npx nx run gamut-release:alpha --preid=alpha.abc123 --manifest[=path]
+npx nx run gamut-release:pre-release --preid=alpha.abc123 --manifest[=path]
 ```
diff --git a/tools/gamut-release/project.json b/tools/gamut-release/project.json
index a3e21b04633..c79e61d831f 100644
--- a/tools/gamut-release/project.json
+++ b/tools/gamut-release/project.json
@@ -5,7 +5,7 @@
   "projectType": "library",
   "tags": ["scope:nx"],
   "targets": {
-    "alpha": {
+    "pre-release": {
       "executor": "nx:run-commands",
       "options": {
         "commands": ["node tools/gamut-release/src/main.ts"],
diff --git a/tools/gamut-release/src/main.ts b/tools/gamut-release/src/main.ts
index 2655c033a81..177c02e284c 100644
--- a/tools/gamut-release/src/main.ts
+++ b/tools/gamut-release/src/main.ts
@@ -6,10 +6,10 @@
  *
  * This script uses the Nx Release programmatic API to publish alpha versions
  * of packages. It is designed to run in CI for pull requests via the Nx target
- * `gamut-release:alpha`, which injects the required Node experimental flags.
+ * `gamut-release:pre-release`, which injects the required Node experimental flags.
  *
  * Usage:
- *   npx nx run gamut-release:alpha --preid=alpha.abc123 [--manifest[=path]]
+ *   npx nx run gamut-release:pre-release --preid=alpha.abc123 [--publish-tag=beta] [--manifest[=path]]
  */
 
 import { writeFile } from 'node:fs/promises';
@@ -25,6 +25,7 @@ import { releasePublish, releaseVersion } from 'nx/release/index.js';
 
 type AlphaReleaseOptions = {
   preid: string;
+  publishTag?: string;
   dryRun?: boolean;
   verbose?: boolean;
   manifest?: string | boolean;
@@ -111,6 +112,10 @@ const program = new Command()
   .name('gamut-release-alpha')
   .description('Publish alpha versions of packages using Nx Release.')
   .requiredOption('--preid <preid>', 'Prerelease identifier, e.g. alpha.abc123')
+  .option(
+    '--publish-tag <tag>',
+    'npm dist-tag for publish (defaults to the same value as --preid)'
+  )
   .option('-d, --dry-run', 'Run without publishing')
   .option('--verbose', 'Enable verbose logging')
   .option(
@@ -123,6 +128,7 @@ program.parse(process.argv);
 const options = program.opts();
 
 const preidArg = options.preid;
+const publishTagArg = options.publishTag?.trim() || preidArg;
 const dryRun = options.dryRun ?? false;
 const verbose = options.verbose ?? false;
 const manifestPath = resolveManifestPath(options.manifest);
@@ -163,10 +169,12 @@ async function releaseAlpha(): Promise<never> {
       });
     }
 
-    // Step 2: Publish packages with alpha tag
-    console.log(`\n📤 Publishing packages with tag: ${preidArg}...`);
+    // Step 2: Publish packages
+    console.log(
+      `\n📤 Publishing packages with npm dist-tag: ${publishTagArg}...`
+    );
     const publishStatus = await releasePublish({
-      tag: preidArg,
+      tag: publishTagArg,
       dryRun,
       verbose,
     });

From c6fc630e5c56e2b2181c87b55aea1bdd3904e9a5 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Mon, 4 May 2026 15:11:59 -0400
Subject: [PATCH 27/37] change git-head rf

---
 .github/workflows/publish-beta.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-beta.yml b/.github/workflows/publish-beta.yml
index b99c09cb970..d7ac677605a 100644
--- a/.github/workflows/publish-beta.yml
+++ b/.github/workflows/publish-beta.yml
@@ -23,7 +23,7 @@ concurrency:
 
 jobs:
   publish-beta:
-    if: github.event.label.name == 'beta' && github.event.pull_request.head.ref == 'cass-gmt-1473-beta'
+    if: github.event.label.name == 'beta' && github.event.pull_request.head.ref == 'cass-gmt-1607-publish'
     runs-on: ubuntu-22.04
     timeout-minutes: 30
     steps:

From 27bbf5bdb4002930fdc6f25eeba63dda6f7d99a8 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Mon, 4 May 2026 15:28:31 -0400
Subject: [PATCH 28/37] test beta

---
 .github/workflows/publish-beta.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/publish-beta.yml b/.github/workflows/publish-beta.yml
index d7ac677605a..2578cd6249f 100644
--- a/.github/workflows/publish-beta.yml
+++ b/.github/workflows/publish-beta.yml
@@ -27,6 +27,8 @@ jobs:
     runs-on: ubuntu-22.04
     timeout-minutes: 30
     steps:
+      - uses: actions/checkout@v4
+
       - uses: ./.github/actions/prerelease-publish
         with:
           node-auth-token: ${{ secrets.NODE_AUTH_TOKEN }}

From c8563bfd924ff46d87a9a4a2c04b8e249f92c832 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 5 Jun 2026 15:39:42 -0400
Subject: [PATCH 29/37] feat(SelectDropdown):isCreatable

---
 .../Form/SelectDropdown/SelectDropdown.tsx    | 12 ++-
 .../SelectDropdown/elements/containers.tsx    | 20 +++-
 .../Form/SelectDropdown/elements/options.tsx  |  6 +-
 .../gamut/src/Form/SelectDropdown/styles.ts   | 34 +++++--
 .../SelectDropdown/types/component-props.ts   | 61 ++++++++++++-
 .../src/Form/SelectDropdown/types/styles.ts   |  2 +
 .../Form/__tests__/SelectDropdown.test.tsx    | 63 +++++++++++++
 .../SelectDropdown/SelectDropdown.mdx         | 17 ++++
 .../SelectDropdown/SelectDropdown.stories.tsx | 91 +++++++++++++++++++
 9 files changed, 289 insertions(+), 17 deletions(-)

diff --git a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
index f31839eaa46..67340c16963 100644
--- a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
@@ -109,14 +109,18 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
   disabled,
   dropdownWidth,
   error,
+  formatCreateLabel = (inputValue: string) => `Add "${inputValue}"`,
   id,
   inputProps,
   inputWidth,
-  isSearchable = false,
+  isCreatable = false,
+  isSearchable: isSearchableProp = false,
+  isValidNewOption,
   menuAlignment = 'left',
   multiple,
   name,
   onChange,
+  onCreateOption,
   options,
   placeholder = 'Select an option',
   shownOptionsLimit = 6,
@@ -125,6 +129,8 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
   zIndex,
   ...rest
 }) => {
+  // isSearchable is forced true when isCreatable is true (CreatableSelect requires a text input)
+  const isSearchable = isCreatable || isSearchableProp;
   const rawInputId = useId();
   const inputId = name ?? `${id}-select-dropdown-${rawInputId}`;
 
@@ -265,16 +271,19 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         }}
         dropdownWidth={dropdownWidth}
         error={Boolean(error)}
+        formatCreateLabel={formatCreateLabel}
         formatGroupLabel={formatGroupLabel}
         formatOptionLabel={formatOptionLabel}
         id={id || rest.htmlFor || rawInputId}
         inputId={inputId}
         inputProps={{ ...inputProps }}
         inputWidth={inputWidth}
+        isCreatable={isCreatable}
         isDisabled={disabled}
         isMulti={multiple}
         isOptionDisabled={(option) => option.disabled}
         isSearchable={isSearchable}
+        isValidNewOption={isValidNewOption}
         menuAlignment={menuAlignment}
         name={name}
         options={selectOptions}
@@ -285,6 +294,7 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         styles={memoizedStyles}
         value={multiple ? multiValues : parsedValue}
         onChange={changeHandler}
+        onCreateOption={onCreateOption}
         onKeyDown={multiple ? (e) => keyPressHandler(e) : undefined}
         {...rest}
       />
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx b/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
index 47dd615a032..7c338eca12a 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
@@ -4,6 +4,7 @@ import ReactSelect, {
   GroupBase,
   Props,
 } from 'react-select';
+import CreatableSelect from 'react-select/creatable';
 
 import {
   CustomSelectComponentProps,
@@ -120,7 +121,9 @@ export const CustomInput = ({
 
 /**
  * Typed wrapper around react-select component.
- * Provides type safety for the underlying react-select implementation.
+ * Renders CreatableSelect when isCreatable is true, ReactSelect otherwise.
+ * Creatable-only props (formatCreateLabel, onCreateOption, isValidNewOption)
+ * are stripped from the non-creatable path so they don't reach ReactSelect.
  */
 export function TypedReactSelect<
   OptionType,
@@ -128,7 +131,22 @@ export function TypedReactSelect<
   GroupType extends GroupBase<OptionType> = GroupBase<OptionType>
 >({
   selectRef,
+  isCreatable,
+  formatCreateLabel,
+  isValidNewOption,
+  onCreateOption,
   ...props
 }: Props<OptionType, IsMulti, GroupType> & TypedReactSelectProps) {
+  if (isCreatable) {
+    return (
+      <CreatableSelect
+        {...(props as any)}
+        formatCreateLabel={formatCreateLabel}
+        isValidNewOption={isValidNewOption}
+        onCreateOption={onCreateOption}
+        ref={selectRef}
+      />
+    );
+  }
   return <ReactSelect {...props} ref={selectRef} />;
 }
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/options.tsx b/packages/gamut/src/Form/SelectDropdown/elements/options.tsx
index b3df15e2c0a..2a3bf1ce154 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/options.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/options.tsx
@@ -46,13 +46,15 @@ const IconOptionLabel: React.FC<
 /**
  * Custom option component that displays a check icon for selected items.
  * Also manages ARIA attributes for accessibility.
+ * Skips the check icon for react-select/creatable's "Add" row (__isNew__).
  */
 export const IconOption = ({
   children,
   ...rest
 }: CustomSelectComponentProps<typeof SelectDropdownElements.Option>) => {
   const { size } = rest.selectProps;
-  const { isFocused, innerProps } = rest;
+  const { isFocused, innerProps, data } = rest;
+  const isNew = (data as any)?.__isNew__;
 
   return (
     <SelectDropdownElements.Option
@@ -60,7 +62,7 @@ export const IconOption = ({
       innerProps={{ ...innerProps, 'aria-selected': isFocused }}
     >
       {children}
-      {rest?.isSelected && (
+      {!isNew && rest?.isSelected && (
         <CheckIcon size={selectedIconSize[size ?? 'medium']} />
       )}
     </SelectDropdownElements.Option>
diff --git a/packages/gamut/src/Form/SelectDropdown/styles.ts b/packages/gamut/src/Form/SelectDropdown/styles.ts
index ba9178c113c..2f0c36f1bd5 100644
--- a/packages/gamut/src/Form/SelectDropdown/styles.ts
+++ b/packages/gamut/src/Form/SelectDropdown/styles.ts
@@ -211,14 +211,32 @@ export const getMemoizedStyles = (
         backgroundColor: theme.colors['secondary-hover'],
       },
     }),
-    option: (provided, state: OptionState) => ({
-      ...getOptionBackground(state.isSelected, state.isFocused)({ theme }),
-      alignItems: 'center',
-      color: state.isDisabled ? 'text-disabled' : 'default',
-      cursor: state.isDisabled ? 'not-allowed' : 'pointer',
-      display: 'flex',
-      padding: state.selectProps.size === 'small' ? '3px 14px' : '11px 14px',
-    }),
+    option: (provided, state: OptionState) => {
+      const isNew = state.data?.__isNew__;
+      const isSmall = state.selectProps.size === 'small';
+      return {
+        ...getOptionBackground(state.isSelected, state.isFocused)({ theme }),
+        alignItems: 'center',
+        color: isNew
+          ? state.isDisabled
+            ? theme.colors['text-disabled']
+            : theme.colors.primary
+          : state.isDisabled
+          ? 'text-disabled'
+          : 'default',
+        cursor: state.isDisabled ? 'not-allowed' : 'pointer',
+        display: 'flex',
+        padding: isSmall ? '3px 14px' : '11px 14px',
+        ...(isNew && {
+          // Gradient creates the 1px divider line centred in the 16px spacer above the option text
+          backgroundImage: `linear-gradient(${theme.colors['text-disabled']} 1px, transparent 1px)`,
+          backgroundPosition: '0 8px',
+          backgroundRepeat: 'no-repeat',
+          backgroundSize: '100% 1px',
+          paddingTop: isSmall ? '19px' : '27px',
+        }),
+      };
+    },
     placeholder: (provided) => ({
       ...provided,
       ...placeholderColor({ theme }),
diff --git a/packages/gamut/src/Form/SelectDropdown/types/component-props.ts b/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
index d5c89453083..d9ea162149b 100644
--- a/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
+++ b/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
@@ -1,5 +1,5 @@
 import { Ref, SelectHTMLAttributes } from 'react';
-import { Props as NamedProps } from 'react-select';
+import { Options as OptionsType, Props as NamedProps } from 'react-select';
 
 import { SelectComponentProps } from '../../inputs/Select';
 import {
@@ -58,6 +58,7 @@ export interface SelectDropdownCoreProps
       | 'theme'
       | 'onChange'
       | 'multiple'
+      | 'isSearchable'
     >,
     Pick<
       SelectHTMLAttributes<HTMLSelectElement>,
@@ -73,6 +74,33 @@ export interface SelectDropdownCoreProps
   placeholder?: string;
   /** Array of options or option groups to display in the dropdown */
   options?: SelectDropdownOptions | SelectDropdownGroup[];
+  /**
+   * Allows users to create new options by typing a value not in the options list.
+   * When true, isSearchable is automatically set to true.
+   * Pair with onCreateOption to persist new options.
+   */
+  isCreatable?: boolean;
+  /**
+   * Called when the user confirms a new option via the "Add" row.
+   * The consumer is responsible for appending the new option to the options array.
+   */
+  onCreateOption?: (inputValue: string) => void;
+  /**
+   * Customises the label shown in the "Add" row.
+   * Defaults to: (inputValue) => `Add "${inputValue}"`.
+   */
+  formatCreateLabel?: (inputValue: string) => React.ReactNode;
+  /**
+   * Controls when the "Add" row is visible.
+   * Receives the current input, selected values, and all options.
+   * Defaults to react-select's built-in logic (hidden when input matches an existing option label).
+   * Use cases: minimum-length gating, pattern validation, case-insensitive dedup, max-items cap.
+   */
+  isValidNewOption?: (
+    inputValue: string,
+    value: OptionsType<OptionStrict>,
+    options: OptionsType<OptionStrict>
+  ) => boolean;
 }
 
 /**
@@ -97,13 +125,24 @@ export interface MultiSelectDropdownProps extends SelectDropdownCoreProps {
   onChange?: NamedProps<OptionStrict, true>['onChange'];
 }
 
+/**
+ * Enforces that isSearchable cannot be false when isCreatable is true.
+ * Creatable mode requires the search input so users can type new option values.
+ */
+type CreatableConstraint =
+  | { isCreatable?: false | undefined; isSearchable?: boolean }
+  | { isCreatable: true; isSearchable?: true };
+
 /**
  * Union type for all SelectDropdown prop variants.
- * Supports both single and multi-select modes through discriminated union.
+ * Supports both single and multi-select modes through discriminated union,
+ * intersected with CreatableConstraint to enforce isSearchable compatibility.
  */
-export type SelectDropdownProps =
+export type SelectDropdownProps = (
   | SingleSelectDropdownProps
-  | MultiSelectDropdownProps;
+  | MultiSelectDropdownProps
+) &
+  CreatableConstraint;
 
 /**
  * Base interface for onChange-related props.
@@ -120,9 +159,21 @@ export interface BaseOnChangeProps {
 
 /**
  * Props for the typed React Select component wrapper.
- * Extends ReactSelectAdditionalProps with an optional ref.
+ * Extends ReactSelectAdditionalProps with an optional ref and creatable flag.
  */
 export interface TypedReactSelectProps extends ReactSelectAdditionalProps {
   /** Optional ref to the underlying react-select component */
   selectRef?: Ref<any>;
+  /** When true, renders CreatableSelect instead of ReactSelect */
+  isCreatable?: boolean;
+  /** Forwarded to CreatableSelect; customises the "Add" row label */
+  formatCreateLabel?: (inputValue: string) => React.ReactNode;
+  /** Forwarded to CreatableSelect; called on new option confirmation */
+  onCreateOption?: (inputValue: string) => void;
+  /** Forwarded to CreatableSelect; controls visibility of the "Add" row */
+  isValidNewOption?: (
+    inputValue: string,
+    value: OptionsType<OptionStrict>,
+    options: OptionsType<OptionStrict>
+  ) => boolean;
 }
diff --git a/packages/gamut/src/Form/SelectDropdown/types/styles.ts b/packages/gamut/src/Form/SelectDropdown/types/styles.ts
index 3be7acbd824..23e7f2334ec 100644
--- a/packages/gamut/src/Form/SelectDropdown/types/styles.ts
+++ b/packages/gamut/src/Form/SelectDropdown/types/styles.ts
@@ -83,4 +83,6 @@ export type OptionState = BaseSelectComponentProps &
   InteractionStates & {
     /** Whether the option is selected */
     isSelected: boolean;
+    /** Option data — includes __isNew__ for react-select/creatable's "Add" row */
+    data?: { __isNew__?: boolean };
   };
diff --git a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
index 3b068aaaa93..390b2d109cb 100644
--- a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
+++ b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
@@ -405,4 +405,67 @@ describe('SelectDropdown', () => {
       expect(comboboxInput).toHaveAttribute('data-zero', '0');
     });
   });
+
+  describe('isCreatable', () => {
+    it('shows the "Add" row when input does not match any existing option', async () => {
+      const { view } = renderView({ isCreatable: true });
+
+      await act(async () => {
+        await userEvent.type(view.getByRole('combobox'), 'purple');
+      });
+
+      expect(view.getByText('Add "purple"')).toBeInTheDocument();
+    });
+
+    it('does not show the "Add" row when input matches an existing option', async () => {
+      const { view } = renderView({ isCreatable: true });
+
+      await act(async () => {
+        await userEvent.type(view.getByRole('combobox'), 'red');
+      });
+
+      expect(view.queryByText('Add "red"')).not.toBeInTheDocument();
+    });
+
+    it('fires onCreateOption with the typed value when the "Add" row is selected', async () => {
+      const onCreateOption = jest.fn();
+      const { view } = renderView({ isCreatable: true, onCreateOption });
+
+      await act(async () => {
+        await userEvent.type(view.getByRole('combobox'), 'purple');
+      });
+
+      await act(async () => {
+        await userEvent.click(view.getByText('Add "purple"'));
+      });
+
+      expect(onCreateOption).toHaveBeenCalledWith('purple');
+    });
+
+    it('respects a custom formatCreateLabel', async () => {
+      const { view } = renderView({
+        isCreatable: true,
+        formatCreateLabel: (v: string) => `Create tag: "${v}"`,
+      });
+
+      await act(async () => {
+        await userEvent.type(view.getByRole('combobox'), 'purple');
+      });
+
+      expect(view.getByText('Create tag: "purple"')).toBeInTheDocument();
+    });
+
+    it('hides the "Add" row when isValidNewOption returns false', async () => {
+      const { view } = renderView({
+        isCreatable: true,
+        isValidNewOption: () => false,
+      });
+
+      await act(async () => {
+        await userEvent.type(view.getByRole('combobox'), 'anything');
+      });
+
+      expect(view.queryByText('Add "anything"')).not.toBeInTheDocument();
+    });
+  });
 });
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
index 3b09f0209ad..688d9ba0584 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
@@ -206,6 +206,23 @@ In the example below, the z-index menu is configured to the default value (`auto
 
 <Canvas of={SelectDropdownStories.zIndexOnMenu} />
 
+## Creatable
+
+Use the `isCreatable` prop to allow users to add options that aren't in the list. When the user types a value that doesn't match any existing option, an **Add "value"** row appears at the bottom of the dropdown. Selecting it fires `onCreateOption` with the typed string — the consumer is responsible for appending the new option to the `options` array.
+
+`isSearchable` is automatically set to `true` when `isCreatable` is `true` (passing `isSearchable={false}` alongside `isCreatable` is a TypeScript error).
+
+<Canvas of={SelectDropdownStories.Creatable} />
+
+### Props
+
+| Prop                | Type                                      | Default              | Description                                                                                               |
+| ------------------- | ----------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------- |
+| `isCreatable`       | `boolean`                                 | `false`              | Enables option creation. Automatically forces `isSearchable` to `true`.                                   |
+| `onCreateOption`    | `(inputValue: string) => void`            | —                    | Called when the user confirms a new option. Append the value to `options` to persist it.                  |
+| `formatCreateLabel` | `(inputValue: string) => ReactNode`       | `Add "inputValue"`   | Customises the label shown in the "Add" row.                                                              |
+| `isValidNewOption`  | `(inputValue, value, options) => boolean` | react-select default | Controls when the "Add" row is visible. Use for min-length gating, pattern validation, or max-items caps. |
+
 ## Multiple select
 
 <Canvas of={SelectDropdownStories.MultipleSelect} />
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
index 8576c849958..4613bfa74d3 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
@@ -8,6 +8,7 @@ import {
 } from '@codecademy/gamut';
 import { RadarIcon, ResponsiveIcon, RocketIcon } from '@codecademy/gamut-icons';
 import type { Meta, StoryObj } from '@storybook/react';
+import { useState } from 'react';
 
 const fruitOptions = ['Apple', 'Banana', 'Cherry', 'Dragonfruit', 'Eggplant'];
 
@@ -466,6 +467,96 @@ export const CustomInputProps: Story = {
   ),
 };
 
+export const Creatable: Story = {
+  args: {
+    name: 'creatable-dropdown',
+    isCreatable: true,
+    placeholder: 'Select or type to add…',
+  },
+  render: (args) => {
+    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    return (
+      <Box height="15rem">
+        <FormGroup
+          htmlFor="creatable-dropdown"
+          isSoloField
+          label="Type a new fruit and press Enter"
+        >
+          <SelectDropdown
+            {...args}
+            options={options}
+            onCreateOption={(inputValue) =>
+              setOptions((prev) => [...prev, inputValue])
+            }
+          />
+        </FormGroup>
+      </Box>
+    );
+  },
+};
+
+export const CreatableMulti: Story = {
+  render: () => {
+    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    return (
+      <Box height="18rem">
+        <FormGroup
+          htmlFor="creatable-multi-dropdown"
+          isSoloField
+          label="Pick fruits or add your own"
+        >
+          <SelectDropdown
+            isCreatable
+            multiple
+            name="creatable-multi-dropdown"
+            options={options}
+            placeholder="Select or type to add…"
+            onCreateOption={(inputValue) =>
+              setOptions((prev) => [...prev, inputValue])
+            }
+          />
+        </FormGroup>
+      </Box>
+    );
+  },
+};
+
+export const CreatableWithValidation: Story = {
+  render: () => {
+    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    return (
+      <Box height="15rem">
+        <FormGroup
+          htmlFor="creatable-validated-dropdown"
+          isSoloField
+          label="Min 3 characters — no duplicates (case-insensitive)"
+        >
+          <SelectDropdown
+            isCreatable
+            name="creatable-validated-dropdown"
+            options={options}
+            placeholder="Type at least 3 characters to add…"
+            isValidNewOption={(
+              inputValue: string,
+              _value,
+              currentOptions: { label: string }[]
+            ) => {
+              if (inputValue.trim().length < 3) return false;
+              return !currentOptions.some(
+                (opt) =>
+                  opt.label.toLowerCase() === inputValue.trim().toLowerCase()
+              );
+            }}
+            onCreateOption={(inputValue) =>
+              setOptions((prev) => [...prev, inputValue.trim()])
+            }
+          />
+        </FormGroup>
+      </Box>
+    );
+  },
+};
+
 export const MultipleSelect: Story = {
   args: {
     name: 'multi-dropdown',

From 8d86bc8f645c0581df4d5b4466832efb8e0d9ccd Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Thu, 11 Jun 2026 15:40:45 -0400
Subject: [PATCH 30/37] tweaks

---
 .../Form/SelectDropdown/SelectDropdown.tsx    |  43 +-
 .../Form/SelectDropdown/elements/constants.ts |   9 -
 .../Form/SelectDropdown/elements/controls.tsx |   5 +-
 .../gamut/src/Form/SelectDropdown/styles.ts   |   6 +
 .../SelectDropdown/types/component-props.ts   |   9 +
 .../Form/__tests__/SelectDropdown.test.tsx    | 682 ++++++++++--------
 .../SelectDropdown/SelectDropdown.mdx         |  21 +-
 .../SelectDropdown/SelectDropdown.stories.tsx |  36 +-
 8 files changed, 483 insertions(+), 328 deletions(-)

diff --git a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
index 67340c16963..4c9ec54557d 100644
--- a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
@@ -9,7 +9,11 @@ import {
   useState,
 } from 'react';
 import * as React from 'react';
-import { Options as OptionsType, StylesConfig } from 'react-select';
+import {
+  InputActionMeta,
+  Options as OptionsType,
+  StylesConfig,
+} from 'react-select';
 
 import { parseOptions, SelectOptionBase } from '../utils';
 import {
@@ -121,10 +125,12 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
   name,
   onChange,
   onCreateOption,
+  onInputChange,
   options,
   placeholder = 'Select an option',
   shownOptionsLimit = 6,
   size,
+  validationMessage,
   value,
   zIndex,
   ...rest
@@ -136,6 +142,9 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
 
   const [activated, setActivated] = useState(false);
   const [currentFocusedValue, setCurrentFocusedValue] = useState(undefined);
+  // Controlled input value for creatable mode so typed text persists across
+  // blur / menu-close (react-select clears it by default).
+  const [inputValue, setInputValue] = useState('');
 
   // these are used to programatically manage the focus state of our multi-select options + 'Remove all' button
   const removeAllButtonRef = useRef<HTMLDivElement>(null);
@@ -195,7 +204,6 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
     );
     if (newMultiValues !== multiValues) setMultiValues(newMultiValues);
 
-    //
     // We only update this when our passed in options or value changes, not multiValues.
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [options, value]);
@@ -248,6 +256,34 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
     }
   };
 
+  const handleInputChange = useCallback(
+    (newValue: string, actionMeta: InputActionMeta) => {
+      if (isCreatable) {
+        /* Keep typed text instead of letting react-select clear it on blur /
+           menu-close. Since the value didn't actually change, we also skip
+           forwarding these to the consumer so derived state (e.g. validation
+           errors) isn't reset against an empty value. 'set-value' (after
+           selecting/creating) still clears and forwards as normal. */
+        if (
+          actionMeta.action === 'input-blur' ||
+          actionMeta.action === 'menu-close'
+        ) {
+          return;
+        }
+        setInputValue(newValue);
+      }
+      onInputChange?.(newValue, actionMeta);
+    },
+    [isCreatable, onInputChange]
+  );
+
+  const noOptionsMessage =
+    validationMessage === undefined
+      ? undefined // fall back to react-select default ("No options")
+      : typeof validationMessage === 'function'
+      ? (validationMessage as (obj: { inputValue: string }) => React.ReactNode)
+      : () => validationMessage;
+
   const theme = useTheme();
   const memoizedStyles = useMemo((): StylesConfig<any, false> => {
     return getMemoizedStyles(theme, zIndex);
@@ -277,6 +313,7 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         id={id || rest.htmlFor || rawInputId}
         inputId={inputId}
         inputProps={{ ...inputProps }}
+        inputValue={isCreatable ? inputValue : undefined}
         inputWidth={inputWidth}
         isCreatable={isCreatable}
         isDisabled={disabled}
@@ -286,6 +323,7 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         isValidNewOption={isValidNewOption}
         menuAlignment={menuAlignment}
         name={name}
+        noOptionsMessage={noOptionsMessage}
         options={selectOptions}
         placeholder={placeholder}
         selectRef={selectInputRef}
@@ -295,6 +333,7 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         value={multiple ? multiValues : parsedValue}
         onChange={changeHandler}
         onCreateOption={onCreateOption}
+        onInputChange={handleInputChange}
         onKeyDown={multiple ? (e) => keyPressHandler(e) : undefined}
         {...rest}
       />
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/constants.ts b/packages/gamut/src/Form/SelectDropdown/elements/constants.ts
index 7d34a7f0fb0..f12c8d6c3f2 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/constants.ts
+++ b/packages/gamut/src/Form/SelectDropdown/elements/constants.ts
@@ -3,7 +3,6 @@ import {
   CloseIcon,
   MiniChevronDownIcon,
   MiniDeleteIcon,
-  SearchIcon,
 } from '@codecademy/gamut-icons';
 
 export const iconSize = { small: 12, medium: 16 };
@@ -18,14 +17,6 @@ export const indicatorIcons = {
     size: iconSize.medium,
     icon: ArrowChevronDownIcon,
   },
-  smallSearchable: {
-    size: iconSize.small,
-    icon: SearchIcon,
-  },
-  mediumSearchable: {
-    size: iconSize.medium,
-    icon: SearchIcon,
-  },
   smallRemove: {
     size: iconSize.small,
     icon: MiniDeleteIcon,
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx b/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
index 3152ed97e2c..0effe010d08 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/controls.tsx
@@ -37,11 +37,10 @@ export const onFocus: AriaOnFocus<ExtendedOption> = ({
  * The icon type depends on whether the select is searchable or not.
  */
 export const DropdownButton = (props: SizedIndicatorProps) => {
-  const { size, isSearchable } = props.selectProps;
+  const { size } = props.selectProps;
   const color = props.isDisabled ? 'text-disabled' : 'text';
   const iconSize = size ?? 'medium';
-  const iconType = isSearchable ? 'Searchable' : 'Chevron';
-  const { ...iconProps } = indicatorIcons[`${iconSize}${iconType}`];
+  const { ...iconProps } = indicatorIcons[`${iconSize}Chevron`];
   const { icon: IndicatorIcon } = iconProps;
 
   return (
diff --git a/packages/gamut/src/Form/SelectDropdown/styles.ts b/packages/gamut/src/Form/SelectDropdown/styles.ts
index 2f0c36f1bd5..64b6ef48adb 100644
--- a/packages/gamut/src/Form/SelectDropdown/styles.ts
+++ b/packages/gamut/src/Form/SelectDropdown/styles.ts
@@ -150,6 +150,8 @@ export const getMemoizedStyles = (
         ...provided,
         ...dropdownBorderStyles(zIndex)({ theme }),
         ...dropdownBorderStates({ error: state.selectProps.error, theme }),
+        // Drop react-select's default menu drop shadow; the border above defines the edge.
+        boxShadow: 'none',
         ...(dropdownWidth
           ? {
               minWidth: dropdownWidth,
@@ -211,6 +213,10 @@ export const getMemoizedStyles = (
         backgroundColor: theme.colors['secondary-hover'],
       },
     }),
+    noOptionsMessage: (provided) => ({
+      ...provided,
+      color: theme.colors['text-secondary'],
+    }),
     option: (provided, state: OptionState) => {
       const isNew = state.data?.__isNew__;
       const isSmall = state.selectProps.size === 'small';
diff --git a/packages/gamut/src/Form/SelectDropdown/types/component-props.ts b/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
index d9ea162149b..13e04c25b26 100644
--- a/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
+++ b/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
@@ -101,6 +101,15 @@ export interface SelectDropdownCoreProps
     value: OptionsType<OptionStrict>,
     options: OptionsType<OptionStrict>
   ) => boolean;
+  /**
+   * Customizes the message shown inside the dropdown menu when no option matches
+   * the current input (react-select's "No options" state). Useful for surfacing
+   * validation/error text directly in the dropdown. Accepts a node, or a function
+   * receiving the current input value.
+   */
+  validationMessage?:
+    | React.ReactNode
+    | ((obj: { inputValue: string }) => React.ReactNode);
 }
 
 /**
diff --git a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
index 390b2d109cb..38651c2b773 100644
--- a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
+++ b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
@@ -1,4 +1,5 @@
 import { setupRtl } from '@codecademy/gamut-tests';
+import { fireEvent } from '@testing-library/dom';
 import userEvent from '@testing-library/user-event';
 import { act } from 'react';
 
@@ -50,359 +51,380 @@ const renderView = setupRtl(SelectDropdown, {
 });
 
 describe('SelectDropdown', () => {
-  it('sets the id prop on the select tag', () => {
-    const { view } = renderView();
+  describe('default', () => {
+    it('sets the id prop on the select tag', () => {
+      const { view } = renderView();
 
-    expect(view.getByRole('combobox')).toHaveAttribute('id', 'colors');
-  });
-
-  it.each([
-    ['array', selectOptions],
-    ['object', selectOptionsObject],
-  ])('renders options when options is an %s', async (_, options) => {
-    const { view } = renderView({ options });
-
-    await openDropdown(view);
-
-    view.getByText('green');
-  });
-
-  it('renders a small dropdown when size is "small"', () => {
-    const { view } = renderView({ size: 'small' });
-    view.getByTitle('Mini Chevron Down Icon');
-  });
+      expect(view.getByRole('combobox')).toHaveAttribute('id', 'colors');
+    });
 
-  it('renders a medium dropdown when size is "medium"', () => {
-    const { view } = renderView({ size: 'medium' });
-    view.getByTitle('Arrow Chevron Down Icon');
-  });
+    it.each([
+      ['array', selectOptions],
+      ['object', selectOptionsObject],
+    ])('renders options when options is an %s', async (_, options) => {
+      const { view } = renderView({ options });
 
-  it('renders a medium dropdown by default', () => {
-    const { view } = renderView();
-    view.getByTitle('Arrow Chevron Down Icon');
-  });
+      await openDropdown(view);
 
-  it('renders a dropdown with the correct maxHeight when shownOptionsLimit is specified', async () => {
-    const { view } = renderView({ shownOptionsLimit: 4 });
+      view.getByText('green');
+    });
 
-    await openDropdown(view);
+    it('renders a small dropdown when size is "small"', () => {
+      const { view } = renderView({ size: 'small' });
+      view.getByTitle('Mini Chevron Down Icon');
+    });
 
-    expect(view.getByRole('listbox')).toHaveStyle({ maxHeight: '12rem' });
-  });
-  it('renders a dropdown with the correct maxHeight when shownOptionsLimit is specified + size is "small"', async () => {
-    const { view } = renderView({
-      size: 'small',
-      shownOptionsLimit: 4,
+    it('renders a medium dropdown when size is "medium"', () => {
+      const { view } = renderView({ size: 'medium' });
+      view.getByTitle('Arrow Chevron Down Icon');
     });
 
-    await openDropdown(view);
+    it('renders a medium dropdown by default', () => {
+      const { view } = renderView();
+      view.getByTitle('Arrow Chevron Down Icon');
+    });
 
-    expect(view.getByRole('listbox')).toHaveStyle({ maxHeight: '8rem' });
-  });
+    it('renders a dropdown with the correct maxHeight when shownOptionsLimit is specified', async () => {
+      const { view } = renderView({ shownOptionsLimit: 4 });
 
-  it('renders a dropdown with icons', async () => {
-    const { view } = renderView({ options: optionsIconsArray });
+      await openDropdown(view);
 
-    await openDropdown(view);
+      expect(view.getByRole('listbox')).toHaveStyle({ maxHeight: '12rem' });
+    });
+    it('renders a dropdown with the correct maxHeight when shownOptionsLimit is specified + size is "small"', async () => {
+      const { view } = renderView({
+        size: 'small',
+        shownOptionsLimit: 4,
+      });
 
-    optionsIconsArray.forEach((icon) => expect(view.getByTitle(icon.label)));
-  });
+      await openDropdown(view);
 
-  it('displays icon in selected value when option has icon', async () => {
-    const { view } = renderView({
-      options: optionsIconsArray,
-      value: 'one',
+      expect(view.getByRole('listbox')).toHaveStyle({ maxHeight: '8rem' });
     });
 
-    expect(view.getByTitle('Data Transfer Vertical Icon')).toBeInTheDocument();
-    const selectedValueContainer = view.getByRole('combobox').closest('div');
-    expect(selectedValueContainer).toHaveTextContent(
-      'Data Transfer Vertical Icon'
-    );
-  });
-
-  it('function passed to onInputChanges is called on input change', async () => {
-    const onInputChange = jest.fn();
-    const { view } = renderView({ onInputChange });
+    it('renders a dropdown with icons', async () => {
+      const { view } = renderView({ options: optionsIconsArray });
 
-    await openDropdown(view);
+      await openDropdown(view);
 
-    await act(async () => {
-      await userEvent.click(view.getByText('red'));
+      optionsIconsArray.forEach((icon) => expect(view.getByTitle(icon.label)));
     });
 
-    expect(onInputChange).toHaveBeenCalled();
-  });
-
-  it('works with multiple selection', async () => {
-    const onChange = jest.fn();
-    const { view } = renderView({
-      multiple: true,
-      onChange,
-    });
+    it('displays icon in selected value when option has icon', async () => {
+      const { view } = renderView({
+        options: optionsIconsArray,
+        value: 'one',
+      });
 
-    await openDropdown(view);
-    await act(async () => {
-      await userEvent.click(view.getByText('red'));
+      expect(
+        view.getByTitle('Data Transfer Vertical Icon')
+      ).toBeInTheDocument();
+      const selectedValueContainer = view.getByRole('combobox').closest('div');
+      expect(selectedValueContainer).toHaveTextContent(
+        'Data Transfer Vertical Icon'
+      );
     });
 
-    await openDropdown(view);
-    await act(async () => {
-      await userEvent.click(view.getByText('green'));
-    });
+    it('function passed to onInputChanges is called on input change', async () => {
+      const onInputChange = jest.fn();
+      const { view } = renderView({ onInputChange });
 
-    view.getByText('red');
-    view.getByText('green');
+      await openDropdown(view);
 
-    expect(onChange).toHaveBeenCalledTimes(2);
-    expect(onChange).toHaveBeenNthCalledWith(
-      1,
-      [
-        {
-          label: 'red',
-          value: 'red',
-        },
-      ],
-      {
-        action: 'select-option',
-      }
-    );
-    expect(onChange).toHaveBeenNthCalledWith(
-      2,
-      [
-        {
-          label: 'red',
-          value: 'red',
-        },
-        {
-          label: 'green',
-          value: 'green',
-        },
-      ],
-      {
-        action: 'select-option',
-      }
-    );
-  });
+      await act(async () => {
+        await userEvent.click(view.getByText('red'));
+      });
 
-  it('displays abbreviations in multiselect mode', async () => {
-    const onChange = jest.fn();
-    const { view } = renderView({
-      multiple: true,
-      options: optionsWithAbbreviations,
-      onChange,
+      expect(onInputChange).toHaveBeenCalled();
     });
 
-    await openDropdown(view);
-    await act(async () => {
-      await userEvent.click(view.getByText('United States of America'));
-    });
+    it('works with multiple selection', async () => {
+      const onChange = jest.fn();
+      const { view } = renderView({
+        multiple: true,
+        onChange,
+      });
 
-    await openDropdown(view);
-    await act(async () => {
-      await userEvent.click(view.getByText('United Kingdom'));
-    });
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('red'));
+      });
 
-    view.getByText('USA');
-    view.getByText('UK');
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('green'));
+      });
 
-    expect(onChange).toHaveBeenCalledTimes(2);
-    expect(onChange).toHaveBeenNthCalledWith(
-      1,
-      [
-        {
-          label: 'United States of America',
-          value: 'usa',
-          abbreviation: 'USA',
-          key: 'usa',
-          size: undefined,
-        },
-      ],
-      {
-        action: 'select-option',
-        option: undefined,
-      }
-    );
-    expect(onChange).toHaveBeenNthCalledWith(
-      2,
-      [
-        {
-          label: 'United States of America',
-          value: 'usa',
-          abbreviation: 'USA',
-          key: 'usa',
-          size: undefined,
-        },
-        {
-          label: 'United Kingdom',
-          value: 'uk',
-          abbreviation: 'UK',
-          key: 'uk',
-          size: undefined,
-        },
-      ],
-      {
-        action: 'select-option',
-        option: undefined,
-      }
-    );
-  });
+      view.getByText('red');
+      view.getByText('green');
 
-  describe('inputProps functionality', () => {
-    it('should apply combobox and hidden props in non-searchable mode (default)', () => {
-      const { view } = renderView({
-        isSearchable: false,
-        inputProps: {
-          hidden: {
-            'data-form-field': 'test-field',
-            'data-hidden-attr': 'hidden-value',
-          },
-          combobox: {
-            'data-testid': 'non-searchable-combobox',
-            'data-custom-attr': 'custom-value',
+      expect(onChange).toHaveBeenCalledTimes(2);
+      expect(onChange).toHaveBeenNthCalledWith(
+        1,
+        [
+          {
+            label: 'red',
+            value: 'red',
           },
-        },
-      });
-
-      const comboboxInput = view.getByRole('combobox');
-      expect(comboboxInput).toHaveAttribute(
-        'data-testid',
-        'non-searchable-combobox'
+        ],
+        {
+          action: 'select-option',
+        }
       );
-      expect(comboboxInput).toHaveAttribute('data-custom-attr', 'custom-value');
-
-      const hiddenInput = view.container.querySelector(
-        'input[type="hidden"][data-form-field="test-field"]'
+      expect(onChange).toHaveBeenNthCalledWith(
+        2,
+        [
+          {
+            label: 'red',
+            value: 'red',
+          },
+          {
+            label: 'green',
+            value: 'green',
+          },
+        ],
+        {
+          action: 'select-option',
+        }
       );
-      expect(hiddenInput).toHaveAttribute('data-form-field', 'test-field');
-      expect(hiddenInput).toHaveAttribute('data-hidden-attr', 'hidden-value');
     });
 
-    it('should apply combobox and hidden props in searchable mode', () => {
+    it('displays abbreviations in multiselect mode', async () => {
+      const onChange = jest.fn();
       const { view } = renderView({
-        isSearchable: true,
-        inputProps: {
-          hidden: {
-            'data-form-field': 'searchable-field',
-            'data-hidden-attr': 'searchable-hidden-value',
-          },
-          combobox: {
-            'data-testid': 'searchable-combobox',
-            'data-custom-attr': 'searchable-custom-value',
-          },
-        },
+        multiple: true,
+        options: optionsWithAbbreviations,
+        onChange,
       });
 
-      const comboboxInput = view.getByRole('combobox');
-      expect(comboboxInput).toHaveAttribute(
-        'data-testid',
-        'searchable-combobox'
-      );
-      expect(comboboxInput).toHaveAttribute(
-        'data-custom-attr',
-        'searchable-custom-value'
-      );
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('United States of America'));
+      });
 
-      const hiddenInput = view.container.querySelector(
-        'input[type="hidden"][data-form-field="searchable-field"]'
-      );
-      expect(hiddenInput).toHaveAttribute(
-        'data-form-field',
-        'searchable-field'
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('United Kingdom'));
+      });
+
+      view.getByText('USA');
+      view.getByText('UK');
+
+      expect(onChange).toHaveBeenCalledTimes(2);
+      expect(onChange).toHaveBeenNthCalledWith(
+        1,
+        [
+          {
+            label: 'United States of America',
+            value: 'usa',
+            abbreviation: 'USA',
+            key: 'usa',
+            size: undefined,
+          },
+        ],
+        {
+          action: 'select-option',
+          option: undefined,
+        }
       );
-      expect(hiddenInput).toHaveAttribute(
-        'data-hidden-attr',
-        'searchable-hidden-value'
+      expect(onChange).toHaveBeenNthCalledWith(
+        2,
+        [
+          {
+            label: 'United States of America',
+            value: 'usa',
+            abbreviation: 'USA',
+            key: 'usa',
+            size: undefined,
+          },
+          {
+            label: 'United Kingdom',
+            value: 'uk',
+            abbreviation: 'UK',
+            key: 'uk',
+            size: undefined,
+          },
+        ],
+        {
+          action: 'select-option',
+          option: undefined,
+        }
       );
     });
 
-    it('should work with only combobox props (no hidden props)', () => {
-      const { view } = renderView({
-        isSearchable: false,
-        inputProps: {
-          combobox: {
-            'data-testid': 'combobox-only',
-            'data-aria-label': 'Custom combobox label',
+    describe('inputProps functionality', () => {
+      it('should apply combobox and hidden props in non-searchable mode (default)', () => {
+        const { view } = renderView({
+          isSearchable: false,
+          inputProps: {
+            hidden: {
+              'data-form-field': 'test-field',
+              'data-hidden-attr': 'hidden-value',
+            },
+            combobox: {
+              'data-testid': 'non-searchable-combobox',
+              'data-custom-attr': 'custom-value',
+            },
           },
-        },
+        });
+
+        const comboboxInput = view.getByRole('combobox');
+        expect(comboboxInput).toHaveAttribute(
+          'data-testid',
+          'non-searchable-combobox'
+        );
+        expect(comboboxInput).toHaveAttribute(
+          'data-custom-attr',
+          'custom-value'
+        );
+
+        const hiddenInput = view.container.querySelector(
+          'input[type="hidden"][data-form-field="test-field"]'
+        );
+        expect(hiddenInput).toHaveAttribute('data-form-field', 'test-field');
+        expect(hiddenInput).toHaveAttribute('data-hidden-attr', 'hidden-value');
       });
 
-      const comboboxInput = view.getByRole('combobox');
-      expect(comboboxInput).toHaveAttribute('data-testid', 'combobox-only');
-      expect(comboboxInput).toHaveAttribute(
-        'data-aria-label',
-        'Custom combobox label'
-      );
-    });
-
-    it('should work with only hidden props (no combobox props)', () => {
-      const { view } = renderView({
-        isSearchable: true,
-        inputProps: {
-          hidden: {
-            'data-form-field': 'hidden-only',
-            'data-validation': 'required',
+      it('should apply combobox and hidden props in searchable mode', () => {
+        const { view } = renderView({
+          isSearchable: true,
+          inputProps: {
+            hidden: {
+              'data-form-field': 'searchable-field',
+              'data-hidden-attr': 'searchable-hidden-value',
+            },
+            combobox: {
+              'data-testid': 'searchable-combobox',
+              'data-custom-attr': 'searchable-custom-value',
+            },
           },
-        },
+        });
+
+        const comboboxInput = view.getByRole('combobox');
+        expect(comboboxInput).toHaveAttribute(
+          'data-testid',
+          'searchable-combobox'
+        );
+        expect(comboboxInput).toHaveAttribute(
+          'data-custom-attr',
+          'searchable-custom-value'
+        );
+
+        const hiddenInput = view.container.querySelector(
+          'input[type="hidden"][data-form-field="searchable-field"]'
+        );
+        expect(hiddenInput).toHaveAttribute(
+          'data-form-field',
+          'searchable-field'
+        );
+        expect(hiddenInput).toHaveAttribute(
+          'data-hidden-attr',
+          'searchable-hidden-value'
+        );
       });
 
-      const comboboxInput = view.getByRole('combobox');
-      // Should not have any combobox-specific attributes
-      expect(comboboxInput).not.toHaveAttribute('data-form-field');
-      expect(comboboxInput).not.toHaveAttribute('data-validation');
-
-      const hiddenInput = view.container.querySelector(
-        'input[type="hidden"][data-form-field="hidden-only"]'
-      );
-      expect(hiddenInput).toHaveAttribute('data-form-field', 'hidden-only');
-      expect(hiddenInput).toHaveAttribute('data-validation', 'required');
-    });
+      it('should work with only combobox props (no hidden props)', () => {
+        const { view } = renderView({
+          isSearchable: false,
+          inputProps: {
+            combobox: {
+              'data-testid': 'combobox-only',
+              'data-aria-label': 'Custom combobox label',
+            },
+          },
+        });
+
+        const comboboxInput = view.getByRole('combobox');
+        expect(comboboxInput).toHaveAttribute('data-testid', 'combobox-only');
+        expect(comboboxInput).toHaveAttribute(
+          'data-aria-label',
+          'Custom combobox label'
+        );
+      });
 
-    it('should handle multiple data attributes in combobox props', () => {
-      const { view } = renderView({
-        isSearchable: false,
-        inputProps: {
-          combobox: {
-            'data-testid': 'multi-attr-test',
-            'data-cy': 'combobox-element',
-            'data-analytics': 'user-interaction',
-            'data-tracking': 'form-field',
-            'aria-describedby': 'help-text',
+      it('should work with only hidden props (no combobox props)', () => {
+        const { view } = renderView({
+          isSearchable: true,
+          inputProps: {
+            hidden: {
+              'data-form-field': 'hidden-only',
+              'data-validation': 'required',
+            },
           },
-        },
+        });
+
+        const comboboxInput = view.getByRole('combobox');
+        // Should not have any combobox-specific attributes
+        expect(comboboxInput).not.toHaveAttribute('data-form-field');
+        expect(comboboxInput).not.toHaveAttribute('data-validation');
+
+        const hiddenInput = view.container.querySelector(
+          'input[type="hidden"][data-form-field="hidden-only"]'
+        );
+        expect(hiddenInput).toHaveAttribute('data-form-field', 'hidden-only');
+        expect(hiddenInput).toHaveAttribute('data-validation', 'required');
       });
 
-      const comboboxInput = view.getByRole('combobox');
-      expect(comboboxInput).toHaveAttribute('data-testid', 'multi-attr-test');
-      expect(comboboxInput).toHaveAttribute('data-cy', 'combobox-element');
-      expect(comboboxInput).toHaveAttribute(
-        'data-analytics',
-        'user-interaction'
-      );
-      expect(comboboxInput).toHaveAttribute('data-tracking', 'form-field');
-      expect(comboboxInput).toHaveAttribute('aria-describedby', 'help-text');
-    });
+      it('should handle multiple data attributes in combobox props', () => {
+        const { view } = renderView({
+          isSearchable: false,
+          inputProps: {
+            combobox: {
+              'data-testid': 'multi-attr-test',
+              'data-cy': 'combobox-element',
+              'data-analytics': 'user-interaction',
+              'data-tracking': 'form-field',
+              'aria-describedby': 'help-text',
+            },
+          },
+        });
+
+        const comboboxInput = view.getByRole('combobox');
+        expect(comboboxInput).toHaveAttribute('data-testid', 'multi-attr-test');
+        expect(comboboxInput).toHaveAttribute('data-cy', 'combobox-element');
+        expect(comboboxInput).toHaveAttribute(
+          'data-analytics',
+          'user-interaction'
+        );
+        expect(comboboxInput).toHaveAttribute('data-tracking', 'form-field');
+        expect(comboboxInput).toHaveAttribute('aria-describedby', 'help-text');
+      });
 
-    it('should handle boolean and number values in combobox props', () => {
-      const { view } = renderView({
-        isSearchable: true,
-        inputProps: {
-          combobox: {
-            'data-testid': 'type-test',
-            'data-boolean-true': true,
-            'data-boolean-false': false,
-            'data-number': 42,
-            'data-zero': 0,
+      it('should handle boolean and number values in combobox props', () => {
+        const { view } = renderView({
+          isSearchable: true,
+          inputProps: {
+            combobox: {
+              'data-testid': 'type-test',
+              'data-boolean-true': true,
+              'data-boolean-false': false,
+              'data-number': 42,
+              'data-zero': 0,
+            },
           },
-        },
+        });
+
+        const comboboxInput = view.getByRole('combobox');
+        expect(comboboxInput).toHaveAttribute('data-testid', 'type-test');
+        expect(comboboxInput).toHaveAttribute('data-boolean-true', 'true');
+        expect(comboboxInput).toHaveAttribute('data-boolean-false', 'false');
+        expect(comboboxInput).toHaveAttribute('data-number', '42');
+        expect(comboboxInput).toHaveAttribute('data-zero', '0');
       });
+    });
+
+    describe('validationMessage', () => {
+      it('renders custom node text in place of the default "No options" state', async () => {
+        const { view } = renderView({
+          options: [],
+          validationMessage: 'No fruits available',
+        });
 
-      const comboboxInput = view.getByRole('combobox');
-      expect(comboboxInput).toHaveAttribute('data-testid', 'type-test');
-      expect(comboboxInput).toHaveAttribute('data-boolean-true', 'true');
-      expect(comboboxInput).toHaveAttribute('data-boolean-false', 'false');
-      expect(comboboxInput).toHaveAttribute('data-number', '42');
-      expect(comboboxInput).toHaveAttribute('data-zero', '0');
+        await openDropdown(view);
+
+        expect(view.getByText('No fruits available')).toBeInTheDocument();
+        expect(view.queryByText('No options')).not.toBeInTheDocument();
+      });
     });
   });
 
@@ -467,5 +489,75 @@ describe('SelectDropdown', () => {
 
       expect(view.queryByText('Add "anything"')).not.toBeInTheDocument();
     });
+
+    it('keeps the typed text after the input blurs', async () => {
+      const { view } = renderView({ isCreatable: true });
+
+      const combobox = view.getByRole('combobox');
+
+      await act(async () => {
+        await userEvent.type(combobox, 'pur');
+      });
+
+      await act(async () => {
+        fireEvent.blur(combobox);
+      });
+
+      expect(combobox).toHaveValue('pur');
+    });
+
+    it('does not forward onInputChange to the consumer when the input blurs', async () => {
+      const onInputChange = jest.fn();
+      const { view } = renderView({ isCreatable: true, onInputChange });
+
+      const combobox = view.getByRole('combobox');
+
+      await act(async () => {
+        await userEvent.type(combobox, 'pur');
+      });
+
+      onInputChange.mockClear();
+
+      await act(async () => {
+        fireEvent.blur(combobox);
+      });
+
+      // Text persists, so consumers should not be told the value went empty.
+      expect(onInputChange).not.toHaveBeenCalled();
+    });
+
+    it('clears the typed text after an option is created', async () => {
+      const { view } = renderView({ isCreatable: true });
+
+      const combobox = view.getByRole('combobox');
+
+      await act(async () => {
+        await userEvent.type(combobox, 'purple');
+      });
+
+      await act(async () => {
+        await userEvent.click(view.getByText('Add "purple"'));
+      });
+
+      expect(combobox).toHaveValue('');
+    });
+
+    describe('validationMessage', () => {
+      it('supports a function that receives the current input value', async () => {
+        const { view } = renderView({
+          isCreatable: true,
+          isValidNewOption: () => false,
+          options: [],
+          validationMessage: ({ inputValue }: { inputValue: string }) =>
+            `No match for "${inputValue}"`,
+        });
+
+        await act(async () => {
+          await userEvent.type(view.getByRole('combobox'), 'kiwi');
+        });
+
+        expect(view.getByText('No match for "kiwi"')).toBeInTheDocument();
+      });
+    });
   });
 });
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
index 688d9ba0584..9fc7b6349bf 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
@@ -212,16 +212,25 @@ Use the `isCreatable` prop to allow users to add options that aren't in the list
 
 `isSearchable` is automatically set to `true` when `isCreatable` is `true` (passing `isSearchable={false}` alongside `isCreatable` is a TypeScript error).
 
+In creatable mode the typed text is retained when the input blurs or the menu closes, so a user who clicks away mid-entry can return to it. The text only clears once an option is selected or created.
+
 <Canvas of={SelectDropdownStories.Creatable} />
 
 ### Props
 
-| Prop                | Type                                      | Default              | Description                                                                                               |
-| ------------------- | ----------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------- |
-| `isCreatable`       | `boolean`                                 | `false`              | Enables option creation. Automatically forces `isSearchable` to `true`.                                   |
-| `onCreateOption`    | `(inputValue: string) => void`            | —                    | Called when the user confirms a new option. Append the value to `options` to persist it.                  |
-| `formatCreateLabel` | `(inputValue: string) => ReactNode`       | `Add "inputValue"`   | Customises the label shown in the "Add" row.                                                              |
-| `isValidNewOption`  | `(inputValue, value, options) => boolean` | react-select default | Controls when the "Add" row is visible. Use for min-length gating, pattern validation, or max-items caps. |
+| Prop                | Type                                           | Default              | Description                                                                                                          |
+| ------------------- | ---------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `isCreatable`       | `boolean`                                      | `false`              | Enables option creation. Automatically forces `isSearchable` to `true`.                                              |
+| `onCreateOption`    | `(inputValue: string) => void`                 | —                    | Called when the user confirms a new option. Append the value to `options` to persist it.                             |
+| `formatCreateLabel` | `(inputValue: string) => ReactNode`            | `Add "inputValue"`   | Customises the label shown in the "Add" row.                                                                         |
+| `isValidNewOption`  | `(inputValue, value, options) => boolean`      | react-select default | Controls when the "Add" row is visible. Use for min-length gating, pattern validation, or max-items caps.            |
+| `validationMessage` | `ReactNode \| (({ inputValue }) => ReactNode)` | `"No options"`       | Replaces the in-menu "No options" text. Useful for surfacing validation/error messages directly inside the dropdown. |
+
+### Surfacing validation in the dropdown
+
+`validationMessage` customises the text shown inside the menu when no option matches the current input. Pair it with `isValidNewOption` (to gate the "Add" row) and a `FormGroup` `error` to communicate the same issue both inside the dropdown and below the field.
+
+<Canvas of={SelectDropdownStories.CreatableWithValidation} />
 
 ## Multiple select
 
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
index 4613bfa74d3..e456fc8940d 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
@@ -506,6 +506,7 @@ export const CreatableMulti: Story = {
           label="Pick fruits or add your own"
         >
           <SelectDropdown
+            disabled
             isCreatable
             multiple
             name="creatable-multi-dropdown"
@@ -524,31 +525,40 @@ export const CreatableMulti: Story = {
 export const CreatableWithValidation: Story = {
   render: () => {
     const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    const [error, setError] = useState<string | undefined>();
+
+    const validate = (inputValue: string) => {
+      const trimmed = inputValue.trim();
+      if (trimmed.length < 3) return 'Enter at least 3 characters.';
+      return undefined;
+    };
+
     return (
       <Box height="15rem">
         <FormGroup
+          error={error}
           htmlFor="creatable-validated-dropdown"
           isSoloField
-          label="Min 3 characters — no duplicates (case-insensitive)"
+          label="Pick a fruit that is at least 3 characters long"
         >
           <SelectDropdown
+            error={Boolean(error)}
             isCreatable
+            isValidNewOption={(inputValue: string) =>
+              !validate(inputValue) && inputValue.trim().length > 0
+            }
             name="creatable-validated-dropdown"
             options={options}
             placeholder="Type at least 3 characters to add…"
-            isValidNewOption={(
-              inputValue: string,
-              _value,
-              currentOptions: { label: string }[]
-            ) => {
-              if (inputValue.trim().length < 3) return false;
-              return !currentOptions.some(
-                (opt) =>
-                  opt.label.toLowerCase() === inputValue.trim().toLowerCase()
-              );
+            validationMessage={({ inputValue }) =>
+              validate(inputValue) ?? 'No matching fruit'
+            }
+            onCreateOption={(inputValue) => {
+              setOptions((prev) => [...prev, inputValue.trim()]);
+              setError(undefined);
             }}
-            onCreateOption={(inputValue) =>
-              setOptions((prev) => [...prev, inputValue.trim()])
+            onInputChange={(inputValue: string) =>
+              setError(validate(inputValue))
             }
           />
         </FormGroup>

From cabad9d3f0a8390aef33151914a2866ef89911d7 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 12 Jun 2026 12:58:31 -0400
Subject: [PATCH 31/37] refactor prop table

---
 .../SelectDropdown/SelectDropdown.mdx         |  54 +-
 .../SelectDropdown/SelectDropdown.stories.tsx | 619 +++++++-----------
 .../SelectDropdown/creatablePropsTable.tsx    |  88 +++
 3 files changed, 361 insertions(+), 400 deletions(-)
 create mode 100644 packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx

diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
index 9fc7b6349bf..171301c537f 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
@@ -2,6 +2,7 @@ import { Canvas, Controls, Meta } from '@storybook/addon-docs/blocks';
 
 import { Callout, ComponentHeader, LinkTo } from '~styleguide/blocks';
 
+import { CreatablePropsTable } from './creatablePropsTable';
 import * as SelectDropdownStories from './SelectDropdown.stories';
 
 export const parameters = {
@@ -129,6 +130,21 @@ To add some pizzazz to your dropdown, you can add any of our <LinkTo id='Atoms/I
 
 <Canvas of={SelectDropdownStories.Icons} />
 
+## Accessibility
+
+### FormGroup + SelectDropdown
+
+`SelectDropdown` formats nicely in FormGroups and reflects error states. Make sure you provide an htmlFor to the `FormGroup` and a `name` to the `SelectDropdown` for maximum accessibility. See <LinkTo id="Atoms/FormElements/FormGroup">FormGroup</LinkTo> story for the customizations available.
+
+<Canvas of={SelectDropdownStories.FormGroupSelectDropdown} />
+<Canvas of={SelectDropdownStories.FormGroupError} />
+
+## Multiple select
+
+Set `multiple` to let users choose more than one option. Selected options render as removable tags in the input, and `onChange` receives the full array of selected options (each as `{ label, value }`) rather than a single value. Manage that array as a [controlled component](https://reactjs.org/docs/forms.html#controlled-components).
+
+<Canvas of={SelectDropdownStories.MultipleSelect} />
+
 ### Custom input props
 
 Some of our forms require special props be passed directly onto the input components. We can do that by passing an object with `hidden` and `combobox` properties into our inputProps prop.
@@ -208,42 +224,34 @@ In the example below, the z-index menu is configured to the default value (`auto
 
 ## Creatable
 
-Use the `isCreatable` prop to allow users to add options that aren't in the list. When the user types a value that doesn't match any existing option, an **Add "value"** row appears at the bottom of the dropdown. Selecting it fires `onCreateOption` with the typed string — the consumer is responsible for appending the new option to the `options` array.
+Set `isCreatable` to let users add options that aren't already in the list. When the typed value doesn't match an existing option, an **Add "value"** row appears at the bottom of the menu; selecting it fires `onCreateOption` with the typed string. The consumer owns persistence — append the new value to your `options` array (and, for multi-select, it is added to the current selection).
 
-`isSearchable` is automatically set to `true` when `isCreatable` is `true` (passing `isSearchable={false}` alongside `isCreatable` is a TypeScript error).
+Two behaviors come along automatically in creatable mode:
 
-In creatable mode the typed text is retained when the input blurs or the menu closes, so a user who clicks away mid-entry can return to it. The text only clears once an option is selected or created.
+- **Searchable by default** — `isSearchable` is forced to `true`, since creation needs a text input. Passing `isSearchable={false}` alongside `isCreatable` is a TypeScript error.
+- **Typed text persists on blur** — if the user clicks away or the menu closes mid-entry, their text is kept so they can pick up where they left off. It clears only once an option is selected or created.
 
-<Canvas of={SelectDropdownStories.Creatable} />
+### Basic usage
 
-### Props
+A single-select creatable dropdown. Type a value that isn't listed, choose the **Add** row, and `onCreateOption` appends it to the options.
 
-| Prop                | Type                                           | Default              | Description                                                                                                          |
-| ------------------- | ---------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `isCreatable`       | `boolean`                                      | `false`              | Enables option creation. Automatically forces `isSearchable` to `true`.                                              |
-| `onCreateOption`    | `(inputValue: string) => void`                 | —                    | Called when the user confirms a new option. Append the value to `options` to persist it.                             |
-| `formatCreateLabel` | `(inputValue: string) => ReactNode`            | `Add "inputValue"`   | Customises the label shown in the "Add" row.                                                                         |
-| `isValidNewOption`  | `(inputValue, value, options) => boolean`      | react-select default | Controls when the "Add" row is visible. Use for min-length gating, pattern validation, or max-items caps.            |
-| `validationMessage` | `ReactNode \| (({ inputValue }) => ReactNode)` | `"No options"`       | Replaces the in-menu "No options" text. Useful for surfacing validation/error messages directly inside the dropdown. |
+<Canvas of={SelectDropdownStories.Creatable} />
 
-### Surfacing validation in the dropdown
+### Multiple selection
 
-`validationMessage` customises the text shown inside the menu when no option matches the current input. Pair it with `isValidNewOption` (to gate the "Add" row) and a `FormGroup` `error` to communicate the same issue both inside the dropdown and below the field.
+Combine `isCreatable` with `multiple` to let users select several existing options and add their own. Each created value is appended to the options list and included in the current selection.
 
-<Canvas of={SelectDropdownStories.CreatableWithValidation} />
+<Canvas of={SelectDropdownStories.CreatableMulti} />
 
-## Multiple select
-
-<Canvas of={SelectDropdownStories.MultipleSelect} />
+### Validation and inline messages
 
-## Accessibility
+Gate which inputs can be added with `isValidNewOption` — return `false` to hide the **Add** row (e.g. minimum length, pattern matching, or de-duplication). Use `validationMessage` to replace the menu's default "No options" text with contextual feedback, and mirror the same message in a `FormGroup` `error` so it's also surfaced below the field.
 
-### FormGroup + SelectDropdown
+<Canvas of={SelectDropdownStories.CreatableWithValidation} />
 
-`SelectDropdown` formats nicely in FormGroups and reflects error states. Make sure you provide an htmlFor to the `FormGroup` and a `name` to the `SelectDropdown` for maximum accessibility. See <LinkTo id="Atoms/FormElements/FormGroup">FormGroup</LinkTo> story for the customizations available.
+### Props
 
-<Canvas of={SelectDropdownStories.FormGroupSelectDropdown} />
-<Canvas of={SelectDropdownStories.FormGroupError} />
+<CreatablePropsTable />
 
 ## Playground
 
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
index e456fc8940d..97a3f5d9b18 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
@@ -32,15 +32,6 @@ const meta: Meta<typeof SelectDropdown> = {
 export default meta;
 type Story = StoryObj<typeof SelectDropdown>;
 
-export const Default: Story = {
-  args: {},
-  render: (args) => (
-    <Box height="18rem">
-      <SelectDropdown {...args} />
-    </Box>
-  ),
-};
-
 export const Base: Story = {
   args: {
     name: 'base-dropdown',
@@ -446,127 +437,6 @@ export const Icons: Story = {
   ),
 };
 
-export const CustomInputProps: Story = {
-  args: {
-    options: ['inspect me to see my inputProps', 'yes I am!', ':)'],
-    inputProps: {
-      hidden: { 'data-form-field': 'what' },
-      combobox: {
-        'data-testid': 'custom-select',
-        'data-cy': 'custom-dropdown',
-      },
-    },
-    name: 'what',
-  },
-  render: (args) => (
-    <Box height="15rem">
-      <FormGroup htmlFor="what" isSoloField label="i am ~styled">
-        <SelectDropdown {...args} />
-      </FormGroup>
-    </Box>
-  ),
-};
-
-export const Creatable: Story = {
-  args: {
-    name: 'creatable-dropdown',
-    isCreatable: true,
-    placeholder: 'Select or type to add…',
-  },
-  render: (args) => {
-    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
-    return (
-      <Box height="15rem">
-        <FormGroup
-          htmlFor="creatable-dropdown"
-          isSoloField
-          label="Type a new fruit and press Enter"
-        >
-          <SelectDropdown
-            {...args}
-            options={options}
-            onCreateOption={(inputValue) =>
-              setOptions((prev) => [...prev, inputValue])
-            }
-          />
-        </FormGroup>
-      </Box>
-    );
-  },
-};
-
-export const CreatableMulti: Story = {
-  render: () => {
-    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
-    return (
-      <Box height="18rem">
-        <FormGroup
-          htmlFor="creatable-multi-dropdown"
-          isSoloField
-          label="Pick fruits or add your own"
-        >
-          <SelectDropdown
-            disabled
-            isCreatable
-            multiple
-            name="creatable-multi-dropdown"
-            options={options}
-            placeholder="Select or type to add…"
-            onCreateOption={(inputValue) =>
-              setOptions((prev) => [...prev, inputValue])
-            }
-          />
-        </FormGroup>
-      </Box>
-    );
-  },
-};
-
-export const CreatableWithValidation: Story = {
-  render: () => {
-    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
-    const [error, setError] = useState<string | undefined>();
-
-    const validate = (inputValue: string) => {
-      const trimmed = inputValue.trim();
-      if (trimmed.length < 3) return 'Enter at least 3 characters.';
-      return undefined;
-    };
-
-    return (
-      <Box height="15rem">
-        <FormGroup
-          error={error}
-          htmlFor="creatable-validated-dropdown"
-          isSoloField
-          label="Pick a fruit that is at least 3 characters long"
-        >
-          <SelectDropdown
-            error={Boolean(error)}
-            isCreatable
-            isValidNewOption={(inputValue: string) =>
-              !validate(inputValue) && inputValue.trim().length > 0
-            }
-            name="creatable-validated-dropdown"
-            options={options}
-            placeholder="Type at least 3 characters to add…"
-            validationMessage={({ inputValue }) =>
-              validate(inputValue) ?? 'No matching fruit'
-            }
-            onCreateOption={(inputValue) => {
-              setOptions((prev) => [...prev, inputValue.trim()]);
-              setError(undefined);
-            }}
-            onInputChange={(inputValue: string) =>
-              setError(validate(inputValue))
-            }
-          />
-        </FormGroup>
-      </Box>
-    );
-  },
-};
-
 export const MultipleSelect: Story = {
   args: {
     name: 'multi-dropdown',
@@ -599,46 +469,27 @@ export const MultipleSelect: Story = {
   ),
 };
 
-export const FormGroupSelectDropdown: Story = {
+export const CustomInputProps: Story = {
   args: {
-    options: ['hello', 'hi', 'howdy'],
-    value: 'oh no',
-    name: 'big-label',
+    options: ['inspect me to see my inputProps', 'yes I am!', ':)'],
+    inputProps: {
+      hidden: { 'data-form-field': 'what' },
+      combobox: {
+        'data-testid': 'custom-select',
+        'data-cy': 'custom-dropdown',
+      },
+    },
+    name: 'what',
   },
   render: (args) => (
     <Box height="15rem">
-      <FormGroup
-        htmlFor="big-label"
-        isSoloField
-        label="i am big label"
-        labelSize="large"
-      >
+      <FormGroup htmlFor="what" isSoloField label="i am ~styled">
         <SelectDropdown {...args} />
       </FormGroup>
     </Box>
   ),
 };
 
-export const FormGroupError: Story = {
-  args: {
-    options: ['Error', 'oh no', ':('],
-    name: 'error-example-unique',
-    placeholder: 'cry cry cry',
-  },
-  render: (args) => (
-    <Box height="15rem">
-      <FormGroup
-        error="error message!! no :'("
-        htmlFor="error-example-unique"
-        isSoloField
-        label="i am ~styled... but something is wrong"
-      >
-        <SelectDropdown error {...args} />
-      </FormGroup>
-    </Box>
-  ),
-};
-
 export const AbbreviatedInput: Story = {
   args: {
     name: 'abbreviated-dropdown',
@@ -687,59 +538,9 @@ export const AbbreviatedInput: Story = {
   ),
 };
 
-export const IndependentWidths: Story = {
-  args: {
-    name: 'width-dropdown',
-    options: [
-      {
-        label: 'Machine Learning Engineer',
-        abbreviation: 'ML Eng',
-        value: 'ml-engineer',
-        subtitle: 'Build AI/ML systems',
-      },
-      {
-        label: 'Frontend Developer',
-        abbreviation: 'FE Dev',
-        value: 'frontend-dev',
-        subtitle: 'React, Vue, Angular',
-      },
-      {
-        label: 'Backend Developer',
-        abbreviation: 'BE Dev',
-        value: 'backend-dev',
-        subtitle: 'Node.js, Python, Java',
-      },
-      {
-        label: 'Full Stack Developer',
-        abbreviation: 'FS Dev',
-        value: 'fullstack-dev',
-        subtitle: 'End-to-end development',
-      },
-    ],
-    inputWidth: '150px',
-    dropdownWidth: '350px',
-
-    placeholder: 'Select a role',
-  },
-  render: (args) => (
-    <Box height="20rem">
-      <FormGroup
-        htmlFor="width-dropdown"
-        isSoloField
-        label="Independent Width Control"
-      >
-        <SelectDropdown {...args} />
-      </FormGroup>
-      <Box color="text-secondary" mt={4}>
-        Input is 150px wide, dropdown is 350px wide
-      </Box>
-    </Box>
-  ),
-};
-
-export const SmallWithAbbreviations: Story = {
+export const AbbreviatedSmallSize: Story = {
   args: {
-    name: 'small-abbreviated-dropdown',
+    name: 'abbreviated-small',
     options: [
       {
         label: 'JavaScript',
@@ -761,37 +562,27 @@ export const SmallWithAbbreviations: Story = {
         abbreviation: 'Java',
         value: 'java',
       },
-      {
-        label: 'C++',
-        abbreviation: 'C++',
-        value: 'cpp',
-      },
     ],
     size: 'small',
     inputWidth: '80px',
     dropdownWidth: '200px',
-    placeholder: 'Select JScript',
   },
   render: (args) => (
     <Box height="15rem">
       <FormGroup
-        htmlFor="small-abbreviated-dropdown"
+        htmlFor="abbreviated-small"
         isSoloField
         label="Small Size with Abbreviations"
       >
         <SelectDropdown {...args} />
       </FormGroup>
-      <Box color="text-secondary" mt={4}>
-        Small size, input shows &quot;JS&quot; but dropdown shows
-        &quot;JavaScript&quot;
-      </Box>
     </Box>
   ),
 };
 
-export const ComplexAbbreviatedOptions: Story = {
+export const AbbreviatedWithSubtitleAndRightLabel: Story = {
   args: {
-    name: 'complex-abbreviated-dropdown',
+    name: 'abbreviated-detailed',
     options: [
       {
         label: 'Senior Software Engineer',
@@ -814,37 +605,24 @@ export const ComplexAbbreviatedOptions: Story = {
         subtitle: '8+ years experience',
         rightLabel: 'Staff',
       },
-      {
-        label: 'Distinguished Engineer',
-        abbreviation: 'Distinguished Eng',
-        value: 'distinguished-eng',
-        subtitle: '15+ years experience',
-        rightLabel: 'Distinguished',
-      },
     ],
-    inputWidth: '80px',
-    dropdownWidth: '400px',
-    placeholder: 'Select seniority level',
   },
   render: (args) => (
     <Box height="22rem">
       <FormGroup
-        htmlFor="complex-abbreviated-dropdown"
+        htmlFor="abbreviated-detailed"
         isSoloField
-        label="Complex Options with Abbreviations"
+        label="Abbreviated with Additional Details"
       >
         <SelectDropdown {...args} />
       </FormGroup>
-      <Box color="text-secondary" mt={4}>
-        Shows abbreviated text in input, full details in dropdown
-      </Box>
     </Box>
   ),
 };
 
-export const AbbreviatedWithSubtitleAndRightLabel: Story = {
+export const ComplexAbbreviatedOptions: Story = {
   args: {
-    name: 'abbreviated-detailed',
+    name: 'complex-abbreviated-dropdown',
     options: [
       {
         label: 'Senior Software Engineer',
@@ -867,66 +645,44 @@ export const AbbreviatedWithSubtitleAndRightLabel: Story = {
         subtitle: '8+ years experience',
         rightLabel: 'Staff',
       },
+      {
+        label: 'Distinguished Engineer',
+        abbreviation: 'Distinguished Eng',
+        value: 'distinguished-eng',
+        subtitle: '15+ years experience',
+        rightLabel: 'Distinguished',
+      },
     ],
+    inputWidth: '80px',
+    dropdownWidth: '400px',
+    placeholder: 'Select seniority level',
   },
   render: (args) => (
     <Box height="22rem">
       <FormGroup
-        htmlFor="abbreviated-detailed"
+        htmlFor="complex-abbreviated-dropdown"
         isSoloField
-        label="Abbreviated with Additional Details"
+        label="Complex Options with Abbreviations"
       >
         <SelectDropdown {...args} />
       </FormGroup>
+      <Box color="text-secondary" mt={4}>
+        Shows abbreviated text in input, full details in dropdown
+      </Box>
     </Box>
   ),
 };
 
-export const AbbreviatedSmallSize: Story = {
+export const IndependentWidths: Story = {
   args: {
-    name: 'abbreviated-small',
+    name: 'width-dropdown',
     options: [
       {
-        label: 'JavaScript',
-        abbreviation: 'JS',
-        value: 'javascript',
-      },
-      {
-        label: 'TypeScript',
-        abbreviation: 'TS',
-        value: 'typescript',
-      },
-      {
-        label: 'Python',
-        abbreviation: 'PY',
-        value: 'python',
-      },
-      {
-        label: 'Java',
-        abbreviation: 'Java',
-        value: 'java',
+        label: 'Machine Learning Engineer',
+        abbreviation: 'ML Eng',
+        value: 'ml-engineer',
+        subtitle: 'Build AI/ML systems',
       },
-    ],
-    size: 'small',
-    inputWidth: '80px',
-    dropdownWidth: '200px',
-  },
-  render: (args) => (
-    <Box height="15rem">
-      <FormGroup
-        htmlFor="abbreviated-small"
-        isSoloField
-        label="Small Size with Abbreviations"
-      >
-        <SelectDropdown {...args} />
-      </FormGroup>
-    </Box>
-  ),
-};
-export const MenuAlignmentRight: Story = {
-  args: {
-    name: 'menu-alignment-right',
-    options: [
       {
         label: 'Frontend Developer',
         abbreviation: 'FE Dev',
@@ -947,37 +703,29 @@ export const MenuAlignmentRight: Story = {
       },
     ],
     inputWidth: '150px',
-    dropdownWidth: '300px',
-    menuAlignment: 'right',
+    dropdownWidth: '350px',
+
     placeholder: 'Select a role',
   },
   render: (args) => (
-    <FlexBox
-      alignItems="center"
-      flexDirection="column"
-      height="20rem"
-      width={1}
-    >
+    <Box height="20rem">
       <FormGroup
-        htmlFor="menu-alignment-right"
+        htmlFor="width-dropdown"
         isSoloField
-        label="Menu Alignment: Right"
-        width="150px"
+        label="Independent Width Control"
       >
         <SelectDropdown {...args} />
       </FormGroup>
       <Box color="text-secondary" mt={4}>
-        Dropdown aligns to the right edge of the input
+        Input is 150px wide, dropdown is 350px wide
       </Box>
-    </FlexBox>
+    </Box>
   ),
 };
 
-// These are for testing, I will delete before shipping
-
-export const DisabledMultiValue: Story = {
+export const SmallWithAbbreviations: Story = {
   args: {
-    name: 'disabled-small-multi',
+    name: 'small-abbreviated-dropdown',
     options: [
       {
         label: 'JavaScript',
@@ -999,117 +747,86 @@ export const DisabledMultiValue: Story = {
         abbreviation: 'Java',
         value: 'java',
       },
+      {
+        label: 'C++',
+        abbreviation: 'C++',
+        value: 'cpp',
+      },
     ],
-    placeholder: 'Long truncated placeholder',
     size: 'small',
-    inputWidth: '100px',
+    inputWidth: '80px',
     dropdownWidth: '200px',
-    multiple: true,
-    value: ['python', 'java'],
-    disabled: true,
+    placeholder: 'Select JScript',
   },
   render: (args) => (
     <Box height="15rem">
       <FormGroup
-        htmlFor="abbreviated-small"
+        htmlFor="small-abbreviated-dropdown"
         isSoloField
         label="Small Size with Abbreviations"
       >
         <SelectDropdown {...args} />
       </FormGroup>
+      <Box color="text-secondary" mt={4}>
+        Small size, input shows &quot;JS&quot; but dropdown shows
+        &quot;JavaScript&quot;
+      </Box>
     </Box>
   ),
 };
 
-export const LongPlaceholder: Story = {
-  args: {
-    name: 'long-placeholder',
-    options: [
-      {
-        label: 'JavaScript',
-        abbreviation: 'JS',
-        value: 'javascript',
-      },
-      {
-        label: 'TypeScript',
-        abbreviation: 'TS',
-        value: 'typescript',
-      },
-      {
-        label: 'Python',
-        abbreviation: 'PY',
-        value: 'python',
-      },
-      {
-        label: 'Java',
-        abbreviation: 'Java',
-        value: 'java',
-      },
-    ],
-    placeholder: 'Long truncated placeholder',
-    size: 'small',
-    inputWidth: '300px',
-    dropdownWidth: '400px',
-    multiple: true,
-    menuAlignment: 'right',
-  },
-  render: (args) => (
-    <Box height="15rem" ml={8}>
-      <FormGroup
-        htmlFor="long-placeholder"
-        isSoloField
-        label="Small Size with Abbreviations"
-      >
-        <SelectDropdown {...args} />
-      </FormGroup>
-    </Box>
-  ),
-};
-export const LongPlaceholderAgain: Story = {
+export const MenuAlignmentRight: Story = {
   args: {
-    name: 'long-placeholder-again',
+    name: 'menu-alignment-right',
     options: [
       {
-        label: 'JavaScript',
-        abbreviation: 'JS',
-        value: 'javascript',
-      },
-      {
-        label: 'TypeScript',
-        abbreviation: 'TS',
-        value: 'typescript',
+        label: 'Frontend Developer',
+        abbreviation: 'FE Dev',
+        value: 'frontend-dev',
+        subtitle: 'React, Vue, Angular',
       },
       {
-        label: 'Python',
-        abbreviation: 'PY',
-        value: 'python',
+        label: 'Backend Developer',
+        abbreviation: 'BE Dev',
+        value: 'backend-dev',
+        subtitle: 'Node.js, Python, Java',
       },
       {
-        label: 'Java',
-        abbreviation: 'Java',
-        value: 'java',
+        label: 'Full Stack Developer',
+        abbreviation: 'FS Dev',
+        value: 'fullstack-dev',
+        subtitle: 'End-to-end development',
       },
     ],
-    placeholder: 'Long truncated placeholder',
-    size: 'small',
-    inputWidth: '400px',
-    dropdownWidth: '200px',
-    multiple: true,
+    inputWidth: '150px',
+    dropdownWidth: '300px',
     menuAlignment: 'right',
+    placeholder: 'Select a role',
   },
   render: (args) => (
-    <Box height="15rem">
+    <FlexBox
+      alignItems="center"
+      flexDirection="column"
+      height="20rem"
+      width={1}
+    >
       <FormGroup
-        htmlFor="long-placeholder-again"
+        htmlFor="menu-alignment-right"
         isSoloField
-        label="Small Size with Abbreviations"
+        label="Menu Alignment: Right"
+        width="150px"
       >
         <SelectDropdown {...args} />
       </FormGroup>
-    </Box>
+      <Box color="text-secondary" mt={4}>
+        Dropdown aligns to the right edge of the input
+      </Box>
+    </FlexBox>
   ),
 };
 
+// These are for testing, I will delete before shipping
+
 export const zIndexOnMenu: Story = {
   render: (args) => (
     <FlexBox column height="500px">
@@ -1170,3 +887,151 @@ export const zIndexOnMenu: Story = {
     </FlexBox>
   ),
 };
+
+export const Creatable: Story = {
+  args: {
+    name: 'creatable-dropdown',
+    isCreatable: true,
+    placeholder: 'Select or type to add…',
+  },
+  render: (args) => {
+    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    return (
+      <Box height="15rem">
+        <FormGroup
+          htmlFor="creatable-dropdown"
+          isSoloField
+          label="Type a new fruit and press Enter"
+        >
+          <SelectDropdown
+            {...args}
+            options={options}
+            onCreateOption={(inputValue) =>
+              setOptions((prev) => [...prev, inputValue])
+            }
+          />
+        </FormGroup>
+      </Box>
+    );
+  },
+};
+
+export const CreatableMulti: Story = {
+  render: () => {
+    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    return (
+      <Box height="18rem">
+        <FormGroup
+          htmlFor="creatable-multi-dropdown"
+          isSoloField
+          label="Pick fruits or add your own"
+        >
+          <SelectDropdown
+            isCreatable
+            multiple
+            name="creatable-multi-dropdown"
+            options={options}
+            placeholder="Select or type to add…"
+            onCreateOption={(inputValue) =>
+              setOptions((prev) => [...prev, inputValue])
+            }
+          />
+        </FormGroup>
+      </Box>
+    );
+  },
+};
+
+export const CreatableWithValidation: Story = {
+  render: () => {
+    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    const [error, setError] = useState<string | undefined>();
+
+    const validate = (inputValue: string) => {
+      const trimmed = inputValue.trim();
+      if (trimmed.length < 3) return 'Enter at least 3 characters.';
+      return undefined;
+    };
+
+    return (
+      <Box height="15rem">
+        <FormGroup
+          error={error}
+          htmlFor="creatable-validated-dropdown"
+          isSoloField
+          label="Pick a fruit that is at least 3 characters long"
+        >
+          <SelectDropdown
+            error={Boolean(error)}
+            isCreatable
+            isValidNewOption={(inputValue: string) =>
+              !validate(inputValue) && inputValue.trim().length > 0
+            }
+            name="creatable-validated-dropdown"
+            options={options}
+            placeholder="Type at least 3 characters to add…"
+            validationMessage={({ inputValue }) =>
+              validate(inputValue) ?? 'No matching fruit'
+            }
+            onCreateOption={(inputValue) => {
+              setOptions((prev) => [...prev, inputValue.trim()]);
+              setError(undefined);
+            }}
+            onInputChange={(inputValue: string) =>
+              setError(validate(inputValue))
+            }
+          />
+        </FormGroup>
+      </Box>
+    );
+  },
+};
+
+export const FormGroupSelectDropdown: Story = {
+  args: {
+    options: ['hello', 'hi', 'howdy'],
+    value: 'oh no',
+    name: 'big-label',
+  },
+  render: (args) => (
+    <Box height="15rem">
+      <FormGroup
+        htmlFor="big-label"
+        isSoloField
+        label="i am big label"
+        labelSize="large"
+      >
+        <SelectDropdown {...args} />
+      </FormGroup>
+    </Box>
+  ),
+};
+
+export const FormGroupError: Story = {
+  args: {
+    options: ['Error', 'oh no', ':('],
+    name: 'error-example-unique',
+    placeholder: 'cry cry cry',
+  },
+  render: (args) => (
+    <Box height="15rem">
+      <FormGroup
+        error="error message!! no :'("
+        htmlFor="error-example-unique"
+        isSoloField
+        label="i am ~styled... but something is wrong"
+      >
+        <SelectDropdown error {...args} />
+      </FormGroup>
+    </Box>
+  ),
+};
+
+export const Default: Story = {
+  args: {},
+  render: (args) => (
+    <Box height="18rem">
+      <SelectDropdown {...args} />
+    </Box>
+  ),
+};
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
new file mode 100644
index 00000000000..fcaa243dffd
--- /dev/null
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
@@ -0,0 +1,88 @@
+import { Code, TokenTable } from '~styleguide/blocks';
+
+const creatablePropColumns = [
+  {
+    key: 'prop',
+    name: 'Prop',
+    size: 'md' as const,
+    render: ({ prop }: { prop: string }) => <Code>{prop}</Code>,
+  },
+  {
+    key: 'type',
+    name: 'Type',
+    size: 'lg' as const,
+    render: ({ type }: { type: string }) => <Code>{type}</Code>,
+  },
+  {
+    key: 'defaultValue',
+    name: 'Default',
+    size: 'md' as const,
+    render: ({ defaultValue }: { defaultValue: string | null }) =>
+      defaultValue ? <Code>{defaultValue}</Code> : '—',
+  },
+  {
+    key: 'description',
+    name: 'Description',
+    size: 'fill' as const,
+    render: ({ description }: { description: React.ReactNode }) => description,
+  },
+];
+
+const creatableProps = [
+  {
+    id: 'isCreatable',
+    prop: 'isCreatable',
+    type: 'boolean',
+    defaultValue: 'false',
+    description: (
+      <>
+        Enables option creation. Automatically forces <Code>isSearchable</Code>{' '}
+        to <Code>true</Code>.
+      </>
+    ),
+  },
+  {
+    id: 'onCreateOption',
+    prop: 'onCreateOption',
+    type: '(inputValue: string) => void',
+    defaultValue: null,
+    description: (
+      <>
+        Called when the user confirms a new option. Append the value to{' '}
+        <Code>options</Code> to persist it.
+      </>
+    ),
+  },
+  {
+    id: 'formatCreateLabel',
+    prop: 'formatCreateLabel',
+    type: '(inputValue: string) => ReactNode',
+    defaultValue: 'Add "inputValue"',
+    description: 'Customises the label shown in the "Add" row.',
+  },
+  {
+    id: 'isValidNewOption',
+    prop: 'isValidNewOption',
+    type: '(inputValue, value, options) => boolean',
+    defaultValue: 'react-select default',
+    description:
+      'Controls when the "Add" row is visible. Use for min-length gating, pattern validation, or max-items caps.',
+  },
+  {
+    id: 'validationMessage',
+    prop: 'validationMessage',
+    type: 'ReactNode | (({ inputValue }) => ReactNode)',
+    defaultValue: '"No options"',
+    description:
+      'Replaces the in-menu "No options" text. Useful for surfacing validation/error messages directly inside the dropdown.',
+  },
+];
+
+export const CreatablePropsTable = () => (
+  <TokenTable
+    bg={false}
+    columns={creatablePropColumns}
+    idKey="id"
+    rows={creatableProps}
+  />
+);

From 2ab39cec79d664cc79641921291c30b3c03a515b Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 12 Jun 2026 15:33:16 -0400
Subject: [PATCH 32/37] write SelectDropdown skill

---
 .../agent-tools/skills/gamut-forms/SKILL.md   |   6 +
 .../skills/gamut-select-dropdown/SKILL.md     | 155 ++++++++++++++++
 .../Form/SelectDropdown/SelectDropdown.tsx    |  76 ++++----
 .../SelectDropdown/elements/containers.tsx    |   8 +-
 .../SelectDropdown/types/component-props.ts   |   9 +-
 .../Form/__tests__/SelectDropdown.test.tsx    | 163 ++++++++++++++++-
 .../SelectDropdown/SelectDropdown.mdx         | 154 +++++++++-------
 .../SelectDropdown/SelectDropdown.stories.tsx | 166 +++++++++++++-----
 .../SelectDropdown/controlledModeTable.tsx    |  92 ++++++++++
 .../SelectDropdown/creatablePropsTable.tsx    |   5 +-
 10 files changed, 660 insertions(+), 174 deletions(-)
 create mode 100644 packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md
 create mode 100644 packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx

diff --git a/packages/gamut/agent-tools/skills/gamut-forms/SKILL.md b/packages/gamut/agent-tools/skills/gamut-forms/SKILL.md
index ea61d364efa..758001eb5fd 100644
--- a/packages/gamut/agent-tools/skills/gamut-forms/SKILL.md
+++ b/packages/gamut/agent-tools/skills/gamut-forms/SKILL.md
@@ -26,6 +26,12 @@ For typical product forms, prefer `GridForm` (declarative `fields`, `LayoutGrid`
 
 ---
 
+## SelectDropdown
+
+For `SelectDropdown` — single vs multi value, controlled vs uncontrolled patterns, creatable options, and react-select action metadata — use [`gamut-select-dropdown`](../gamut-select-dropdown/SKILL.md). Generic `FormGroup` wiring (labels, errors, live regions) still applies as documented below; SelectDropdown-specific state contracts live in that skill.
+
+---
+
 ## `FormGroup` (baseline)
 
 [`FormGroup.tsx`](https://github.com/Codecademy/gamut/blob/main/packages/gamut/src/Form/elements/FormGroup.tsx)
diff --git a/packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md b/packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md
new file mode 100644
index 00000000000..00939e1e8bb
--- /dev/null
+++ b/packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md
@@ -0,0 +1,155 @@
+---
+name: gamut-select-dropdown
+description: Use when implementing or auditing SelectDropdown — single/multi modes, controlled vs uncontrolled value, creatable options, FormGroup wiring, and react-select action meta. Pair with gamut-forms for FormGroup/validation patterns.
+---
+
+# Gamut SelectDropdown
+
+Styled dropdown built on react-select. Supports single and multi-select, searchable menus, creatable options, icons, groups, and abbreviations.
+
+Source: `@codecademy/gamut` — [SelectDropdown.tsx](https://github.com/Codecademy/gamut/blob/main/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx)
+
+See also: [`gamut-forms`](../gamut-forms/SKILL.md) — FormGroup wiring, error regions, and validation UX.
+
+Storybook: [Atoms / FormInputs / SelectDropdown](https://gamut.codecademy.com/?path=/docs-atoms-forminputs-selectdropdown--docs)
+
+---
+
+## When to use SelectDropdown vs Select
+
+Use `Select` for standard single-select forms with minimal bundle cost. Use `SelectDropdown` when designs specify the styled dropdown menu, search, multi-select tags, creatable options, icons, groups, or abbreviations. SelectDropdown has a larger JavaScript dependency (react-select).
+
+---
+
+## Controlled vs uncontrolled
+
+SelectDropdown does **not** accept `defaultValue`.
+
+| Mode             | Uncontrolled                                       | Controlled                                                                        |
+| ---------------- | -------------------------------------------------- | --------------------------------------------------------------------------------- |
+| Single           | Not supported                                      | `value` (string) + update in `onChange`                                           |
+| Multi            | Omit `value` or pass non-array (`undefined`, `''`) | `value: string[]` + update in `onChange`                                          |
+| Creatable single | Not supported                                      | Same as single; `onCreateOption` appends to `options`                             |
+| Creatable multi  | Omit `value`; `onCreateOption` for options         | `value: string[]`; update in `onChange` on every change including `create-option` |
+
+Single-select selection is derived from the `value` prop only — internal state is not kept. Multi-select without `value: string[]` keeps selection in internal `multiValues`.
+
+**Controlled creatable multi pitfall:** Updating `options` alone without syncing `value` in `onChange` clears selection when options re-render.
+
+---
+
+## onChange contract
+
+`onChange` receives option object(s), not `event.target.value`:
+
+```tsx
+// Single
+onChange={(option) => setValue(option.value)}
+
+// Multi
+onChange={(selected) => setValue(selected.map((o) => o.value))}
+```
+
+Second argument is react-select `ActionMeta`. For creatable creates: `meta.action === 'create-option'`. Do **not** pass `onCreateOption` to react-select directly — Gamut invokes it from `changeHandler` while still forwarding `create-option` to consumer `onChange`.
+
+---
+
+## Creatable
+
+- `isCreatable` forces `isSearchable: true` (TypeScript enforces this).
+- `onCreateOption(inputValue)` — convenience hook to append to `options`.
+- `onChange(selected, meta)` — use `meta.action === 'create-option'` to sync controlled `value` and `options` together.
+- `isValidNewOption` — return `false` to hide the Add row.
+- `validationMessage` — replaces menu "No options" text; mirror in `FormGroup` `error` for field-level feedback.
+
+**Validation after blur:** react-select clears input on blur. Handle `onInputChange`: validate on `input-change`, re-validate from last typed value on `input-blur` so FormGroup error persists.
+
+---
+
+## FormGroup wiring
+
+- `FormGroup` `htmlFor` must match control `id` / `name`.
+- Pass `name` on SelectDropdown (required for forms).
+- Pass `error` boolean when FormGroup has an error.
+- Generic FormGroup live-region behavior: see [`gamut-forms`](../gamut-forms/SKILL.md).
+
+```tsx
+<FormGroup htmlFor="country" isSoloField label="Country" error={errors.country}>
+  <SelectDropdown
+    name="country"
+    options={options}
+    value={value}
+    error={Boolean(errors.country)}
+    onChange={(option) => setValue(option.value)}
+  />
+</FormGroup>
+```
+
+---
+
+## Examples
+
+### Single (controlled)
+
+```tsx
+const [value, setValue] = useState('us');
+
+<SelectDropdown
+  name="country"
+  options={options}
+  value={value}
+  onChange={(option) => setValue(option.value)}
+/>;
+```
+
+### Multi (uncontrolled)
+
+```tsx
+<SelectDropdown
+  multiple
+  name="tags"
+  options={options}
+  onChange={(selected) => console.log(selected)}
+/>
+```
+
+### Creatable multi (uncontrolled)
+
+```tsx
+const [options, setOptions] = useState(['Apple', 'Banana']);
+
+<SelectDropdown
+  isCreatable
+  multiple
+  name="fruits"
+  options={options}
+  onCreateOption={(v) => setOptions((prev) => [...prev, v])}
+/>;
+```
+
+### Creatable multi (controlled)
+
+```tsx
+const [options, setOptions] = useState(['Apple', 'Banana']);
+const [value, setValue] = useState<string[]>([]);
+
+<SelectDropdown
+  isCreatable
+  multiple
+  name="fruits"
+  options={options}
+  value={value}
+  onChange={(selected, meta) => {
+    setValue(selected.map((o) => o.value));
+    if (meta.action === 'create-option' && meta.option) {
+      setOptions((prev) => [...prev, meta.option.value]);
+    }
+  }}
+/>;
+```
+
+---
+
+## Storybook note
+
+Default story args include `value: ''`. Spreading `{...args}` in custom renders behaves as controlled empty single. Omit `value` when demonstrating uncontrolled multi or creatable multi.
diff --git a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
index 4c9ec54557d..f164ef0f068 100644
--- a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
@@ -9,11 +9,7 @@ import {
   useState,
 } from 'react';
 import * as React from 'react';
-import {
-  InputActionMeta,
-  Options as OptionsType,
-  StylesConfig,
-} from 'react-select';
+import { ActionMeta, Options as OptionsType, StylesConfig } from 'react-select';
 
 import { parseOptions, SelectOptionBase } from '../utils';
 import {
@@ -142,9 +138,6 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
 
   const [activated, setActivated] = useState(false);
   const [currentFocusedValue, setCurrentFocusedValue] = useState(undefined);
-  // Controlled input value for creatable mode so typed text persists across
-  // blur / menu-close (react-select clears it by default).
-  const [inputValue, setInputValue] = useState('');
 
   // these are used to programatically manage the focus state of our multi-select options + 'Remove all' button
   const removeAllButtonRef = useRef<HTMLDivElement>(null);
@@ -195,8 +188,11 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
       )
   );
 
-  // If the caller changes the initial value, let's update our value to match.
+  // Sync multi-select value from props when controlled (`value` is a string[]).
+  // Uncontrolled multi (`value` undefined or '') keeps selection in local state.
   useEffect(() => {
+    if (!multiple || !Array.isArray(value)) return;
+
     const newMultiValues = filterValueFromOptions(
       selectOptions,
       value,
@@ -206,35 +202,46 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
 
     // We only update this when our passed in options or value changes, not multiValues.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [options, value]);
+  }, [options, value, multiple]);
 
   const changeHandler = useCallback(
-    (optionEvent: OptionStrict | OptionsType<OptionStrict>) => {
+    (
+      optionEvent: OptionStrict | OptionsType<OptionStrict>,
+      actionMeta: ActionMeta<OptionStrict>
+    ) => {
       setActivated(true);
 
-      // We have to do this because the version of typescript we have doesn't have the transitivity of these type guards yet. But, we will soon!
-      // Should probably come with: https://codecademy.atlassian.net/browse/GM-354
+      if (actionMeta.action === 'create-option') {
+        onCreateOption?.(actionMeta.option?.value ?? '');
+      }
+
       const onChangeProps = { onChange, multiple };
+      const forwardedMeta: ActionMeta<OptionStrict> =
+        actionMeta.action === 'create-option'
+          ? actionMeta
+          : {
+              action: onChangeAction,
+              option: isMultipleSelectProps(onChangeProps)
+                ? undefined
+                : (optionEvent as OptionStrict),
+            };
 
       if (isSingleSelectProps(onChangeProps)) {
         const singleOptionEvent = optionEvent as OptionStrict;
 
-        onChangeProps.onChange?.(singleOptionEvent, {
-          action: onChangeAction,
-          option: singleOptionEvent,
-        });
+        onChangeProps.onChange?.(singleOptionEvent, forwardedMeta);
       }
 
       if (isMultipleSelectProps(onChangeProps)) {
         setMultiValues(optionEvent as OptionStrict[]);
 
-        onChangeProps.onChange?.(optionEvent as OptionsType<OptionStrict>, {
-          action: onChangeAction,
-          option: undefined, // At the moment this isn't used, but when multi select is built for real, boom (https://codecademy.atlassian.net/browse/GM-354)
-        });
+        onChangeProps.onChange?.(
+          optionEvent as OptionsType<OptionStrict>,
+          forwardedMeta
+        );
       }
     },
-    [onChange, multiple]
+    [onChange, multiple, onCreateOption]
   );
 
   const keyPressHandler = (e: KeyboardEvent<HTMLDivElement>) => {
@@ -256,27 +263,6 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
     }
   };
 
-  const handleInputChange = useCallback(
-    (newValue: string, actionMeta: InputActionMeta) => {
-      if (isCreatable) {
-        /* Keep typed text instead of letting react-select clear it on blur /
-           menu-close. Since the value didn't actually change, we also skip
-           forwarding these to the consumer so derived state (e.g. validation
-           errors) isn't reset against an empty value. 'set-value' (after
-           selecting/creating) still clears and forwards as normal. */
-        if (
-          actionMeta.action === 'input-blur' ||
-          actionMeta.action === 'menu-close'
-        ) {
-          return;
-        }
-        setInputValue(newValue);
-      }
-      onInputChange?.(newValue, actionMeta);
-    },
-    [isCreatable, onInputChange]
-  );
-
   const noOptionsMessage =
     validationMessage === undefined
       ? undefined // fall back to react-select default ("No options")
@@ -313,7 +299,6 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         id={id || rest.htmlFor || rawInputId}
         inputId={inputId}
         inputProps={{ ...inputProps }}
-        inputValue={isCreatable ? inputValue : undefined}
         inputWidth={inputWidth}
         isCreatable={isCreatable}
         isDisabled={disabled}
@@ -332,8 +317,7 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
         styles={memoizedStyles}
         value={multiple ? multiValues : parsedValue}
         onChange={changeHandler}
-        onCreateOption={onCreateOption}
-        onInputChange={handleInputChange}
+        onInputChange={onInputChange}
         onKeyDown={multiple ? (e) => keyPressHandler(e) : undefined}
         {...rest}
       />
diff --git a/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx b/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
index 7c338eca12a..cc3f12cdc64 100644
--- a/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/elements/containers.tsx
@@ -122,8 +122,10 @@ export const CustomInput = ({
 /**
  * Typed wrapper around react-select component.
  * Renders CreatableSelect when isCreatable is true, ReactSelect otherwise.
- * Creatable-only props (formatCreateLabel, onCreateOption, isValidNewOption)
- * are stripped from the non-creatable path so they don't reach ReactSelect.
+ * Creatable-only props (formatCreateLabel, isValidNewOption) are stripped from
+ * the non-creatable path so they don't reach ReactSelect. `onCreateOption` is
+ * handled in SelectDropdown's changeHandler — do not pass it to CreatableSelect
+ * or react-select will skip onChange on create.
  */
 export function TypedReactSelect<
   OptionType,
@@ -134,7 +136,6 @@ export function TypedReactSelect<
   isCreatable,
   formatCreateLabel,
   isValidNewOption,
-  onCreateOption,
   ...props
 }: Props<OptionType, IsMulti, GroupType> & TypedReactSelectProps) {
   if (isCreatable) {
@@ -143,7 +144,6 @@ export function TypedReactSelect<
         {...(props as any)}
         formatCreateLabel={formatCreateLabel}
         isValidNewOption={isValidNewOption}
-        onCreateOption={onCreateOption}
         ref={selectRef}
       />
     );
diff --git a/packages/gamut/src/Form/SelectDropdown/types/component-props.ts b/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
index 13e04c25b26..37fd704ab52 100644
--- a/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
+++ b/packages/gamut/src/Form/SelectDropdown/types/component-props.ts
@@ -82,7 +82,8 @@ export interface SelectDropdownCoreProps
   isCreatable?: boolean;
   /**
    * Called when the user confirms a new option via the "Add" row.
-   * The consumer is responsible for appending the new option to the options array.
+   * Convenience callback for persisting the new value to your `options` list.
+   * Selection updates are delivered through `onChange` with `action: 'create-option'`.
    */
   onCreateOption?: (inputValue: string) => void;
   /**
@@ -175,11 +176,9 @@ export interface TypedReactSelectProps extends ReactSelectAdditionalProps {
   selectRef?: Ref<any>;
   /** When true, renders CreatableSelect instead of ReactSelect */
   isCreatable?: boolean;
-  /** Forwarded to CreatableSelect; customises the "Add" row label */
+  /** Customises the "Add" row label */
   formatCreateLabel?: (inputValue: string) => React.ReactNode;
-  /** Forwarded to CreatableSelect; called on new option confirmation */
-  onCreateOption?: (inputValue: string) => void;
-  /** Forwarded to CreatableSelect; controls visibility of the "Add" row */
+  /** Controls visibility of the "Add" row */
   isValidNewOption?: (
     inputValue: string,
     value: OptionsType<OptionStrict>,
diff --git a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
index 38651c2b773..0735805854f 100644
--- a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
+++ b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
@@ -1,7 +1,7 @@
 import { setupRtl } from '@codecademy/gamut-tests';
 import { fireEvent } from '@testing-library/dom';
 import userEvent from '@testing-library/user-event';
-import { act } from 'react';
+import { act, useState } from 'react';
 
 import {
   openDropdown,
@@ -12,6 +12,59 @@ import {
 } from '../__fixtures__/utils';
 import { SelectDropdown } from '../SelectDropdown';
 
+const CreatableMultiHarness = () => {
+  const [options, setOptions] = useState(['Apple', 'Banana']);
+
+  return (
+    <SelectDropdown
+      isCreatable
+      multiple
+      name="creatable-multi"
+      options={options}
+      onCreateOption={(inputValue) =>
+        setOptions((prev) => [...prev, inputValue])
+      }
+    />
+  );
+};
+
+const ControlledCreatableMultiHarness = ({
+  onChange,
+  onCreateOption,
+}: {
+  onChange?: jest.Mock;
+  onCreateOption?: jest.Mock;
+}) => {
+  const [options, setOptions] = useState(['Apple', 'Banana']);
+  const [value, setValue] = useState<string[]>(['Apple']);
+
+  return (
+    <SelectDropdown
+      isCreatable
+      multiple
+      name="controlled-creatable-multi"
+      options={options}
+      value={value}
+      onChange={(selected, meta) => {
+        setValue(selected.map((option) => option.value));
+
+        if (meta.action === 'create-option' && meta.option) {
+          setOptions((prev) => [...prev, meta.option.value]);
+        }
+
+        onChange?.(selected, meta);
+      }}
+      onCreateOption={onCreateOption}
+    />
+  );
+};
+
+const renderCreatableMulti = setupRtl(CreatableMultiHarness, {});
+const renderControlledCreatableMulti = setupRtl(
+  ControlledCreatableMultiHarness,
+  {}
+);
+
 /** There is a state pollution issue with SelectDropdown and jest which is why these are broken up into their own file.
  *  Ticket to fix: https://skillsoftdev.atlassian.net/browse/GM-1297
  */
@@ -464,6 +517,41 @@ describe('SelectDropdown', () => {
       expect(onCreateOption).toHaveBeenCalledWith('purple');
     });
 
+    it('fires onChange with create-option when the "Add" row is selected in multi mode', async () => {
+      const onChange = jest.fn();
+      const { view } = renderView({
+        isCreatable: true,
+        multiple: true,
+        onChange,
+      });
+
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('red'));
+      });
+
+      const combobox = view.getByRole('combobox');
+
+      await act(async () => {
+        await userEvent.type(combobox, 'purple');
+      });
+
+      await act(async () => {
+        await userEvent.click(view.getByText('Add "purple"'));
+      });
+
+      expect(onChange).toHaveBeenLastCalledWith(
+        [
+          { label: 'red', value: 'red' },
+          { label: 'purple', value: 'purple', __isNew__: true },
+        ],
+        expect.objectContaining({
+          action: 'create-option',
+          option: expect.objectContaining({ value: 'purple' }),
+        })
+      );
+    });
+
     it('respects a custom formatCreateLabel', async () => {
       const { view } = renderView({
         isCreatable: true,
@@ -490,7 +578,7 @@ describe('SelectDropdown', () => {
       expect(view.queryByText('Add "anything"')).not.toBeInTheDocument();
     });
 
-    it('keeps the typed text after the input blurs', async () => {
+    it('clears the typed text when the input blurs', async () => {
       const { view } = renderView({ isCreatable: true });
 
       const combobox = view.getByRole('combobox');
@@ -503,10 +591,10 @@ describe('SelectDropdown', () => {
         fireEvent.blur(combobox);
       });
 
-      expect(combobox).toHaveValue('pur');
+      expect(combobox).toHaveValue('');
     });
 
-    it('does not forward onInputChange to the consumer when the input blurs', async () => {
+    it('forwards onInputChange to the consumer when the input blurs', async () => {
       const onInputChange = jest.fn();
       const { view } = renderView({ isCreatable: true, onInputChange });
 
@@ -522,8 +610,10 @@ describe('SelectDropdown', () => {
         fireEvent.blur(combobox);
       });
 
-      // Text persists, so consumers should not be told the value went empty.
-      expect(onInputChange).not.toHaveBeenCalled();
+      expect(onInputChange).toHaveBeenCalledWith('', {
+        action: 'input-blur',
+        prevInputValue: 'pur',
+      });
     });
 
     it('clears the typed text after an option is created', async () => {
@@ -542,6 +632,67 @@ describe('SelectDropdown', () => {
       expect(combobox).toHaveValue('');
     });
 
+    it('keeps existing multi selections when a new option is created', async () => {
+      const { view } = renderCreatableMulti();
+
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('Apple'));
+      });
+
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('Banana'));
+      });
+
+      const combobox = view.getByRole('combobox');
+
+      await act(async () => {
+        await userEvent.type(combobox, 'Cherry');
+      });
+
+      await act(async () => {
+        await userEvent.click(view.getByText('Add "Cherry"'));
+      });
+
+      expect(view.getByText('Apple')).toBeInTheDocument();
+      expect(view.getByText('Banana')).toBeInTheDocument();
+      expect(view.getByText('Cherry')).toBeInTheDocument();
+    });
+
+    it('keeps controlled multi selections when a new option is created', async () => {
+      const onChange = jest.fn();
+      const { view } = renderControlledCreatableMulti({ onChange });
+
+      await openDropdown(view);
+      await act(async () => {
+        await userEvent.click(view.getByText('Banana'));
+      });
+
+      const combobox = view.getByRole('combobox');
+
+      await act(async () => {
+        await userEvent.type(combobox, 'Cherry');
+      });
+
+      await act(async () => {
+        await userEvent.click(view.getByText('Add "Cherry"'));
+      });
+
+      expect(view.getByText('Apple')).toBeInTheDocument();
+      expect(view.getByText('Banana')).toBeInTheDocument();
+      expect(view.getByText('Cherry')).toBeInTheDocument();
+
+      expect(onChange).toHaveBeenLastCalledWith(
+        expect.arrayContaining([
+          expect.objectContaining({ value: 'Apple' }),
+          expect.objectContaining({ value: 'Banana' }),
+          expect.objectContaining({ value: 'Cherry' }),
+        ]),
+        expect.objectContaining({ action: 'create-option' })
+      );
+    });
+
     describe('validationMessage', () => {
       it('supports a function that receives the current input value', async () => {
         const { view } = renderView({
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
index 171301c537f..ed33506a98e 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.mdx
@@ -2,6 +2,7 @@ import { Canvas, Controls, Meta } from '@storybook/addon-docs/blocks';
 
 import { Callout, ComponentHeader, LinkTo } from '~styleguide/blocks';
 
+import { ControlledModeTable } from './controlledModeTable';
 import { CreatablePropsTable } from './creatablePropsTable';
 import * as SelectDropdownStories from './SelectDropdown.stories';
 
@@ -16,7 +17,7 @@ export const parameters = {
   source: {
     repo: 'gamut',
     githubLink:
-      'https://github.com/Codecademy/gamut/blob/main/packages/gamut/src/Form/inputs/SelectDropdown.tsx',
+      'https://github.com/Codecademy/gamut/blob/main/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx',
   },
 };
 
@@ -31,44 +32,7 @@ Use SelectDropdown to pick from exclusive options within a styled dropdown.
 
 If you are using this in a standard form, `SelectDropdown` must be provided an `aria-label` and a `name`. The `aria-label` must match the `htmlFor` of the FormGroupLabel or `<label>` of the SelectDropdown.
 
-## Events and controlled components
-
-Instead of a standard HTML Select event return, SelectDropdown returns the selected option. This is formatted as `{label: 'labelText', value: 'valueText' }`. Your event functions should be formatted as `(event) => changeHandler(event.value)` instead of `(event) => changeHandler(event.target.value)`.
-
-SelectDropdown does not take a defaultValue prop. If you wish to define a default value, you must format `SelectDropdown` as a [controlled component](https://reactjs.org/docs/forms.html#controlled-components), like so:
-
-```tsx
-import { Box, SelectDropdown } from '@codecademy/gamut';
-import React, { useState } from 'react';
-
-export const CustomDropdown: React.FC = ({
-  errorMessage,
-  disabled,
-  defaultValue,
-  options,
-}) => {
-  const [currentValue, setCurrentValue] = useState(defaultValue);
-
-  const changeHandler = (newValue) => {
-    setCurrentValue(newValue);
-  };
-
-  return (
-    <FormGroup error={errorMessage} disabled={disabled}>
-      <SelectDropdown
-        options={options}
-        onChange={(e) => changeHandler(e.value)}
-        placeholder="Placeholder"
-        error={!!errorMessage}
-        disabled={disabled}
-        value={currentValue}
-      />
-    </FormGroup>
-  );
-};
-```
-
-## SelectDropdown states
+## States
 
 ### Base
 
@@ -130,22 +94,18 @@ To add some pizzazz to your dropdown, you can add any of our <LinkTo id='Atoms/I
 
 <Canvas of={SelectDropdownStories.Icons} />
 
-## Accessibility
+## Multiple selection
 
-### FormGroup + SelectDropdown
+Set `multiple` to let users choose more than one option. Selected options render as removable tags in the input, and `onChange` receives the full array of selected options (each as `{ label, value }`) rather than a single value. See [Controlled vs. Uncontrolled](#controlled-vs-uncontrolled) for when to pass `value` as a `string[]`.
+
+## FormGroup integration
 
 `SelectDropdown` formats nicely in FormGroups and reflects error states. Make sure you provide an htmlFor to the `FormGroup` and a `name` to the `SelectDropdown` for maximum accessibility. See <LinkTo id="Atoms/FormElements/FormGroup">FormGroup</LinkTo> story for the customizations available.
 
 <Canvas of={SelectDropdownStories.FormGroupSelectDropdown} />
 <Canvas of={SelectDropdownStories.FormGroupError} />
 
-## Multiple select
-
-Set `multiple` to let users choose more than one option. Selected options render as removable tags in the input, and `onChange` receives the full array of selected options (each as `{ label, value }`) rather than a single value. Manage that array as a [controlled component](https://reactjs.org/docs/forms.html#controlled-components).
-
-<Canvas of={SelectDropdownStories.MultipleSelect} />
-
-### Custom input props
+## Custom input props
 
 Some of our forms require special props be passed directly onto the input components. We can do that by passing an object with `hidden` and `combobox` properties into our inputProps prop.
 
@@ -159,11 +119,11 @@ Some of our forms require special props be passed directly onto the input compon
 
 <Canvas of={SelectDropdownStories.CustomInputProps} />
 
-### Abbreviated options
+## Abbreviated options
 
 For space-constrained layouts or when you need to display long option names in a compact way, you can use the abbreviated feature. This allows you to show a short abbreviation in the input field while displaying the full label in the dropdown.
 
-#### How it works
+### How it works
 
 - **Input Display**: Shows the abbreviated text (e.g., "USA")
 - **Dropdown Display**: Shows the full label (e.g., "United States of America")
@@ -171,41 +131,41 @@ For space-constrained layouts or when you need to display long option names in a
 
 <Canvas of={SelectDropdownStories.AbbreviatedInput} />
 
-#### Small size with abbreviations
+### Small size with abbreviations
 
 The abbreviated feature works particularly well with the small size variant, providing space-efficient layouts for compact interfaces.
 
 <Canvas of={SelectDropdownStories.AbbreviatedSmallSize} />
 
-#### Advanced options
+### Advanced options
 
 You can combine abbreviations with other option features like subtitles, right labels, and icons for rich, informative dropdowns.
 
 <Canvas of={SelectDropdownStories.AbbreviatedWithSubtitleAndRightLabel} />
 <Canvas of={SelectDropdownStories.ComplexAbbreviatedOptions} />
 
-### Independent width control
+## Independent width control
 
 You can control the width of the input field and dropdown independently using the `inputWidth` and `dropdownWidth` props. This is particularly useful when you need a compact input but want to show more detailed information in the dropdown.
 
-#### How it works
+### How it works
 
 - **`inputWidth`**: Controls the width of the input field (can be a string like "150px" or a number)
 - **`dropdownWidth`**: Controls the width of the dropdown menu (can be a string like "350px" or a number)
 
 <Canvas of={SelectDropdownStories.IndependentWidths} />
 
-#### Small size with independent widths
+### Small size with independent widths
 
 The independent width feature works particularly well with the small size variant, allowing for very compact inputs while maintaining readable dropdown content.
 
 <Canvas of={SelectDropdownStories.SmallWithAbbreviations} />
 
-### Menu alignment
+## Menu alignment
 
 When using different widths for the input and dropdown, you can control how the dropdown aligns relative to the input using the `menuAlignment` prop.
 
-#### How it works
+### How it works
 
 - **`menuAlignment`**: Controls the horizontal alignment of the dropdown menu relative to the input
   - **`'left'`** (default): Aligns the dropdown to the left edge of the input
@@ -214,7 +174,7 @@ When using different widths for the input and dropdown, you can control how the
 
 <Canvas of={SelectDropdownStories.MenuAlignmentRight} />
 
-### Selectdropdown options menu z-index
+## Dropdown z-index
 
 You can control the z-index of the dropdown menu using the `zIndex` prop. This is useful when you have other elements on the page that might overlap with the dropdown.
 
@@ -226,10 +186,7 @@ In the example below, the z-index menu is configured to the default value (`auto
 
 Set `isCreatable` to let users add options that aren't already in the list. When the typed value doesn't match an existing option, an **Add "value"** row appears at the bottom of the menu; selecting it fires `onCreateOption` with the typed string. The consumer owns persistence — append the new value to your `options` array (and, for multi-select, it is added to the current selection).
 
-Two behaviors come along automatically in creatable mode:
-
-- **Searchable by default** — `isSearchable` is forced to `true`, since creation needs a text input. Passing `isSearchable={false}` alongside `isCreatable` is a TypeScript error.
-- **Typed text persists on blur** — if the user clicks away or the menu closes mid-entry, their text is kept so they can pick up where they left off. It clears only once an option is selected or created.
+Creatable mode is **searchable by default** — `isSearchable` is forced to `true`, since creation needs a text input. Passing `isSearchable={false}` alongside `isCreatable` is a TypeScript error.
 
 ### Basic usage
 
@@ -237,9 +194,15 @@ A single-select creatable dropdown. Type a value that isn't listed, choose the *
 
 <Canvas of={SelectDropdownStories.Creatable} />
 
-### Multiple selection
+### Multiple selection (uncontrolled)
+
+Combine `isCreatable` with `multiple` and omit `value`. Use `onCreateOption` to persist new options; selection is managed internally. See [Controlled vs. Uncontrolled](#controlled-vs-uncontrolled) for the full pattern.
+
+<Canvas of={SelectDropdownStories.CreatableMultiUncontrolled} />
+
+### Multiple selection (controlled)
 
-Combine `isCreatable` with `multiple` to let users select several existing options and add their own. Each created value is appended to the options list and included in the current selection.
+Pass `value` as `string[]` and update it in `onChange` on every change, including `create-option`. See [Controlled vs. Uncontrolled](#controlled-vs-uncontrolled) for the full pattern.
 
 <Canvas of={SelectDropdownStories.CreatableMulti} />
 
@@ -247,12 +210,75 @@ Combine `isCreatable` with `multiple` to let users select several existing optio
 
 Gate which inputs can be added with `isValidNewOption` — return `false` to hide the **Add** row (e.g. minimum length, pattern matching, or de-duplication). Use `validationMessage` to replace the menu's default "No options" text with contextual feedback, and mirror the same message in a `FormGroup` `error` so it's also surfaced below the field.
 
+When persisting a `FormGroup` error after blur, handle `onInputChange` in the consumer — react-select clears the input on blur by default. Update validation on `input-change`, and on `input-blur` re-validate from the last typed value so the error isn't lost when the input clears.
+
 <Canvas of={SelectDropdownStories.CreatableWithValidation} />
 
 ### Props
 
 <CreatablePropsTable />
 
+## Controlled vs. Uncontrolled
+
+SelectDropdown does not accept a `defaultValue` prop. How you manage selection depends on single vs. multi mode:
+
+<ControlledModeTable />
+
+`onChange` receives the selected option as `{ label, value }` (or an array of those objects in multi mode), not `event.target.value`. The second argument is react-select action metadata — for creatable creates, `meta.action === 'create-option'`.
+
+### Single select (controlled)
+
+```tsx
+import { FormGroup, SelectDropdown } from '@codecademy/gamut';
+import { useState } from 'react';
+
+export const SingleSelectExample = ({ options, defaultValue }) => {
+  const [value, setValue] = useState(defaultValue);
+
+  return (
+    <FormGroup htmlFor="country" isSoloField label="Country">
+      <SelectDropdown
+        name="country"
+        options={options}
+        value={value}
+        onChange={(option) => setValue(option.value)}
+      />
+    </FormGroup>
+  );
+};
+```
+
+### Multi select (uncontrolled)
+
+Omit `value` and the component keeps selection in internal state. Pass `onChange` only if you need to react to changes.
+
+```tsx
+<SelectDropdown
+  multiple
+  name="tags"
+  options={['Apple', 'Banana', 'Cherry']}
+  onChange={(selected) => console.log(selected.map((o) => o.value))}
+/>
+```
+
+<Canvas of={SelectDropdownStories.MultipleSelect} />
+
+### Multi select (controlled)
+
+```tsx
+const [value, setValue] = useState<string[]>(['Apple']);
+
+<SelectDropdown
+  multiple
+  name="tags"
+  options={options}
+  value={value}
+  onChange={(selected) => setValue(selected.map((option) => option.value))}
+/>;
+```
+
+Creatable modes follow the same single/multi rules above — see the [Creatable](#creatable) section for runnable examples.
+
 ## Playground
 
 <Canvas sourceState="shown" of={SelectDropdownStories.Default} />
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
index 97a3f5d9b18..c5efe567093 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
@@ -8,7 +8,8 @@ import {
 } from '@codecademy/gamut';
 import { RadarIcon, ResponsiveIcon, RocketIcon } from '@codecademy/gamut-icons';
 import type { Meta, StoryObj } from '@storybook/react';
-import { useState } from 'react';
+import { useRef, useState } from 'react';
+import type { InputActionMeta } from 'react-select';
 
 const fruitOptions = ['Apple', 'Banana', 'Cherry', 'Dragonfruit', 'Eggplant'];
 
@@ -469,6 +470,46 @@ export const MultipleSelect: Story = {
   ),
 };
 
+export const FormGroupSelectDropdown: Story = {
+  args: {
+    options: ['hello', 'hi', 'howdy'],
+    value: 'oh no',
+    name: 'big-label',
+  },
+  render: (args) => (
+    <Box height="15rem">
+      <FormGroup
+        htmlFor="big-label"
+        isSoloField
+        label="i am big label"
+        labelSize="large"
+      >
+        <SelectDropdown {...args} />
+      </FormGroup>
+    </Box>
+  ),
+};
+
+export const FormGroupError: Story = {
+  args: {
+    options: ['Error', 'oh no', ':('],
+    name: 'error-example-unique',
+    placeholder: 'cry cry cry',
+  },
+  render: (args) => (
+    <Box height="15rem">
+      <FormGroup
+        error="error message!! no :'("
+        htmlFor="error-example-unique"
+        isSoloField
+        label="i am ~styled... but something is wrong"
+      >
+        <SelectDropdown error {...args} />
+      </FormGroup>
+    </Box>
+  ),
+};
+
 export const CustomInputProps: Story = {
   args: {
     options: ['inspect me to see my inputProps', 'yes I am!', ':)'],
@@ -916,20 +957,28 @@ export const Creatable: Story = {
   },
 };
 
-export const CreatableMulti: Story = {
+export const CreatableMultiUncontrolled: Story = {
+  parameters: {
+    docs: {
+      description: {
+        story: `Uncontrolled creatable multi-select. Omit \`value\` and use \`onCreateOption\` to append new options to your list. Selection is managed internally — existing tags stay selected when a new option is created.`,
+      },
+    },
+  },
   render: () => {
     const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+
     return (
       <Box height="18rem">
         <FormGroup
-          htmlFor="creatable-multi-dropdown"
+          htmlFor="creatable-multi-uncontrolled"
           isSoloField
           label="Pick fruits or add your own"
         >
           <SelectDropdown
             isCreatable
             multiple
-            name="creatable-multi-dropdown"
+            name="creatable-multi-uncontrolled"
             options={options}
             placeholder="Select or type to add…"
             onCreateOption={(inputValue) =>
@@ -942,10 +991,53 @@ export const CreatableMulti: Story = {
   },
 };
 
+export const CreatableMulti: Story = {
+  parameters: {
+    docs: {
+      description: {
+        story: `Controlled creatable multi-select. When \`value\` is a \`string[]\`, update it in \`onChange\` on every selection change — including \`create-option\`. Append new values to \`options\` when \`meta.action === 'create-option'\`, or use \`onCreateOption\` as a convenience hook for option persistence.
+
+\`onChange\` receives \`action: 'create-option'\` when the user picks the **Add** row; the first argument is the full selected array (existing tags plus the new value). Updating only \`options\` in \`onCreateOption\` without syncing \`value\` in \`onChange\` will clear the selection when \`options\` re-render.`,
+      },
+    },
+  },
+  render: () => {
+    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+    const [value, setValue] = useState<string[]>([]);
+
+    return (
+      <Box height="18rem">
+        <FormGroup
+          htmlFor="creatable-multi-dropdown"
+          isSoloField
+          label="Pick fruits or add your own"
+        >
+          <SelectDropdown
+            isCreatable
+            multiple
+            name="creatable-multi-dropdown"
+            options={options}
+            placeholder="Select or type to add…"
+            value={value}
+            onChange={(selected, meta) => {
+              setValue(selected.map((option) => option.value));
+
+              if (meta.action === 'create-option' && meta.option) {
+                setOptions((prev) => [...prev, meta.option.value]);
+              }
+            }}
+          />
+        </FormGroup>
+      </Box>
+    );
+  },
+};
+
 export const CreatableWithValidation: Story = {
   render: () => {
     const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
     const [error, setError] = useState<string | undefined>();
+    const lastInputRef = useRef('');
 
     const validate = (inputValue: string) => {
       const trimmed = inputValue.trim();
@@ -953,6 +1045,23 @@ export const CreatableWithValidation: Story = {
       return undefined;
     };
 
+    const handleInputChange = (
+      inputValue: string,
+      { action }: InputActionMeta
+    ) => {
+      if (action === 'input-change') {
+        lastInputRef.current = inputValue;
+        setError(validate(inputValue));
+        return;
+      }
+
+      if (action === 'input-blur' && lastInputRef.current) {
+        // react-select clears the input on blur (default behavior). Re-apply
+        // validation from what the user typed so the FormGroup error persists.
+        setError(validate(lastInputRef.current));
+      }
+    };
+
     return (
       <Box height="15rem">
         <FormGroup
@@ -973,13 +1082,16 @@ export const CreatableWithValidation: Story = {
             validationMessage={({ inputValue }) =>
               validate(inputValue) ?? 'No matching fruit'
             }
+            onChange={() => {
+              lastInputRef.current = '';
+              setError(undefined);
+            }}
             onCreateOption={(inputValue) => {
               setOptions((prev) => [...prev, inputValue.trim()]);
+              lastInputRef.current = '';
               setError(undefined);
             }}
-            onInputChange={(inputValue: string) =>
-              setError(validate(inputValue))
-            }
+            onInputChange={handleInputChange}
           />
         </FormGroup>
       </Box>
@@ -987,46 +1099,6 @@ export const CreatableWithValidation: Story = {
   },
 };
 
-export const FormGroupSelectDropdown: Story = {
-  args: {
-    options: ['hello', 'hi', 'howdy'],
-    value: 'oh no',
-    name: 'big-label',
-  },
-  render: (args) => (
-    <Box height="15rem">
-      <FormGroup
-        htmlFor="big-label"
-        isSoloField
-        label="i am big label"
-        labelSize="large"
-      >
-        <SelectDropdown {...args} />
-      </FormGroup>
-    </Box>
-  ),
-};
-
-export const FormGroupError: Story = {
-  args: {
-    options: ['Error', 'oh no', ':('],
-    name: 'error-example-unique',
-    placeholder: 'cry cry cry',
-  },
-  render: (args) => (
-    <Box height="15rem">
-      <FormGroup
-        error="error message!! no :'("
-        htmlFor="error-example-unique"
-        isSoloField
-        label="i am ~styled... but something is wrong"
-      >
-        <SelectDropdown error {...args} />
-      </FormGroup>
-    </Box>
-  ),
-};
-
 export const Default: Story = {
   args: {},
   render: (args) => (
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx
new file mode 100644
index 00000000000..0e5f31ff987
--- /dev/null
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx
@@ -0,0 +1,92 @@
+import { Code, TokenTable } from '~styleguide/blocks';
+
+const controlledModeColumns = [
+  {
+    key: 'mode',
+    name: 'Mode',
+    size: 'md' as const,
+    render: ({ mode }: { mode: string }) => <Code>{mode}</Code>,
+  },
+  {
+    key: 'uncontrolled',
+    name: 'Uncontrolled',
+    size: 'lg' as const,
+    render: ({ uncontrolled }: { uncontrolled: React.ReactNode }) =>
+      uncontrolled,
+  },
+  {
+    key: 'controlled',
+    name: 'Controlled',
+    size: 'fill' as const,
+    render: ({ controlled }: { controlled: React.ReactNode }) => controlled,
+  },
+];
+
+const notSupported = <em>Not supported</em>;
+
+const controlledModes = [
+  {
+    id: 'single',
+    mode: 'Single',
+    uncontrolled: notSupported,
+    controlled: (
+      <>
+        Pass <Code>value</Code> (option value string) and update it in{' '}
+        <Code>onChange</Code>.
+      </>
+    ),
+  },
+  {
+    id: 'multi',
+    mode: 'Multi',
+    uncontrolled: (
+      <>
+        Omit <Code>value</Code>, or pass a non-array (<Code>undefined</Code>,{' '}
+        <Code>''</Code>).
+      </>
+    ),
+    controlled: (
+      <>
+        Pass <Code>value</Code> as <Code>string[]</Code> and update it in{' '}
+        <Code>onChange</Code>.
+      </>
+    ),
+  },
+  {
+    id: 'creatable-single',
+    mode: 'Creatable single',
+    uncontrolled: notSupported,
+    controlled: (
+      <>
+        Same as single; use <Code>onCreateOption</Code> to append to{' '}
+        <Code>options</Code>.
+      </>
+    ),
+  },
+  {
+    id: 'creatable-multi',
+    mode: 'Creatable multi',
+    uncontrolled: (
+      <>
+        Omit <Code>value</Code>; use <Code>onCreateOption</Code> for option
+        persistence.
+      </>
+    ),
+    controlled: (
+      <>
+        Pass <Code>value</Code> as <Code>string[]</Code>; update it in{' '}
+        <Code>onChange</Code> on every change, including{' '}
+        <Code>meta.action === 'create-option'</Code>.
+      </>
+    ),
+  },
+];
+
+export const ControlledModeTable = () => (
+  <TokenTable
+    bg={false}
+    columns={controlledModeColumns}
+    idKey="id"
+    rows={controlledModes}
+  />
+);
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
index fcaa243dffd..9ae457026f0 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
@@ -48,8 +48,9 @@ const creatableProps = [
     defaultValue: null,
     description: (
       <>
-        Called when the user confirms a new option. Append the value to{' '}
-        <Code>options</Code> to persist it.
+        Called when the user confirms a new option. Convenience hook for
+        appending to <Code>options</Code>; selection updates arrive via{' '}
+        <Code>onChange</Code> with <Code>action: 'create-option'</Code>.
       </>
     ),
   },

From 878a06fe625339b8de2cfdcf875f5bc62812721f Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Fri, 12 Jun 2026 16:23:40 -0400
Subject: [PATCH 33/37] tweak props + co-pilot

---
 .../version-plan-1781295720164.md             |   5 +
 .../Form/SelectDropdown/SelectDropdown.tsx    |  11 +-
 .../SelectDropdown/__tests__/utils.test.tsx   |  59 ++++
 .../gamut/src/Form/SelectDropdown/styles.ts   |   4 +-
 .../gamut/src/Form/SelectDropdown/utils.tsx   |  29 ++
 .../SelectDropdown/SelectDropdown.stories.tsx | 285 +++++++++---------
 .../SelectDropdown/controlledModeTable.tsx    |   4 +-
 .../SelectDropdown/creatablePropsTable.tsx    |   3 +-
 8 files changed, 257 insertions(+), 143 deletions(-)
 create mode 100644 .nx/version-plans/version-plan-1781295720164.md

diff --git a/.nx/version-plans/version-plan-1781295720164.md b/.nx/version-plans/version-plan-1781295720164.md
new file mode 100644
index 00000000000..04a1e56bb9c
--- /dev/null
+++ b/.nx/version-plans/version-plan-1781295720164.md
@@ -0,0 +1,5 @@
+---
+gamut: minor
+---
+
+feat(SelectDropdown): add isCreateable prop + remove SearchIcon
diff --git a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
index f164ef0f068..3a5ba7ee5db 100644
--- a/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/SelectDropdown.tsx
@@ -36,6 +36,7 @@ import {
 } from './types';
 import {
   filterValueFromOptions,
+  getCreatedOptionValue,
   isMultipleSelectProps,
   isOptionsGrouped,
   isSingleSelectProps,
@@ -212,7 +213,15 @@ export const SelectDropdown: React.FC<SelectDropdownProps> = ({
       setActivated(true);
 
       if (actionMeta.action === 'create-option') {
-        onCreateOption?.(actionMeta.option?.value ?? '');
+        const createdValue = getCreatedOptionValue(
+          optionEvent,
+          actionMeta,
+          multiple
+        );
+
+        if (createdValue) {
+          onCreateOption?.(createdValue);
+        }
       }
 
       const onChangeProps = { onChange, multiple };
diff --git a/packages/gamut/src/Form/SelectDropdown/__tests__/utils.test.tsx b/packages/gamut/src/Form/SelectDropdown/__tests__/utils.test.tsx
index 6e3ce321144..a1a244babde 100644
--- a/packages/gamut/src/Form/SelectDropdown/__tests__/utils.test.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/__tests__/utils.test.tsx
@@ -2,12 +2,71 @@ import { SelectOptionBase } from '../../utils';
 import { ExtendedOption, SelectDropdownGroup } from '../types';
 import {
   filterValueFromOptions,
+  getCreatedOptionValue,
   isOptionGroup,
   isOptionsGrouped,
   removeValueFromSelectedOptions,
 } from '../utils';
 
 describe('SelectDropdown Utils', () => {
+  describe('getCreatedOptionValue', () => {
+    it('returns actionMeta.option.value when present', () => {
+      expect(
+        getCreatedOptionValue(
+          { label: 'Purple', value: 'purple' },
+          {
+            action: 'create-option',
+            option: { label: 'Purple', value: 'purple' },
+          },
+          false
+        )
+      ).toBe('purple');
+    });
+
+    it('falls back to single-select optionEvent value when actionMeta.option is missing', () => {
+      expect(
+        getCreatedOptionValue(
+          { label: 'Purple', value: 'purple' },
+          { action: 'create-option' },
+          false
+        )
+      ).toBe('purple');
+    });
+
+    it('falls back to multi-select __isNew__ option when actionMeta.option is missing', () => {
+      expect(
+        getCreatedOptionValue(
+          [
+            { label: 'Red', value: 'red' },
+            { label: 'Purple', value: 'purple', __isNew__: true },
+          ],
+          { action: 'create-option' },
+          true
+        )
+      ).toBe('purple');
+    });
+
+    it('returns undefined when no created value can be resolved', () => {
+      expect(
+        getCreatedOptionValue(
+          [{ label: 'Red', value: 'red' }],
+          { action: 'create-option' },
+          true
+        )
+      ).toBeUndefined();
+    });
+
+    it('returns undefined for an empty actionMeta.option.value', () => {
+      expect(
+        getCreatedOptionValue(
+          { label: '', value: '' },
+          { action: 'create-option', option: { label: '', value: '' } },
+          false
+        )
+      ).toBeUndefined();
+    });
+  });
+
   describe('isOptionGroup', () => {
     it('returns true for valid group objects', () => {
       const groupOption: SelectDropdownGroup = {
diff --git a/packages/gamut/src/Form/SelectDropdown/styles.ts b/packages/gamut/src/Form/SelectDropdown/styles.ts
index 64b6ef48adb..a7fc50142fa 100644
--- a/packages/gamut/src/Form/SelectDropdown/styles.ts
+++ b/packages/gamut/src/Form/SelectDropdown/styles.ts
@@ -228,8 +228,8 @@ export const getMemoizedStyles = (
             ? theme.colors['text-disabled']
             : theme.colors.primary
           : state.isDisabled
-          ? 'text-disabled'
-          : 'default',
+          ? theme.colors['text-disabled']
+          : theme.colors.text,
         cursor: state.isDisabled ? 'not-allowed' : 'pointer',
         display: 'flex',
         padding: isSmall ? '3px 14px' : '11px 14px',
diff --git a/packages/gamut/src/Form/SelectDropdown/utils.tsx b/packages/gamut/src/Form/SelectDropdown/utils.tsx
index bcf0fd7ac87..2607e32f49b 100644
--- a/packages/gamut/src/Form/SelectDropdown/utils.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/utils.tsx
@@ -1,8 +1,11 @@
+import { ActionMeta, Options as OptionsType } from 'react-select';
+
 import { SelectOptionBase } from '../utils';
 import {
   BaseOnChangeProps,
   ExtendedOption,
   MultiSelectDropdownProps,
+  OptionStrict,
   SelectDropdownGroup,
   SelectDropdownOptions,
   SelectDropdownProps,
@@ -17,6 +20,32 @@ export const isSingleSelectProps = (
   props: BaseOnChangeProps
 ): props is SingleSelectDropdownProps => !props.multiple;
 
+type CreatableOption = OptionStrict & { __isNew__?: boolean };
+
+/**
+ * Resolves the value for a newly created option from react-select action metadata
+ * or the onChange option payload. Returns undefined when no reliable value exists.
+ */
+export const getCreatedOptionValue = (
+  optionEvent: OptionStrict | OptionsType<OptionStrict>,
+  actionMeta: ActionMeta<OptionStrict>,
+  multiple?: boolean
+): string | undefined => {
+  const metaValue = actionMeta.option?.value;
+  if (metaValue) return metaValue;
+
+  if (!multiple) {
+    const value = (optionEvent as OptionStrict).value;
+    return value || undefined;
+  }
+
+  const newOption = (optionEvent as OptionsType<OptionStrict>).find(
+    (option) => (option as CreatableOption).__isNew__
+  );
+
+  return newOption?.value || undefined;
+};
+
 export const isOptionGroup = (obj: unknown): obj is SelectDropdownGroup =>
   obj != null &&
   typeof obj === 'object' &&
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
index c5efe567093..bf8b5540f0e 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/SelectDropdown.stories.tsx
@@ -33,6 +33,150 @@ const meta: Meta<typeof SelectDropdown> = {
 export default meta;
 type Story = StoryObj<typeof SelectDropdown>;
 
+const CreatableStoryRender = (
+  args: React.ComponentProps<typeof SelectDropdown>
+) => {
+  const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+
+  return (
+    <Box height="15rem">
+      <FormGroup
+        htmlFor="creatable-dropdown"
+        isSoloField
+        label="Type a new fruit and press Enter"
+      >
+        <SelectDropdown
+          {...args}
+          options={options}
+          onCreateOption={(inputValue) =>
+            setOptions((prev) => [...prev, inputValue])
+          }
+        />
+      </FormGroup>
+    </Box>
+  );
+};
+
+const CreatableMultiUncontrolledStoryRender = () => {
+  const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+
+  return (
+    <Box height="18rem">
+      <FormGroup
+        htmlFor="creatable-multi-uncontrolled"
+        isSoloField
+        label="Pick fruits or add your own"
+      >
+        <SelectDropdown
+          isCreatable
+          multiple
+          name="creatable-multi-uncontrolled"
+          options={options}
+          placeholder="Select or type to add…"
+          onCreateOption={(inputValue) =>
+            setOptions((prev) => [...prev, inputValue])
+          }
+        />
+      </FormGroup>
+    </Box>
+  );
+};
+
+const CreatableMultiStoryRender = () => {
+  const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+  const [value, setValue] = useState<string[]>([]);
+
+  return (
+    <Box height="18rem">
+      <FormGroup
+        htmlFor="creatable-multi-dropdown"
+        isSoloField
+        label="Pick fruits or add your own"
+      >
+        <SelectDropdown
+          isCreatable
+          multiple
+          name="creatable-multi-dropdown"
+          options={options}
+          placeholder="Select or type to add…"
+          value={value}
+          onChange={(selected, meta) => {
+            setValue(selected.map((option) => option.value));
+
+            if (meta.action === 'create-option' && meta.option) {
+              setOptions((prev) => [...prev, meta.option.value]);
+            }
+          }}
+        />
+      </FormGroup>
+    </Box>
+  );
+};
+
+const CreatableWithValidationStoryRender = () => {
+  const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
+  const [error, setError] = useState<string | undefined>();
+  const lastInputRef = useRef('');
+
+  const validate = (inputValue: string) => {
+    const trimmed = inputValue.trim();
+    if (trimmed.length < 3) return 'Enter at least 3 characters.';
+    return undefined;
+  };
+
+  const handleInputChange = (
+    inputValue: string,
+    { action }: InputActionMeta
+  ) => {
+    if (action === 'input-change') {
+      lastInputRef.current = inputValue;
+      setError(validate(inputValue));
+      return;
+    }
+
+    if (action === 'input-blur' && lastInputRef.current) {
+      // react-select clears the input on blur (default behavior). Re-apply
+      // validation from what the user typed so the FormGroup error persists.
+      setError(validate(lastInputRef.current));
+    }
+  };
+
+  return (
+    <Box height="15rem">
+      <FormGroup
+        error={error}
+        htmlFor="creatable-validated-dropdown"
+        isSoloField
+        label="Pick a fruit that is at least 3 characters long"
+      >
+        <SelectDropdown
+          error={Boolean(error)}
+          isCreatable
+          isValidNewOption={(inputValue: string) =>
+            !validate(inputValue) && inputValue.trim().length > 0
+          }
+          name="creatable-validated-dropdown"
+          options={options}
+          placeholder="Type at least 3 characters to add…"
+          validationMessage={({ inputValue }) =>
+            validate(inputValue) ?? 'No matching fruit'
+          }
+          onChange={() => {
+            lastInputRef.current = '';
+            setError(undefined);
+          }}
+          onCreateOption={(inputValue) => {
+            setOptions((prev) => [...prev, inputValue.trim()]);
+            lastInputRef.current = '';
+            setError(undefined);
+          }}
+          onInputChange={handleInputChange}
+        />
+      </FormGroup>
+    </Box>
+  );
+};
+
 export const Base: Story = {
   args: {
     name: 'base-dropdown',
@@ -935,26 +1079,7 @@ export const Creatable: Story = {
     isCreatable: true,
     placeholder: 'Select or type to add…',
   },
-  render: (args) => {
-    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
-    return (
-      <Box height="15rem">
-        <FormGroup
-          htmlFor="creatable-dropdown"
-          isSoloField
-          label="Type a new fruit and press Enter"
-        >
-          <SelectDropdown
-            {...args}
-            options={options}
-            onCreateOption={(inputValue) =>
-              setOptions((prev) => [...prev, inputValue])
-            }
-          />
-        </FormGroup>
-      </Box>
-    );
-  },
+  render: (args) => <CreatableStoryRender {...args} />,
 };
 
 export const CreatableMultiUncontrolled: Story = {
@@ -965,30 +1090,7 @@ export const CreatableMultiUncontrolled: Story = {
       },
     },
   },
-  render: () => {
-    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
-
-    return (
-      <Box height="18rem">
-        <FormGroup
-          htmlFor="creatable-multi-uncontrolled"
-          isSoloField
-          label="Pick fruits or add your own"
-        >
-          <SelectDropdown
-            isCreatable
-            multiple
-            name="creatable-multi-uncontrolled"
-            options={options}
-            placeholder="Select or type to add…"
-            onCreateOption={(inputValue) =>
-              setOptions((prev) => [...prev, inputValue])
-            }
-          />
-        </FormGroup>
-      </Box>
-    );
-  },
+  render: () => <CreatableMultiUncontrolledStoryRender />,
 };
 
 export const CreatableMulti: Story = {
@@ -1001,102 +1103,11 @@ export const CreatableMulti: Story = {
       },
     },
   },
-  render: () => {
-    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
-    const [value, setValue] = useState<string[]>([]);
-
-    return (
-      <Box height="18rem">
-        <FormGroup
-          htmlFor="creatable-multi-dropdown"
-          isSoloField
-          label="Pick fruits or add your own"
-        >
-          <SelectDropdown
-            isCreatable
-            multiple
-            name="creatable-multi-dropdown"
-            options={options}
-            placeholder="Select or type to add…"
-            value={value}
-            onChange={(selected, meta) => {
-              setValue(selected.map((option) => option.value));
-
-              if (meta.action === 'create-option' && meta.option) {
-                setOptions((prev) => [...prev, meta.option.value]);
-              }
-            }}
-          />
-        </FormGroup>
-      </Box>
-    );
-  },
+  render: () => <CreatableMultiStoryRender />,
 };
 
 export const CreatableWithValidation: Story = {
-  render: () => {
-    const [options, setOptions] = useState(['Apple', 'Banana', 'Cherry']);
-    const [error, setError] = useState<string | undefined>();
-    const lastInputRef = useRef('');
-
-    const validate = (inputValue: string) => {
-      const trimmed = inputValue.trim();
-      if (trimmed.length < 3) return 'Enter at least 3 characters.';
-      return undefined;
-    };
-
-    const handleInputChange = (
-      inputValue: string,
-      { action }: InputActionMeta
-    ) => {
-      if (action === 'input-change') {
-        lastInputRef.current = inputValue;
-        setError(validate(inputValue));
-        return;
-      }
-
-      if (action === 'input-blur' && lastInputRef.current) {
-        // react-select clears the input on blur (default behavior). Re-apply
-        // validation from what the user typed so the FormGroup error persists.
-        setError(validate(lastInputRef.current));
-      }
-    };
-
-    return (
-      <Box height="15rem">
-        <FormGroup
-          error={error}
-          htmlFor="creatable-validated-dropdown"
-          isSoloField
-          label="Pick a fruit that is at least 3 characters long"
-        >
-          <SelectDropdown
-            error={Boolean(error)}
-            isCreatable
-            isValidNewOption={(inputValue: string) =>
-              !validate(inputValue) && inputValue.trim().length > 0
-            }
-            name="creatable-validated-dropdown"
-            options={options}
-            placeholder="Type at least 3 characters to add…"
-            validationMessage={({ inputValue }) =>
-              validate(inputValue) ?? 'No matching fruit'
-            }
-            onChange={() => {
-              lastInputRef.current = '';
-              setError(undefined);
-            }}
-            onCreateOption={(inputValue) => {
-              setOptions((prev) => [...prev, inputValue.trim()]);
-              lastInputRef.current = '';
-              setError(undefined);
-            }}
-            onInputChange={handleInputChange}
-          />
-        </FormGroup>
-      </Box>
-    );
-  },
+  render: () => <CreatableWithValidationStoryRender />,
 };
 
 export const Default: Story = {
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx
index 0e5f31ff987..1a62cf0db90 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/controlledModeTable.tsx
@@ -42,7 +42,7 @@ const controlledModes = [
     uncontrolled: (
       <>
         Omit <Code>value</Code>, or pass a non-array (<Code>undefined</Code>,{' '}
-        <Code>''</Code>).
+        <Code>{`''`}</Code>).
       </>
     ),
     controlled: (
@@ -76,7 +76,7 @@ const controlledModes = [
       <>
         Pass <Code>value</Code> as <Code>string[]</Code>; update it in{' '}
         <Code>onChange</Code> on every change, including{' '}
-        <Code>meta.action === 'create-option'</Code>.
+        <Code>meta.action === &apos;create-option&apos;</Code>.
       </>
     ),
   },
diff --git a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
index 9ae457026f0..1b7ae8e6b31 100644
--- a/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
+++ b/packages/styleguide/src/lib/Atoms/FormInputs/SelectDropdown/creatablePropsTable.tsx
@@ -50,7 +50,8 @@ const creatableProps = [
       <>
         Called when the user confirms a new option. Convenience hook for
         appending to <Code>options</Code>; selection updates arrive via{' '}
-        <Code>onChange</Code> with <Code>action: 'create-option'</Code>.
+        <Code>onChange</Code> with{' '}
+        <Code>action: &apos;create-option&apos;</Code>.
       </>
     ),
   },

From f2e6db11ca80cab0204bbf5c367277f5985075d0 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Tue, 16 Jun 2026 10:29:06 -0400
Subject: [PATCH 34/37] as

---
 packages/gamut/src/Form/SelectDropdown/utils.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/gamut/src/Form/SelectDropdown/utils.tsx b/packages/gamut/src/Form/SelectDropdown/utils.tsx
index 2607e32f49b..75a15438b5a 100644
--- a/packages/gamut/src/Form/SelectDropdown/utils.tsx
+++ b/packages/gamut/src/Form/SelectDropdown/utils.tsx
@@ -35,7 +35,7 @@ export const getCreatedOptionValue = (
   if (metaValue) return metaValue;
 
   if (!multiple) {
-    const value = (optionEvent as OptionStrict).value;
+    const { value } = optionEvent as OptionStrict;
     return value || undefined;
   }
 

From 706406121b0eb773a57347cd0096bcde5b497834 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Tue, 16 Jun 2026 10:43:39 -0400
Subject: [PATCH 35/37] tweak

---
 packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
index 0735805854f..90cd8bc274a 100644
--- a/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
+++ b/packages/gamut/src/Form/__tests__/SelectDropdown.test.tsx
@@ -588,7 +588,7 @@ describe('SelectDropdown', () => {
       });
 
       await act(async () => {
-        fireEvent.blur(combobox);
+        fireEvent.focusOut(combobox);
       });
 
       expect(combobox).toHaveValue('');
@@ -607,7 +607,7 @@ describe('SelectDropdown', () => {
       onInputChange.mockClear();
 
       await act(async () => {
-        fireEvent.blur(combobox);
+        fireEvent.focusOut(combobox);
       });
 
       expect(onInputChange).toHaveBeenCalledWith('', {

From a4b27b83041312ac6560a97f590981f9344dba47 Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Tue, 16 Jun 2026 11:01:15 -0400
Subject: [PATCH 36/37] SelectDropdown skill

---
 .../skills/gamut-select-dropdown/SKILL.md     | 40 ++++++++++++++++---
 1 file changed, 34 insertions(+), 6 deletions(-)

diff --git a/packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md b/packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md
index 00939e1e8bb..a44fcabafd3 100644
--- a/packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md
+++ b/packages/gamut/agent-tools/skills/gamut-select-dropdown/SKILL.md
@@ -21,6 +21,24 @@ Use `Select` for standard single-select forms with minimal bundle cost. Use `Sel
 
 ---
 
+## Options
+
+`options` accepts plain strings or option objects. `value` is always a string and references an option's `value`.
+
+| Field          | Required | Notes                                                                |
+| -------------- | -------- | -------------------------------------------------------------------- |
+| `label`        | yes      | Display text                                                         |
+| `value`        | yes      | Unique string; what `value` / `string[]` reference                   |
+| `disabled`     | no       | Option cannot be selected                                            |
+| `subtitle`     | no       | Secondary text below the label                                       |
+| `rightLabel`   | no       | Text on the right side of the option                                 |
+| `icon`         | no       | A `@codecademy/gamut-icons` component                                |
+| `abbreviation` | no       | Short text shown in the input while the full label shows in the menu |
+
+Grouped options: `{ label, options: [...], divider? }` (extends react-select `GroupBase`; `divider` draws a rule above the group).
+
+---
+
 ## Controlled vs uncontrolled
 
 SelectDropdown does **not** accept `defaultValue`.
@@ -70,6 +88,7 @@ Second argument is react-select `ActionMeta`. For creatable creates: `meta.actio
 
 - `FormGroup` `htmlFor` must match control `id` / `name`.
 - Pass `name` on SelectDropdown (required for forms).
+- Pass `aria-label` (required for forms); it must match the FormGroupLabel `htmlFor` / `name`.
 - Pass `error` boolean when FormGroup has an error.
 - Generic FormGroup live-region behavior: see [`gamut-forms`](../gamut-forms/SKILL.md).
 
@@ -77,6 +96,7 @@ Second argument is react-select `ActionMeta`. For creatable creates: `meta.actio
 <FormGroup htmlFor="country" isSoloField label="Country" error={errors.country}>
   <SelectDropdown
     name="country"
+    aria-label="country"
     options={options}
     value={value}
     error={Boolean(errors.country)}
@@ -87,6 +107,20 @@ Second argument is react-select `ActionMeta`. For creatable creates: `meta.actio
 
 ---
 
+## Styling & layout props
+
+| Prop                | Type                     | Default  | Notes                                                     |
+| ------------------- | ------------------------ | -------- | --------------------------------------------------------- |
+| `size`              | `'small' \| 'medium'`    | `medium` | Control height/density                                    |
+| `shownOptionsLimit` | `1`–`6`                  | `6`      | Visible options before the menu scrolls                   |
+| `inputWidth`        | `string \| number`       | —        | Width of the input independent of the menu                |
+| `dropdownWidth`     | `string \| number`       | —        | Width of the menu independent of the input                |
+| `menuAlignment`     | `'left' \| 'right'`      | `left`   | Menu edge alignment                                       |
+| `zIndex`            | `number`                 | auto     | Menu z-index                                              |
+| `inputProps`        | `{ hidden?, combobox? }` | —        | `data-*` / `aria-*` only, forwarded to the input elements |
+
+---
+
 ## Examples
 
 ### Single (controlled)
@@ -147,9 +181,3 @@ const [value, setValue] = useState<string[]>([]);
   }}
 />;
 ```
-
----
-
-## Storybook note
-
-Default story args include `value: ''`. Spreading `{...args}` in custom renders behaves as controlled empty single. Omit `value` when demonstrating uncontrolled multi or creatable multi.

From 5261dd91ca20e1ce8a6c011db4c2c79ae856bcba Mon Sep 17 00:00:00 2001
From: dreamwasp <cass.spain@skillsoft.com>
Date: Tue, 16 Jun 2026 13:17:59 -0400
Subject: [PATCH 37/37] need an alpha

---
 .github/workflows/publish-alpha.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/publish-alpha.yml b/.github/workflows/publish-alpha.yml
index b968dd17558..e4c5830d8a6 100644
--- a/.github/workflows/publish-alpha.yml
+++ b/.github/workflows/publish-alpha.yml
@@ -27,6 +27,8 @@ jobs:
     runs-on: ubuntu-22.04
     timeout-minutes: 30
     steps:
+      - uses: actions/checkout@v4
+
       - uses: ./.github/actions/prerelease-publish
         with:
           node-auth-token: ${{ secrets.NODE_AUTH_TOKEN }}