From a89177bbfb43e694d3cc3be96cc0a68c6459d2fc Mon Sep 17 00:00:00 2001
From: AmirSa12 <amirhosseinpr184@gmail.com>
Date: Sun, 31 May 2026 18:44:23 +0330
Subject: [PATCH 1/3] feat(cli): add --previewVersion

---
 packages/cli/index.ts | 44 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 42 insertions(+), 2 deletions(-)

diff --git a/packages/cli/index.ts b/packages/cli/index.ts
index e48a1c7c..7ffb5a9d 100644
--- a/packages/cli/index.ts
+++ b/packages/cli/index.ts
@@ -122,6 +122,12 @@ const main = defineCommand({
             description:
               "Set to true if your package is a binary application and you would like to show an execute command instead of an install command.",
           },
+          previewVersion: {
+            type: "boolean",
+            description:
+              "Rewrite the version field of every published package.json to '0.0.0-preview-<sha>' so package managers and consumers can clearly tell this is a preview build (not the real npm version). For monorepos, cross-package peerDependencies are updated to match.",
+            default: false,
+          },
         },
         run: async ({ args }) => {
           const rawInputs =
@@ -190,6 +196,14 @@ const main = defineCommand({
           const isBinaryApplication = !!args.bin;
           const isCommentWithSha = !!args.commentWithSha;
           const isCommentWithDev = !!args.commentWithDev;
+          const isPreviewVersion = !!args.previewVersion;
+
+          if (isPreviewVersion && tarballPaths.length > 0) {
+            console.error(
+              "pkg-pr-new: --previewVersion is not supported with prebuilt tarball (.tgz) inputs because the version is baked into the tarball at pack time. Rewrite the version before packing, or pass source directories instead.",
+            );
+            process.exit(1);
+          }
           const comment: Comment = args.comment as Comment;
           const selectedPackageManager = [
             ...new Set(
@@ -415,13 +429,26 @@ const main = defineCommand({
 
           const formattedSha = isCompact ? abbreviateCommitHash(sha) : sha;
 
+          const previewVersion = isPreviewVersion
+            ? `0.0.0-preview-${abbreviateCommitHash(sha)}`
+            : null;
+
+          if (previewVersion) {
+            console.warn(
+              `Rewriting package versions to ${previewVersion} (--previewVersion).`,
+            );
+          }
+
           for (const { packageName, pJson } of packageInfos) {
             const longDepUrl = new URL(
               `/${owner}/${repo}/${packageName}@${formattedSha}`,
               apiUrl,
             ).href;
             deps.set(packageName, longDepUrl);
-            realDeps?.set(packageName, pJson.version ?? longDepUrl);
+            realDeps?.set(
+              packageName,
+              previewVersion ?? pJson.version ?? longDepUrl,
+            );
 
             const controller = new AbortController();
             try {
@@ -482,6 +509,7 @@ const main = defineCommand({
               pJson,
               deps,
               realDeps,
+              null,
             );
 
             const gitignorePath = path.join(templateDir, ".gitignore");
@@ -563,7 +591,14 @@ const main = defineCommand({
 
             restoreMap.set(
               p,
-              await writeDeps(p, pJsonContents, pJson, deps, realDeps),
+              await writeDeps(
+                p,
+                pJsonContents,
+                pJson,
+                deps,
+                realDeps,
+                previewVersion,
+              ),
             );
           }
 
@@ -885,6 +920,7 @@ async function writeDeps(
   pJson: PackageJson,
   deps: Map<string, string>,
   realDeps: Map<string, string> | null,
+  newVersion: string | null,
 ) {
   const pJsonPath = path.resolve(p, "package.json");
 
@@ -896,6 +932,10 @@ async function writeDeps(
     hijackDeps(realDeps, pJson.peerDependencies);
   }
 
+  if (newVersion) {
+    pJson.version = newVersion;
+  }
+
   await writePackageJSON(pJsonPath, pJson);
 
   return () => fs.writeFile(pJsonPath, pJsonContents);

From 4a34336e0e6731c057cf2375bb809888c38ddf27 Mon Sep 17 00:00:00 2001
From: AmirSa12 <amirhosseinpr184@gmail.com>
Date: Sun, 31 May 2026 18:50:22 +0330
Subject: [PATCH 2/3] update

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index e4a6f73c..b6e876b4 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
   "scripts": {
     "dev": "pnpm -r run dev",
     "build": "pnpm -r run build",
-    "publish:playgrounds": "pnpm pkg-pr-new publish './playgrounds/*' ./packages/cli --template './templates/*' --peerDeps",
+    "publish:playgrounds": "pnpm pkg-pr-new publish './playgrounds/*' ./packages/cli --template './templates/*' --peerDeps --previewVersion",
     "format": "prettier --write --cache .",
     "lint": "pnpm run lint:fix && pnpm run lint:format && pnpm run lint:js",
     "lint:js": "eslint --cache .",

From 88cccba6a4db36b5acaf7b875e5d36e12f68985b Mon Sep 17 00:00:00 2001
From: AmirSa12 <amirhosseinpr184@gmail.com>
Date: Sun, 31 May 2026 19:00:05 +0330
Subject: [PATCH 3/3] update

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index b6e876b4..e4a6f73c 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
   "scripts": {
     "dev": "pnpm -r run dev",
     "build": "pnpm -r run build",
-    "publish:playgrounds": "pnpm pkg-pr-new publish './playgrounds/*' ./packages/cli --template './templates/*' --peerDeps --previewVersion",
+    "publish:playgrounds": "pnpm pkg-pr-new publish './playgrounds/*' ./packages/cli --template './templates/*' --peerDeps",
     "format": "prettier --write --cache .",
     "lint": "pnpm run lint:fix && pnpm run lint:format && pnpm run lint:js",
     "lint:js": "eslint --cache .",