accessibility-plugin-react 2.3.1 → 2.3.2
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.
|
@@ -78,7 +78,7 @@ completed. Closing a child issue does not replace the milestone exit review.
|
|
|
78
78
|
- [x] [A11Y-106 — Position, oversized controls, statement link and help #37](https://github.com/prabothcharith/accessibility-react/issues/37) — Implement position and non-drag movement, oversized controls, safe-area actions, conditional statement link and help while reconciling existing positioning work.
|
|
79
79
|
- [x] [A11Y-107 — Base locale infrastructure and English strings #38](https://github.com/prabothcharith/accessibility-react/issues/38) — Add typed English locale strings, configured/html-language fallback, BCP 47 and RTL handling, announcements and safe missing-key behavior.
|
|
80
80
|
- [x] [A11Y-108 — Vite and Next.js App Router consumer integrations #39](https://github.com/prabothcharith/accessibility-react/issues/39) — Provide Vite and Next.js App Router consumers and verify hydration, portals, React peer versions, CSS, declarations, themes and CSP guidance.
|
|
81
|
-
- [
|
|
81
|
+
- [x] [A11Y-109 — CI for typecheck, lint, unit, axe and browser smoke #40](https://github.com/prabothcharith/accessibility-react/issues/40) — Establish CI for typecheck, lint, unit/integration, relevant axe checks, packed browser smoke and supported browser jobs without publication credentials.
|
|
82
82
|
|
|
83
83
|
### M2 — Stable visual and typographic features
|
|
84
84
|
|
package/docs/DEVELOPMENT.md
CHANGED
|
@@ -18,9 +18,25 @@ npm run test:browser
|
|
|
18
18
|
|
|
19
19
|
For a PR under review, check out its head branch instead and record the tested commit. Main contains the merged stabilization and Clean light foundation; PR #17 adds movement and fixed actions.
|
|
20
20
|
|
|
21
|
-
`validate` runs typecheck, lint, unit tests and JS/declaration/CSS build. `test:consumers` builds, packs and installs the archive in `.consumers/react18`, `.consumers/react19` and `.consumers/next`, checks ESM/CJS and declarations/SSR, and produces application production builds. Consumers use explicitly selected framework versions; generated install locks reside in disposable `.consumers`. Network access is required for installation, not widget runtime.
|
|
21
|
+
`validate` runs typecheck, lint, unit tests and JS/declaration/CSS build. `test:consumers` builds, packs and installs the archive in `.consumers/react18`, `.consumers/react19` and `.consumers/next`, checks ESM/CJS and declarations/SSR, and produces application production builds. Consumers use explicitly selected framework versions; generated install locks reside in disposable `.consumers`. Network access is required for installation, not widget runtime.
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
### Local Ports and Consumer Servers
|
|
24
|
+
|
|
25
|
+
Browser integration tests use local test servers started by Playwright:
|
|
26
|
+
|
|
27
|
+
- **Port `7311`**: React 18.3.1 consumer application (Vite).
|
|
28
|
+
- **Port `7312`**: React 19.2.0 consumer application with Tailwind CSS 3 (Vite).
|
|
29
|
+
- **Port `7313`**: Next.js 16.2.10 production server (`next start`) testing App Router, Pages Router, and Server Component boundaries.
|
|
30
|
+
|
|
31
|
+
Avoid using these ports for unrelated background processes. If an `EADDRINUSE` error occurs due to an interrupted run, terminate existing node processes holding these ports.
|
|
32
|
+
|
|
33
|
+
### Browser Test Commands
|
|
34
|
+
|
|
35
|
+
- `npm run test:browser`: Executes the full 6-project browser test matrix (React 18 Chromium, React 19 Tailwind Chromium, Next.js App Router Chromium, Firefox, WebKit, and Mobile WebKit emulation).
|
|
36
|
+
- `npm run test:browser:smoke`: Rapid Chromium-only smoke test on the React 18 consumer for fast developer iteration.
|
|
37
|
+
- `CI=1 npm run test:browser`: Disables server reuse in Playwright and forces fresh server lifecycle per run.
|
|
38
|
+
|
|
39
|
+
`npm run example` serves the built-package examples through Vite after `npm run build`. `npm run dev` watches the library JS bundle; run build:css after editing CSS. `npm run test:watch` is useful locally. `npm pack` produces the actual package archive. Never validate only source imports and call it release-ready.
|
|
24
40
|
|
|
25
41
|
## Directory map
|
|
26
42
|
|
|
@@ -77,7 +93,18 @@ These checks require a human/tester; mark results and platform/version in PROJEC
|
|
|
77
93
|
6. Host integration: sticky/fixed overlays, complex forms, embedded media, route navigation, dynamically inserted content and font loading. Confirm each selected setting improves intended content without concealing important controls. Video hiding does not stop playback.
|
|
78
94
|
7. Inspect reset/unmount restoration, rapid reload storage, blocked storage and corrupted saved data. Test a custom feature's restored and removed-control effects.
|
|
79
95
|
|
|
80
|
-
Automated
|
|
96
|
+
### Automated Axe Audits and Human Acceptance
|
|
97
|
+
|
|
98
|
+
Automated `@axe-core/playwright` checks are executed as part of `tests/browser/widget.spec.ts` against the widget DOM (`[data-arap-ui]`) using WCAG 2.0 A/AA, 2.1 AA, and 2.2 AA rule sets in both light and dark host themes.
|
|
99
|
+
|
|
100
|
+
- **Scope:** Automated axe results verify that rendered markup, color contrast within the widget panel, native form controls, and ARIA attributes do not produce detectable programmatic violations.
|
|
101
|
+
- **Non-Certification:** Automated test suites do not establish official WCAG conformance or substitute for human accessibility acceptance. Real screen-reader navigation (VoiceOver, NVDA), physical touch devices, browser zoom (200%/400%), and keyboard reviews are mandatory components of accessibility validation.
|
|
102
|
+
|
|
103
|
+
### Platform and Environment Failure Modes
|
|
104
|
+
|
|
105
|
+
- **macOS Local Firefox Launch:** Firefox on macOS may fail during Playwright launch with `Could not find profile folder`. The complete Firefox test suite passes in Ubuntu Linux CI.
|
|
106
|
+
- **Port Conflicts:** Ensure ports `7311`, `7312`, and `7313` are free before running `npm run test:browser`. If interrupted, kill existing node processes.
|
|
107
|
+
- **Missing Browser Binaries:** If browser engines are missing, execute `npx playwright install --with-deps chromium firefox webkit`.
|
|
81
108
|
|
|
82
109
|
## Release procedure (manual, owner-authorized)
|
|
83
110
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "accessibility-plugin-react",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.2",
|
|
4
4
|
"description": "A composable React display-preference widget with a clean light design, persistent settings and movable accessible controls.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"module": "dist/index.mjs",
|
|
@@ -36,6 +36,7 @@
|
|
|
36
36
|
"validate": "npm run typecheck && npm run lint && npm test && npm run build",
|
|
37
37
|
"pack:check": "node scripts/check-package.mjs",
|
|
38
38
|
"test:browser": "playwright test",
|
|
39
|
+
"test:browser:smoke": "playwright test --project=react18-chromium",
|
|
39
40
|
"test:consumers": "npm run build && npm run pack:check && node scripts/prepare-consumers.mjs",
|
|
40
41
|
"example": "vite examples",
|
|
41
42
|
"example:next": "npm --prefix examples/next-app run dev",
|