From 85744f609bf2d6156e93c0210ab51efe20d2b87e Mon Sep 17 00:00:00 2001
From: SheetJS <dev@sheetjs.com>
Date: Wed, 20 Mar 2024 03:05:29 -0400
Subject: [PATCH] pnpm install supports --save

---
 .../01-installation/02-frameworks.md          | 29 +++++++++++++++++--
 .../01-installation/03-nodejs.md              | 29 +++++++++++++++++--
 .../01-installation/07-bun.md                 |  7 +++++
 .../02-frontend/19-bundler/04-esbuild.md      |  4 +--
 .../02-frontend/19-bundler/05-webpack.md      |  2 +-
 .../02-frontend/19-bundler/09-browserify.md   |  2 +-
 .../02-frontend/19-bundler/14-rollup.md       |  6 ++--
 .../02-frontend/19-bundler/20-parcel.md       |  2 +-
 .../02-frontend/19-bundler/21-swcpack.md      |  6 ++--
 .../03-demos/02-frontend/19-bundler/index.md  |  4 +--
 docz/docs/03-demos/03-net/04-email/11-pst.md  |  2 +-
 docz/docs/03-demos/12-static/02-gatsbyjs.md   |  4 +--
 docz/docs/03-demos/20-cli/09-nodesea.md       |  2 +-
 docz/docs/03-demos/20-cli/index.md            |  2 +-
 docz/docs/index.md                            |  2 +-
 15 files changed, 78 insertions(+), 25 deletions(-)

diff --git a/docz/docs/02-getting-started/01-installation/02-frameworks.md b/docz/docs/02-getting-started/01-installation/02-frameworks.md
index 38e2ab7..9d57fd3 100644
--- a/docz/docs/02-getting-started/01-installation/02-frameworks.md
+++ b/docz/docs/02-getting-started/01-installation/02-frameworks.md
@@ -26,16 +26,19 @@ Tarballs can be directly installed using a package manager:
 <Tabs groupId="pm">
   <TabItem value="npm" label="npm">
 <CodeBlock language="bash">{`\
+npm rm --save xlsx
 npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm rm xlsx
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
 <CodeBlock language="bash">{`\
+yarn remove xlsx
 yarn add https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
@@ -100,7 +103,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
 pnpm rm xlsx
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
@@ -130,6 +133,26 @@ in `package.json` can control module resolution:
 
 For general stability, "vendoring" modules is the recommended approach:
 
+0) Remove any existing dependency on a project named `xlsx`:
+
+<Tabs groupId="pm">
+  <TabItem value="npm" label="npm">
+<CodeBlock language="bash">{`\
+npm rm --save xlsx`}
+</CodeBlock>
+  </TabItem>
+  <TabItem value="pnpm" label="pnpm">
+<CodeBlock language="bash">{`\
+pnpm rm xlsx`}
+</CodeBlock>
+  </TabItem>
+  <TabItem value="yarn" label="Yarn" default>
+<CodeBlock language="bash">{`\
+yarn remove xlsx`}
+</CodeBlock>
+  </TabItem>
+</Tabs>
+
 <p>1) Download the tarball (<code parentName="pre">xlsx-{current}.tgz</code>) for the desired version. The current
    version is available at <a href={`https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}>https://cdn.sheetjs.com/xlsx-{current}/xlsx-{current}.tgz</a></p>
 
@@ -146,7 +169,7 @@ npm i --save file:vendor/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install file:vendor/xlsx-${current}.tgz`}
+pnpm install --save file:vendor/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/02-getting-started/01-installation/03-nodejs.md b/docz/docs/02-getting-started/01-installation/03-nodejs.md
index 2487beb..f1565d2 100644
--- a/docz/docs/02-getting-started/01-installation/03-nodejs.md
+++ b/docz/docs/02-getting-started/01-installation/03-nodejs.md
@@ -23,16 +23,19 @@ Tarballs can be directly installed using a package manager:
 <Tabs groupId="pm">
   <TabItem value="npm" label="npm">
 <CodeBlock language="bash">{`\
+npm rm --save xlsx
 npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm rm xlsx
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
 <CodeBlock language="bash">{`\
+yarn remove xlsx
 yarn add https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
@@ -89,7 +92,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
 pnpm rm xlsx
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
@@ -119,6 +122,26 @@ in `package.json` can control module resolution:
 
 For general stability, "vendoring" modules is the recommended approach:
 
+0) Remove any existing dependency on a project named `xlsx`:
+
+<Tabs groupId="pm">
+  <TabItem value="npm" label="npm">
+<CodeBlock language="bash">{`\
+npm rm --save xlsx`}
+</CodeBlock>
+  </TabItem>
+  <TabItem value="pnpm" label="pnpm">
+<CodeBlock language="bash">{`\
+pnpm rm xlsx`}
+</CodeBlock>
+  </TabItem>
+  <TabItem value="yarn" label="Yarn" default>
+<CodeBlock language="bash">{`\
+yarn remove xlsx`}
+</CodeBlock>
+  </TabItem>
+</Tabs>
+
 <p>1) Download the tarball (<code parentName="pre">xlsx-{current}.tgz</code>) for the desired version. The current
    version is available at <a href={`https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}>https://cdn.sheetjs.com/xlsx-{current}/xlsx-{current}.tgz</a></p>
 
@@ -135,7 +158,7 @@ npm i --save file:vendor/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install file:vendor/xlsx-${current}.tgz`}
+pnpm install --save file:vendor/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/02-getting-started/01-installation/07-bun.md b/docz/docs/02-getting-started/01-installation/07-bun.md
index 4d6f00d..3b1151d 100644
--- a/docz/docs/02-getting-started/01-installation/07-bun.md
+++ b/docz/docs/02-getting-started/01-installation/07-bun.md
@@ -28,6 +28,7 @@ be reported to the Bun project for further diagnosis.
 Tarballs can be directly installed with `bun install`:
 
 <CodeBlock language="bash">{`\
+bun rm xlsx
 bun install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
 
@@ -43,6 +44,12 @@ new versions are released!
 
 For general stability, "vendoring" modules is the recommended approach:
 
+0) Remove any existing dependency on a project named `xlsx`:
+
+```bash
+bun rm xlsx
+```
+
 <p>1) Download the tarball (<code parentName="pre">xlsx-{current}.tgz</code>) for the desired version. The current
    version is available at <a href={`https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}>https://cdn.sheetjs.com/xlsx-{current}/xlsx-{current}.tgz</a></p>
 
