@nova-design-system/nova-webcomponents 3.12.0 → 3.14.0-beta.0

package/dist/collection/components/nv-notification/nv-notification.js

@@ -0,0 +1,431 @@
+import { Host, h, } from "@stencil/core";
+import { v4 as uuidv4 } from "uuid";
+import { FeedbackColors, NotificationPosition, } from "../../utils/constants";
+import { useCollapse, useFade, useSlide, parallel } from "../../animations";
+/**
+ * @slot heading - Use this slot to insert HTML as the notification title.
+ * @slot content - Use this slot to insert HTML as the notification message.
+ * @slot actions - Use this slot for custom actions.
+ */
+export class NvNotification {
+    constructor() {
+        /****************************************************************************/
+        //#region PROPERTIES
+        /**
+         * Set a unique ID for the notification. Used for aria attributes and managing
+         * multiple notifications.
+         */
+        this.uid = uuidv4();
+        /**
+         * Specifies the notification type which determines the color and default icon.
+         */
+        this.feedback = 'information';
+        /**
+         * Adjusts the emphasis to make the notification more or less visually
+         * prominent to users. Use this to draw attention to important actions or
+         * reduce focus on less critical ones
+         */
+        this.emphasis = 'medium';
+        /**
+         * Allows the notification to be dismissed via a close button (x). The
+         * notification is not dismissible unless explicitly enabled.
+         */
+        this.dismissible = false;
+        /**
+         * Controls the visibility of the notification.
+         */
+        this.hidden = false; // eslint-disable-line @stencil-community/reserved-member-names
+        /**
+         * When true, the notification will be hidden initially, but internal changes
+         * will not be in a controlled state. Good for animating the notification in.
+         */
+        this.initiallyHidden = false;
+        //#endregion EVENTS
+        /****************************************************************************/
+        //#region INTERNAL
+        this.iconByFeedback = {
+            [FeedbackColors.Warning]: 'alert-circle',
+            [FeedbackColors.Information]: 'info-circle',
+            [FeedbackColors.Success]: 'circle-check',
+            [FeedbackColors.Error]: 'alert-triangle',
+            [FeedbackColors.Neutral]: 'help',
+        };
+        this.roleByFeedback = {
+            [FeedbackColors.Error]: 'alert',
+            [FeedbackColors.Warning]: 'alert',
+            [FeedbackColors.Information]: 'status',
+            [FeedbackColors.Success]: 'status',
+            [FeedbackColors.Neutral]: 'status',
+        };
+    }
+    //#endregion PROPERTIES
+    /****************************************************************************/
+    //#region METHODS
+    /**
+     * Dismisses the notification with an animation, after the animation is
+     * complete, the hiddenChanged event will be emitted with the value of true,
+     * and the hidden prop will be set to true.
+     */
+    async dismiss() {
+        await this.dismissAnimation();
+    }
+    /**
+     * Sets the hidden prop to false, and shows the notification with an
+     * animation, after the animation is complete, the hiddenChanged event will be
+     * emitted with the value of false.
+     */
+    async show() {
+        await this.showAnimation();
+    }
+    getDefaultIcon() {
+        var _a;
+        return (_a = this.iconByFeedback[this.feedback]) !== null && _a !== void 0 ? _a : 'info-circle';
+    }
+    getAriaRole() {
+        var _a;
+        return (_a = this.roleByFeedback[this.feedback]) !== null && _a !== void 0 ? _a : 'status';
+    }
+    getAriaLive() {
+        return this.getAriaRole() === 'alert' ? 'assertive' : 'polite';
+    }
+    getHeadingId() {
+        return this.heading ? `nv-notification-${this.uid}-heading` : null;
+    }
+    getMessageId() {
+        return this.message ? `nv-notification-${this.uid}-message` : null;
+    }
+    async showAnimation() {
+        this.hidden = false;
+        const { setFadeIn } = useFade(this.container);
+        const { expand } = useCollapse(this.el, {
+            duration: 300,
+            overflow: 'visible',
+        });
+        const { slideY, setSlideY } = useSlide(this.container, {
+            duration: 300,
+        });
+        setSlideY(-100);
+        setFadeIn();
+        await parallel(slideY({ from: -100, to: 0 }), expand).start();
+        this.hiddenChanged.emit(false);
+    }
+    getSlideDestination(pos) {
+        switch (pos) {
+            case NotificationPosition.TopRight:
+            case NotificationPosition.BottomRight:
+                return { axis: 'x', to: 100 }; // right
+            case NotificationPosition.TopLeft:
+            case NotificationPosition.BottomLeft:
+                return { axis: 'x', to: -100 }; // left
+            case NotificationPosition.TopCenter:
+                return { axis: 'y', to: -100 }; // up
+            case NotificationPosition.BottomCenter:
+                return { axis: 'y', to: 100 }; // down
+            default:
+                return { axis: 'x', to: 100 }; // fallback
+        }
+    }
+    async dismissAnimation() {
+        var _a;
+        const position = (_a = this.el
+            .closest('nv-notificationcontainer')) === null || _a === void 0 ? void 0 : _a.getAttribute('position');
+        const destination = this.getSlideDestination(position);
+        const { fadeOut } = useFade(this.container, { duration: 300 });
+        const { slideX, slideY, setSlideReset } = useSlide(this.container, {
+            duration: 500,
+        });
+        const { collapse } = useCollapse(this.el, {
+            duration: 500,
+            overflow: 'visible',
+        });
+        const slide = destination.axis === 'x'
+            ? slideX({ from: 0, to: destination.to })
+            : slideY({ from: 0, to: destination.to });
+        setSlideReset();
+        await parallel(fadeOut, slide, collapse).start();
+        this.hidden = true;
+        this.hiddenChanged.emit(true);
+    }
+    //#endregion INTERNAL
+    /****************************************************************************/
+    //#region LIFECYCLE
+    componentWillLoad() {
+        this.headingSlot = this.el.querySelector('[slot="heading"]');
+        this.messageSlot = this.el.querySelector('[slot="content"]');
+        this.actionsSlot = this.el.querySelector('[slot="actions"]');
+        if (this.initiallyHidden)
+            this.hidden = true;
+    }
+    //#endregion LIFECYCLE
+    /****************************************************************************/
+    //#region RENDER
+    render() {
+        var _a, _b, _c;
+        return (h(Host, { key: '6e0b8abd9cbcb62b0b133db77520aa5aaa4173c9', role: this.getAriaRole(), "aria-live": this.getAriaLive(), "aria-atomic": true, "aria-labelledby": (_a = this.getHeadingId()) !== null && _a !== void 0 ? _a : null, "aria-describedby": (_b = this.getMessageId()) !== null && _b !== void 0 ? _b : null, tabindex: "-1" }, h("div", { key: '41b2ad35bf5220333e132d61f8843d1136cb1f40', "data-scope": "container", ref: el => (this.container = el) }, this.dismissible && (h("button", { key: '63116f239f7108ae945845c247c712827d8ae8a6', "data-scope": "dismiss", type: "button", onClick: this.dismiss.bind(this) }, h("nv-icon", { key: 'dc19bf166c6d2eccd3d40384d43206457f0d03f0', name: "x", size: "sm" }))), h("nv-icon", { key: 'e673ac1cc78300bc3425018a0cdfc4b90c679796', name: (_c = this.icon) !== null && _c !== void 0 ? _c : this.getDefaultIcon(), size: "md", "data-scope": "icon" }), h("div", { key: '95cb6ec06d89cda8e5170f9ff0f863b6b0b7e32d', "data-scope": "content" }, (this.heading || this.headingSlot) && (h("p", { key: 'ed654c0271d2ff8538295d8f7bf58a9754abb4c9', id: this.getHeadingId(), "data-scope": "heading" }, h("slot", { key: '00cc14a709059b9caf2117174ef7fcc310f5965f', name: "heading" }, this.heading))), (this.message || this.messageSlot) && (h("p", { key: 'c7c0bcbc2b54fdfdf8280af6a377929bf17fd688', id: this.getMessageId(), "data-scope": "message" }, h("slot", { key: '946db5aeb667b67f52f51adbb1b8f600325f937e', name: "content" }, this.message))), this.actionsSlot && (h("div", { key: 'd94560b658507a515a1360057121e933b95e6fe6', "data-scope": "actions" }, h("slot", { key: 'db185d3924c7d1fbeb30578992f2375e92a0d4bc', name: "actions" })))))));
+    }
+    static get is() { return "nv-notification"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["styles/nv-notification.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["styles/nv-notification.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "uid": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Set a unique ID for the notification. Used for aria attributes and managing\nmultiple notifications."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "uid",
+                "reflect": true,
+                "defaultValue": "uuidv4()"
+            },
+            "feedback": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "`${FeedbackColors}`",
+                    "resolved": "\"error\" | \"information\" | \"neutral\" | \"success\" | \"warning\"",
+                    "references": {
+                        "FeedbackColors": {
+                            "location": "import",
+                            "path": "../../utils/constants",
+                            "id": "src/utils/constants.ts::FeedbackColors"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Specifies the notification type which determines the color and default icon."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "feedback",
+                "reflect": true,
+                "defaultValue": "'information'"
+            },
+            "emphasis": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "`${NotificationEmphasis}`",
+                    "resolved": "\"high\" | \"medium\"",
+                    "references": {
+                        "NotificationEmphasis": {
+                            "location": "import",
+                            "path": "../../utils/constants",
+                            "id": "src/utils/constants.ts::NotificationEmphasis"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Adjusts the emphasis to make the notification more or less visually\nprominent to users. Use this to draw attention to important actions or\nreduce focus on less critical ones"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "emphasis",
+                "reflect": true,
+                "defaultValue": "'medium'"
+            },
+            "heading": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Short and concise text for the notification title."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "heading",
+                "reflect": true
+            },
+            "message": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Main content for the notification. For more complex content, use the\ncontent slot instead."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "message",
+                "reflect": true
+            },
+            "icon": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Icon associated with the notification, defaults vary based on the feedback\ntype."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "icon",
+                "reflect": true
+            },
+            "dismissible": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Allows the notification to be dismissed via a close button (x). The\nnotification is not dismissible unless explicitly enabled."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "dismissible",
+                "reflect": true,
+                "defaultValue": "false"
+            },
+            "hidden": {
+                "type": "boolean",
+                "mutable": true,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Controls the visibility of the notification."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "hidden",
+                "reflect": true,
+                "defaultValue": "false"
+            },
+            "initiallyHidden": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "When true, the notification will be hidden initially, but internal changes\nwill not be in a controlled state. Good for animating the notification in."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "initially-hidden",
+                "reflect": true,
+                "defaultValue": "false"
+            }
+        };
+    }
+    static get events() {
+        return [{
+                "method": "hiddenChanged",
+                "name": "hiddenChanged",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "bind",
+                            "text": "hidden"
+                        }],
+                    "text": "Emits when the 'hidden' prop changes, reflecting a change in visibility.\nPasses hidden value to the detail."
+                },
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                }
+            }];
+    }
+    static get methods() {
+        return {
+            "dismiss": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Dismisses the notification with an animation, after the animation is\ncomplete, the hiddenChanged event will be emitted with the value of true,\nand the hidden prop will be set to true.",
+                    "tags": []
+                }
+            },
+            "show": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Sets the hidden prop to false, and shows the notification with an\nanimation, after the animation is complete, the hiddenChanged event will be\nemitted with the value of false.",
+                    "tags": []
+                }
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+}
+//# sourceMappingURL=nv-notification.js.map

