\n \n Daniel Bannert's open source work is supported by the community on GitHub Sponsors\n \n
\n
\n\n---\n\n## Why?\n\nWhen publishing packages to npm, many properties in `package.json` are only needed during development and build time, but not in the published package. This plugin automatically removes unnecessary properties while preserving essential ones needed for the package to work correctly in production.\n\nKey benefits:\n\n- Reduces package size by removing development-only properties\n- Prevents leaking internal configuration and metadata\n- Maintains a clean and focused package.json for end users\n- Customizable property preservation through configuration\n\n## Install\n\n```sh\nnpm install @anolilab/semantic-release-clean-package-json\n```\n\n```sh\nyarn add @anolilab/semantic-release-clean-package-json\n```\n\n```sh\npnpm add @anolilab/semantic-release-clean-package-json\n```\n\n## Usage\n\nThe plugin can be configured in the [**semantic-release** configuration file](https://github.com/semantic-release/semantic-release/blob/master/docs/usage/configuration.md#configuration):\n\n> [!IMPORTANT]\n> Very important: The plugin must be placed before the `@semantic-release/github` or `@semantic-release/git` and before `@anolilab/semantic-release-pnpm` or `@semantic-release/npm` plugin otherwise the `package.json` will be cleaned and published into GitHub / Your Git Provider.\n\n```json\n{\n \"plugins\": [\n \"@semantic-release/commit-analyzer\",\n \"@semantic-release/release-notes-generator\",\n \"@anolilab/semantic-release-clean-package-json\",\n \"@anolilab/semantic-release-pnpm\",\n \"@semantic-release/github\"\n ]\n}\n```\n\n## Steps that are used\n\n| Step | Description |\n| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `publish` | - Creates a backup of the original package.json file - Removes all non-preserved properties from package.json - Keeps properties specified in the default list and custom `keep` option - Preserves specific npm scripts if they are in the keep list - Writes the cleaned package.json file |\n| `success` | - Restores the original package.json from backup - Updates the version number to match the released version - Removes the backup file - Logs success or error messages |\n\n### Options\n\n| Options | Description | Default |\n| --------- | -------------------------- | ------- |\n| `pkgRoot` | Directory path to publish. | `.` |\n| `keep` | Property names to keep. | `[]` |\n\n**Note**: The `pkgRoot` directory must contain a `package.json`. The version will be updated only in the `package.json` and `npm-shrinkwrap.json` within the `pkgRoot` directory.\n\n**Note**: If you use a [shareable configuration](https://github.com/semantic-release/semantic-release/blob/master/docs/usage/shareable-configurations.md#shareable-configurations) that defines one of these options you can set it to `false` in your [**semantic-release** configuration](https://github.com/semantic-release/semantic-release/blob/master/docs/usage/configuration.md#configuration) in order to use the default value.\n\n### Examples\n\nThe plugin can be configured with custom properties to keep in addition to the default preserved ones:\n\n```json\n{\n \"plugins\": [\n \"@semantic-release/commit-analyzer\",\n \"@semantic-release/release-notes-generator\",\n [\n \"@anolilab/semantic-release-clean-package-json\",\n {\n \"keep\": [\"custom field\"]\n }\n ],\n \"@anolilab/semantic-release-pnpm\",\n \"@semantic-release/github\"\n ]\n}\n```\n\n#### Example: Publishing a TypeScript Package\n\nWhen publishing a TypeScript package, you might want to keep TypeScript-specific fields:\n\n```jsonc\n{\n \"plugins\": [\n \"@semantic-release/commit-analyzer\",\n \"@semantic-release/release-notes-generator\",\n [\n \"@anolilab/semantic-release-clean-package-json\",\n {\n // This are the default values, just a example\n \"keep\": [\"types\", \"typings\", \"typesVersions\", \"module\"],\n },\n ],\n \"@anolilab/semantic-release-pnpm\",\n \"@semantic-release/github\",\n ],\n}\n```\n\n#### Example: Custom Package Root\n\nIf your package.json is not in the root directory:\n\n```json\n{\n \"plugins\": [\n \"@semantic-release/commit-analyzer\",\n \"@semantic-release/release-notes-generator\",\n \"@semantic-release/github\",\n [\n \"@anolilab/semantic-release-clean-package-json\",\n {\n \"pkgRoot\": \"dist\"\n }\n ],\n \"@anolilab/semantic-release-pnpm\"\n ]\n}\n```\n\n### Default preserved properties\n\nBy default, these properties are preserved in `package.json`:\n\n#### [npm](https://docs.npmjs.com/cli/v8/configuring-npm/package-json)\n\n- `name`\n- `version`\n- `private`\n- `publishConfig`\n- `scripts.preinstall`\n- `scripts.install`\n- `scripts.postinstall`\n- `scripts.dependencies`\n- `files`\n- `bin`\n- `browser`\n- `main`\n- `man`\n- `dependencies`\n- `peerDependencies`\n- `peerDependenciesMeta`\n- `bundledDependencies`\n- `optionalDependencies`\n- `engines`\n- `os`\n- `cpu`\n- `description`\n- `keywords`\n- `author`\n- `contributors`\n- `license`\n- `homepage`\n- `repository`\n- `bugs`\n- `funding`\n\n#### CDNs\n\n- [`jsdelivr`](https://www.jsdelivr.com/features#publishing-packages)\n- [`unpkg`](https://unpkg.com/)\n\n#### [Node.js](https://nodejs.org/api/packages.html#nodejs-packagejson-field-definitions)\n\n- `type`\n- `exports`\n- `imports`\n\n#### [VSCode Extension Manifest](https://code.visualstudio.com/api/references/extension-manifest)\n\n- `publisher`\n- `displayName`\n- `categories`\n- `galleryBanner`\n- `preview`\n- `contributes`\n- `activationEvents`\n- `badges`\n- `markdown`\n- `qna`\n- `sponsor`\n- `extensionPack`\n- `extensionDependencies`\n- `extensionKind`\n- `icon`\n\n#### [Angular Package Format](https://angular.io/guide/angular-package-format#legacy-resolution-keys)\n\n- `fesm2020`\n- `fesm2015`\n- `esm2020`\n- `es2020`\n\n#### [TypeScript](https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html)\n\n- `types`\n- `typings`\n- `typesVersions`\n\n#### Bundlers (Webpack, Rollup, esbuild)\n\n- [`module`](https://stackoverflow.com/questions/42708484/what-is-the-module-package-json-field-for)\n- [`sideEffects`](https://webpack.js.org/guides/tree-shaking/)\n\n## Supported Node.js Versions\n\nLibraries in this ecosystem make the best effort to track [Node.js’ release schedule](https://github.com/nodejs/release#release-schedule).\nHere’s [a post on why we think this is important](https://medium.com/the-node-js-collection/maintainers-should-consider-following-node-js-release-schedule-ab08ed4de71a).\n\n## Contributing\n\nIf you would like to help take a look at the [list of issues](https://github.com/anolilab/semantic-release/issues) and check our [Contributing](.github/CONTRIBUTING.md) guidelines.\n\n> **Note:** please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.\n\n## Credits\n\n- [Daniel Bannert](https://github.com/prisis)\n- [All Contributors](https://github.com/anolilab/semantic-release/graphs/contributors)\n\n## Made with ❤️ at Anolilab\n\nThis is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Anolilab](https://www.anolilab.com/open-source) is a Development and AI Studio. Contact us at [hello@anolilab.com](mailto:hello@anolilab.com) if you need any help with these technologies or just want to say hi!\n\n## License\n\nThe anolilab semantic-release-clean-package-json is open-sourced software licensed under the [MIT][license-url]\n\n\n\n[license-badge]: https://img.shields.io/npm/l/@anolilab/semantic-release-clean-package-json?style=for-the-badge\n[license]: https://github.com/anolilab/multi-semantic-release/blob/main/LICENSE\n[npm-downloads-badge]: https://img.shields.io/npm/dm/@anolilab/semantic-release-clean-package-json?style=for-the-badge\n[npm-downloads]: https://www.npmjs.com/package/@anolilab/semantic-release-clean-package-json\n[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge\n[prs-welcome]: https://github.com/anolilab/multi-semantic-release/blob/main/.github/CONTRIBUTING.md\n[chat-badge]: https://img.shields.io/discord/902465130518949899.svg?style=for-the-badge\n[chat]: https://discord.gg/eajEZvk2PG\n[typescript-badge]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript\n[typescript-url]: https://www.typescriptlang.org/\n[license-url]: LICENSE.md\n","readmeFilename":""}
![\"semantic-release-clean-package-json\"](\"__assets__/package-og.svg\")
\n\n