diff --git a/docz/docs/03-demos/02-frontend/19-bundler/04-esbuild.md b/docz/docs/03-demos/02-frontend/19-bundler/04-esbuild.md
index 41b5859..889f4d3 100644
--- a/docz/docs/03-demos/02-frontend/19-bundler/04-esbuild.md
+++ b/docz/docs/03-demos/02-frontend/19-bundler/04-esbuild.md
@@ -99,7 +99,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
@@ -194,7 +194,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/02-frontend/19-bundler/05-webpack.md b/docz/docs/03-demos/02-frontend/19-bundler/05-webpack.md
index 109f17f..3313390 100644
--- a/docz/docs/03-demos/02-frontend/19-bundler/05-webpack.md
+++ b/docz/docs/03-demos/02-frontend/19-bundler/05-webpack.md
@@ -149,7 +149,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/02-frontend/19-bundler/09-browserify.md b/docz/docs/03-demos/02-frontend/19-bundler/09-browserify.md
index fe4c232..5b08f16 100644
--- a/docz/docs/03-demos/02-frontend/19-bundler/09-browserify.md
+++ b/docz/docs/03-demos/02-frontend/19-bundler/09-browserify.md
@@ -74,7 +74,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/02-frontend/19-bundler/14-rollup.md b/docz/docs/03-demos/02-frontend/19-bundler/14-rollup.md
index 34448ee..76fc4b5 100644
--- a/docz/docs/03-demos/02-frontend/19-bundler/14-rollup.md
+++ b/docz/docs/03-demos/02-frontend/19-bundler/14-rollup.md
@@ -76,17 +76,17 @@ npm init -y
 <Tabs groupId="pm">
   <TabItem value="npm" label="npm">
 <CodeBlock language="bash">{`\
-npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`} rollup@4.6.1 @rollup/plugin-node-resolve
+npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz rollup@4.6.1 @rollup/plugin-node-resolve`}
 </CodeBlock>
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`} rollup@4.6.1 @rollup/plugin-node-resolve
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz rollup@4.6.1 @rollup/plugin-node-resolve`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
 <CodeBlock language="bash">{`\
