@p8ec/shared 3.0.0 → 3.0.3

package/README.md

@@ -69,3 +69,5 @@ p8-cli [command] [options]
     - Example: `p8-cli run build` - returns the `build` script using the detected package manager.
     - Example: `p8-cli run test auto par` - returns the `test` script using the detected
       package manager in parallel mode for workspaces.
+- `pm` - Returns the detected package manager (`npm`, `yarn`, or `pnpm`).
+- `ws` - Returns `true` if the project is a workspace, `false` otherwise.

package/dist/assets/lefthook.yml

@@ -7,10 +7,34 @@ pre-commit:
   commands:
     git:
       run: |
-          if [[ $(git rev-parse --abbrev-ref HEAD) =~ ^(main|master|release)$ ]]; then
-            echo "Direct commits to main, master, and release branches are not allowed."
-            exit 1
+        if [[ $(git rev-parse --abbrev-ref HEAD) =~ ^(main|master|release)$ ]]; then
+          # Allow direct commits on protected branches ONLY if the staged changes are package.json
+          STAGED_FILES=$(git diff --cached --name-only)
+        
+          if [[ -z "$STAGED_FILES" ]]; then
+            exit 0
           fi
+        
+          ALLOWED_FILES=${ALLOWED_FILES:-"package.json"}
+          IFS=',' read -r -a ALLOWED_ARRAY <<< "$ALLOWED_FILES"
+        
+          # Check every staged file; if any differs from the allowed files, block the commit
+          for f in $STAGED_FILES; do
+            MATCHED=false
+            for allowed in "${ALLOWED_ARRAY[@]}"; do
+              if [[ "$f" == "$allowed" || "$f" == */"$allowed" ]]; then
+                MATCHED=true
+                break
+              fi
+            done
+        
+            if [[ "$MATCHED" == "false" ]]; then
+              echo "Direct commits to main, master, and release branches are not allowed, except for: $ALLOWED_FILES"
+              exit 1
+            fi
+          done
+        fi
+
 
 ### Commit message hook ###
 # 1. Allow only commit messages that follow a conventional commit format

package/dist/cjs/bin/cmds/init.js

@@ -75,28 +75,38 @@ exports.initCleanup = initCleanup;
 /**
  * Initializes a TypeScript project with P8 shared configurations.
  */
