Uppy 4.0 major, motherissue

[arturi]

Initial checklist

• I understand this is a feature request and questions should be posted in the Community Forum
• I searched issues and couldn’t find anything (or linked relevant results below)

We are planning the release of the new Uppy Major, we’ve got to prioritise and sort issues and breaking changes for 4.0 and possibly 5.0.

---

Changes touching multiple plugins

• TypeScript migration.
• Make arguments passed to events consistent #3938
• Make allowedMetaFields option consistent across plugins #4217
• Upgrade Yarn to 4.x #4849
• Plugin titles are sometimes configured through options, something in locale #5018
• Consider removing the plugins array and how to document target option #5021
• Type tests for common plugin combinations. Particularly the Body generic with different uploaders.
• Replace all instances of JSX.Element global to ComponentChild from preact.
• Investigate if we can remove the confusing { reason } argument from cancelAll / destroy
• Go over all TODO's in the codebase. (mifi started here Uppy 4x breaking changes #5200)
• Write a migration guide. (companion here 8e3c51b)
• Write a blog post.
• Do we need to export Body generics per uploader plugin?

@uppy/core

• Rename / deprecate: resetProgress, rename close to destroy, rename clearUploadedFiles to clear, and make it public
• Remove or improve getObjectOfFilesPerState
• Investigate if we can simplify the import BasePlugin from '@uppy/core/lib/BasePlugin.js' import to '@uppy/core' without bundling Preact for plugins only using BasePlugin.
• @uppy/core: use variadic arguments for uppy.use #4888

@uppy/companion

• @uppy/companion: switch from node-redis to ioredis #4623
• @uppy/companion, remote sources: Encode the uploadId before putting it in the URL #4649
• coalesce options bucket and getKey #5169
• Companion 4x breaking changes #5198

@uppy/provider-views

• Partial tree refactor

@uppy/aws-s3

• Correctly setup docs. aws-s3-multipart should become aws-s3. See how we want to do this.
• Move all code from @uppy/aws-s3-multipart into @uppy/aws-s3, remove code for @uppy/aws-s3-multipart
• When using aws-s3, force endpoints to be the same as Companion to simplify setup #5030

@uppy/xhr-upload

• @uppy/xhr-upload: align options with tus #5049

@uppy/transloadit

• @uppy/transloadit: always create one assembly instead of determining per file #4765

@uppy/angular

• Upgrade to Angular 17.x and to TS 5.4 #5008

@uppy/progress-bar

• @uppy/progress-bar: remove default target #4971

@uppy/status-bar

• @uppy/status-bar: remove default target #4970

@uppy/svelte

• examples: add SvelteKit example #5181

@uppy/react

• examples: make React example up-to-date #5205
• Remove useUppy
• Remove UppyWrapper component?
• Require newer version of React and reintroduce useUppyState
• Remove prop-types package and usage.

[lmyslinski]

Are the updated docs available yet? I wanted to give the beta a try but I can't find an updated example

[Murderlon]

They are available on the 4.x branch in the docs folder. Not live on the website yet.

[lmyslinski]

@Murderlon I've just finished upgrading - the docs were really helpful, I like the new API a lot more. There's less fiddling, it's more straightforward. I've only had one problem, I can't find a way anymore to get the file name before an upload is sent - I've just worked around that by returning that from the server but probably something that would be good to add into the docs/examples

[Murderlon]

Can you open a new issue with a way to reproduce that? Might be a regression.

Migration guide is here btw: #5206