Initial commit

Author: prantlf

.denolint.json

@@ -0,0 +1,11 @@
+{
+  "files": {
+    "exclude": [
+      "test/fixtures",
+      "test/snapshots"
+    ]
+  },
+  "rules": {
+    "tags": ["recommended"]
+  }
+}

.editorconfig

@@ -0,0 +1,10 @@
+# editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: Test or Release
+
+on:
+  - push
+  - pull_request
+
+jobs:
+  test-or-release:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout Sources
+      uses: actions/checkout@v3
+    - name: Install Node
+      uses: actions/setup-node@v3
+      with:
+        node-version: 'lts/*'
+        registry-url: 'https://registry.npmjs.org'
+    - name: Install PNPM
+      uses: pnpm/action-setup@v2
+      with:
+        version: latest
+        run_install: |
+          - args: [--frozen-lockfile, --no-verify-store-integrity]
+    - name: Test
+      run: npm test
+    - name: Coverage
+      uses: codecov/codecov-action@v3
+    - name: Publish
+      uses: cycjimmy/semantic-release-action@v3
+      with:
+        semantic_version: 19
+        branches: master
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+*.log
+*.map
+/lib/index.cjs
+node_modules

.vscode/launch.json

@@ -0,0 +1,18 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "tests",
+      "program": "${workspaceFolder}/test/index.js",
+      "skipFiles": [
+        "<node_internals>/**"
+      ]
+    },
+
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  "files.exclude": {
+    "**/.git": true,
+    "**/.DS_Store": true
+  },
+  "search.exclude": {
+    "**/node_modules": true,
+    "pnpm-lock.yaml": true
+  }
+}

CHANGELOG.md

@@ -0,0 +1,3 @@
+# 1.0.0 (2023-05-04)
+
+Initial release

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Ferdinand Prantl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,86 @@
+# rollup-plugin-write-only-changes
+
+[![Latest version](https://img.shields.io/npm/v/rollup-plugin-write-only-changes)
+ ![Dependency status](https://img.shields.io/librariesio/release/npm/rollup-plugin-write-only-changes)
+](https://www.npmjs.com/package/rollup-plugin-write-only-changes)
+
+A [Rollup]  Rollup plugin for writing files to the output directoriy only if their contents actually changed.
+
+## Requirements
+
+This plugin requires [Node.js] [LTS] (currently 18, at least 14.8) and Rollup 1.20 or newer.
+
+## Installation
+
+Using npm:
+
+    npm i -D rollup-plugin-write-only-changes
+
+## Usage
+
+Create a `rollup.config.js` [configuration file] and import the plugin:
+
+```js
+import { writeOnlyChanges } from 'rollup-plugin-write-only-changes';
+
+export default {
+  input: 'src/index.js',
+  output: {
+    dir: 'output',
+    format: 'cjs'
+  },
+  plugins: [writeOnlyChanges()]
+}
+```
+
+Then call `rollup` either via the [command-line] or the [programmatically].
+
+## Options
+
+The plugin can be customised by the following options, which can be passed as an object with the properties below.
+
+### `verbose`
+
+Type: `boolean` | `{ missing, failing, existed, created, changed, intact }`<br>
+Default: `{ failing: true }`
+
+Logging configuration. All cases can be enabled by `true` and disabled
+by `false`. ingle cases are selectable by specifying an object with
+the following boolean properties, which are `false` by default,
+except for `failing`, which `true` by default:
+
+  * `missing`: Log files, which were missing in the output directory.
+  * `failing`: Log files, which failed when they tried to be read from the output directory.
+  * `existed`: Log files, which already existed in the output directory and were read.
+  * `created`: Log files, which had to be created in the output directory,
+               because they did not exist there.
+  * `changed`: Log files, which had to be rewritten in the output directory,
+               because their content was different.
+  * `intact`:  Log files, which did not have to be rewritten in the output directory,
+               because their content remained the same.
+
+### `rebuild`
+
+Type: `boolean`<br>
+Default: `false`
+
+If the output files should be forcibly written at least once, when rollup
+starts and the project is built at first, before the watcher starts.
+
+## Contributing
+
+In lieu of a formal styleguide, take care to maintain the existing coding style. Lint and test your code.
+
+## License
+
+Copyright (C) 2023 Ferdinand Prantl
+
+Licensed under the [MIT License].
+
+[MIT License]: http://en.wikipedia.org/wiki/MIT_License
+[Rollup]: https://rollupjs.org/
+[Node.js]: https://nodejs.org/
+[LTS]: https://github.com/nodejs/Release
+[configuration file]: https://www.rollupjs.org/guide/en/#configuration-files
+[command-line]: https://www.rollupjs.org/guide/en/#command-line-reference
+[programmatically]: https://www.rollupjs.org/guide/en/#javascript-api

lib/index.d.ts

@@ -0,0 +1,64 @@
+import { Plugin } from 'rollup'
+
+export interface WriteOnlyChangesLogOptions {
+  /**
+   * Log files, which were missing in the output directory.
+   * @default false
+   */
+  missing?: boolean
+
+  /**
+   * Log files, which failed when they tried to be read from the output directory.
+   * @default true
+   */
+  failing?: boolean
+
+  /**
+   * Log files, which already existed in the output directory and were read.
+   * @default false
+   */
+  existed?: boolean
+
+  /**
+   * Log files, which had to be created in the output directory,
+   * because they did not exist there.
+   * @default false
+   */
+  created?: boolean
+
+  /**
+   * Log files, which had to be rewritten in the output directory,
+   * because their content was different.
+   * @default false
+   */
+  changed?: boolean
+
+  /**
+   * Log files, which did not have to be rewritten in the output directory,
+   * because their content remained the same.
+   * @default false
+   */
+  intact?: boolean
+}
+
+export interface PluginWriteOnlyChangesOptions {
+  /**
+   * Logging configuration. All cases can be enabled by `true` and disabled
+   * by `false`. ingle cases are selectable by specifying an object
+   * with `PluginWriteOnlyChangesLogOptions`.
+   * @default { failing: true }
+   */
+  verbose?: boolean | WriteOnlyChangesLogOptions
+
+  /**
+   * If the output files should be forcibly written at least once, when rollup
+   * starts and the project is built at first, before the watcher starts.
+   * @default false
+   */
+  rebuild?: boolean
+}
+
+/**
+ * Converts .json (JSON/CJSON/JSON5) files to ES6 modules.
+ */
+export function writeOnlyChanges(options?: PluginWriteOnlyChangesOptions): Plugin