@bookjane2/bookjane-design-library 9.0.32 → 9.0.33

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BKJEllipsisMenu.d.ts","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAoB,MAAM,OAAO,CAAC;AAQ7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAyBhE,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,qBAAqB,CASrD,CAAC"}
+{"version":3,"file":"BKJEllipsisMenu.d.ts","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAoB,MAAM,OAAO,CAAC;AAQ7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAoChE,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,qBAAqB,CAcrD,CAAC"}

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.js

@@ -5,12 +5,13 @@ import { Flex } from '../Flex/index.js';
 import { BKJEllipsisMenuUIStateProvider, useBKJEllipsisMenuUIStateContext, } from './BKJEllipsisMenu.context.js';
 import { BKJEllipsisMenuIconWrapper } from './BKJEllipsisMenu.styled.js';
 import { BKJEllipsisMenuDropdown } from './BKJEllipsisMenuDropdown.js';
-const Component = ({ triggerRef, children }) => {
+const Component = ({ triggerRef, ariaLabel, consumerProps, children }) => {
     const { toggleMenu, isOpen } = useBKJEllipsisMenuUIStateContext();
-    return (_jsxs(Fragment, { children: [_jsx(BKJEllipsisMenuIconWrapper, { onClick: toggleMenu, children: _jsx(Flex, { ref: triggerRef, height: "38px", minHeight: "38px", justifyContent: "center", alignItems: "center", children: _jsx(BKJIcon, { iconName: "Ellipsis" }) }) }), isOpen && triggerRef.current && (_jsx(BKJEllipsisMenuDropdown, { triggerRef: triggerRef, children: children }))] }));
+    return (_jsxs(Fragment, { children: [_jsx(BKJEllipsisMenuIconWrapper, { ref: triggerRef, ...consumerProps, type: "button", "aria-label": ariaLabel, "aria-haspopup": "menu", "aria-expanded": isOpen, onClick: toggleMenu, children: _jsx(Flex, { height: "38px", minHeight: "38px", justifyContent: "center", alignItems: "center", children: _jsx(BKJIcon, { iconName: "Ellipsis" }) }) }), isOpen && triggerRef.current && (_jsx(BKJEllipsisMenuDropdown, { triggerRef: triggerRef, children: children }))] }));
 };
-export const BKJEllipsisMenu = ({ children, ...props }) => {
+export const BKJEllipsisMenu = ({ children, 'aria-label': ariaLabelProp, ...rest }) => {
     const triggerRef = useRef(null);
-    return (_jsx(BKJEllipsisMenuUIStateProvider, { children: _jsx(Component, { ...props, triggerRef: triggerRef, children: children }) }));
+    const ariaLabel = ariaLabelProp === undefined ? 'More options' : ariaLabelProp;
+    return (_jsx(BKJEllipsisMenuUIStateProvider, { children: _jsx(Component, { triggerRef: triggerRef, ariaLabel: ariaLabel, consumerProps: rest, children: children }) }));
 };
 //# sourceMappingURL=BKJEllipsisMenu.js.map

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"BKJEllipsisMenu.js","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAM,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,SAAS,GAA6B,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE;IACvE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,gCAAgC,EAAE,CAAC;IAClE,OAAO,CACL,MAAC,QAAQ,eACP,KAAC,0BAA0B,IAAC,OAAO,EAAE,UAAU,YAC7C,KAAC,IAAI,IACH,GAAG,EAAE,UAAiB,EACtB,MAAM,EAAC,MAAM,EACb,SAAS,EAAC,MAAM,EAChB,cAAc,EAAC,QAAQ,EACvB,UAAU,EAAC,QAAQ,YAEnB,KAAC,OAAO,IAAC,QAAQ,EAAC,UAAU,GAAG,GAC1B,GACoB,EAC5B,MAAM,IAAI,UAAU,CAAC,OAAO,IAAI,CAC/B,KAAC,uBAAuB,IAAC,UAAU,EAAE,UAAU,YAAG,QAAQ,GAA2B,CACtF,IACQ,CACZ,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA8B,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE;IACnF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CACL,KAAC,8BAA8B,cAC7B,KAAC,SAAS,OAAK,KAAK,EAAE,UAAU,EAAE,UAAU,YACzC,QAAQ,GACC,GACmB,CAClC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"BKJEllipsisMenu.js","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAM,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,SAAS,GAIV,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC1D,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,gCAAgC,EAAE,CAAC;IAClE,OAAO,CACL,MAAC,QAAQ,eACP,KAAC,0BAA0B,IACzB,GAAG,EAAE,UAAiB,KAClB,aAAa,EACjB,IAAI,EAAC,QAAQ,gBACD,SAAS,mBACP,MAAM,mBACL,MAAM,EACrB,OAAO,EAAE,UAAU,YAEnB,KAAC,IAAI,IACH,MAAM,EAAC,MAAM,EACb,SAAS,EAAC,MAAM,EAChB,cAAc,EAAC,QAAQ,EACvB,UAAU,EAAC,QAAQ,YAEnB,KAAC,OAAO,IAAC,QAAQ,EAAC,UAAU,GAAG,GAC1B,GACoB,EAC5B,MAAM,IAAI,UAAU,CAAC,OAAO,IAAI,CAC/B,KAAC,uBAAuB,IAAC,UAAU,EAAE,UAAU,YAAG,QAAQ,GAA2B,CACtF,IACQ,CACZ,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA8B,CAAC,EACzD,QAAQ,EACR,YAAY,EAAE,aAAa,EAC3B,GAAG,IAAI,EACR,EAAE,EAAE;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAC/E,OAAO,CACL,KAAC,8BAA8B,cAC7B,KAAC,SAAS,IAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,YACzE,QAAQ,GACC,GACmB,CAClC,CAAC;AACJ,CAAC,CAAC"}

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.d.ts

@@ -6,4 +6,6 @@ declare const _default: {
 };
 export default _default;
 export declare const Default: import("@storybook/core/csf").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, IBKJEllipsisMenuProps>;
+export declare const WithCustomLabel: import("@storybook/core/csf").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, IBKJEllipsisMenuProps>;
+export declare const OpenedByDefault: import("@storybook/core/csf").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, IBKJEllipsisMenuProps>;
 //# sourceMappingURL=BKJEllipsisMenu.stories.d.ts.map

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BKJEllipsisMenu.stories.d.ts","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;;;;;;AAEhE,wBAIE;AAaF,eAAO,MAAM,OAAO,iHAA2B,CAAC"}
+{"version":3,"file":"BKJEllipsisMenu.stories.d.ts","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;;;;;;AAEhE,wBAIE;AAaF,eAAO,MAAM,OAAO,iHAA2B,CAAC;AAehD,eAAO,MAAM,eAAe,iHAA0C,CAAC;AAsBvE,eAAO,MAAM,eAAe,iHAA0C,CAAC"}

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { userEvent, within } from '@storybook/test';
 import { BKJMenuItem } from '../BKJMenuItem/index.js';
 import { Flex } from '../Flex/index.js';
 import { BKJEllipsisMenu } from './BKJEllipsisMenu.js';
@@ -12,4 +13,33 @@ const BKJMenuTemplate = () => {
 };
 export const Default = BKJMenuTemplate.bind({});
 Default.args = {};
+const BKJMenuTemplateWithCustomLabel = () => {
+    return (_jsx(Flex, { flexDirection: "row-reverse", width: "100%", children: _jsxs(BKJEllipsisMenu, { "aria-label": "Row actions for shift 12345", children: [_jsx(BKJMenuItem, { children: "Export CSV" }), _jsx(BKJMenuItem, { children: "Export XLSX" })] }) }));
+};
+export const WithCustomLabel = BKJMenuTemplateWithCustomLabel.bind({});
+WithCustomLabel.args = {};
+WithCustomLabel.parameters = {
+    docs: {
+        description: {
+            story: 'Renders BKJEllipsisMenu with a consumer-supplied `aria-label`. The default `"More options"` is overridden by the prop value. Use this pattern when the row context (e.g., "Row actions for shift 12345") gives screen-reader users more useful information than a generic label.',
+        },
+    },
+};
+const BKJMenuTemplateOpenedByDefault = () => {
+    return (_jsx(Flex, { flexDirection: "row-reverse", width: "100%", children: _jsxs(BKJEllipsisMenu, { children: [_jsx(BKJMenuItem, { children: "Export CSV" }), _jsx(BKJMenuItem, { children: "Export XLSX" })] }) }));
+};
+export const OpenedByDefault = BKJMenuTemplateOpenedByDefault.bind({});
+OpenedByDefault.args = {};
+OpenedByDefault.play = async ({ canvasElement }) => {
+    const canvas = within(canvasElement);
+    const trigger = await canvas.findByRole('button', { name: 'More options' });
+    await userEvent.click(trigger);
+};
+OpenedByDefault.parameters = {
+    docs: {
+        description: {
+            story: 'Renders BKJEllipsisMenu in the open state via a play function. Use this story to verify the Storybook a11y addon reports zero violations with the menu-popup mounted via Portal. The trigger has `aria-expanded="true"` after the play function fires.',
+        },
+    },
+};
 //# sourceMappingURL=BKJEllipsisMenu.stories.js.map

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.js.map

@@ -1 +1 @@
-{"version":3,"file":"BKJEllipsisMenu.stories.js","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,eAAe;IACb,KAAK,EAAE,gCAAgC;IACvC,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,eAAe,GAAmC,GAAG,EAAE;IAC3D,OAAO,CACL,KAAC,IAAI,IAAC,aAAa,EAAC,aAAa,EAAC,KAAK,EAAC,MAAM,YAC5C,MAAC,eAAe,eACd,KAAC,WAAW,6BAAyB,EACrC,KAAC,WAAW,8BAA0B,IACtB,GACb,CACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEhD,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC"}
+{"version":3,"file":"BKJEllipsisMenu.stories.js","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.stories.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,eAAe;IACb,KAAK,EAAE,gCAAgC;IACvC,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,eAAe,GAAmC,GAAG,EAAE;IAC3D,OAAO,CACL,KAAC,IAAI,IAAC,aAAa,EAAC,aAAa,EAAC,KAAK,EAAC,MAAM,YAC5C,MAAC,eAAe,eACd,KAAC,WAAW,6BAAyB,EACrC,KAAC,WAAW,8BAA0B,IACtB,GACb,CACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEhD,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC;AAElB,MAAM,8BAA8B,GAAmC,GAAG,EAAE;IAC1E,OAAO,CACL,KAAC,IAAI,IAAC,aAAa,EAAC,aAAa,EAAC,KAAK,EAAC,MAAM,YAC5C,MAAC,eAAe,kBAAY,6BAA6B,aACvD,KAAC,WAAW,6BAAyB,EACrC,KAAC,WAAW,8BAA0B,IACtB,GACb,CACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvE,eAAe,CAAC,IAAI,GAAG,EAAE,CAAC;AAC1B,eAAe,CAAC,UAAU,GAAG;IAC3B,IAAI,EAAE;QACJ,WAAW,EAAE;YACX,KAAK,EACH,kRAAkR;SACrR;KACF;CACF,CAAC;AAEF,MAAM,8BAA8B,GAAmC,GAAG,EAAE;IAC1E,OAAO,CACL,KAAC,IAAI,IAAC,aAAa,EAAC,aAAa,EAAC,KAAK,EAAC,MAAM,YAC5C,MAAC,eAAe,eACd,KAAC,WAAW,6BAAyB,EACrC,KAAC,WAAW,8BAA0B,IACtB,GACb,CACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvE,eAAe,CAAC,IAAI,GAAG,EAAE,CAAC;AAC1B,eAAe,CAAC,IAAI,GAAG,KAAK,EAAE,EAAE,aAAa,EAAkC,EAAE,EAAE;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAC5E,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC,CAAC;AACF,eAAe,CAAC,UAAU,GAAG;IAC3B,IAAI,EAAE;QACJ,WAAW,EAAE;YACX,KAAK,EACH,wPAAwP;SAC3P;KACF;CACF,CAAC"}

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.d.ts

@@ -1,4 +1,4 @@
-export declare const BKJEllipsisMenuIconWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+export declare const BKJEllipsisMenuIconWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {
     ref?: any;
 }>> & string;
 //# sourceMappingURL=BKJEllipsisMenu.styled.d.ts.map

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BKJEllipsisMenu.styled.d.ts","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B;UAAsB,GAAG;YAW/D,CAAC"}
+{"version":3,"file":"BKJEllipsisMenu.styled.d.ts","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B;UAAyB,GAAG;YAgBlE,CAAC"}

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.js

@@ -1,5 +1,5 @@
 import styled from 'styled-components';
-export const BKJEllipsisMenuIconWrapper = styled.div `
+export const BKJEllipsisMenuIconWrapper = styled.button `
   min-height: 38px;
   height: 38px;
   width: 38px;
@@ -7,6 +7,11 @@ export const BKJEllipsisMenuIconWrapper = styled.div `
   display: flex;
   justify-content: center;
   align-items: center;
+  border: none;
+  background: none;
+  padding: 0;
+  font: inherit;
+  color: inherit;
   &:hover {
     cursor: pointer;
   }

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.js.map

@@ -1 +1 @@
-{"version":3,"file":"BKJEllipsisMenu.styled.js","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,mBAAmB,CAAC;AAEvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAe;;;;;;;;;;;CAWlE,CAAC"}
+{"version":3,"file":"BKJEllipsisMenu.styled.js","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.styled.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,mBAAmB,CAAC;AAEvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAe;;;;;;;;;;;;;;;;CAgBrE,CAAC"}

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BKJEllipsisMenu.test.d.ts.map

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BKJEllipsisMenu.test.d.ts","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.test.tsx"],"names":[],"mappings":""}

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.test.js

@@ -0,0 +1,126 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { axe } from 'jest-axe';
+import { renderAndCheckA11y, renderWithTheme } from '../../test-utils/index.js';
+import { BKJMenuItem } from '../BKJMenuItem/index.js';
+import { BKJEllipsisMenu } from './BKJEllipsisMenu.js';
+describe('BKJEllipsisMenu trigger structural contract (FR-001 / FR-002)', () => {
+    it('renders the trigger as a real <button> element with type="button"', () => {
+        renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        expect(trigger.tagName).toBe('BUTTON');
+        expect(trigger).toHaveAttribute('type', 'button');
+    });
+});
+describe('BKJEllipsisMenu trigger keyboard activation (FR-001 / FR-009 (vi)–(vii))', () => {
+    it('opens the menu when Enter is pressed on the focused trigger', async () => {
+        const user = userEvent.setup();
+        renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        trigger.focus();
+        expect(document.activeElement).toBe(trigger);
+        expect(trigger).toHaveAttribute('aria-expanded', 'false');
+        await user.keyboard('{Enter}');
+        expect(trigger).toHaveAttribute('aria-expanded', 'true');
+    });
+    it('opens the menu when Space is pressed on the focused trigger', async () => {
+        const user = userEvent.setup();
+        renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        trigger.focus();
+        expect(trigger).toHaveAttribute('aria-expanded', 'false');
+        await user.keyboard(' ');
+        expect(trigger).toHaveAttribute('aria-expanded', 'true');
+    });
+    it('is reachable via Tab from a sibling element', async () => {
+        const user = userEvent.setup();
+        renderWithTheme(_jsxs(_Fragment, { children: [_jsx("button", { "data-testid": "sibling", children: "Sibling" }), _jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) })] }));
+        const sibling = screen.getByTestId('sibling');
+        sibling.focus();
+        expect(document.activeElement).toBe(sibling);
+        await user.tab();
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        expect(document.activeElement).toBe(trigger);
+    });
+});
+describe('BKJEllipsisMenu accessible-name resolution (FR-003 / FR-004)', () => {
+    it('applies aria-label="More options" by default when no prop is supplied', () => {
+        renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        expect(trigger).toHaveAttribute('aria-label', 'More options');
+    });
+    it('honours consumer-supplied aria-label override', () => {
+        renderWithTheme(_jsx(BKJEllipsisMenu, { "aria-label": "Row actions for shift 12345", children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'Row actions for shift 12345' });
+        expect(trigger).toHaveAttribute('aria-label', 'Row actions for shift 12345');
+    });
+    it('passes empty-string aria-label through verbatim (does not fall back to default)', () => {
+        const { container } = renderWithTheme(_jsx(BKJEllipsisMenu, { "aria-label": "", children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = container.querySelector('button');
+        expect(trigger).not.toBeNull();
+        expect(trigger).toHaveAttribute('aria-label', '');
+    });
+});
+describe('BKJEllipsisMenu Ellipsis icon decorative inheritance (WEB-4841 / SC-011)', () => {
+    it('renders the inner <svg> with aria-hidden="true" (inherited from BKJIcon default)', () => {
+        const { container } = renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const svg = container.querySelector('button svg');
+        expect(svg).not.toBeNull();
+        expect(svg).toHaveAttribute('aria-hidden', 'true');
+    });
+});
+describe('BKJEllipsisMenu axe-clean accessible-name states (FR-009 axe sweep)', () => {
+    it('reports zero axe violations with the default aria-label and the menu closed', async () => {
+        const { axeResults } = await renderAndCheckA11y(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        expect(axeResults).toHaveNoViolations();
+    });
+    it('reports zero axe violations with a consumer-supplied aria-label and the menu closed', async () => {
+        const { axeResults } = await renderAndCheckA11y(_jsx(BKJEllipsisMenu, { "aria-label": "Row actions for shift 12345", children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        expect(axeResults).toHaveNoViolations();
+    });
+});
+describe('BKJEllipsisMenu trigger menu-popup state ARIA (FR-002 / Clarification Q4)', () => {
+    it('carries aria-haspopup="menu", aria-expanded="false", and NO aria-controls when closed', () => {
+        renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        expect(trigger).toHaveAttribute('aria-haspopup', 'menu');
+        expect(trigger).toHaveAttribute('aria-expanded', 'false');
+        expect(trigger).not.toHaveAttribute('aria-controls');
+    });
+    it('flips aria-expanded to "true" after the trigger is clicked, and STILL has no aria-controls', async () => {
+        const user = userEvent.setup();
+        renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        expect(trigger).toHaveAttribute('aria-expanded', 'false');
+        await user.click(trigger);
+        expect(trigger).toHaveAttribute('aria-haspopup', 'menu');
+        expect(trigger).toHaveAttribute('aria-expanded', 'true');
+        expect(trigger).not.toHaveAttribute('aria-controls');
+    });
+    it('reports zero axe violations with the menu open (default aria-label)', async () => {
+        const user = userEvent.setup();
+        const { container } = renderWithTheme(_jsx(BKJEllipsisMenu, { children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'More options' });
+        await user.click(trigger);
+        const axeResults = await axe(container);
+        expect(axeResults).toHaveNoViolations();
+    });
+});
+describe('BKJEllipsisMenu consumer override exclusion (FR-006)', () => {
+    it('silently overrides consumer-supplied type / aria-haspopup / aria-expanded / onClick', async () => {
+        const user = userEvent.setup();
+        const consumerOnClick = jest.fn();
+        const Adversarial = BKJEllipsisMenu;
+        renderWithTheme(_jsx(Adversarial, { type: "submit", "aria-haspopup": "dialog", "aria-expanded": true, onClick: consumerOnClick, "aria-label": "Custom", children: _jsx(BKJMenuItem, { children: "Export CSV" }) }));
+        const trigger = screen.getByRole('button', { name: 'Custom' });
+        expect(trigger).toHaveAttribute('type', 'button');
+        expect(trigger).toHaveAttribute('aria-haspopup', 'menu');
+        expect(trigger).toHaveAttribute('aria-expanded', 'false');
+        expect(trigger).toHaveAttribute('aria-label', 'Custom');
+        await user.click(trigger);
+        expect(consumerOnClick).not.toHaveBeenCalled();
+        expect(trigger).toHaveAttribute('aria-expanded', 'true');
+    });
+});
+//# sourceMappingURL=BKJEllipsisMenu.test.js.map

package/lib/components/BKJEllipsisMenu/BKJEllipsisMenu.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BKJEllipsisMenu.test.js","sourceRoot":"","sources":["../../../src/components/BKJEllipsisMenu/BKJEllipsisMenu.test.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bookjane2/bookjane-design-library",
-  "version": "9.0.32",
+  "version": "9.0.33",
   "main": "./lib/index.js",
   "typings": "./lib/index.d.ts",
   "engines": {