Configuration_Service.md

graph LR
    ConfigurationManager["ConfigurationManager"]
    XslLexer["XslLexer"]
    XPathLexer["XPathLexer"]
    SemanticProvider["SemanticProvider"]
    FormattingEngine["FormattingEngine"]
    TaskEngine["TaskEngine"]
    SymbolEngine["SymbolEngine"]
    DocumentCoordinator["DocumentCoordinator"]
    ExtensionActivator["ExtensionActivator"]
    Unclassified["Unclassified"]
    ConfigurationManager -- "provides language configuration to" --> XslLexer
    ConfigurationManager -- "provides configuration settings to" --> SemanticProvider
    ConfigurationManager -- "provides formatting options to" --> FormattingEngine
    ConfigurationManager -- "provides execution settings to" --> TaskEngine
    ConfigurationManager -- "provides snippet lists to" --> SymbolEngine
    ConfigurationManager -- "emits configuration change events to" --> DocumentCoordinator
    XslLexer -- "delegates embedded XPath parsing to" --> XPathLexer
    XslLexer -- "feeds token stream to" --> SemanticProvider
    XPathLexer -- "merges tokens into stream for" --> SemanticProvider
    SemanticProvider -- "uses formatting options for code‑action edits" --> FormattingEngine
    SemanticProvider -- "provides diagnostics for symbols" --> SymbolEngine
    TaskEngine -- "exposes task diagnostics to" --> SemanticProvider
    SymbolEngine -- "provides symbol resolution for" --> SemanticProvider
    DocumentCoordinator -- "triggers re‑analysis of" --> XslLexer
    DocumentCoordinator -- "triggers re‑analysis of" --> SemanticProvider
    DocumentCoordinator -- "triggers re‑analysis of" --> SymbolEngine
    ExtensionActivator -- "instantiates and registers" --> ConfigurationManager
    ExtensionActivator -- "instantiates and registers" --> XslLexer
    ExtensionActivator -- "instantiates and registers" --> XPathLexer
    ExtensionActivator -- "instantiates and registers" --> SemanticProvider
    ExtensionActivator -- "instantiates and registers" --> FormattingEngine
    ExtensionActivator -- "instantiates and registers" --> TaskEngine
    ExtensionActivator -- "instantiates and registers" --> SymbolEngine
    ExtensionActivator -- "instantiates and registers" --> DocumentCoordinator

Loading

Details

XSLT Extension Core – The heart of the VS Code XSLT extension is a tightly‑coupled set of eight components that together deliver a full language‑service experience. The ConfigurationManager supplies immutable language‑configuration objects for XSLT, XPath, XML, DCP and Schematron. The XslLexer (backed by the XPathLexer) tokenises source files and produces a unified token stream. This stream powers the SemanticProvider, which implements diagnostics, completions, hover, definition, reference and code‑action services, all of which respect the current configuration. Document formatting is handled by the FormattingEngine, while the TaskEngine creates Saxon‑based build tasks using the same configuration data. Navigation and outline features are provided by the SymbolEngine, which builds a hierarchical symbol tree from the lexer output. The DocumentCoordinator watches editor and configuration events and triggers re‑analysis of the lexer, semantic and symbol engines when needed. Finally, the ExtensionActivator bootstraps the subsystem, registers every provider with VS Code, and disposes resources on shutdown. This architecture isolates configuration, lexical analysis, language‑feature provision, formatting, task execution and change‑notification into clear, single‑responsibility components, enabling a concise flow diagram with at most two relationships per component pair.

ConfigurationManager

Holds immutable LanguageConfiguration objects for XSLT, XPath, XML, DCP, and Schematron, exposes them via static properties, and emits configuration‑changed events.

Related Classes/Methods:

• languageConfigurations.ConfigurationManager

XslLexer

Scans XSLT source, produces a stream of XslToken objects, detects embedded XPath expressions and delegates to XPathLexer, and supplies token‑level state for semantic colouring.

Related Classes/Methods:

• xslLexer.XslLexer

XPathLexer

Parses XPath fragments inside XSLT attribute values, emits Token objects compatible with the XSLT token stream, and is invoked by XslLexer for embedded expressions.

Related Classes/Methods:

• xpLexer.XPathLexer

SemanticProvider

Implements diagnostics, completions, hover, definition, reference and code‑action services using the token stream and configuration settings.

Related Classes/Methods:

• xsltTokenDiagnostics.XsltTokenDiagnostics
• xsltTokenCompletions.XsltTokenCompletions
• xsltHoverProvider.XsltHoverProvider
• xsltDefinitionProvider.XsltDefinitionProvider
• xsltReferenceProvider.XsltReferenceProvider
• xsltCodeActions.XsltCodeActions

FormattingEngine

Formats XSLT, XPath, XML, DCP and Schematron documents according to active LanguageConfiguration (indentation, line‑break rules, attribute ordering).

Related Classes/Methods:

• xmlDocumentFormattingProvider.XmlDocumentFormattingProvider

TaskEngine

Generates VS Code Task objects that invoke Saxon (Java) or Saxon‑JS based on configuration, registers the task provider, and surfaces execution‑related diagnostics.

Related Classes/Methods:

• saxonTaskProvider.SaxonTaskProvider
• saxonJsTaskProvider.SaxonJsTaskProvider

SymbolEngine

Walks the token stream to build a hierarchical DocumentSymbol tree for outline, go‑to‑symbol and UI commands, using snippet lists for root‑element suggestions.

Related Classes/Methods:

• xsltSymbolProvider.XsltSymbolProvider
• dcpSymbolProvider.DcpSymbolProvider

DocumentCoordinator

Listens to VS Code editor and configuration events, triggers refresh of lexer, semantic and symbol engines, and provides UI helpers for file‑selection dialogs.

Related Classes/Methods:

• documentChangeHandler.DocumentChangeHandler
• fileSelection.FileSelection

ExtensionActivator

Bootstraps the subsystem: instantiates all core components, registers them with VS Code, holds the extension context and disposes resources on shutdown.

Related Classes/Methods:

• extension.activate

Unclassified

Component for all unclassified files and utility functions (Utility functions/External Libraries/Dependencies)

Related Classes/Methods: None

FAQ