excaliburjs / Excalibur / 7939446408

89%

push

github

feat: ex.FontSource resource type (#2934)

## Changes:

- Added `ex.FontSource` resource type
  ```typescript
  const fontSource = new ex.FontSource('/my-font.ttf', 'My Font')
  loader.addResource(fontSource)

  game.start(loader).then(() => {
    const font = fontSource.toFont() // returns ex.Font
  })
  ```

  Font options can be defined either at the source or at the `toFont()` call. If defined in both, `toFont(options)` will
  override the options in the `FontSource`.

  ```typescript
  const fontSource = new ex.FontSource('/my-font.ttf', 'My Font', { 
    filtering: ex.ImageFiltering.Pixel,
    size: 16, // set a default size
  })
  const font = fontSource.toFont({
    // override just the size
    size: 20,
  })
  ```
- adds `"dom.iterable"` to  `lib` in tsconfig.json as it was needed to get the correct types for `document.fonts`

5243 of 6613 branches covered (79.28%)

11581 of 12706 relevant lines covered (91.15%)

23803.05 hits per line