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

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 resolve this, you can either get an new license key at https://mui.com/r/x-get-license or from your account profile at https://mui.com/store/account/licenses/, or downgrade to an older MUI X version that matches your current 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 resolve this, you can either get an new license key at https://mui.com/r/x-get-license or from your account profile at https://mui.com/store/account/licenses/, or downgrade to an older MUI X version that matches your current 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;
-  }
-}