no-frills-ui 0.0.14-alpha.8 → 0.0.14-rc.1

package/lib-esm/components/Menu/Menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"Menu.js","sources":["../../../src/components/Menu/Menu.tsx"],"sourcesContent":["import React, { useState, ReactNode, ForwardedRef } from 'react';\nimport styled from '@emotion/styled';\nimport { getThemeValue, THEME_NAME } from '../../shared/constants';\nimport MenuContext from './MenuContext';\n/**\n * Props for the Menu component.\n * @template T - The type of value(s) in the menu.\n */\ninterface MenuProps<T> {\n    /** Multiple Menu Items can be selected */\n    multiSelect?: boolean;\n    /** Value(s) selected */\n    value?: T | T[];\n    /** Callback when the selected value changes */\n    onChange?: (value: T | T[]) => void;\n    /** Menu Items */\n    children?: ReactNode;\n}\n\nconst MenuContainer = styled.div`\n    flex: 1;\n    display: flex;\n    flex-direction: column;\n\n    & div:last-child {\n        border-bottom: none;\n    }\n\n    &:focus-within {\n        box-shadow: 0 0 0 4px ${getThemeValue(THEME_NAME.PRIMARY_LIGHT)};\n    }\n`;\n\n/**\n * Menu component that allows selection of items from a list.\n * Supports single and multi-select modes and keyboard navigation.\n *\n * @template T - The type of value(s) in the menu.\n * @param {MenuProps<T> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>} props - The menu properties.\n * @param {ForwardedRef<HTMLDivElement>} ref - The ref forwarded to the menu container.\n */\nconst Menu = React.forwardRef(function <T extends object>(\n    props: MenuProps<T> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>,\n    ref: ForwardedRef<HTMLDivElement>,\n) {\n    const { multiSelect, onChange, value: propValue, ...rest } = props;\n    const [value, setValue] = useState(propValue || (multiSelect ? [] : ''));\n\n    /**\n     * Updates the selected value(s).\n     * Handles both single and multi-select logic.\n     *\n     * @param {T} val - The value to select or deselect.\n     */\n    const updateValue = (val: T) => {\n        let newVal;\n        if (multiSelect) {\n            if (Array.isArray(value)) {\n                if (value.includes(val)) {\n                    newVal = value.filter((item) => item !== val);\n                } else {\n                    newVal = [...value, val];\n                }\n            }\n        } else {\n            newVal = val;\n        }\n        setValue(newVal);\n        onChange?.(newVal);\n    };\n\n    /**\n     * Handles keyboard navigation within the menu.\n     * Supports Arrow keys for navigation, and Enter/Space for selection.\n     *\n     * @param {React.KeyboardEvent} e - The keyboard event.\n     */\n    const handleKeyDown = (e: React.KeyboardEvent) => {\n        const target = e.target as HTMLElement;\n        const container = e.currentTarget as HTMLElement;\n        const items = Array.from(container.querySelectorAll('[role=\"option\"]')) as HTMLElement[];\n        const currentIndex = items.indexOf(target as HTMLElement);\n\n        let nextIndex;\n\n        switch (e.key) {\n            case 'ArrowDown':\n                e.preventDefault();\n                nextIndex = currentIndex + 1;\n                if (nextIndex >= items.length) nextIndex = 0;\n                items[nextIndex]?.focus();\n                break;\n            case 'ArrowUp':\n                e.preventDefault();\n                nextIndex = currentIndex - 1;\n                if (nextIndex < 0) nextIndex = items.length - 1;\n                items[nextIndex]?.focus();\n                break;\n            case 'Home':\n                e.preventDefault();\n                items[0]?.focus();\n                break;\n            case 'End':\n                e.preventDefault();\n                items[items.length - 1]?.focus();\n                break;\n            case 'Enter':\n            case ' ': // Space\n                e.preventDefault();\n                target.click();\n                break;\n            default:\n                break;\n        }\n    };\n\n    /**\n     * Handles focus events on the menu container.\n     * Delegates focus to the first item if the container itself receives focus.\n     *\n     * @param {React.FocusEvent} e - The focus event.\n     */\n    const focusHandler = (e: React.FocusEvent) => {\n        // Prevent trap: If focus came from inside (Shift+Tab), do NOT auto-focus again.\n        // This allows focus to land on the container, and the next Shift+Tab will exit.\n        if (e.currentTarget.contains(e.relatedTarget as Node)) {\n            return;\n        }\n\n        // Only if focus is actually on the container (e.g. tabbing into it)\n        // and not bubbling up from a child\n        if (e.target === e.currentTarget) {\n            // Prevent the container from holding focus; delegate to first item\n            const firstItem = e.currentTarget.querySelector('[role=\"option\"]') as HTMLElement;\n            firstItem?.focus();\n        }\n    };\n\n    return (\n        <MenuContext.Provider\n            value={\n                {\n                    value,\n                    multiSelect,\n                    updateValue,\n                } as unknown as React.ContextType<typeof MenuContext>\n            }\n        >\n            <MenuContainer\n                {...rest}\n                ref={ref}\n                role=\"listbox\"\n                aria-multiselectable={multiSelect}\n                tabIndex={0}\n                onKeyDown={handleKeyDown}\n                onFocus={focusHandler}\n            >\n                {props.children}\n            </MenuContainer>\n        </MenuContext.Provider>\n    );\n});\n\nMenu.displayName = 'Menu';\n\nMenu.defaultProps = {\n    multiSelect: false,\n};\n\nexport default Menu;\n"],"names":["MenuContainer","styled","getThemeValue","THEME_NAME","PRIMARY_LIGHT","Menu","React","forwardRef","props","ref","multiSelect","onChange","value","propValue","rest","setValue","useState","updateValue","val","newVal","Array","isArray","includes","filter","item","handleKeyDown","e","target","container","currentTarget","items","from","querySelectorAll","currentIndex","indexOf","nextIndex","key","preventDefault","length","focus","click","focusHandler","contains","relatedTarget","firstItem","querySelector","_jsx","MenuContext","Provider","role","aria-multiselectable","tabIndex","onKeyDown","onFocus","children","displayName","defaultProps"],"mappings":"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"}
+{"version":3,"file":"Menu.js","sources":["../../../src/components/Menu/Menu.tsx"],"sourcesContent":["import React, { useState, ForwardedRef } from 'react';\nimport styled from '@emotion/styled';\nimport { getThemeValue, THEME_NAME } from '../../shared/constants';\nimport MenuContext from './MenuContext';\n/**\n * Props for the Menu component.\n * @template T - The type of value(s) in the menu.\n */\ntype MenuProps<T> = {\n    /** Multiple Menu Items can be selected */\n    multiSelect?: boolean;\n    /** Value(s) selected */\n    value?: T | T[];\n    /** Callback when the selected value changes */\n    onChange?: (value: T | T[]) => void;\n} & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>;\n\nconst MenuContainer = styled.div`\n    flex: 1;\n    display: flex;\n    flex-direction: column;\n\n    & div:last-child {\n        border-bottom: none;\n    }\n\n    &:focus-within {\n        box-shadow: 0 0 0 4px ${getThemeValue(THEME_NAME.PRIMARY_LIGHT)};\n    }\n`;\n\n/**\n * Menu component that allows selection of items from a list.\n * Supports single and multi-select modes and keyboard navigation.\n *\n * @template T - The type of value(s) in the menu.\n * @param props - The menu properties.\n * @param ref - The ref forwarded to the menu container.\n */\n/**\n * Menu Component\n * @template T - The type of value(s) in the menu.\n * @param props - Component props\n * @param ref - Ref forwarded to the underlying HTMLDivElement\n */\nfunction MenuInner<T>(props: MenuProps<T>, ref: ForwardedRef<HTMLDivElement>) {\n    const { multiSelect = false, onChange, value: propValue, children, ...rest } = props;\n    // State holds either a single T or an array of T when multiSelect\n    const [value, setValue] = useState<unknown | undefined>(propValue);\n\n    /**\n     * Updates the selected value(s).\n     * Handles both single and multi-select logic.\n     *\n     * @param {T} val - The value to select or deselect.\n     */\n    const updateValue = (val: unknown) => {\n        let newVal: unknown;\n        if (multiSelect) {\n            if (Array.isArray(value)) {\n                if (value.includes(val as unknown as T)) {\n                    newVal = (value as T[]).filter((item) => item !== val);\n                } else {\n                    newVal = [...(value as T[]), val];\n                }\n            } else {\n                newVal = [val];\n            }\n        } else {\n            newVal = val;\n        }\n\n        setValue(newVal as T | T[]);\n        onChange?.(newVal as T | T[]);\n    };\n\n    /**\n     * Handles keyboard navigation within the menu.\n     * Supports Arrow keys for navigation, and Enter/Space for selection.\n     *\n     * @param {React.KeyboardEvent} e - The keyboard event.\n     */\n    const handleKeyDown = (e: React.KeyboardEvent) => {\n        const target = e.target as HTMLElement;\n        const container = e.currentTarget as HTMLElement;\n        const items = Array.from(container.querySelectorAll('[role=\"option\"]')) as HTMLElement[];\n        const currentIndex = items.indexOf(target as HTMLElement);\n\n        let nextIndex;\n\n        switch (e.key) {\n            case 'ArrowDown':\n                e.preventDefault();\n                nextIndex = currentIndex + 1;\n                if (nextIndex >= items.length) nextIndex = 0;\n                items[nextIndex]?.focus();\n                break;\n            case 'ArrowUp':\n                e.preventDefault();\n                nextIndex = currentIndex - 1;\n                if (nextIndex < 0) nextIndex = items.length - 1;\n                items[nextIndex]?.focus();\n                break;\n            case 'Home':\n                e.preventDefault();\n                items[0]?.focus();\n                break;\n            case 'End':\n                e.preventDefault();\n                items[items.length - 1]?.focus();\n                break;\n            case 'Enter':\n            case ' ': // Space\n                e.preventDefault();\n                target.click();\n                break;\n            default:\n                break;\n        }\n    };\n\n    /**\n     * Handles focus events on the menu container.\n     * Delegates focus to the first item if the container itself receives focus.\n     *\n     * @param {React.FocusEvent} e - The focus event.\n     */\n    const focusHandler = (e: React.FocusEvent) => {\n        // Prevent trap: If focus came from inside (Shift+Tab), do NOT auto-focus again.\n        // This allows focus to land on the container, and the next Shift+Tab will exit.\n        if (e.currentTarget.contains(e.relatedTarget as Node)) {\n            return;\n        }\n\n        // Only if focus is actually on the container (e.g. tabbing into it)\n        // and not bubbling up from a child\n        if (e.target === e.currentTarget) {\n            // Prevent the container from holding focus; delegate to first item\n            const firstItem = e.currentTarget.querySelector('[role=\"option\"]') as HTMLElement;\n            firstItem?.focus();\n        }\n    };\n\n    return (\n        // @ts-expect-error Generic context typing\n        <MenuContext.Provider value={{ value: value, multiSelect: !!multiSelect, updateValue }}>\n            <MenuContainer\n                {...rest}\n                ref={ref}\n                role=\"listbox\"\n                aria-multiselectable={multiSelect}\n                tabIndex={0}\n                onKeyDown={handleKeyDown}\n                onFocus={focusHandler}\n            >\n                {children}\n            </MenuContainer>\n        </MenuContext.Provider>\n    );\n}\n\nconst Menu = React.forwardRef(MenuInner) as <T>(\n    props: MenuProps<T> & React.RefAttributes<HTMLDivElement>,\n) => React.ReactElement;\n\nexport default Menu;\n"],"names":["MenuContainer","styled","getThemeValue","THEME_NAME","PRIMARY_LIGHT","MenuInner","props","ref","multiSelect","onChange","value","propValue","children","rest","setValue","useState","updateValue","val","newVal","Array","isArray","includes","filter","item","handleKeyDown","e","target","container","currentTarget","items","from","querySelectorAll","currentIndex","indexOf","nextIndex","key","preventDefault","length","focus","click","focusHandler","contains","relatedTarget","firstItem","querySelector","_jsx","MenuContext","Provider","role","aria-multiselectable","tabIndex","onKeyDown","onFocus","Menu","React","forwardRef"],"mappings":"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"}