-yarn add https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`} rollup@4.6.1 @rollup/plugin-node-resolve
+yarn add https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz rollup@4.6.1 @rollup/plugin-node-resolve`}
 </CodeBlock>
   </TabItem>
 </Tabs>
diff --git a/docz/docs/03-demos/02-frontend/19-bundler/20-parcel.md b/docz/docs/03-demos/02-frontend/19-bundler/20-parcel.md
index 2e58022..4d21824 100644
--- a/docz/docs/03-demos/02-frontend/19-bundler/20-parcel.md
+++ b/docz/docs/03-demos/02-frontend/19-bundler/20-parcel.md
@@ -192,7 +192,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/02-frontend/19-bundler/21-swcpack.md b/docz/docs/03-demos/02-frontend/19-bundler/21-swcpack.md
index f2f755a..2e635ab 100644
--- a/docz/docs/03-demos/02-frontend/19-bundler/21-swcpack.md
+++ b/docz/docs/03-demos/02-frontend/19-bundler/21-swcpack.md
@@ -92,17 +92,17 @@ npm init -y
 <Tabs groupId="pm">
   <TabItem value="npm" label="npm">
 <CodeBlock language="bash">{`\
-npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`} regenerator-runtime @swc/cli @swc/core@1.2.246
+npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz regenerator-runtime @swc/cli @swc/core@1.2.246`}
 </CodeBlock>
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`} regenerator-runtime @swc/cli @swc/core@1.2.246
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz regenerator-runtime @swc/cli @swc/core@1.2.246`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
 <CodeBlock language="bash">{`\
-yarn add https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`} regenerator-runtime @swc/cli @swc/core@1.2.246
+yarn add https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz regenerator-runtime @swc/cli @swc/core@1.2.246`}
 </CodeBlock>
   </TabItem>
 </Tabs>
diff --git a/docz/docs/03-demos/02-frontend/19-bundler/index.md b/docz/docs/03-demos/02-frontend/19-bundler/index.md
index 3dc8f0c..b53cfde 100644
--- a/docz/docs/03-demos/02-frontend/19-bundler/index.md
+++ b/docz/docs/03-demos/02-frontend/19-bundler/index.md
@@ -75,7 +75,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
@@ -196,7 +196,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/03-net/04-email/11-pst.md b/docz/docs/03-demos/03-net/04-email/11-pst.md
index 333c017..9c509e6 100644
--- a/docz/docs/03-demos/03-net/04-email/11-pst.md
+++ b/docz/docs/03-demos/03-net/04-email/11-pst.md
@@ -221,7 +221,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz pst-ext
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz pst-extractor`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz pst-extractor`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/12-static/02-gatsbyjs.md b/docz/docs/03-demos/12-static/02-gatsbyjs.md
index 6a8f6d3..d35204c 100644
--- a/docz/docs/03-demos/12-static/02-gatsbyjs.md
+++ b/docz/docs/03-demos/12-static/02-gatsbyjs.md
@@ -114,8 +114,8 @@ npm i --save gatsby-transformer-excel gatsby-source-filesystem`}
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
 npx gatsby telemetry --disable
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz
-pnpm install gatsby-transformer-excel gatsby-source-filesystem`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz
+pnpm install --save gatsby-transformer-excel gatsby-source-filesystem`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/20-cli/09-nodesea.md b/docz/docs/03-demos/20-cli/09-nodesea.md
index 9421471..5625bb9 100644
--- a/docz/docs/03-demos/20-cli/09-nodesea.md
+++ b/docz/docs/03-demos/20-cli/09-nodesea.md
@@ -202,7 +202,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/03-demos/20-cli/index.md b/docz/docs/03-demos/20-cli/index.md
index 86ec1a2..723cf12 100644
--- a/docz/docs/03-demos/20-cli/index.md
+++ b/docz/docs/03-demos/20-cli/index.md
@@ -146,7 +146,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz exit-on
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz exit-on-epipe commander@2`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz exit-on-epipe commander@2`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>
diff --git a/docz/docs/index.md b/docz/docs/index.md
index b582b75..0513f6c 100644
--- a/docz/docs/index.md
+++ b/docz/docs/index.md
@@ -110,7 +110,7 @@ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 <CodeBlock language="bash">{`\
-pnpm install https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
+pnpm install --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz`}
 </CodeBlock>
   </TabItem>
   <TabItem value="yarn" label="Yarn" default>