feat(command): return result of run command

[mandarini]

❓ Type of change

• 📖 Documentation (updates to the documentation, readme, or JSdoc annotations)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Changes

This will return the result of the run function of the command being executed.

Why is this needed?

Sometimes a command may return some output or something. It would be nice to be able to get this result.
Please see this related PR I submitted to the Nuxt nuxi CLI. They are using runCommand from citty here: https://github.com/nuxt/cli/blob/3401917c1852918171e23013d6522bda31762e5d/src/run.ts#L33

And they are returning the result or runCommand like this:

return await _runCommand(await commands[name as keyof typeof commands](),

now, if the command they are calling/running returns something, it would be lost, since runCommand does not return anything as it is.

I hope this change makes sense. We need it in Nx, but in any case I think it could benefit others as well.

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[pi0]

For the forward compatibility, we might return { result: unknown } object format

[mandarini]

@pi0 made the change you requested! Thanks!

[pi0]

Thanks! Made minor changes to always preserve { result } returned value