NPM Package Migration Guide

Beginning with version 19, all SpreadJS libraries will be published under the new @mescius NPM scope.

The legacy scope @grapecity will no longer receive updates or maintenance.

Action required:

To receive the latest features, fixes, and technical support, please migrate your project dependencies from @grapecity to @mescius.

1. Migration Steps

Follow the steps below to update your project safely:

Step 1. Open Your Project

1. Launch your project folder in your preferred code editor (e.g., VS Code).

2. Make sure you have a backup or recent commit before proceeding.

Step 2. Update Namespace References

You need to change all occurrences of @grapecity/ to @mescius/.

There are two main areas to check:

• Dependencies in package.json

• Import statements in your source code

Use Find and Replace in Your Editor

1. Open the Find and Replace tool in your editor (e.g., press Ctrl + Shift + F in VS Code).

2. In the Find field, enter:

@grapecity/

4. In the Replace field, enter:

@mescius/

5. Click Replace All (or review each change manually if preferred).

6. Save all modified files.

Step 3. Update Dependencies

1. Open your terminal and run:

npm install

or if using yarn:

yarn install

2. This will download and install all packages from the new @mescius scope.

Step 4. Verify the Migration

1. Check that your package.json dependencies now look like this:

{
  "dependencies": {
    "@mescius/spread-sheets": "^19.0.0"
  }
}

2. Review your code for import statements such as:

import * as GC from "@mescius/spread-sheets";

3. Run your application and ensure all SpreadJS functionalities work as expected.

Step 5. Clean Up (Optional)

After successful migration, you can remove cached data or old packages:

npm prune
npm cache clean --force

2. Common Issues & Troubleshooting

3. Support

If you encounter any issues during migration, please contact Mescius Technical Support or visit our documentation portal for additional resources.

Thank you for migrating to the new @mescius namespace!

This update ensures you continue receiving the latest improvements, security updates, and active maintenance for the SpreadJS product family.