package/lib-esm/components/Menu/MenuContext.d.ts

@@ -1,13 +1,13 @@
 type SingleSelect<T> = {
-    value: T;
+    value?: T;
     multiSelect: false;
     updateValue: (newVal: T) => void;
 };
 type MultiSelect<T> = {
-    value: T[];
+    value?: T[];
     multiSelect: true;
-    updateValue: (newVal: T[]) => void;
+    updateValue: (newVal: T) => void;
 };
 export type MenuContextType<T> = SingleSelect<T> | MultiSelect<T>;
-declare const _default: import("react").Context<MenuContextType<object>>;
+declare const _default: import("react").Context<MenuContextType<unknown> | undefined>;
 export default _default;

package/lib-esm/components/Menu/MenuContext.js

@@ -1,5 +1,6 @@
 import { createContext } from 'react';
 
+// Context may be undefined if used outside a Menu provider
 var MenuContext = createContext(undefined);
 
 export { MenuContext as default };

package/lib-esm/components/Menu/MenuContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuContext.js","sources":["../../../src/components/Menu/MenuContext.ts"],"sourcesContent":["import { createContext } from 'react';\n\ntype SingleSelect<T> = {\n    value: T;\n    multiSelect: false;\n    updateValue: (newVal: T) => void;\n};\n\ntype MultiSelect<T> = {\n    value: T[];\n    multiSelect: true;\n    updateValue: (newVal: T[]) => void;\n};\nexport type MenuContextType<T> = SingleSelect<T> | MultiSelect<T>;\n\nexport default createContext<MenuContextType<object>>(undefined);\n"],"names":["createContext","undefined"],"mappings":";;AAeA,kBAAeA,cAAuCC,SAAAA,CAAAA;;;;"}
+{"version":3,"file":"MenuContext.js","sources":["../../../src/components/Menu/MenuContext.ts"],"sourcesContent":["import { createContext } from 'react';\n\ntype SingleSelect<T> = {\n    value?: T;\n    multiSelect: false;\n    updateValue: (newVal: T) => void;\n};\n\ntype MultiSelect<T> = {\n    value?: T[];\n    multiSelect: true;\n    // updateValue takes a single item and the provider will add/remove it\n    updateValue: (newVal: T) => void;\n};\nexport type MenuContextType<T> = SingleSelect<T> | MultiSelect<T>;\n\n// Context may be undefined if used outside a Menu provider\nexport default createContext<MenuContextType<unknown> | undefined>(undefined);\n"],"names":["createContext","undefined"],"mappings":";;AAgBA;AACA,kBAAeA,cAAoDC,SAAAA,CAAAA;;;;"}

