@nova-design-system/nova-vue 3.14.0-beta.0 → 3.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/generated/components.d.ts +0 -1
- package/dist/generated/components.js +0 -4
- package/dist/index.d.ts +0 -1
- package/dist/index.js +0 -1
- package/dist/plugin.d.ts +4 -14
- package/dist/plugin.js +3 -7
- package/package.json +2 -4
- package/dist/providers/NotificationService.d.ts +0 -84
- package/dist/providers/NotificationService.js +0 -215
- package/dist/providers/index.d.ts +0 -2
- package/dist/providers/index.js +0 -1
|
@@ -56,7 +56,6 @@ export declare const NvLoader: import("vue").DefineSetupFnComponent<JSX.NvLoader
|
|
|
56
56
|
export declare const NvMenu: import("vue").DefineSetupFnComponent<JSX.NvMenu & import("./vue-component-lib/utils").InputProps<string | number | boolean>, {}, {}, JSX.NvMenu & import("./vue-component-lib/utils").InputProps<string | number | boolean> & {}, import("vue").PublicProps>;
|
|
57
57
|
export declare const NvMenuitem: import("vue").DefineSetupFnComponent<JSX.NvMenuitem & import("./vue-component-lib/utils").InputProps<string | number | boolean>, {}, {}, JSX.NvMenuitem & import("./vue-component-lib/utils").InputProps<string | number | boolean> & {}, import("vue").PublicProps>;
|
|
58
58
|
export declare const NvNotification: import("vue").DefineSetupFnComponent<JSX.NvNotification & import("./vue-component-lib/utils").InputProps<boolean>, {}, {}, JSX.NvNotification & import("./vue-component-lib/utils").InputProps<boolean> & {}, import("vue").PublicProps>;
|
|
59
|
-
export declare const NvNotificationcontainer: import("vue").DefineSetupFnComponent<JSX.NvNotificationcontainer & import("./vue-component-lib/utils").InputProps<string | number | boolean>, {}, {}, JSX.NvNotificationcontainer & import("./vue-component-lib/utils").InputProps<string | number | boolean> & {}, import("vue").PublicProps>;
|
|
60
59
|
export declare const NvPopover: import("vue").DefineSetupFnComponent<JSX.NvPopover & import("./vue-component-lib/utils").InputProps<boolean>, {}, {}, JSX.NvPopover & import("./vue-component-lib/utils").InputProps<boolean> & {}, import("vue").PublicProps>;
|
|
61
60
|
export declare const NvRow: import("vue").DefineSetupFnComponent<JSX.NvRow & import("./vue-component-lib/utils").InputProps<string | number | boolean>, {}, {}, JSX.NvRow & import("./vue-component-lib/utils").InputProps<string | number | boolean> & {}, import("vue").PublicProps>;
|
|
62
61
|
export declare const NvStack: import("vue").DefineSetupFnComponent<JSX.NvStack & import("./vue-component-lib/utils").InputProps<string | number | boolean>, {}, {}, JSX.NvStack & import("./vue-component-lib/utils").InputProps<string | number | boolean> & {}, import("vue").PublicProps>;
|
|
@@ -543,12 +543,8 @@ export const NvNotification = /*@__PURE__*/ defineContainer('nv-notification', u
|
|
|
543
543
|
'icon',
|
|
544
544
|
'dismissible',
|
|
545
545
|
'hidden',
|
|
546
|
-
'initiallyHidden',
|
|
547
546
|
'hiddenChanged'
|
|
548
547
|
], 'hidden', 'hidden-changed');
|
|
549
|
-
export const NvNotificationcontainer = /*@__PURE__*/ defineContainer('nv-notificationcontainer', undefined, [
|
|
550
|
-
'position'
|
|
551
|
-
]);
|
|
552
548
|
export const NvPopover = /*@__PURE__*/ defineContainer('nv-popover', undefined, [
|
|
553
549
|
'triggerElement',
|
|
554
550
|
'open',
|
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
package/dist/plugin.d.ts
CHANGED
|
@@ -8,19 +8,9 @@
|
|
|
8
8
|
* By providing custom implementations, we ensure that event names are
|
|
9
9
|
* properly transformed, allowing Stencil components to work seamlessly in Vue.
|
|
10
10
|
*/
|
|
11
|
-
import {
|
|
12
|
-
import { type NotificationServiceOptions } from './providers/NotificationService';
|
|
11
|
+
import { Plugin } from 'vue';
|
|
13
12
|
/**
|
|
14
|
-
*
|
|
13
|
+
* This is the Vue plugin that is used to define the custom elements and event
|
|
14
|
+
* handlers.
|
|
15
15
|
*/
|
|
16
|
-
export
|
|
17
|
-
/** Notification service configuration options. */
|
|
18
|
-
notifications?: NotificationServiceOptions;
|
|
19
|
-
}
|
|
20
|
-
/**
|
|
21
|
-
* This is the Vue plugin that is used to define the custom elements, event
|
|
22
|
-
* handlers, and includes the notification service.
|
|
23
|
-
*/
|
|
24
|
-
export declare const NovaComponents: {
|
|
25
|
-
install(app: App, options?: NovaComponentsOptions): Promise<void>;
|
|
26
|
-
};
|
|
16
|
+
export declare const NovaComponents: Plugin;
|
package/dist/plugin.js
CHANGED
|
@@ -9,7 +9,6 @@
|
|
|
9
9
|
* properly transformed, allowing Stencil components to work seamlessly in Vue.
|
|
10
10
|
*/
|
|
11
11
|
import { defineCustomElements } from '@nova-design-system/nova-webcomponents/loader';
|
|
12
|
-
import { NvNotificationService, } from './providers/NotificationService';
|
|
13
12
|
/**
|
|
14
13
|
* Transforms the event name to kebab-case.
|
|
15
14
|
* @param {string} eventName - The name of the event.
|
|
@@ -40,18 +39,15 @@ const ael = (el, eventName, cb, opts) => el.addEventListener(transformEventName(
|
|
|
40
39
|
*/
|
|
41
40
|
const rel = (el, eventName, cb, opts) => el.removeEventListener(transformEventName(eventName), cb, opts);
|
|
42
41
|
/**
|
|
43
|
-
* This is the Vue plugin that is used to define the custom elements
|
|
44
|
-
* handlers
|
|
42
|
+
* This is the Vue plugin that is used to define the custom elements and event
|
|
43
|
+
* handlers.
|
|
45
44
|
*/
|
|
46
45
|
export const NovaComponents = {
|
|
47
|
-
async install(
|
|
48
|
-
// Define custom elements with event handling
|
|
46
|
+
async install() {
|
|
49
47
|
defineCustomElements(window, {
|
|
50
48
|
ce: (eventName, opts) => new CustomEvent(transformEventName(eventName), opts),
|
|
51
49
|
ael,
|
|
52
50
|
rel,
|
|
53
51
|
});
|
|
54
|
-
// Install notification service
|
|
55
|
-
NvNotificationService.install(app, options.notifications);
|
|
56
52
|
},
|
|
57
53
|
};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nova-design-system/nova-vue",
|
|
3
|
-
"version": "3.14.0
|
|
3
|
+
"version": "3.14.0",
|
|
4
4
|
"description": "Nova is a design system created by Elia Group to empower creators to efficiently build solutions that people love to use.",
|
|
5
5
|
"author": "Elia Group",
|
|
6
6
|
"homepage": "https://nova.eliagroup.io",
|
|
@@ -31,9 +31,7 @@
|
|
|
31
31
|
},
|
|
32
32
|
"scripts": {
|
|
33
33
|
"build": "npm run tsc",
|
|
34
|
-
"build:watch": "npm run tsc:watch",
|
|
35
34
|
"tsc": "tsc -p . --outDir ./dist",
|
|
36
|
-
"tsc:watch": "tsc -p . --outDir ./dist --watch",
|
|
37
35
|
"storybook": "storybook dev -p 6008",
|
|
38
36
|
"storybook.build": "storybook build -o ../../storybook-static/vue",
|
|
39
37
|
"clean": "rimraf dist lib/generated",
|
|
@@ -43,7 +41,7 @@
|
|
|
43
41
|
"@nova-design-system/nova-webcomponents": "*"
|
|
44
42
|
},
|
|
45
43
|
"devDependencies": {
|
|
46
|
-
"vue": "3.
|
|
44
|
+
"vue": "3.4.36",
|
|
47
45
|
"nova-utils": "*",
|
|
48
46
|
"nova-storybook-utils": "*"
|
|
49
47
|
}
|
|
@@ -1,84 +0,0 @@
|
|
|
1
|
-
import { App, type Ref, type Component } from 'vue';
|
|
2
|
-
import { NotificationEmphasis, FeedbackColors, NotificationPosition } from '../index';
|
|
3
|
-
/**
|
|
4
|
-
* Action callbacks for notifications. Will render buttons automatically.
|
|
5
|
-
*/
|
|
6
|
-
export interface NotificationAction {
|
|
7
|
-
/** The label of the action. */
|
|
8
|
-
label: string;
|
|
9
|
-
/** The callback to execute when the action is clicked. */
|
|
10
|
-
onClick: () => void;
|
|
11
|
-
}
|
|
12
|
-
/**
|
|
13
|
-
* Options for creating a notification.
|
|
14
|
-
*/
|
|
15
|
-
export interface NotificationOptions {
|
|
16
|
-
/** Unique identifier for the notification. If not provided, one will be generated. */
|
|
17
|
-
id?: string;
|
|
18
|
-
/** Short and concise text for the notification heading. */
|
|
19
|
-
heading?: string;
|
|
20
|
-
/** Main content of the notification. */
|
|
21
|
-
message?: string;
|
|
22
|
-
/** Whether the notification can be manually dismissed via close button. */
|
|
23
|
-
dismissible?: boolean;
|
|
24
|
-
/** Adjusts the emphasis to make the notification more or less visually
|
|
25
|
-
* prominent to users. Use this to draw attention to important actions or
|
|
26
|
-
* reduce focus on less critical ones */
|
|
27
|
-
emphasis?: `${NotificationEmphasis}`;
|
|
28
|
-
/** Type of the notification, used to determine the color and default icon. */
|
|
29
|
-
feedback?: `${FeedbackColors}`;
|
|
30
|
-
/** Custom icon name to override the default icon. */
|
|
31
|
-
icon?: string;
|
|
32
|
-
/** Notification actions */
|
|
33
|
-
actions?: NotificationAction[];
|
|
34
|
-
/** Custom components for the notification actions. */
|
|
35
|
-
actionSlot?: Component;
|
|
36
|
-
}
|
|
37
|
-
/**
|
|
38
|
-
* A notification with all required fields populated.
|
|
39
|
-
*/
|
|
40
|
-
export interface Notification extends NotificationOptions {
|
|
41
|
-
/** Timestamp when the notification was created. */
|
|
42
|
-
createdAt: number;
|
|
43
|
-
}
|
|
44
|
-
/**
|
|
45
|
-
* Context value provided by the NotificationService.
|
|
46
|
-
*/
|
|
47
|
-
export interface NotificationContextValue {
|
|
48
|
-
/** Reactive array of active notifications. */
|
|
49
|
-
notifications: Ref<Notification[]>;
|
|
50
|
-
/** Function to show a new notification. Returns the notification ID. */
|
|
51
|
-
show: (options: NotificationOptions) => string;
|
|
52
|
-
/** Function to dismiss a specific notification by ID. This will remove the
|
|
53
|
-
* notification after the animation completes */
|
|
54
|
-
dismiss: (id: string) => void;
|
|
55
|
-
/** Function to immediately remove a specific notification by ID. */
|
|
56
|
-
remove: (id: string) => void;
|
|
57
|
-
/** Function to remove all active notifications immediately. */
|
|
58
|
-
removeAll: () => void;
|
|
59
|
-
}
|
|
60
|
-
/**
|
|
61
|
-
* Configuration options for the NotificationService plugin.
|
|
62
|
-
*/
|
|
63
|
-
export interface NotificationServiceOptions {
|
|
64
|
-
/** Position of the notification container on the screen. */
|
|
65
|
-
position?: `${NotificationPosition}`;
|
|
66
|
-
/** Maximum number of notifications to display at once. */
|
|
67
|
-
maxNotifications?: number;
|
|
68
|
-
/** Additional CSS class name for the notification container. */
|
|
69
|
-
className?: string;
|
|
70
|
-
}
|
|
71
|
-
/**
|
|
72
|
-
* Vue plugin for Nova notifications.
|
|
73
|
-
*/
|
|
74
|
-
export declare const NvNotificationService: {
|
|
75
|
-
install(app: App, options?: NotificationServiceOptions): void;
|
|
76
|
-
};
|
|
77
|
-
/**
|
|
78
|
-
* Composable to use notifications in any component.
|
|
79
|
-
*
|
|
80
|
-
* @returns {NotificationContextValue} The notification context
|
|
81
|
-
* @throws {Error} If used outside of an app with NvNotificationService installed
|
|
82
|
-
*/
|
|
83
|
-
export declare const useNotifications: () => NotificationContextValue;
|
|
84
|
-
export default NvNotificationService;
|
|
@@ -1,215 +0,0 @@
|
|
|
1
|
-
/* eslint-disable jsdoc/require-jsdoc */
|
|
2
|
-
import { ref, createApp, h, } from 'vue';
|
|
3
|
-
import { NvButton, NvNotification, NvNotificationcontainer, } from '../generated/components';
|
|
4
|
-
/**
|
|
5
|
-
* Utility function to generate unique IDs.
|
|
6
|
-
*
|
|
7
|
-
* @returns {string} A unique identifier string
|
|
8
|
-
*/
|
|
9
|
-
const generateId = () => {
|
|
10
|
-
return `notification-${Date.now()}-${Math.random()
|
|
11
|
-
.toString(36)
|
|
12
|
-
.substr(2, 9)}`;
|
|
13
|
-
};
|
|
14
|
-
/**
|
|
15
|
-
* Utility function to unwrap a notification element from a ref.
|
|
16
|
-
* @param {NvNotificationRef} el The notification element ref
|
|
17
|
-
* @returns {HTMLNvNotificationElement | null} The notification element
|
|
18
|
-
*/
|
|
19
|
-
const unwrapNotificationEl = (el) => {
|
|
20
|
-
if (!el)
|
|
21
|
-
return null;
|
|
22
|
-
return '$el' in el ? el.$el : el;
|
|
23
|
-
};
|
|
24
|
-
class NotificationManager {
|
|
25
|
-
notifications = ref([]);
|
|
26
|
-
options;
|
|
27
|
-
containerApp = null;
|
|
28
|
-
constructor(options = {}) {
|
|
29
|
-
this.options = {
|
|
30
|
-
position: options.position || 'top-right',
|
|
31
|
-
maxNotifications: options.maxNotifications || 50,
|
|
32
|
-
className: options.className || '',
|
|
33
|
-
};
|
|
34
|
-
this.createContainer();
|
|
35
|
-
}
|
|
36
|
-
// keep track of all notification refs by id
|
|
37
|
-
elRefs = new Map();
|
|
38
|
-
// small helper to bind/unbind refs per id
|
|
39
|
-
setElRef = (id) => (el) => {
|
|
40
|
-
if (el)
|
|
41
|
-
this.elRefs.set(id, el);
|
|
42
|
-
else
|
|
43
|
-
this.elRefs.delete(id);
|
|
44
|
-
};
|
|
45
|
-
createContainer() {
|
|
46
|
-
// Create container element
|
|
47
|
-
const containerEl = document.createElement('div');
|
|
48
|
-
containerEl.id = 'nova-notification-container';
|
|
49
|
-
document.body.appendChild(containerEl);
|
|
50
|
-
// Create Vue app for the container
|
|
51
|
-
this.containerApp = createApp({
|
|
52
|
-
setup: () => {
|
|
53
|
-
return () => {
|
|
54
|
-
const items = this.notifications.value.map((notification) => {
|
|
55
|
-
const hasCustomActions = (notification.actions && notification.actions.length > 0) ||
|
|
56
|
-
!!notification.actionSlot;
|
|
57
|
-
const actionChildren = [];
|
|
58
|
-
notification.actions?.forEach((action) => {
|
|
59
|
-
actionChildren.push(h(NvButton, { onClick: action.onClick, emphasis: 'low', size: 'sm' }, { default: () => action.label }));
|
|
60
|
-
});
|
|
61
|
-
if (notification.actionSlot) {
|
|
62
|
-
actionChildren.push(h(notification.actionSlot));
|
|
63
|
-
}
|
|
64
|
-
const actionContainer = hasCustomActions
|
|
65
|
-
? h('div', { slot: 'actions' }, actionChildren)
|
|
66
|
-
: null;
|
|
67
|
-
return h(NvNotification, {
|
|
68
|
-
key: notification.id,
|
|
69
|
-
ref: this.setElRef(notification.id),
|
|
70
|
-
heading: notification.heading,
|
|
71
|
-
message: notification.message,
|
|
72
|
-
dismissible: notification.dismissible,
|
|
73
|
-
emphasis: notification.emphasis,
|
|
74
|
-
feedback: notification.feedback,
|
|
75
|
-
icon: notification.icon,
|
|
76
|
-
initiallyHidden: true,
|
|
77
|
-
onHiddenChanged: (event) => {
|
|
78
|
-
if (event.detail)
|
|
79
|
-
this.handleNotificationClose(notification.id);
|
|
80
|
-
},
|
|
81
|
-
}, {
|
|
82
|
-
default: () => (actionContainer ? [actionContainer] : null),
|
|
83
|
-
});
|
|
84
|
-
});
|
|
85
|
-
return h(NvNotificationcontainer, {
|
|
86
|
-
position: this.options.position,
|
|
87
|
-
class: this.options.className,
|
|
88
|
-
'data-testid': 'notification-container',
|
|
89
|
-
}, {
|
|
90
|
-
// ✅ function slot avoids the warning
|
|
91
|
-
default: () => items,
|
|
92
|
-
});
|
|
93
|
-
};
|
|
94
|
-
},
|
|
95
|
-
});
|
|
96
|
-
this.containerApp.mount(containerEl);
|
|
97
|
-
}
|
|
98
|
-
handleNotificationClose(id) {
|
|
99
|
-
this.remove(id);
|
|
100
|
-
}
|
|
101
|
-
/**
|
|
102
|
-
* Show a new notification.
|
|
103
|
-
*
|
|
104
|
-
* @param {NotificationOptions} options - The notification options
|
|
105
|
-
* @returns {string} The notification ID
|
|
106
|
-
*/
|
|
107
|
-
show = (options) => {
|
|
108
|
-
const id = options.id || generateId();
|
|
109
|
-
const notification = {
|
|
110
|
-
id,
|
|
111
|
-
heading: options.heading,
|
|
112
|
-
message: options.message,
|
|
113
|
-
dismissible: options.dismissible ?? true,
|
|
114
|
-
emphasis: options.emphasis ?? 'medium',
|
|
115
|
-
feedback: options.feedback ?? 'information',
|
|
116
|
-
actions: options.actions ?? [],
|
|
117
|
-
actionSlot: options.actionSlot,
|
|
118
|
-
icon: options.icon,
|
|
119
|
-
createdAt: Date.now(),
|
|
120
|
-
};
|
|
121
|
-
// Remove oldest notifications if we exceed max
|
|
122
|
-
const newNotifications = [notification, ...this.notifications.value];
|
|
123
|
-
if (newNotifications.length > this.options.maxNotifications) {
|
|
124
|
-
this.notifications.value = newNotifications.slice(0, this.options.maxNotifications);
|
|
125
|
-
}
|
|
126
|
-
else {
|
|
127
|
-
this.notifications.value = newNotifications;
|
|
128
|
-
}
|
|
129
|
-
setTimeout(() => {
|
|
130
|
-
const ref = this.elRefs.get(id);
|
|
131
|
-
const el = unwrapNotificationEl(ref);
|
|
132
|
-
el?.show();
|
|
133
|
-
}, 0);
|
|
134
|
-
return id;
|
|
135
|
-
};
|
|
136
|
-
/**
|
|
137
|
-
* Dismiss a specific notification by ID. This will remove the notification
|
|
138
|
-
* after the animation completes.
|
|
139
|
-
*
|
|
140
|
-
* @param {string} id - The notification ID to dismiss
|
|
141
|
-
*/
|
|
142
|
-
dismiss = (id) => {
|
|
143
|
-
const ref = this.elRefs.get(id);
|
|
144
|
-
const el = unwrapNotificationEl(ref);
|
|
145
|
-
el?.dismiss();
|
|
146
|
-
};
|
|
147
|
-
/**
|
|
148
|
-
* Immediately remove a specific notification by ID.
|
|
149
|
-
*
|
|
150
|
-
* @param {string} id - The notification ID to dismiss
|
|
151
|
-
*/
|
|
152
|
-
remove = (id) => {
|
|
153
|
-
this.notifications.value = this.notifications.value.filter((notification) => notification.id !== id);
|
|
154
|
-
this.elRefs.delete(id);
|
|
155
|
-
};
|
|
156
|
-
/**
|
|
157
|
-
* Clear all active notifications.
|
|
158
|
-
*/
|
|
159
|
-
removeAll = () => {
|
|
160
|
-
this.notifications.value = [];
|
|
161
|
-
};
|
|
162
|
-
/**
|
|
163
|
-
* Get the current context value.
|
|
164
|
-
*
|
|
165
|
-
* @returns {NotificationContextValue} The context value
|
|
166
|
-
*/
|
|
167
|
-
getContextValue = () => ({
|
|
168
|
-
notifications: this.notifications,
|
|
169
|
-
show: this.show,
|
|
170
|
-
remove: this.remove,
|
|
171
|
-
dismiss: this.dismiss,
|
|
172
|
-
removeAll: this.removeAll,
|
|
173
|
-
});
|
|
174
|
-
/**
|
|
175
|
-
* Destroy the notification manager and clean up resources.
|
|
176
|
-
*/
|
|
177
|
-
destroy() {
|
|
178
|
-
if (this.containerApp) {
|
|
179
|
-
this.containerApp.unmount();
|
|
180
|
-
this.containerApp = null;
|
|
181
|
-
}
|
|
182
|
-
const containerEl = document.getElementById('nova-notification-container');
|
|
183
|
-
if (containerEl) {
|
|
184
|
-
document.body.removeChild(containerEl);
|
|
185
|
-
}
|
|
186
|
-
}
|
|
187
|
-
}
|
|
188
|
-
// Global notification manager instance
|
|
189
|
-
let notificationManager = null;
|
|
190
|
-
/**
|
|
191
|
-
* Vue plugin for Nova notifications.
|
|
192
|
-
*/
|
|
193
|
-
export const NvNotificationService = {
|
|
194
|
-
install(app, options = {}) {
|
|
195
|
-
notificationManager = new NotificationManager(options);
|
|
196
|
-
// Provide global property
|
|
197
|
-
app.config.globalProperties.$notifications =
|
|
198
|
-
notificationManager.getContextValue();
|
|
199
|
-
// Provide for composition API
|
|
200
|
-
app.provide('notifications', notificationManager.getContextValue());
|
|
201
|
-
},
|
|
202
|
-
};
|
|
203
|
-
/**
|
|
204
|
-
* Composable to use notifications in any component.
|
|
205
|
-
*
|
|
206
|
-
* @returns {NotificationContextValue} The notification context
|
|
207
|
-
* @throws {Error} If used outside of an app with NvNotificationService installed
|
|
208
|
-
*/
|
|
209
|
-
export const useNotifications = () => {
|
|
210
|
-
if (!notificationManager) {
|
|
211
|
-
throw new Error('useNotifications must be used in an app with NovaComponents installed. Use app.use(NovaComponents) in your main.ts');
|
|
212
|
-
}
|
|
213
|
-
return notificationManager.getContextValue();
|
|
214
|
-
};
|
|
215
|
-
export default NvNotificationService;
|
package/dist/providers/index.js
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export { NvNotificationService, useNotifications, default as NotificationService, } from './NotificationService';
|