PhoenixmlDb.Xslt 2.2.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package PhoenixmlDb.Xslt --version 2.2.0
                    
NuGet\Install-Package PhoenixmlDb.Xslt -Version 2.2.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="PhoenixmlDb.Xslt" Version="2.2.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="PhoenixmlDb.Xslt" Version="2.2.0" />
                    
Directory.Packages.props
<PackageReference Include="PhoenixmlDb.Xslt" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add PhoenixmlDb.Xslt --version 2.2.0
                    
#r "nuget: PhoenixmlDb.Xslt, 2.2.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package PhoenixmlDb.Xslt@2.2.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=PhoenixmlDb.Xslt&version=2.2.0
                    
Install as a Cake Addin
#tool nuget:?package=PhoenixmlDb.Xslt&version=2.2.0
                    
Install as a Cake Tool

PhoenixmlDb.Xslt

XSLT 4.0 transformation engine for PhoenixmlDb — transform XML documents into HTML, JSON, CSV, text, or other XML formats.

Features

  • XSLT 3.0/4.0 — template matching, streaming, accumulators, packages, maps/arrays
  • All output methods — HTML5, XML, XHTML, JSON, text, CSV, adaptive
  • Multiple outputs — xsl:result-document for multi-file generation
  • Full XPath 4.0 — 240+ built-in functions available in all expressions
  • Packages — reusable stylesheet libraries with visibility control

Quick example

using PhoenixmlDb.Xslt;

var transformer = new XsltTransformer();
await transformer.LoadStylesheetAsync(
    File.ReadAllText("style.xsl"),
    new Uri(Path.GetFullPath("style.xsl")));

transformer.SetParameter("title", "My Report");
var html = await transformer.TransformAsync(
    File.ReadAllText("data.xml"));

// Handle secondary outputs (xsl:result-document)
foreach (var (href, content) in transformer.SecondaryResultDocuments)
    File.WriteAllText(Path.Combine(outputDir, href), content);

See the full API overview in the README.

Package Description
PhoenixmlDb.Core Core types and XDM data model (dependency)
PhoenixmlDb.XQuery XQuery 4.0 query engine (dependency)
PhoenixmlDb.Xslt.Cli xslt command-line tool

Documentation

Full documentation at phoenixml.dev

License

Apache 2.0

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.5.1 36 10/1/2026
2.4.1 325 9/28/2026
2.4.0 95 9/28/2026
2.2.0 116 9/25/2026
2.1.0 181 9/17/2026
2.0.0 166 9/15/2026
1.8.0 234 9/14/2026
1.7.0 126 9/11/2026
1.6.15 193 9/9/2026
1.6.14 134 9/7/2026
1.6.13 168 9/2/2026
1.6.12 128 8/30/2026
1.6.11 116 8/29/2026
1.6.10 181 8/27/2026
1.6.9 108 8/26/2026
1.6.8 109 8/26/2026
1.6.7 111 8/24/2026
1.6.6 118 8/23/2026
1.6.5 137 8/22/2026
1.6.4 137 8/16/2026
Loading failed

Takes **PhoenixmlDb.XQuery 2.2.0** and **PhoenixmlDb.Core 2.0.0**.

XQuery moves with this release and the order matters: that package carries `xs:IDREFS`,
`xs:NMTOKENS` and `xs:ENTITIES` as cast targets (+63 QT3 cases). Had this shipped against the
2.1.0 pin, none of those would have reached anyone installing `PhoenixmlDb.Xslt`.

### Fixed

- **`xsl:expose` selected nothing, silently.** Component names, the value space and the missing
 token forms (#162). **+13 W3C cases.**
- **Three error sites named a neighbouring code** (#155). **+12 W3C cases.**
- **A streamed `group-adjacent` key that returns elements is now rejected** as `XTSE3430`, and a
 streamed `group-adjacent` with an empty key reports `XTTE1100` like its buffered twin rather
 than a misleading `XTDE1071` (#168, #152). Both halves of Martin Honnen's #147.
- **`xsl:sort` and `xsl:key` did not set temporary output state**, so `xsl:result-document`
 inside a sort key ran instead of raising `XTDE1480` (#158).
- **The runner never set a base output URI**, so every `current-output-uri()` case saw `()` (#159).
- **`regex-group()` returned the empty sequence inside a pattern** (#154).
- **A text node returned by `xsl:function` was not a real node** — axis steps raised `XPTY0020`
 naming an internal type (#151).
- **Static declarations now come into scope in declaration order** (#167).
- **The streaming scanner descends into `xsl:map` and `xsl:map-entry`** (#128).
- **`xsl:use-package` whitespace declarations have a relative import precedence** (#145).

### Performance

**A match pattern carrying any predicate was O(n²) in sibling count** (#169). The predicate's
content was irrelevant — `w:p[@zzz]` cost the same as one walking every descendant twice, because
the cost was establishing `position()`/`last()` context for a predicate that cannot observe it.
Measured on the issue's own repro: **12.6× faster at n=4000**, and a predicate now costs 3% over
having none rather than 250%.

### Conformance

**W3C XSLT 3.0: 10,384 / 10,839 (95.80%)**, up 37 passes from 2.1.0's 10,347.

The denominator is unchanged, so this is the engine doing more rather than cases leaving the
count. Measured on this commit against the **published** `PhoenixmlDb.XQuery 2.2.0` package — not
sibling source — so it describes the artifact being released.

### Known limitations

- A streamed `xsl:message` loses items produced by `xsl:for-each` in its content (#148). The
 obvious fix makes it worse: the message loses its constants too.
- Three streaming sets remain below their 1.6.10 scores (#96). Not a regression — those cases
 passed by not streaming at all until `streamable="true"` began actually streaming.

> **Correction (2026-09-04).** Every W3C XSLT conformance figure recorded in this file before
> this date is overstated. Tests expecting a specific error code were scored as passes whenever
> the transform threw anything at all, because both conformance runners read the expected code
> from element text when the corpus writes it as an attribute. Re-measured against the same
> corpus, the figure **on that date** was **10,020/10,630 (94.3%)**. The historical entries below
> are left as written — they record what was believed at the time. See BUGS.md entry 28.
>
> That 94.3% is itself now historical; do not quote it as current. The live figure is in
> `README.md` and in the generated `STATUS.md`, each carrying its own measurement date.