accessibility-plugin-react 1.0.0 → 2.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.
- package/LICENSE +15 -0
- package/README.md +77 -45
- package/dist/index.d.mts +114 -0
- package/dist/index.d.ts +114 -1
- package/dist/index.js +1694 -0
- package/dist/index.js.map +1 -0
- package/dist/index.mjs +1657 -0
- package/dist/index.mjs.map +1 -0
- package/dist/style.css +593 -0
- package/docs/API.md +89 -0
- package/docs/ARCHITECTURE.md +43 -0
- package/docs/BASELINE.md +48 -0
- package/docs/CUSTOM_FEATURES.md +101 -0
- package/docs/DESIGN.md +39 -0
- package/docs/DEVELOPMENT.md +91 -0
- package/docs/FEATURES.md +49 -0
- package/docs/HANDOVER.md +143 -0
- package/docs/INSTALLATION.md +92 -0
- package/docs/MIGRATION.md +40 -0
- package/docs/PROJECT_STATUS.md +95 -0
- package/docs/RELEASE.md +107 -0
- package/docs/ROADMAP.md +29 -0
- package/docs/TROUBLESHOOTING.md +25 -0
- package/docs/assets/clean-light-desktop.png +0 -0
- package/docs/assets/clean-light-mobile.png +0 -0
- package/docs/assets/movable-desktop.png +0 -0
- package/docs/assets/position-menu.png +0 -0
- package/docs/assets/quick-actions-mobile.png +0 -0
- package/docs/assets/widget-desktop.png +0 -0
- package/docs/assets/widget-mobile.png +0 -0
- package/package.json +86 -48
- package/dist/index.es.js +0 -8354
- package/dist/index.umd.js +0 -14
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# Installation and integration
|
|
2
|
+
|
|
3
|
+
## Requirements
|
|
4
|
+
|
|
5
|
+
Development: Node.js 22.13 or newer, npm, Git. Library peers: React/React DOM 18.3.1 or 19.x. Keep React and React DOM on the same version. There are no application environment variables, API keys, backend services or mandatory network access at runtime. Storage is optional (`persist={false}`).
|
|
6
|
+
|
|
7
|
+
The owner selected the existing registry identity `accessibility-plugin-react`. The registry currently has 1.0.0; the owner approved 2.0.0 under the latest tag. The API changes require migration (see MIGRATION.md). For version 2, use `npm install accessibility-plugin-react@2`; plain `npm install accessibility-plugin-react` selects the registry's latest tag. For this checkout:
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
npm ci
|
|
11
|
+
npm run build
|
|
12
|
+
npm pack
|
|
13
|
+
# From an independent application:
|
|
14
|
+
npm install /absolute/path/to/accessibility-plugin-react-2.0.0.tgz
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Import `accessibility-plugin-react/style.css` once near the app entry. Do not add the library to a Tailwind content scan. No shadcn, icon or Motion dependency is needed. See README for complete React/Vite JSX.
|
|
18
|
+
|
|
19
|
+
## Next.js App Router
|
|
20
|
+
|
|
21
|
+
Keep custom hooks and custom apply callbacks in a Client Component. The built library preserves its own client boundary. The root layout may remain a Server Component.
|
|
22
|
+
|
|
23
|
+
```tsx
|
|
24
|
+
// app/preferences.tsx
|
|
25
|
+
"use client";
|
|
26
|
+
import {
|
|
27
|
+
AccessibilityPlugin,
|
|
28
|
+
AccessibilityButton,
|
|
29
|
+
AccessibilityList,
|
|
30
|
+
FontSizeController,
|
|
31
|
+
GrayscaleController,
|
|
32
|
+
ResetController,
|
|
33
|
+
} from "accessibility-plugin-react";
|
|
34
|
+
export default function Preferences() {
|
|
35
|
+
return (
|
|
36
|
+
<AccessibilityPlugin>
|
|
37
|
+
<AccessibilityButton />
|
|
38
|
+
<AccessibilityList>
|
|
39
|
+
<FontSizeController />
|
|
40
|
+
<GrayscaleController />
|
|
41
|
+
<ResetController />
|
|
42
|
+
</AccessibilityList>
|
|
43
|
+
</AccessibilityPlugin>
|
|
44
|
+
);
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
```tsx
|
|
49
|
+
// app/layout.tsx
|
|
50
|
+
import type { ReactNode } from "react";
|
|
51
|
+
import "accessibility-plugin-react/style.css";
|
|
52
|
+
import Preferences from "./preferences";
|
|
53
|
+
export default function RootLayout({ children }: { children: ReactNode }) {
|
|
54
|
+
return (
|
|
55
|
+
<html lang="en">
|
|
56
|
+
<body>
|
|
57
|
+
{children}
|
|
58
|
+
<Preferences />
|
|
59
|
+
</body>
|
|
60
|
+
</html>
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Mount the widget in the persistent root layout, not each route. Do not place document reads inside render. Do not disable SSR merely to mask hydration problems. Effects and portals appear on the client after hydration; a brief default-style paint can occur.
|
|
66
|
+
|
|
67
|
+
## Next.js Pages Router
|
|
68
|
+
|
|
69
|
+
```tsx
|
|
70
|
+
// pages/_app.tsx
|
|
71
|
+
import type { AppProps } from "next/app";
|
|
72
|
+
import "accessibility-plugin-react/style.css";
|
|
73
|
+
import Preferences from "../components/preferences"; // same component as above
|
|
74
|
+
export default function App({ Component, pageProps }: AppProps) {
|
|
75
|
+
return (
|
|
76
|
+
<>
|
|
77
|
+
<Component {...pageProps} />
|
|
78
|
+
<Preferences />
|
|
79
|
+
</>
|
|
80
|
+
);
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Custom global CSS, Tailwind and themes
|
|
85
|
+
|
|
86
|
+
Load library CSS after a host reset and load intentional widget overrides afterward. There is no library global preflight. Portals are independent of application layout and filter effects. Global host styles can still affect inherited properties or override selectors, especially with `!important`; inspect computed styles if controls differ.
|
|
87
|
+
|
|
88
|
+
Filters create a containing block for fixed host descendants. Test sticky/fixed headers, modals, menus, images and third-party overlays in your real application. Text measurement does not enter iframe documents or Shadow DOM. Hiding videos is visual only and is not a playback-control feature. See troubleshooting for CSP and font-loading considerations.
|
|
89
|
+
|
|
90
|
+
## Verified consumers
|
|
91
|
+
|
|
92
|
+
Automated scripts install the packed archive into separate directories rather than importing repository source. They exercise ESM, CommonJS, declarations, SSR, production Vite builds, and production Next App/Pages routes. Exact framework/browser versions and actual results are in PROJECT_STATUS.md. Broader versions allowed by peer ranges are compatibility targets, not individually verified claims.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Migration
|
|
2
|
+
|
|
3
|
+
## From newer development baseline (6dfbd44)
|
|
4
|
+
|
|
5
|
+
Existing compound imports and two-argument `useAccessibility` calls remain. CSS `/dist/style.css` still resolves; prefer `/style.css` for new integrations. Optional trigger icon, configurable labels/style and `persist` are additions.
|
|
6
|
+
|
|
7
|
+
Behavior changes with rationale:
|
|
8
|
+
|
|
9
|
+
- Effects belong to the provider and persist after panel/control removal. Defaults register while the panel is closed; restored settings apply immediately after hydration. To disable a removed feature, reset it first. Mount one provider above routes.
|
|
10
|
+
- The panel is a **non-modal region**, not a modal dialog. Remove tests relying on `role=dialog`, focus traps or fixed ID `arap-panel`. Use the trigger's aria-controls or accessible role/name. Hidden content remains in the DOM; query its visibility rather than asserting node absence.
|
|
11
|
+
- No full-screen/side fixed wrapper around app children. Button/list use body portals. Ancestor-dependent CSS may need `.arap-root` overrides.
|
|
12
|
+
- Text alignment defaults to `default`; persisted `left` now actively forces left. Line-height percentages scale measured baseline. Font percentages scale individual computed fonts, including pixel-sized text, instead of only changing html.
|
|
13
|
+
- Low saturation is 20%, restoring original vanilla behavior; previous 50% is no longer the low preset. Contrast 1/2/3 retains 1.25/1.5/2; reduced and color palettes are additive choices.
|
|
14
|
+
- Image hiding preserves layout and removes CSS backgrounds. Videos use targeted embed recognition; unrelated document/map iframes remain visible. Reading mask now has a transparent reading window.
|
|
15
|
+
- Single provider/document is enforced. Changing persistence configuration in place is rejected; remount with a React key.
|
|
16
|
+
- Custom callbacks passed in hook options are immutable definitions. Direct click-handler DOM mutations must move into an apply callback with cleanup. Ordinary React effects remain supported but end when their own component unmounts.
|
|
17
|
+
- Persisted root data gains a version envelope. Unversioned records still load; invalid values fall back. Reset cancels pending writes and deletes display preferences; when a widget placement is saved, that preference remains. Reset button position removes it separately.
|
|
18
|
+
- Plain scoped CSS replaces Tailwind's global reset. Hosts must import CSS, but need no build-time scanning/configuration.
|
|
19
|
+
|
|
20
|
+
## From older development (7aef17c / PR #1)
|
|
21
|
+
|
|
22
|
+
The owner has selected the existing npm package `accessibility-plugin-react` for this update. The published 1.0.0 package uses the older integration; version 2.0.0 uses with explicit compound composition. Its historical development name was `react-accessibility-plugin@0.1.0`, which is not the release identity. This is a breaking API upgrade, not an automatic visual-only replacement.
|
|
23
|
+
|
|
24
|
+
The inspected published 1.0.0 archive has an empty `dist/index.d.ts` (`export {}`), metadata declaring ISC and a README declaring MIT. The new archive ships usable ESM/CJS declarations and uses ISC following the owner’s explicit confirmation on 2026-10-13 that all included code may be licensed under ISC. Published README package/import names were inconsistent; use `accessibility-plugin-react` and `accessibility-plugin-react/style.css` for this release.
|
|
25
|
+
|
|
26
|
+
Replace `<AccessibilityPlugin tools={...} trigger={...}>app</AccessibilityPlugin>` with app content plus an explicit `<AccessibilityButton icon={...}/>` and `<AccessibilityList>controllers</AccessibilityList>`. There are no automatic tools. Convert FontSizeTool to FontSizeController, LineHeightTool to LineHeightController, LetterSpacingTool to LetterSpacingController, TextAlignTool to TextAlignController. Split ContrastTool into Contrast/Saturation/InvertColors/Grayscale controllers; split CursorTool into BigCursor/ReadingGuide/ReadingMask controllers; split VisualTogglesTool into HideImages/LinkHighlight controllers. HideVideosController is additional. Add ResetController explicitly.
|
|
27
|
+
|
|
28
|
+
Replace `useAccessibility().fontSize/setFontSize` with `useAccessibility('fontSize', 100).value/setValue`; old scale 1.2 becomes 120. Do not mechanically migrate line-height absolute multipliers to relative percentages without checking rendered results. Old localStorage was not implemented; no legacy fixed-provider storage format is promised. The new trigger supports dragging, keyboard/click alternatives and saved placement; configure position for its initial corner.
|
|
29
|
+
|
|
30
|
+
## Historical documents
|
|
31
|
+
|
|
32
|
+
`react-accessibility-plugin-spec.md` and `COMMIT_SUMMARY.md` remain historical evidence. They describe prior intent/results, not current guarantees. Current docs, tests, public declarations and PROJECT_STATUS.md supersede contradictory examples and completion claims.
|
|
33
|
+
|
|
34
|
+
## Movable trigger and fixed actions
|
|
35
|
+
|
|
36
|
+
Pointer dragging is enabled by default; set AccessibilityButton draggable={false} to disable it. Normal activation is preserved through a movement threshold. Saved placement overrides the position prop until reset separately. ResetController keeps the saved placement while resetting display features. Its button moves to the fixed panel action area even when composed inside nested children; CSS overrides relying on its old scroll-list DOM ancestry may need updates. AccessibilityList footer is an additive slot for other fixed actions. Trigger and panel description IDs are now distinct.
|
|
37
|
+
|
|
38
|
+
## Upgrade from the historical compound development name
|
|
39
|
+
|
|
40
|
+
Replace imports from `react-accessibility-plugin` with `accessibility-plugin-react`, including the CSS import. Named compound components and the two-argument hook remain. The default storage key stays `react-accessibility-plugin:state` so existing compound-development preferences and placement are preserved; package branding does not reset user settings. No migration from the old published widget's unverified storage format is promised.
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Project status — 2026-10-13
|
|
2
|
+
|
|
3
|
+
**Local stabilization implemented and automatically verified; stable release not yet approved.** Stabilization was merged into `main` through PR #3 at `2893b6c`. No npm publication or release tag. The original stabilization foundation was `new-development` at `6dfbd44`; Clean light merged through [PR #16](https://github.com/prabothcharith/accessibility-react/pull/16) at `15e9465`. Movement and fixed actions are in [PR #17](https://github.com/prabothcharith/accessibility-react/pull/17) on `codex/movable-quick-actions`, not yet merged.
|
|
4
|
+
|
|
5
|
+
## Status categories
|
|
6
|
+
|
|
7
|
+
| Category | Current evidence |
|
|
8
|
+
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
9
|
+
| Implemented and verified | Provider-owned built-in/custom effects; reset cancellation; validated restoration; all fifteen controllers; combined filters; host style cleanup; dynamic child content; non-modal focus; portal layout; scoped CSS; React18/19 packed consumers; Next App/Pages and direct Server Component imports |
|
|
10
|
+
| Implemented but unverified | Broader React19 patch versions, physical devices, assistive technologies and browser versions outside the executed matrix |
|
|
11
|
+
| Partially implemented | Broad accessibility acceptance: automated keyboard/axe/reflow checks passed, real screen-reader/physical-device/actual zoom review remains. Host-wide integration: known filter/CSP/Shadow DOM/attribute-change limits remain. |
|
|
12
|
+
| In progress | Movable trigger and fixed quick actions are implemented in PR #17; manual release acceptance remains pending. |
|
|
13
|
+
| Planned | Large-DOM profiling, attribute/font-load refresh, explicit effect scopes and richer localization |
|
|
14
|
+
| Blocked | Local macOS Firefox launch only (Linux coverage passed); npm rejected beta publication due to a temporary maintainer account suspension; stable human acceptance remains pending |
|
|
15
|
+
| Deferred | Multi-provider arbitration and live cross-tab sync |
|
|
16
|
+
| Completed | Investigation/baseline, local P0 stabilization, feature regression suite, packed consumer/build verification, documentation, local example verification and full hosted CI meet their stated local acceptance criteria |
|
|
17
|
+
|
|
18
|
+
## Stabilization and Clean light checks
|
|
19
|
+
|
|
20
|
+
Environment: macOS, Node 22.14.0, npm 11.21.0. Baseline: typecheck/build pass, lint seven errors, 24 nominal tests with three ineffective async assertions, 15 audit findings. See BASELINE.md.
|
|
21
|
+
|
|
22
|
+
| Check | Actual result |
|
|
23
|
+
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
|
24
|
+
| npm ci (original lock) | Passed before implementation |
|
|
25
|
+
| npm run typecheck | Passed for source, unit/browser tests and TypeScript configs |
|
|
26
|
+
| npm run lint | Passed with zero warnings, ESLint 10 and hooks rules |
|
|
27
|
+
| npm test | 61 tests passed in 3 files |
|
|
28
|
+
| npm run build | ESM + CJS + both declaration formats + standalone CSS produced |
|
|
29
|
+
| npm audit | Zero vulnerabilities after tooling/dependency updates (snapshot, not a perpetual guarantee) |
|
|
30
|
+
| npm pack / pack:check | Archive generated and inspected; required JS/types/CSS/license present; client boundary and CSS reset guard passed |
|
|
31
|
+
| Clean packed consumer installs | React 18.3.1 and React 19.2.0; ESM, CJS, NodeNext ESM/CommonJS and JSX declarations, SSR and production Vite 7.3.7 builds passed |
|
|
32
|
+
| Next.js 16.2.10 + React19.2.0 | Production webpack build, App Router, Pages Router and direct Server Component package imports passed |
|
|
33
|
+
| Browser suite excluding unavailable Firefox | 31 passed, 4 intentional skips (Next-only test on non-Next projects) |
|
|
34
|
+
| Axe | Zero violations for tested widget scopes in light/dark hosts using WCAG2 A/AA, 2.1AA and 2.2AA tags in passing browser projects |
|
|
35
|
+
| Built examples | Basic and custom demos opened/interacted/reset through actual package imports; zero page errors |
|
|
36
|
+
| Visual review | Desktop and 320px custom example screenshots inspected; no panel overflow/clipped controls observed. Actual images in assets/. |
|
|
37
|
+
| git diff --check | Passed |
|
|
38
|
+
|
|
39
|
+
Local browser projects: Chromium 156 (React18, React19 with Tailwind3, Next production); WebKit 27.2 desktop and iPhone13 emulation. Playwright 1.64.0. These are tested engine builds, not claims about every installed Safari/Chrome version.
|
|
40
|
+
|
|
41
|
+
The initial full browser run had 10 failures: seven Firefox launch failures before page execution, two overly exact WebKit fractional-CSS assertions, and one test clearing storage before a pending pagehide flush. Numeric assertions now use explicit tolerance and each Next route starts with clean storage. The corrected non-Firefox suite passed. Firefox157 build1555 fails “Could not find profile folder” with temporary or persistent profiles, including TMPDIR=/tmp; the local environment provides no Firefox functionality result. Linux-hosted execution is recorded separately below. The workflow retains Firefox tests rather than silently excluding them.
|
|
42
|
+
|
|
43
|
+
Expected error-path unit tests deliberately trigger missing-provider and duplicate-provider errors; jsdom logs these while their throw assertions pass. The continuation added regressions for mount-effect state initialization and focus return when the panel itself is removed. No unexpected runtime errors were observed in the passing browser/examples matrix.
|
|
44
|
+
|
|
45
|
+
## Merge and review state
|
|
46
|
+
|
|
47
|
+
[PR #2](https://github.com/prabothcharith/accessibility-react/pull/2) merged stabilization into `new-development`; [PR #3](https://github.com/prabothcharith/accessibility-react/pull/3) merged the complete implementation into `main`. [Merged-main validation](https://github.com/prabothcharith/accessibility-react/actions/runs/38345207412) passed all jobs. PR #16 merged Clean light into main at `15e9465`; [that main run](https://github.com/prabothcharith/accessibility-react/actions/runs/38353340223) also passed all jobs. PR #17 is the movement follow-up awaiting review. No release tag or npm publication has occurred.
|
|
48
|
+
|
|
49
|
+
## Hosted validation
|
|
50
|
+
|
|
51
|
+
[Initial hosted run](https://github.com/prabothcharith/accessibility-react/actions/runs/38327175897) on commit `0dc6ead`: Node 22 and 24 unit/type/lint/format/build/archive/audit jobs passed. Packed React/Next builds passed. Full browser matrix: 36 passed, five intentional skips, one Firefox failure caused by computed font-size quantization (`19.8125px` vs `19.8px`). Five other Firefox scenarios passed. The font-size test now permits less than 1/32 CSS-pixel rounding error and still verifies the intended enlargement.
|
|
52
|
+
|
|
53
|
+
[Corrected hosted run](https://github.com/prabothcharith/accessibility-react/actions/runs/38327577761) on source/test/workflow commit `4fd3768` **passed all jobs**. Fresh final-lock installs, 59 unit tests on Node 22 and 24, type/lint/format/build/archive/audit checks, three packed consumer builds and the full Chromium/Firefox/WebKit/mobile matrix succeeded: **37 passed, five intentional Next-only skips**. Firefox 157 is verified on Linux. This run verified the earlier stabilization snapshot. Follow-up regressions now cover proportional font/line-height scaling and restoration of nullable custom state before mount-effect initialization; their full hosted verification follows below.
|
|
54
|
+
|
|
55
|
+
CI uses Ubuntu 24.04 and verified Node24-based action releases to avoid the deprecated action runtime and an impending ubuntu-latest image rollover. This configuration passed the corrected hosted run.
|
|
56
|
+
|
|
57
|
+
## Final regression follow-up
|
|
58
|
+
|
|
59
|
+
The local suite now passes 61 tests. Font enlargement scales fixed line heights too, preventing overlapping lines, and a validated nullable custom preference restores before a mount effect can initialize a fallback. Packed consumer builds/type checks passed; the text-layout browser regression passed locally in Chromium and desktop/mobile WebKit (18 passed, three intentional skips). [Final source validation](https://github.com/prabothcharith/accessibility-react/actions/runs/38328538388) on commit `a020352` **passed all jobs**: 61 unit tests on Node 22 and 24, type/lint/format/build/archive/audit checks, all three packed consumers and the full browser matrix (**37 passed, five intentional Next-only skips**). This includes Linux Firefox coverage and both final regressions. Subsequent handover edits only record these results.
|
|
60
|
+
|
|
61
|
+
## Known limits and release gates
|
|
62
|
+
|
|
63
|
+
1. **Human accessibility testing pending:** VoiceOver/NVDA, physical touch devices, forced-colors visual review, browser zoom 200/400%. Automated axe and emulation do not establish WCAG conformance.
|
|
64
|
+
2. **Local Firefox remains unavailable on this Mac.** The complete Firefox browser scenarios passed on Linux, so the local launch issue does not block automated release verification.
|
|
65
|
+
3. **License resolved for this release:** on 2026-10-13 the owner confirmed authority to license all included code under ISC. LICENSE and package/lock metadata now agree on ISC. Historical GPL/ISC/MIT discrepancies remain recorded in baseline/migration evidence.
|
|
66
|
+
4. **Version 2 identity and channel approved:** the owner now selected `accessibility-plugin-react@2.0.0` under `latest`, superseding the unpublished beta candidate. npm maintainer authentication is verified. Registry latest remains 1.0.0 until a successful upload is independently confirmed; see RELEASE.md.
|
|
67
|
+
5. One provider per document, no live cross-tab sync, immutable definitions/storage configuration. Routes should share the provider.
|
|
68
|
+
6. Effects target current-document HTML only; no Shadow DOM, iframe interiors, pseudo-elements or SVG/canvas text. Color filters alter host containing blocks. Late fonts/attribute-only style changes need a preference refresh. Very large/changing DOMs need application-specific profiling.
|
|
69
|
+
7. Media hiding retains layout and does not stop playback. CSP may restrict inline styles/data cursors. No universal host compatibility claim.
|
|
70
|
+
|
|
71
|
+
**Release readiness:** not yet stable-release-ready. Local implementation and integration evidence are substantially stronger than baseline; the gates above remain explicit. See ROADMAP.md for priorities and DEVELOPMENT.md for the manual procedure.
|
|
72
|
+
|
|
73
|
+
## Clean light design follow-up
|
|
74
|
+
|
|
75
|
+
The selected Clean light foundation adds scoped palette variables, decorative icons, compact steppers, responsive spacing, checked selected states, 44px toggle targets and an optional panel description. Local validation: 61 unit tests, type/lint/build/archive checks and all packed consumers passed; Chromium/desktop and mobile WebKit matrix passed 31 tests with four intentional skips. Narrow viewport checks also verify horizontal fit and 44px button dimensions. Runtime screenshots were visually inspected. [Hosted design validation](https://github.com/prabothcharith/accessibility-react/actions/runs/38350884486) and [merged-main validation](https://github.com/prabothcharith/accessibility-react/actions/runs/38353340223) passed all jobs. This foundation is merged, not an outstanding draft. See DESIGN.md.
|
|
76
|
+
|
|
77
|
+
## Movement and quick-action follow-up
|
|
78
|
+
|
|
79
|
+
On PR #17 (movement source `d5e21df`), the trigger persists normalized drag/corner placement alongside display settings, with pointer-cancellation/activation guards and keyboard/click alternatives. Fixed header/footer controls and a keyboard action jump keep reset available without scrolling. Resetting display settings preserves placement; position reset is separate. Local validation: 66 unit tests and packed React18/React19/Next consumers passed; the final local browser matrix passed 46 tests with four intentional skips, including measured-size geometry, mouse/Chromium touch dragging, WebKit mobile taps, cancelled drags, 320px/short-screen fit, persistence and fixed-action checks. Hosted movement validation is tracked by PR #17 checks; it is separate from the earlier merged-main results. Human touch, screen-reader and actual zoom acceptance remains pending.
|
|
80
|
+
|
|
81
|
+
## Release tracking
|
|
82
|
+
|
|
83
|
+
[Project #18](https://github.com/users/prabothcharith/projects/18) and [tracker #15](https://github.com/prabothcharith/accessibility-react/issues/15) hold the first stable release gates. Documentation correction [#9](https://github.com/prabothcharith/accessibility-react/issues/9) is addressed in PR #17. Owner licensing/identity decisions (#4/#5), human acceptance (#6–#8), final candidate checks (#10) and explicitly authorized publication/registry verification (#11) remain required. Build artifacts and merged implementation do not establish registry availability.
|
|
84
|
+
|
|
85
|
+
## npm identity follow-up
|
|
86
|
+
|
|
87
|
+
The owner requested that the new design update the existing `accessibility-plugin-react` package. The `codex/npm-v2-release` branch updates metadata, imports, documentation, examples and packed consumer fixtures to that name. It retains the previous internal storage key to preserve preferences. This branch includes PR #17's movement source and is based on that review head. The inspected 1.0.0 archive has empty declaration exports and conflicting ISC/MIT metadata; migration guidance records the new major API and the owner’s ISC decision. Candidate validation is recorded in RELEASE.md; no registry publication is implied.
|
|
88
|
+
|
|
89
|
+
## Final beta validation and upload status
|
|
90
|
+
|
|
91
|
+
Owner-approved ISC beta source `cf4348b` passed [full hosted validation](https://github.com/prabothcharith/accessibility-react/actions/runs/38356642128): 66 unit tests on Node22/24 and 55 full-matrix browser passes with five intentional skips, plus packed consumers and all build/package checks. npm accepted browser authentication but rejected the upload with a temporary account suspension (E403). Registry checks confirmed no 2.0.0-beta.1, no beta tag, and latest=1.0.0. Publication remains blocked by npm account state, not build failures. Issues #4/#5 are resolved by the owner’s decisions; #11 remains open. See RELEASE.md for the exact archive and retry procedure.
|
|
92
|
+
|
|
93
|
+
## Version 2 channel selection
|
|
94
|
+
|
|
95
|
+
The owner requested 2.0.0 without beta on 2026-10-13. Package/lock version and publishConfig now use 2.0.0/latest; README and migration instructions match. This is explicit publication authorization despite the remaining documented human acceptance checks. The earlier account suspension is a registry blocker independent of version choice. Publication results will be recorded after the retry.
|
package/docs/RELEASE.md
ADDED
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# npm release candidate — 2026-10-13
|
|
2
|
+
|
|
3
|
+
## Identity and current state
|
|
4
|
+
|
|
5
|
+
- Owner-selected package: `accessibility-plugin-react` (same existing npm package).
|
|
6
|
+
- Registry snapshot: `latest=1.0.0`; sole published version 1.0.0; maintainer `praboth`.
|
|
7
|
+
- Owner-approved candidate: `2.0.0`, npm tag `latest`. The owner explicitly selected publication without beta.
|
|
8
|
+
- Source branch: `codex/npm-v2-release`, based on the movement/fixed-actions PR #17 head. No publication, release tag or main merge performed by this preparation.
|
|
9
|
+
- ISC is owner-approved for all included code as of 2026-10-13; LICENSE and package/lock metadata agree. Published 1.0.0 metadata says ISC and its README says MIT; historical inconsistency is retained in migration evidence.
|
|
10
|
+
- npm CLI authentication as package maintainer `praboth` is verified. Credentials/2FA remain outside repository files and chat.
|
|
11
|
+
|
|
12
|
+
The API changes warrant a new major version: explicit button/list/controllers replace the old implicit widget/tools/trigger API. See MIGRATION.md. React18/19 peers, ESM/CJS, usable declarations, both CSS paths, provider-owned effects, Clean light styling and saved movement are included. No styling framework is required. The historical storage key remains unchanged to preserve compound-development preferences.
|
|
13
|
+
|
|
14
|
+
## Preparation and verification
|
|
15
|
+
|
|
16
|
+
Run source checks and validate the actual archive:
|
|
17
|
+
|
|
18
|
+
```sh
|
|
19
|
+
npm ci
|
|
20
|
+
npm run validate
|
|
21
|
+
npm run format:check
|
|
22
|
+
npm run test:consumers
|
|
23
|
+
npx playwright install --with-deps chromium firefox webkit
|
|
24
|
+
npm run test:browser
|
|
25
|
+
npm audit
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Use the hosted Linux matrix for Firefox when this Mac's profile launch fails. Record results for the exact candidate commit, not an earlier PR. Local artifacts and dry runs do not indicate registry publication. Human accessibility/device/zoom/host-integration acceptance remains pending; the owner selected version 2 publication while those checks remain documented.
|
|
29
|
+
|
|
30
|
+
Build and inspect a reviewable archive outside the checkout:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
npm run build
|
|
34
|
+
npm pack --pack-destination /tmp
|
|
35
|
+
npm publish /tmp/accessibility-plugin-react-2.0.0.tgz --dry-run --tag latest --access public
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Executed candidate checks
|
|
39
|
+
|
|
40
|
+
On this preparation branch, the locked install, source/test/config type checks, zero-warning lint, 66 unit tests, JS/types/CSS builds, formatting and archive checks passed. Clean packed React18/React19/Next consumers passed ESM/CJS, SSR, strict declarations and production builds using the new package name. Local Chromium/desktop and mobile WebKit browser checks passed 46 tests with four intentional Next-only skips, including axe and movement/fixed-action regressions. npm audit reported zero vulnerabilities. Tarball publication dry-run passed with the beta tag; it warned that real publication requires authentication.
|
|
41
|
+
|
|
42
|
+
The archive contains the expected package name/version, declarations, both client JS formats, CSS, license, README and documentation. The final archive uses the owner-approved ISC license. [Hosted renamed-package validation](https://github.com/prabothcharith/accessibility-react/actions/runs/38355795578) passed all jobs on 9f48dc3, including Linux Firefox. Final ISC metadata/documentation validation is tracked by PR #18 checks. Human acceptance remains pending.
|
|
43
|
+
|
|
44
|
+
## Publication after the required decisions
|
|
45
|
+
|
|
46
|
+
Log in with the account that has publish rights:
|
|
47
|
+
|
|
48
|
+
```sh
|
|
49
|
+
npm login --registry=https://registry.npmjs.org/
|
|
50
|
+
npm whoami
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
The owner selected the candidate version/channel, resolved licensing and authorized version 2 publication on 2026-10-13. Upload the exact verified archive using:
|
|
54
|
+
|
|
55
|
+
```sh
|
|
56
|
+
npm publish /tmp/accessibility-plugin-react-2.0.0.tgz --tag latest --access public
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
The package's approved publishConfig uses latest. Successful publication makes 2.0.0 the default npm install target. The major API requires migration; see MIGRATION.md. No Git release tag or main merge is authorized by this preparation.
|
|
60
|
+
|
|
61
|
+
After upload, verify registry name/version/license and latest tag, archive integrity, and clean registry installations in the React/Next consumers. Record the published version and source commit only after those checks succeed.
|
|
62
|
+
|
|
63
|
+
## Historical beta publication attempt
|
|
64
|
+
|
|
65
|
+
On 2026-10-13 the owner-approved source `cf4348b` passed [all hosted jobs](https://github.com/prabothcharith/accessibility-react/actions/runs/38356642128): 66 unit tests on Node22/24, packed React18/React19/Next consumers, and 55 browser passes with five intentional Next-only skips including Linux Firefox. Local final ISC source checks and packed consumers also passed.
|
|
66
|
+
|
|
67
|
+
The exact archive was inspected before upload. Its SHA512 integrity is `sha512-zqDaTtbv+3cGpgZlqp1TPmuUs4/R/sczLGUOiuTh34HooAcwqJan7wXvS0CSQTvfa12wYgXybLO7/8ClNl5R+Q==`.
|
|
68
|
+
|
|
69
|
+
After npm browser authentication, publication was rejected with E403: the maintainer account is temporarily suspended after a recent security-sensitive action. Registry verification found only 1.0.0, with latest=1.0.0 and no beta tag/version. **2.0.0-beta.1 is not published.** Registry consumer verification cannot run until publication succeeds. No Git release tag or main merge was made.
|
|
70
|
+
|
|
71
|
+
The owner subsequently selected 2.0.0 under latest. The registry account hold is independent of release version; record the version 2 retry result separately. The hold duration is unknown; no automatic retry is scheduled. License/identity issues #4 and #5 are resolved; publication and stable human acceptance remain open.
|
|
72
|
+
|
|
73
|
+
## Version 2 retry
|
|
74
|
+
|
|
75
|
+
The owner requested export/publication as 2.0.0 without beta on 2026-10-13. Package/lock metadata and publishConfig were changed to 2.0.0/latest, and a new archive is prepared for verification and upload. The earlier beta integrity above applies only to that unpublished beta artifact. Until successful registry verification, 2.0.0 is not claimed as published.
|
|
76
|
+
|
|
77
|
+
## GitHub Actions publication
|
|
78
|
+
|
|
79
|
+
The owner requested a GitHub Actions publishing route for 2.0.0/latest. `.github/workflows/publish.yml` is manually dispatched, defaults to dry-run, validates the exact committed name/version/ISC/latest metadata, runs source/packed-consumer/full Linux browser/audit checks, and uploads the tested archive with its SHA512 checksum. The publishing job downloads that archive and uses npm trusted publishing (OIDC), then verifies registry integrity/latest and clean React18/React19/Next registry consumers. No npm token or automatic push/tag publication is configured.
|
|
80
|
+
|
|
81
|
+
Configure npm’s trusted publisher for package accessibility-plugin-react:
|
|
82
|
+
|
|
83
|
+
- GitHub organization/user: `prabothcharith`
|
|
84
|
+
- Repository: `accessibility-react`
|
|
85
|
+
- Workflow filename: `publish.yml` (without the directory)
|
|
86
|
+
- Environment: leave blank; this workflow does not use a named environment
|
|
87
|
+
- Allowed action: direct `npm publish`
|
|
88
|
+
|
|
89
|
+
Authenticated maintainers can configure it through npm package settings or:
|
|
90
|
+
|
|
91
|
+
```sh
|
|
92
|
+
npm trust github accessibility-plugin-react --file publish.yml --repo prabothcharith/accessibility-react --allow-publish --yes
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Browser/2FA authorization may be required. Trusted publishing requires compatible npm/Node; the workflow uses Node24 and npm11.21.0. The prior npm account hold may still reject setup or publishing; OIDC is not evidence that it is cleared.
|
|
96
|
+
|
|
97
|
+
GitHub requires workflow_dispatch workflows to exist on the default branch. PR #17 supplies movement and PR #18 supplies the npm identity/release workflow; merge #17, retarget #18 to main, and merge it after owner authorization. Then run:
|
|
98
|
+
|
|
99
|
+
```sh
|
|
100
|
+
gh workflow run publish.yml --ref main -f version=2.0.0 -f dry_run=true
|
|
101
|
+
# Authorized real publication:
|
|
102
|
+
gh workflow run publish.yml --ref main -f version=2.0.0 -f dry_run=false
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
References: [npm trusted publishing](https://docs.npmjs.com/trusted-publishers/), [npm trust CLI](https://docs.npmjs.com/cli/v11/commands/npm-trust/), [GitHub manual workflow requirements](https://docs.github.com/en/actions/how-tos/manage-workflow-runs/manually-run-a-workflow). Do not report successful publication until the registry and consumer steps succeed.
|
|
106
|
+
|
|
107
|
+
Local version 2 preparation checks passed: 66 unit tests, type/lint/format/build/archive validation, and packed React18/React19/Next consumer builds. The publication workflow passed actionlint 1.7.12; malformed registry-consumer versions are rejected before installation. The workflow itself has not been dispatched; main-branch availability and npm trusted-publisher setup are still required.
|
package/docs/ROADMAP.md
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Prioritized roadmap
|
|
2
|
+
|
|
3
|
+
No deadlines or percentage-complete estimates. Status is based on current evidence in PROJECT_STATUS.md.
|
|
4
|
+
|
|
5
|
+
| Phase | Priority | Objective / tasks | Dependencies | Acceptance / deliverables | Risk / status |
|
|
6
|
+
| --------------------------- | -------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
|
7
|
+
| Investigation | P0 | Compare vanilla/main/development/new-development, PR #1, history; baseline all checks | Git/registry access | Evidence-backed baseline and parity matrix | Completed locally |
|
|
8
|
+
| Core stabilization | P0 | Provider effects, filter composition, independent storage, reset cancellation, no invisible hit area | Baseline | Close/reopen, reset race, restore, dynamic content and cleanup regressions | Implemented; local automated verification |
|
|
9
|
+
| Features and extension | P1 | All fifteen controllers, missing original variants, safe custom apply contract | Core | Per-feature bounds/states and custom restore/reset/unmount tests; public examples | Implemented; host-specific effect limits documented |
|
|
10
|
+
| Accessibility/UI | P1 | Non-modal semantics, names/focus, safe-area responsive CSS, motion preferences | Core | Keyboard/browser/axe checks plus human SR, actual zoom and device review | Automated checks implemented; human review remains |
|
|
11
|
+
| Packaging/frameworks | P1 | Client boundary, ESM/CJS/types/CSS, React 18/19, Next App/Pages, built examples | Core + build | Clean tarball installs, production builds and runtime tests | Local and hosted consumer verification passed; complete Firefox coverage passed on Linux |
|
|
12
|
+
| CI/release validation | P1 | Execute hosted matrix; fix Firefox launch environment; record results | Push/PR workflow and compatible runner | Passing Node22/24 jobs and full browser matrix on exact release commit | Completed: hosted Node22/24 and full Chromium/Firefox/WebKit/mobile matrix passed |
|
|
13
|
+
| Clean light base design | P1 | Apply owner-selected light concept, icons, tokens and responsive rows | Stabilized core | Browser/axe/target-size checks, actual runtime screenshots and documented overrides | Merged through PR #16; local and hosted checks passed |
|
|
14
|
+
| Movement and quick actions | P1 | Persist drag/corner placement, non-drag controls and fixed reset/footer | Clean light foundation | Drag/cancel/reload/resize and pinned-action browser regressions | In PR #17; 66 unit and 46 local browser checks passed |
|
|
15
|
+
| Ownership/release | P1 | Continue confirmed npm identity; resolve license; choose version; approve merge/tag/publish | Owner decision + all gates | Traceable authorized release with clean registry install | Beta name/version/ISC approved; stable human acceptance remains |
|
|
16
|
+
| Performance/dynamic styling | P2 | Benchmark large documents; incremental observation; attribute/font-load refresh | Real host profiles | Measured budgets, no redundant work, style-change regression tests | Planned; current child-list/resize path works |
|
|
17
|
+
| Host effects hardening | P2 | Optional explicit effect scopes, CSP renderer, Shadow DOM strategy, fixed-descendant filter alternatives | API design and real use cases | Documented contract with package/browser tests | Planned; avoid universal-host compatibility claims |
|
|
18
|
+
| UX enhancements | P2 | Richer per-control labels and localization polish | Stable core + accessibility review | Pointer/touch/keyboard equivalence, no activation regressions | Planned after current design/movement work |
|
|
19
|
+
| Multi-instance/cross-tab | P2 | Decide if needed; deterministic arbitration/synchronization | Usage evidence | Isolated lifetime, persistence and interaction tests | Deferred; one provider/document enforced |
|
|
20
|
+
|
|
21
|
+
Release gates are not satisfied by checking in tests or CI configuration. Execute them on the final candidate. A local Chromium/WebKit pass is not a Firefox pass, and an axe pass is not screen-reader or WCAG certification.
|
|
22
|
+
|
|
23
|
+
Release tasks are tracked in [Project #18](https://github.com/users/prabothcharith/projects/18) under [tracker #15](https://github.com/prabothcharith/accessibility-react/issues/15). Documentation status correction (#9) is in PR #17; owner decisions (#4/#5), human acceptance (#6–#8), final candidate validation (#10) and approved publication (#11) remain open gates.
|
|
24
|
+
|
|
25
|
+
The owner confirmed `accessibility-plugin-react` as the registry identity on 2026-10-13. The npm preparation branch prepares `2.0.0-beta.1`; the owner approved 2.0.0-beta.1 under beta and ISC, and npm maintainer authentication is verified. Stable human acceptance remains pending. See RELEASE.md.
|
|
26
|
+
|
|
27
|
+
Final ISC beta source cf4348b passed the full hosted matrix. npm rejected the upload due to a temporary account suspension; 2.0.0-beta.1 is not published. Owner decision issues #4/#5 are closed; publication #11 and human stable-release acceptance remain open. See RELEASE.md.
|
|
28
|
+
|
|
29
|
+
The owner subsequently chose 2.0.0 under latest instead of beta. Current release preparation follows that instruction; human accessibility acceptance remains documented as pending. Earlier beta preparation/hold notes above are historical; see RELEASE.md for the current version and publication result.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Troubleshooting
|
|
2
|
+
|
|
3
|
+
| Symptom | Check / resolution |
|
|
4
|
+
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
5
|
+
| Widget unstyled | Import `accessibility-plugin-react/style.css` once. Inspect packed CSS, not source Tailwind directives. No consumer Tailwind configuration is required. |
|
|
6
|
+
| “useAccessibility must be used within…” | Put custom control below AccessibilityPlugin and import from the same installed package copy. Check npm ls react/react-dom for duplication. |
|
|
7
|
+
| “Only one AccessibilityPlugin…” | Mount one provider at the persistent app/layout root; do not mount another in each route. Different persistence keys do not permit competing global effect owners. |
|
|
8
|
+
| Changing storage key throws | Remount with React `key`; persistence identity is intentionally immutable. |
|
|
9
|
+
| No effect after installing registry version | These changes are unreleased. Install the local packed archive or verified owner-approved release, not an assumed npm version. |
|
|
10
|
+
| Hydration warnings | Use the built distribution with preserved client directive. Put custom hooks/effect functions in a Client Component. Avoid conditional browser globals in render. Check host hydration independently. |
|
|
11
|
+
| Preference appears after first paint | Storage restores client-side after hydration. A brief default paint is expected; no flash-free SSR claim is made. |
|
|
12
|
+
| Gray makes saturation look ineffective | Grayscale is applied last. Turn it off to see retained saturation. |
|
|
13
|
+
| Fixed host element moves when filters enabled | CSS filters create containing blocks/stacking contexts. Test your host's fixed descendants; this browser behavior is an integration limitation. The widget itself is portaled outside the filtered roots. |
|
|
14
|
+
| Text fails to refresh after theme/font/style change | Child insertion and window resize are observed; pure class/style attribute changes and late font-load metrics are not. Toggle the preference to remeasure. Avoid multiple systems writing the same property. |
|
|
15
|
+
| iframe/Shadow DOM content unchanged | Only HTML in the current document is processed. Shadow roots, iframe interiors, SVG/canvas text, pseudo-elements and raw text nodes directly under body are outside scope. |
|
|
16
|
+
| Hidden video still audible | Visibility is not playback control. Pause/mute through your application's player. Only recognized video embeds are hidden; maps/documents remain. |
|
|
17
|
+
| Custom reset changes UI but not page | Move DOM changes from event handlers to the hook's apply callback with cleanup. For ordinary React effects use value as a dependency and restore prior styles. |
|
|
18
|
+
| Removed control's effect persists | Intentional provider ownership. Reset before removing a feature, or reset globally. Remount provider to change the feature set/definitions. |
|
|
19
|
+
| Storage unavailable or full | Widget stays usable in memory. There is no server sync. Keep custom values small and JSON-compatible; set persist=false if needed. |
|
|
20
|
+
| Preferences differ across tabs | No live cross-tab synchronization. The last write controls the next restoration. |
|
|
21
|
+
| CSP blocks styling or cursor | Built-ins use inline style properties and an SVG data cursor. Test your actual CSP; there is no nonce-based stylesheet renderer in this release. Native cursor fallback remains. |
|
|
22
|
+
| Extremely large/changing pages are slow | Active text/media effects traverse the document on relevant child mutations. Profile your real page; no universal large-DOM performance promise. |
|
|
23
|
+
| Firefox Playwright launch fails before loading the page | On the validation Mac, Firefox 157 build 1555 exited “Could not find profile folder”, including with TMPDIR=/tmp. This is a local environment failure. Full Firefox integration passed on the Linux CI runner; the local launch issue remains reproducible. |
|
|
24
|
+
|
|
25
|
+
For a bug report, include package/build SHA, React/framework/browser/OS versions, a small reproducible application, selected settings, host CSS and whether the actual tarball reproduces it. Do not include private stored preferences or credentials. See baseline and project status for known issues rather than relying on historical completion claims.
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,63 +1,101 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "accessibility-plugin-react",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "A
|
|
5
|
-
"
|
|
6
|
-
"
|
|
7
|
-
"type": "module",
|
|
8
|
-
"main": "dist/index.umd.js",
|
|
9
|
-
"module": "dist/index.es.js",
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "A composable React display-preference widget with a clean light design, persistent settings and movable accessible controls.",
|
|
5
|
+
"main": "dist/index.js",
|
|
6
|
+
"module": "dist/index.mjs",
|
|
10
7
|
"types": "dist/index.d.ts",
|
|
11
|
-
"files": [
|
|
12
|
-
"dist"
|
|
13
|
-
],
|
|
14
8
|
"exports": {
|
|
15
9
|
".": {
|
|
16
|
-
"import":
|
|
17
|
-
|
|
10
|
+
"import": {
|
|
11
|
+
"types": "./dist/index.d.mts",
|
|
12
|
+
"default": "./dist/index.mjs"
|
|
13
|
+
},
|
|
14
|
+
"require": {
|
|
15
|
+
"types": "./dist/index.d.ts",
|
|
16
|
+
"default": "./dist/index.js"
|
|
17
|
+
}
|
|
18
18
|
},
|
|
19
|
+
"./dist/style.css": "./dist/style.css",
|
|
19
20
|
"./style.css": "./dist/style.css"
|
|
20
21
|
},
|
|
22
|
+
"files": [
|
|
23
|
+
"dist",
|
|
24
|
+
"LICENSE",
|
|
25
|
+
"docs"
|
|
26
|
+
],
|
|
21
27
|
"scripts": {
|
|
22
|
-
"
|
|
23
|
-
"build": "
|
|
24
|
-
"
|
|
25
|
-
"
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
"
|
|
29
|
-
"
|
|
30
|
-
"
|
|
31
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"
|
|
34
|
-
"
|
|
35
|
-
"
|
|
36
|
-
"
|
|
37
|
-
"tailwind-merge": "^3.4.0"
|
|
28
|
+
"build": "tsup && npm run build:css",
|
|
29
|
+
"build:css": "node scripts/build-css.mjs",
|
|
30
|
+
"dev": "tsup --watch",
|
|
31
|
+
"lint": "eslint src tests scripts --max-warnings 0",
|
|
32
|
+
"typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.tests.json",
|
|
33
|
+
"test": "vitest run",
|
|
34
|
+
"test:watch": "vitest",
|
|
35
|
+
"prepublishOnly": "npm run build",
|
|
36
|
+
"validate": "npm run typecheck && npm run lint && npm test && npm run build",
|
|
37
|
+
"pack:check": "node scripts/check-package.mjs",
|
|
38
|
+
"test:browser": "playwright test",
|
|
39
|
+
"test:consumers": "npm run build && npm run pack:check && node scripts/prepare-consumers.mjs",
|
|
40
|
+
"example": "vite examples",
|
|
41
|
+
"format": "prettier --write src tests scripts examples docs README.md AGENTS.md CHANGELOG.md *.ts *.json *.mjs .github",
|
|
42
|
+
"format:check": "prettier --check src tests scripts examples docs README.md AGENTS.md CHANGELOG.md *.ts *.json *.mjs .github"
|
|
38
43
|
},
|
|
39
44
|
"peerDependencies": {
|
|
40
|
-
"react": "^19.
|
|
41
|
-
"react-dom": "^19.
|
|
45
|
+
"react": "^18.3.1 || ^19.0.0",
|
|
46
|
+
"react-dom": "^18.3.1 || ^19.0.0"
|
|
42
47
|
},
|
|
43
48
|
"devDependencies": {
|
|
44
|
-
"@
|
|
45
|
-
"@eslint/js": "^
|
|
46
|
-
"@
|
|
47
|
-
"@
|
|
48
|
-
"@
|
|
49
|
-
"@
|
|
50
|
-
"
|
|
51
|
-
"
|
|
52
|
-
"eslint
|
|
53
|
-
"eslint-plugin-react-
|
|
54
|
-
"
|
|
55
|
-
"
|
|
56
|
-
"
|
|
57
|
-
"
|
|
58
|
-
"
|
|
59
|
-
"typescript
|
|
60
|
-
"
|
|
61
|
-
"vite
|
|
49
|
+
"@axe-core/playwright": "^4.13.0",
|
|
50
|
+
"@eslint/js": "^10.0.1",
|
|
51
|
+
"@playwright/test": "^1.64.0",
|
|
52
|
+
"@testing-library/jest-dom": "^6.6.3",
|
|
53
|
+
"@testing-library/react": "^16.1.0",
|
|
54
|
+
"@types/node": "^22.20.5",
|
|
55
|
+
"@types/react": "^18.3.12",
|
|
56
|
+
"@types/react-dom": "^18.3.1",
|
|
57
|
+
"eslint": "^10.12.0",
|
|
58
|
+
"eslint-plugin-react-hooks": "^7.1.1",
|
|
59
|
+
"jsdom": "^25.0.1",
|
|
60
|
+
"prettier": "^3.9.10",
|
|
61
|
+
"react": "^18.3.1",
|
|
62
|
+
"react-dom": "^18.3.1",
|
|
63
|
+
"tsup": "^8.3.5",
|
|
64
|
+
"typescript": "^5.7.2",
|
|
65
|
+
"typescript-eslint": "^8.71.1",
|
|
66
|
+
"vite": "^7.3.7",
|
|
67
|
+
"vitest": "^4.1.11"
|
|
68
|
+
},
|
|
69
|
+
"keywords": [
|
|
70
|
+
"accessibility",
|
|
71
|
+
"a11y",
|
|
72
|
+
"react",
|
|
73
|
+
"widget",
|
|
74
|
+
"plugin",
|
|
75
|
+
"font-size",
|
|
76
|
+
"contrast",
|
|
77
|
+
"grayscale",
|
|
78
|
+
"invert-colors"
|
|
79
|
+
],
|
|
80
|
+
"author": "Praboth Charith",
|
|
81
|
+
"license": "ISC",
|
|
82
|
+
"repository": {
|
|
83
|
+
"type": "git",
|
|
84
|
+
"url": "git+https://github.com/prabothcharith/accessibility-react.git"
|
|
85
|
+
},
|
|
86
|
+
"sideEffects": [
|
|
87
|
+
"**/*.css"
|
|
88
|
+
],
|
|
89
|
+
"engines": {
|
|
90
|
+
"node": ">=22.13"
|
|
91
|
+
},
|
|
92
|
+
"homepage": "https://github.com/prabothcharith/accessibility-react#readme",
|
|
93
|
+
"bugs": {
|
|
94
|
+
"url": "https://github.com/prabothcharith/accessibility-react/issues"
|
|
95
|
+
},
|
|
96
|
+
"publishConfig": {
|
|
97
|
+
"registry": "https://registry.npmjs.org/",
|
|
98
|
+
"access": "public",
|
|
99
|
+
"tag": "latest"
|
|
62
100
|
}
|
|
63
101
|
}
|