@a-2-c-2-anpm/aspernatur-beatae-magni

Simple utilities for modern npm packages.

``sh
npm install @a-2-c-2-anpm/aspernatur-beatae-magni -D
`

![npm version](https://www.npmjs.com/package/@a-2-c-2-anpm/aspernatur-beatae-magni)

Basic usage

`sh


Initialize a new package

pnpx @a-2-c-2-anpm/aspernatur-beatae-magni@latest init my-package

In a Node.js package directory with package.json present

Check the package

pkg-utils check

Build the package

pkg-utils build

Watch the package

pkg-utils watch
`

Run pkg-utils -h for more information on CLI usage.

Configuration

@a-2-c-2-anpm/aspernatur-beatae-magni reads most of its configuration from package.json. But sometimes you need more
control. You may then add a configuration file named package.config.ts (or .js, .cjs, or
.mjs).

`ts
// package.config.ts

import {defineConfig} from '@a-2-c-2-anpm/aspernatur-beatae-magni'

export default defineConfig({
extract: {
rules: {
// do not require internal members to be prefixed with _
'ae-internal-missing-underscore': 'off',
},
},

// the path to the tsconfig file for distributed builds
tsconfig: 'tsconfig.dist.json',
})
`

$3

#### bundles

- Type: PkgBundle[]
- Default: undefined

An array of entry points to bundle. This is useful if you want to bundle something that should not
be exported by the package, e.g. CLI scripts or Node.js workers.

#### define

- Type: Record
- Default: {}

An object defining globals within the package.

#### dist

- Type: string
- Default: './dist'

The path to the directory to which bundle and chunk files should be written.

#### exports

- Type: PkgConfigProperty
- Default: the value of "exports" in package.json

Override or modify the value of the exports before it’s parsed internally.

#### extract

- Type:
`ts
{
rules?: {
'ae-forgotten-export'?: PkgRuleLevel
'ae-incompatible-release-tags'?: PkgRuleLevel
'ae-internal-missing-underscore'?: PkgRuleLevel
'ae-missing-release-tag'?: PkgRuleLevel
}
}
`
- Default: undefined

Configure the level of reporting of API Extractor (which is used to bundle the
type definitions, as well as lint the TSDoc of the package).

#### external

- Type: string[]
- Default: []

Packages to exclude from bundles.

#### jsx

- Type: 'transform' | 'preserve' | 'automatic'
- Default: 'automatic'

Strategy for bundling JSX.

#### jsxFactory

- Type: string
- Default: 'createElement'

The name of the function that creates JSX elements.

#### jsxFragment

- Type: string
- Default: 'Fragment'

The name of JSX fragment elements.

#### jsxImportSource

- Type: string
- Default: 'react'

The name of the library from which to import JSX factory and fragment names.

#### legacyExports

- Type: boolean
- Default: false

Build package with support for legacy exports (writes root .js files). Use this if you
need to support older bundlers.

#### minify

- Type: boolean
- Default: false

Whether to minify the bundled JavaScript.

#### rollup.plugins

- Type: PkgConfigProperty
- Default: []

Rollup plugins to load when bundling.

#### runtime

- Type: '*' | 'browser' | 'node'
- Default: '*'

Default runtime of package exports

#### sourcemap

- Type: boolean
- Default: true

Whether to include source map files.

#### src

- Type: string
- Default: './src'

The path to the directory in which source code is located.

#### tsconfig

- Type: string
- Default: 'tsconfig.json'`

The path to the TypeScript configuration file.

License

MIT