Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sanity-io/pkg-utils
Simple utilities for modern npm packages.
https://github.com/sanity-io/pkg-utils
bundle npm package team-ecosystem utils
Last synced: 18 days ago
JSON representation
Simple utilities for modern npm packages.
- Host: GitHub
- URL: https://github.com/sanity-io/pkg-utils
- Owner: sanity-io
- License: mit
- Created: 2022-08-25T20:10:06.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-06T02:43:46.000Z (21 days ago)
- Last Synced: 2024-12-06T05:03:23.968Z (20 days ago)
- Topics: bundle, npm, package, team-ecosystem, utils
- Language: TypeScript
- Homepage:
- Size: 6.01 MB
- Stars: 24
- Watchers: 13
- Forks: 3
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# @sanity/pkg-utils
Simple utilities for modern [npm](https://www.npmjs.com/) packages.
```sh
npm install @sanity/pkg-utils -D
```
[](https://www.npmjs.com/package/@sanity/pkg-utils)
## Basic usage
```sh
# 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 `.js`, `.cjs`, or
`.mjs`).
```ts
// 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`
- 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](https://api-extractor.com/) (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