@mui/x-license 9.0.0-alpha.2 → 9.0.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,127 @@
 # Changelog
 
+## 9.0.0-alpha.3
+
+_Mar 12, 2026_
+
+We'd like to extend a big thank you to the 13 contributors who made this release possible. Here are some highlights ✨:
+
+- 🐞 Bugfixes and internal improvements
+
+The following team members contributed to this release:
+@aemartos, @alexfauquette, @bernardobelchior, @brijeshb42, @cherniavskii, @flaviendelangle, @Janpot, @JCQuintas, @MBilalShafi, @michelengelen, @rita-codes, @sai6855, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@9.0.0-alpha.3`
+
+- [DataGrid] Fix crash when `rows` and `rowModesModel` are updated simultaneously (#21265) @michelengelen
+- [DataGrid] Add missing `resizablePanelHandle` classes to `gridClasses` object (#21538) @sai6855
+- [DataGrid] Refactor `headerAlign` style calls (#21541) @sai6855
+
+#### `@mui/x-data-grid-pro@9.0.0-alpha.3` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-data-grid@9.0.0-alpha.3`, plus:
+
+- [DataGridPro] Add `role="presentation"` to detail panel toggle header content (#21634) @michelengelen
+- [DataGridPro] Fix sorting not reflected in nested server-side data (#21619) @MBilalShafi
+
+#### `@mui/x-data-grid-premium@9.0.0-alpha.3` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-data-grid-pro@9.0.0-alpha.3`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@9.0.0-alpha.3`
+
+- [pickers] Refactor `DateRangePickerDay` overrides to use a centralized `elementOverrides` object (#21426) @sai6855
+- [pickers] Migrate from deprecated props for `PickersModalDialog` (#21702) @siriwatknp
+
+#### `@mui/x-date-pickers-pro@9.0.0-alpha.3` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-date-pickers@9.0.0-alpha.3`.
+
+### Charts
+
+#### `@mui/x-charts@9.0.0-alpha.3`
+
+- [charts] Differentiate Line Plot roots classes (#21679) @JCQuintas
+- [charts] Enable keyboard navigation by default (#21675) @alexfauquette
+- [charts] Fix keyboard tooltip radar (#21667) @alexfauquette
+- [charts] Fix selector default parameter (#21638) @JCQuintas
+- [charts] Fix tooltip blink between node and pointer anchor (#21611) @alexfauquette
+- [charts] Let tooltip and legend reflect the line shape (#21475) @alexfauquette
+- [charts] Refactor `BarChart` classes structure (#21601) @JCQuintas
+- [charts] Refactor `LineChart` classes structure (#21648) @JCQuintas
+- [charts] Refactor `ScatterChart` classes structure (#21651) @JCQuintas
+- [charts] Refactor `PieChart` classes structure (#21649) @JCQuintas
+- [charts] Remove batch rendering checks in highlight selectors (#21646) @bernardobelchior
+- [charts] Standardize generic arg names to `SeriesType` (#21694) @alexfauquette
+- [charts] Simplify highlight hooks return types (#21695) @alexfauquette
+
+#### `@mui/x-charts-pro@9.0.0-alpha.3` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-charts@9.0.0-alpha.3`, plus:
+
+- [charts-pro] Fix heatmap style override from `arc` to `cell` (#21693) @Copilot
+- [charts-pro] Fix image export truncated when page is zoomed out (#21685) @bernardobelchior
+- [charts-pro] Speed-up heatmap cell search with an index lookup (#21130) @alexfauquette
+- [charts-pro] Fix heatmap highlight not working (#21710) @Copilot
+
+#### `@mui/x-charts-premium@9.0.0-alpha.3` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-charts-pro@9.0.0-alpha.3`, plus:
+
+- [charts-premium] Re-enable WebGL tests (#21708) @bernardobelchior
+
+### Tree View
+
+#### Breaking changes
+
+- Remove `TreeViewBaseItem` type (use `TreeViewDefaultItemModelProperties` or a custom interface)
+- Remove `useTreeViewApiRef` hook (use `useRichTreeViewApiRef`, `useSimpleTreeViewApiRef`, or `useRichTreeViewProApiRef`)
+- Remove `status` from content slot props returned by `getContentProps()` (use `data-*` attributes; `status` on `useTreeItem` return value is unchanged)
+- Remove deprecated CSS state classes from `treeItemClasses`: `expanded`, `selected`, `focused`, `disabled`, `editable`, `editing` (use `[data-expanded]`, `[data-selected]`, etc.)
+- The `<RichTreeViewPro />` component has now virtualization enabled by default.
+- The items used inside the `<RichTreeViewPro />` now have a default height of `32px`.
+- The events of the `<RichTreeViewPro />` are now rendered as a flat list instead of a nested tree.
+
+#### `@mui/x-tree-view@9.0.0-alpha.3`
+
+- [tree view] Remove deprecated APIs (#21591) @flaviendelangle
+- [tree view] Fix collapsed children not selected with `selectionPropagation.descendants` in `SimpleTreeView` (#21253) @flaviendelangle
+
+#### `@mui/x-tree-view-pro@9.0.0-alpha.3` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-tree-view@9.0.0-alpha.3`, plus:
+
+- [RichTreeViewPro] Make the virtualization opt-out and port the layout doc from the data grid (#21461) @flaviendelangle
+
+### Codemod
+
+#### `@mui/x-codemod@9.0.0-alpha.3`
+
+Internal changes.
+
+### Docs
+
+- [docs] Fix `AssistantWithDataSource` demo crashing (#21555) @sai6855
+- [docs] Remove `Preview` pill from Sankey (#21623) @bernardobelchior
+- [docs] Migrate internal Material UI deprecated APIs (#21680) @siriwatknp
+- [docs] Remove `New` flag on Tree View and Date and Time Pickers features released before v9 alpha (#21585) @flaviendelangle
+
+### Core
+
+- [code-infra] Remove checkout step (#21688) @Janpot
+- [code-infra] Fix contributor generation in changelog (#21718) @brijeshb42
+- [docs-infra] Do not point to non-existent v8 subdomain (#21640) @cherniavskii
+
+### Miscellaneous
+
+- [test] Add missing tests for forwarding props to filter operators in DataGrid (#21441) @siriwatknp
+- [x-license] Export additional license types and constants (#21625) @aemartos
+- [x-license] Refactor license verification to accept package info object and add v9 version gating (#21690) @aemartos
+
 ## 9.0.0-alpha.2
 
 _Mar 5, 2026_
@@ -92,7 +214,7 @@ Internal changes.
 
 - [docs] Add backticks and parentheses to all functions and hooks (DX-173) (#21496) @mapache-salvaje
 - [docs] Remove mentions of `mySvgRef` (#21559) @bernardobelchior
-- [docs] Update Roadmap section in the docs  (#20892) @alelthomas
+- [docs] Update Roadmap section in the docs (#20892) @alelthomas
 - [docs] Add tutorial and example app for aggregation with row grouping (DX-162) (#21102) @mapache-salvaje
 - [docs] Fix missing codemod docs (#21604) @JCQuintas
 

package/Watermark/Watermark.d.mts

@@ -1,7 +1,6 @@
-import { MuiCommercialPackageName } from "../utils/commercialPackages.mjs";
+import { CommercialPackageInfo } from "../utils/commercialPackages.mjs";
 interface WatermarkProps {
-  packageName: MuiCommercialPackageName;
-  releaseInfo: string;
+  packageInfo: CommercialPackageInfo;
 }
 declare function Watermark(props: WatermarkProps): import("react/jsx-runtime").JSX.Element | null;
 declare const MemoizedWatermark: typeof Watermark;

package/Watermark/Watermark.d.ts

@@ -1,7 +1,6 @@
-import { MuiCommercialPackageName } from "../utils/commercialPackages.js";
+import { CommercialPackageInfo } from "../utils/commercialPackages.js";
 interface WatermarkProps {
-  packageName: MuiCommercialPackageName;
-  releaseInfo: string;
+  packageInfo: CommercialPackageInfo;
 }
 declare function Watermark(props: WatermarkProps): import("react/jsx-runtime").JSX.Element | null;
 declare const MemoizedWatermark: typeof Watermark;

package/Watermark/Watermark.js

@@ -31,10 +31,9 @@ function getLicenseErrorMessage(licenseStatus) {
 }
 function Watermark(props) {
   const {
-    packageName,
-    releaseInfo
+    packageInfo
   } = props;
-  const licenseStatus = (0, _useLicenseVerifier.useLicenseVerifier)(packageName, releaseInfo);
+  const licenseStatus = (0, _useLicenseVerifier.useLicenseVerifier)(packageInfo);
   if (licenseStatus.status === _licenseStatus.LICENSE_STATUS.Valid) {
     return null;
   }

package/Watermark/Watermark.mjs

@@ -24,10 +24,9 @@ function getLicenseErrorMessage(licenseStatus) {
 }
 function Watermark(props) {
   const {
-    packageName,
-    releaseInfo
+    packageInfo
   } = props;
-  const licenseStatus = useLicenseVerifier(packageName, releaseInfo);
+  const licenseStatus = useLicenseVerifier(packageInfo);
   if (licenseStatus.status === LICENSE_STATUS.Valid) {
     return null;
   }

package/index.d.mts

@@ -1,4 +1,3 @@
 export { Unstable_LicenseInfoProvider, type Unstable_LicenseInfoProviderProps } from "./Unstable_LicenseInfoProvider/index.mjs";
 export { LicenseInfo } from "./utils/index.mjs";
-export type { LicenseStatus, MuiLicenseInfo, AppType, KeyVersion, LicenseDetails, LicenseModel, PlanScope } from "./utils/index.mjs";
 export { muiXTelemetrySettings } from '@mui/x-telemetry';

package/index.d.ts

@@ -1,4 +1,3 @@
 export { Unstable_LicenseInfoProvider, type Unstable_LicenseInfoProviderProps } from "./Unstable_LicenseInfoProvider/index.js";
 export { LicenseInfo } from "./utils/index.js";
-export type { LicenseStatus, MuiLicenseInfo, AppType, KeyVersion, LicenseDetails, LicenseModel, PlanScope } from "./utils/index.js";
 export { muiXTelemetrySettings } from '@mui/x-telemetry';

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-license v9.0.0-alpha.2
+ * @mui/x-license v9.0.0-alpha.3
  *
  * @license SEE LICENSE IN LICENSE
  * This source code is licensed under the SEE LICENSE IN LICENSE license found in the

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/x-license v9.0.0-alpha.2
+ * @mui/x-license v9.0.0-alpha.3
  *
  * @license SEE LICENSE IN LICENSE
  * This source code is licensed under the SEE LICENSE IN LICENSE license found in the

package/internals/index.d.mts

@@ -0,0 +1,13 @@
+export { base64Decode, base64Encode } from "../encoding/base64.mjs";
+export { md5 } from "../encoding/md5.mjs";
+export { APP_TYPES, type AppType } from "../utils/licenseAppType.mjs";
+export { PLAN_SCOPES, PLAN_VERSIONS, type PlanScope, type PlanVersion } from "../utils/licensePlan.mjs";
+export { LICENSE_MODELS, type LicenseModel } from "../utils/licenseModel.mjs";
+export type { KeyVersion, LicenseDetails, NullableLicenseDetails } from "../utils/licenseDetails.mjs";
+export type { LicenseStatus } from "../utils/licenseStatus.mjs";
+export type { MuiLicenseInfo } from "../utils/licenseInfo.mjs";
+export type { MuiCommercialPackageName, CommercialPackageInfo } from "../utils/commercialPackages.mjs";
+export { Watermark } from "../Watermark/Watermark.mjs";
+export { useLicenseVerifier, clearLicenseStatusCache } from "../useLicenseVerifier/useLicenseVerifier.mjs";
+export * from "../verifyLicense/verifyLicense.mjs";
+export * from "../test-keys.mjs";

package/internals/index.d.ts

@@ -0,0 +1,13 @@
+export { base64Decode, base64Encode } from "../encoding/base64.js";
+export { md5 } from "../encoding/md5.js";
+export { APP_TYPES, type AppType } from "../utils/licenseAppType.js";
+export { PLAN_SCOPES, PLAN_VERSIONS, type PlanScope, type PlanVersion } from "../utils/licensePlan.js";
+export { LICENSE_MODELS, type LicenseModel } from "../utils/licenseModel.js";
+export type { KeyVersion, LicenseDetails, NullableLicenseDetails } from "../utils/licenseDetails.js";
+export type { LicenseStatus } from "../utils/licenseStatus.js";
+export type { MuiLicenseInfo } from "../utils/licenseInfo.js";
+export type { MuiCommercialPackageName, CommercialPackageInfo } from "../utils/commercialPackages.js";
+export { Watermark } from "../Watermark/Watermark.js";
+export { useLicenseVerifier, clearLicenseStatusCache } from "../useLicenseVerifier/useLicenseVerifier.js";
+export * from "../verifyLicense/verifyLicense.js";
+export * from "../test-keys.js";

package/internals/index.js

@@ -0,0 +1,108 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  base64Decode: true,
+  base64Encode: true,
+  md5: true,
+  APP_TYPES: true,
+  PLAN_SCOPES: true,
+  PLAN_VERSIONS: true,
+  LICENSE_MODELS: true,
+  Watermark: true,
+  useLicenseVerifier: true,
+  clearLicenseStatusCache: true
+};
+Object.defineProperty(exports, "APP_TYPES", {
+  enumerable: true,
+  get: function () {
+    return _licenseAppType.APP_TYPES;
+  }
+});
+Object.defineProperty(exports, "LICENSE_MODELS", {
+  enumerable: true,
+  get: function () {
+    return _licenseModel.LICENSE_MODELS;
+  }
+});
+Object.defineProperty(exports, "PLAN_SCOPES", {
+  enumerable: true,
+  get: function () {
+    return _licensePlan.PLAN_SCOPES;
+  }
+});
+Object.defineProperty(exports, "PLAN_VERSIONS", {
+  enumerable: true,
+  get: function () {
+    return _licensePlan.PLAN_VERSIONS;
+  }
+});
+Object.defineProperty(exports, "Watermark", {
+  enumerable: true,
+  get: function () {
+    return _Watermark.Watermark;
+  }
+});
+Object.defineProperty(exports, "base64Decode", {
+  enumerable: true,
+  get: function () {
+    return _base.base64Decode;
+  }
+});
+Object.defineProperty(exports, "base64Encode", {
+  enumerable: true,
+  get: function () {
+    return _base.base64Encode;
+  }
+});
+Object.defineProperty(exports, "clearLicenseStatusCache", {
+  enumerable: true,
+  get: function () {
+    return _useLicenseVerifier.clearLicenseStatusCache;
+  }
+});
+Object.defineProperty(exports, "md5", {
+  enumerable: true,
+  get: function () {
+    return _md.md5;
+  }
+});
+Object.defineProperty(exports, "useLicenseVerifier", {
+  enumerable: true,
+  get: function () {
+    return _useLicenseVerifier.useLicenseVerifier;
+  }
+});
+var _base = require("../encoding/base64");
+var _md = require("../encoding/md5");
+var _licenseAppType = require("../utils/licenseAppType");
+var _licensePlan = require("../utils/licensePlan");
+var _licenseModel = require("../utils/licenseModel");
+var _Watermark = require("../Watermark/Watermark");
+var _useLicenseVerifier = require("../useLicenseVerifier/useLicenseVerifier");
+var _verifyLicense = require("../verifyLicense/verifyLicense");
+Object.keys(_verifyLicense).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _verifyLicense[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _verifyLicense[key];
+    }
+  });
+});
+var _testKeys = require("../test-keys");
+Object.keys(_testKeys).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _testKeys[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _testKeys[key];
+    }
+  });
+});

package/internals/index.mjs

@@ -0,0 +1,9 @@
+export { base64Decode, base64Encode } from "../encoding/base64.mjs";
+export { md5 } from "../encoding/md5.mjs";
+export { APP_TYPES } from "../utils/licenseAppType.mjs";
+export { PLAN_SCOPES, PLAN_VERSIONS } from "../utils/licensePlan.mjs";
+export { LICENSE_MODELS } from "../utils/licenseModel.mjs";
+export { Watermark } from "../Watermark/Watermark.mjs";
+export { useLicenseVerifier, clearLicenseStatusCache } from "../useLicenseVerifier/useLicenseVerifier.mjs";
+export * from "../verifyLicense/verifyLicense.mjs";
+export * from "../test-keys.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-license",
-  "version": "9.0.0-alpha.2",
+  "version": "9.0.0-alpha.3",
   "author": "MUI Team",
   "description": "MUI X License verification.",
   "license": "SEE LICENSE IN LICENSE",
@@ -23,8 +23,8 @@
   "dependencies": {
     "@babel/runtime": "^7.28.6",
     "@mui/utils": "^7.3.7",
-    "@mui/x-internals": "9.0.0-alpha.2",
-    "@mui/x-telemetry": "9.0.0-alpha.2"
+    "@mui/x-telemetry": "9.0.0-alpha.2",
+    "@mui/x-internals": "9.0.0-alpha.2"
   },
   "peerDependencies": {
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
@@ -49,102 +49,18 @@
         "default": "./index.mjs"
       }
     },
-    "./Watermark": {
+    "./internals": {
       "import": {
-        "types": "./Watermark/index.d.mts",
-        "default": "./Watermark/index.mjs"
+        "types": "./internals/index.d.mts",
+        "default": "./internals/index.mjs"
       },
       "require": {
-        "types": "./Watermark/index.d.ts",
-        "default": "./Watermark/index.js"
+        "types": "./internals/index.d.ts",
+        "default": "./internals/index.js"
       },
       "default": {
-        "types": "./Watermark/index.d.mts",
-        "default": "./Watermark/index.mjs"
-      }
-    },
-    "./useLicenseVerifier": {
-      "import": {
-        "types": "./useLicenseVerifier/index.d.mts",
-        "default": "./useLicenseVerifier/index.mjs"
-      },
-      "require": {
-        "types": "./useLicenseVerifier/index.d.ts",
-        "default": "./useLicenseVerifier/index.js"
-      },
-      "default": {
-        "types": "./useLicenseVerifier/index.d.mts",
-        "default": "./useLicenseVerifier/index.mjs"
-      }
-    },
-    "./verifyLicense": {
-      "import": {
-        "types": "./verifyLicense/index.d.mts",
-        "default": "./verifyLicense/index.mjs"
-      },
-      "require": {
-        "types": "./verifyLicense/index.d.ts",
-        "default": "./verifyLicense/index.js"
-      },
-      "default": {
-        "types": "./verifyLicense/index.d.mts",
-        "default": "./verifyLicense/index.mjs"
-      }
-    },
-    "./utils": {
-      "import": {
-        "types": "./utils/index.d.mts",
-        "default": "./utils/index.mjs"
-      },
-      "require": {
-        "types": "./utils/index.d.ts",
-        "default": "./utils/index.js"
-      },
-      "default": {
-        "types": "./utils/index.d.mts",
-        "default": "./utils/index.mjs"
-      }
-    },
-    "./test-keys": {
-      "import": {
-        "types": "./test-keys.d.mts",
-        "default": "./test-keys.mjs"
-      },
-      "require": {
-        "types": "./test-keys.d.ts",
-        "default": "./test-keys.js"
-      },
-      "default": {
-        "types": "./test-keys.d.mts",
-        "default": "./test-keys.mjs"
-      }
-    },
-    "./Unstable_LicenseInfoProvider": {
-      "import": {
-        "types": "./Unstable_LicenseInfoProvider/index.d.mts",
-        "default": "./Unstable_LicenseInfoProvider/index.mjs"
-      },
-      "require": {
-        "types": "./Unstable_LicenseInfoProvider/index.d.ts",
-        "default": "./Unstable_LicenseInfoProvider/index.js"
-      },
-      "default": {
-        "types": "./Unstable_LicenseInfoProvider/index.d.mts",
-        "default": "./Unstable_LicenseInfoProvider/index.mjs"
-      }
-    },
-    "./encoding": {
-      "import": {
-        "types": "./encoding/index.d.mts",
-        "default": "./encoding/index.mjs"
-      },
-      "require": {
-        "types": "./encoding/index.d.ts",
-        "default": "./encoding/index.js"
-      },
-      "default": {
-        "types": "./encoding/index.d.mts",
-        "default": "./encoding/index.mjs"
+        "types": "./internals/index.d.mts",
+        "default": "./internals/index.mjs"
       }
     }
   },

package/test-keys.d.mts

@@ -80,6 +80,16 @@ export declare const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = "5f52871b5845f28ebdd0fabbe
  * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
  */
 export declare const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = "450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=";
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate + 1 day (not expired).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL_Q1_2026 = "5f78509380f3ea3b3c91d7af3f5496eaTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL_Q1_2026_EXPIRED = "191d8aaf174e38bcbf367e07fa39e423Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y";
 /**
  * Invalid key: hash does not match payload (tampered).
  * Used to test that verifyLicense rejects tampered keys.

package/test-keys.d.ts

@@ -80,6 +80,16 @@ export declare const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = "5f52871b5845f28ebdd0fabbe
  * orderId: #123, keyVersion: 3, expiryDate: 3001-01-01
  */
 export declare const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = "450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=";
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate + 1 day (not expired).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL_Q1_2026 = "5f78509380f3ea3b3c91d7af3f5496eaTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y";
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+export declare const TEST_KEY_PRO_PERPETUAL_Q1_2026_EXPIRED = "191d8aaf174e38bcbf367e07fa39e423Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y";
 /**
  * Invalid key: hash does not match payload (tampered).
  * Used to test that verifyLicense rejects tampered keys.

package/test-keys.js

@@ -3,11 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TEST_LICENSE_KEY_PRO = exports.TEST_LICENSE_KEY_PREMIUM = exports.TEST_KEY_V1 = exports.TEST_KEY_UNKNOWN_VERSION = exports.TEST_KEY_PRO_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PRO_SUBSCRIPTION = exports.TEST_KEY_PRO_PERPETUAL_EXPIRED = exports.TEST_KEY_PRO_PERPETUAL = exports.TEST_KEY_PRO_ANNUAL_V3 = exports.TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PRO_ANNUAL_INITIAL = exports.TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PREMIUM_SUBSCRIPTION = exports.TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PREMIUM_ANNUAL_INITIAL = exports.TEST_KEY_INVALID = exports.TEST_KEY_EXPIRED_GRACE = exports.TEST_KEY_EXPIRED_30DAYS = void 0;
+exports.TEST_LICENSE_KEY_PRO = exports.TEST_LICENSE_KEY_PREMIUM = exports.TEST_KEY_V1 = exports.TEST_KEY_UNKNOWN_VERSION = exports.TEST_KEY_PRO_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PRO_SUBSCRIPTION = exports.TEST_KEY_PRO_PERPETUAL_Q1_2026_EXPIRED = exports.TEST_KEY_PRO_PERPETUAL_Q1_2026 = exports.TEST_KEY_PRO_PERPETUAL_EXPIRED = exports.TEST_KEY_PRO_PERPETUAL = exports.TEST_KEY_PRO_ANNUAL_V3 = exports.TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PRO_ANNUAL_INITIAL = exports.TEST_KEY_PREMIUM_SUBSCRIPTION_FUTURE = exports.TEST_KEY_PREMIUM_SUBSCRIPTION = exports.TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PREMIUM_ANNUAL_INITIAL = exports.TEST_KEY_INVALID = exports.TEST_KEY_EXPIRED_GRACE = exports.TEST_KEY_EXPIRED_30DAYS = void 0;
 // =============================================================================
 // Test license keys for use in test suites.
 // All keys contain T=true in their payload and are rejected outside test environments.
-// Import via '@mui/x-license/test-keys'.
+// Import via '@mui/x-license/internals'.
 // =============================================================================
 
 /**
@@ -120,6 +120,20 @@ const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PRO_ANNUAL_Q1_2026_V3 =
  */
 const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = exports.TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = '450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=';
 
+// --- Keys for v9 plan version check tests (perpetual + Q1-2026) ---
+
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate + 1 day (not expired).
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PRO_PERPETUAL_Q1_2026 = exports.TEST_KEY_PRO_PERPETUAL_Q1_2026 = '5f78509380f3ea3b3c91d7af3f5496eaTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+const TEST_KEY_PRO_PERPETUAL_Q1_2026_EXPIRED = exports.TEST_KEY_PRO_PERPETUAL_Q1_2026_EXPIRED = '191d8aaf174e38bcbf367e07fa39e423Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y';
+
 // --- Invalid / edge-case keys ---
 
 /**

package/test-keys.mjs

@@ -1,7 +1,7 @@
 // =============================================================================
 // Test license keys for use in test suites.
 // All keys contain T=true in their payload and are rejected outside test environments.
-// Import via '@mui/x-license/test-keys'.
+// Import via '@mui/x-license/internals'.
 // =============================================================================
 
 /**
@@ -114,6 +114,20 @@ export const TEST_KEY_PRO_ANNUAL_Q1_2026_V3 = '5f52871b5845f28ebdd0fabbe0b89695T
  */
 export const TEST_KEY_PREMIUM_ANNUAL_Q1_2026_V3 = '450d9fc1b28e709fcb73969bd10e1c30Tz0xMjMsRT0zMjUzNTEyNjAwMDAwMCxTPXByZW1pdW0sTE09YW5udWFsLFBWPVExLTIwMjYsUT0xMCxBVD1zaW5nbGUsVD10cnVlLEtWPTM=';
 
+// --- Keys for v9 plan version check tests (perpetual + Q1-2026) ---
+
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate + 1 day (not expired).
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PRO_PERPETUAL_Q1_2026 = '5f78509380f3ea3b3c91d7af3f5496eaTz0xMjMsRT0xNTE0NzYxMjAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y';
+
+/**
+ * Pro perpetual, Q1-2026, expiry = releaseDate - 1 day (expired before release).
+ * orderId: #123, keyVersion: 2
+ */
+export const TEST_KEY_PRO_PERPETUAL_Q1_2026_EXPIRED = '191d8aaf174e38bcbf367e07fa39e423Tz0xMjMsRT0xNTE0NTg4NDAwMDAwLFM9cHJvLExNPXBlcnBldHVhbCxQVj1RMS0yMDI2LFQ9dHJ1ZSxLVj0y';
+
 // --- Invalid / edge-case keys ---
 
 /**

package/useLicenseVerifier/useLicenseVerifier.d.mts

@@ -1,5 +1,5 @@
 import { LicenseStatus } from "../utils/licenseStatus.mjs";
-import { MuiCommercialPackageName } from "../utils/commercialPackages.mjs";
+import { MuiCommercialPackageName, CommercialPackageInfo } from "../utils/commercialPackages.mjs";
 export declare const sharedLicenseStatuses: { [packageName in MuiCommercialPackageName]?: {
   key: string | undefined;
   licenseVerifier: {
@@ -11,6 +11,6 @@ export declare const sharedLicenseStatuses: { [packageName in MuiCommercialPacka
  * This should not be used in production code, but can be useful for testing purposes.
  */
 export declare function clearLicenseStatusCache(): void;
-export declare function useLicenseVerifier(packageName: MuiCommercialPackageName, releaseInfo: string): {
+export declare function useLicenseVerifier(packageInfo: CommercialPackageInfo): {
   status: LicenseStatus;
 };

package/useLicenseVerifier/useLicenseVerifier.d.ts

@@ -1,5 +1,5 @@
 import { LicenseStatus } from "../utils/licenseStatus.js";
-import { MuiCommercialPackageName } from "../utils/commercialPackages.js";
+import { MuiCommercialPackageName, CommercialPackageInfo } from "../utils/commercialPackages.js";
 export declare const sharedLicenseStatuses: { [packageName in MuiCommercialPackageName]?: {
   key: string | undefined;
   licenseVerifier: {
@@ -11,6 +11,6 @@ export declare const sharedLicenseStatuses: { [packageName in MuiCommercialPacka
  * This should not be used in production code, but can be useful for testing purposes.
  */
 export declare function clearLicenseStatusCache(): void;
-export declare function useLicenseVerifier(packageName: MuiCommercialPackageName, releaseInfo: string): {
+export declare function useLicenseVerifier(packageInfo: CommercialPackageInfo): {
   status: LicenseStatus;
 };

package/useLicenseVerifier/useLicenseVerifier.js

@@ -30,12 +30,17 @@ function clearLicenseStatusCache() {
     }
   }
 }
-function useLicenseVerifier(packageName, releaseInfo) {
+function useLicenseVerifier(packageInfo) {
   const {
     key: contextKey
   } = React.useContext(_MuiLicenseInfoContext.default);
   return React.useMemo(() => {
     const licenseKey = contextKey ?? _licenseInfo.LicenseInfo.getLicenseKey();
+    const {
+      name: packageName,
+      releaseDate,
+      version: packageVersion
+    } = packageInfo;
 
     // Cache the response to not trigger the error twice.
     if (sharedLicenseStatuses[packageName] && sharedLicenseStatuses[packageName].key === licenseKey) {
@@ -43,17 +48,16 @@ function useLicenseVerifier(packageName, releaseInfo) {
     }
     const plan = packageName.includes('premium') ? 'Premium' : 'Pro';
     const licenseStatus = (0, _verifyLicense.verifyLicense)({
-      releaseInfo,
-      licenseKey,
-      packageName
+      packageInfo,
+      licenseKey
     });
     const fullPackageName = `@mui/${packageName}`;
     (0, _xTelemetry.sendMuiXTelemetryEvent)(_xTelemetry.muiXTelemetryEvents.licenseVerification({
       licenseKey,
-      xLicenseClientVersion: "9.0.0-alpha.2"
+      xLicenseClientVersion: packageVersion
     }, {
       packageName,
-      packageReleaseInfo: releaseInfo,
+      packageReleaseInfo: releaseDate,
       licenseStatus: licenseStatus?.status
     }));
     if (licenseStatus.status === _licenseStatus.LICENSE_STATUS.Valid) {
@@ -83,6 +87,8 @@ function useLicenseVerifier(packageName, releaseInfo) {
       (0, _licenseErrorMessageUtils.showExpiredPackageVersionError)({
         packageName: fullPackageName
       });
+    } else if (licenseStatus.status === _licenseStatus.LICENSE_STATUS.NotValidForPackage) {
+      (0, _licenseErrorMessageUtils.showLicenseKeyVersionMismatchError)();
     } else if (process.env.NODE_ENV !== 'production') {
       throw new Error('missing status handler');
     }
@@ -91,5 +97,5 @@ function useLicenseVerifier(packageName, releaseInfo) {
       licenseVerifier: licenseStatus
     };
     return licenseStatus;
-  }, [packageName, releaseInfo, contextKey]);
+  }, [packageInfo, contextKey]);
 }

package/useLicenseVerifier/useLicenseVerifier.mjs

@@ -5,7 +5,7 @@ import * as React from 'react';
 import { sendMuiXTelemetryEvent, muiXTelemetryEvents } from '@mui/x-telemetry';
 import { verifyLicense } from "../verifyLicense/verifyLicense.mjs";
 import { LicenseInfo } from "../utils/licenseInfo.mjs";
-import { showExpiredAnnualGraceLicenseKeyError, showExpiredAnnualLicenseKeyError, showInvalidLicenseKeyError, showMissingLicenseKeyError, showLicenseKeyPlanMismatchError, showExpiredPackageVersionError, showNotAvailableInInitialProPlanError } from "../utils/licenseErrorMessageUtils.mjs";
+import { showExpiredAnnualGraceLicenseKeyError, showExpiredAnnualLicenseKeyError, showInvalidLicenseKeyError, showMissingLicenseKeyError, showLicenseKeyPlanMismatchError, showExpiredPackageVersionError, showNotAvailableInInitialProPlanError, showLicenseKeyVersionMismatchError } from "../utils/licenseErrorMessageUtils.mjs";
 import { LICENSE_STATUS } from "../utils/licenseStatus.mjs";
 import MuiLicenseInfoContext from "../Unstable_LicenseInfoProvider/MuiLicenseInfoContext.mjs";
 export const sharedLicenseStatuses = {};
@@ -21,12 +21,17 @@ export function clearLicenseStatusCache() {
     }
   }
 }
-export function useLicenseVerifier(packageName, releaseInfo) {
+export function useLicenseVerifier(packageInfo) {
   const {
     key: contextKey
   } = React.useContext(MuiLicenseInfoContext);
   return React.useMemo(() => {
     const licenseKey = contextKey ?? LicenseInfo.getLicenseKey();
+    const {
+      name: packageName,
+      releaseDate,
+      version: packageVersion
+    } = packageInfo;
 
     // Cache the response to not trigger the error twice.
     if (sharedLicenseStatuses[packageName] && sharedLicenseStatuses[packageName].key === licenseKey) {
@@ -34,17 +39,16 @@ export function useLicenseVerifier(packageName, releaseInfo) {
     }
     const plan = packageName.includes('premium') ? 'Premium' : 'Pro';
     const licenseStatus = verifyLicense({
-      releaseInfo,
-      licenseKey,
-      packageName
+      packageInfo,
+      licenseKey
     });
     const fullPackageName = `@mui/${packageName}`;
     sendMuiXTelemetryEvent(muiXTelemetryEvents.licenseVerification({
       licenseKey,
-      xLicenseClientVersion: "9.0.0-alpha.2"
+      xLicenseClientVersion: packageVersion
     }, {
       packageName,
-      packageReleaseInfo: releaseInfo,
+      packageReleaseInfo: releaseDate,
       licenseStatus: licenseStatus?.status
     }));
     if (licenseStatus.status === LICENSE_STATUS.Valid) {
@@ -74,6 +78,8 @@ export function useLicenseVerifier(packageName, releaseInfo) {
       showExpiredPackageVersionError({
         packageName: fullPackageName
       });
+    } else if (licenseStatus.status === LICENSE_STATUS.NotValidForPackage) {
+      showLicenseKeyVersionMismatchError();
     } else if (process.env.NODE_ENV !== 'production') {
       throw new Error('missing status handler');
     }
@@ -82,5 +88,5 @@ export function useLicenseVerifier(packageName, releaseInfo) {
       licenseVerifier: licenseStatus
     };
     return licenseStatus;
-  }, [packageName, releaseInfo, contextKey]);
+  }, [packageInfo, contextKey]);
 }

package/utils/commercialPackages.d.mts

@@ -1 +1,6 @@
-export type MuiCommercialPackageName = 'x-data-grid-pro' | 'x-data-grid-premium' | 'x-date-pickers-pro' | 'x-tree-view-pro' | 'x-charts-pro' | 'x-charts-premium' | 'x-scheduler-premium';
+export type MuiCommercialPackageName = 'x-data-grid-pro' | 'x-data-grid-premium' | 'x-date-pickers-pro' | 'x-tree-view-pro' | 'x-charts-pro' | 'x-charts-premium' | 'x-scheduler-premium';
+export interface CommercialPackageInfo {
+  releaseDate: string;
+  version: string;
+  name: MuiCommercialPackageName;
+}

package/utils/commercialPackages.d.ts

@@ -1 +1,6 @@
-export type MuiCommercialPackageName = 'x-data-grid-pro' | 'x-data-grid-premium' | 'x-date-pickers-pro' | 'x-tree-view-pro' | 'x-charts-pro' | 'x-charts-premium' | 'x-scheduler-premium';
+export type MuiCommercialPackageName = 'x-data-grid-pro' | 'x-data-grid-premium' | 'x-date-pickers-pro' | 'x-tree-view-pro' | 'x-charts-pro' | 'x-charts-premium' | 'x-scheduler-premium';
+export interface CommercialPackageInfo {
+  releaseDate: string;
+  version: string;
+  name: MuiCommercialPackageName;
+}

package/utils/index.d.mts

@@ -5,4 +5,4 @@ export type { AppType } from "./licenseAppType.mjs";
 export type { PlanScope } from "./licensePlan.mjs";
 export type { LicenseModel } from "./licenseModel.mjs";
 export type { KeyVersion, LicenseDetails, NullableLicenseDetails } from "./licenseDetails.mjs";
-export type { MuiCommercialPackageName } from "./commercialPackages.mjs";
+export type { MuiCommercialPackageName, CommercialPackageInfo } from "./commercialPackages.mjs";

package/utils/index.d.ts

@@ -5,4 +5,4 @@ export type { AppType } from "./licenseAppType.js";
 export type { PlanScope } from "./licensePlan.js";
 export type { LicenseModel } from "./licenseModel.js";
 export type { KeyVersion, LicenseDetails, NullableLicenseDetails } from "./licenseDetails.js";
-export type { MuiCommercialPackageName } from "./commercialPackages.js";
+export type { MuiCommercialPackageName, CommercialPackageInfo } from "./commercialPackages.js";

package/utils/licenseErrorMessageUtils.d.mts

@@ -5,6 +5,7 @@ export declare function showLicenseKeyPlanMismatchError({
   packageName: string;
 }): void;
 export declare function showNotAvailableInInitialProPlanError(): void;
+export declare function showLicenseKeyVersionMismatchError(): void;
 export declare function showMissingLicenseKeyError({
   plan,
   packageName

package/utils/licenseErrorMessageUtils.d.ts

@@ -5,6 +5,7 @@ export declare function showLicenseKeyPlanMismatchError({
   packageName: string;
 }): void;
 export declare function showNotAvailableInInitialProPlanError(): void;
+export declare function showLicenseKeyVersionMismatchError(): void;
 export declare function showMissingLicenseKeyError({
   plan,
   packageName

package/utils/licenseErrorMessageUtils.js

@@ -9,6 +9,7 @@ exports.showExpiredAnnualLicenseKeyError = showExpiredAnnualLicenseKeyError;
 exports.showExpiredPackageVersionError = showExpiredPackageVersionError;
 exports.showInvalidLicenseKeyError = showInvalidLicenseKeyError;
 exports.showLicenseKeyPlanMismatchError = showLicenseKeyPlanMismatchError;
+exports.showLicenseKeyVersionMismatchError = showLicenseKeyVersionMismatchError;
 exports.showMissingLicenseKeyError = showMissingLicenseKeyError;
 exports.showNotAvailableInInitialProPlanError = showNotAvailableInInitialProPlanError;
 var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/formatErrorMessage"));
@@ -39,6 +40,9 @@ function showLicenseKeyPlanMismatchError({
 function showNotAvailableInInitialProPlanError() {
   showError(['MUI X: Component not included in your license.', '', 'The component you are trying to use is not included in the Pro Plan you purchased.', '', 'Your license is from an old version of the Pro Plan that is only compatible with the `@mui/x-data-grid-pro` and `@mui/x-date-pickers-pro` commercial packages.', '', 'To start using another Pro package, please consider reaching to our sales team to upgrade your license or visit https://mui.com/r/x-get-license to get a new license key.']);
 }
+function showLicenseKeyVersionMismatchError() {
+  showError(['MUI X: License key version mismatch.', '', 'The license key you are using is not compatible with the version of the MUI X packages installed.', 'This happens when using a license key from a previous major version (e.g. a v8 license with v9 packages).', '', 'To solve the issue, you can upgrade your license at https://mui.com/r/x-get-license or install an older version of the MUI X packages that is compatible with your license key.']);
+}
 function showMissingLicenseKeyError({
   plan,
   packageName

package/utils/licenseErrorMessageUtils.mjs

@@ -26,6 +26,9 @@ export function showLicenseKeyPlanMismatchError({
 export function showNotAvailableInInitialProPlanError() {
   showError(['MUI X: Component not included in your license.', '', 'The component you are trying to use is not included in the Pro Plan you purchased.', '', 'Your license is from an old version of the Pro Plan that is only compatible with the `@mui/x-data-grid-pro` and `@mui/x-date-pickers-pro` commercial packages.', '', 'To start using another Pro package, please consider reaching to our sales team to upgrade your license or visit https://mui.com/r/x-get-license to get a new license key.']);
 }
+export function showLicenseKeyVersionMismatchError() {
+  showError(['MUI X: License key version mismatch.', '', 'The license key you are using is not compatible with the version of the MUI X packages installed.', 'This happens when using a license key from a previous major version (e.g. a v8 license with v9 packages).', '', 'To solve the issue, you can upgrade your license at https://mui.com/r/x-get-license or install an older version of the MUI X packages that is compatible with your license key.']);
+}
 export function showMissingLicenseKeyError({
   plan,
   packageName

package/utils/licensePlan.d.mts

@@ -1,4 +1,11 @@
 export declare const PLAN_SCOPES: readonly ["pro", "premium"];
 export declare const PLAN_VERSIONS: readonly ["initial", "Q3-2024", "Q1-2026"];
 export type PlanScope = (typeof PLAN_SCOPES)[number];
-export type PlanVersion = (typeof PLAN_VERSIONS)[number];
+export type PlanVersion = (typeof PLAN_VERSIONS)[number];
+/**
+ * Checks if a plan version is older than or equal to the given threshold
+ * using the ordering defined in PLAN_VERSIONS.
+ * This can be reused for future major version gates
+ * (e.g. v10 could set its own max plan version).
+ */
+export declare function isPlanVersionOlderOrEqual(planVersion: string, maxVersion: PlanVersion): boolean;

package/utils/licensePlan.d.ts

@@ -1,4 +1,11 @@
 export declare const PLAN_SCOPES: readonly ["pro", "premium"];
 export declare const PLAN_VERSIONS: readonly ["initial", "Q3-2024", "Q1-2026"];
 export type PlanScope = (typeof PLAN_SCOPES)[number];
-export type PlanVersion = (typeof PLAN_VERSIONS)[number];
+export type PlanVersion = (typeof PLAN_VERSIONS)[number];
+/**
+ * Checks if a plan version is older than or equal to the given threshold
+ * using the ordering defined in PLAN_VERSIONS.
+ * This can be reused for future major version gates
+ * (e.g. v10 could set its own max plan version).
+ */
+export declare function isPlanVersionOlderOrEqual(planVersion: string, maxVersion: PlanVersion): boolean;

package/utils/licensePlan.js

@@ -4,5 +4,17 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.PLAN_VERSIONS = exports.PLAN_SCOPES = void 0;
+exports.isPlanVersionOlderOrEqual = isPlanVersionOlderOrEqual;
 const PLAN_SCOPES = exports.PLAN_SCOPES = ['pro', 'premium'];
-const PLAN_VERSIONS = exports.PLAN_VERSIONS = ['initial', 'Q3-2024', 'Q1-2026'];
+const PLAN_VERSIONS = exports.PLAN_VERSIONS = ['initial', 'Q3-2024', 'Q1-2026'];
+/**
+ * Checks if a plan version is older than or equal to the given threshold
+ * using the ordering defined in PLAN_VERSIONS.
+ * This can be reused for future major version gates
+ * (e.g. v10 could set its own max plan version).
+ */
+function isPlanVersionOlderOrEqual(planVersion, maxVersion) {
+  const index = PLAN_VERSIONS.indexOf(planVersion);
+  const maxIndex = PLAN_VERSIONS.indexOf(maxVersion);
+  return index !== -1 && index <= maxIndex;
+}

package/utils/licensePlan.mjs

@@ -1,2 +1,13 @@
 export const PLAN_SCOPES = ['pro', 'premium'];
-export const PLAN_VERSIONS = ['initial', 'Q3-2024', 'Q1-2026'];
+export const PLAN_VERSIONS = ['initial', 'Q3-2024', 'Q1-2026'];
+/**
+ * Checks if a plan version is older than or equal to the given threshold
+ * using the ordering defined in PLAN_VERSIONS.
+ * This can be reused for future major version gates
+ * (e.g. v10 could set its own max plan version).
+ */
+export function isPlanVersionOlderOrEqual(planVersion, maxVersion) {
+  const index = PLAN_VERSIONS.indexOf(planVersion);
+  const maxIndex = PLAN_VERSIONS.indexOf(maxVersion);
+  return index !== -1 && index <= maxIndex;
+}

package/utils/licenseStatus.d.mts

@@ -7,5 +7,6 @@ export declare enum LICENSE_STATUS {
   Valid = "Valid",
   OutOfScope = "OutOfScope",
   NotAvailableInInitialProPlan = "NotAvailableInInitialProPlan",
+  NotValidForPackage = "NotValidForPackage",
 }
 export type LicenseStatus = keyof typeof LICENSE_STATUS;

package/utils/licenseStatus.d.ts

@@ -7,5 +7,6 @@ export declare enum LICENSE_STATUS {
   Valid = "Valid",
   OutOfScope = "OutOfScope",
   NotAvailableInInitialProPlan = "NotAvailableInInitialProPlan",
+  NotValidForPackage = "NotValidForPackage",
 }
 export type LicenseStatus = keyof typeof LICENSE_STATUS;

package/utils/licenseStatus.js

@@ -14,5 +14,6 @@ let LICENSE_STATUS = exports.LICENSE_STATUS = /*#__PURE__*/function (LICENSE_STA
   LICENSE_STATUS["Valid"] = "Valid";
   LICENSE_STATUS["OutOfScope"] = "OutOfScope";
   LICENSE_STATUS["NotAvailableInInitialProPlan"] = "NotAvailableInInitialProPlan";
+  LICENSE_STATUS["NotValidForPackage"] = "NotValidForPackage";
   return LICENSE_STATUS;
 }({});

package/utils/licenseStatus.mjs

@@ -8,5 +8,6 @@ export let LICENSE_STATUS = /*#__PURE__*/function (LICENSE_STATUS) {
   LICENSE_STATUS["Valid"] = "Valid";
   LICENSE_STATUS["OutOfScope"] = "OutOfScope";
   LICENSE_STATUS["NotAvailableInInitialProPlan"] = "NotAvailableInInitialProPlan";
+  LICENSE_STATUS["NotValidForPackage"] = "NotValidForPackage";
   return LICENSE_STATUS;
 }({});

package/verifyLicense/verifyLicense.d.mts

@@ -1,6 +1,6 @@
 import { LicenseStatus } from "../utils/licenseStatus.mjs";
 import type { NullableLicenseDetails } from "../utils/licenseDetails.mjs";
-import { MuiCommercialPackageName } from "../utils/commercialPackages.mjs";
+import { CommercialPackageInfo } from "../utils/commercialPackages.mjs";
 /**
  * Parse a comma-separated key=value license string into a NullableLicenseDetails object.
  * Shared by v2 and v3 decoders.
@@ -19,13 +19,11 @@ export declare function decodeLicenseVersion3(license: string): NullableLicenseD
  */
 export declare function decodeLicense(encodedLicense: string): NullableLicenseDetails | null;
 export declare function verifyLicense({
-  releaseInfo,
-  licenseKey,
-  packageName
+  packageInfo,
+  licenseKey
 }: {
-  releaseInfo: string;
+  packageInfo: CommercialPackageInfo;
   licenseKey?: string;
-  packageName: MuiCommercialPackageName;
 }): {
   status: LicenseStatus;
   meta?: any;

package/verifyLicense/verifyLicense.d.ts

@@ -1,6 +1,6 @@
 import { LicenseStatus } from "../utils/licenseStatus.js";
 import type { NullableLicenseDetails } from "../utils/licenseDetails.js";
-import { MuiCommercialPackageName } from "../utils/commercialPackages.js";
+import { CommercialPackageInfo } from "../utils/commercialPackages.js";
 /**
  * Parse a comma-separated key=value license string into a NullableLicenseDetails object.
  * Shared by v2 and v3 decoders.
@@ -19,13 +19,11 @@ export declare function decodeLicenseVersion3(license: string): NullableLicenseD
  */
 export declare function decodeLicense(encodedLicense: string): NullableLicenseDetails | null;
 export declare function verifyLicense({
-  releaseInfo,
-  licenseKey,
-  packageName
+  packageInfo,
+  licenseKey
 }: {
-  releaseInfo: string;
+  packageInfo: CommercialPackageInfo;
   licenseKey?: string;
-  packageName: MuiCommercialPackageName;
 }): {
   status: LicenseStatus;
   meta?: any;

package/verifyLicense/verifyLicense.js

@@ -29,6 +29,7 @@ function isPlanScopeSufficient(packageName, planScope) {
 const expiryReg = /^.*EXPIRY=([0-9]+),.*$/;
 const orderReg = /^.*ORDER:([0-9]+),.*$/;
 const PRO_PACKAGES_AVAILABLE_IN_INITIAL_PRO_PLAN = ['x-data-grid-pro', 'x-date-pickers-pro'];
+const MAX_V8_PLAN_VERSION = 'Q3-2024';
 
 /**
  * Format: ORDER:${orderNumber},EXPIRY=${expiryTimestamp},KEYVERSION=1
@@ -163,11 +164,16 @@ function decodeLicense(encodedLicense) {
   return null;
 }
 function verifyLicense({
-  releaseInfo,
-  licenseKey,
-  packageName
+  packageInfo,
+  licenseKey
 }) {
-  if (!releaseInfo) {
+  const {
+    name: packageName,
+    releaseDate,
+    version: packageVersion
+  } = packageInfo;
+  const packageMajorVersion = parseInt(packageVersion ?? '', 10);
+  if (!releaseDate) {
     throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X: The release information is missing and license validation cannot proceed. ' + 'This is an internal error that should not occur in normal usage. ' + 'Please report this issue if you encounter it.' : (0, _formatErrorMessage2.default)(188));
   }
   if (!licenseKey) {
@@ -213,11 +219,18 @@ function verifyLicense({
     };
   }
   if (license.licenseModel === 'perpetual' || process.env.NODE_ENV === 'production') {
-    const pkgTimestamp = parseInt((0, _base.base64Decode)(releaseInfo), 10);
+    const pkgTimestamp = parseInt((0, _base.base64Decode)(releaseDate), 10);
     if (Number.isNaN(pkgTimestamp)) {
       throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X: The release information is invalid and license validation cannot proceed. ' + 'The package release timestamp could not be parsed. ' + 'This may indicate a corrupted package. Try reinstalling the MUI X packages.' : (0, _formatErrorMessage2.default)(189));
     }
     if (license.expiryTimestamp < pkgTimestamp) {
+      // Perpetual v8 (or older) licenses whose expiry predates this package release
+      // are not valid for v9 packages.
+      if (packageMajorVersion != null && packageMajorVersion >= 9 && license.licenseModel === 'perpetual' && (0, _licensePlan.isPlanVersionOlderOrEqual)(license.planVersion, MAX_V8_PLAN_VERSION)) {
+        return {
+          status: _licenseStatus.LICENSE_STATUS.NotValidForPackage
+        };
+      }
       return {
         status: _licenseStatus.LICENSE_STATUS.ExpiredVersion
       };
@@ -262,6 +275,14 @@ function verifyLicense({
       status: _licenseStatus.LICENSE_STATUS.NotAvailableInInitialProPlan
     };
   }
+
+  // v8 licenses (Q1-2026 and older) are not valid for v9 packages.
+  // Perpetual licenses are exempt as they are already gated by the expiry date check.
+  if (packageMajorVersion != null && packageMajorVersion >= 9 && license.licenseModel !== 'perpetual' && (0, _licensePlan.isPlanVersionOlderOrEqual)(license.planVersion, MAX_V8_PLAN_VERSION)) {
+    return {
+      status: _licenseStatus.LICENSE_STATUS.NotValidForPackage
+    };
+  }
   return {
     status: _licenseStatus.LICENSE_STATUS.Valid
   };

package/verifyLicense/verifyLicense.mjs

@@ -2,7 +2,7 @@ import _formatErrorMessage from "@mui/x-internals/formatErrorMessage";
 import { base64Decode } from "../encoding/base64.mjs";
 import { md5 } from "../encoding/md5.mjs";
 import { LICENSE_STATUS } from "../utils/licenseStatus.mjs";
-import { PLAN_SCOPES } from "../utils/licensePlan.mjs";
+import { PLAN_SCOPES, isPlanVersionOlderOrEqual } from "../utils/licensePlan.mjs";
 import { LICENSE_MODELS } from "../utils/licenseModel.mjs";
 function isPlanScopeSufficient(packageName, planScope) {
   let acceptedScopes;
@@ -18,6 +18,7 @@ function isPlanScopeSufficient(packageName, planScope) {
 const expiryReg = /^.*EXPIRY=([0-9]+),.*$/;
 const orderReg = /^.*ORDER:([0-9]+),.*$/;
 const PRO_PACKAGES_AVAILABLE_IN_INITIAL_PRO_PLAN = ['x-data-grid-pro', 'x-date-pickers-pro'];
+const MAX_V8_PLAN_VERSION = 'Q3-2024';
 
 /**
  * Format: ORDER:${orderNumber},EXPIRY=${expiryTimestamp},KEYVERSION=1
@@ -152,11 +153,16 @@ export function decodeLicense(encodedLicense) {
   return null;
 }
 export function verifyLicense({
-  releaseInfo,
-  licenseKey,
-  packageName
+  packageInfo,
+  licenseKey
 }) {
-  if (!releaseInfo) {
+  const {
+    name: packageName,
+    releaseDate,
+    version: packageVersion
+  } = packageInfo;
+  const packageMajorVersion = parseInt(packageVersion ?? '', 10);
+  if (!releaseDate) {
     throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X: The release information is missing and license validation cannot proceed. ' + 'This is an internal error that should not occur in normal usage. ' + 'Please report this issue if you encounter it.' : _formatErrorMessage(188));
   }
   if (!licenseKey) {
@@ -202,11 +208,18 @@ export function verifyLicense({
     };
   }
   if (license.licenseModel === 'perpetual' || process.env.NODE_ENV === 'production') {
-    const pkgTimestamp = parseInt(base64Decode(releaseInfo), 10);
+    const pkgTimestamp = parseInt(base64Decode(releaseDate), 10);
     if (Number.isNaN(pkgTimestamp)) {
       throw new Error(process.env.NODE_ENV !== "production" ? 'MUI X: The release information is invalid and license validation cannot proceed. ' + 'The package release timestamp could not be parsed. ' + 'This may indicate a corrupted package. Try reinstalling the MUI X packages.' : _formatErrorMessage(189));
     }
     if (license.expiryTimestamp < pkgTimestamp) {
+      // Perpetual v8 (or older) licenses whose expiry predates this package release
+      // are not valid for v9 packages.
+      if (packageMajorVersion != null && packageMajorVersion >= 9 && license.licenseModel === 'perpetual' && isPlanVersionOlderOrEqual(license.planVersion, MAX_V8_PLAN_VERSION)) {
+        return {
+          status: LICENSE_STATUS.NotValidForPackage
+        };
+      }
       return {
         status: LICENSE_STATUS.ExpiredVersion
       };
@@ -251,6 +264,14 @@ export function verifyLicense({
       status: LICENSE_STATUS.NotAvailableInInitialProPlan
     };
   }
+
+  // v8 licenses (Q1-2026 and older) are not valid for v9 packages.
+  // Perpetual licenses are exempt as they are already gated by the expiry date check.
+  if (packageMajorVersion != null && packageMajorVersion >= 9 && license.licenseModel !== 'perpetual' && isPlanVersionOlderOrEqual(license.planVersion, MAX_V8_PLAN_VERSION)) {
+    return {
+      status: LICENSE_STATUS.NotValidForPackage
+    };
+  }
   return {
     status: LICENSE_STATUS.Valid
   };

package/license-env.d.mts

@@ -1,6 +0,0 @@
-export {};
-declare global {
-  interface MUIEnv {
-    MUI_VERSION?: string;
-  }
-}

package/license-env.d.ts

@@ -1,6 +0,0 @@
-export {};
-declare global {
-  interface MUIEnv {
-    MUI_VERSION?: string;
-  }
-}