PhoenixmlDb.Xslt 2.6.0

dotnet add package PhoenixmlDb.Xslt --version 2.6.0
                    
NuGet\Install-Package PhoenixmlDb.Xslt -Version 2.6.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.6.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="PhoenixmlDb.Xslt" Version="2.6.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.6.0
                    
#r "nuget: PhoenixmlDb.Xslt, 2.6.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.6.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.6.0
                    
Install as a Cake Addin
#tool nuget:?package=PhoenixmlDb.Xslt&version=2.6.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.6.0 52 10/6/2026
2.5.1 157 10/1/2026
2.4.1 341 9/28/2026
2.4.0 108 9/28/2026
2.2.0 125 9/25/2026
2.1.0 190 9/17/2026
2.0.0 174 9/15/2026
1.8.0 239 9/14/2026
1.7.0 131 9/11/2026
1.6.15 200 9/9/2026
1.6.14 142 9/7/2026
1.6.13 171 9/2/2026
1.6.12 131 8/30/2026
1.6.11 119 8/29/2026
1.6.10 184 8/27/2026
1.6.9 110 8/26/2026
1.6.8 110 8/26/2026
1.6.7 114 8/24/2026
1.6.6 119 8/23/2026
1.6.5 141 8/22/2026
Loading failed

Takes **PhoenixmlDb.XQuery 2.6.0**. Streaming correctness, browser WebAssembly support, a faster
apply-templates path, and the tail of the W3C conformance backlog.

### Changed behaviour to check on upgrade

- **Streaming no longer loses or mis-answers data.** Three defects in streamable modes, all
 reported by Martin Honnen, produced wrong output with no error:
 - A template rule reading its matched element's children as a value lost them:
   `<a>{foo}</a>` came out `<a/>`, and `<xsl:copy><xsl:value-of select="foo"/></xsl:copy>` produced
   malformed output (#295).
 - A rule reading OUTSIDE its matched element answered wrongly: `count(preceding-sibling::*)`
   was `0`, `last()` was `1` (#298). Such a rule is not streamable. The stylesheet is now
   evaluated against an in-memory tree instead, which gives the right answer at the tree's
   memory cost. The spec's `XTSE3430` for these stylesheets is not implemented yet.
 - A subtree the streaming pass buffered lost its whitespace-only text nodes, so `snapshot()`
   and `copy-of(.)` dropped indentation the unstreamed stylesheet kept (#301).
 A stylesheet that depended on any of these outputs changes. Streamed and unstreamed
 evaluation now agree on all three.
- **`fn:format-number` rounds half to even** (`format-number(2.5, '0')` is `2`), and **a non-node
 on the left of `/` is `XPTY0019`**, not `XPTY0020`. Both come from PhoenixmlDb.XQuery 2.6.0.
- **`exclude-result-prefixes` excludes namespace URIs, not prefix names** (XSLT 3.0 §11.1.3), and
 copies in a temporary tree inherit the namespaces of the element they are copied into. XSpec's
 compiled stylesheets no longer carry a stray `xsl:namespace` for the default namespace.
- **`xsl:mode` declarations combine across modules as §6.6.1 says**: conflicting attributes at
 the same import precedence are `XTSE0545`.
- **`key()` compares with `eq`**: an untyped key value never equals a number.

### Added

- **`XsltTransformer.DisableStreaming`** evaluates against a tree even when the initial mode is
 streamable. The CLI's `--no-stream` sets it; that flag had no effect before.
- **`AllowedOutputMethods`** restricts which serialization methods a transformation may deliver,
 and **`OutputDeclarations`** lists the stylesheet's `xsl:output` declarations.
- **`XsltTransformer.XQueryModules`**: modules for `fn:load-xquery-module` without location hints.
- **`xsl:mode warning-on-multiple-match="yes"`** reports equal-rank template conflicts.

### Browser WebAssembly

- A transformation runs inline where no thread can be started; 2.5.1 threw
 `PlatformNotSupportedException` for every transform in Blazor WebAssembly (#237).
- Deep recursion yields to unwind the stack instead of failing, at a fixed nesting interval and
 with headroom before the stack check.
- `XsltTransformer` no longer holds the calling thread during a transform or a stylesheet load.

### Performance

Applying a compiled Schematron validator is 2.6 to 3 times faster than 2.5.1, with identical
SVRL: `xsl:apply-templates` allocates far less per call, XPath plans evaluate synchronously where
the operator tree allows, and the built-in text-only-copy rule recurses directly.

### Fixed

- **Namespaces.** `inherit-namespaces="no"` keeps the parent's default namespace off prefixed
 children; `xsl:copy-of` keeps a parentless namespace node a namespace node; `xsl:key
 use="@xml:id"` finds `xml:id` attributes (DocBook xslTNG links).
- **Variables and params.** Typed template-param defaults, whitespace stripping and `expand-text`
 in variable bodies; `xml:space="preserve"` keeps whitespace after a template's params.
- **`xsl:evaluate`** refuses private stylesheet functions and XSLT-only functions (`XTDE3160`); a
 policy that disables it is "dynamically disabled" (§27.6).
- **Streaming.** `xsl:value-of` in a streamed `xsl:source-document` gives the unstreamed result;
 streamed children dispatched by `apply-templates` have their parent; `accumulator-after()` before
 a consuming instruction is `XTSE3430`.
- **Serialization.** HTML indentation no longer deepens after every void element; `indent="yes"`
 writes LF on every operating system; a typed template's text result keeps its characters.
- **Error codes.** An unresolvable `xsl:use-package` is `XTSE3000`; a declaration homonymous with
 an `xsl:override` child is `XTSE3055`; `xsl:number` with a fixed invalid `lang` is `XTSE0020`;
 `document()` with a fragment that is not a shorthand pointer is `XTDE1160`.
- `json-to-xml` replaces or escapes characters XML cannot hold; an empty declared default
 collection is the empty sequence; a `regex-group` function item returns `""`.

### Conformance

W3C XSLT 3.0: **216 failing at 2.5.1 → 131 at 2.6.0** (98.8% of 10,839). The harness changed too,
in ways that affect the count: it now compares HTML-method output as the result tree it
serializes, parses a multi-rooted result document as a fragment, binds the catalog's namespace
prefixes for XPath assertions, treats an environment `ref` as a reference, and declares the
processor as XSD 1.1.

The real-world gate against 2.5.1 (XSpec, DocBook xslTNG, Martin Honnen's reports and workbench,
120 cases) shows no regressions: 21 cases 2.5.1 failed now pass, and 19 outputs differ, each
checked as an improvement.