Release 0.5.0

Author: devoto13

CHANGELOG.md

@@ -5,6 +5,48 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ---
 
+## [0.5.0](https://github.com/FortAwesome/angular-fontawesome/releases/tag/0.5.0) - 2019-08-12
+
+Make sure to check [upgrade instructions](https://github.com/FortAwesome/angular-fontawesome/blob/master/UPGRADING.md).
+
+### Added
+
+* Added `fa-stack` component to stack [two icons together](https://fontawesome.com/how-to-use/on-the-web/styling/stacking-icons):
+
+    ```html
+    <fa-stack>
+      <fa-icon [icon]="faCircle" stackItemSize="2x"></fa-icon>
+      <fa-icon [icon]="faFlag" [inverse]="true" stackItemSize="1x"></fa-icon>
+    </fa-stack>
+    ```
+* Added `fa-duotone-icon` component to work with [duotone icons](https://fontawesome.com/how-to-use/on-the-web/styling/duotone-icons):
+
+    ```html
+    <fa-duotone-icon [icon]="['fad', 'coffee']" primaryColor="red" secondaryColor="blue"></fa-duotone-icon>
+    ```
+* Added [an official method](https://github.com/FortAwesome/angular-fontawesome/blob/master/docs/usage/features.md#programmatic-api) to update `FaIconComponent` and `FaDuotoneIconComponent` programmatically.
+* Added `FaIconLibray` class to replace deprecated global icon library from `@fortawesome/fontawesome-svg-core` package.
+* Added `a11yRole` input for `fa-icon` and `fa-duotone-icon` components to support customizing `role` attribute of the rendered SVG icon.
+* Added `FaConfig` class to globally configure `angular-fontawesome`.
+* Added a table in README.md to document compatibility with major Angular versions.
+* Added instructions on how to install library with NPM.
+
+### Changed
+
+* Restructured documentation to make it easier to navigate and extend.
+* Changed semantics of the `FaIconComponent.icon` property. It used to have type `Icon` - rendered icon object and is now changed into component input to specify icon definition with type `IconProp`.
+
+### Deprecated
+
+* `FaIconComponent.iconProp` is deprecated. Use `FaIconComponent.icon` instead.
+* Warning when `FaIconComponent.icon` is not set or specified icon definition is missing in the icon library is deprecated. It will throw a hard error in the next version.
+* `FaIconComponent.listItem` is deprecated. Use `FaIconComponent.fixedWidth` + custom CSS to render icons as list markers.
+* `FaIconService` is deprecated in favour of `FaConfig`.
+
+### Fixed
+
+* Fixed title-tooltip not being displayed in IE 11 in some cases.
+
 ## [0.4.0](https://github.com/FortAwesome/angular-fontawesome/releases/tag/0.4.0) - 2019-03-28
 
 ### Added

DEVELOPER.md

@@ -36,7 +36,9 @@ Command     | Purpose
 
 1. Bump version in `package.json`
 1. Add contributors to `package.json` and `README.md`
+1. Update Compatibility table in `README.md`
 1. Update the `CHANGELOG.md`
+1. Update the `UPGRADING.md` if necessary
 1. `yarn build`
 1. `cd dist/angular-fontawesome`
 1. `npm publish`

README.md

@@ -33,7 +33,7 @@ $ npm install @fortawesome/angular-fontawesome@<version>
 |0.1.x|5.x|
 |0.2.x|6.x|
 |0.3.x|6.x && 7.x|
-|0.4.x|8.x|
+|0.4.x, 0.5.x|8.x|
 
 ## Usage
 To get up and running using Font Awesome with Angular follow below steps:
@@ -120,6 +120,8 @@ being awesome contributors to this project. **We'd like to take a moment to reco
 [<img src="https://github.com/stephaniepurvis.png?size=72" alt="stephaniepurvis" width="72">](https://github.com/stephaniepurvis)
 [<img src="https://github.com/loicgasser.png?size=72" alt="loicgasser" width="72">](https://github.com/loicgasser)
 [<img src="https://github.com/damienwebdev.png?size=72" alt="damienwebdev" width="72">](https://github.com/damienwebdev)
+[<img src="https://github.com/ronniebarker.png?size=72" alt="ronniebarker" width="72">](https://github.com/ronniebarker)
+[<img src="https://github.com/bhanuhiteshi.png?size=72" alt="bhanuhiteshi" width="72">](https://github.com/bhanuhiteshi)
 
 If we've missed someone (which is quite likely) submit a Pull Request to us and we'll get it resolved.
 

docs/upgrading/0.4.0-0.5.0.md

@@ -31,3 +31,24 @@ export class AppModule {
 ```
 
 You can also use `FaConfig.globalLibrary` property to change the warning into the hard error or suppress warnings altogether (not recommended). 
+
+## Changed semantics of FaIconComponent.icon property
+
+`FaIconComponent.icon` property used to have type `Icon` (rendered icon object), which was changed to `IconProp` as it is now an input property to specify the icon definition. No replacement is provided.
+
+If you were working with `FaIconComponent` programmatically you should switch from setting `FaIconComponent.iconProp` to `FaIconComponent.icon` as former is deprecated.  
+
+## FaIconComponent.listItem is deprecated
+
+The input was not working and we don't want to support this pattern in angular-fontawesome.
+
+You can use `fixedWidth=true` and custom CSS to achieve similar behavior:
+
+```css
+ul {
+  list-style-type: none;
+  padding-left: 20px;
+}
+```
+
+Demo: https://stackblitz.com/edit/angular-z8v4ux-o2yduf

package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./node_modules/ng-packagr/package.schema.json",
   "name": "@fortawesome/angular-fontawesome",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Angular Fontawesome, an Angular library",
   "scripts": {
     "test": "ng test angular-fontawesome --watch=false --browsers=ChromeCI",
@@ -31,7 +31,9 @@
     "Siddharth Ajmera <[email protected]>",
     "Stephanie Purvis <[email protected]>",
     "Gasser Loïc <[email protected]>",
-    "Damien Retzinger <[email protected]>"
+    "Damien Retzinger <[email protected]>",
+    "Ronnie Barker <[email protected]>",
+    "bhanuhiteshi <[email protected]>"
   ],
   "license": "MIT",
   "bugs": {