@ifsworld/granite-components 4.2.0 → 4.5.0

package/README.md

@@ -1,7 +1,120 @@
-# granite-components
+# Granite Components
 
-This library was generated with [Nx](https://nx.dev).
+This library is an Angular implementation of the [IFS Design System](https://design.ifs.com). The IFS User Experience product group builds and maintains common UI components and tools. [The goal](docs/strategy.md) is to help product teams rapidly build applications with a delightful IFS branded experience.
 
-## Running unit tests
+![npm](https://img.shields.io/npm/v/@ifsworld/granite-components)
+![npm weekly downloads](https://img.shields.io/npm/dw/@ifsworld/granite-components)
+[![@ifsworld/granite-components](https://snyk.io/advisor/npm-package/@ifsworld/granite-components/badge.svg)](https://snyk.io/advisor/npm-package/@ifsworld/granite-components)
 
-Run `nx test granite-components` to execute the unit tests.
+[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![Storybook](https://cdn.jsdelivr.net/gh/storybookjs/brand@main/badge/badge-storybook.svg)](https://uxstorybooklatest.z16.web.core.windows.net/)
+
+## Deployments
+
+| Name                                        | URL                                                   | Secondary URL                                       |
+| ------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------- |
+| **Storybook - Latest**                      | <https://uxstorybooklatest.z16.web.core.windows.net/> | -                                                   |
+| **Storybook - Beta**                        | <https://sb-designifs.azureedge.net/>                 | <https://uxstorybookbeta.z16.web.core.windows.net/> |
+| **Granite Component Library Demo - Latest** | <https://uxdemolatest.z16.web.core.windows.net/>      | -                                                   |
+| **Granite Component Library Demo - Beta**   | <https://cl-designifs.azureedge.net/>                 | <https://uxdemobeta.z16.web.core.windows.net/>      |
+
+## Getting started
+
+Assuming we're starting with a new @angular/cli project:
+
+```shell
+npx @angular/cli new my-project --style=scss
+
+cd my-project
+
+npm i --save @ifsworld/granite-components
+
+```
+
+If peer dependencies haven't automatically been installed (default behavior of NPM 7 and beyond), then manually install [@ifsworld/granite-icons](https://www.npmjs.com/package/@ifsworld/granite-icons) and [@ifsworld/granite-tokens](https://www.npmjs.com/package/@ifsworld/granite-tokens).
+
+```shell
+npm i --save @ifsworld/granite-icons @ifsworld/granite-tokens
+```
+
+Finally, add them in `src/styles.scss`:
+
+```scss
+@use '@ifsworld/granite-tokens/design-tokens/light/tokens';
+@use  '@ifsworld/granite-icons/assets/fonts/ligature/granite-iconfont-liga.css';
+```
+
+> That's it! Now we can run `npm start` and start building out our application!
+
+[StackBlitz Example](https://stackblitz.com/edit/angular-ivy-zcgdkv?file=src/app/app.component.html)
+
+**Note: currrently there's an issue with the _Ivy compiler_. To get the project to work, the Ivy Compiler must be set to disabled in `tsconfig.json`!**
+
+### Support
+
+#### Angular version support matrix
+
+| Angular / Library | 0.x.x | 1.x.x | 2.x.x | 3.x.x |
+| ----------------- | ----- | ----- | ----- | ----- |
+| 10                | ❌    | ❌    | ❌    | ❌    |
+| 11                | ✅    | 🔶    | ✅    | ✅    |
+| 12                | ✅    | ✅    | ✅    | ✅    |
+| 13                | ✅    | ✅    | ✅    | ✅    |
+| 14                | 🔶    | 🔶    | 🔶    | 🔶    |
+
+_Note: we plan to only support our latest release. Beyond that we make no guarantees of continued support._
+
+❌ unsupported
+🔶 limited support
+✅ fully supported
+
+## Contributing
+
+If you'd like to contribute, please see the [Getting started guide](../../docs/getting-started.md). Then follow our [Development guidelines](../../docs/development-guidelines.md).
+
+Check the IFS internal Jira for issues.
+
+### Further help
+
+To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI README](https://github.com/angular/angular-cli/blob/master/README.md).
+
+#### External sources
+
+- [Angular - Creating Libraries](https://angular.io/guide/creating-libraries)
+- [Create your Standalone Angular Library in 10 minutes](https://indepth.dev/create-your-standalone-angular-library-in-10-minutes/)
+- [Creating monorepos using NX](https://nx.dev/)
+
+## What we're working on now (2022)
+
+- Multi Select Input Control
+- Date Picker Control
+- Advance Input Control
+- Advance Table Control
+- Rating Control
+- Label Control
+
+## About the product group
+
+The project is governed by the [User Experience Product Group](https://ifs.sharepoint.com/teams/UserExperienceProductGroup). The mission of the product group is to drive the unified User Experience of IFS business applications. Own and provide UI components and guidelines based on our user's needs. Act as a guide and advisor helping application teams create great UX.
+
+### Primary goals of component library
+
+- Build high-quality UI components that developers can drop into existing applications
+- Provide tools that help developers build their own custom components with common interaction patterns
+
+#### What we mean by _high-quality_ components
+
+- Internationalized and accessible so that all users can use them.
+- Straightforward APIs that don't confuse developers.
+- Behave as expected across a wide variety of use-cases without bugs.
+- Behavior is well-tested with both unit and integration tests.
+- Customizable.
+- Performance cost is minimized.
+- Code is clean and well-documented to serve as an example for Angular developers.
+
+## Browser and accessibility support
+
+The library supports the most recent versions of the following major browsers: [Google Chrome (including Android)](https://www.google.com/chrome/), [Apple Safari (including iOS)](https://www.apple.com/safari/), and [Microsoft Edge](https://www.microsoft.com/edge). See [IFS official guidelines](https://ifs.sharepoint.com/sites/IFSCloudProdInfo/SitePages/Supported-Platforms-21R2.aspx).
+
+We aim for great user experience and to provide high levels of accessibility through support for standardized tools such as [ARIA](https://www.w3.org/WAI/standards-guidelines/aria/).

package/bundles/ifsworld-granite-components.umd.js

@@ -2734,10 +2734,7 @@
             this.radioBlur = new core.EventEmitter();
             this._positionBefore = false;
             this._radioDisabled = false;
-            this._removeUniqueSelectionListener = function () {
-                // Function used to deregister listener
-            };
-            this._removeUniqueSelectionListener = _radioDispatcher.listen(function (id, name) {
+            this._removeUniqueSelectionListenerFn = _radioDispatcher.listen(function (id, name) {
                 if (id !== _this.id && name === _this.name) {
                     _this.checked = false;
                 }
@@ -2767,7 +2764,9 @@
             }
         };
         GraniteRadioButtonComponent.prototype.ngOnDestroy = function () {
-            this._removeUniqueSelectionListener();
+            if (this._removeUniqueSelectionListenerFn instanceof Function) {
+                this._removeUniqueSelectionListenerFn();
+            }
         };
         // Focuses the radio button.
         GraniteRadioButtonComponent.prototype.focus = function (origin, options) {
@@ -2855,11 +2854,11 @@
                         class: 'granite-radio-group',
                         '[attr.role]': '"radiogroup"',
                         '[attr.aria-labelledby]': 'ariaLabelledby',
-                        '[class.granite-radio-group-layout-horizontal]': 'layout === "horizontal"',
+                        '[class.granite-radio-checkbox-base-layout-horizontal]': 'layout === "horizontal"',
                     },
-                    template: "<ng-content></ng-content>\n",
+                    template: '<ng-content></ng-content>',
                     changeDetection: core.ChangeDetectionStrategy.OnPush,
-                    styles: [":host(.granite-radio-group-layout-horizontal){display:flex;align-items:flex-start}"]
+                    styles: [":host(.granite-radio-checkbox-base-layout-horizontal){display:flex;align-items:flex-start}"]
                 },] }
     ];
 
@@ -2943,7 +2942,7 @@
                     },
                     template: "<label [attr.for]=\"id\" class=\"granite-checkbox-label\">\n  <div class=\"granite-checkbox-box\">\n    <input\n      #input\n      [id]=\"id\"\n      class=\"granite-checkbox-input cdk-visually-hidden\"\n      role=\"checkbox\"\n      type=\"checkbox\"\n      [attr.aria-checked]=\"checked.toString()\"\n      [attr.aria-label]=\"ariaLabel\"\n      [attr.aria-labelledby]=\"ariaLabelledby\"\n      [checked]=\"checked\"\n      [disabled]=\"_checkboxDisabled\"\n      [readonly]=\"readonly\"\n      (click)=\"_checkboxClick()\"\n      (change)=\"_checkboxChange()\"\n      (blur)=\"_onBlur()\"\n    />\n    <div class=\"granite-checkbox-check\"></div>\n  </div>\n  <span class=\"granite-checkbox-text\"><ng-content></ng-content></span>\n</label>\n",
                     changeDetection: core.ChangeDetectionStrategy.OnPush,
-                    styles: [".cdk-visually-hidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px;white-space:nowrap;outline:0;-webkit-appearance:none;-moz-appearance:none}:host{box-sizing:border-box}:host *,:host :after,:host :before{box-sizing:inherit;cursor:pointer}:host(.granite-checkbox){color:var(--granite-color-text)}:host(.granite-checkbox):not(.granite-checkbox-checked):not(.granite-checkbox-readonly):not(.granite-checkbox-disabled) .granite-checkbox-label:hover .granite-checkbox-box{border-color:var(--granite-color-background-active)}:host(.granite-checkbox-checked):not(.granite-checkbox-readonly):not(.granite-checkbox-disabled) .granite-checkbox-label:hover .granite-checkbox-box{background-color:var(--granite-color-background-active-hover);border-color:var(--granite-color-background-active-hover)}:host(.granite-checkbox-checked) .granite-checkbox-box{border-color:var(--granite-color-background-active);background-color:var(--granite-color-background-active)}:host(.granite-checkbox-checked) .granite-checkbox-box:focus-within{border-color:var(--granite-color-focus)}:host(.granite-checkbox-checked) .granite-checkbox-check{display:flex}:host(.granite-checkbox-checked):not(.granite-checkbox-readonly):not(.granite-checkbox-disabled) .granite-checkbox-box{-webkit-animation:fadeInAnimation .2s;animation:fadeInAnimation .2s;-webkit-animation-iteration-count:1;animation-iteration-count:1}:host(:not(.granite-checkbox-checked)) .granite-checkbox-box{-webkit-animation:fadeOutAnimation .2s;animation:fadeOutAnimation .2s;-webkit-animation-iteration-count:1;animation-iteration-count:1}:host(.granite-checkbox-readonly.granite-checkbox-checked) .granite-checkbox-box{background-color:var(--granite-color-text);border-color:var(--granite-color-text)}:host(.granite-checkbox-readonly.granite-checkbox-checked) .granite-checkbox-box .granite-checkbox-check{border-color:var(--granite-color-background)}:host(.granite-checkbox-disabled) .granite-checkbox-box{opacity:.3;background-color:var(--granite-color-border-soft)}:host(.granite-checkbox-disabled) .granite-checkbox-label{opacity:.6}:host(.granite-checkbox-disabled) *,:host(.granite-checkbox-readonly) *{cursor:default}:host(.granite-checkbox-label-before) .granite-checkbox-label{flex-direction:row-reverse}:host(.granite-checkbox-label-before) .granite-checkbox-text{-webkit-padding-start:0;padding-inline-start:0;-webkit-padding-end:var(--granite-spacing-s);padding-inline-end:var(--granite-spacing-s)}.granite-checkbox-label{display:flex;align-items:center;width:-webkit-max-content;width:-moz-max-content;width:max-content}.granite-checkbox-box{width:1rem;height:1rem;border:solid var(--granite-color-background-inactive);border-width:.0625rem;border-radius:.25rem;display:flex;justify-content:center;position:relative}.granite-checkbox-box:focus-within{border:.0625rem solid var(--granite-color-focus)}.granite-checkbox-check{position:relative;display:none;width:.5625rem;height:.3125rem;background-color:transparent;border:solid var(--granite-color-text-static-light);transform:rotate(-45deg);margin-top:var(--granite-spacing-xs);border-width:0 0 .125rem .125rem}.granite-checkbox-text{-webkit-padding-start:var(--granite-spacing-s);padding-inline-start:var(--granite-spacing-s)}.granite-checkbox-text:empty{display:none}@-webkit-keyframes fadeInAnimation{0%{opacity:0}to{opacity:1}}@keyframes fadeInAnimation{0%{opacity:0}to{opacity:1}}@-webkit-keyframes fadeOutAnimation{0%{opacity:1}to{opacity:0}}@keyframes fadeOutAnimation{0%{opacity:1}to{opacity:0}}"]
+                    styles: [".cdk-visually-hidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px;white-space:nowrap;outline:0;-webkit-appearance:none;-moz-appearance:none}:host{box-sizing:border-box}:host *,:host :after,:host :before{box-sizing:inherit;cursor:pointer}:host(.granite-checkbox){color:var(--granite-color-text)}:host(.granite-checkbox):not(.granite-checkbox-checked):not(.granite-checkbox-readonly):not(.granite-checkbox-disabled) .granite-checkbox-label:hover .granite-checkbox-box{border-color:var(--granite-color-background-active)}:host(.granite-checkbox-checked):not(.granite-checkbox-readonly):not(.granite-checkbox-disabled) .granite-checkbox-label:hover .granite-checkbox-box{background-color:var(--granite-color-background-active-hover);border-color:var(--granite-color-background-active-hover)}:host(.granite-checkbox-checked) .granite-checkbox-box{border-color:var(--granite-color-background-active);background-color:var(--granite-color-background-active)}:host(.granite-checkbox-checked) .granite-checkbox-box:focus-within{border-color:var(--granite-color-focus)}:host(.granite-checkbox-checked) .granite-checkbox-check{display:flex}:host(.granite-checkbox-checked):not(.granite-checkbox-readonly):not(.granite-checkbox-disabled) .granite-checkbox-box{-webkit-animation:fadeInAnimation .2s;animation:fadeInAnimation .2s;-webkit-animation-iteration-count:1;animation-iteration-count:1}:host(:not(.granite-checkbox-checked)) .granite-checkbox-box{-webkit-animation:fadeOutAnimation .2s;animation:fadeOutAnimation .2s;-webkit-animation-iteration-count:1;animation-iteration-count:1}:host(.granite-checkbox-readonly.granite-checkbox-checked) .granite-checkbox-box{background-color:var(--granite-color-text);border-color:var(--granite-color-text)}:host(.granite-checkbox-readonly.granite-checkbox-checked) .granite-checkbox-box .granite-checkbox-check{border-color:var(--granite-color-background)}:host(.granite-checkbox-disabled) .granite-checkbox-box{opacity:.3;background-color:var(--granite-color-border-soft)}:host(.granite-checkbox-disabled) .granite-checkbox-label{opacity:.6}:host(.granite-checkbox-disabled) *,:host(.granite-checkbox-readonly) *{cursor:default}:host(.granite-checkbox-label-before) .granite-checkbox-label{flex-direction:row-reverse}:host(.granite-checkbox-label-before) .granite-checkbox-text{-webkit-padding-start:0;padding-inline-start:0;-webkit-padding-end:var(--granite-spacing-s);padding-inline-end:var(--granite-spacing-s)}.granite-checkbox-label{display:flex;align-items:center;width:-webkit-max-content;width:-moz-max-content;width:max-content;-webkit-margin-end:var(--granite-spacing-xl);margin-inline-end:var(--granite-spacing-xl)}.granite-checkbox-box{width:1rem;height:1rem;border:solid var(--granite-color-background-inactive);border-width:.0625rem;border-radius:.25rem;display:flex;justify-content:center;position:relative}.granite-checkbox-box:focus-within{border:.0625rem solid var(--granite-color-focus)}.granite-checkbox-check{position:relative;display:none;width:.5625rem;height:.3125rem;background-color:transparent;border:solid var(--granite-color-text-static-light);transform:rotate(-45deg);margin-top:var(--granite-spacing-xs);border-width:0 0 .125rem .125rem}.granite-checkbox-text{-webkit-padding-start:var(--granite-spacing-s);padding-inline-start:var(--granite-spacing-s)}.granite-checkbox-text:empty{display:none}@-webkit-keyframes fadeInAnimation{0%{opacity:0}to{opacity:1}}@keyframes fadeInAnimation{0%{opacity:0}to{opacity:1}}@-webkit-keyframes fadeOutAnimation{0%{opacity:1}to{opacity:0}}@keyframes fadeOutAnimation{0%{opacity:1}to{opacity:0}}"]
                 },] }
     ];
     GraniteCheckboxComponent.ctorParameters = function () { return [
@@ -2963,6 +2962,28 @@
         _inputElement: [{ type: core.ViewChild, args: ['input',] }]
     };
 
+    var GraniteCheckboxGroupComponent = /** @class */ (function (_super) {
+        __extends(GraniteCheckboxGroupComponent, _super);
+        function GraniteCheckboxGroupComponent() {
+            return _super !== null && _super.apply(this, arguments) || this;
+        }
+        return GraniteCheckboxGroupComponent;
+    }(GraniteRadioCheckboxBase));
+    GraniteCheckboxGroupComponent.decorators = [
+        { type: core.Component, args: [{
+                    selector: 'granite-checkbox-group',
+                    host: {
+                        class: 'granite-checkbox-group',
+                        '[attr.role]': '"group"',
+                        '[attr.aria-labelledby]': 'ariaLabelledby',
+                        '[class.granite-radio-checkbox-base-layout-horizontal]': 'layout === "horizontal"',
+                    },
+                    template: '<ng-content></ng-content>',
+                    changeDetection: core.ChangeDetectionStrategy.OnPush,
+                    styles: [":host(.granite-radio-checkbox-base-layout-horizontal){display:flex;align-items:flex-start}"]
+                },] }
+    ];
+
     var GraniteCheckboxModule = /** @class */ (function () {
         function GraniteCheckboxModule() {
         }
@@ -2970,8 +2991,8 @@
     }());
     GraniteCheckboxModule.decorators = [
         { type: core.NgModule, args: [{
-                    declarations: [GraniteCheckboxComponent],
-                    exports: [GraniteCheckboxComponent],
+                    declarations: [GraniteCheckboxComponent, GraniteCheckboxGroupComponent],
+                    exports: [GraniteCheckboxComponent, GraniteCheckboxGroupComponent],
                 },] }
     ];
 
@@ -3576,6 +3597,7 @@
     exports.GraniteButtonComponent = GraniteButtonComponent;
     exports.GraniteButtonModule = GraniteButtonModule;
     exports.GraniteCheckboxComponent = GraniteCheckboxComponent;
+    exports.GraniteCheckboxGroupComponent = GraniteCheckboxGroupComponent;
     exports.GraniteCheckboxModule = GraniteCheckboxModule;
     exports.GraniteCoreModule = GraniteCoreModule;
     exports.GraniteDividerDirective = GraniteDividerDirective;