Raxol.Core.Accessibility.AccessibilityServer (Raxol v2.0.1)

Unified GenServer implementation for accessibility features in Raxol.

This server consolidates all accessibility state management, eliminating Process dictionary usage across Accessibility, Announcements, and Metadata modules.

Features

Screen reader announcements with queuing and priority
High contrast mode management
Reduced motion support
Large text support
Keyboard focus indicators
Accessibility metadata tracking
User preference integration
Theme integration for accessibility
Announcement history tracking

State Structure

The server maintains state with the following structure:

%{
  enabled: boolean(),
  preferences: %{
    screen_reader: boolean(),
    high_contrast: boolean(),
    reduced_motion: boolean(),
    large_text: boolean(),
    keyboard_focus: boolean(),
    silence_announcements: boolean()
  },
  announcements: %{
    queue: [announcement],
    history: [announcement],
    max_history: 100
  },
  metadata: %{component_id => metadata},
  theme_settings: map(),
  user_preferences_pid: pid() | nil,
  announcement_callback: function() | nil
}

Summary

Functions

add_announcement(announcement, user_preferences_pid_or_name \\ nil)

Adds an announcement to the queue.

add_announcement(server, announcement, user_preferences_pid_or_name)

announce(server \\ __MODULE__, message, opts \\ [])

Makes an announcement for screen readers.

announce_sync(server \\ __MODULE__, message, opts \\ [])

Announces with synchronous confirmation.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

clear_all_announcements()

Clears all announcements from the queue.

clear_all_announcements(server)

clear_announcement_history(server \\ __MODULE__)

Clears announcement history.

clear_announcements(user_preferences_pid_or_name)

Clears announcements for a specific user.

clear_announcements(server, user_preferences_pid_or_name)

disable(server \\ __MODULE__)

Disables accessibility features.

enable(server \\ __MODULE__, options \\ [], user_preferences_pid \\ nil)

Enables accessibility features with the given options.

enabled?(server \\ __MODULE__)

Checks if accessibility is enabled.

get_announcement_history(server \\ __MODULE__, limit \\ nil)

Gets announcement history.

get_component_hint(component_id, hint_level \\ :normal)

Gets a component hint.

get_component_hint(server, component_id, hint_level)

get_component_style(component_type)

Gets component style.

get_component_style(server, component_type)

get_element_metadata(element_id)

Gets element metadata for a component.

get_element_metadata(server, element_id)

get_focus_history()

Gets focus history.

get_focus_history(server)

get_metadata(server \\ __MODULE__, component_id)

Gets accessibility metadata for a component.

get_next_announcement(user_preferences_pid_or_name \\ nil)

Gets the next announcement from the queue.

get_next_announcement(server, user_preferences_pid_or_name)

get_option(key, default \\ nil)

Gets an option value.

get_option(server, key, default)

get_preferences(server \\ __MODULE__)

Gets all current preferences.

get_state(server \\ __MODULE__)

Gets the current state (for debugging/testing).

handle_focus_change(server \\ __MODULE__, old_focus, new_focus)

Handles focus change events.

handle_focus_change_event(unexpected_arg)

handle_focus_change_event(event_type, event_data)

handle_focus_change_event(event_name, measurements, metadata, config)

handle_preference_changed_event(arg)

handle_theme_changed_event(arg)

high_contrast?(server \\ __MODULE__)

Gets high contrast mode status.

large_text?(server \\ __MODULE__)

Gets large text mode status.

reduced_motion?(server \\ __MODULE__)

Gets reduced motion mode status.

register_component_style(component_type, style)

Registers component style.

register_component_style(server, component_type, style)

register_element_metadata(element_id, metadata)

Registers element metadata for a component.

register_element_metadata(server, element_id, metadata)

remove_metadata(server \\ __MODULE__, component_id)

Removes metadata for a component.

screen_reader?(server \\ __MODULE__)

Gets screen reader support status.

set_announcement_callback(server \\ __MODULE__, callback)

Sets the announcement callback function.

set_high_contrast(server \\ __MODULE__, enabled)

Sets high contrast mode.

set_keyboard_focus(server \\ __MODULE__, enabled)

Sets keyboard focus indicators.

set_large_text(server \\ __MODULE__, enabled)

Sets large text mode.

set_large_text_with_prefs(server \\ __MODULE__, enabled, user_preferences_pid)

set_metadata(server \\ __MODULE__, component_id, metadata)

Sets accessibility metadata for a component.

set_option(key, value)

Sets an option value.

set_option(server, key, value)

set_reduced_motion(server \\ __MODULE__, enabled)

Sets reduced motion mode.

set_screen_reader(server \\ __MODULE__, enabled)

Sets screen reader support.

should_announce?(user_preferences_pid_or_name \\ nil)

Checks if announcements should be made.

start_link(init_opts \\ [])

unregister_component_style(component_type)

Unregisters component style.

unregister_component_style(server, component_type)

unregister_element_metadata(element_id)

Unregisters element metadata.

unregister_element_metadata(server, element_id)