Merge pull request #1743 from nextcloud-libraries/chore/releas

prepare v1.10.0 and document release process

Author: susnux

.github/release.yml

@@ -0,0 +1,35 @@
+# https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes
+# SPDX-FileCopyrightText: 2021-2024 Nextcloud GmbH and Nextcloud contributors
+# SPDX-License-Identifier: CC0-1.0
+changelog:
+  exclude:
+    authors:
+      - dependabot
+      - dependabot[bot]
+      - nextcloud-bot
+      - nextcloud-command
+    labels:
+      - automated
+      - dependencies
+      - duplicate
+      - invalid
+      - l10n
+      - question
+      - wontfix
+
+  categories:
+    - title: 🔐 Security
+      labels:
+        - security
+    - title: 💥 Breaking Changes
+      labels:
+        - breaking
+    - title: 🚀 Enhancements
+      labels:
+        - enhancement
+    - title: 🐛 Fixed bugs
+      labels:
+        - bug
+    - title: Other Changes
+      labels:
+        - "*"

CHANGELOG.md

@@ -4,6 +4,19 @@
 -->
 # Changelog
 
+## [v1.10.0](https://github.com/nextcloud-libraries/nextcloud-upload/tree/v1.10.0) \(2025-05-05\)
+
+### Added
+* feat(Uploader): Enable chunked upload for public shares if supported [\#1705](https://github.com/nextcloud-libraries/nextcloud-upload/pull/1705) \([provokateurin](https://github.com/provokateurin)\)
+
+### Fixed
+* fix(i18n): Corrected plural for multi. plural languages [\#1733](https://github.com/nextcloud-libraries/nextcloud-upload/pull/1733) \([rakekniven](https://github.com/rakekniven)\)
+
+### Changed
+* chore(i18n): Improved grammar [\#1672](https://github.com/nextcloud-libraries/nextcloud-upload/pull/1672) \([rakekniven](https://github.com/rakekniven)\)
+* chore(deps): Bump axios to 1.9.0
+* Updated translations
+
 ## [v1.9.1](https://github.com/nextcloud-libraries/nextcloud-upload/tree/v1.9.1) \(2025-03-20\)
 
 ### Fixed

README.md

@@ -12,3 +12,27 @@ Nextcloud upload helpers for Nextcloud apps
 
 ## Usage
 📘 [API documentation](https://nextcloud-libraries.github.io/nextcloud-upload)
+
+## Development
+
+### 📤 Releasing a new version
+
+- Pull the latest changes from `main` or `stableX`
+- Checkout a new branch with the tag name (e.g `v4.0.1`): `git checkout -b v<version>`
+- Run `npm version patch --no-git-tag-version` (`npm version minor --no-git-tag-version` if minor).
+  This will return a new version name, make sure it matches what you expect
+- Generate the changelog content from the [release](https://github.com/nextcloud-libraries/nextcloud-upload/releases) page.
+  Create a draft release, select the previous tag, click `generate` then paste the content to the `CHANGELOG.md` file
+  1. adjust the links to the merged pull requests and authors so that the changelog also works outside of GitHub
+     by running `npm run prerelease:format-changelog`.
+     This will apply this regex: `by @([^ ]+) in ((https://github.com/)nextcloud-libraries/nextcloud-upload/pull/(\d+))`
+     Which this as the replacement: `[\#$4]($2) \([$1]($3$1)\)`
+  2. use the the version as tag AND title (e.g `v4.0.1`)
+  3. add the changelog content as description (https://github.com/nextcloud-libraries/nextcloud-upload/releases)
+- Commit, push and create PR
+- Get your PR reviewed and merged
+- Create a milestone with the follow-up version at https://github.com/nextcloud-libraries/nextcloud-upload/milestones
+- Move all open tickets and PRs to the follow-up
+- Close the milestone of the version you release
+- Publish the previously drafted release on GitHub
+  ![image](https://user-images.githubusercontent.com/14975046/124442568-2a952500-dd7d-11eb-82a2-402f9170231a.png)

build/format-changelog.mjs

@@ -0,0 +1,24 @@
+/**
+ * SPDX-FileCopyrightText: Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+console.info('🔎 checking format of CHANGELOG.md')
+
+const file = join(import.meta.dirname, '..', 'CHANGELOG.md')
+const content = await readFile(file, { encoding: 'utf-8' })
+
+const formatted = content.replaceAll(
+	/by @([^ ]+) in ((https:\/\/github.com\/)nextcloud-libraries\/nextcloud-upload\/pull\/(\d+))/g,
+	'[\\#$4]($2) \\([$1]($3$1)\\)',
+)
+
+if (formatted !== content) {
+	console.info('✏️ fixing format')
+	await writeFile(file, formatted)
+	console.info('🎉 done')
+} else {
+	console.info('✅ no formatting needed - done.')
+}

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextcloud/upload",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Nextcloud file upload client",
   "keywords": [
     "nextcloud",
@@ -36,6 +36,7 @@
   "scripts": {
     "build": "vite --mode production build",
     "build:doc": "typedoc --out dist/doc lib && touch dist/doc/.nojekyll",
+    "prerelease:format-changelog": "node build/format-changelog.mjs",
     "cypress": "cypress run --component",
     "cypress:gui": "cypress open --component",
     "dev": "vite --mode development build",