@bookjane2/bookjane-design-library 9.0.34 → 9.0.35

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

@@ -0,0 +1,12 @@
+import { StoryFn } from '@storybook/react';
+import { BKJImage } from './BKJImage.js';
+import { IBKJImageProps } from './BKJImage.types.js';
+declare const setup: {
+    title: string;
+    component: typeof BKJImage;
+};
+export declare const Decorative: import("@storybook/core/csf").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, IBKJImageProps>;
+export declare const Informative: import("@storybook/core/csf").AnnotatedStoryFn<import("@storybook/react").ReactRenderer, IBKJImageProps>;
+export declare const Variants: StoryFn;
+export default setup;
+//# sourceMappingURL=BKJImage.stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BKJImage.stories.d.ts","sourceRoot":"","sources":["../../../src/components/BKJImage/BKJImage.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA0BlD,QAAA,MAAM,KAAK;;;CAGV,CAAC;AAIF,eAAO,MAAM,UAAU,0GAAoB,CAAC;AAmB5C,eAAO,MAAM,WAAW,0GAAoB,CAAC;AAmB7C,eAAO,MAAM,QAAQ,EAAE,OA2BtB,CAAC;AAUF,eAAe,KAAK,CAAC"}

package/lib/components/BKJImage/BKJImage.stories.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { BKJImage } from './BKJImage.js';
+const SkeletonDiv = () => (_jsx("div", { style: { width: '100%', height: '100%', background: '#f0f0f0' } }));
+const PlaceholderDiv = () => (_jsx("div", { style: {
+        width: '100%',
+        height: '100%',
+        background: '#e0e0e0',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        color: '#666',
+        fontSize: 12,
+    }, children: "No image" }));
+const SAMPLE_DECORATIVE_URL = 'https://picsum.photos/seed/decorative-bkjimage/240/120';
+const SAMPLE_PORTRAIT_URL = 'https://picsum.photos/seed/portrait-bkjimage/240/240';
+const setup = {
+    title: 'Basic Elements/BKJImage',
+    component: BKJImage,
+};
+const Template = (args) => _jsx(BKJImage, { ...args });
+export const Decorative = Template.bind({});
+Decorative.args = {
+    alt: '',
+    src: SAMPLE_DECORATIVE_URL,
+    width: '240px',
+    height: '120px',
+    LoadingComponent: SkeletonDiv,
+    FallbackComponent: PlaceholderDiv,
+    variant: 'Rectangle',
+};
+Decorative.parameters = {
+    docs: {
+        description: {
+            story: '`alt=""` is the correct value for decorative images per WCAG H67 ("Using null alt text and no title attribute on `img` elements that AT should ignore"); this is intentional, not a bug. Use this when the image is purely visual or when an adjacent visible label already names the content.',
+        },
+    },
+};
+export const Informative = Template.bind({});
+Informative.args = {
+    alt: 'Jane Smith — Director of Engineering',
+    src: SAMPLE_PORTRAIT_URL,
+    width: '120px',
+    height: '120px',
+    LoadingComponent: SkeletonDiv,
+    FallbackComponent: PlaceholderDiv,
+    variant: 'Round',
+};
+Informative.parameters = {
+    docs: {
+        description: {
+            story: 'Informative image: the `alt` describes who or what the image shows. AT announces the alt text + "image". This is the dominant pattern when the image carries meaning that the consumer has not duplicated as adjacent visible text.',
+        },
+    },
+};
+export const Variants = () => (_jsxs("div", { style: { display: 'flex', gap: '24px', alignItems: 'flex-start' }, children: [_jsxs("div", { children: [_jsx("p", { style: { marginBottom: 8, fontSize: 12 }, children: "variant=\"Round\"" }), _jsx(BKJImage, { alt: "Profile photo of Alice", src: SAMPLE_PORTRAIT_URL, width: "120px", height: "120px", LoadingComponent: SkeletonDiv, FallbackComponent: PlaceholderDiv, variant: "Round" })] }), _jsxs("div", { children: [_jsx("p", { style: { marginBottom: 8, fontSize: 12 }, children: "variant=\"Rectangle\"" }), _jsx(BKJImage, { alt: "Conference room photo", src: SAMPLE_DECORATIVE_URL, width: "240px", height: "120px", LoadingComponent: SkeletonDiv, FallbackComponent: PlaceholderDiv, variant: "Rectangle" })] })] }));
+Variants.parameters = {
+    docs: {
+        description: {
+            story: 'Side-by-side rendering of `Round` (border-radius: 50%) and `Rectangle` (no border-radius) variants. Both use informative `alt` values. The a11y panel scans both variants together — confirms neither variant has a per-CSS-rule a11y regression.',
+        },
+    },
+};
+export default setup;
+//# sourceMappingURL=BKJImage.stories.js.map

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

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

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

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

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

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

