@sanity/pkg-utils

Simple utilities for modern npm packages.

npm install @sanity/pkg-utils -D

Basic usage

# Initialize a new package
pnpx @sanity/pkg-utils@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

@sanity/pkg-utils 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 .mts, .js, or .mjs).

// package.config.ts

import {defineConfig} from '@sanity/pkg-utils'

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',
})

Options

`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<string, string | number | boolean | null | undefined>
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<PkgExports>
Default: the value of "exports" in package.json

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

`extract`

Type:

{
  rules?: {
    '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.

`minify`

Type: boolean
Default: false

Whether to minify the bundled JavaScript.

`rollup.plugins`

Type: PkgConfigProperty<RollupPlugin[]>
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

License

sanity-io/pkg-utils

About

Topics

Resources

License

Code of conduct

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 409

Uh oh!

Contributors 17

Languages