PhoenixmlDb.Xslt 1.6.5

There is a newer version of this package available.
See the version list below for details.
dotnet add package PhoenixmlDb.Xslt --version 1.6.5
                    
NuGet\Install-Package PhoenixmlDb.Xslt -Version 1.6.5
                    
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="1.6.5" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="PhoenixmlDb.Xslt" Version="1.6.5" />
                    
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 1.6.5
                    
#r "nuget: PhoenixmlDb.Xslt, 1.6.5"
                    
#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@1.6.5
                    
#: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=1.6.5
                    
Install as a Cake Addin
#tool nuget:?package=PhoenixmlDb.Xslt&version=1.6.5
                    
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 outputsxsl: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
1.6.8 0 8/26/2026
1.6.7 47 8/24/2026
1.6.6 55 8/23/2026
1.6.5 80 8/22/2026
1.6.4 117 8/16/2026
1.6.3 88 8/14/2026
1.6.2 86 8/13/2026
1.6.1 106 8/4/2026
1.6.0 108 7/31/2026
1.5.0 127 7/27/2026
1.4.25 106 7/17/2026
1.4.24 88 7/14/2026
1.4.23 131 7/12/2026
1.4.22 107 7/10/2026
1.4.21 111 7/9/2026
1.4.20 103 7/9/2026
1.4.19 100 7/9/2026
1.4.18 101 7/8/2026
1.4.17 104 7/7/2026
1.4.16 130 6/30/2026
Loading failed

Seven engine fixes, all found by running real stylesheets rather than the test suites. The
largest of them unblocked 60 of the 162 XSpec suites, which had been failing before they could
execute a single test.

### Fixes

- **`xsl:copy` carries the source element's complete IN-SCOPE namespaces, not only the `xmlns`
 declarations written on it.** XSLT 3.0 §11.9.1 requires a namespace node on the copy for every
 namespace node of the original. Emitting only the local declarations is usually
 indistinguishable, because the copy lands in a tree whose ancestors re-supply the rest — but
 not when nothing re-supplies them. Under `inherit-namespaces="no"`, or for a detached copy, the
 copy kept only the prefix of its own name, and a later `resolve-QName` against it failed with
 `FONS0004` for a prefix the source plainly had. XSpec's compiler is exactly this shape:
 `x:combine` wraps the combined document in `<xsl:element inherit-namespaces="no">` and the
 compiler then copies scenarios out of that tree and resolves `@function` / `@template` / `@as`
 against the copies. Measured across the XSpec suites: suites stuck at Compile 99 → 42, reaching
 Run 39 → 84, running to Completion 24 → 36, with 58 suites advancing a stage and none
 regressing.

- **`xsl:result-document` targeting the principal output returns the empty sequence.** Its content
 is a result document and never contributes to the containing sequence constructor (§26.1). One
 with an `href` was already redirected correctly; one targeting the principal output wrote into
 the same buffer an `as=`-typed body slices for its return value, so its content was counted as
 the template's result. A template declared `as="empty-sequence()"` around a bare
 `xsl:result-document` — the shape XSpec generates for its report — raised `XTTE0505: expected
 zero items, got 1`.

- **`xsl:result-document` content contributes no accumulated items either.** The companion to the
 above: the content ran with the enclosing sequence accumulator still installed, so an
 `xsl:sequence` *inside* a result document could still leak an item into an enclosing typed body.

- **The collected-attribute stack is restored bottom-first.** Four seams saved the stack to a
 `List`, cleared it, and pushed the list back — but `Stack<T>` enumerates top-first, so the
 restore reversed it. Harmless at nesting depth 1, which is why it survived; at depth ≥ 2 the
 enclosing element sealed against its parent's buffer, losing every attribute created by the
 `xsl:attribute` instruction while the parent silently gained them, and every element built
 afterwards was shifted by one. Literal and AVT attributes never enter that stack, so ordinary
 stylesheets were unaffected and only code generators — which must compute attribute names and
 values — fell in. It accounted for `XTSE0010` in 62 XSpec suites: a generated
 `<xsl:stylesheet>` with no `@version`, `Q{uri}` names with an empty local part, and valueless
 `xsl:attribute` elements were one defect wearing three masks.

- **`fn:transform`'s `initial-template` option is an `xs:QName`, not a local name.** It was read
 as a string, discarding the namespace, so a namespaced entry point could not be selected. The
 adjacent `initial-function` option already handled this correctly.

- **An `xsl:function` with no `as=` returns text NODES for text its body produces.** The typed
 form already did; the untyped form handed back a plain string, so `boolean()` over a sequence
 of such results raised `FORG0006`.

- **`for-each-group` with `group-by` over a grounded population is streamable.** The classifier
 reported every `group-by` as not-streamable, which forced whole-input buffering even where the
 population is already materialised. A correctness fix in the classifier; runtime behaviour is
 unchanged.

### Version alignment

From 1.6.5 the engine libraries and the CLI tools built on them share a single version, so a
matching number means a compatible set. See `PhoenixmlDb.Core` 1.6.5 for the rationale.