package/lib/components/BKJImage/BKJImage.test.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { fireEvent, screen } from '@testing-library/react';
+import { renderAndCheckA11y, renderWithTheme } from '../../test-utils/index.js';
+import { BKJImage } from './BKJImage.js';
+const LoadingPlaceholder = () => _jsx("div", { "data-testid": "loading-ph" });
+const FallbackPlaceholder = () => _jsx("div", { "data-testid": "fallback-ph" });
+const STUB_SRC = 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciLz4=';
+describe('BKJImage type contract (compile-time)', () => {
+    it('rejects missing alt prop at compile time', () => {
+        // FR-001. If this directive ever becomes "unused", IBKJImageProps.alt has been
+        // loosened (e.g., changed to alt?: string) and the compile-time safety check is gone.
+        const _bad = (
+        // @ts-expect-error — BKJImage with no `alt` must fail type-checking.
+        _jsx(BKJImage, { src: STUB_SRC, width: "40", height: "40", LoadingComponent: LoadingPlaceholder, FallbackComponent: FallbackPlaceholder, variant: "Round" }));
+        void _bad;
+    });
+});
+describe('BKJImage decorative render', () => {
+    it('renders alt="" byte-identically', () => {
+        const { container } = renderWithTheme(_jsx(BKJImage, { alt: "", src: STUB_SRC, width: "40", height: "40", LoadingComponent: LoadingPlaceholder, FallbackComponent: FallbackPlaceholder, variant: "Rectangle" }));
+        const img = container.querySelector('img');
+        expect(img).not.toBeNull();
+        expect(img).toHaveAttribute('alt', '');
+    });
+    it('decorative render is axe-clean (Rectangle variant)', async () => {
+        const { renderResult, axeResults } = await renderAndCheckA11y(_jsx(BKJImage, { alt: "", src: STUB_SRC, width: "40", height: "40", LoadingComponent: LoadingPlaceholder, FallbackComponent: FallbackPlaceholder, variant: "Rectangle" }));
+        const img = renderResult.container.querySelector('img');
+        if (img)
+            fireEvent.load(img);
+        expect(axeResults).toHaveNoViolations();
+    });
+});
+describe('BKJImage informative render', () => {
+    it('renders alt="Jane Smith" byte-identically', () => {
+        const { container } = renderWithTheme(_jsx(BKJImage, { alt: "Jane Smith", src: STUB_SRC, width: "40", height: "40", LoadingComponent: LoadingPlaceholder, FallbackComponent: FallbackPlaceholder, variant: "Round" }));
+        const img = container.querySelector('img');
+        expect(img).not.toBeNull();
+        expect(img).toHaveAttribute('alt', 'Jane Smith');
+    });
+    it('informative <img> is reachable via getByRole("img", { name }) after onLoad', () => {
+        const { container } = renderWithTheme(_jsx(BKJImage, { alt: "Jane Smith", src: STUB_SRC, width: "40", height: "40", LoadingComponent: LoadingPlaceholder, FallbackComponent: FallbackPlaceholder, variant: "Round" }));
+        const img = container.querySelector('img');
+        if (img)
+            fireEvent.load(img);
+        expect(screen.getByRole('img', { name: 'Jane Smith' })).toBeInTheDocument();
+    });
+    it('informative render is axe-clean (Round variant)', async () => {
+        const { renderResult, axeResults } = await renderAndCheckA11y(_jsx(BKJImage, { alt: "Jane Smith", src: STUB_SRC, width: "40", height: "40", LoadingComponent: LoadingPlaceholder, FallbackComponent: FallbackPlaceholder, variant: "Round" }));
+        const img = renderResult.container.querySelector('img');
+        if (img)
+            fireEvent.load(img);
+        expect(axeResults).toHaveNoViolations();
+    });
+});
+//# sourceMappingURL=BKJImage.test.js.map

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

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

package/package.json

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