feat: new @ng-web-apis/notification package (Notification API)

[nsbarsukov]

PR Type

What kind of change does this PR introduce?

• Bugfix
• Feature
• Refactoring (no functional changes, no api changes)
• Other... Please describe:

Partially solves #96

[github-actions]

Visit the preview URL for this PR (updated for commit f9958a5):

https://ng-web-apis-common--pr123-notification-api-bz7qli26.web.app

_{(expires Wed, 11 Oct 2023 13:12:19 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: a9d81cd8541a1a45fa12e730c551222bb3d5ceb9}

[codecov]

Codecov Report

Merging #123 (f9958a5) into main (8bc8eca) will decrease coverage by 0.36%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##             main     #123      +/-   ##
==========================================
- Coverage   89.29%   88.93%   -0.36%     
==========================================
  Files         201      194       -7     
  Lines        1186     1112      -74     
  Branches      128      119       -9     
==========================================
- Hits         1059      989      -70     
+ Misses        103      100       -3     
+ Partials       24       23       -1     

Flag	Coverage Δ
audio	79.92% <ø> (ø)
canvas	95.97% <ø> (ø)
common	100.00% <ø> (ø)
geolocation	100.00% <ø> (ø)
intersection-observer	98.00% <ø> (ø)
midi	100.00% <ø> (ø)
mutation-observer	100.00% <ø> (ø)
payment-request	100.00% <ø> (ø)
permissions	78.78% <ø> (ø)
resize-observer	100.00% <ø> (ø)
speech	100.00% <ø> (ø)
storage	100.00% <ø> (ø)
summary	88.93% <ø> (-0.36%)	⬇️
universal	100.00% <ø> (ø)
view-transition	?
workers	?

Flags with carried forward coverage won't be shown. Click here to find out more.

see 7 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[waterplea]

Safari 16 supports Permissions API so I think we can just keep it here until 16 and drop this method completely after that.

[waterplea]

We need a demo example showing all the notification options:
https://developer.mozilla.org/en-US/docs/Web/API/Notification/Notification

I also wonder if it's possible to create a declarative directive, something like:

<notification *ngIf="open" (close)="open = false">
  Text content
  <button icon="src" (click)="onClick()">
    Action
  </button>
</notification>

Not sure about actual "tags" inside, but it would be nice to be able to listen to actions in the same manner we listen to clicks on buttons.

[waterplea]

There are examples with inline replies here, not mentioned on MDN:
https://web.dev/push-notifications-display-a-notification/