Add documentation provider, inspections, and improve settings UI

[inxilpro]

Summary

This PR adds comprehensive documentation support for Alpine.js directives and magic properties, introduces an inspection for deprecated x-spread, refactors the settings UI to use modern IntelliJ DSL, and improves code quality with better type safety and caching.

Key Changes

Documentation & Help

• New AlpineDocumentationProvider: Provides detailed documentation for all Alpine.js directives (x-data, x-show, x-model, etc.) and magic properties ($refs, $store, $el, etc.) with examples and descriptions
• Supports both full documentation and quick navigate info for IDE tooltips
• Handles directive shorthand syntax (@click, :class) by mapping to base directives

Code Inspections

• New DeprecatedXSpreadInspection: Warns users about deprecated x-spread directive and suggests using x-bind with object syntax instead
• Includes comprehensive test coverage

Settings & Configuration

• Refactored AlpineSettingsConfigurable: Replaced custom AlpineSettingsComponent with modern IntelliJ UI DSL (panel builder)
• Cleaner, more maintainable settings UI with proper grouping
• Improved state management and modification tracking
• Added comprehensive settings tests

Code Quality Improvements

• New JsContext data class: Replaces Apache Commons MutablePair for better type safety and readability
• Caching optimization in AlpineTargetReferenceContributor: Uses CachedValuesManager with PsiModificationTracker for efficient ID map caching
• Improved logging: Added proper logger usage in AlpinePluginRegistry
• Better error handling: Enhanced detection logic with proper logging

Testing

• Added comprehensive test suites:
  • AlpineDocumentationProviderTest: Tests documentation generation for directives and shorthands
  • AlpineCompletionContributorTest: Tests completion suggestions for directives, modifiers, and shorthands
  • AlpineJavaScriptInjectionTest: Tests JavaScript injection into Alpine attributes
  • AlpineSettingsTest: Tests settings persistence and state management
  • PackageJsonDetectorTest: Tests plugin detection from package.json
  • ScriptReferenceDetectorTest: Tests plugin detection from script tags
  • DeprecatedXSpreadInspectionTest: Tests x-spread deprecation warnings

Test Data

• Added HTML and JSON test fixtures for completion, injection, and detection tests

Build & CI

• Updated Java version from 17 to 21 in GitHub Actions
• Changed plugin verification to use recommended() IDE versions instead of hardcoded version

Plugin System

• Made alpinePlugin extension point dynamic for better plugin lifecycle management

https://claude.ai/code/session_01V2fCJAQ7skygq5KtjRQFjW

[github-actions]

Qodana Community for JVM

1 new problem were found

Inspection name	Severity	Problems
Incorrect string capitalization	🔶 Warning	1

💡 Qodana analysis was run in the pull request mode: only the changed files were checked

View the detailed Qodana report

To be able to view the detailed Qodana report, you can either:

• Register at Qodana Cloud and configure the action
• Use GitHub Code Scanning with Qodana
• Host Qodana report at GitHub Pages
• Inspect and use qodana.sarif.json (see the Qodana SARIF format for details)

To get *.log files or any other Qodana artifacts, run the action with upload-result option set to true,
so that the action will upload the files as the job artifacts:

      - name: 'Qodana Scan'
        uses: JetBrains/qodana-action@v2025.1.1
        with:
          upload-result: true

Contact Qodana team

Contact us at qodana-support@jetbrains.com

• Or via our issue tracker: https://jb.gg/qodana-issue
• Or share your feedback: https://jb.gg/qodana-discussions