@gjsify/cli 0.4.24 → 0.4.26

package/lib/commands/install.js

@@ -121,12 +121,33 @@ function depKindFromArgs(args) {
 async function projectInstallNative(args) {
     const cwd = process.cwd();
     const pkgPath = join(cwd, 'package.json');
-    // Yarn-Berry / PnP detection: fall back to yarn with a clear warning
-    // rather than producing a half-working node_modules tree.
-    if (existsSync(join(cwd, '.pnp.cjs')) || existsSync(join(cwd, '.pnp.loader.mjs'))) {
-        throw new Error('gjsify install: detected Yarn PnP (.pnp.cjs) — native install is ' +
-            'not PnP-aware yet. Use `yarn install` or set ' +
-            'GJSIFY_INSTALL_BACKEND=npm.');
+    // gjsify install is a node_modules-linker installer (like `npm install`
+    // or `yarn --nodeLinker node-modules`): it materialises a node_modules/
+    // tree + gjsify-lock.json. It deliberately does NOT produce a Yarn PnP
+    // install, and the two resolution strategies cannot coexist — a leftover
+    // `.pnp.cjs` makes Node ignore the node_modules/ tree we write, leaving a
+    // silently broken project.
+    //
+    // Native PnP *generation* (a byte-identical `.pnp.cjs` + `.yarn/cache/*.zip`
+    // that yarn itself would accept) is intentionally out of scope: it would
+    // mean replicating yarn's libzip-deterministic archives, SHA-512 cache
+    // keys, cache-version tracking and virtual-locator synthesis, and would
+    // only ever match a single yarn release. So we stop here with actionable
+    // guidance instead of half-doing it.
+    //
+    // We do NOT point users at `GJSIFY_INSTALL_BACKEND=npm` from this error:
+    // that backend chokes on `workspace:` specs (`EUNSUPPORTEDPROTOCOL`),
+    // which is exactly what the workspace repos that reach this branch have.
+    const pnpResidue = ['.pnp.cjs', '.pnp.loader.mjs'].filter((f) => existsSync(join(cwd, f)));
+    if (pnpResidue.length > 0) {
+        throw new Error(`gjsify install uses the node_modules linker and cannot run in a Yarn PnP ` +
+            `project (found ${pnpResidue.join(', ')} in ${cwd}).\n\n` +
+            `• If this project uses \`gjsify install\` to manage dependencies, these PnP ` +
+            `files are stale residue from an earlier \`yarn install\` — remove them and re-run:\n` +
+            `      rm -f .pnp.cjs .pnp.loader.mjs && rm -rf .yarn/cache .yarn/unplugged\n` +
+            `      gjsify install\n\n` +
+            `• If instead you want Yarn to manage dependencies, set \`nodeLinker: node-modules\` ` +
+            `in .yarnrc.yml and run \`yarn install\` (not \`gjsify install\`).`);
     }
     // Workspace install (no args, root pkg.json has `workspaces`).
     // Project-local `gjsify install <pkg>` inside a workspace child still

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/cli",
-    "version": "0.4.24",
+    "version": "0.4.26",
     "description": "CLI for Gjsify",
     "type": "module",
     "main": "lib/index.js",
@@ -120,18 +120,18 @@
         "cli"
     ],
     "dependencies": {
-        "@gjsify/buffer": "^0.4.24",
-        "@gjsify/create-app": "^0.4.24",
-        "@gjsify/node-globals": "^0.4.24",
-        "@gjsify/node-polyfills": "^0.4.24",
-        "@gjsify/npm-registry": "^0.4.24",
-        "@gjsify/resolve-npm": "^0.4.24",
-        "@gjsify/rolldown-plugin-gjsify": "^0.4.24",
-        "@gjsify/rolldown-plugin-pnp": "^0.4.24",
-        "@gjsify/semver": "^0.4.24",
-        "@gjsify/tar": "^0.4.24",
-        "@gjsify/web-polyfills": "^0.4.24",
-        "@gjsify/workspace": "^0.4.24",
+        "@gjsify/buffer": "^0.4.26",
+        "@gjsify/create-app": "^0.4.26",
+        "@gjsify/node-globals": "^0.4.26",
+        "@gjsify/node-polyfills": "^0.4.26",
+        "@gjsify/npm-registry": "^0.4.26",
+        "@gjsify/resolve-npm": "^0.4.26",
+        "@gjsify/rolldown-plugin-gjsify": "^0.4.26",
+        "@gjsify/rolldown-plugin-pnp": "^0.4.26",
+        "@gjsify/semver": "^0.4.26",
+        "@gjsify/tar": "^0.4.26",
+        "@gjsify/web-polyfills": "^0.4.26",
+        "@gjsify/workspace": "^0.4.26",
         "cosmiconfig": "^9.0.1",
         "get-tsconfig": "^4.14.0",
         "pkg-types": "^2.3.1",
@@ -139,12 +139,12 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/unit": "^0.4.24",
+        "@gjsify/unit": "^0.4.26",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"
     },
     "peerDependencies": {
-        "@gjsify/rolldown-native": "^0.4.24"
+        "@gjsify/rolldown-native": "^0.4.26"
     },
     "peerDependenciesMeta": {
         "@gjsify/rolldown-native": {