chore(react): improve components & error messages

[brionmario]

Purpose

This pull request introduces notable improvements to theme handling, error management, and sign-in option flexibility across the codebase. The changes add a new getActiveTheme utility for consistent theme resolution, update button styling and props for sign-in options, and enhance error handling and accessibility in several components. Additionally, exports are refined for better clarity and usage.

Theme Handling Improvements

• Added new getActiveTheme utility (packages/browser/src/theme/getActiveTheme.ts) to consistently determine the active theme mode based on user preference or system settings. This is now exported and used in both browser and Next.js packages for unified theme resolution. [1] [2] [3] [4]
• Introduced and exported DEFAULT_THEME constant for theme mode defaults; updated theme color values for dark mode to improve visual consistency. [1] [2] [3] [4]
• Refactored theme mode logic in AsgardeoProvider to use useMemo for determining dark mode, improving performance and reliability.

Sign-In Option Component Enhancements

• Refactored createSignInOption and related props to make authenticator and onSubmit optional, and improved prop passing for federated and local authenticators for greater flexibility and type safety. [1] [2] [3]
• Updated button styling and prop order for sign-in options (EmailOtp, IdentifierFirst, MultiOptionButton) to ensure consistent appearance and behavior. [1] [2] [3]
• Corrected import paths for social sign-in buttons to resolve from the appropriate directory, improving maintainability.

Error Handling and Accessibility

• Improved error reporting in SignInButton by stringifying error objects for clearer runtime messages.
• Enhanced accessibility in BaseOrganizationSwitcher by setting initialFocus={-1} in FloatingFocusManager.
• Added a catch block to handle promise rejections in AsgardeoSPAClient for better error propagation.

Export and API Surface Refinements

• Refined exports in packages/javascript/src/index.ts for clarity, switching from wildcard to named exports for key client and model types.
• Updated theme-related exports to include DEFAULT_THEME and improved type exports for better developer experience. [1] [2]

These updates collectively improve the consistency, reliability, and maintainability of theme management, sign-in flows, and error handling throughout the codebase.

Related Issues

• chore: stabilize @asgardeo/react & @asgardeo/nextjs #81

Related PRs

• N/A

Checklist

• e2e cypress tests locally verified.
• Manual test round performed and verified.
• UX/UI review done on the final implementation.
• Documentation provided. (Add links if there are any)
• Unit tests provided. (Add links if there are any)
• Integration tests provided. (Add links if there are any)

Security checks

• Followed secure coding standards in http://wso2.com/technical-reports/wso2-secure-engineering-guidelines?
• Ran FindSecurityBugs plugin and verified report?
• Confirmed that this PR doesn't commit any keys, passwords, tokens, usernames, or other secrets?