package/lib-esm/components/Menu/MenuItem.d.ts

@@ -1,10 +1,16 @@
 import React from 'react';
-interface MenuItemProps<T> {
+type MenuItemProps<T> = {
     /** Value of the element */
     value: T;
-}
-declare const MenuItemInner: <T>(props: MenuItemProps<T> & React.PropsWithChildren, ref: React.Ref<HTMLButtonElement>) => import("@emotion/react/jsx-runtime").JSX.Element;
-declare const MenuItem: <T>(props: MenuItemProps<T> & React.PropsWithChildren & {
+} & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'value'>;
+/**
+ * MenuItem Component
+ * @template T - The type of value in the menu item.
+ * @param props - Component props
+ * @param ref - Ref forwarded to the underlying HTMLButtonElement
+ */
+declare const MenuItemInner: <T>(props: MenuItemProps<T>, ref: React.Ref<HTMLButtonElement>) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const MenuItem: <T>(props: MenuItemProps<T> & {
     ref?: React.Ref<HTMLButtonElement>;
 }) => ReturnType<typeof MenuItemInner>;
 export default MenuItem;

package/lib-esm/components/Menu/MenuItem.js

@@ -5,19 +5,33 @@ import { getThemeValue, THEME_NAME } from '../../shared/constants.js';
 import Checkbox from '../Input/Checkbox.js';
 import MenuContext from './MenuContext.js';
 
-const Container = /*#__PURE__*/ styled("button", {
-    target: "ea4jlaf0",
+const Container$4 = /*#__PURE__*/ styled("button", {
+    target: "ebwocs30",
     label: "Container"
 })("font-weight:", (props)=>props.selected ? 'bold' : 'normal', ";padding:8px;border:none;border-left:4px solid\n        ", (props)=>props.selected && !props.multiselect ? getThemeValue(THEME_NAME.TEXT_COLOR_DARK) : 'transparent', ";background-color:transparent;font-size:16px;border-bottom:1px solid ", getThemeValue(THEME_NAME.BORDER_LIGHT_COLOR), ";min-height:41px;display:flex;align-items:center;cursor:pointer;position:relative;color:", getThemeValue(THEME_NAME.TEXT_COLOR_DARK), ";&:hover,&:focus,&:focus-within{background-color:", getThemeValue(THEME_NAME.BORDER_LIGHT_COLOR), ";}& > label{margin:0 4px 0 0;}");
-const MenuItemInner = (props, ref)=>{
+/**
+ * MenuItem Component
+ * @template T - The type of value in the menu item.
+ * @param props - Component props
+ * @param ref - Ref forwarded to the underlying HTMLButtonElement
+ */ const MenuItemInner = (props, ref)=>{
     const context = useContext(MenuContext);
+    if (!context) {
+        throw new Error('`MenuItem` must be used within a `Menu` provider');
+    }
     const { value, children, ...rest } = props;
     const clickHandler = (e)=>{
         e.stopPropagation();
         context.updateValue(value);
     };
-    const selected = context.multiSelect ? context.value?.includes?.(value) : context.value === value;
-    return /*#__PURE__*/ jsxs(Container, {
+    let selected = false;
+    if (context.multiSelect) {
+        const arr = context.value;
+        selected = Array.isArray(arr) && arr.includes(value);
+    } else {
+        selected = context.value === value;
+    }
+    return /*#__PURE__*/ jsxs(Container$4, {
         ...rest,
         ref: ref,
         type: "button",

package/lib-esm/components/Menu/MenuItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuItem.js","sources":["../../../src/components/Menu/MenuItem.tsx"],"sourcesContent":["import React, { SyntheticEvent, useContext } from 'react';\nimport styled from '@emotion/styled';\nimport { getThemeValue, THEME_NAME } from '../../shared/constants';\nimport Checkbox from '../Input/Checkbox';\nimport MenuContext, { MenuContextType } from './MenuContext';\n\ninterface MenuItemProps<T> {\n    /** Value of the element */\n    value: T;\n}\n\nconst Container = styled.button<{ selected: boolean; multiselect?: boolean }>`\n    font-weight: ${(props) => (props.selected ? 'bold' : 'normal')};\n    padding: 8px;\n    border: none;\n    border-left: 4px solid\n        ${(props) =>\n            props.selected && !props.multiselect\n                ? getThemeValue(THEME_NAME.TEXT_COLOR_DARK)\n                : 'transparent'};\n    background-color: transparent;\n    font-size: 16px;\n    border-bottom: 1px solid ${getThemeValue(THEME_NAME.BORDER_LIGHT_COLOR)};\n    min-height: 41px;\n    display: flex;\n    align-items: center;\n    cursor: pointer;\n    position: relative;\n    color: ${getThemeValue(THEME_NAME.TEXT_COLOR_DARK)};\n\n    &:hover,\n    &:focus,\n    &:focus-within {\n        background-color: ${getThemeValue(THEME_NAME.BORDER_LIGHT_COLOR)};\n    }\n\n    & > label {\n        margin: 0 4px 0 0;\n    }\n`;\n\nconst MenuItemInner = <T,>(\n    props: MenuItemProps<T> & React.PropsWithChildren,\n    ref: React.Ref<HTMLButtonElement>,\n) => {\n    const context = useContext(MenuContext) as MenuContextType<T>;\n    const { value, children, ...rest } = props;\n    const clickHandler = (e: SyntheticEvent) => {\n        e.stopPropagation();\n        context.updateValue(value as T & T[]);\n    };\n\n    const selected = context.multiSelect\n        ? context.value?.includes?.(value)\n        : context.value === value;\n\n    return (\n        <Container\n            {...rest}\n            ref={ref}\n            type=\"button\"\n            role=\"option\"\n            aria-selected={selected}\n            selected={selected}\n            onClick={clickHandler}\n            multiselect={context.multiSelect ? true : undefined}\n        >\n            {context.multiSelect && (\n                <Checkbox\n                    checked={selected}\n                    readOnly\n                    tabIndex={-1}\n                    onClick={(e) => e.stopPropagation()}\n                />\n            )}\n            {children}\n        </Container>\n    );\n};\n\nconst MenuItem = React.forwardRef(MenuItemInner) as <T>(\n    props: MenuItemProps<T> & React.PropsWithChildren & { ref?: React.Ref<HTMLButtonElement> },\n) => ReturnType<typeof MenuItemInner>;\n\nexport default MenuItem;\n"],"names":["Container","styled","props","selected","multiselect","getThemeValue","THEME_NAME","TEXT_COLOR_DARK","BORDER_LIGHT_COLOR","MenuItemInner","ref","context","useContext","MenuContext","value","children","rest","clickHandler","e","stopPropagation","updateValue","multiSelect","includes","_jsxs","type","role","aria-selected","onClick","undefined","_jsx","Checkbox","checked","readOnly","tabIndex","MenuItem","React","forwardRef"],"mappings":";;;;;;;AAWA,MAAMA,SAAAA,iBAAYC,MAAAA,CAAAA,QAAAA,EAAAA;;;AACC,CAAA,CAAA,CAAA,cAAA,EAAA,CAACC,KAAAA,GAAWA,KAAAA,CAAMC,QAAQ,GAAG,MAAA,GAAS,QAAA,EAAA,0DAAA,EAI/C,CAACD,KAAAA,GACCA,KAAAA,CAAMC,QAAQ,IAAI,CAACD,MAAME,WAAW,GAC9BC,aAAAA,CAAcC,UAAAA,CAAWC,eAAe,CAAA,GACxC,aAAA,EAAA,uEAAA,EAGaF,aAAAA,CAAcC,UAAAA,CAAWE,kBAAkB,CAAA,EAAA,0FAAA,EAM7DH,aAAAA,CAAcC,UAAAA,CAAWC,eAAe,CAAA,EAAA,mDAAA,EAKzBF,aAAAA,CAAcC,WAAWE,kBAAkB,CAAA,EAAA,gCAAA,CAAA;AAQvE,MAAMC,aAAAA,GAAgB,CAClBP,KAAAA,EACAQ,GAAAA,GAAAA;AAEA,IAAA,MAAMC,UAAUC,UAAAA,CAAWC,WAAAA,CAAAA;AAC3B,IAAA,MAAM,EAAEC,KAAK,EAAEC,QAAQ,EAAE,GAAGC,MAAM,GAAGd,KAAAA;AACrC,IAAA,MAAMe,eAAe,CAACC,CAAAA,GAAAA;AAClBA,QAAAA,CAAAA,CAAEC,eAAe,EAAA;AACjBR,QAAAA,OAAAA,CAAQS,WAAW,CAACN,KAAAA,CAAAA;AACxB,IAAA,CAAA;IAEA,MAAMX,QAAAA,GAAWQ,OAAAA,CAAQU,WAAW,GAC9BV,OAAAA,CAAQG,KAAK,EAAEQ,QAAAA,GAAWR,KAAAA,CAAAA,GAC1BH,OAAAA,CAAQG,KAAK,KAAKA,KAAAA;AAExB,IAAA,qBACIS,IAAA,CAACvB,SAAAA,EAAAA;AACI,QAAA,GAAGgB,IAAI;QACRN,GAAAA,EAAKA,GAAAA;QACLc,IAAAA,EAAK,QAAA;QACLC,IAAAA,EAAK,QAAA;QACLC,eAAAA,EAAevB,QAAAA;QACfA,QAAAA,EAAUA,QAAAA;QACVwB,OAAAA,EAASV,YAAAA;QACTb,WAAAA,EAAaO,OAAAA,CAAQU,WAAW,GAAG,IAAA,GAAOO,SAAAA;;YAEzCjB,OAAAA,CAAQU,WAAW,kBAChBQ,GAAA,CAACC,QAAAA,EAAAA;gBACGC,OAAAA,EAAS5B,QAAAA;gBACT6B,QAAQ,EAAA,IAAA;AACRC,gBAAAA,QAAAA,EAAU,EAAC;gBACXN,OAAAA,EAAS,CAACT,CAAAA,GAAMA,CAAAA,CAAEC,eAAe;;AAGxCJ,YAAAA;;;AAGb,CAAA;AAEA,MAAMmB,QAAAA,iBAAWC,KAAAA,CAAMC,UAAU,CAAC3B,aAAAA;;;;"}
+{"version":3,"file":"MenuItem.js","sources":["../../../src/components/Menu/MenuItem.tsx"],"sourcesContent":["import React, { SyntheticEvent, useContext } from 'react';\nimport styled from '@emotion/styled';\nimport { getThemeValue, THEME_NAME } from '../../shared/constants';\nimport Checkbox from '../Input/Checkbox';\nimport MenuContext, { MenuContextType } from './MenuContext';\n\ntype MenuItemProps<T> = {\n    /** Value of the element */\n    value: T;\n} & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'value'>;\n\nconst Container = styled.button<{ selected: boolean; multiselect?: boolean }>`\n    font-weight: ${(props) => (props.selected ? 'bold' : 'normal')};\n    padding: 8px;\n    border: none;\n    border-left: 4px solid\n        ${(props) =>\n            props.selected && !props.multiselect\n                ? getThemeValue(THEME_NAME.TEXT_COLOR_DARK)\n                : 'transparent'};\n    background-color: transparent;\n    font-size: 16px;\n    border-bottom: 1px solid ${getThemeValue(THEME_NAME.BORDER_LIGHT_COLOR)};\n    min-height: 41px;\n    display: flex;\n    align-items: center;\n    cursor: pointer;\n    position: relative;\n    color: ${getThemeValue(THEME_NAME.TEXT_COLOR_DARK)};\n\n    &:hover,\n    &:focus,\n    &:focus-within {\n        background-color: ${getThemeValue(THEME_NAME.BORDER_LIGHT_COLOR)};\n    }\n\n    & > label {\n        margin: 0 4px 0 0;\n    }\n`;\n\n/**\n * MenuItem Component\n * @template T - The type of value in the menu item.\n * @param props - Component props\n * @param ref - Ref forwarded to the underlying HTMLButtonElement\n */\nconst MenuItemInner = <T,>(props: MenuItemProps<T>, ref: React.Ref<HTMLButtonElement>) => {\n    const context = useContext(MenuContext) as MenuContextType<T> | undefined;\n    if (!context) {\n        throw new Error('`MenuItem` must be used within a `Menu` provider');\n    }\n    const { value, children, ...rest } = props;\n    const clickHandler = (e: SyntheticEvent) => {\n        e.stopPropagation();\n        context.updateValue(value as T);\n    };\n\n    let selected = false;\n    if (context.multiSelect) {\n        const arr = context.value as unknown as T[] | undefined;\n        selected = Array.isArray(arr) && arr.includes(value as unknown as T);\n    } else {\n        selected = (context.value as unknown as T) === value;\n    }\n\n    return (\n        <Container\n            {...rest}\n            ref={ref}\n            type=\"button\"\n            role=\"option\"\n            aria-selected={selected}\n            selected={selected}\n            onClick={clickHandler}\n            multiselect={context.multiSelect ? true : undefined}\n        >\n            {context.multiSelect && (\n                <Checkbox\n                    checked={selected}\n                    readOnly\n                    tabIndex={-1}\n                    onClick={(e) => e.stopPropagation()}\n                />\n            )}\n            {children}\n        </Container>\n    );\n};\n\nconst MenuItem = React.forwardRef(MenuItemInner) as <T>(\n    props: MenuItemProps<T> & { ref?: React.Ref<HTMLButtonElement> },\n) => ReturnType<typeof MenuItemInner>;\nexport default MenuItem;\n"],"names":["Container","styled","props","selected","multiselect","getThemeValue","THEME_NAME","TEXT_COLOR_DARK","BORDER_LIGHT_COLOR","MenuItemInner","ref","context","useContext","MenuContext","Error","value","children","rest","clickHandler","e","stopPropagation","updateValue","multiSelect","arr","Array","isArray","includes","_jsxs","type","role","aria-selected","onClick","undefined","_jsx","Checkbox","checked","readOnly","tabIndex","MenuItem","React","forwardRef"],"mappings":";;;;;;;AAWA,MAAMA,WAAAA,iBAAYC,MAAAA,CAAAA,QAAAA,EAAAA;;;AACC,CAAA,CAAA,CAAA,cAAA,EAAA,CAACC,KAAAA,GAAWA,KAAAA,CAAMC,QAAQ,GAAG,MAAA,GAAS,QAAA,EAAA,0DAAA,EAI/C,CAACD,KAAAA,GACCA,KAAAA,CAAMC,QAAQ,IAAI,CAACD,MAAME,WAAW,GAC9BC,aAAAA,CAAcC,UAAAA,CAAWC,eAAe,CAAA,GACxC,aAAA,EAAA,uEAAA,EAGaF,aAAAA,CAAcC,UAAAA,CAAWE,kBAAkB,CAAA,EAAA,0FAAA,EAM7DH,aAAAA,CAAcC,UAAAA,CAAWC,eAAe,CAAA,EAAA,mDAAA,EAKzBF,aAAAA,CAAcC,WAAWE,kBAAkB,CAAA,EAAA,gCAAA,CAAA;AAQvE;;;;;IAMA,MAAMC,aAAAA,GAAgB,CAAKP,KAAAA,EAAyBQ,GAAAA,GAAAA;AAChD,IAAA,MAAMC,UAAUC,UAAAA,CAAWC,WAAAA,CAAAA;AAC3B,IAAA,IAAI,CAACF,OAAAA,EAAS;AACV,QAAA,MAAM,IAAIG,KAAAA,CAAM,kDAAA,CAAA;AACpB,IAAA;AACA,IAAA,MAAM,EAAEC,KAAK,EAAEC,QAAQ,EAAE,GAAGC,MAAM,GAAGf,KAAAA;AACrC,IAAA,MAAMgB,eAAe,CAACC,CAAAA,GAAAA;AAClBA,QAAAA,CAAAA,CAAEC,eAAe,EAAA;AACjBT,QAAAA,OAAAA,CAAQU,WAAW,CAACN,KAAAA,CAAAA;AACxB,IAAA,CAAA;AAEA,IAAA,IAAIZ,QAAAA,GAAW,KAAA;IACf,IAAIQ,OAAAA,CAAQW,WAAW,EAAE;QACrB,MAAMC,GAAAA,GAAMZ,QAAQI,KAAK;AACzBZ,QAAAA,QAAAA,GAAWqB,MAAMC,OAAO,CAACF,GAAAA,CAAAA,IAAQA,GAAAA,CAAIG,QAAQ,CAACX,KAAAA,CAAAA;IAClD,CAAA,MAAO;QACHZ,QAAAA,GAAYQ,OAAAA,CAAQI,KAAK,KAAsBA,KAAAA;AACnD,IAAA;AAEA,IAAA,qBACIY,IAAA,CAAC3B,WAAAA,EAAAA;AACI,QAAA,GAAGiB,IAAI;QACRP,GAAAA,EAAKA,GAAAA;QACLkB,IAAAA,EAAK,QAAA;QACLC,IAAAA,EAAK,QAAA;QACLC,eAAAA,EAAe3B,QAAAA;QACfA,QAAAA,EAAUA,QAAAA;QACV4B,OAAAA,EAASb,YAAAA;QACTd,WAAAA,EAAaO,OAAAA,CAAQW,WAAW,GAAG,IAAA,GAAOU,SAAAA;;YAEzCrB,OAAAA,CAAQW,WAAW,kBAChBW,GAAA,CAACC,QAAAA,EAAAA;gBACGC,OAAAA,EAAShC,QAAAA;gBACTiC,QAAQ,EAAA,IAAA;AACRC,gBAAAA,QAAAA,EAAU,EAAC;gBACXN,OAAAA,EAAS,CAACZ,CAAAA,GAAMA,CAAAA,CAAEC,eAAe;;AAGxCJ,YAAAA;;;AAGb,CAAA;AAEA,MAAMsB,QAAAA,iBAAWC,KAAAA,CAAMC,UAAU,CAAC/B,aAAAA;;;;"}

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

@@ -1,17 +1,17 @@
 import React from 'react';
-import PropTypes from 'prop-types';
 export { Header as ModalHeader, Body as ModalBody, Footer as ModalFooter, } from '../../shared/styles';
-declare const modalPropTypes: {
+type ModalProps = {
     /** Opens the modal */
-    open: PropTypes.Validator<boolean>;
+    open: boolean;
     /** Closes the modal on esc */
-    closeOnEsc: PropTypes.Requireable<boolean>;
+    closeOnEsc?: boolean;
     /** Closes the modal on overlay click */
-    closeOnOverlayClick: PropTypes.Requireable<boolean>;
+    closeOnOverlayClick?: boolean;
     /** Call back function called when the modal closes. */
-    onClose: PropTypes.Requireable<(...args: any[]) => any>;
-};
-type ModalProps = PropTypes.InferProps<typeof modalPropTypes>;
+    onClose?: () => void;
+    /** Ref forwarded to the underlying HTMLDivElement of the modal container */
+    forwardRef?: React.Ref<HTMLDivElement>;
+} & React.HTMLAttributes<HTMLDivElement>;
 interface ModalState {
     open: boolean;
 }
@@ -31,16 +31,6 @@ export default class Modal extends React.Component<React.PropsWithChildren<Modal
     state: {
         open: boolean;
     };
-    static propTypes: {
-        /** Opens the modal */
-        open: PropTypes.Validator<boolean>;
-        /** Closes the modal on esc */
-        closeOnEsc: PropTypes.Requireable<boolean>;
-        /** Closes the modal on overlay click */
-        closeOnOverlayClick: PropTypes.Requireable<boolean>;
-        /** Call back function called when the modal closes. */
-        onClose: PropTypes.Requireable<(...args: any[]) => any>;
-    };
     static defaultProps: {
         closeOnEsc: boolean;
         closeOnOverlayClick: boolean;
@@ -50,9 +40,9 @@ export default class Modal extends React.Component<React.PropsWithChildren<Modal
      */
     static getDerivedStateFromProps(props: ModalProps): {
         open: boolean;
-    };
-    private layer;
-    private closeCallback;
+    } | null;
+    private layer?;
+    private closeCallback?;
     /**
      * Internal close handler.
      * Restores focus and calls the external onClose callback.
@@ -73,6 +63,10 @@ export default class Modal extends React.Component<React.PropsWithChildren<Modal
      * Lifecycle method to save the currently focused element when the modal mounts while open.
      */
     componentDidMount(): void;
+    /**
+     * Handles opening the modal by creating the layer.
+     */
+    private handleOpen;
     /**
      * Lifecycle method to restore focus when the modal unmounts.
      */
@@ -95,9 +89,9 @@ export default class Modal extends React.Component<React.PropsWithChildren<Modal
      * Lifecycle method to handle Modal updates.
      * Manages opening/closing logic via LayerManager and focus preservation.
      */
-    getSnapshotBeforeUpdate(prevProps: ModalProps): void;
+    getSnapshotBeforeUpdate(prevProps: ModalProps): null;
     /**
      * Renders the Modal component via the LayerManager portal.
      */
-    render(): import("@emotion/react/jsx-runtime").JSX.Element;
+    render(): import("@emotion/react/jsx-runtime").JSX.Element | null;
 }

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

@@ -1,15 +1,8 @@
 import { jsx } from '@emotion/react/jsx-runtime';
 import React from 'react';
-import PropTypes from 'prop-types';
 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 {
     /**
      * Syncs state with props.
@@ -26,6 +19,8 @@ class Modal extends React.Component {
      */ componentDidMount() {
         if (this.props.open) {
             this.lastFocusedElement = document.activeElement;
+            // Handle initial open state
+            this.handleOpen();
         }
     }
     /**
@@ -37,15 +32,15 @@ class Modal extends React.Component {
         // Clean up layer references
         if (this.closeCallback) {
             this.closeCallback();
-            this.closeCallback = null;
+            this.closeCallback = undefined;
         }
-        this.layer = null;
+        this.layer = undefined;
     }
     /**
      * 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;
+        const { open } = this.props;
         if (prevProps.open && !open) {
             this.closeCallback?.();
             this.restoreFocus();
@@ -53,28 +48,9 @@ class Modal extends React.Component {
         if (!prevProps.open && open) {
             // Save current focus
             this.lastFocusedElement = document.activeElement;
-            this.layer = LayerManager.renderLayer({
-                overlay: true,
-                exitDelay: 300,
-                position: LAYER_POSITION.DIALOG,
-                closeCallback: this.onClose,
-                closeOnEsc: closeOnEsc,
-                closeOnOverlayClick: closeOnOverlayClick,
-                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();
+            this.handleOpen();
         }
+        return null;
     }
     /**
      * Renders the Modal component via the LayerManager portal.
@@ -97,8 +73,8 @@ class Modal extends React.Component {
                 open: false
             });
             this.props.onClose?.();
-            this.closeCallback = null;
-            this.layer = null;
+            this.closeCallback = undefined;
+            this.layer = undefined;
         }, this.lastFocusedElement = null, this.modalRef = /*#__PURE__*/ React.createRef(), /**
      * Retrieves all focusable elements within the modal.
      */ this.getFocusableElements = ()=>{
@@ -126,6 +102,31 @@ class Modal extends React.Component {
                 }
             }
         }, /**
+     * Handles opening the modal by creating the layer.
+     */ this.handleOpen = ()=>{
+            const { closeOnEsc, closeOnOverlayClick, children, ...rest } = this.props;
+            this.layer = LayerManager.renderLayer({
+                overlay: true,
+                exitDelay: 300,
+                position: LAYER_POSITION.DIALOG,
+                closeCallback: this.onClose,
+                closeOnEsc: closeOnEsc,
+                closeOnOverlayClick: closeOnOverlayClick,
+                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();
+        }, /**
      * Restores focus to the element that was focused before the modal opened.
      */ this.restoreFocus = ()=>{
             if (this.lastFocusedElement) {
@@ -148,6 +149,9 @@ class Modal extends React.Component {
                 // Set initial focus when the node is mounted
                 this.setInitialFocus(node);
             }
+            if (this.props.forwardRef) {
+                this.props.forwardRef.current = 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.
@@ -173,7 +177,6 @@ class Modal extends React.Component {
         };
     }
 }
-Modal.propTypes = modalPropTypes;
 Modal.defaultProps = {
     closeOnEsc: true,
     closeOnOverlayClick: true

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

@@ -1 +1 @@
-{"version":3,"file":"Modal.js","sources":["../../../src/components/Modal/Modal.tsx"],"sourcesContent":["import React from 'react';\nimport PropTypes from 'prop-types';\nimport LayerManager, { LAYER_POSITION } from '../../shared/LayerManager';\nexport {\n    Header as ModalHeader,\n    Body as ModalBody,\n    Footer as ModalFooter,\n} from '../../shared/styles';\nimport { DialogContainer as ModalContainer } from '../Dialog/Dialog';\n\nconst modalPropTypes = {\n    /** Opens the modal */\n    open: PropTypes.bool.isRequired,\n    /** Closes the modal on esc */\n    closeOnEsc: PropTypes.bool,\n    /** Closes the modal on overlay click */\n    closeOnOverlayClick: PropTypes.bool,\n    /** Call back function called when the modal closes. */\n    onClose: PropTypes.func,\n};\n\ntype ModalProps = PropTypes.InferProps<typeof modalPropTypes>;\n\ninterface ModalState {\n    open: boolean;\n}\n\n/**\n * Modal component\n *\n * A dialog window that sits on top of the main application content.\n * It disrupts the user's workflow to demand attention for a critical task or decision.\n *\n * Accessibility:\n * - Implements ARIA `role=\"dialog\"` and `aria-modal=\"true\"`.\n * - Traps focus effectively within the modal while open.\n * - Restores focus to the triggering element upon closure.\n * - Supports closing via ESC key and overlay click.\n */\nexport default class Modal extends React.Component<\n    React.PropsWithChildren<ModalProps>,\n    ModalState\n> {\n    state = {\n        open: false,\n    };\n\n    static propTypes = modalPropTypes;\n\n    static defaultProps = {\n        closeOnEsc: true,\n        closeOnOverlayClick: true,\n    };\n\n    /**\n     * Syncs state with props.\n     */\n    static getDerivedStateFromProps(props: ModalProps) {\n        if (props.open) {\n            return {\n                open: true,\n            };\n        }\n        return null;\n    }\n\n    private layer: ReturnType<typeof LayerManager.renderLayer>;\n\n    private closeCallback: (resp?: unknown) => void;\n\n    /**\n     * Internal close handler.\n     * Restores focus and calls the external onClose callback.\n     */\n    private onClose = () => {\n        this.restoreFocus();\n        this.setState({\n            open: false,\n        });\n        this.props.onClose?.();\n        this.closeCallback = null;\n        this.layer = null;\n    };\n\n    private lastFocusedElement: HTMLElement | null = null;\n    private modalRef = React.createRef<HTMLDivElement>();\n\n    /**\n     * Retrieves all focusable elements within the modal.\n     */\n    private getFocusableElements = (): HTMLElement[] => {\n        if (!this.modalRef.current) return [];\n        return Array.from(\n            this.modalRef.current.querySelectorAll(\n                'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])',\n            ),\n        ) as HTMLElement[];\n    };\n\n    /**\n     * Handles keydown events to implement the focus trap.\n     * Traps Tab and Shift+Tab within the modal.\n     */\n    private handleKeyDown = (e: React.KeyboardEvent) => {\n        if (e.key === 'Tab') {\n            const focusableElements = this.getFocusableElements();\n            if (focusableElements.length === 0) return;\n\n            const firstElement = focusableElements[0];\n            const lastElement = focusableElements[focusableElements.length - 1];\n\n            if (e.shiftKey) {\n                if (document.activeElement === firstElement) {\n                    lastElement.focus();\n                    e.preventDefault();\n                }\n            } else {\n                if (document.activeElement === lastElement) {\n                    firstElement.focus();\n                    e.preventDefault();\n                }\n            }\n        }\n    };\n\n    /**\n     * Lifecycle method to save the currently focused element when the modal mounts while open.\n     */\n    componentDidMount() {\n        if (this.props.open) {\n            this.lastFocusedElement = document.activeElement as HTMLElement;\n        }\n    }\n\n    /**\n     * Lifecycle method to restore focus when the modal unmounts.\n     */\n    componentWillUnmount() {\n        if (this.props.open) {\n            this.restoreFocus();\n        }\n        // Clean up layer references\n        if (this.closeCallback) {\n            this.closeCallback();\n            this.closeCallback = null;\n        }\n        this.layer = null;\n    }\n\n    /**\n     * Restores focus to the element that was focused before the modal opened.\n     */\n    private restoreFocus = () => {\n        if (this.lastFocusedElement) {\n            // Check if the element is still in the document\n            const elementToBeFocused = this.lastFocusedElement;\n            this.lastFocusedElement = null;\n            setTimeout(() => {\n                if (document.body.contains(elementToBeFocused)) {\n                    elementToBeFocused.focus();\n                }\n            }, 100);\n        }\n    };\n\n    /**\n     * Callback ref to capture the Modal DOM element.\n     * Triggers initial focus setting when the element mounts.\n     */\n    private setModalRef = (node: HTMLDivElement | null) => {\n        // Update ref\n        (this.modalRef as React.MutableRefObject<HTMLDivElement | null>).current = node;\n\n        if (node) {\n            // Set initial focus when the node is mounted\n            this.setInitialFocus(node);\n        }\n    };\n\n    /**\n     * Sets initial focus within the modal.\n     * Tries to focus the header (first child) first, then the first interactive element, or falls back to the container.\n     */\n    private setInitialFocus = (root: HTMLElement) => {\n        // Try to find the header (assumed to be the first child)\n        const firstChild = root.firstElementChild as HTMLElement;\n        if (firstChild) {\n            // Ensure it's focusable\n            if (firstChild.getAttribute('tabindex') === null) {\n                firstChild.setAttribute('tabindex', '-1');\n            }\n            firstChild.focus();\n            return;\n        }\n\n        // Fallback to focusable elements\n        const focusableElements = this.getFocusableElements();\n        if (focusableElements.length > 0) {\n            focusableElements[0].focus();\n        } else {\n            // Fallback to container\n            root.focus();\n        }\n    };\n\n    /**\n     * Lifecycle method to handle Modal updates.\n     * Manages opening/closing logic via LayerManager and focus preservation.\n     */\n    getSnapshotBeforeUpdate(prevProps: ModalProps) {\n        const { open, closeOnEsc, closeOnOverlayClick, children, ...rest } = this.props;\n\n        if (prevProps.open && !open) {\n            this.closeCallback?.();\n            this.restoreFocus();\n        }\n\n        if (!prevProps.open && open) {\n            // Save current focus\n            this.lastFocusedElement = document.activeElement as HTMLElement;\n\n            this.layer = LayerManager.renderLayer({\n                overlay: true,\n                exitDelay: 300,\n                position: LAYER_POSITION.DIALOG,\n                closeCallback: this.onClose,\n                closeOnEsc: closeOnEsc,\n                closeOnOverlayClick: closeOnOverlayClick,\n                component: (\n                    <ModalContainer\n                        {...rest}\n                        ref={this.setModalRef}\n                        role=\"dialog\"\n                        aria-modal=\"true\"\n                        tabIndex={-1}\n                        onKeyDown={this.handleKeyDown}\n                        onClick={(e) => e.stopPropagation()}\n                        elevated\n                    >\n                        {children}\n                    </ModalContainer>\n                ),\n            });\n            this.closeCallback = this.layer[1];\n            this.forceUpdate();\n        }\n    }\n\n    /**\n     * Renders the Modal component via the LayerManager portal.\n     */\n    render() {\n        if (this.state.open && this.layer) {\n            const [Component] = this.layer;\n            return <Component />;\n        }\n\n        return null;\n    }\n}\n"],"names":["modalPropTypes","open","PropTypes","bool","isRequired","closeOnEsc","closeOnOverlayClick","onClose","func","Modal","React","Component","getDerivedStateFromProps","props","componentDidMount","lastFocusedElement","document","activeElement","componentWillUnmount","restoreFocus","closeCallback","layer","getSnapshotBeforeUpdate","prevProps","children","rest","LayerManager","renderLayer","overlay","exitDelay","position","LAYER_POSITION","DIALOG","component","_jsx","ModalContainer","ref","setModalRef","role","aria-modal","tabIndex","onKeyDown","handleKeyDown","onClick","e","stopPropagation","elevated","forceUpdate","render","state","setState","modalRef","createRef","getFocusableElements","current","Array","from","querySelectorAll","key","focusableElements","length","firstElement","lastElement","shiftKey","focus","preventDefault","elementToBeFocused","setTimeout","body","contains","node","setInitialFocus","root","firstChild","firstElementChild","getAttribute","setAttribute","propTypes","defaultProps"],"mappings":"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"}
+{"version":3,"file":"Modal.js","sources":["../../../src/components/Modal/Modal.tsx"],"sourcesContent":["import React from 'react';\nimport LayerManager, { LAYER_POSITION } from '../../shared/LayerManager';\nexport {\n    Header as ModalHeader,\n    Body as ModalBody,\n    Footer as ModalFooter,\n} from '../../shared/styles';\nimport { DialogContainer as ModalContainer } from '../Dialog/Dialog';\n\ntype ModalProps = {\n    /** Opens the modal */\n    open: boolean;\n    /** Closes the modal on esc */\n    closeOnEsc?: boolean;\n    /** Closes the modal on overlay click */\n    closeOnOverlayClick?: boolean;\n    /** Call back function called when the modal closes. */\n    onClose?: () => void;\n    /** Ref forwarded to the underlying HTMLDivElement of the modal container */\n    forwardRef?: React.Ref<HTMLDivElement>;\n} & React.HTMLAttributes<HTMLDivElement>;\n\ninterface ModalState {\n    open: boolean;\n}\n\n/**\n * Modal component\n *\n * A dialog window that sits on top of the main application content.\n * It disrupts the user's workflow to demand attention for a critical task or decision.\n *\n * Accessibility:\n * - Implements ARIA `role=\"dialog\"` and `aria-modal=\"true\"`.\n * - Traps focus effectively within the modal while open.\n * - Restores focus to the triggering element upon closure.\n * - Supports closing via ESC key and overlay click.\n */\nexport default class Modal extends React.Component<\n    React.PropsWithChildren<ModalProps>,\n    ModalState\n> {\n    state = {\n        open: false,\n    };\n\n    static defaultProps = {\n        closeOnEsc: true,\n        closeOnOverlayClick: true,\n    };\n\n    /**\n     * Syncs state with props.\n     */\n    static getDerivedStateFromProps(props: ModalProps) {\n        if (props.open) {\n            return {\n                open: true,\n            };\n        }\n        return null;\n    }\n\n    private layer?: ReturnType<typeof LayerManager.renderLayer>;\n\n    private closeCallback?: (resp?: unknown) => void;\n\n    /**\n     * Internal close handler.\n     * Restores focus and calls the external onClose callback.\n     */\n    private onClose = () => {\n        this.restoreFocus();\n        this.setState({\n            open: false,\n        });\n        this.props.onClose?.();\n        this.closeCallback = undefined;\n        this.layer = undefined;\n    };\n\n    private lastFocusedElement: HTMLElement | null = null;\n    private modalRef = React.createRef<HTMLDivElement>();\n\n    /**\n     * Retrieves all focusable elements within the modal.\n     */\n    private getFocusableElements = (): HTMLElement[] => {\n        if (!this.modalRef.current) return [];\n        return Array.from(\n            this.modalRef.current.querySelectorAll(\n                'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])',\n            ),\n        ) as HTMLElement[];\n    };\n\n    /**\n     * Handles keydown events to implement the focus trap.\n     * Traps Tab and Shift+Tab within the modal.\n     */\n    private handleKeyDown = (e: React.KeyboardEvent) => {\n        if (e.key === 'Tab') {\n            const focusableElements = this.getFocusableElements();\n            if (focusableElements.length === 0) return;\n\n            const firstElement = focusableElements[0];\n            const lastElement = focusableElements[focusableElements.length - 1];\n\n            if (e.shiftKey) {\n                if (document.activeElement === firstElement) {\n                    lastElement.focus();\n                    e.preventDefault();\n                }\n            } else {\n                if (document.activeElement === lastElement) {\n                    firstElement.focus();\n                    e.preventDefault();\n                }\n            }\n        }\n    };\n\n    /**\n     * Lifecycle method to save the currently focused element when the modal mounts while open.\n     */\n    componentDidMount() {\n        if (this.props.open) {\n            this.lastFocusedElement = document.activeElement as HTMLElement;\n            // Handle initial open state\n            this.handleOpen();\n        }\n    }\n\n    /**\n     * Handles opening the modal by creating the layer.\n     */\n    private handleOpen = () => {\n        const { closeOnEsc, closeOnOverlayClick, children, ...rest } = this.props;\n\n        this.layer = LayerManager.renderLayer({\n            overlay: true,\n            exitDelay: 300,\n            position: LAYER_POSITION.DIALOG,\n            closeCallback: this.onClose,\n            closeOnEsc: closeOnEsc,\n            closeOnOverlayClick: closeOnOverlayClick,\n            component: (\n                <ModalContainer\n                    {...rest}\n                    ref={this.setModalRef}\n                    role=\"dialog\"\n                    aria-modal=\"true\"\n                    tabIndex={-1}\n                    onKeyDown={this.handleKeyDown}\n                    onClick={(e) => e.stopPropagation()}\n                    elevated\n                >\n                    {children}\n                </ModalContainer>\n            ),\n        });\n        this.closeCallback = this.layer[1];\n        this.forceUpdate();\n    };\n\n    /**\n     * Lifecycle method to restore focus when the modal unmounts.\n     */\n    componentWillUnmount() {\n        if (this.props.open) {\n            this.restoreFocus();\n        }\n        // Clean up layer references\n        if (this.closeCallback) {\n            this.closeCallback();\n            this.closeCallback = undefined;\n        }\n        this.layer = undefined;\n    }\n\n    /**\n     * Restores focus to the element that was focused before the modal opened.\n     */\n    private restoreFocus = () => {\n        if (this.lastFocusedElement) {\n            // Check if the element is still in the document\n            const elementToBeFocused = this.lastFocusedElement;\n            this.lastFocusedElement = null;\n            setTimeout(() => {\n                if (document.body.contains(elementToBeFocused)) {\n                    elementToBeFocused.focus();\n                }\n            }, 100);\n        }\n    };\n\n    /**\n     * Callback ref to capture the Modal DOM element.\n     * Triggers initial focus setting when the element mounts.\n     */\n    private setModalRef = (node: HTMLDivElement | null) => {\n        // Update ref\n        (this.modalRef as React.MutableRefObject<HTMLDivElement | null>).current = node;\n\n        if (node) {\n            // Set initial focus when the node is mounted\n            this.setInitialFocus(node);\n        }\n\n        if (this.props.forwardRef) {\n            (this.props.forwardRef as React.MutableRefObject<HTMLDivElement | null>).current = node;\n        }\n    };\n\n    /**\n     * Sets initial focus within the modal.\n     * Tries to focus the header (first child) first, then the first interactive element, or falls back to the container.\n     */\n    private setInitialFocus = (root: HTMLElement) => {\n        // Try to find the header (assumed to be the first child)\n        const firstChild = root.firstElementChild as HTMLElement;\n        if (firstChild) {\n            // Ensure it's focusable\n            if (firstChild.getAttribute('tabindex') === null) {\n                firstChild.setAttribute('tabindex', '-1');\n            }\n            firstChild.focus();\n            return;\n        }\n\n        // Fallback to focusable elements\n        const focusableElements = this.getFocusableElements();\n        if (focusableElements.length > 0) {\n            focusableElements[0].focus();\n        } else {\n            // Fallback to container\n            root.focus();\n        }\n    };\n\n    /**\n     * Lifecycle method to handle Modal updates.\n     * Manages opening/closing logic via LayerManager and focus preservation.\n     */\n    getSnapshotBeforeUpdate(prevProps: ModalProps) {\n        const { open } = this.props;\n\n        if (prevProps.open && !open) {\n            this.closeCallback?.();\n            this.restoreFocus();\n        }\n\n        if (!prevProps.open && open) {\n            // Save current focus\n            this.lastFocusedElement = document.activeElement as HTMLElement;\n            this.handleOpen();\n        }\n\n        return null;\n    }\n\n    /**\n     * Renders the Modal component via the LayerManager portal.\n     */\n    render() {\n        if (this.state.open && this.layer) {\n            const [Component] = this.layer;\n            return <Component />;\n        }\n\n        return null;\n    }\n}\n"],"names":["Modal","React","Component","getDerivedStateFromProps","props","open","componentDidMount","lastFocusedElement","document","activeElement","handleOpen","componentWillUnmount","restoreFocus","closeCallback","undefined","layer","getSnapshotBeforeUpdate","prevProps","render","state","_jsx","onClose","setState","modalRef","createRef","getFocusableElements","current","Array","from","querySelectorAll","handleKeyDown","e","key","focusableElements","length","firstElement","lastElement","shiftKey","focus","preventDefault","closeOnEsc","closeOnOverlayClick","children","rest","LayerManager","renderLayer","overlay","exitDelay","position","LAYER_POSITION","DIALOG","component","ModalContainer","ref","setModalRef","role","aria-modal","tabIndex","onKeyDown","onClick","stopPropagation","elevated","forceUpdate","elementToBeFocused","setTimeout","body","contains","node","setInitialFocus","forwardRef","root","firstChild","firstElementChild","getAttribute","setAttribute","defaultProps"],"mappings":"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"}

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

@@ -1,42 +1,47 @@
-import React from 'react';
-import PropTypes from 'prop-types';
 import { NOTIFICATION_POSITION, NOTIFICATION_TYPE, NotificationOptions } from './types';
-type NotificationProps = PropTypes.InferProps<typeof StoryProps.propTypes>;
-/** This component is only used for storybook documentation */
-export declare class StoryProps extends React.Component<NotificationProps> {
-    static propTypes: {
-        /** Title of the notification */
-        title: PropTypes.Validator<string>;
-        /** Body of the notification */
-        description: PropTypes.Validator<string>;
-        /** Id for the notification, helps in de-duplication. */
-        id: PropTypes.Requireable<string>;
-        /** Duration for the notification in milliseconds */
-        duration: PropTypes.Requireable<number>;
-        /** Creates sticky notification */
-        sticky: PropTypes.Requireable<boolean>;
-        /** Type of notification */
-        type: PropTypes.Requireable<NOTIFICATION_TYPE>;
-        /** Action button text */
-        buttonText: PropTypes.Requireable<string>;
-        /** Action button click callback */
-        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;
-        sticky: boolean;
-        type: NOTIFICATION_TYPE;
-    };
-    render(): React.ReactNode;
-}
+type NotificationProps = {
+    /** Title of the notification */
+    title: string;
+    /** Body of the notification */
+    description: string;
+    /** Id for the notification, helps in de-duplication. */
+    id?: string;
+    /**
+     * Duration for the notification in milliseconds
+     * @default 5000
+     */
+    duration?: number;
+    /**
+     * Creates sticky notification
+     * @default false
+     */
+    sticky?: boolean;
+    /**
+     * Type of notification
+     * @default NOTIFICATION_TYPE.INFO
+     */
+    type?: NOTIFICATION_TYPE;
+    /** Action button text */
+    buttonText?: string;
+    /** Action button click callback */
+    buttonClick?: () => void;
+    /** Notification close callback. */
+    onClose?: () => void;
+    /** Aria label for the close button on the notification. Defaults to "Close notification" */
+    closeButtonAriaLabel?: string;
+};
+/**
+ * This dummy component is used to extract props for documentation in Storybook.
+ * @param props
+ * @returns
+ */
+export declare function StoryProps(props: NotificationProps): null;
 /** Notification class */
 declare class Notification {
     /** Helps in maintaining single instance for different positions. */
     private containers;
+    /** Pending add requests waiting for manager to mount */
+    private pending;
     /**
      * Adds a notification
      *