add definition for addFiles method

[mrbatista]

No description provided.

[Murderlon]

@arturi @aduh95 do we want to continue to expose this or remove it in the next major? I recall it being initially introduced for internal purposes but there was some hesitation for making it public?

[aduh95]

It was introduced in #1949 to provide a more performant alternative to addFile. I agree we should either document it or remove it, I'm more on the "document it" side if the perf argument still holds.

[Murderlon]

If we want to document it should also be added to the docs like addFile

[arturi]

Document and expose would be my vote. I think it makes sense for use cases when you have a 100 files pre-uploaded or similar, this would be way faster that calling .addFile in a loop.

[Murderlon]

Cool. @mrbatista could you update the docs as well?

[aduh95]

For reference, addFile documentation can be found here:

uppy/website/src/docs/core.md

Line 450 in 80e5ced

### `uppy.addFile(fileObject)`

I suggest adding the addFiles section right below. Let us know if you need help.

[chiefGui]

Hey guys! Any ETA for this?

We've been using Uppy since 2018 and always had to create some proxy queue to don't bloat UI when the user adds multiple files at once.

[Murderlon]

We've been using Uppy since 2018 and always had to create some proxy queue to don't bloat UI when the user adds multiple files at once.

Note that it is available and has been, it's just not typed or documented, so you can use it now. When we document this we can merge this PR.

[chiefGui]

@Murderlon Yep. It's just I'd like to avoid explicit type declaration, but it works for now.

For anyone in need:

declare module '@uppy/core' {
  // eslint-disable-next-line
  export interface Uppy {
    addFiles<TMeta extends IndexedObject<any> = Record<string, unknown>>(
      files: AddFileOptions<TMeta>[]
    ): void
  }
}

I am placing this in the same file I'm calling .addFiles() (because of TypeScript v4.5.x). If you're on a lower version, please go with the .d.ts solution.