feat: add new options

[ivodolenc]

Type of Change

• New feature
• Documentation
• Tests

Request Description

New Options

defaults

Specifies an object of defaults that will be added to the parsed output regardless of CLI inputs.

• Type: (Record<string, unknown> & { _?: string[] }) | undefined
• Default: undefined

import { createArgs } from '@hypernym/args'

createArgs({
  defaults: {
    _: ['value'],
    a: true,
  },
})

exclude

Specifies an array of values that will be skipped when parsing arguments.

• Type: string[] | undefined
• Default: undefined

import { createArgs } from '@hypernym/args'

createArgs({
  exclude: ['arg', '--flag', '-alias'],
})

Supports the ability to add values ​​using the = sign

$ --flag=value

# => { _: [], flag: 'value', }

$ -alias=value

# => { _: [], alias: 'value', }

Additional Details

• Improves performance
• Improves types and examples
• Adds tests