@a11ypros/a11y-ui-components 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/dist/components/Button/Button.css +259 -0
  2. package/dist/components/Button/Button.d.ts +37 -0
  3. package/dist/components/Button/Button.d.ts.map +1 -0
  4. package/dist/components/Button/Button.js +52 -0
  5. package/dist/components/Button/index.d.ts +3 -0
  6. package/dist/components/Button/index.d.ts.map +1 -0
  7. package/dist/components/Button/index.js +1 -0
  8. package/dist/components/DataTable/DataTable.css +132 -0
  9. package/dist/components/DataTable/DataTable.d.ts +71 -0
  10. package/dist/components/DataTable/DataTable.d.ts.map +1 -0
  11. package/dist/components/DataTable/DataTable.js +122 -0
  12. package/dist/components/DataTable/index.d.ts +3 -0
  13. package/dist/components/DataTable/index.d.ts.map +1 -0
  14. package/dist/components/DataTable/index.js +1 -0
  15. package/dist/components/Form/Checkbox.css +46 -0
  16. package/dist/components/Form/Checkbox.d.ts +36 -0
  17. package/dist/components/Form/Checkbox.d.ts.map +1 -0
  18. package/dist/components/Form/Checkbox.js +39 -0
  19. package/dist/components/Form/Fieldset.css +43 -0
  20. package/dist/components/Form/Fieldset.d.ts +33 -0
  21. package/dist/components/Form/Fieldset.d.ts.map +1 -0
  22. package/dist/components/Form/Fieldset.js +34 -0
  23. package/dist/components/Form/Input.css +76 -0
  24. package/dist/components/Form/Input.d.ts +37 -0
  25. package/dist/components/Form/Input.d.ts.map +1 -0
  26. package/dist/components/Form/Input.js +41 -0
  27. package/dist/components/Form/Label.css +13 -0
  28. package/dist/components/Form/Label.d.ts +30 -0
  29. package/dist/components/Form/Label.d.ts.map +1 -0
  30. package/dist/components/Form/Label.js +30 -0
  31. package/dist/components/Form/Radio.css +81 -0
  32. package/dist/components/Form/Radio.d.ts +53 -0
  33. package/dist/components/Form/Radio.d.ts.map +1 -0
  34. package/dist/components/Form/Radio.js +39 -0
  35. package/dist/components/Form/Select.css +69 -0
  36. package/dist/components/Form/Select.d.ts +51 -0
  37. package/dist/components/Form/Select.d.ts.map +1 -0
  38. package/dist/components/Form/Select.js +49 -0
  39. package/dist/components/Form/Textarea.css +79 -0
  40. package/dist/components/Form/Textarea.d.ts +44 -0
  41. package/dist/components/Form/Textarea.d.ts.map +1 -0
  42. package/dist/components/Form/Textarea.js +43 -0
  43. package/dist/components/Form/index.d.ts +8 -0
  44. package/dist/components/Form/index.d.ts.map +1 -0
  45. package/dist/components/Form/index.js +7 -0
  46. package/dist/components/Link/Link.css +70 -0
  47. package/dist/components/Link/Link.d.ts +34 -0
  48. package/dist/components/Link/Link.d.ts.map +1 -0
  49. package/dist/components/Link/Link.js +48 -0
  50. package/dist/components/Link/index.d.ts +3 -0
  51. package/dist/components/Link/index.d.ts.map +1 -0
  52. package/dist/components/Link/index.js +1 -0
  53. package/dist/components/Modal/Modal.css +118 -0
  54. package/dist/components/Modal/Modal.d.ts +64 -0
  55. package/dist/components/Modal/Modal.d.ts.map +1 -0
  56. package/dist/components/Modal/Modal.js +108 -0
  57. package/dist/components/Modal/index.d.ts +3 -0
  58. package/dist/components/Modal/index.d.ts.map +1 -0
  59. package/dist/components/Modal/index.js +1 -0
  60. package/dist/components/Tabs/Tabs.css +132 -0
  61. package/dist/components/Tabs/Tabs.d.ts +63 -0
  62. package/dist/components/Tabs/Tabs.d.ts.map +1 -0
  63. package/dist/components/Tabs/Tabs.js +134 -0
  64. package/dist/components/Tabs/index.d.ts +3 -0
  65. package/dist/components/Tabs/index.d.ts.map +1 -0
  66. package/dist/components/Tabs/index.js +1 -0
  67. package/dist/components/Toast/Toast.css +100 -0
  68. package/dist/components/Toast/Toast.d.ts +59 -0
  69. package/dist/components/Toast/Toast.d.ts.map +1 -0
  70. package/dist/components/Toast/Toast.js +91 -0
  71. package/dist/components/Toast/ToastProvider.css +48 -0
  72. package/dist/components/Toast/ToastProvider.d.ts +22 -0
  73. package/dist/components/Toast/ToastProvider.d.ts.map +1 -0
  74. package/dist/components/Toast/ToastProvider.js +33 -0
  75. package/dist/components/Toast/index.d.ts +5 -0
  76. package/dist/components/Toast/index.d.ts.map +1 -0
  77. package/dist/components/Toast/index.js +2 -0
  78. package/dist/hooks/useAriaLive.d.ts +9 -0
  79. package/dist/hooks/useAriaLive.d.ts.map +1 -0
  80. package/dist/hooks/useAriaLive.js +39 -0
  81. package/dist/hooks/useFocusReturn.d.ts +9 -0
  82. package/dist/hooks/useFocusReturn.d.ts.map +1 -0
  83. package/dist/hooks/useFocusReturn.js +33 -0
  84. package/dist/hooks/useFocusTrap.d.ts +9 -0
  85. package/dist/hooks/useFocusTrap.d.ts.map +1 -0
  86. package/dist/hooks/useFocusTrap.js +68 -0
  87. package/dist/index.d.ts +22 -0
  88. package/dist/index.d.ts.map +1 -0
  89. package/dist/index.js +25 -0
  90. package/dist/styles/components.css +33 -0
  91. package/dist/styles/global.css +289 -0
  92. package/dist/styles/index.d.ts +3 -0
  93. package/dist/styles/index.d.ts.map +1 -0
  94. package/dist/styles/index.js +1 -0
  95. package/dist/tokens/breakpoints.d.ts +25 -0
  96. package/dist/tokens/breakpoints.d.ts.map +1 -0
  97. package/dist/tokens/breakpoints.js +23 -0
  98. package/dist/tokens/colors.d.ts +81 -0
  99. package/dist/tokens/colors.d.ts.map +1 -0
  100. package/dist/tokens/colors.js +86 -0
  101. package/dist/tokens/index.d.ts +6 -0
  102. package/dist/tokens/index.d.ts.map +1 -0
  103. package/dist/tokens/index.js +5 -0
  104. package/dist/tokens/motion.d.ts +30 -0
  105. package/dist/tokens/motion.d.ts.map +1 -0
  106. package/dist/tokens/motion.js +34 -0
  107. package/dist/tokens/spacing.d.ts +22 -0
  108. package/dist/tokens/spacing.d.ts.map +1 -0
  109. package/dist/tokens/spacing.js +20 -0
  110. package/dist/tokens/theme.d.ts +159 -0
  111. package/dist/tokens/theme.d.ts.map +1 -0
  112. package/dist/tokens/theme.js +15 -0
  113. package/dist/tokens/typography.d.ts +45 -0
  114. package/dist/tokens/typography.d.ts.map +1 -0
  115. package/dist/tokens/typography.js +56 -0
  116. package/dist/utils/aria.d.ts +60 -0
  117. package/dist/utils/aria.d.ts.map +1 -0
  118. package/dist/utils/aria.js +86 -0
  119. package/dist/utils/focus.d.ts +30 -0
  120. package/dist/utils/focus.d.ts.map +1 -0
  121. package/dist/utils/focus.js +80 -0
  122. package/dist/utils/index.d.ts +4 -0
  123. package/dist/utils/index.d.ts.map +1 -0
  124. package/dist/utils/index.js +3 -0
  125. package/dist/utils/keyboard.d.ts +38 -0
  126. package/dist/utils/keyboard.d.ts.map +1 -0
  127. package/dist/utils/keyboard.js +59 -0
  128. package/package.json +68 -0
