@macrulez/devtoolz 0.1.0 → 0.2.0

package/dist/utils/workspace.d.ts

@@ -0,0 +1,14 @@
+export interface WorkspacePackage {
+    name: string;
+    rootDir: string;
+    packageJson: Record<string, unknown>;
+}
+export interface WorkspaceInfo {
+    root: string;
+    packages: WorkspacePackage[];
+}
+/**
+ * Walks up from `startDir` looking for a pnpm/npm/yarn workspace root.
+ * Returns `null` if none is found — a plain single-package project.
+ */
+export declare function detectWorkspace(startDir: string): WorkspaceInfo | null;

package/dist/utils/workspace.js

@@ -0,0 +1,101 @@
+// Detects a pnpm/npm/yarn workspace so a sibling package's import of
+// another package's export (e.g. `@macrulez/inview-vue` importing from
+// `@macrulez/inview-core`, as it really does) doesn't read as a false
+// "dead export" just because the reference lives in a different package
+// directory than the one being checked — the exact case features.md's
+// contract calls out. Shared by every command that needs to reason about
+// a package relative to its workspace (dead-exports, unused-deps) — not
+// specific to either one.
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+function readPackageJson(dir) {
+    try {
+        return JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// Only the one shape pnpm-workspace.yaml realistically uses in practice —
+// a top-level `packages:` key followed by `- 'glob'` list items. Not a
+// general YAML parser; anything fancier (anchors, nested maps) isn't
+// recognized and the file is treated as if it weren't there.
+function parsePnpmWorkspaceYaml(text) {
+    const lines = text.split('\n');
+    const globs = [];
+    let inPackages = false;
+    for (const line of lines) {
+        if (/^packages:\s*$/.test(line)) {
+            inPackages = true;
+            continue;
+        }
+        if (inPackages) {
+            const item = line.match(/^\s*-\s*['"]?([^'"#]+)['"]?\s*(#.*)?$/);
+            if (item) {
+                globs.push(item[1].trim());
+                continue;
+            }
+            if (/^\S/.test(line))
+                break; // dedented past the packages: block
+        }
+    }
+    return globs;
+}
+function expandGlob(root, glob) {
+    // Only "dir/*" (one trailing wildcard segment) is supported — the
+    // overwhelming common case for a workspace's packages list. A glob
+    // without a wildcard is just a literal directory.
+    if (!glob.includes('*')) {
+        const dir = resolve(root, glob);
+        return existsSync(dir) && statSync(dir).isDirectory() ? [dir] : [];
+    }
+    const starIndex = glob.indexOf('*');
+    const prefix = glob.slice(0, starIndex).replace(/\/$/, '');
+    const parentDir = resolve(root, prefix);
+    if (!existsSync(parentDir))
+        return [];
+    return readdirSync(parentDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => join(parentDir, e.name));
+}
+function packagesFromGlobs(root, globs) {
+    const packages = [];
+    for (const glob of globs) {
+        for (const dir of expandGlob(root, glob)) {
+            const pkgJson = readPackageJson(dir);
+            const name = pkgJson && typeof pkgJson.name === 'string' ? pkgJson.name : null;
+            if (pkgJson && name)
+                packages.push({ name, rootDir: dir, packageJson: pkgJson });
+        }
+    }
+    return packages;
+}
+/**
+ * Walks up from `startDir` looking for a pnpm/npm/yarn workspace root.
+ * Returns `null` if none is found — a plain single-package project.
+ */
+export function detectWorkspace(startDir) {
+    let dir = resolve(startDir);
+    for (;;) {
+        const pnpmWorkspacePath = join(dir, 'pnpm-workspace.yaml');
+        if (existsSync(pnpmWorkspacePath)) {
+            const globs = parsePnpmWorkspaceYaml(readFileSync(pnpmWorkspacePath, 'utf8'));
+            return { root: dir, packages: packagesFromGlobs(dir, globs) };
+        }
+        const pkgJson = readPackageJson(dir);
+        if (pkgJson?.workspaces) {
+            const raw = pkgJson.workspaces;
+            const globs = Array.isArray(raw)
+                ? raw.filter((g) => typeof g === 'string')
+                : Array.isArray(raw?.packages)
+                    ? raw.packages.filter((g) => typeof g === 'string')
+                    : [];
+            return { root: dir, packages: packagesFromGlobs(dir, globs) };
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/utils/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/utils/workspace.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@macrulez/devtoolz",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A small toolbox of CLI commands that automate routine dev chores — strip comments/console.log, find dead exports, catch case-sensitivity import bugs before Linux CI does",
   "type": "module",
   "license": "MIT",