no-frills-ui 0.0.14-alpha.4 → 0.0.14-alpha.6

package/lib-esm/components/Modal/Modal.js

@@ -1,51 +1,58 @@
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-import { jsx as _jsx } from "@emotion/react/jsx-runtime";
+import { jsx } from '@emotion/react/jsx-runtime';
 import React from 'react';
 import PropTypes from 'prop-types';
-import LayerManager, { LAYER_POSITION } from '../../shared/LayerManager';
-export { Header as ModalHeader, Body as ModalBody, Footer as ModalFooter, } from '../../shared/styles';
-import { DialogContainer as ModalContainer } from '../Dialog/Dialog';
+import LayerManager, { LAYER_POSITION } from '../../shared/LayerManager.js';
+import { DialogContainer } from '../Dialog/Dialog.js';
+
+const modalPropTypes = {
+    /** Opens the modal */ open: PropTypes.bool.isRequired,
+    /** Closes the modal on esc */ closeOnEsc: PropTypes.bool,
+    /** Closes the modal on overlay click */ closeOnOverlayClick: PropTypes.bool,
+    /** Call back function called when the modal closes. */ onClose: PropTypes.func
+};
 class Modal extends React.Component {
-    constructor() {
-        super(...arguments);
-        this.state = {
-            open: false,
-        };
-        this.onClose = () => {
-            var _a, _b;
-            this.setState({
-                open: false,
-            });
-            (_b = (_a = this.props).onClose) === null || _b === void 0 ? void 0 : _b.call(_a);
-            this.closeCallback = null;
-            this.layer = null;
-        };
-    }
-    static getDerivedStateFromProps(props) {
+    /**
+     * Syncs state with props.
+     */ static getDerivedStateFromProps(props) {
         if (props.open) {
             return {
-                open: true,
+                open: true
             };
         }
         return null;
     }
-    getSnapshotBeforeUpdate(prevProps) {
-        var _a;
-        const _b = this.props, { open, closeOnEsc, closeOnOverlayClick, children } = _b, rest = __rest(_b, ["open", "closeOnEsc", "closeOnOverlayClick", "children"]);
+    /**
+     * Lifecycle method to save the currently focused element when the modal mounts while open.
+     */ componentDidMount() {
+        if (this.props.open) {
+            this.lastFocusedElement = document.activeElement;
+        }
+    }
+    /**
+     * Lifecycle method to restore focus when the modal unmounts.
+     */ componentWillUnmount() {
+        if (this.props.open) {
+            this.restoreFocus();
+        }
+        // Clean up layer references
+        if (this.closeCallback) {
+            this.closeCallback();
+            this.closeCallback = null;
+        }
+        this.layer = null;
+    }
+    /**
+     * Lifecycle method to handle Modal updates.
+     * Manages opening/closing logic via LayerManager and focus preservation.
+     */ getSnapshotBeforeUpdate(prevProps) {
+        const { open, closeOnEsc, closeOnOverlayClick, children, ...rest } = this.props;
         if (prevProps.open && !open) {
-            (_a = this.closeCallback) === null || _a === void 0 ? void 0 : _a.call(this);
+            this.closeCallback?.();
+            this.restoreFocus();
         }
         if (!prevProps.open && open) {
+            // Save current focus
+            this.lastFocusedElement = document.activeElement;
             this.layer = LayerManager.renderLayer({
                 overlay: true,
                 exitDelay: 300,
@@ -53,33 +60,123 @@ class Modal extends React.Component {
                 closeCallback: this.onClose,
                 closeOnEsc: closeOnEsc,
                 closeOnOverlayClick: closeOnOverlayClick,
-                component: (_jsx(ModalContainer, Object.assign({}, rest, { onClick: (e) => e.stopPropagation(), elevated: true, children: children }))),
+                component: /*#__PURE__*/ jsx(DialogContainer, {
+                    ...rest,
+                    ref: this.setModalRef,
+                    role: "dialog",
+                    "aria-modal": "true",
+                    tabIndex: -1,
+                    onKeyDown: this.handleKeyDown,
+                    onClick: (e)=>e.stopPropagation(),
+                    elevated: true,
+                    children: children
+                })
             });
             this.closeCallback = this.layer[1];
             this.forceUpdate();
         }
     }
-    render() {
+    /**
+     * Renders the Modal component via the LayerManager portal.
+     */ render() {
         if (this.state.open && this.layer) {
             const [Component] = this.layer;
-            return _jsx(Component, {});
+            return /*#__PURE__*/ jsx(Component, {});
         }
         return null;
     }
+    constructor(...args){
+        super(...args), this.state = {
+            open: false
+        }, /**
+     * Internal close handler.
+     * Restores focus and calls the external onClose callback.
+     */ this.onClose = ()=>{
+            this.restoreFocus();
+            this.setState({
+                open: false
+            });
+            this.props.onClose?.();
+            this.closeCallback = null;
+            this.layer = null;
+        }, this.lastFocusedElement = null, this.modalRef = /*#__PURE__*/ React.createRef(), /**
+     * Retrieves all focusable elements within the modal.
+     */ this.getFocusableElements = ()=>{
+            if (!this.modalRef.current) return [];
+            return Array.from(this.modalRef.current.querySelectorAll('button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'));
+        }, /**
+     * Handles keydown events to implement the focus trap.
+     * Traps Tab and Shift+Tab within the modal.
+     */ this.handleKeyDown = (e)=>{
+            if (e.key === 'Tab') {
+                const focusableElements = this.getFocusableElements();
+                if (focusableElements.length === 0) return;
+                const firstElement = focusableElements[0];
+                const lastElement = focusableElements[focusableElements.length - 1];
+                if (e.shiftKey) {
+                    if (document.activeElement === firstElement) {
+                        lastElement.focus();
+                        e.preventDefault();
+                    }
+                } else {
+                    if (document.activeElement === lastElement) {
+                        firstElement.focus();
+                        e.preventDefault();
+                    }
+                }
+            }
+        }, /**
+     * Restores focus to the element that was focused before the modal opened.
+     */ this.restoreFocus = ()=>{
+            if (this.lastFocusedElement) {
+                // Check if the element is still in the document
+                const elementToBeFocused = this.lastFocusedElement;
+                this.lastFocusedElement = null;
+                setTimeout(()=>{
+                    if (document.body.contains(elementToBeFocused)) {
+                        elementToBeFocused.focus();
+                    }
+                }, 100);
+            }
+        }, /**
+     * Callback ref to capture the Modal DOM element.
+     * Triggers initial focus setting when the element mounts.
+     */ this.setModalRef = (node)=>{
+            // Update ref
+            this.modalRef.current = node;
+            if (node) {
+                // Set initial focus when the node is mounted
+                this.setInitialFocus(node);
+            }
+        }, /**
+     * Sets initial focus within the modal.
+     * Tries to focus the header (first child) first, then the first interactive element, or falls back to the container.
+     */ this.setInitialFocus = (root)=>{
+            // Try to find the header (assumed to be the first child)
+            const firstChild = root.firstElementChild;
+            if (firstChild) {
+                // Ensure it's focusable
+                if (firstChild.getAttribute('tabindex') === null) {
+                    firstChild.setAttribute('tabindex', '-1');
+                }
+                firstChild.focus();
+                return;
+            }
+            // Fallback to focusable elements
+            const focusableElements = this.getFocusableElements();
+            if (focusableElements.length > 0) {
+                focusableElements[0].focus();
+            } else {
+                // Fallback to container
+                root.focus();
+            }
+        };
+    }
 }
-Modal.propTypes = {
-    /** Opens the modal */
-    open: PropTypes.bool.isRequired,
-    /** Closes the modal on esc */
-    closeOnEsc: PropTypes.bool,
-    /** Closes the modal on overlay click */
-    closeOnOverlayClick: PropTypes.bool,
-    /** Call back function called when the modal closes. */
-    onClose: PropTypes.func,
-};
+Modal.propTypes = modalPropTypes;
 Modal.defaultProps = {
     closeOnEsc: true,
-    closeOnOverlayClick: true,
+    closeOnOverlayClick: true
 };
-export default Modal;
-//# sourceMappingURL=Modal.js.map
+
+export { Modal as default };

package/lib-esm/components/Modal/index.d.ts

@@ -1,2 +1 @@
 export { default as Modal, ModalHeader, ModalBody, ModalFooter } from './Modal';
-//# sourceMappingURL=index.d.ts.map

package/lib-esm/components/Notification/Notification.d.ts

@@ -23,6 +23,8 @@ export declare class StoryProps extends React.Component<NotificationProps> {
         buttonClick: PropTypes.Requireable<(...args: any[]) => any>;
         /** Notification close callback. */
         onClose: PropTypes.Requireable<(...args: any[]) => any>;
+        /** Aria label for the close button on the notification. Defaults to "Close notification" */
+        closeButtonAriaLabel: PropTypes.Requireable<string>;
     };
     static defaultProps: {
         duration: number;
@@ -42,7 +44,7 @@ declare class Notification {
      * @param options - Configuration options for the notification
      * @returns The notification ID or a promise that resolves to the notification ID
      */
-    add: (position: NOTIFICATION_POSITION, options: NotificationOptions) => string | Promise<unknown>;
+    add: (position: NOTIFICATION_POSITION, options: NotificationOptions, ariaLabel?: string) => Promise<string>;
     /**
      * Removes a notification
      *
@@ -61,4 +63,3 @@ declare class Notification {
 /** Export a singleton instance */
 declare const _default: Notification;
 export default _default;
-//# sourceMappingURL=Notification.d.ts.map

package/lib-esm/components/Notification/Notification.js

@@ -1,70 +1,57 @@
-import { jsx as _jsx } from "@emotion/react/jsx-runtime";
+import { jsx } from '@emotion/react/jsx-runtime';
 import React from 'react';
 import PropTypes from 'prop-types';
 import { flushSync } from 'react-dom';
 import { createRoot } from 'react-dom/client';
-import LayerManager, { LAYER_POSITION } from '../../shared/LayerManager';
-import NotificationManager from './NotificationManager';
-import { NOTIFICATION_POSITION, NOTIFICATION_TYPE } from './types';
-/** This component is only used for storybook documentation */
-export class StoryProps extends React.Component {
+import LayerManager, { LAYER_POSITION } from '../../shared/LayerManager.js';
+import NotificationManager from './NotificationManager.js';
+import { NOTIFICATION_POSITION, NOTIFICATION_TYPE } from './types.js';
+
+/** This component is only used for storybook documentation */ class StoryProps extends React.Component {
     render() {
         return null;
     }
 }
 StoryProps.propTypes = {
-    /** Title of the notification */
-    title: PropTypes.string.isRequired,
-    /** Body of the notification */
-    description: PropTypes.string.isRequired,
-    /** Id for the notification, helps in de-duplication. */
-    id: PropTypes.string,
-    /** Duration for the notification in milliseconds */
-    duration: PropTypes.number,
-    /** Creates sticky notification */
-    sticky: PropTypes.bool,
-    /** Type of notification */
-    type: PropTypes.oneOf([
+    /** Title of the notification */ title: PropTypes.string.isRequired,
+    /** Body of the notification */ description: PropTypes.string.isRequired,
+    /** Id for the notification, helps in de-duplication. */ id: PropTypes.string,
+    /** Duration for the notification in milliseconds */ duration: PropTypes.number,
+    /** Creates sticky notification */ sticky: PropTypes.bool,
+    /** Type of notification */ type: PropTypes.oneOf([
         NOTIFICATION_TYPE.INFO,
         NOTIFICATION_TYPE.SUCCESS,
         NOTIFICATION_TYPE.WARNING,
-        NOTIFICATION_TYPE.DANGER,
+        NOTIFICATION_TYPE.DANGER
     ]),
-    /** Action button text */
-    buttonText: PropTypes.string,
-    /** Action button click callback */
-    buttonClick: PropTypes.func,
-    /** Notification close callback. */
-    onClose: PropTypes.func,
+    /** Action button text */ buttonText: PropTypes.string,
+    /** Action button click callback */ buttonClick: PropTypes.func,
+    /** Notification close callback. */ onClose: PropTypes.func,
+    /** Aria label for the close button on the notification. Defaults to "Close notification" */ closeButtonAriaLabel: PropTypes.string
 };
 StoryProps.defaultProps = {
     duration: 5000,
     sticky: false,
-    type: NOTIFICATION_TYPE.INFO,
+    type: NOTIFICATION_TYPE.INFO
 };
-/** Maps notification position to layer position */
-const positionMap = {
+/** Maps notification position to layer position */ const positionMap = {
     [NOTIFICATION_POSITION.TOP_LEFT]: LAYER_POSITION.TOP_LEFT,
     [NOTIFICATION_POSITION.TOP_RIGHT]: LAYER_POSITION.TOP_RIGHT,
     [NOTIFICATION_POSITION.BOTTOM_LEFT]: LAYER_POSITION.BOTTOM_LEFT,
-    [NOTIFICATION_POSITION.BOTTOM_RIGHT]: LAYER_POSITION.BOTTOM_RIGHT,
+    [NOTIFICATION_POSITION.BOTTOM_RIGHT]: LAYER_POSITION.BOTTOM_RIGHT
 };
-/** Notification class */
-class Notification {
-    constructor() {
-        /** Helps in maintaining single instance for different positions. */
-        this.containers = new Map();
+/** Notification class */ class Notification {
+    constructor(){
+        /** Helps in maintaining single instance for different positions. */ this.containers = new Map();
         /**
-         * Adds a notification
-         *
-         * @param position - The position where the notification should appear
-         * @param options - Configuration options for the notification
-         * @returns The notification ID or a promise that resolves to the notification ID
-         */
-        this.add = (position, options) => {
+     * Adds a notification
+     *
+     * @param position - The position where the notification should appear
+     * @param options - Configuration options for the notification
+     * @returns The notification ID or a promise that resolves to the notification ID
+     */ this.add = (position, options, ariaLabel = 'Notifications')=>{
             if (!this.containers.has(position)) {
-                /** Callback ref to capture the NotificationManager instance when it mounts */
-                const refCallback = (instance) => {
+                /** Callback ref to capture the NotificationManager instance when it mounts */ const refCallback = (instance)=>{
                     if (instance) {
                         const container = this.containers.get(position);
                         if (container) {
@@ -77,7 +64,12 @@ class Notification {
                     closeOnOverlayClick: false,
                     position: positionMap[position],
                     alwaysOnTop: true,
-                    component: (_jsx(NotificationManager, { ref: refCallback, position: position, onEmpty: () => this.destroy(position) })),
+                    component: /*#__PURE__*/ jsx(NotificationManager, {
+                        ref: refCallback,
+                        position: position,
+                        onEmpty: ()=>this.destroy(position),
+                        ariaLabel: ariaLabel
+                    })
                 });
                 // Create a div to mount the Component
                 const div = document.createElement('div');
@@ -86,11 +78,11 @@ class Notification {
                 this.containers.set(position, {
                     manager: null,
                     root,
-                    div,
+                    div
                 });
                 // Render the Component which will trigger the LayerManager's useEffect
-                flushSync(() => {
-                    root.render(_jsx(Component, {}));
+                flushSync(()=>{
+                    root.render(/*#__PURE__*/ jsx(Component, {}));
                 });
             }
             const container = this.containers.get(position);
@@ -98,8 +90,8 @@ class Notification {
                 return container.manager.add(options);
             }
             // If manager is not ready yet, wait a bit and retry
-            return new Promise((resolve) => {
-                setTimeout(() => {
+            return new Promise((resolve)=>{
+                setTimeout(()=>{
                     const container = this.containers.get(position);
                     if (container && container.manager) {
                         resolve(container.manager.add(options));
@@ -108,24 +100,22 @@ class Notification {
             });
         };
         /**
-         * Removes a notification
-         *
-         * @param position - The position of the notification container
-         * @param id - The unique ID of the notification to remove
-         */
-        this.remove = (position, id) => {
+     * Removes a notification
+     *
+     * @param position - The position of the notification container
+     * @param id - The unique ID of the notification to remove
+     */ this.remove = (position, id)=>{
             const container = this.containers.get(position);
             if (container && container.manager) {
                 container.manager.remove(id);
             }
         };
         /**
-         * Destroys entire stack of notifications at a position.
-         * Unmounts the React root and cleans up DOM elements.
-         *
-         * @param position - The position of the notification container to destroy
-         */
-        this.destroy = (position) => {
+     * Destroys entire stack of notifications at a position.
+     * Unmounts the React root and cleans up DOM elements.
+     *
+     * @param position - The position of the notification container to destroy
+     */ this.destroy = (position)=>{
             const container = this.containers.get(position);
             if (container) {
                 container.root.unmount();
@@ -137,6 +127,6 @@ class Notification {
         };
     }
 }
-/** Export a singleton instance */
-export default new Notification();
-//# sourceMappingURL=Notification.js.map
+/** Export a singleton instance */ var Notification$1 = new Notification();
+
+export { StoryProps, Notification$1 as default };

package/lib-esm/components/Notification/NotificationManager.d.ts

@@ -3,6 +3,7 @@ import { NOTIFICATION_POSITION, NotificationOptions } from './types';
 interface NotificationManagerProps {
     position: NOTIFICATION_POSITION;
     onEmpty: () => void;
+    ariaLabel?: string;
 }
 interface NoticeProp extends NotificationOptions {
     leaving?: boolean;
@@ -17,6 +18,8 @@ declare class NotificationManager extends React.Component<NotificationManagerPro
     state: NotificationManagerState;
     private timeouts;
     private set;
+    private politeRegionRef;
+    private assertiveRegionRef;
     /**
      * Removes a notification from stack if the notification with the given id is found.
      *
@@ -28,7 +31,14 @@ declare class NotificationManager extends React.Component<NotificationManagerPro
      *
      * @param notice
      */
-    add: (notice: NotificationOptions) => string;
+    add: (notice: NotificationOptions) => Promise<string>;
+    /**
+     * Update live region content with clear-then-set pattern for reliable VoiceOver announcements.
+     *
+     * @param content - The text content to announce
+     * @param isAssertive - Whether to use assertive (alert) or polite (log) live region
+     */
+    private updateLiveRegion;
     /**
      * Handler for close button click.
      *
@@ -47,7 +57,10 @@ declare class NotificationManager extends React.Component<NotificationManagerPro
      * @param id
      */
     resume: (id: string) => () => void;
+    /**
+     * Clean up all pending timeouts when component unmounts
+     */
+    componentWillUnmount(): void;
     render(): import("@emotion/react/jsx-runtime").JSX.Element;
 }
 export default NotificationManager;
-//# sourceMappingURL=NotificationManager.d.ts.map