doc: add package migration to v2-migration doc (#504)

* doc: add package migration to v2-migration doc

* update

Author: ymc9

versioned_docs/version-3.x/_components/PackageUninstall.tsx

@@ -0,0 +1,30 @@
+import CodeBlock from '@theme/CodeBlock';
+import TabItem from '@theme/TabItem';
+import Tabs from '@theme/Tabs';
+
+interface Props {
+    dependencies: string[];
+}
+
+const pkgManagers = [
+    { name: 'npm', command: 'npm uninstall' },
+    { name: 'pnpm', command: 'pnpm remove' },
+    { name: 'bun', command: 'bun remove' },
+    { name: 'yarn', command: 'yarn remove' },
+];
+
+const PackageUninstall = ({ dependencies }: Props) => {
+    return (
+        <Tabs>
+            {pkgManagers.map((pkg) => (
+                <TabItem key={pkg.name} value={pkg.name} label={pkg.name}>
+                    <CodeBlock language="bash">
+                        {`${dependencies?.length ? `${pkg.command} ${dependencies.join(' ')}` : ''}`}
+                    </CodeBlock>
+                </TabItem>
+            ))}
+        </Tabs>
+    );
+};
+
+export default PackageUninstall;

versioned_docs/version-3.x/migrate-v2.md

@@ -4,6 +4,7 @@ sidebar_position: 11
 ---
 
 import PackageInstall from './_components/PackageInstall';
+import PackageUninstall from './_components/PackageUninstall';
 
 # Migrating From ZenStack V2
 
@@ -40,6 +41,18 @@ Here are a few essential items to verify before preparing your migration:
 
 Since ZenStack v3 is no longer based on Prisma ORM, the first step is to replace Prisma dependencies with ZenStack and update the code where `PrismaClient` is created. Please follow the [Prisma Migration Guide](./migrate-prisma.md) for detailed instructions.
 
+## Migrating ZenStack Packages
+
+As you have seen in the [Prisma Migration Guide](./migrate-prisma.md), all v3 packages are published under the "@next" tag for now. Two most important packages have been renamed:
+
+- `zenstack`: the CLI package is now named `@zenstackhq/cli`
+- `@zenstackhq/runtime`: the ORM runtime package is now named `@zenstackhq/orm`
+
+Make sure you replace them in your project.
+
+<PackageUninstall dependencies={["zenstack", "@zenstackhq/runtime"]} />
+<PackageInstall dependencies={["@zenstackhq/orm@next"]} devDependencies={["@zenstackhq/cli@next"]} />
+
 ## Migrating ZModel
 
 ### Access Control