package/dist/collection/components/nv-notification/nv-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nv-notification.js","sourceRoot":"","sources":["../../../src/components/nv-notification/nv-notification.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  Component,\n  Host,\n  h,\n  Prop,\n  Method,\n  Element,\n  Event,\n  EventEmitter,\n} from '@stencil/core';\nimport { v4 as uuidv4 } from 'uuid';\n\nimport {\n  FeedbackColors,\n  NotificationEmphasis,\n  NotificationPosition,\n} from '../../utils/constants';\nimport { type IconName } from '../nv-icon/nv-icons';\nimport { useCollapse, useFade, useSlide, parallel } from '../../animations';\n\ntype AriaRole = 'status' | 'alert';\ntype AriaLive = 'polite' | 'assertive';\n\n/**\n * @slot heading - Use this slot to insert HTML as the notification title.\n * @slot content - Use this slot to insert HTML as the notification message.\n * @slot actions - Use this slot for custom actions.\n */\n@Component({\n  tag: 'nv-notification',\n  styleUrl: 'styles/nv-notification.scss',\n  shadow: false,\n})\nexport class NvNotification {\n  @Element() el: HTMLNvNotificationElement;\n  private container: HTMLElement;\n  private headingSlot: HTMLElement;\n  private messageSlot: HTMLElement;\n  private actionsSlot: HTMLElement;\n\n  /****************************************************************************/\n  //#region PROPERTIES\n\n  /**\n   * Set a unique ID for the notification. Used for aria attributes and managing\n   * multiple notifications.\n   */\n  @Prop({ reflect: true })\n  readonly uid: string = uuidv4();\n\n  /**\n   * Specifies the notification type which determines the color and default icon.\n   */\n  @Prop({ reflect: true })\n  readonly feedback: `${FeedbackColors}` = 'information';\n\n  /**\n   * Adjusts the emphasis to make the notification more or less visually\n   * prominent to users. Use this to draw attention to important actions or\n   * reduce focus on less critical ones\n   */\n  @Prop({ reflect: true })\n  readonly emphasis: `${NotificationEmphasis}` = 'medium';\n\n  /**\n   * Short and concise text for the notification title.\n   */\n  @Prop({ reflect: true })\n  readonly heading: string;\n\n  /**\n   * Main content for the notification. For more complex content, use the\n   * content slot instead.\n   */\n  @Prop({ reflect: true })\n  readonly message: string;\n\n  /**\n   * Icon associated with the notification, defaults vary based on the feedback\n   * type.\n   */\n  @Prop({ reflect: true })\n  readonly icon: string;\n\n  /**\n   * Allows the notification to be dismissed via a close button (x). The\n   * notification is not dismissible unless explicitly enabled.\n   */\n  @Prop({ reflect: true })\n  readonly dismissible: boolean = false;\n\n  /**\n   * Controls the visibility of the notification.\n   */\n  @Prop({ reflect: true, mutable: true })\n  hidden: boolean = false; // eslint-disable-line @stencil-community/reserved-member-names\n\n  /**\n   * When true, the notification will be hidden initially, but internal changes\n   * will not be in a controlled state. Good for animating the notification in.\n   */\n  @Prop({ reflect: true })\n  readonly initiallyHidden: boolean = false;\n\n  //#endregion PROPERTIES\n  /****************************************************************************/\n  //#region METHODS\n\n  /**\n   * Dismisses the notification with an animation, after the animation is\n   * complete, the hiddenChanged event will be emitted with the value of true,\n   * and the hidden prop will be set to true.\n   */\n  @Method()\n  async dismiss() {\n    await this.dismissAnimation();\n  }\n\n  /**\n   * Sets the hidden prop to false, and shows the notification with an\n   * animation, after the animation is complete, the hiddenChanged event will be\n   * emitted with the value of false.\n   */\n  @Method()\n  async show() {\n    await this.showAnimation();\n  }\n\n  //#endregion METHODS\n  /****************************************************************************/\n  //#region EVENTS\n\n  /**\n   * Emits when the 'hidden' prop changes, reflecting a change in visibility.\n   * Passes hidden value to the detail.\n   * @bind hidden\n   */\n  @Event()\n  hiddenChanged: EventEmitter<boolean>;\n\n  //#endregion EVENTS\n  /****************************************************************************/\n  //#region INTERNAL\n\n  private iconByFeedback: Record<FeedbackColors, IconName> = {\n    [FeedbackColors.Warning]: 'alert-circle',\n    [FeedbackColors.Information]: 'info-circle',\n    [FeedbackColors.Success]: 'circle-check',\n    [FeedbackColors.Error]: 'alert-triangle',\n    [FeedbackColors.Neutral]: 'help',\n  };\n\n  private roleByFeedback: Record<FeedbackColors, AriaRole> = {\n    [FeedbackColors.Error]: 'alert',\n    [FeedbackColors.Warning]: 'alert',\n    [FeedbackColors.Information]: 'status',\n    [FeedbackColors.Success]: 'status',\n    [FeedbackColors.Neutral]: 'status',\n  };\n\n  private getDefaultIcon(): IconName {\n    return this.iconByFeedback[this.feedback] ?? 'info-circle';\n  }\n\n  private getAriaRole(): AriaRole {\n    return this.roleByFeedback[this.feedback] ?? 'status';\n  }\n\n  private getAriaLive(): AriaLive {\n    return this.getAriaRole() === 'alert' ? 'assertive' : 'polite';\n  }\n\n  private getHeadingId(): string | null {\n    return this.heading ? `nv-notification-${this.uid}-heading` : null;\n  }\n\n  private getMessageId(): string | null {\n    return this.message ? `nv-notification-${this.uid}-message` : null;\n  }\n\n  private async showAnimation() {\n    this.hidden = false;\n\n    const { setFadeIn } = useFade(this.container);\n    const { expand } = useCollapse(this.el, {\n      duration: 300,\n      overflow: 'visible',\n    });\n    const { slideY, setSlideY } = useSlide(this.container, {\n      duration: 300,\n    });\n\n    setSlideY(-100);\n    setFadeIn();\n    await parallel(slideY({ from: -100, to: 0 }), expand).start();\n\n    this.hiddenChanged.emit(false);\n  }\n\n  private getSlideDestination(pos?: NotificationPosition): {\n    /** The axis to slide. */\n    axis: 'x' | 'y';\n    /** The destination value. */\n    to: number;\n  } {\n    switch (pos) {\n      case NotificationPosition.TopRight:\n      case NotificationPosition.BottomRight:\n        return { axis: 'x', to: 100 }; // right\n      case NotificationPosition.TopLeft:\n      case NotificationPosition.BottomLeft:\n        return { axis: 'x', to: -100 }; // left\n      case NotificationPosition.TopCenter:\n        return { axis: 'y', to: -100 }; // up\n      case NotificationPosition.BottomCenter:\n        return { axis: 'y', to: 100 }; // down\n      default:\n        return { axis: 'x', to: 100 }; // fallback\n    }\n  }\n\n  private async dismissAnimation() {\n    const position = this.el\n      .closest('nv-notificationcontainer')\n      ?.getAttribute('position') as NotificationPosition | undefined;\n\n    const destination = this.getSlideDestination(position);\n\n    const { fadeOut } = useFade(this.container, { duration: 300 });\n    const { slideX, slideY, setSlideReset } = useSlide(this.container, {\n      duration: 500,\n    });\n    const { collapse } = useCollapse(this.el, {\n      duration: 500,\n      overflow: 'visible',\n    });\n    const slide =\n      destination.axis === 'x'\n        ? slideX({ from: 0, to: destination.to })\n        : slideY({ from: 0, to: destination.to });\n\n    setSlideReset();\n    await parallel(fadeOut, slide, collapse).start();\n\n    this.hidden = true;\n    this.hiddenChanged.emit(true);\n  }\n\n  //#endregion INTERNAL\n  /****************************************************************************/\n  //#region LIFECYCLE\n\n  componentWillLoad() {\n    this.headingSlot = this.el.querySelector('[slot=\"heading\"]');\n    this.messageSlot = this.el.querySelector('[slot=\"content\"]');\n    this.actionsSlot = this.el.querySelector('[slot=\"actions\"]');\n\n    if (this.initiallyHidden) this.hidden = true;\n  }\n\n  //#endregion LIFECYCLE\n  /****************************************************************************/\n  //#region RENDER\n\n  render() {\n    return (\n      <Host\n        role={this.getAriaRole()}\n        aria-live={this.getAriaLive()}\n        aria-atomic\n        aria-labelledby={this.getHeadingId() ?? null}\n        aria-describedby={this.getMessageId() ?? null}\n        tabindex=\"-1\"\n      >\n        <div data-scope=\"container\" ref={el => (this.container = el)}>\n          {this.dismissible && (\n            <button\n              data-scope=\"dismiss\"\n              type=\"button\"\n              onClick={this.dismiss.bind(this)}\n            >\n              <nv-icon name=\"x\" size=\"sm\" />\n            </button>\n          )}\n\n          <nv-icon\n            name={this.icon ?? this.getDefaultIcon()}\n            size=\"md\"\n            data-scope=\"icon\"\n          ></nv-icon>\n\n          <div data-scope=\"content\">\n            {(this.heading || this.headingSlot) && (\n              <p id={this.getHeadingId()} data-scope=\"heading\">\n                <slot name=\"heading\">{this.heading}</slot>\n              </p>\n            )}\n            {(this.message || this.messageSlot) && (\n              <p id={this.getMessageId()} data-scope=\"message\">\n                <slot name=\"content\">{this.message}</slot>\n              </p>\n            )}\n\n            {this.actionsSlot && (\n              <div data-scope=\"actions\">\n                <slot name=\"actions\"></slot>\n              </div>\n            )}\n          </div>\n        </div>\n      </Host>\n    );\n  }\n  // #endregion RENDER\n}\n"]}

package/dist/collection/components/nv-notification/styles/nv-notification.css

@@ -0,0 +1,155 @@
+/* Colors */
+/* Maps for feedback-related variables */
+/* Spacing and Sizing */
+nv-notification {
+  display: block;
+}
+nv-notification [data-scope=container] {
+  display: flex;
+  position: relative;
+  max-width: 512px;
+  width: 100%;
+  padding: var(--notification-padding);
+  align-items: flex-start;
+  gap: var(--notification-gap-x);
+  border-radius: var(--notification-radius);
+  border-style: solid;
+  /* shadow/lg */
+  box-shadow: 0 var(--shadow-y-axis-lg-1, 4px) var(--shadow-blur-lg-1, 6px) var(--shadow-spread-lg-1, -2px) var(--shadow-color-opacity-1, rgba(14, 14, 14, 0.06)), 0 var(--shadow-y-axis-lg-2, 10px) var(--shadow-blur-lg-2, 15px) var(--shadow-spread-lg-2, -3px) var(--shadow-color-opacity-2, rgba(14, 14, 14, 0.1));
+}
+nv-notification [data-scope=container] [data-scope=icon] {
+  flex-shrink: 0;
+}
+nv-notification [data-scope=container] [data-scope=dismiss] {
+  padding: var(--button-sm-icon-button-padding, 8px);
+  justify-content: center;
+  align-items: center;
+  gap: var(--button-sm-gap, 6px);
+  display: flex;
+  position: absolute;
+  right: 8px;
+  top: 8px;
+  border-radius: var(--button-sm-border-radius, 4px);
+  background: var(--components-button-lower-background, rgba(255, 255, 255, 0));
+  color: var(--components-button-lower-icon);
+}
+nv-notification [data-scope=container] [data-scope=content] {
+  display: flex;
+  padding-right: var(--notification-padding-right);
+  flex-direction: column;
+  align-items: flex-start;
+  gap: var(--notification-gap-y);
+  flex: 1 0 0;
+}
+nv-notification [data-scope=container] [data-scope=content] [data-scope=heading] {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--notification-gap-x);
+  align-self: stretch;
+  color: var(--components-notification-content-title);
+  font-size: var(--notification-title-font-size);
+  font-style: normal;
+  font-weight: 500;
+  line-height: 20px; /* 142.857% */
+}
+nv-notification [data-scope=container] [data-scope=content] [data-scope=message] {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: var(--notification-gap-y);
+  align-self: stretch;
+  color: var(--components-notification-content-description);
+  font-variant-numeric: lining-nums tabular-nums slashed-zero;
+  font-size: var(--font-size-sm, 14px);
+  font-style: normal;
+  font-weight: 400;
+  line-height: var(--line-height-sm, 20px);
+}
+nv-notification [data-scope=container] [data-scope=content] [data-scope=actions] {
+  display: flex;
+  padding: var(--spacing-2, 8px) 0;
+  padding-bottom: 0px;
+  align-items: flex-start;
+  gap: var(--notification-gap-x);
+  align-self: stretch;
+  margin-left: calc(-1 * var(--button-sm-padding-x));
+}
+nv-notification[feedback=information] [data-scope=container] {
+  background-color: var(--components-notification-information-background);
+  border-color: var(--components-notification-information-border);
+}
+nv-notification[feedback=information] [data-scope=container] [data-scope=icon] {
+  color: var(--components-notification-information-icon);
+}
+nv-notification[feedback=information] > [data-scope=close]:focus, nv-notification[feedback=information] > [data-scope=close]:focus-within {
+  outline: none;
+}
+nv-notification[feedback=information] > [data-scope=close]:focus-visible, nv-notification[feedback=information] > [data-scope=close]:has(:focus-visible) {
+  outline: calc(var(--focus-outline-stroke) * 1) solid var(--components-notification-information-border);
+  outline-offset: calc(var(--focus-outline-offset) * 1);
+}
+nv-notification[feedback=warning] [data-scope=container] {
+  background-color: var(--components-notification-warning-background);
+  border-color: var(--components-notification-warning-border);
+}
+nv-notification[feedback=warning] [data-scope=container] [data-scope=icon] {
+  color: var(--components-notification-warning-icon);
+}
+nv-notification[feedback=warning] > [data-scope=close]:focus, nv-notification[feedback=warning] > [data-scope=close]:focus-within {
+  outline: none;
+}
+nv-notification[feedback=warning] > [data-scope=close]:focus-visible, nv-notification[feedback=warning] > [data-scope=close]:has(:focus-visible) {
+  outline: calc(var(--focus-outline-stroke) * 1) solid var(--components-notification-warning-border);
+  outline-offset: calc(var(--focus-outline-offset) * 1);
+}
+nv-notification[feedback=error] [data-scope=container] {
+  background-color: var(--components-notification-error-background);
+  border-color: var(--components-notification-error-border);
+}
+nv-notification[feedback=error] [data-scope=container] [data-scope=icon] {
+  color: var(--components-notification-error-icon);
+}
+nv-notification[feedback=error] > [data-scope=close]:focus, nv-notification[feedback=error] > [data-scope=close]:focus-within {
+  outline: none;
+}
+nv-notification[feedback=error] > [data-scope=close]:focus-visible, nv-notification[feedback=error] > [data-scope=close]:has(:focus-visible) {
+  outline: calc(var(--focus-outline-stroke) * 1) solid var(--components-notification-error-border);
+  outline-offset: calc(var(--focus-outline-offset) * 1);
+}
+nv-notification[feedback=success] [data-scope=container] {
+  background-color: var(--components-notification-success-background);
+  border-color: var(--components-notification-success-border);
+}
+nv-notification[feedback=success] [data-scope=container] [data-scope=icon] {
+  color: var(--components-notification-success-icon);
+}
+nv-notification[feedback=success] > [data-scope=close]:focus, nv-notification[feedback=success] > [data-scope=close]:focus-within {
+  outline: none;
+}
+nv-notification[feedback=success] > [data-scope=close]:focus-visible, nv-notification[feedback=success] > [data-scope=close]:has(:focus-visible) {
+  outline: calc(var(--focus-outline-stroke) * 1) solid var(--components-notification-success-border);
+  outline-offset: calc(var(--focus-outline-offset) * 1);
+}
+nv-notification[feedback=neutral] [data-scope=container] {
+  background-color: var(--components-notification-neutral-background);
+  border-color: var(--components-notification-neutral-border);
+}
+nv-notification[feedback=neutral] [data-scope=container] [data-scope=icon] {
+  color: var(--components-notification-neutral-icon);
+}
+nv-notification[feedback=neutral] > [data-scope=close]:focus, nv-notification[feedback=neutral] > [data-scope=close]:focus-within {
+  outline: none;
+}
+nv-notification[feedback=neutral] > [data-scope=close]:focus-visible, nv-notification[feedback=neutral] > [data-scope=close]:has(:focus-visible) {
+  outline: calc(var(--focus-outline-stroke) * 1) solid var(--components-notification-neutral-border);
+  outline-offset: calc(var(--focus-outline-offset) * 1);
+}
+nv-notification[emphasis=high] [data-scope=container] {
+  border-width: 1px;
+  border-left-width: var(--notification-border-width-high-emphasis);
+  padding-left: calc(var(--notification-padding) - var(--notification-border-width-high-emphasis) + 1px);
+}
+nv-notification[emphasis=medium] [data-scope=container] {
+  border-width: var(--notification-border-width-low-emphasis);
+  border-color: var(--color-content-low-border, #E3E3E3);
+}