-const init = (option_1, ...args_1) => __awaiter(void 0, [option_1, ...args_1], void 0, function* (option, packageManager = (0, detect_1.detectPackageManager)()) {
-    var _a;
+const init = (option_1, ...args_1) => __awaiter(void 0, [option_1, ...args_1], void 0, function* (option, pm = 'auto') {
     const packageJsonData = fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8');
     const packageJson = JSON.parse(packageJsonData);
     const moduleType = packageJson['type'] === 'module' ? 'mjs' : 'cjs';
+    const packageManager = pm === 'auto' ? (0, detect_1.detectPackageManager)() : pm;
     writeLn(`Creating eslint.config.${moduleType}...`);
     p8_shared_cli_1.cliUtils.copyAsset(`eslint.config.${moduleType}`);
     writeLn(`Creating prettier.config.${moduleType}...`);
     p8_shared_cli_1.cliUtils.copyAsset(`prettier.config.${moduleType}`);
-    (_a = packageJson.scripts) !== null && _a !== void 0 ? _a : (packageJson.scripts = {});
-    packageJson.scripts[`${packageManager}:reset`] =
-        packageManager === 'pnpm'
-            ? 'rm -rf ./**/node_modules && rm -rf ./**/pnpm-lock.yaml && pnpm install'
-            : packageManager === 'yarn'
-                ? 'rm -rf ./**/node_modules && rm -rf ./**/yarn.lock && yarn install'
-                : 'rm -rf ./**/node_modules && rm -rf ./**/package-lock.json && npm install';
-    packageJson.scripts[`${packageManager}:audit`] =
-        packageManager === 'pnpm'
-            ? 'pnpm audit'
-            : packageManager === 'yarn'
-                ? 'yarn npm audit'
-                : 'npm audit --audit-level=moderate';
+    const scripts = [
+        {
+            name: 'reset',
+            command: {
+                pnpm: 'rm -rf ./**/node_modules && rm -rf ./**/pnpm-lock.yaml && pnpm install',
+                yarn: 'rm -rf ./**/node_modules && rm -rf ./**/yarn.lock && yarn install',
+                npm: 'rm -rf ./**/node_modules && rm -rf ./**/package-lock.json && npm install',
+            },
+        },
+        {
+            name: 'audit',
+            command: {
+                pnpm: 'pnpm audit',
+                yarn: 'yarn npm audit',
+                npm: 'npm audit --audit-level=moderate',
+            },
+        },
+    ];
+    scripts.forEach((script) => {
+        var _a;
+        (_a = packageJson.scripts) !== null && _a !== void 0 ? _a : (packageJson.scripts = {});
+        packageJson.scripts[`${packageManager}:${script.name}`] = script.command[packageManager];
+    });
     const lefthook = yield (0, yesno_1.default)({
         question: 'Do you want to use commitlint/lefthook? [y]n',
         defaultValue: true,

package/dist/cjs/bin/cmds/root.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * 2026 Copyright P8 Enterprise Components, Inc.
+ * All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.root = void 0;
+const detect_1 = require("../utils/detect");
+/**
+ * Returns the root directory of the project.
+ */
+const root = (cwd = process.cwd()) => {
+    return (0, detect_1.detectRoot)(cwd);
+};
+exports.root = root;

package/dist/cjs/bin/p8-shared-cli.js

@@ -50,7 +50,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cliUtils = exports.IS_DEV = exports.detectWorkspace = exports.detectPackageManager = exports.run = exports.dirn = exports.initCleanup = exports.init = void 0;
+exports.main = exports.cliUtils = exports.IS_DEV = exports.detectWorkspace = exports.detectPackageManager = exports.root = exports.run = exports.dirn = exports.initCleanup = exports.init = void 0;
 /**
  * P8 Shared CLI tool.
  *
@@ -70,20 +70,27 @@ const dirn_1 = require("./cmds/dirn");
 Object.defineProperty(exports, "dirn", { enumerable: true, get: function () { return dirn_1.dirn; } });
 const run_1 = require("./cmds/run");
 Object.defineProperty(exports, "run", { enumerable: true, get: function () { return run_1.run; } });
+const root_1 = require("./cmds/root");
+Object.defineProperty(exports, "root", { enumerable: true, get: function () { return root_1.root; } });
 const detect_1 = require("./utils/detect");
 Object.defineProperty(exports, "detectPackageManager", { enumerable: true, get: function () { return detect_1.detectPackageManager; } });
 Object.defineProperty(exports, "detectWorkspace", { enumerable: true, get: function () { return detect_1.detectWorkspace; } });
 exports.IS_DEV = process.env.NODE_ENV === 'development';
 let args = ferramenta_1.processArgs.args;
 const self = path.parse(ferramenta_1.processArgs.name).name;
-const writeLn = console.log;
+const writeLn = (...args) => {
+    console.log(...args);
+};
 exports.cliUtils = {
-    execShell: (command) => exports.IS_DEV ? writeLn(`DEV: execShell ${command}`) : child_process.execSync(command).toString(),
+    writeLn: (...args) => {
+        writeLn(...args);
+    },
+    execShell: (command) => exports.IS_DEV ? exports.cliUtils.writeLn(`DEV: execShell ${command}`) : child_process.execSync(command).toString(),
     writeFile: (name, data) => exports.IS_DEV
-        ? writeLn(`DEV: writeFile name=${name} data=${data}`)
+        ? console.log(`DEV: writeFile name=${name} data=${data}`)
         : fs.writeFileSync(path.join(process.cwd(), name), data),
     copyAsset: (name) => exports.IS_DEV
-        ? writeLn(`DEV: copyAsset name=${name}`)
+        ? console.log(`DEV: copyAsset name=${name}`)
         : fs.copyFileSync(path.join(__dirname, '..', '..', 'assets', name), path.join(process.cwd(), name)),
 };
 if (args.length === 0 && !exports.IS_DEV && require.main === module) {
@@ -104,37 +111,56 @@ Commands:
 			Arguments:
 				script: The script to run.
 			Options:
-				-p {value}, --packageManager={value}: The package manager to use, where {value} is one of 'npm', 'pnpm', 'yarn', or 'auto'.
-				-w {value}, --workspaceMode={value}: The workspace mode to use, where {value} is one of 'none', 'seq', 'par', or 'auto'.
+				-p {value}, --packageManager={value}: The package manager to use, where {value} is one of 'npm', 'pnpm', 'yarn', or 'auto' (defaults to 'auto').
+				-w {value}, --workspaceMode={value}: The workspace mode to use, where {value} is one of 'none', 'seq', 'par', or 'auto' (defaults to 'auto').
+	root
+		Returns path to the root of the repo.
+	pm
+		Returns the detected package manager.
+	ws
+		Returns true or false for detected workspace.
 `);
     if (exports.IS_DEV) {
         writeLn(`DEVELOPMENT MODE`);
     }
     process.exit(1);
 }
-const main = () => __awaiter(void 0, void 0, void 0, function* () {
+const main = (customArgs) => __awaiter(void 0, void 0, void 0, function* () {
     // Ask the user for arguments if IS_DEV is true
-    if (exports.IS_DEV) {
+    if (exports.IS_DEV && !customArgs) {
         args = (yield (0, prompt_1.default)('Enter arguments:')).split(' ');
     }
+    else if (customArgs) {
+        args = customArgs;
+    }
     const parsed = (0, args_1.default)(args);
     switch (parsed.command) {
         case 'init':
             yield (0, init_1.init)(parsed.positional[0] || (parsed.options.cleanup ? 'cleanup' : ''));
             break;
         case 'dirn':
-            writeLn((0, dirn_1.dirn)(parsed.positional[0]));
+            exports.cliUtils.writeLn((0, dirn_1.dirn)(parsed.positional[0]));
             break;
         case 'run':
-            writeLn((0, run_1.run)(parsed.positional[0], (parsed.positional[1] || parsed.options.p || parsed.options.packageManager), (parsed.positional[2] || parsed.options.w || parsed.options.workspaceMode)));
+            exports.cliUtils.writeLn((0, run_1.run)(parsed.positional[0], (parsed.positional[1] || parsed.options.p || parsed.options.packageManager), (parsed.positional[2] || parsed.options.w || parsed.options.workspaceMode)));
+            break;
+        case 'root':
+            exports.cliUtils.writeLn((0, root_1.root)());
+            break;
+        case 'pm':
+            exports.cliUtils.writeLn((0, detect_1.detectPackageManager)());
+            break;
+        case 'ws':
+            exports.cliUtils.writeLn((0, detect_1.detectWorkspace)());
             break;
         default:
             console.error(`Unknown command: ${parsed.command}`);
             process.exit(1);
     }
 });
+exports.main = main;
 if (require.main === module) {
-    main()
+    (0, exports.main)()
         .then((r) => {
         if (exports.IS_DEV) {
             writeLn(`DEV: setup completed successfully with result: ${JSON.stringify(r)}`);

package/dist/cjs/bin/utils/detect.js

@@ -37,17 +37,53 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectWorkspace = exports.detectPackageManager = void 0;
+exports.detectWorkspace = exports.detectPackageManager = exports.detectRoot = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
+/**
+ * Finds the TOPMOST directory containing package.json
+ * by walking up the directory tree.
+ * @param startDir Directory to start from (defaults to cwd)
+ * @returns Absolute path to monorepo root, or null if none found
+ */
+const detectRoot = (startDir = process.cwd()) => {
+    let currentDir = path.resolve(startDir);
+    // Avoid symlink loops
+    try {
+        currentDir = fs.realpathSync(currentDir);
+    }
+    catch (_a) {
+        // ignore
+    }
+    let lastMatch = startDir;
+    while (true) {
+        const pkgPath = path.join(currentDir, 'package.json');
+        try {
+            if (fs.existsSync(pkgPath)) {
+                lastMatch = currentDir;
+            }
+        }
+        catch (_b) {
+            // ignore fs errors and continue walking up
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break; // filesystem root reached
+        }
+        currentDir = parentDir;
+    }
+    return lastMatch;
+};
+exports.detectRoot = detectRoot;
 /**
  * Detects the package manager used in the project.
  */
 const detectPackageManager = (cwd = process.cwd()) => {
-    if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml'))) {
+    const root = (0, exports.detectRoot)(cwd);
+    if (fs.existsSync(path.join(root, 'pnpm-lock.yaml'))) {
         return 'pnpm';
     }
-    if (fs.existsSync(path.join(cwd, 'yarn.lock'))) {
+    if (fs.existsSync(path.join(root, 'yarn.lock'))) {
         return 'yarn';
     }
     return 'npm';
@@ -57,10 +93,11 @@ exports.detectPackageManager = detectPackageManager;
  * Detects if the project is a workspace.
  */
 const detectWorkspace = (cwd = process.cwd()) => {
-    if (fs.existsSync(path.join(cwd, 'pnpm-workspace.yaml'))) {
+    const root = (0, exports.detectRoot)(cwd);
+    if (fs.existsSync(path.join(root, 'pnpm-workspace.yaml'))) {
         return true;
     }
-    const packageJsonPath = path.join(cwd, 'package.json');
+    const packageJsonPath = path.join(root, 'package.json');
     if (fs.existsSync(packageJsonPath)) {
         try {
             const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@p8ec/shared",
-	"version": "3.0.0",
+	"version": "3.0.3",
 	"description": "P(8) Global Shared Library for Javascript",
 	"repository": {
 		"type": "git",