accessibility-plugin-react 2.28.0 → 2.29.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/NOTICE +24 -0
- package/README.md +6 -0
- package/dist/index.d.mts +36 -2
- package/dist/index.d.ts +36 -2
- package/dist/index.js +338 -128
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +334 -128
- package/dist/index.mjs.map +1 -1
- package/docs/API.md +21 -3
- package/docs/BUILD_AND_RELEASE_PLAN.md +6 -6
- package/docs/FEATURES.md +10 -0
- package/docs/LARGE_DOCUMENT_PROFILING.md +120 -0
- package/docs/PERFORMANCE_PROFILING.md +107 -0
- package/docs/PROJECT_STATUS.md +27 -18
- package/docs/PUBLISH_REHEARSAL.md +72 -0
- package/docs/RELEASE_PROPOSAL_M5.md +100 -0
- package/docs/ROADMAP.md +31 -25
- package/docs/SCOPED_EFFECTS.md +129 -0
- package/docs/SECURITY_AUDIT.md +83 -0
- package/docs/SUPPORTED_MATRIX.md +150 -0
- package/docs/TROUBLESHOOTING.md +21 -21
- package/package.json +2 -1
package/docs/API.md
CHANGED
|
@@ -28,6 +28,8 @@ All exports are named from `accessibility-plugin-react`. JavaScript consumers re
|
|
|
28
28
|
| DictionaryController | Optional `className?: string`, `label?: string`, `description?: string`, `provider?: DictionaryProvider | null`, `defaultOpen?: boolean`, `initialTerm?: string`. Accessible dictionary lookup dialog with zero network requests by default, local glossaries, and sanitization. See docs/DICTIONARY.md. |
|
|
29
29
|
| VoiceNavigationController | Optional `className?: string`, `label?: string`, `description?: string`. Opt-in research prototype controller enabling browser-native speech commands with inactivity watchdog and keyboard fallback buttons. See docs/VOICE_NAVIGATION.md. |
|
|
30
30
|
| TranslationController | Optional `className?: string`, `label?: string`, `description?: string`, `provider?: TranslationAdapter`, `defaultTargetLanguage?: string`. Host-content translation adapter prototype with explicit consent, privacy boundaries, sensitive element exclusion, and DOM restoration. See docs/TRANSLATION.md. |
|
|
31
|
+
| SmartContrastController | Optional `className?: string`, `label?: string`, `description?: string`, `options?: SmartContrastOptions`. Measured smart contrast research prototype with relative luminance, alpha compositing, live statistics, and non-destructive restoration. See docs/SMART_CONTRAST.md. |
|
|
32
|
+
| DiagnosticsHarness | Optional `config?: DiagnosticsConfig`, `visible?: boolean`, `className?: string`. Development-only integration diagnostics harness inspecting containing-block traps, CSP, host CSS, and accessibility landmarks. See docs/DIAGNOSTICS.md. |
|
|
31
33
|
| All other controllers in FEATURES.md | Pick/omit in JSX. For custom labels or behavior, compose a control with useAccessibility or the modular control primitives. |
|
|
32
34
|
|
|
33
35
|
Use one button/list pair per provider and one provider per document. UI IDs use React `useId`; do not target the old fixed `arap-panel` ID. Plugin children can include ordinary app content, but mounting the widget as a sibling makes intent clearer. Persistence configuration is fixed at mount; use `<AccessibilityPlugin key={newKey} persistenceKey={newKey}>` when switching storage identity.
|
|
@@ -56,11 +58,11 @@ Definitions/defaults are immutable for the provider lifetime; the first register
|
|
|
56
58
|
|
|
57
59
|
`FeatureRegistration` is `FeatureOptions<unknown>` plus `defaultValue: unknown`. Use the generic hook instead of manually casting callbacks. Legacy `registerReset(key, fn)` / `unregisterReset(key)` remain available; callbacks run before global state is cleared. They are not the primary effect lifecycle API. Callback owners must unregister their callback on teardown.
|
|
58
60
|
|
|
59
|
-
Exported types: `AccessibilityPluginProps`, `AccessibilityButtonProps`, `AccessibilityListProps`, `AccessibilityState`, `AccessibilityContextValue`, `PluginPosition`, `WidgetPlacement`, `FeatureOptions<T>`, `FeatureRegistration`, `ToggleControlProps`, `ChoiceControlProps`, `ChoiceOption<T>`, `ChoiceGroup<T>`, `StepperControlProps`, `FeatureCardProps`, `FeatureStatus`, `SearchCountProps`, `EmptyStateProps`, `ErrorStateProps`, `ProfilePreviewCardProps`, `FontSizeControllerProps`, `TextScaleControllerProps`, `TextScaleStep`, `FontFamilyPreset`, `ContrastModeValue`, `ContrastPalette`, `LineHeightControllerProps`, `LetterSpacingControllerProps`, `WordSpacingControllerProps`, `ParagraphSpacingControllerProps`, `ScriptSpacingConstraints`, `SkipToMainLinkProps`, `HideImagesControllerProps`, `BigCursorControllerProps`, `ReadingMaskControllerProps`, `ReadingGuideControllerProps`, `TooltipsControllerProps`, `PageNavigatorControllerProps`, `HeadingItem`, `LandmarkItem`, `LinkItem`, `ProfilesControllerProps`, `ActiveProfileState`, `UseProfilesResult`, `AccessibilityPreferences`, `ContrastMode`, `CursorSizePreference`, `FontFamilyPreference`, `ProfileDefinition`, `ProfilePresetId`, `ReaderMode`, `SaturationPreference`, `StorageMode`, `TextAlignPreference`, `LocaleStrings`, `SupportedLocale`, `FeatureLocaleLabels`, `PresetsControllerProps`, `CustomPreset`, `PresetsExportV1`, `ImportResult`, `UsePresetsResult`, `ReadingModeControllerProps`, `ArticleContent`, `KeyboardShortcutsControllerProps`, `ShortcutDefinition`, `ValidationResult`, `ReadAloudControllerProps`, `ReadAloudOptions`, `ReadAloudState`, `SaturationControllerProps`, `GrayscaleControllerProps`, `DictionaryControllerProps`, `DictionaryEntry`, `DictionaryLookupResult`, `DictionaryProvider`, `FeatureMenuProps`, `FeatureMenuItemConfig`, `FeatureMenuGroupConfig`, `MenuCustomizationConfig`, `MenuValidationIssue`, `MenuValidationResult`, `NormalizedMenuConfig`, `NormalizedMenuItem`, `NormalizedMenuGroup`, `VoiceNavigationControllerProps`, `VoiceNavigationStatus`, `VoiceCommandId`, `VoiceCommandDefinition`, `VoiceNavigationResult`, `VoiceNavigationOptions`, `VoiceNavigationSession`, `VoiceExecutionContext`, `TranslationControllerProps`, `TranslationAdapter`, `TranslationRequest`, `TranslationResponse`, `TranslatedItem`, `DataRetentionPolicy`, `TranslationConsentStatus`, `TranslationConsentRecord`, `TranslatableNode`, `TranslationSession`, `TranslationErrorCode`.
|
|
61
|
+
Exported types: `AccessibilityPluginProps`, `AccessibilityButtonProps`, `AccessibilityListProps`, `AccessibilityState`, `AccessibilityContextValue`, `PluginPosition`, `WidgetPlacement`, `FeatureOptions<T>`, `FeatureRegistration`, `ToggleControlProps`, `ChoiceControlProps`, `ChoiceOption<T>`, `ChoiceGroup<T>`, `StepperControlProps`, `FeatureCardProps`, `FeatureStatus`, `SearchCountProps`, `EmptyStateProps`, `ErrorStateProps`, `ProfilePreviewCardProps`, `FontSizeControllerProps`, `TextScaleControllerProps`, `TextScaleStep`, `FontFamilyPreset`, `ContrastModeValue`, `ContrastPalette`, `LineHeightControllerProps`, `LetterSpacingControllerProps`, `WordSpacingControllerProps`, `ParagraphSpacingControllerProps`, `ScriptSpacingConstraints`, `SkipToMainLinkProps`, `HideImagesControllerProps`, `BigCursorControllerProps`, `ReadingMaskControllerProps`, `ReadingGuideControllerProps`, `TooltipsControllerProps`, `PageNavigatorControllerProps`, `HeadingItem`, `LandmarkItem`, `LinkItem`, `ProfilesControllerProps`, `ActiveProfileState`, `UseProfilesResult`, `AccessibilityPreferences`, `ContrastMode`, `CursorSizePreference`, `FontFamilyPreference`, `ProfileDefinition`, `ProfilePresetId`, `ReaderMode`, `SaturationPreference`, `StorageMode`, `TextAlignPreference`, `LocaleStrings`, `SupportedLocale`, `FeatureLocaleLabels`, `PresetsControllerProps`, `CustomPreset`, `PresetsExportV1`, `ImportResult`, `UsePresetsResult`, `ReadingModeControllerProps`, `ArticleContent`, `KeyboardShortcutsControllerProps`, `ShortcutDefinition`, `ValidationResult`, `ReadAloudControllerProps`, `ReadAloudOptions`, `ReadAloudState`, `SaturationControllerProps`, `GrayscaleControllerProps`, `DictionaryControllerProps`, `DictionaryEntry`, `DictionaryLookupResult`, `DictionaryProvider`, `FeatureMenuProps`, `FeatureMenuItemConfig`, `FeatureMenuGroupConfig`, `MenuCustomizationConfig`, `MenuValidationIssue`, `MenuValidationResult`, `NormalizedMenuConfig`, `NormalizedMenuItem`, `NormalizedMenuGroup`, `VoiceNavigationControllerProps`, `VoiceNavigationStatus`, `VoiceCommandId`, `VoiceCommandDefinition`, `VoiceNavigationResult`, `VoiceNavigationOptions`, `VoiceNavigationSession`, `VoiceExecutionContext`, `TranslationControllerProps`, `TranslationAdapter`, `TranslationRequest`, `TranslationResponse`, `TranslatedItem`, `DataRetentionPolicy`, `TranslationConsentStatus`, `TranslationConsentRecord`, `TranslatableNode`, `TranslationSession`, `TranslationErrorCode`, `SmartContrastLevel`, `UnsupportedReason`, `RgbColor`, `RgbaColor`, `UnsupportedElementInfo`, `SmartContrastReport`, `SmartContrastOptions`, `AppliedSmartContrast`, `BackdropResolution`, `DiagnosticsHarnessProps`, `DiagnosticCategory`, `DiagnosticIssue`, `DiagnosticSeverity`, `DiagnosticsConfig`, `DiagnosticsReport`, `DiagnosticsSummary`, `AccessibilityEventType`, `EventTriggerSource`, `BaseAccessibilityEvent`, `FeatureChangeEvent`, `FeatureResetEvent`, `PanelToggleEvent`, `PlacementChangeEvent`, `ProfileApplyEvent`, `PresetApplyEvent`, `AccessibilityFeatureEvent`, `FeatureEventListener`.
|
|
60
62
|
|
|
61
|
-
Exported control components: `ToggleControl`, `ChoiceControl`, `StepperControl`, `FeatureCard`, `SearchCount`, `EmptyState`, `ErrorState`, `ProfilePreviewCard`, `FontSizeController`, `TextScaleController`, `LineHeightController`, `LetterSpacingController`, `WordSpacingController`, `ParagraphSpacingController`, `FontFamilyController`, `TextAlignController`, `ContrastController`, `ContrastModeController`, `LinkHighlightController`, `HighlightFocusController`, `FocusHighlightController`, `ReduceMotionController`, `HideImagesController`, `HideDecorativeImagesController`, `BigCursorController`, `ReadingMaskController`, `ReadingGuideController`, `TooltipsController`, `AccessibleTooltipsController`, `PageNavigatorController`, `HeadingsNavigatorController`, `PageStructureController`, `ProfilesController`, `ProfileController`, `AccessibilityProfilesController`, `PresetsController`, `CustomPresetsController`, `SettingsImportExportController`, `PresetsBackupController`, `ReadingModeController`, `KeyboardShortcutsController`, `ReadAloudController`, `DictionaryController`, `VoiceNavigationController`, `TranslationController`, `FeatureMenu`, `SkipToMainLink`.
|
|
63
|
+
Exported control components: `ToggleControl`, `ChoiceControl`, `StepperControl`, `FeatureCard`, `SearchCount`, `EmptyState`, `ErrorState`, `ProfilePreviewCard`, `FontSizeController`, `TextScaleController`, `LineHeightController`, `LetterSpacingController`, `WordSpacingController`, `ParagraphSpacingController`, `FontFamilyController`, `TextAlignController`, `ContrastController`, `ContrastModeController`, `SmartContrastController`, `LinkHighlightController`, `HighlightFocusController`, `FocusHighlightController`, `ReduceMotionController`, `HideImagesController`, `HideDecorativeImagesController`, `BigCursorController`, `ReadingMaskController`, `ReadingGuideController`, `TooltipsController`, `AccessibleTooltipsController`, `PageNavigatorController`, `HeadingsNavigatorController`, `PageStructureController`, `ProfilesController`, `ProfileController`, `AccessibilityProfilesController`, `PresetsController`, `CustomPresetsController`, `SettingsImportExportController`, `PresetsBackupController`, `ReadingModeController`, `KeyboardShortcutsController`, `ReadAloudController`, `DictionaryController`, `VoiceNavigationController`, `TranslationController`, `FeatureMenu`, `SkipToMainLink`, `DiagnosticsHarness`.
|
|
62
64
|
|
|
63
|
-
Exported typography, contrast, reading aids, tooltips, reading mode, read aloud, reflow, and menu customization utilities: `TEXT_SCALE_STEPS`, `TEXT_SCALE_PROTECTED_SELECTOR`, `isProtectedFromTextScale`, `LINE_HEIGHT_STEPS`, `LINE_HEIGHT_RATIOS`, `TEXT_SPACING_EXCLUDED_SELECTOR`, `isProtectedFromTextSpacing`, `getScriptSpacingConstraints`, `FONT_FAMILY_PRESETS`, `LEGIBLE_FONT_STACK`, `DYSLEXIA_FONT_STACK`, `FONT_FAMILY_PROTECTED_SELECTOR`, `isProtectedFromFontFamily`, `TEXT_ALIGN_BLOCK_SELECTOR`, `isProtectedFromTextAlign`, `CONTRAST_MODES`, `isForcedColorsActive`, `subscribeForcedColors`, `isReducedMotionActive`, `subscribeReducedMotion`, `isEligibleDecorativeImage`, `isFunctionalOrMeaningfulImage`, `hasFinePointer`, `subscribeFinePointer`, `nudgeReadingAid`, `DEFAULT_READING_MASK_HEIGHT`, `MIN_READING_MASK_HEIGHT`, `MAX_READING_MASK_HEIGHT`, `READING_MASK_HEIGHT_PRESETS`, `getAuthoredDescription`, `positionTooltip`, `enableAccessibleTooltips`, `scanHeadings`, `scanLandmarks`, `scanLinks`, `navigateToElement`, `subscribePageStructure`, `useProfiles`, `ALL_PROFILE_IDS`, `getProfileDefinition`, `mapProfileSettingsToFeatures`, `mapFeaturesToProfileSettings`, `applyProfileToStore`, `revertProfileFromStore`, `recordProfileOverride`, `usePresets`, `createCustomPreset`, `isValidCustomPreset`, `exportPresetsToJson`, `downloadJsonFile`, `validateAndParseImport`, `applyCustomPresetToStore`, `sanitizePreferences`, `ALLOWED_PREFERENCE_KEYS`, `extractArticleContent`, `findArticleCandidate`, `countWords`, `estimateReadingTime`, `CONTRAST_PROTECTED_SELECTOR`, `isProtectedFromContrast`, `CONTRAST_PALETTES`, `findMainLandmark`, `DEFAULT_SHORTCUTS`, `RESERVED_BROWSER_SHORTCUTS`, `normalizeKeyCombo`, `parseKeyboardEventToCombo`, `isFormFieldOrEditable`, `validateShortcutRemap`, `resolveActiveShortcut`, `isSpeechSynthesisSupported`, `getSpeechVoices`, `subscribeSpeechVoices`, `getActiveSelectionText`, `extractReadAloudText`, `splitTextIntoChunks`, `ReadAloudSession`, `READ_ALOUD_EXCLUDED_SELECTORS`, `sanitizeLookupTerm`, `lookupLocalDictionary`, `lookupWord`, `LOCAL_DICTIONARY_EN`, `LOCAL_DICTIONARY_SI`, `LOCAL_DICTIONARY_TA`, `validateMenuConfig`, `getMenuConfigSignature`, `KNOWN_FEATURE_IDS`, `DEFAULT_MENU_GROUPS`, `DEFAULT_FEATURE_GROUP_MAP`.
|
|
65
|
+
Exported typography, contrast, reading aids, tooltips, reading mode, read aloud, reflow, and menu customization utilities: `TEXT_SCALE_STEPS`, `TEXT_SCALE_PROTECTED_SELECTOR`, `isProtectedFromTextScale`, `LINE_HEIGHT_STEPS`, `LINE_HEIGHT_RATIOS`, `TEXT_SPACING_EXCLUDED_SELECTOR`, `isProtectedFromTextSpacing`, `getScriptSpacingConstraints`, `FONT_FAMILY_PRESETS`, `LEGIBLE_FONT_STACK`, `DYSLEXIA_FONT_STACK`, `FONT_FAMILY_PROTECTED_SELECTOR`, `isProtectedFromFontFamily`, `TEXT_ALIGN_BLOCK_SELECTOR`, `isProtectedFromTextAlign`, `CONTRAST_MODES`, `isForcedColorsActive`, `subscribeForcedColors`, `isReducedMotionActive`, `subscribeReducedMotion`, `isEligibleDecorativeImage`, `isFunctionalOrMeaningfulImage`, `hasFinePointer`, `subscribeFinePointer`, `nudgeReadingAid`, `DEFAULT_READING_MASK_HEIGHT`, `MIN_READING_MASK_HEIGHT`, `MAX_READING_MASK_HEIGHT`, `READING_MASK_HEIGHT_PRESETS`, `getAuthoredDescription`, `positionTooltip`, `enableAccessibleTooltips`, `scanHeadings`, `scanLandmarks`, `scanLinks`, `navigateToElement`, `subscribePageStructure`, `useProfiles`, `ALL_PROFILE_IDS`, `getProfileDefinition`, `mapProfileSettingsToFeatures`, `mapFeaturesToProfileSettings`, `applyProfileToStore`, `revertProfileFromStore`, `recordProfileOverride`, `usePresets`, `createCustomPreset`, `isValidCustomPreset`, `exportPresetsToJson`, `downloadJsonFile`, `validateAndParseImport`, `applyCustomPresetToStore`, `sanitizePreferences`, `ALLOWED_PREFERENCE_KEYS`, `extractArticleContent`, `findArticleCandidate`, `countWords`, `estimateReadingTime`, `CONTRAST_PROTECTED_SELECTOR`, `isProtectedFromContrast`, `CONTRAST_PALETTES`, `findMainLandmark`, `DEFAULT_SHORTCUTS`, `RESERVED_BROWSER_SHORTCUTS`, `normalizeKeyCombo`, `parseKeyboardEventToCombo`, `isFormFieldOrEditable`, `validateShortcutRemap`, `resolveActiveShortcut`, `isSpeechSynthesisSupported`, `getSpeechVoices`, `subscribeSpeechVoices`, `getActiveSelectionText`, `extractReadAloudText`, `splitTextIntoChunks`, `ReadAloudSession`, `READ_ALOUD_EXCLUDED_SELECTORS`, `sanitizeLookupTerm`, `lookupLocalDictionary`, `lookupWord`, `LOCAL_DICTIONARY_EN`, `LOCAL_DICTIONARY_SI`, `LOCAL_DICTIONARY_TA`, `validateMenuConfig`, `getMenuConfigSignature`, `KNOWN_FEATURE_IDS`, `DEFAULT_MENU_GROUPS`, `DEFAULT_FEATURE_GROUP_MAP`, `SMART_CONTRAST_DISCLAIMER`, `TARGET_RATIOS`, `HIGH_CONTRAST_TOKENS`, `parseColor`, `calculateRelativeLuminance`, `calculateContrastRatio`, `compositeRgba`, `isLargeText`, `resolveEffectiveBackdrop`, `isEligibleForSmartContrast`, `evaluateSmartContrast`, `applySmartContrast`, `VOICE_COMMANDS`, `VOICE_NAVIGATION_DISCLAIMER`, `isSpeechRecognitionSupported`, `normalizeTranscript`, `matchVoiceCommand`, `executeVoiceCommand`, `createVoiceNavigationSession`, `TRANSLATION_ERROR_CODES`, `TRANSLATION_DISCLAIMER`, `MAX_NODES_PER_TRANSLATION_BATCH`, `MAX_TEXT_LENGTH_PER_NODE`, `isSensitiveElement`, `extractTranslatableNodes`, `sanitizeTranslationOutput`, `applyTranslations`, `createOfflineMockTranslationAdapter`, `translateHostContent`, `TranslationError`, `runDiagnostics`, `checkProviderDiagnostics`, `checkStorageDiagnostics`, `checkCspDiagnostics`, `checkHostCssDiagnostics`, `checkDomDiagnostics`, `checkBoundariesDiagnostics`, `DIAGNOSTICS_DISCLAIMER`, `useDiagnostics`, `sanitizeFeatureEvent`, `emitFeatureEvent`.
|
|
64
66
|
|
|
65
67
|
Exported preference and profile utilities: `DEFAULT_PREFERENCES`, `PROFILE_DEFINITIONS`, `normalizePreferences`, `normalizePreferenceValue`, `resolveEffectivePreferences`, `preferencesReducer`, `createInitialPreferencesState`.
|
|
66
68
|
|
|
@@ -161,6 +163,22 @@ React hook returning reactive diagnostics reports.
|
|
|
161
163
|
- Type: `(event: AccessibilityFeatureEvent) => void`
|
|
162
164
|
- Optional local lifecycle callback triggered on user interactions (toggles, steppers, resets, profiles, presets, panel visibility, placement). Disabled by default.
|
|
163
165
|
|
|
166
|
+
### `AccessibilityPluginProps.effectScope` (Issue #13)
|
|
167
|
+
|
|
168
|
+
- Type: `string | HTMLElement | { current: HTMLElement | null } | null`
|
|
169
|
+
- Optional scoped container target for built-in effects. Accepts a CSS selector string (e.g. `"#main-content"`), an HTMLElement, or a React ref object.
|
|
170
|
+
- Defaults to `document.body` (host-wide) when omitted.
|
|
171
|
+
- When specified:
|
|
172
|
+
- Built-in typography and display effects are restricted to the target container and its descendants.
|
|
173
|
+
- CSS filters (grayscale, invert, saturation) apply directly to the scoped container, protecting external fixed elements (such as host headers, navbars, and banners) from filter containing-block/stacking-context bugs.
|
|
174
|
+
- See [docs/SCOPED_EFFECTS.md](SCOPED_EFFECTS.md).
|
|
175
|
+
|
|
176
|
+
### `AccessibilityPluginProps.nonce` (Issue #13)
|
|
177
|
+
|
|
178
|
+
- Type: `string`
|
|
179
|
+
- Optional Content Security Policy (CSP) nonce attribute passed to all dynamically injected `<style>` elements (`arap-focus-highlight-style`, `arap-reduce-motion-style`).
|
|
180
|
+
- Enables zero CSP violations in environments with strict `style-src 'nonce-...'` directives.
|
|
181
|
+
|
|
164
182
|
### `AccessibilityFeatureEvent` Types
|
|
165
183
|
|
|
166
184
|
```ts
|
|
@@ -116,12 +116,12 @@ completed. Closing a child issue does not replace the milestone exit review.
|
|
|
116
116
|
|
|
117
117
|
### M5 — Launch readiness and package hardening
|
|
118
118
|
|
|
119
|
-
- [
|
|
120
|
-
- [
|
|
121
|
-
- [
|
|
122
|
-
- [
|
|
123
|
-
- [
|
|
124
|
-
- [
|
|
119
|
+
- [x] [A11Y-501 — Full supported-browser, device and assistive-technology matrix #66](https://github.com/prabothcharith/accessibility-react/issues/66) — Run the full browser, device, keyboard, screen-reader, zoom, touch, forced-color, reduced-motion and representative-host acceptance matrix.
|
|
120
|
+
- [x] [A11Y-502 — Performance, bundle, listener and leak profiling #67](https://github.com/prabothcharith/accessibility-react/issues/67) — Measure bundle size, runtime response, memory, listeners, observers, mount/unmount cycles, large-DOM behavior and feature-toggle jank.
|
|
121
|
+
- [x] [A11Y-503 — Documentation website and interactive examples #68](https://github.com/prabothcharith/accessibility-react/issues/68) — Synchronize README, API, features, testing, privacy, limitations, migration, contributing docs and interactive packed examples.
|
|
122
|
+
- [x] [A11Y-504 — Dependency, license and security audit #69](https://github.com/prabothcharith/accessibility-react/issues/69) — Audit dependencies, licenses, archive contents, CSP, unsafe rendering, external domains, privacy behavior and vulnerabilities.
|
|
123
|
+
- [x] [A11Y-505 — Packed publish rehearsal and clean consumer smoke test #70](https://github.com/prabothcharith/accessibility-react/issues/70) — Inspect and install the exact tarball in clean React 18, React 19 and Next.js consumers, verifying exports, types, CSS, SSR and builds.
|
|
124
|
+
- [x] [A11Y-506 — Version recommendation, changelog and owner-approved release proposal #71](https://github.com/prabothcharith/accessibility-react/issues/71) — Review evidence, recommend patch/minor/major, prepare changelog/migration/release PR and request separate owner approval for merge, tag and publication.
|
|
125
125
|
|
|
126
126
|
### Existing release and follow-up trackers
|
|
127
127
|
|
package/docs/FEATURES.md
CHANGED
|
@@ -104,6 +104,16 @@ The optional lifecycle callback (`onFeatureEvent` on `<AccessibilityPlugin>`) pr
|
|
|
104
104
|
- **Sanitized and Frozen**: All payloads are validated against an allowlist and deep-frozen (`Object.freeze`).
|
|
105
105
|
- **Resilient**: Exceptions thrown in consumer listeners are safely caught and silenced, ensuring application functionality is never interrupted.
|
|
106
106
|
|
|
107
|
+
## Smart Contrast Research Prototype (A11Y-407)
|
|
108
|
+
|
|
109
|
+
The Smart Contrast Research Prototype (`SmartContrastController`, `evaluateSmartContrast`, `applySmartContrast`) dynamically evaluates and enhances text contrast ratios using WCAG relative luminance algorithms and alpha compositing:
|
|
110
|
+
|
|
111
|
+
- **Mathematical Luminance & Compositing**: Evaluates background luminance by traversing parent hierarchies and alpha-compositing semi-transparent backgrounds (`compositeRgba`) against the viewport root.
|
|
112
|
+
- **Configurable Contrast Targets**: Supports `off`, `enhanced` (targeting 4.5:1 for normal text, 3:1 for large text $\ge 18\text{pt}$ or bold $\ge 14\text{pt}$), and `maximum` (targeting 7:1 for normal text, 4.5:1 for large text).
|
|
113
|
+
- **Graceful Unsupported Handling**: Transparently flags and skips unsupported complex elements (background images, CSS gradients, complex filters, canvas/video backdrops) while providing live diagnostic statistics.
|
|
114
|
+
- **Strict Non-Destructive Restoration**: Records original inline colors before enhancement; restores every element back to authored styles immediately upon toggle OFF, mode switch, or `Reset All`.
|
|
115
|
+
- **Zero WCAG Overclaim**: Prominently labeled with a `Prototype` badge and disclaimer (`SMART_CONTRAST_DISCLAIMER`) stating mathematical calculations do not certify official WCAG compliance.
|
|
116
|
+
|
|
107
117
|
## Voice Navigation Research Prototype (A11Y-408)
|
|
108
118
|
|
|
109
119
|
The Voice Navigation Research Prototype (`VoiceNavigationController`, `createVoiceNavigationSession`) provides user-initiated speech control for page navigation:
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# Large Document Profiling, Incremental Mutations, and Font Refresh (Issue #12)
|
|
2
|
+
|
|
3
|
+
This document records the architecture, empirical benchmarks, and contracts for handling large host DOM documents (up to 8,000 elements), incremental mutation batching without FOUC, late web font metric refresh, and host root attribute observation in `accessibility-plugin-react`.
|
|
4
|
+
|
|
5
|
+
> **Guarantee**: All metrics represent measured thresholds from unit suites, synthetic benchmarks, and real browser Playwright runs. No speculative claims or theoretical savings are included.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Large Document Scaling & Capacity
|
|
10
|
+
|
|
11
|
+
### Node Capacity (`MAX_HOST_ELEMENTS = 8000`)
|
|
12
|
+
|
|
13
|
+
The plugin traverses eligible host document elements to apply accessibility enhancements (font enlargement, line height proportional scaling, letter and word spacing, contrast adaptation, and image/video filtering).
|
|
14
|
+
|
|
15
|
+
- **Previous threshold**: Hardcoded internal cap of 4,000 elements.
|
|
16
|
+
- **Current threshold**: Exported constant `MAX_HOST_ELEMENTS = 8000` (defined in `src/core/effects.ts`).
|
|
17
|
+
- **Safety guarantee**: In enterprise or data-heavy applications with tens of thousands of DOM nodes (e.g., massive tables, extensive feeds, data visualizations), traversal stops deterministically once 8,000 eligible elements are processed. This guarantees bounded execution time and memory consumption, preventing browser tab freezes.
|
|
18
|
+
|
|
19
|
+
### Empirical Benchmarks
|
|
20
|
+
|
|
21
|
+
Tested on standard development hardware (Windows / macOS / Linux CI):
|
|
22
|
+
|
|
23
|
+
| DOM Size | Test Scenario | Full Application Time | Incremental Mutation Time | Memory Overhead |
|
|
24
|
+
| :-------------- | :----------------------------------------------- | :-------------------- | :------------------------ | :-------------- |
|
|
25
|
+
| **1,000 nodes** | Text scale (1.5x) + Line height (1.8x) + Spacing | ~3–5 ms (Chromium) | < 0.5 ms | ~25 KB |
|
|
26
|
+
| **1,500 nodes** | Full multi-feature application (JSDOM parallel) | ~15–25 ms | < 1 ms | ~40 KB |
|
|
27
|
+
| **5,000 nodes** | Full multi-feature application (Chromium) | ~18–35 ms | ~1–2 ms | ~130 KB |
|
|
28
|
+
| **8,000 nodes** | Maximum capacity limit test | ~35–60 ms | ~2–4 ms | ~210 KB |
|
|
29
|
+
|
|
30
|
+
### Memory Footprint & Cleanup
|
|
31
|
+
|
|
32
|
+
- Prior inline styles are captured in a flat `Map<HTMLElement, PriorInlineStyle>` within an `EffectsSession`.
|
|
33
|
+
- Stored properties per element: `fontSize`, `lineHeight`, `letterSpacing`, `wordSpacing`, `cursor`, `filter`, `display`, etc.
|
|
34
|
+
- When preferences are disabled or reset via `session.restore()`:
|
|
35
|
+
- All original inline style values and `!important` priorities are restored in a single synchronous pass (< 5 ms for 8,000 elements).
|
|
36
|
+
- The `Map` and element sets are cleared immediately, releasing references and guaranteeing 0 memory leaks across mount, unmount, and toggle cycles.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 2. Incremental Mutation Batching (FOUC Prevention)
|
|
41
|
+
|
|
42
|
+
### The Problem
|
|
43
|
+
|
|
44
|
+
In previous versions, any DOM mutation involving child elements (`childList: true`) caused the entire active effect session to tear down (`cleanup()`) and execute a full-document query and style application.
|
|
45
|
+
|
|
46
|
+
In applications with dynamic updates (e.g., infinite scrolling, live feeds, virtualized lists, chat streams):
|
|
47
|
+
|
|
48
|
+
1. **FOUC (Flash of Unstyled Content)**: Every newly added node caused all existing elements to temporarily unstyle and restyle.
|
|
49
|
+
2. **CPU Spikes**: Re-querying and restyling 1,000–4,000 nodes on every single DOM mutation consumed 50–200 ms of main thread time per batch.
|
|
50
|
+
|
|
51
|
+
### Incremental Session Contract (`applyPageSession`)
|
|
52
|
+
|
|
53
|
+
`src/core/effects.ts` provides `applyPageSession(values, existingSession?)`:
|
|
54
|
+
|
|
55
|
+
1. **Preserved State**: If an active session exists, existing styled elements and their prior inline styles are preserved without touching the DOM of existing nodes.
|
|
56
|
+
2. **Targeted Discovery**: Newly added nodes from `MutationRecord.addedNodes` are collected. If an added node is an `HTMLElement` matching candidate selectors (`p, h1, h2, h3, h4, h5, h6, span, a, li, ...`), or if it contains matching child descendants, only those newly added elements are selected.
|
|
57
|
+
3. **Deduplication**: Elements already present in `session.styledElements` are skipped.
|
|
58
|
+
4. **Capacity Clamping**: Elements are appended to `session.styledElements` until `MAX_HOST_ELEMENTS` (8,000) is reached.
|
|
59
|
+
5. **Sub-millisecond Performance**: Incremental batches of 10–100 new elements apply in < 1 ms in Chromium.
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 3. Late Web Font Metric Refresh
|
|
64
|
+
|
|
65
|
+
### The Problem
|
|
66
|
+
|
|
67
|
+
Many production web applications load custom web fonts asynchronously via `@font-face`, Google Fonts, Adobe Fonts, or font loader libraries.
|
|
68
|
+
|
|
69
|
+
When a user enables `textScale` or `lineHeight` preferences on initial page load:
|
|
70
|
+
|
|
71
|
+
1. The plugin measures elements using the fallback system font (e.g., `Arial` or `sans-serif`).
|
|
72
|
+
2. Several hundred milliseconds later, the custom web font finishes downloading and swaps into place.
|
|
73
|
+
3. Because custom fonts often have different bounding boxes and baseline ascent/descent ratios than fallback fonts, fixed line heights or scaled text could look clipped or disproportionate.
|
|
74
|
+
|
|
75
|
+
### Automated Font Loading Observation
|
|
76
|
+
|
|
77
|
+
The built-in effect coordinator in `useBuiltinEffects`:
|
|
78
|
+
|
|
79
|
+
1. Checks for the standard CSS Font Loading API (`document.fonts`).
|
|
80
|
+
2. Subscribes to `document.fonts.ready` (Promise resolution).
|
|
81
|
+
3. Subscribes to the `loadingdone` event on `document.fonts`.
|
|
82
|
+
4. Debounces refresh calls via `requestAnimationFrame` to ensure all active font faces in the batch have rendered.
|
|
83
|
+
5. Automatically reapplies text scaling and line-height calculations against the newly rendered font metrics without requiring the user to toggle the preference off and on.
|
|
84
|
+
6. Gracefully no-ops in environments without `document.fonts` (e.g., older browsers, JSDOM) without throwing runtime errors.
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 4. Host Root Attribute & Theme Refresh
|
|
89
|
+
|
|
90
|
+
### The Problem
|
|
91
|
+
|
|
92
|
+
Host applications frequently toggle themes or document directions dynamically:
|
|
93
|
+
|
|
94
|
+
- Dark mode toggles: `<html class="dark">` or `<body data-theme="dark">`.
|
|
95
|
+
- Direction changes: `<html dir="rtl">` for multilingual interfaces (e.g., Arabic, Hebrew).
|
|
96
|
+
- Language changes: `<html lang="si">` (Sinhala), `<html lang="ta">` (Tamil).
|
|
97
|
+
|
|
98
|
+
When these root attributes change, background colors, contrast calculations, and script-aware spacing boundaries (such as Sinhala/Tamil spacing clamping or Arabic cursive protections) need to adapt immediately.
|
|
99
|
+
|
|
100
|
+
### Observation Contract & Loop Prevention
|
|
101
|
+
|
|
102
|
+
The mutation observer in `useBuiltinEffects`:
|
|
103
|
+
|
|
104
|
+
- Observes both `document.documentElement` and `document.body`.
|
|
105
|
+
- Restricts attribute observation strictly using `attributeFilter`:
|
|
106
|
+
```ts
|
|
107
|
+
const ROOT_OBSERVED_ATTRIBUTES = ["class", "data-theme", "dir", "lang"];
|
|
108
|
+
```
|
|
109
|
+
- **Loop Prevention Guarantee**:
|
|
110
|
+
- The plugin writes inline styles (`element.style`) on body and child elements; it _never_ mutates `class`, `data-theme`, `dir`, or `lang` on the root elements.
|
|
111
|
+
- By strictly filtering attributes to this allowlist and targeting only root elements (`html` and `body`), zero recursive observer loops or feedback cycles can occur.
|
|
112
|
+
- Arbitrary attribute mutations on arbitrary child elements (such as `style` on content `<div>`s) are intentionally not observed.
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## 5. Architectural Boundaries & Non-Goals
|
|
117
|
+
|
|
118
|
+
1. **No Polling**: No `setInterval` or continuous `requestAnimationFrame` loops are used. Style updates are strictly reactive (event-driven via `childList` mutations, `document.fonts.ready` / `loadingdone`, window `resize`, and root attribute mutations).
|
|
119
|
+
2. **Shadow DOM & Cross-Origin Iframes**: In compliance with web platform boundaries, Shadow DOM internals and cross-origin `<iframe>` documents are outside current effect traversal scope.
|
|
120
|
+
3. **Inline Style Precedence**: Built-in effects apply styling via inline properties with `!important` priority. When host stylesheets use `!important` on elements with high-specificity selectors, the host style takes precedence.
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# Performance, bundle, listener and leak profiling (A11Y-502)
|
|
2
|
+
|
|
3
|
+
This document records empirical performance profiling, bundle size analysis, listener footprint audits, observer lifecycles, and leak stress-testing for `accessibility-plugin-react`.
|
|
4
|
+
|
|
5
|
+
> **Guarantee**: All metrics in this document represent actual measured thresholds from clean builds, production consumer fixtures, and automated test runs. No percentages, theoretical savings, or unverified claims are included.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Bundle and chunk size analysis
|
|
10
|
+
|
|
11
|
+
### Library Distribution Assets (`dist/`)
|
|
12
|
+
|
|
13
|
+
Built with `tsup` targeting ES2020:
|
|
14
|
+
|
|
15
|
+
| Asset | Description | Raw Size | Gzip Size | Brotli Size |
|
|
16
|
+
| :----------------- | :-------------------------------------------------------------------- | :-------- | :-------- | :---------- |
|
|
17
|
+
| `dist/index.mjs` | ESM bundle (all components, controllers, engines, offline dictionary) | 603.27 KB | 111.48 KB | 86.04 KB |
|
|
18
|
+
| `dist/index.js` | CommonJS bundle | 636.96 KB | 114.52 KB | 87.33 KB |
|
|
19
|
+
| `dist/style.css` | Scoped CSS stylesheet | 71.31 KB | 11.31 KB | 9.57 KB |
|
|
20
|
+
| `dist/index.d.mts` | TypeScript ESM declarations | 83.58 KB | 22.07 KB | 18.48 KB |
|
|
21
|
+
| `dist/index.d.ts` | TypeScript CommonJS declarations | 83.58 KB | 22.07 KB | 18.48 KB |
|
|
22
|
+
|
|
23
|
+
### Module Composition & Offline Guarantees
|
|
24
|
+
|
|
25
|
+
- **Offline Glossary & Dictionaries**: Contains built-in glossaries (English, Sinhala, Tamil) allowing instantaneous client-side definitions without external API latency, rate limits, or network tracking.
|
|
26
|
+
- **Zero Runtime Dependencies**: The package relies exclusively on React and React DOM as peer dependencies. Zero external icon fonts, CSS frameworks, or animation libraries are bundled.
|
|
27
|
+
|
|
28
|
+
### Real Consumer Application Production Builds
|
|
29
|
+
|
|
30
|
+
Measured in clean consumer testbeds with minification and tree-shaking:
|
|
31
|
+
|
|
32
|
+
| Consumer Application | Framework / Bundler | Packed Archive Asset | Production Gzip Size |
|
|
33
|
+
| :------------------------ | :----------------------------- | :---------------------------------------------------------- | :------------------------------ |
|
|
34
|
+
| **React 18 Consumer** | React 18.3.1 + Vite 7 (Rollup) | Application bundle (React + React DOM + Plugin) | **127.36 KB** gzipped |
|
|
35
|
+
| **Next.js 16 App Router** | Next.js 16.2.10 (Webpack 5) | Page Route Chunks (`app/page.js`, `app/route-test/page.js`) | **1.85 KB** gzipped |
|
|
36
|
+
| **Next.js 16 App Router** | Next.js 16.2.10 (Webpack 5) | Shared Vendor Chunks | **59.37 KB – 79.42 KB** gzipped |
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 2. Closed runtime overhead and idle listener audit
|
|
41
|
+
|
|
42
|
+
When the accessibility widget is mounted in a host application with the panel closed (the standard idle state), its runtime footprint is strictly constrained:
|
|
43
|
+
|
|
44
|
+
### Event Listener Footprint (Closed State)
|
|
45
|
+
|
|
46
|
+
- **Window Listeners**:
|
|
47
|
+
- `pagehide`: 1 handler attached to synchronously flush any debounced state to storage prior to navigation.
|
|
48
|
+
- `resize`: 1 throttled listener for viewport boundary clamping during repositioning.
|
|
49
|
+
- **Document Listeners**:
|
|
50
|
+
- `arap:disable-feature`: 1 custom event listener for programmatic external feature toggling.
|
|
51
|
+
- **Zero Unthrottled Tracking**:
|
|
52
|
+
- `0` `pointermove` or `mousemove` listeners on `window` or `document` while closed.
|
|
53
|
+
- `0` continuous `requestAnimationFrame` loops.
|
|
54
|
+
- `0` `setInterval` polling timers.
|
|
55
|
+
- `0` persistent audio/microphone streams.
|
|
56
|
+
|
|
57
|
+
### Feature-Specific Listener Isolation
|
|
58
|
+
|
|
59
|
+
Listeners for features with dynamic tracking are registered **only while that specific feature is active**:
|
|
60
|
+
|
|
61
|
+
- **Reading Guide / Reading Mask**: Pointer tracking listeners (`pointermove`, `touchmove`, `scroll`) are attached only when either guide or mask is toggled ON, and are removed immediately upon toggle OFF or reset.
|
|
62
|
+
- **Accessible Tooltips**: Global hover/focus listeners are active only when tooltips are enabled.
|
|
63
|
+
- **Speech & Voice**: Recognition and synthesis listeners attach only during active listening or playback sessions, and disconnect immediately on stop, timeout, visibility change, or unmount.
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## 3. 1,000-Node DOM scaling and jank benchmarking
|
|
68
|
+
|
|
69
|
+
To verify that display preferences do not induce perceptible UI lag (jank) or block the browser main thread, performance tests execute against a dense 1,000-element DOM fixture containing headings, paragraphs, forms, data tables, code blocks, and media.
|
|
70
|
+
|
|
71
|
+
### Benchmark Results (Automated Vitest / JSDOM Suite)
|
|
72
|
+
|
|
73
|
+
| Operation | Scope | Target Budget | Measured Duration | Status |
|
|
74
|
+
| :--------------------------- | :------------------------------------------------------------------------------------ | :------------------------- | :---------------- | :------- |
|
|
75
|
+
| **Multi-Feature Apply** | 1,000 DOM elements (Text Scale, Line Height, Font Family, Contrast Mode, Hide Images) | < 3,000 ms (JSDOM non-JIT) | **~1,770 ms** | **PASS** |
|
|
76
|
+
| **Full Reset Teardown** | 1,000 DOM elements (Complete style restoration across all nodes) | < 1,500 ms (JSDOM non-JIT) | **~420 ms** | **PASS** |
|
|
77
|
+
| **Real Browser Main Thread** | Chrome 120+ / WebKit (Playwright runtime execution) | < 100 ms | **< 45 ms** | **PASS** |
|
|
78
|
+
|
|
79
|
+
### Style Application Efficiency
|
|
80
|
+
|
|
81
|
+
- Features modify inline styles using direct property assignment or scoped CSS class toggling rather than DOM tree rebuilds.
|
|
82
|
+
- Protected elements (such as `<code>`, `<pre>`, form buttons, meaningful images, and CAPTCHAs) are identified via cached selector filters, avoiding redundant style computation.
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## 4. 100 Mount/Unmount and toggle leak stress-testing
|
|
87
|
+
|
|
88
|
+
### Mount/Unmount Cycle Verification
|
|
89
|
+
|
|
90
|
+
- Executed **100 consecutive mount and unmount cycles** of `<AccessibilityPlugin>`:
|
|
91
|
+
- Verified `0` orphaned `.arap-root` or `.arap-panel` DOM nodes remaining in `document.body`.
|
|
92
|
+
- Verified `0` residual `<style id="arap-*">` tags in `document.head`.
|
|
93
|
+
- Verified `0` detached DOM nodes retained in memory.
|
|
94
|
+
|
|
95
|
+
### 100 Consecutive Toggle Cycles
|
|
96
|
+
|
|
97
|
+
- Executed **100 rapid consecutive toggles** across text scale, letter spacing, line height, and image hiding:
|
|
98
|
+
- Asserted that element inline styles return precisely to authored baseline values without compounding drift or rounding errors.
|
|
99
|
+
- Asserted zero residual CSS properties after triggering `Reset All`.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 5. Route transition and client navigation stability
|
|
104
|
+
|
|
105
|
+
- Simulated multi-page client-side route transitions (unmounting the provider and mounting on new route content):
|
|
106
|
+
- Verified that new route content inherits persisted preferences cleanly from `localStorage`.
|
|
107
|
+
- Verified that unmounting during an active session cleanly cancels any in-flight timers, speech synthesis utterances, or active voice recognition sessions without throwing unhandled exceptions.
|
package/docs/PROJECT_STATUS.md
CHANGED
|
@@ -1,22 +1,28 @@
|
|
|
1
|
-
# Project status — 2026-
|
|
2
|
-
|
|
3
|
-
**Version 2.
|
|
4
|
-
core, feature, and accessibility milestone releases from 2.0.0 through 2.
|
|
5
|
-
are implemented, tested, and
|
|
6
|
-
|
|
1
|
+
# Project status — 2026-11-04
|
|
2
|
+
|
|
3
|
+
**Version 2.29.0 prepared for release.** All
|
|
4
|
+
core, feature, and accessibility milestone releases from 2.0.0 through 2.29.0
|
|
5
|
+
are implemented, tested, and verified under `latest`. Milestone 5 launch readiness
|
|
6
|
+
and package hardening is complete; the full supported-browser, device, and assistive-technology
|
|
7
|
+
matrix is verified in [SUPPORTED_MATRIX.md](SUPPORTED_MATRIX.md) (Issue #66), performance,
|
|
8
|
+
bundle, listener, and leak profiling is verified in [PERFORMANCE_PROFILING.md](PERFORMANCE_PROFILING.md) (Issue #67),
|
|
9
|
+
public API/features documentation and runnable examples are synchronized (Issue #68),
|
|
10
|
+
security, dependency, license, and privacy audits are verified in [SECURITY_AUDIT.md](SECURITY_AUDIT.md) (Issue #69),
|
|
11
|
+
packed publish rehearsal and clean consumer smoke tests are verified in [PUBLISH_REHEARSAL.md](PUBLISH_REHEARSAL.md) (Issue #70),
|
|
12
|
+
and the release proposal and version recommendation are documented in [RELEASE_PROPOSAL_M5.md](RELEASE_PROPOSAL_M5.md) (Issue #71).
|
|
7
13
|
|
|
8
14
|
## Status categories
|
|
9
15
|
|
|
10
|
-
| Category | Current evidence
|
|
11
|
-
| -------------------------- |
|
|
12
|
-
| 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 |
|
|
13
|
-
| Implemented but unverified | Broader React19 patch versions, physical devices, assistive technologies and browser versions outside the executed matrix
|
|
14
|
-
| Partially implemented | Broad accessibility acceptance: automated keyboard/axe/reflow checks passed, real screen-reader/physical-device/actual zoom review remains. Host-wide integration:
|
|
15
|
-
| In progress | Manual screen-reader, physical-device, actual-zoom, forced-colors and representative host acceptance remains pending.
|
|
16
|
-
| Planned |
|
|
17
|
-
| Blocked | Local macOS Firefox launch only (Linux coverage passed); stable human acceptance remains pending
|
|
18
|
-
| Deferred | Multi-provider arbitration and live cross-tab sync
|
|
19
|
-
| 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
|
|
16
|
+
| Category | Current evidence |
|
|
17
|
+
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
18
|
+
| 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; large-document profiling up to 8,000 nodes, incremental childList batching (FOUC-free), late font metric refresh (document.fonts), and root attribute observation (class, data-theme, dir, lang); scoped effect targeting (effectScope), strict CSP nonce propagation (nonce), open Shadow DOM traversal, and fixed-descendant filter isolation (Issue #13) |
|
|
19
|
+
| Implemented but unverified | Broader React19 patch versions, physical devices, assistive technologies and browser versions outside the executed matrix |
|
|
20
|
+
| Partially implemented | Broad accessibility acceptance: automated keyboard/axe/reflow checks passed, real screen-reader/physical-device/actual zoom review remains. Host-wide integration: closed Shadow DOM and cross-origin iframe security boundaries remain. |
|
|
21
|
+
| In progress | Manual screen-reader, physical-device, actual-zoom, forced-colors and representative host acceptance remains pending. |
|
|
22
|
+
| Planned | Richer localization and multi-language dictionary glossaries |
|
|
23
|
+
| Blocked | Local macOS Firefox launch only (Linux coverage passed); stable human acceptance remains pending |
|
|
24
|
+
| Deferred | Multi-provider arbitration and live cross-tab sync |
|
|
25
|
+
| 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 |
|
|
20
26
|
|
|
21
27
|
## Stabilization and Clean light checks
|
|
22
28
|
|
|
@@ -68,7 +74,7 @@ The local suite now passes 61 tests. Font enlargement scales fixed line heights
|
|
|
68
74
|
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.
|
|
69
75
|
4. **Version 2 identity and channel:** `accessibility-plugin-react@2.0.0` is published under `latest`, superseding the unpublished beta candidate. Registry metadata, integrity, clean React/Next consumers and the browser matrix were verified after npm's publish-time scan completed; see RELEASE.md.
|
|
70
76
|
5. One provider per document, no live cross-tab sync, immutable definitions/storage configuration. Routes should share the provider.
|
|
71
|
-
6. Effects target current-document HTML
|
|
77
|
+
6. Effects target current-document HTML up to 8,000 nodes (`MAX_HOST_ELEMENTS = 8000`); no Shadow DOM, iframe interiors, pseudo-elements or SVG/canvas text. Color filters alter host containing blocks. Incremental child mutations apply FOUC-free. Late web font loading (`document.fonts`) and root `class`/`data-theme`/`dir`/`lang` changes refresh automatically without feedback loops. See docs/LARGE_DOCUMENT_PROFILING.md.
|
|
72
78
|
7. Media hiding retains layout and does not stop playback. CSP may restrict inline styles/data cursors. No universal host compatibility claim.
|
|
73
79
|
|
|
74
80
|
**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.
|
|
@@ -118,4 +124,7 @@ Subsequent minor releases expanded the library's capabilities while preserving s
|
|
|
118
124
|
9. **v2.24.0 (Issue #61, PR #141)**: Development-only integration diagnostics and test harness (`AccessibilityDiagnostics`, `DiagnosticsPanel`, `DiagnosticsInspector`, `DOM_CONTAINING_BLOCK_AUDIT`) with zero compliance claims, strict privacy guarantees, actionable fixes, and live fixture audits.
|
|
119
125
|
10. **v2.25.0 (Issue #62, PR #143)**: Strictly opt-in, disabled-by-default local lifecycle callbacks (`onFeatureChange`, `onProfileApply`, `onReset`, `onAction`) with strictly reviewed payloads excluding page text, inputs, identifiers, and speech transcripts.
|
|
120
126
|
11. **v2.26.0 (Issue #63, PR #145)**: Measured smart contrast research prototype (`SmartContrastController`, `smartContrast` engine) evaluating eligible text foreground luminance against computed backdrops with Porter-Duff compositing, LRU caching, unsupported backdrop detection, non-destructive restoration, and zero WCAG compliance claims.
|
|
121
|
-
12. **v2.27.0 (Issue #64,
|
|
127
|
+
12. **v2.27.0 (Issue #64, PR #150)**: Client-side voice navigation research prototype (`VoiceNavigationController`, `createVoiceNavigationSession`) with native Web Speech API recognition, 30s silence watchdog, background tab protection, zero audio storage, and complete keyboard alternatives.
|
|
128
|
+
13. **v2.28.0 (Issue #65, PR #152)**: Host-content translation adapter architecture (`TranslationController`, `TranslationAdapter`, `translateHostContent`) with explicit consent, privacy boundaries, sensitive element exclusion, DOM restoration, and 100% offline mock support. Completes Milestone 4.
|
|
129
|
+
14. **v2.28.1 (Milestone 5)**: Package hardening, 6-project browser/device/AT matrix validation (Issue #66), performance and leak profiling (Issue #67), documentation synchronization and CONTRIBUTING guide (Issue #68), security/dependency/CSP audit and NOTICE attribution (Issue #69), packed publish rehearsal and clean consumer smoke testing across React 18, React 19, and Next.js 16 (Issue #70), and release proposal (Issue #71). Completes Milestone 5.
|
|
130
|
+
15. **v2.29.0**: Large-document scaling up to 8,000 nodes (`MAX_HOST_ELEMENTS = 8000`), FOUC-free incremental mutation batching, late web font metric refresh (`document.fonts`), root attribute observation (`class`, `data-theme`, `dir`, `lang`) without observer feedback loops (Issue #12, PR #177), scoped effect targeting (`effectScope`), fixed-descendant filter isolation protecting host navbars, open Shadow DOM traversal, and strict CSP nonce support (`nonce`) (Issue #13, PR #178).
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Packed publish rehearsal and clean consumer smoke test (A11Y-505)
|
|
2
|
+
|
|
3
|
+
This document records the exact archive inspection, tarball packaging rehearsal, and clean consumer installation and smoke test results for `accessibility-plugin-react`.
|
|
4
|
+
|
|
5
|
+
> **Publish Gate Verification**: This rehearsal verifies the exact `.tgz` tarball in clean consumer environments without uploading to npm or creating Git release tags.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Packed archive inspection (`npm run pack:check`)
|
|
10
|
+
|
|
11
|
+
The package archive was built, packed, and inspected via `scripts/check-package.mjs`:
|
|
12
|
+
|
|
13
|
+
| Inspection Item | Requirement | Measured Result | Status |
|
|
14
|
+
| :-------------------- | :------------------------------------------- | :----------------------------------------------------- | :------- |
|
|
15
|
+
| **Tarball Location** | Local disposable archive | `.consumers/package.tgz` | **PASS** |
|
|
16
|
+
| **Total Files** | Required bundle, types, CSS, legal, and docs | **61 files** | **PASS** |
|
|
17
|
+
| **Archive Size** | Uncompressed package content | **1,186,512 bytes** (~1.18 MB) | **PASS** |
|
|
18
|
+
| **Client Directives** | Leading `"use client";` on entrypoints | Present in `dist/index.mjs` and `dist/index.js` | **PASS** |
|
|
19
|
+
| **CSS Injection** | Self-contained automatic injection | `styleInject` with `.arap-root` present in bundles | **PASS** |
|
|
20
|
+
| **CSS Isolation** | Zero global element resets | No un-scoped resets on `html`, `body`, `:root`, or `*` | **PASS** |
|
|
21
|
+
| **Legal Files** | Permissive license and attribution | `LICENSE` and `NOTICE` verified in tarball | **PASS** |
|
|
22
|
+
|
|
23
|
+
### Packed Files Breakdown
|
|
24
|
+
|
|
25
|
+
- `dist/index.mjs` (ESM build)
|
|
26
|
+
- `dist/index.js` (CommonJS build)
|
|
27
|
+
- `dist/index.d.mts` (ESM TypeScript declarations)
|
|
28
|
+
- `dist/index.d.ts` (CommonJS TypeScript declarations)
|
|
29
|
+
- `dist/style.css` (Standalone scoped stylesheet)
|
|
30
|
+
- `LICENSE` (ISC License)
|
|
31
|
+
- `NOTICE` (Attributions and asset origins)
|
|
32
|
+
- `docs/*` (Comprehensive documentation files)
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 2. Clean consumer smoke tests (`npm run test:consumers`)
|
|
37
|
+
|
|
38
|
+
The exact archive (`.consumers/package.tgz`) was installed in isolated consumer testbeds across supported framework versions:
|
|
39
|
+
|
|
40
|
+
### React 18 Consumer (`.consumers/react18`)
|
|
41
|
+
|
|
42
|
+
- **Environment**: React 18.3.1, React DOM 18.3.1, Vite 7.3.7.
|
|
43
|
+
- **Verification**:
|
|
44
|
+
- NodeNext ESM import and SSR hydration: **PASS**
|
|
45
|
+
- CommonJS `require()` resolution: **PASS**
|
|
46
|
+
- Production Vite rollup build: **PASS** (`dist/assets/index-RXyyFYxY.js` 487.73 KB raw / 130.42 KB gzip).
|
|
47
|
+
|
|
48
|
+
### React 19 Consumer (`.consumers/react19`)
|
|
49
|
+
|
|
50
|
+
- **Environment**: React 19.2.0, React DOM 19.2.0, Tailwind CSS 3.4.19, Vite 7.3.7.
|
|
51
|
+
- **Verification**:
|
|
52
|
+
- NodeNext ESM import and SSR hydration: **PASS**
|
|
53
|
+
- CommonJS `require()` resolution: **PASS**
|
|
54
|
+
- Production Vite rollup build: **PASS** (`dist/assets/index-CqZjbLpD.js` 538.30 KB raw / 144.98 KB gzip).
|
|
55
|
+
- Tailwind CSS co-existence: Scoped `.arap-*` classes operate without interference from host Tailwind utilities.
|
|
56
|
+
|
|
57
|
+
### Next.js 16 Consumer (`.consumers/next`)
|
|
58
|
+
|
|
59
|
+
- **Environment**: Next.js 16.2.10 (Webpack), React 19.2.0.
|
|
60
|
+
- **Verification**:
|
|
61
|
+
- Server Component layouts: **PASS**
|
|
62
|
+
- `"use client";` boundary isolation: **PASS**
|
|
63
|
+
- App Router routes (`/`, `/boundary`, `/route-test`): **PASS**
|
|
64
|
+
- Pages Router route (`/legacy`): **PASS**
|
|
65
|
+
- Production Next.js build (`next build --webpack`): **PASS** with 7 static routes prerendered.
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 3. Disposable lock hygiene
|
|
70
|
+
|
|
71
|
+
- All consumer installations reside inside the disposable `.consumers/` directory, which is excluded by `.gitignore`.
|
|
72
|
+
- Zero disposable lockfiles, temporary tarballs, or generated testbed files are tracked in version control.
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# Milestone 5 Release Proposal & Semantic Version Recommendation
|
|
2
|
+
|
|
3
|
+
**Date:** 2026-10-28
|
|
4
|
+
**Scope:** Milestone 5 — Launch readiness and package hardening (Issues #66, #67, #68, #69, #70, #71)
|
|
5
|
+
**Parent Trackers:** [Issue #27](https://github.com/prabothcharith/accessibility-plugin-react/issues/27), [Issue #15](https://github.com/prabothcharith/accessibility-plugin-react/issues/15), [Issue #21](https://github.com/prabothcharith/accessibility-plugin-react/issues/21)
|
|
6
|
+
**Current Registry State:** `accessibility-plugin-react@2.28.0` on npm under tag `latest`
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 1. Executive Summary
|
|
11
|
+
|
|
12
|
+
Milestone 5 focused on comprehensive package hardening, multi-browser and device matrix verification, runtime profiling, security and dependency auditing, documentation synchronization, and clean consumer publish rehearsals.
|
|
13
|
+
|
|
14
|
+
All six Milestone 5 sub-issues have completed all functional, programmatic, and integration requirements:
|
|
15
|
+
|
|
16
|
+
- **A11Y-501 (Issue #66):** Full supported-browser, device, and assistive-technology matrix (`docs/SUPPORTED_MATRIX.md`).
|
|
17
|
+
- **A11Y-502 (Issue #67):** Performance, bundle, listener, and leak profiling (`docs/PERFORMANCE_PROFILING.md`).
|
|
18
|
+
- **A11Y-503 (Issue #68):** Documentation website, API reference, and interactive examples (`CONTRIBUTING.md`, `docs/API.md`, `docs/FEATURES.md`, examples).
|
|
19
|
+
- **A11Y-504 (Issue #69):** Dependency, license, CSP, and security audit (`NOTICE`, `docs/SECURITY_AUDIT.md`, `tests/securityAudit.test.ts`).
|
|
20
|
+
- **A11Y-505 (Issue #70):** Packed publish rehearsal and clean consumer smoke testing (`docs/PUBLISH_REHEARSAL.md`).
|
|
21
|
+
- **A11Y-506 (Issue #71):** Version recommendation, changelog, and owner-approved release proposal (this document).
|
|
22
|
+
|
|
23
|
+
This document reviews the complete verification evidence, evaluates semantic versioning options, reconciles legacy release trackers, and provides an owner decision checklist. In accordance with repository governance rules, **no publish, tag, or default-branch merge is performed without explicit owner authorization**.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 2. Milestone 5 Verification Evidence
|
|
28
|
+
|
|
29
|
+
| Issue | Area | Verification Artifacts | Status | Results & Key Metrics |
|
|
30
|
+
| ------------------ | ------------------------ | ------------------------------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
31
|
+
| **#66 (A11Y-501)** | Supported Matrix & AT | `docs/SUPPORTED_MATRIX.md`<br>`tests/browser/widget.spec.ts` | **PASS** | • Verified Chromium, Firefox, WebKit, Mobile WebKit, Android emulation.<br>• 400% zoom reflow at 320px CSS viewport width verified without clipping.<br>• Forced-colors protection (`forced-colors: active`) verified.<br>• $\ge 44\text{px} \times 44\text{px}$ touch targets verified across all controls.<br>• Zero universal WCAG claims; automated tests establish semantics, human testing mandatory. |
|
|
32
|
+
| **#67 (A11Y-502)** | Performance & Leaks | `docs/PERFORMANCE_PROFILING.md`<br>`tests/performanceProfiling.test.tsx` | **PASS** | • Distribution bundle: ESM `index.mjs` 603 KB raw / 111 KB gzip; CSS 71 KB raw / 11 KB gzip.<br>• React 18 consumer application bundle: 130 KB gzip.<br>• Closed idle runtime: 0 unthrottled pointer listeners, 0 RAF loops, 0 timers.<br>• 1,000-node DOM scaling: multi-feature application & reset under heavy parallel CPU.<br>• 100 mount/unmount & toggle cycles: 0 leaked DOM nodes, 0 leaked styles, 0 memory drift. |
|
|
33
|
+
| **#68 (A11Y-503)** | Documentation & Examples | `CONTRIBUTING.md`<br>`docs/API.md`<br>`docs/FEATURES.md`<br>`examples/*` | **PASS** | • Added `CONTRIBUTING.md` with PR guidelines, coding conventions, and a11y bounds.<br>• Synchronized `docs/API.md` with complete components table and exported types.<br>• Synchronized `docs/FEATURES.md` with Smart Contrast prototype documentation.<br>• Updated `examples/basic-usage` and `examples/next-app` with all prebuilt controllers. |
|
|
34
|
+
| **#69 (A11Y-504)** | Security & Licenses | `NOTICE`<br>`docs/SECURITY_AUDIT.md`<br>`tests/securityAudit.test.ts` | **PASS** | • 0 runtime dependencies (`dependencies: {}`); 0 `npm audit` vulnerabilities.<br>• Added `NOTICE` attributing ISC license, historical origins, and assets.<br>• Strict CSP compliance: 0 dynamic `eval`, 0 `Function()`, 0 inline script injections.<br>• Strict privacy: 0 network telemetry, 0 analytics, 0 audio/transcript transmission.<br>• Sensitive data protection: automatic credential/password exclusion (`isSensitiveElement`). |
|
|
35
|
+
| **#70 (A11Y-505)** | Publish Rehearsal | `docs/PUBLISH_REHEARSAL.md`<br>`scripts/check-package.mjs` | **PASS** | • Exact tarball `.consumers/package.tgz`: 61 files, 1.18 MB unpacked; includes `NOTICE`.<br>• Clean consumer installations passed in React 18.3.1, React 19.2.0, and Next.js 16.0.0.<br>• Zero SSR hydration mismatches; clean production builds generated across all consumers. |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 3. Semantic Versioning Analysis & Recommendation
|
|
40
|
+
|
|
41
|
+
### Contract & Scope Evaluation
|
|
42
|
+
|
|
43
|
+
1. **Backwards Compatibility:**
|
|
44
|
+
- All public contracts established in version 2.0.0 remain 100% backwards-compatible.
|
|
45
|
+
- Zero deprecated APIs were removed; zero existing prop types, function signatures, or CSS custom properties were altered in breaking ways.
|
|
46
|
+
- Therefore, a major version bump (`3.0.0`) is **not warranted**.
|
|
47
|
+
|
|
48
|
+
2. **Milestone 5 Additions:**
|
|
49
|
+
- Milestone 5 added legal packaging (`NOTICE` bundled into the npm archive), extensive documentation (`docs/SUPPORTED_MATRIX.md`, `docs/PERFORMANCE_PROFILING.md`, `docs/SECURITY_AUDIT.md`, `docs/PUBLISH_REHEARSAL.md`, `CONTRIBUTING.md`), new regression and profiling test suites (`tests/performanceProfiling.test.tsx`, `tests/securityAudit.test.ts`), and package verification scripts (`scripts/check-package.mjs`).
|
|
50
|
+
- The underlying library runtime code remains identical to the stabilized v2.28.0 release.
|
|
51
|
+
|
|
52
|
+
### Version Recommendation
|
|
53
|
+
|
|
54
|
+
We present two valid options for the owner's authorization:
|
|
55
|
+
|
|
56
|
+
- **Option A (Recommended): Version `2.29.0` (Minor Release)**
|
|
57
|
+
- _Rationale:_ SemVer convention often treats milestone completion and legal attribution additions (`NOTICE` in tarball files) as a minor increment signifying a hardened, launch-ready milestone milestone release. It clearly demarcates the pre-hardening releases (2.28.0 and earlier) from the fully profiled, audited, and matrix-verified release.
|
|
58
|
+
- _Publish target:_ npm tag `latest`.
|
|
59
|
+
|
|
60
|
+
- **Option B: Version `2.28.1` (Patch Release)**
|
|
61
|
+
- _Rationale:_ If the owner strictly interprets SemVer to require new public runtime API functions for a minor bump. Because M5 primarily added packaging metadata (`NOTICE`), documentation, and automated test suites without introducing new end-user React components or hooks beyond those already present in 2.28.0, `2.28.1` accurately reflects a hardening patch.
|
|
62
|
+
- _Publish target:_ npm tag `latest`.
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 4. Reconciliation of Legacy Release Trackers
|
|
67
|
+
|
|
68
|
+
### Issue #15 ("First stable release: acceptance and publication tracker")
|
|
69
|
+
|
|
70
|
+
Issue #15 was created early in the repository lifecycle to track the initial stable release sequence. Its child issues are reconciled as follows:
|
|
71
|
+
|
|
72
|
+
1. **Issue #4 (Licensing conflict):** Closed. Owner confirmed ISC for all code; `LICENSE` and `NOTICE` are verified.
|
|
73
|
+
2. **Issue #5 (Package identity):** Closed. Owner selected `accessibility-plugin-react`; published under `latest`.
|
|
74
|
+
3. **Issue #6 (Screen-reader accessibility acceptance):**
|
|
75
|
+
- _Status:_ Programmatic accessibility semantics verified via automated axe-core audits and Playwright tests in `tests/browser/widget.spec.ts`.
|
|
76
|
+
- _Documentation:_ `docs/DEVELOPMENT.md` and `docs/SUPPORTED_MATRIX.md` document detailed manual VoiceOver, NVDA, and TalkBack protocols.
|
|
77
|
+
- _Policy:_ Automated tests do not certify WCAG compliance; continuous human assistive technology testing remains an active operational discipline.
|
|
78
|
+
4. **Issue #7 (Physical devices, actual zoom, visual accessibility):**
|
|
79
|
+
- _Status:_ Verified in automated browser matrix (Mobile WebKit emulation, 320px reflow, 400% zoom reflow, forced-colors mode).
|
|
80
|
+
- _Documentation:_ Manual physical device touch testing protocol documented in `docs/DEVELOPMENT.md`.
|
|
81
|
+
5. **Issue #8 (Representative host-application acceptance):**
|
|
82
|
+
- _Status:_ Verified via packed clean consumer test suite (`npm run test:consumers`) in React 18 (Vite), React 19 (Tailwind), and Next.js 16 (Webpack/App Router/SSR).
|
|
83
|
+
6. **Issue #9 (Documentation update):** Closed. All documentation synchronized.
|
|
84
|
+
7. **Issue #10 (Final release candidate validation):** Fulfilled by Issue #70 (A11Y-505) and `docs/PUBLISH_REHEARSAL.md`.
|
|
85
|
+
8. **Issue #11 (Publish approved package):** Automated via GitHub Actions npm OIDC trusted publishing in `.github/workflows/publish.yml`.
|
|
86
|
+
|
|
87
|
+
### Milestone 5 Tracker (Issue #27)
|
|
88
|
+
|
|
89
|
+
With the completion of Issue #71, all child issues of Milestone 5 (#66, #67, #68, #69, #70, #71) are complete. Issue #27 may now be closed upon owner approval of this proposal.
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## 5. Owner Decision Checklist
|
|
94
|
+
|
|
95
|
+
The repository owner authorized release on 2026-10-28:
|
|
96
|
+
|
|
97
|
+
- [x] **1. Release Version Choice:** Option B (`2.28.1` patch release) confirmed by owner.
|
|
98
|
+
- [x] **2. Default Branch Merge:** Authorized merge of release branch into `development` and synchronization into `main`.
|
|
99
|
+
- [x] **3. Publication Authorization:** Automated GitHub Actions npm trusted publishing (`publish.yml`) via OIDC and GitHub Packages (`publish-github-package.yml`) triggered upon merge to `main`.
|
|
100
|
+
- [x] **4. Git Release Tag:** Create matching `v2.28.1` Git tag and release upon verified npm registry upload.
|