pkgprn 0.2.3 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # package-prune
 
-Prune `package.json` before publishing to npm. Removes `devDependencies`, strips unnecessary scripts, cleans up junk files, optimizes the `files` array, and optionally flattens dist directories — so your published package is lean and clean.
+Prune `package.json` before publishing to npm. Removes `devDependencies`, strips unnecessary scripts, cleans up junk files, optimizes the `files` array, and optionally flattens dist directories - so your published package is lean and clean.
 
 ## Installation
 
@@ -47,12 +47,12 @@ The tool reads the `package.json` in the current working directory, applies all
 
 By default, `pkgprn` performs the following steps:
 
-1. **Removes `devDependencies`** — Strips the entire `devDependencies` field from `package.json`.
-2. **Removes `packageManager`** — Strips the `packageManager` field.
-3. **Prunes scripts** — Removes scripts that are not relevant to package consumers (based on the selected [profile](#profiles)).
-4. **Removes junk files** — Deletes OS and editor artifacts (`.DS_Store`, `*.orig`, `.*.swp`, `._*`, etc.) from the package directory.
-5. **Optimizes the `files` array** — Collapses individual file entries into their parent directory when all files in that directory are already listed, and removes entries that npm always includes automatically (`package.json`, `README`, `LICENSE`).
-6. **Cleans up unlisted files** — Removes files and directories not covered by the `files` array, then drops the `files` field itself (since only the included files remain on disk).
+1. **Removes `devDependencies`** - Strips the entire `devDependencies` field from `package.json`.
+2. **Removes `packageManager`** - Strips the `packageManager` field.
+3. **Prunes scripts** - Removes scripts that are not relevant to package consumers (based on the selected [profile](#profiles)).
+4. **Removes junk files** - Deletes OS and editor artifacts (`.DS_Store`, `*.orig`, `.*.swp`, `._*`, etc.) from the package directory.
+5. **Optimizes the `files` array** - Collapses individual file entries into their parent directory when all files in that directory are already listed, and removes entries that npm always includes automatically (`package.json`, `README`, `LICENSE`).
+6. **Cleans up unlisted files** - Removes files and directories not covered by the `files` array, then drops the `files` field itself (since only the included files remain on disk).
 
 Additional optional features can be enabled via flags:
 
@@ -120,8 +120,9 @@ pkgprn --flatten dist,lib
 3. Moves all files to the root (preserving subdirectory structure relative to the dist directory).
 4. Removes the now-empty dist directory.
 5. Rewrites all path references in `package.json` to point to the new locations.
-6. Updates the `files` array.
-7. Cleans up any leftover export-map stub directories that only contain a `package.json`.
+6. **Adjusts sourcemap `sources` paths** (explicit directories only) - when `.map` files are moved, their `sources` entries are rewritten so they still resolve to the correct original files. This also handles cross-directory references (e.g. a `.d.ts.map` in `types/` pointing at files in `dist/`) and incorporates any `sourceRoot` into the individual source paths.
+7. Updates the `files` array.
+8. Cleans up any leftover export-map stub directories that only contain a `package.json`.
 
 ## Examples
 
@@ -193,9 +194,9 @@ await prunePkg(
 
 ### `prunePkg(pkg, options, logger)`
 
-- **`pkg`** — A mutable `package.json` object. Modified in place.
-- **`options`** — An options object matching the CLI flags.
-- **`logger`** — A logger instance (from [`@niceties/logger`](https://www.npmjs.com/package/@niceties/logger)).
+- **`pkg`** - A mutable `package.json` object. Modified in place.
+- **`options`** - An options object matching the CLI flags.
+- **`logger`** - A logger instance (from [`@niceties/logger`](https://www.npmjs.com/package/@niceties/logger)).
 
 ## Ignored Files
 

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["prunePkg","Logger"],"sources":["prune.js"],"sourcesContent":[null],"mappings":";;;;iBAmEsBA,QAAQA;aA/BUC,MAAMA","ignoreList":[]}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "pkgprn",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "license": "MIT",
   "author": "Konstantin Shutkin",
   "bin": "./index.js",
   "type": "module",
-  "types": "./types/index.d.ts",
+  "types": "./index.d.ts",
   "exports": {
     ".": {
-      "types": "./types/index.d.ts",
+      "types": "./index.d.ts",
       "default": "./prune.js"
     },
     "./package.json": "./package.json"

package/prune.js

@@ -356,16 +356,40 @@ async function flatten(pkg, flatten, logger) {
     const renamePromises = [];
     const newFiles = [];
 
+    /** @type {Map<string, string>} maps new path -> old path */
+    const movedFiles = new Map();
+
     for (const [, info] of distDirInfo) {
         for (const file of info.files) {
             const relativePath = path.relative(info.relativeDistDir, file);
             newFiles.push(relativePath);
+            movedFiles.set(relativePath, file);
             renamePromises.push(rename(file, relativePath));
         }
     }
 
     await Promise.all(renamePromises);
 
+    // adjust sourcemap paths for explicit flatten only
+    // (automatic flatten is safe because the common prefix is derived from package.json references)
+    if (typeof flatten === 'string') {
+        // build reverse map: normalized old path -> new path
+        // so we can fix sources that point to files which themselves moved
+        /** @type {Map<string, string>} */
+        const oldToNew = new Map();
+        for (const [newPath, oldPath] of movedFiles) {
+            oldToNew.set(path.normalize(oldPath), newPath);
+        }
+
+        const sourcemapFiles = newFiles.filter(f => f.endsWith('.map'));
+        for (const newMapPath of sourcemapFiles) {
+            const oldMapPath = movedFiles.get(newMapPath);
+            if (oldMapPath) {
+                await adjustSourcemapPaths(newMapPath, oldMapPath, oldToNew);
+            }
+        }
+    }
+
     // clean up empty source directories
     /** @type {string[]} */
     const cleanedDirs = [];
@@ -466,6 +490,51 @@ function cloneAndUpdate(pkg, updater) {
     return pkg;
 }
 
+/**
+ * Adjusts the `sources` (and `sourceRoot`) in a v3 sourcemap file after it has been moved.
+ * Resolves each source against the old location, then makes it relative to the new location.
+ * If a source target was itself moved during flatten, the new location is used instead.
+ * @param {string} newMapPath - The new path of the .map file (relative to project root).
+ * @param {string} oldMapPath - The old path of the .map file (relative to project root).
+ * @param {Map<string, string>} oldToNew - Map from normalized old file paths to their new paths.
+ */
+async function adjustSourcemapPaths(newMapPath, oldMapPath, oldToNew) {
+    const content = await readFile(newMapPath, 'utf8');
+
+    let map;
+    try {
+        map = JSON.parse(content);
+    } catch {
+        return; // not valid JSON, skip
+    }
+
+    if (map.version !== 3 || !Array.isArray(map.sources)) {
+        return;
+    }
+
+    const oldDir = path.dirname(oldMapPath) || '.';
+    const newDir = path.dirname(newMapPath) || '.';
+    const sourceRoot = map.sourceRoot || '';
+
+    map.sources = map.sources.map((/** @type {string} */ source) => {
+        // Resolve source against old map location (incorporating sourceRoot)
+        const resolved = path.normalize(path.join(oldDir, sourceRoot, source));
+        // If the resolved source was itself moved, use its new location
+        const effective = oldToNew.get(resolved) ?? resolved;
+        // Make relative to new map location
+        const newRelative = path.relative(newDir, effective);
+        // Sourcemaps always use forward slashes
+        return newRelative.split(path.sep).join('/');
+    });
+
+    // sourceRoot has been incorporated into the individual source paths
+    if (map.sourceRoot !== undefined) {
+        delete map.sourceRoot;
+    }
+
+    await writeFile(newMapPath, JSON.stringify(map), 'utf8');
+}
+
 /**
  * @param {string} parent
  * @param {string} child

package/types/index.d.ts.map

@@ -1,16 +0,0 @@
-{
-	"version": 3,
-	"file": "index.d.ts",
-	"names": [
-		"prunePkg",
-		"Logger"
-	],
-	"sources": [
-		"../prune.js"
-	],
-	"sourcesContent": [
-		null
-	],
-	"mappings": ";;;;iBAmEsBA,QAAQA;aA/BUC,MAAMA",
-	"ignoreList": []
-}