@@ -0,0 +1,259 @@
1
+ /* Button component styles */
2
+ .btn {
3
+ display: inline-flex;
4
+ align-items: center;
5
+ justify-content: center;
6
+ gap: var(--spacing-2, 0.5rem);
7
+ font-family: var(--font-family-sans, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
8
+ font-weight: var(--font-weight-medium, 500);
9
+ line-height: var(--line-height-normal, 1.5);
10
+ border: 1px solid transparent;
11
+ border-radius: 0.375rem;
12
+ cursor: pointer;
13
+ transition: all var(--motion-duration-normal, 200ms) var(--motion-easing-ease-out, cubic-bezier(0, 0, 0.2, 1));
14
+ text-decoration: none;
15
+ white-space: nowrap;
16
+ }
17
+
18
+ /* Respect reduced motion */
19
+ @media (prefers-reduced-motion: reduce) {
20
+ .btn {
21
+ transition: none;
22
+ }
23
+ }
24
+
25
+ /* Focus styles - WCAG 2.4.7 Focus Visible */
26
+ .btn:focus-visible {
27
+ outline: 2px solid var(--color-border-focus, #0ea5e9);
28
+ outline-offset: 2px;
29
+ }
30
+
31
+ .btn:focus:not(:focus-visible) {
32
+ outline: none;
33
+ }
34
+
35
+ /* High contrast mode support */
36
+ @media (prefers-contrast: high) {
37
+ .btn {
38
+ border-width: 2px;
39
+ }
40
+
41
+ .btn:focus-visible {
42
+ outline-width: 3px;
43
+ }
44
+ }
45
+
46
+ /* Disabled state */
47
+ .btn:disabled:not(.btn--loading),
48
+ .btn[aria-disabled="true"]:not(.btn--loading) {
49
+ cursor: not-allowed;
50
+ pointer-events: none;
51
+ opacity: 1; /* Reset opacity so we can use explicit colors */
52
+ }
53
+
54
+ /* Disabled state colors for each variant (but not when loading) */
55
+ .btn--primary:disabled:not(.btn--loading),
56
+ .btn--primary[aria-disabled="true"]:not(.btn--loading) {
57
+ background-color: var(--color-neutral-300, #d4d4d4);
58
+ color: var(--color-neutral-500, #737373);
59
+ }
60
+
61
+ .btn--secondary:disabled:not(.btn--loading),
62
+ .btn--secondary[aria-disabled="true"]:not(.btn--loading) {
63
+ background-color: var(--color-neutral-100, #f5f5f5);
64
+ color: var(--color-neutral-400, #a3a3a3);
65
+ border-color: var(--color-neutral-200, #e5e5e5);
66
+ }
67
+
68
+ .btn--ghost:disabled:not(.btn--loading),
69
+ .btn--ghost[aria-disabled="true"]:not(.btn--loading) {
70
+ background-color: transparent;
71
+ color: var(--color-neutral-400, #a3a3a3);
72
+ }
73
+
74
+ .btn--danger:disabled:not(.btn--loading),
75
+ .btn--danger[aria-disabled="true"]:not(.btn--loading) {
76
+ background-color: var(--color-neutral-300, #d4d4d4);
77
+ color: var(--color-neutral-500, #737373);
78
+ }
79
+
80
+ /* Sizes */
81
+ .btn--sm {
82
+ padding: var(--spacing-2, 0.5rem) var(--spacing-3, 0.75rem);
83
+ font-size: var(--font-size-sm, 0.875rem);
84
+ }
85
+
86
+ .btn--md {
87
+ padding: var(--spacing-3, 0.75rem) var(--spacing-4, 1rem);
88
+ font-size: var(--font-size-base, 1rem);
89
+ }
90
+
91
+ .btn--lg {
92
+ padding: var(--spacing-4, 1rem) var(--spacing-6, 1.5rem);
93
+ font-size: var(--font-size-lg, 1.125rem);
94
+ }
95
+
96
+ /* Variants */
97
+ .btn--primary {
98
+ background-color: var(--color-primary-700, #0369a1);
99
+ color: var(--color-text-inverse, #ffffff);
100
+ }
101
+
102
+ .btn--primary:hover:not(:disabled) {
103
+ background-color: var(--color-primary-800, #075985);
104
+ }
105
+
106
+ .btn--primary:active:not(:disabled) {
107
+ background-color: var(--color-primary-900, #0c4a6e);
108
+ }
109
+
110
+ .btn--secondary {
111
+ background-color: var(--color-neutral-100, #f5f5f5);
112
+ color: var(--color-text-primary, #171717);
113
+ border-color: var(--color-border-default, #bbbbbb);
114
+ }
115
+
116
+ .btn--secondary:hover:not(:disabled) {
117
+ background-color: var(--color-neutral-200, #e5e5e5);
118
+ }
119
+
120
+ .btn--secondary:active:not(:disabled) {
121
+ background-color: var(--color-neutral-300, #d4d4d4);
122
+ }
123
+
124
+ .btn--ghost {
125
+ background-color: transparent;
126
+ color: var(--color-text-primary, #171717);
127
+ }
128
+
129
+ .btn--ghost:hover:not(:disabled) {
130
+ background-color: var(--color-neutral-100, #f5f5f5);
131
+ }
132
+
133
+ .btn--ghost:active:not(:disabled) {
134
+ background-color: var(--color-neutral-200, #e5e5e5);
135
+ }
136
+
137
+ .btn--danger {
138
+ background-color: var(--color-error-600, #dc2626);
139
+ color: var(--color-text-inverse, #ffffff);
140
+ }
141
+
142
+ .btn--danger:hover:not(:disabled) {
143
+ background-color: var(--color-error-700, #b91c1c);
144
+ }
145
+
146
+ .btn--danger:active:not(:disabled) {
147
+ background-color: var(--color-error-700, #b91c1c);
148
+ }
149
+
150
+ /* Loading state */
151
+ .btn--loading {
152
+ position: relative;
153
+ cursor: wait;
154
+ pointer-events: none;
155
+ }
156
+
157
+ .btn--loading .btn__content {
158
+ color: transparent;
159
+ }
160
+
161
+ /* Loading state colors - use slightly different shade of variant color */
162
+ .btn--loading.btn--primary {
163
+ background-color: var(--color-primary-600, #0284c7);
164
+ }
165
+
166
+ .btn--loading.btn--secondary {
167
+ background-color: var(--color-neutral-50, #fafafa);
168
+ }
169
+
170
+ .btn--loading.btn--ghost {
171
+ background-color: var(--color-neutral-50, #fafafa);
172
+ }
173
+
174
+ .btn--loading.btn--danger {
175
+ background-color: var(--color-error-500, #ef4444);
176
+ }
177
+
178
+ .btn__spinner {
179
+ position: absolute;
180
+ top: 50%;
181
+ left: 50%;
182
+ transform: translate(-50%, -50%);
183
+ display: inline-flex;
184
+ align-items: center;
185
+ justify-content: center;
186
+ pointer-events: none;
187
+ }
188
+
189
+ /* Set spinner color based on button variant */
190
+ .btn--primary .btn__spinner,
191
+ .btn--danger .btn__spinner {
192
+ color: var(--color-text-inverse, #ffffff);
193
+ }
194
+
195
+ .btn--secondary .btn__spinner,
196
+ .btn--ghost .btn__spinner {
197
+ color: var(--color-text-primary, #171717);
198
+ }
199
+
200
+ .btn__spinner-icon {
201
+ width: 1em;
202
+ height: 1em;
203
+ color: inherit;
204
+ animation: btn-spin 0.8s linear infinite;
205
+ }
206
+
207
+ .btn__spinner-circle {
208
+ opacity: 1;
209
+ stroke-width: 2.5;
210
+ }
211
+
212
+ .btn__spinner-circle {
213
+ animation: btn-spinner-dash 1.5s ease-in-out infinite;
214
+ }
215
+
216
+ @keyframes btn-spin {
217
+ from {
218
+ transform: rotate(0deg);
219
+ }
220
+ to {
221
+ transform: rotate(360deg);
222
+ }
223
+ }
224
+
225
+ @keyframes btn-spinner-dash {
226
+ 0% {
227
+ stroke-dasharray: 1, 31.416;
228
+ stroke-dashoffset: 0;
229
+ }
230
+ 50% {
231
+ stroke-dasharray: 18.85, 31.416;
232
+ stroke-dashoffset: -9.425;
233
+ }
234
+ 100% {
235
+ stroke-dasharray: 1, 31.416;
236
+ stroke-dashoffset: -31.416;
237
+ }
238
+ }
239
+
240
+ /* Respect reduced motion */
241
+ @media (prefers-reduced-motion: reduce) {
242
+ .btn__spinner-icon,
243
+ .btn__spinner-circle {
244
+ animation: none;
245
+ }
246
+
247
+ .btn__spinner-circle {
248
+ stroke-dasharray: 31.416;
249
+ stroke-dashoffset: 0;
250
+ opacity: 0.5;
251
+ }
252
+ }
253
+
254
+ .btn__content {
255
+ display: inline-flex;
256
+ align-items: center;
257
+ gap: inherit;
258
+ }
259
+
@@ -0,0 +1,37 @@
1
+ import React from 'react';
2
+ import './Button.css';
3
+ export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
4
+ /**
5
+ * Visual variant of the button
6
+ */
7
+ variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
8
+ /**
9
+ * Size of the button
10
+ */
11
+ size?: 'sm' | 'md' | 'lg';
12
+ /**
13
+ * Whether the button is in a loading state
14
+ */
15
+ loading?: boolean;
16
+ /**
17
+ * ARIA label for the button (required if no visible text)
18
+ */
19
+ 'aria-label'?: string;
20
+ }
21
+ /**
22
+ * Accessible Button component
23
+ *
24
+ * WCAG Compliance:
25
+ * - 2.1.1 Keyboard: Full keyboard support (Enter/Space)
26
+ * - 2.4.7 Focus Visible: Clear focus indicators
27
+ * - 4.1.2 Name, Role, Value: Proper ARIA attributes
28
+ *
29
+ * @example
30
+ * ```tsx
31
+ * <Button variant="primary" onClick={handleClick}>
32
+ * Click me
33
+ * </Button>
34
+ * ```
35
+ */
36
+ export declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
37
+ //# sourceMappingURL=Button.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,cAAc,CAAA;AAErB,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IAChF;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAA;IAEtD;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,uFA2FlB,CAAA"}
@@ -0,0 +1,52 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import React from 'react';
3
+ import { createActivationHandler } from '../../utils/keyboard';
4
+ import { getAriaLabel, getBusyAttributes } from '../../utils/aria';
5
+ import './Button.css';
6
+ /**
7
+ * Accessible Button component
8
+ *
9
+ * WCAG Compliance:
10
+ * - 2.1.1 Keyboard: Full keyboard support (Enter/Space)
11
+ * - 2.4.7 Focus Visible: Clear focus indicators
12
+ * - 4.1.2 Name, Role, Value: Proper ARIA attributes
13
+ *
14
+ * @example
15
+ * ```tsx
16
+ * <Button variant="primary" onClick={handleClick}>
17
+ * Click me
18
+ * </Button>
19
+ * ```
20
+ */
21
+ export const Button = React.forwardRef(({ variant = 'primary', size = 'md', loading = false, disabled, children, className = '', onClick, onKeyDown, 'aria-label': ariaLabel, ...props }, ref) => {
22
+ const isDisabled = disabled || loading;
23
+ const handleKeyDown = React.useCallback((event) => {
24
+ // Handle activation keys
25
+ const activationHandler = createActivationHandler((e) => {
26
+ if (!isDisabled && onClick) {
27
+ onClick(e);
28
+ }
29
+ });
30
+ activationHandler(event);
31
+ // Call user's onKeyDown if provided
32
+ if (onKeyDown) {
33
+ onKeyDown(event);
34
+ }
35
+ }, [isDisabled, onClick, onKeyDown]);
36
+ const ariaProps = {
37
+ ...getAriaLabel(ariaLabel),
38
+ ...getBusyAttributes(loading),
39
+ ...props,
40
+ };
41
+ const classes = [
42
+ 'btn',
43
+ `btn--${variant}`,
44
+ `btn--${size}`,
45
+ loading && 'btn--loading',
46
+ className,
47
+ ]
48
+ .filter(Boolean)
49
+ .join(' ');
50
+ return (_jsxs("button", { ref: ref, type: "button", className: classes, disabled: isDisabled, onClick: onClick, onKeyDown: handleKeyDown, "aria-disabled": isDisabled, ...ariaProps, children: [loading && (_jsx("span", { className: "btn__spinner", "aria-hidden": "true", children: _jsx("svg", { className: "btn__spinner-icon", width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: _jsx("circle", { className: "btn__spinner-circle", cx: "8", cy: "8", r: "6", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeDasharray: "31.416", strokeDashoffset: "31.416" }) }) })), _jsx("span", { className: "btn__content", children: children })] }));
51
+ });
52
+ Button.displayName = 'Button';
@@ -0,0 +1,3 @@
1
+ export { Button } from './Button';
2
+ export type { ButtonProps } from './Button';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Button/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA"}
@@ -0,0 +1 @@
1
+ export { Button } from './Button';
@@ -0,0 +1,132 @@
1
+ .data-table-wrapper {
2
+ width: 100%;
3
+ overflow-x: auto;
4
+ border: 1px solid var(--color-border-default, #bbbbbb);
5
+ border-radius: 0.375rem;
6
+ }
7
+
8
+ .data-table {
9
+ width: 100%;
10
+ border-collapse: collapse;
11
+ font-size: var(--font-size-base, 1rem);
12
+ }
13
+
14
+ .data-table-caption {
15
+ padding: var(--spacing-4, 1rem);
16
+ font-weight: var(--font-weight-semibold, 600);
17
+ text-align: left;
18
+ caption-side: top;
19
+ }
20
+
21
+ .data-table-header {
22
+ padding: var(--spacing-3, 0.75rem) var(--spacing-4, 1rem);
23
+ text-align: left;
24
+ font-weight: var(--font-weight-semibold, 600);
25
+ font-size: var(--font-size-sm, 0.875rem);
26
+ color: var(--color-text-secondary, #525252);
27
+ background-color: var(--color-background-secondary, #fafafa);
28
+ border-bottom: 2px solid var(--color-border-default, #bbbbbb);
29
+ }
30
+
31
+ .data-table-header--sortable {
32
+ padding: 0;
33
+ }
34
+
35
+ .data-table-sort-button {
36
+ width: 100%;
37
+ padding: var(--spacing-3, 0.75rem) var(--spacing-4, 1rem);
38
+ text-align: left;
39
+ background: none;
40
+ border: none;
41
+ font-weight: var(--font-weight-semibold, 600);
42
+ font-size: var(--font-size-sm, 0.875rem);
43
+ color: var(--color-text-secondary, #525252);
44
+ cursor: pointer;
45
+ transition: background-color var(--motion-duration-normal, 200ms) var(--motion-easing-ease-out, cubic-bezier(0, 0, 0.2, 1));
46
+ }
47
+
48
+ /* Respect reduced motion */
49
+ @media (prefers-reduced-motion: reduce) {
50
+ .data-table-sort-button {
51
+ transition: none;
52
+ }
53
+ }
54
+
55
+ .data-table-sort-button:hover {
56
+ background-color: var(--color-neutral-100, #f5f5f5);
57
+ }
58
+
59
+ .data-table-sort-button:focus-visible {
60
+ outline: 2px solid var(--color-border-focus, #0ea5e9);
61
+ outline-offset: -2px;
62
+ }
63
+
64
+ .data-table-sort-indicator {
65
+ margin-left: var(--spacing-1, 0.25rem);
66
+ }
67
+
68
+ .data-table-row {
69
+ border-bottom: 1px solid var(--color-border-default, #bbbbbb);
70
+ transition: background-color var(--motion-duration-normal, 200ms) var(--motion-easing-ease-out, cubic-bezier(0, 0, 0.2, 1));
71
+ }
72
+
73
+ /* Respect reduced motion */
74
+ @media (prefers-reduced-motion: reduce) {
75
+ .data-table-row {
76
+ transition: none;
77
+ }
78
+ }
79
+
80
+ .data-table-row:hover {
81
+ background-color: var(--color-background-secondary, #fafafa);
82
+ }
83
+
84
+ .data-table-row--selected {
85
+ background-color: rgba(14, 165, 233, 0.1);
86
+ }
87
+
88
+ .data-table-row--focused {
89
+ outline: 2px solid var(--color-border-focus, #0ea5e9);
90
+ outline-offset: -2px;
91
+ }
92
+
93
+ .data-table-row:focus {
94
+ outline: none;
95
+ }
96
+
97
+ .data-table-row:focus-visible {
98
+ outline: 2px solid var(--color-border-focus, #0ea5e9);
99
+ outline-offset: -2px;
100
+ }
101
+
102
+ .data-table-cell {
103
+ padding: var(--spacing-3, 0.75rem) var(--spacing-4, 1rem);
104
+ color: var(--color-text-primary, #171717);
105
+ }
106
+
107
+ .data-table-cell--checkbox {
108
+ width: 3rem;
109
+ text-align: center;
110
+ }
111
+
112
+ .data-table-header--checkbox {
113
+ width: 3rem;
114
+ text-align: center;
115
+ }
116
+
117
+ /* High contrast mode support */
118
+ @media (prefers-contrast: high) {
119
+ .data-table-wrapper {
120
+ border-width: 2px;
121
+ }
122
+
123
+ .data-table-header {
124
+ border-bottom-width: 3px;
125
+ }
126
+
127
+ .data-table-row--focused,
128
+ .data-table-row:focus-visible {
129
+ outline-width: 3px;
130
+ }
131
+ }
132
+
@@ -0,0 +1,71 @@
1
+ import React from 'react';
2
+ import './DataTable.css';
3
+ export interface DataTableColumn<T> {
4
+ key: string;
5
+ header: string;
6
+ render?: (row: T, index: number) => React.ReactNode;
7
+ sortable?: boolean;
8
+ width?: string;
9
+ }
10
+ export interface DataTableProps<T> {
11
+ /**
12
+ * Data rows
13
+ */
14
+ data: T[];
15
+ /**
16
+ * Column definitions
17
+ */
18
+ columns: DataTableColumn<T>[];
19
+ /**
20
+ * Key function to get unique ID for each row
21
+ */
22
+ getRowId: (row: T) => string;
23
+ /**
24
+ * Whether rows are selectable
25
+ */
26
+ selectable?: boolean;
27
+ /**
28
+ * Selected row IDs
29
+ */
30
+ selectedRows?: string[];
31
+ /**
32
+ * Callback when selection changes
33
+ */
34
+ onSelectionChange?: (selectedIds: string[]) => void;
35
+ /**
36
+ * Sort configuration
37
+ */
38
+ sortConfig?: {
39
+ column: string;
40
+ direction: 'asc' | 'desc';
41
+ };
42
+ /**
43
+ * Callback when sort changes
44
+ */
45
+ onSortChange?: (column: string, direction: 'asc' | 'desc') => void;
46
+ /**
47
+ * Caption for the table (required for accessibility)
48
+ */
49
+ caption?: string;
50
+ }
51
+ /**
52
+ * Accessible DataTable component
53
+ *
54
+ * WCAG Compliance:
55
+ * - 1.3.1 Info and Relationships: Semantic table structure
56
+ * - 2.1.1 Keyboard: Arrow keys, Home/End navigation
57
+ * - 4.1.2 Name, Role, Value: Proper ARIA attributes
58
+ * - 4.1.3 Status Messages: Sort announcements
59
+ *
60
+ * @example
61
+ * ```tsx
62
+ * <DataTable
63
+ * data={users}
64
+ * columns={columns}
65
+ * getRowId={(user) => user.id}
66
+ * caption="User list"
67
+ * />
68
+ * ```
69
+ */
70
+ export declare function DataTable<T extends Record<string, any>>({ data, columns, getRowId, selectable, selectedRows, onSelectionChange, sortConfig, onSortChange, caption, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
71
+ //# sourceMappingURL=DataTable.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../src/components/DataTable/DataTable.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAwC,MAAM,OAAO,CAAA;AAI5D,OAAO,iBAAiB,CAAA;AAExB,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAA;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B;;OAEG;IACH,IAAI,EAAE,CAAC,EAAE,CAAA;IAET;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IAE7B;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAA;IAE5B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAEvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAEnD;;OAEG;IACH,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAC1B,CAAA;IAED;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,KAAK,IAAI,CAAA;IAElE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EACvD,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,UAAkB,EAClB,YAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,OAAO,GACR,EAAE,cAAc,CAAC,CAAC,CAAC,2CAoMnB"}
@@ -0,0 +1,122 @@
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useState, useRef, useCallback } from 'react';
4
+ import { useAriaLive } from '../../hooks/useAriaLive';
5
+ import { isNavigationKey } from '../../utils/keyboard';
6
+ import { Checkbox } from '../Form/Checkbox';
7
+ import './DataTable.css';
8
+ /**
9
+ * Accessible DataTable component
10
+ *
11
+ * WCAG Compliance:
12
+ * - 1.3.1 Info and Relationships: Semantic table structure
13
+ * - 2.1.1 Keyboard: Arrow keys, Home/End navigation
14
+ * - 4.1.2 Name, Role, Value: Proper ARIA attributes
15
+ * - 4.1.3 Status Messages: Sort announcements
16
+ *
17
+ * @example
18
+ * ```tsx
19
+ * <DataTable
20
+ * data={users}
21
+ * columns={columns}
22
+ * getRowId={(user) => user.id}
23
+ * caption="User list"
24
+ * />
25
+ * ```
26
+ */
27
+ export function DataTable({ data, columns, getRowId, selectable = false, selectedRows = [], onSelectionChange, sortConfig, onSortChange, caption, }) {
28
+ const [focusedRow, setFocusedRow] = useState(null);
29
+ const tableRef = useRef(null);
30
+ const rowRefs = useRef(new Map());
31
+ // Announce sort changes
32
+ const sortAnnouncement = sortConfig
33
+ ? `Sorted by ${columns.find((c) => c.key === sortConfig.column)?.header || sortConfig.column}, ${sortConfig.direction === 'asc' ? 'ascending' : 'descending'}`
34
+ : undefined;
35
+ useAriaLive(sortAnnouncement, 'polite');
36
+ const handleSelectAll = useCallback(() => {
37
+ if (!onSelectionChange)
38
+ return;
39
+ const allSelected = selectedRows.length === data.length;
40
+ if (allSelected) {
41
+ onSelectionChange([]);
42
+ }
43
+ else {
44
+ onSelectionChange(data.map(getRowId));
45
+ }
46
+ }, [data, selectedRows, onSelectionChange, getRowId]);
47
+ const handleSelectRow = useCallback((rowId) => {
48
+ if (!onSelectionChange)
49
+ return;
50
+ const isSelected = selectedRows.includes(rowId);
51
+ if (isSelected) {
52
+ onSelectionChange(selectedRows.filter((id) => id !== rowId));
53
+ }
54
+ else {
55
+ onSelectionChange([...selectedRows, rowId]);
56
+ }
57
+ }, [selectedRows, onSelectionChange]);
58
+ const handleSort = useCallback((columnKey) => {
59
+ if (!onSortChange || !columns.find((c) => c.key === columnKey)?.sortable) {
60
+ return;
61
+ }
62
+ const newDirection = sortConfig?.column === columnKey && sortConfig.direction === 'asc'
63
+ ? 'desc'
64
+ : 'asc';
65
+ onSortChange(columnKey, newDirection);
66
+ }, [onSortChange, sortConfig, columns]);
67
+ const handleKeyDown = useCallback((event, rowId, index) => {
68
+ const row = rowRefs.current.get(rowId);
69
+ if (!row)
70
+ return;
71
+ if (isNavigationKey(event.key)) {
72
+ event.preventDefault();
73
+ let newIndex = index;
74
+ switch (event.key) {
75
+ case 'ArrowDown':
76
+ newIndex = Math.min(index + 1, data.length - 1);
77
+ break;
78
+ case 'ArrowUp':
79
+ newIndex = Math.max(index - 1, 0);
80
+ break;
81
+ case 'Home':
82
+ newIndex = 0;
83
+ break;
84
+ case 'End':
85
+ newIndex = data.length - 1;
86
+ break;
87
+ }
88
+ const newRowId = getRowId(data[newIndex]);
89
+ setFocusedRow(newRowId);
90
+ rowRefs.current.get(newRowId)?.focus();
91
+ }
92
+ else if (event.key === ' ' && selectable) {
93
+ event.preventDefault();
94
+ handleSelectRow(rowId);
95
+ }
96
+ }, [data, selectable, handleSelectRow, getRowId]);
97
+ const allSelected = data.length > 0 && selectedRows.length === data.length;
98
+ const someSelected = selectedRows.length > 0 && selectedRows.length < data.length;
99
+ return (_jsx("div", { className: "data-table-wrapper", children: _jsxs("table", { ref: tableRef, className: "data-table", "aria-label": caption, children: [caption && _jsx("caption", { className: "data-table-caption", children: caption }), _jsx("thead", { children: _jsxs("tr", { children: [selectable && (_jsx("th", { scope: "col", className: "data-table-header data-table-header--checkbox", children: _jsx(Checkbox, { checked: allSelected, "aria-label": "Select all rows", onChange: handleSelectAll, "aria-checked": allSelected ? 'true' : someSelected ? 'mixed' : 'false' }) })), columns.map((column) => (_jsx("th", { scope: "col", className: `data-table-header ${column.sortable ? 'data-table-header--sortable' : ''}`, style: column.width ? { width: column.width } : undefined, "aria-sort": sortConfig?.column === column.key
100
+ ? sortConfig.direction === 'asc'
101
+ ? 'ascending'
102
+ : 'descending'
103
+ : 'none', children: column.sortable ? (_jsxs("button", { type: "button", className: "data-table-sort-button", "aria-label": sortConfig?.column === column.key
104
+ ? `${column.header}, sorted ${sortConfig.direction === 'asc' ? 'ascending' : 'descending'}, activate to sort ${sortConfig.direction === 'asc' ? 'descending' : 'ascending'}`
105
+ : `Sort by ${column.header}`, onClick: () => handleSort(column.key), children: [column.header, sortConfig?.column === column.key && (_jsx("span", { className: "data-table-sort-indicator", "aria-hidden": "true", children: sortConfig.direction === 'asc' ? ' ↑' : ' ↓' }))] })) : (column.header) }, column.key)))] }) }), _jsx("tbody", { children: data.map((row, index) => {
106
+ const rowId = getRowId(row);
107
+ const isSelected = selectedRows.includes(rowId);
108
+ const isFocused = focusedRow === rowId;
109
+ return (_jsxs("tr", { ref: (el) => {
110
+ if (el) {
111
+ rowRefs.current.set(rowId, el);
112
+ }
113
+ else {
114
+ rowRefs.current.delete(rowId);
115
+ }
116
+ }, className: `data-table-row ${isSelected ? 'data-table-row--selected' : ''} ${isFocused ? 'data-table-row--focused' : ''}`, tabIndex: 0, "aria-selected": selectable ? isSelected : undefined, onKeyDown: (e) => handleKeyDown(e, rowId, index), onClick: () => {
117
+ if (selectable) {
118
+ handleSelectRow(rowId);
119
+ }
120
+ }, children: [selectable && (_jsx("td", { className: "data-table-cell data-table-cell--checkbox", children: _jsx(Checkbox, { checked: isSelected, "aria-label": `Select row ${index + 1}`, onChange: () => handleSelectRow(rowId), onClick: (e) => e.stopPropagation() }) })), columns.map((column) => (_jsx("td", { className: "data-table-cell", children: column.render ? column.render(row, index) : row[column.key] }, column.key)))] }, rowId));
121
+ }) })] }) }));
122
+ }