feat: _yargs esm helper

Author: kirillgroshkov

package.json

@@ -23,6 +23,7 @@
     "@naturalcycles/js-lib": "^14",
     "@types/js-yaml": "^4",
     "@types/jsonwebtoken": "^9",
+    "@types/yargs": "^16",
     "ajv": "^8",
     "ajv-formats": "^3",
     "ajv-keywords": "^5",
@@ -41,7 +42,6 @@
     "@naturalcycles/dev-lib": "^16",
     "@types/node": "^22",
     "@types/through2-concurrent": "^2",
-    "@types/yargs": "^16",
     "@vitest/coverage-v8": "^3",
     "tsx": "^4",
     "vitest": "^3"

src/index.ts

@@ -82,6 +82,7 @@ export * from './validation/joi/joi.shared.schemas'
 export * from './validation/joi/joi.validation.error'
 export * from './validation/joi/joi.validation.util'
 export type { StringSchema } from './validation/joi/string.extensions'
+export * from './yargs.util'
 
 export type {
   AlternativesSchema,

src/yargs.util.test.ts

@@ -0,0 +1,6 @@
+import { expect, test } from 'vitest'
+import { _yargs } from './yargs.util'
+
+test('_yargs', () => {
+  expect(typeof _yargs().options).toBe('function')
+})

src/yargs.util.ts

@@ -0,0 +1,11 @@
+import yargs from 'yargs'
+import { hideBin } from 'yargs/helpers'
+
+/**
+ * Quick yargs helper to make it work in esm.
+ * It also allows to not have yargs and `@types/yargs` to be declared as dependencies.
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function _yargs() {
+  return yargs(hideBin(process.argv))
+}