From 1fc0c61edf8f62553414a51eda4ef784f32adfd7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 19 May 2026 11:00:07 +0200
Subject: [PATCH 01/28] adds XSLT for generating a SEED config for media type
 transformations

This is related to #20.
---
 build.xml                                 |  11 +++
 distribution/seed/seed-config-chain.xsl   | 109 ++++++++++++++++++++++
 distribution/seed/seed-config-chain.xspec |  20 ++++
 distribution/seed/seed-config.xsl         |  67 ++++++++-----
 test/media-type/id.xsl                    |  11 +++
 test/media-type/saxon.xml                 |  14 +++
 6 files changed, 209 insertions(+), 23 deletions(-)
 create mode 100644 distribution/seed/seed-config-chain.xsl
 create mode 100644 distribution/seed/seed-config-chain.xspec
 create mode 100644 test/media-type/id.xsl
 create mode 100644 test/media-type/saxon.xml

diff --git a/build.xml b/build.xml
index fb98b13..3626b8e 100644
--- a/build.xml
+++ b/build.xml
@@ -27,6 +27,8 @@
         <antcall target="test-test-post-proc-call.xsl"/>
         <antcall target="test-xsl-uri-templates-query-parameters.xsl"/>
         <antcall target="test-xsl-uri-templates-path-parameters.xsl"/>
+        <!-- testing utils -->
+        <antcall target="test-distribution-seed-seed-config-chain.xsl"/>
     </target>
 
     <target name="test-xsl-dts.xsl">
@@ -77,4 +79,13 @@
         </antcall>
     </target>
 
+    <!-- tests for utils -->
+
+    <target name="test-distribution-seed-seed-config-chain.xsl">
+        <antcall target="xspec.xspec" inheritall="false">
+            <param name="xspec.xml" location="${basedir}/distribution/seed/seed-config-chain.xspec"
+            />
+        </antcall>
+    </target>
+
 </project>
diff --git a/distribution/seed/seed-config-chain.xsl b/distribution/seed/seed-config-chain.xsl
new file mode 100644
index 0000000..19b49cd
--- /dev/null
+++ b/distribution/seed/seed-config-chain.xsl
@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Generate a configuration file for the SEED XML Transformer
+
+The transformations given as the "transformation" parameter is
+resolved relative to the URI given in the transformation-saxon-config-uri. The
+saxon-config-uri is resolved relative to the stylesheet URI, aka
+as static-base-uri().
+
+The parameter upload-uri can be used to set a base URL for all
+relevant locations.
+
+USAGE EXAMPLES:
+
+target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl -s:xsl/projects/alea/prose-page saxon-config-uri=../../saxon.xml
+
+target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl -it saxon-config-uri=../../saxon.xml transformations=xsl/projects/alea/prose-page.xsl
+
+target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https://scdh.zivgitlabpages.uni-muenster.de/tei-processing/seed-tei-transformations/saxon.xml transformations=xsl/projects/alea/prose-page.xsl -it
+
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map"
+    xmlns:cfg="http://saxon.sf.net/ns/configuration" xmlns:seed="http://scdh.wwu.de/transform/seed#"
+    xpath-default-namespace="http://www.w3.org/1999/XSL/Transform" exclude-result-prefixes="#all"
+    version="3.0">
+
+    <xsl:output method="json" encoding="UTF-8" indent="true"/>
+
+    <xsl:param name="seed-config-xsl" as="xs:string" select="'seed-config.xsl'" static="true"/>
+
+    <xsl:import _href="{$seed-config-xsl}"/>
+
+    <xsl:param name="dts-root" as="xs:string" select="resolve-uri('../../', static-base-uri())"/>
+
+    <!-- document.xsl stylesheet -->
+    <xsl:param name="document-xsl" as="xs:string"
+        select="resolve-uri('xsl/document.xsl', $dts-root)"/>
+
+    <xsl:variable name="document-transformation" as="document-node()" select="doc($document-xsl)"/>
+
+    <!-- URI of the saxon configuration file of the DTS project -->
+    <xsl:param name="dts-saxon-config-uri" as="xs:string"
+        select="resolve-uri('saxon-local.xml', $dts-root)"/>
+
+    <!-- Relative links to packages in the saxon config are based on this.
+        Defaults to the base URI of the Saxon configuration's document node. -->
+    <xsl:variable name="dts-base-uri" as="xs:string" select="base-uri($dts-saxon-config)"/>
+
+    <xsl:variable name="dts-saxon-config" as="document-node()" select="doc($dts-saxon-config-uri)"/>
+
+    <xsl:variable name="chained-transformation" as="document-node()" select="."/>
+
+    <xsl:template name="xsl:initial-template">
+        <xsl:map>
+            <xsl:for-each select="$transformations">
+                <xsl:variable name="location" select="resolve-uri(., $base-uri)"/>
+                <xsl:variable name="stylesheet" as="document-node()" select="doc($location)"/>
+                <xsl:apply-templates select="$stylesheet" mode="transformation">
+                    <xsl:with-param name="transformation-id" tunnel="true"
+                        select="seed:get-transformation-id(., $stylesheet)"/>
+                    <xsl:with-param name="location" tunnel="true" select="."/>
+                </xsl:apply-templates>
+            </xsl:for-each>
+        </xsl:map>
+    </xsl:template>
+
+    <xsl:template match="document-node()">
+        <xsl:map>
+            <!-- start with document.xsl -->
+            <xsl:variable name="document-relative-path"
+                select="substring($document-xsl, string-length(resolve-uri('.', base-uri($dts-saxon-config))) + 1)"/>
+            <xsl:apply-templates mode="transformation" select="$document-transformation">
+                <xsl:with-param name="transformation-id"
+                    select="seed:get-transformation-id($document-relative-path, .)" tunnel="true"/>
+                <xsl:with-param name="location" select="$document-relative-path" tunnel="true"/>
+            </xsl:apply-templates>
+            <!-- on with chained transformation given as source -->
+            <xsl:variable name="transformation-relative-path"
+                select="substring(base-uri(), string-length(resolve-uri('.', $base-uri)) + 1)"/>
+            <xsl:apply-templates mode="libraries" select="."/>
+        </xsl:map>
+    </xsl:template>
+
+    <xsl:template name="seed:libraries" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'libraries'">
+            <xsl:variable name="libs" as="map(*)*">
+                <xsl:apply-templates mode="libraries" select="$stylesheet"/>
+                <xsl:apply-templates mode="libraries" select="$chained-transformation"/>
+            </xsl:variable>
+            <xsl:sequence select="array {$libs => reverse() => seed:distinct-maps-in-order(())}"/>
+        </xsl:map-entry>
+    </xsl:template>
+
+    <xsl:template name="seed:parameter-descriptors" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'parameterDescriptors'">
+            <xsl:variable name="params" as="map(*)*">
+                <xsl:apply-templates mode="stylesheet-params" select="$stylesheet"/>
+                <xsl:apply-templates mode="stylesheet-params" select="$chained-transformation"/>
+            </xsl:variable>
+            <xsl:sequence select="map:merge($params, $merge-options)"/>
+        </xsl:map-entry>
+    </xsl:template>
+
+
+
+</xsl:stylesheet>
diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
new file mode 100644
index 0000000..8409c90
--- /dev/null
+++ b/distribution/seed/seed-config-chain.xspec
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<x:description xmlns:x="http://www.jenitennison.com/xslt/xspec"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map" stylesheet="seed-config-chain.xsl"
+    run-as="external">
+
+    <x:variable name="id-xsl-transformation-id" as="xs:string" select="'xsl-document'"/>
+
+    <x:scenario label="chained id.xsl">
+        <x:param name="saxon-config-uri" select="'../../test/media-type/saxon.xml'"/>
+        <x:context href="../../test/media-type/id.xsl"/>
+        <x:expect label="transformation ID" test="map:contains(., $id-xsl-transformation-id)"/>
+        <x:expect label="has parameter descriptions"
+            test=". => map:get($id-xsl-transformation-id) => map:contains('parameterDescriptors')"/>
+        <x:expect label="parameter descriptions from chained transformation"
+            test=". => map:get($id-xsl-transformation-id) => map:get('parameterDescriptors') => map:contains('fingers')"
+        />
+    </x:scenario>
+
+</x:description>
diff --git a/distribution/seed/seed-config.xsl b/distribution/seed/seed-config.xsl
index 52212cf..3d0c2d2 100644
--- a/distribution/seed/seed-config.xsl
+++ b/distribution/seed/seed-config.xsl
@@ -48,8 +48,7 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         otherwise they are prefixed with $upload-uri. -->
     <xsl:param name="relative-uris" as="xs:boolean" select="true()"/>
 
-    <xsl:param name="class" as="xs:string"
-        select="'xslt'"/>
+    <xsl:param name="class" as="xs:string" select="'xslt'"/>
 
     <xsl:param name="transformation-id" as="xs:string" select="'name'"/>
 
@@ -98,8 +97,7 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         <xsl:variable name="stylesheet" as="document-node()" select="."/>
         <xsl:map-entry key="$transformation-id">
             <xsl:map>
-                <xsl:map-entry key="'description'"
-                    select="($stylesheet//comment() => string-join('&#xa;') => tokenize('&#xa;'))[normalize-space() ne ''][1] => normalize-space()"/>
+                <xsl:call-template name="seed:description"/>
                 <xsl:map-entry key="'class'" select="$class"/>
                 <xsl:choose>
                     <xsl:when test="$relative-uris and $id-prefix eq ''">
@@ -114,31 +112,54 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
                         />
                     </xsl:otherwise>
                 </xsl:choose>
-                <xsl:map-entry key="'mediaType'" select="seed:media-type($stylesheet)"/>
-                <xsl:map-entry key="'requiresSource'"
-                    select="exists($stylesheet/global-context-item)"/>
-
+                <xsl:call-template name="seed:media-type"/>
+                <xsl:call-template name="seed:requires-source"/>
                 <!-- libraries (used packages) -->
-                <xsl:map-entry key="'libraries'">
-                    <xsl:variable name="libs" as="map(*)*">
-                        <xsl:apply-templates mode="libraries" select="$stylesheet"/>
-                    </xsl:variable>
-                    <xsl:sequence
-                        select="array {$libs => reverse() => seed:distinct-maps-in-order(())}"/>
-                </xsl:map-entry>
-
+                <xsl:call-template name="seed:libraries"/>
                 <!-- parameters -->
-                <xsl:map-entry key="'parameterDescriptors'">
-                    <xsl:variable name="params" as="map(*)*">
-                        <xsl:apply-templates mode="stylesheet-params" select="$stylesheet"/>
-                    </xsl:variable>
-                    <xsl:sequence select="map:merge($params, $merge-options)"/>
-                </xsl:map-entry>
-
+                <xsl:call-template name="seed:parameter-descriptors"/>
             </xsl:map>
         </xsl:map-entry>
     </xsl:template>
 
+    <xsl:template name="seed:description" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'description'"
+            select="($stylesheet//comment() => string-join('&#xa;') => tokenize('&#xa;'))[normalize-space() ne ''][1] => normalize-space()"
+        />
+    </xsl:template>
+
+    <xsl:template name="seed:media-type" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'mediaType'" select="seed:media-type($stylesheet)"/>
+    </xsl:template>
+
+    <xsl:template name="seed:requires-source" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'requiresSource'" select="exists($stylesheet/global-context-item)"/>
+    </xsl:template>
+
+    <xsl:template name="seed:libraries" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'libraries'">
+            <xsl:variable name="libs" as="map(*)*">
+                <xsl:apply-templates mode="libraries" select="$stylesheet"/>
+            </xsl:variable>
+            <xsl:sequence select="array {$libs => reverse() => seed:distinct-maps-in-order(())}"/>
+        </xsl:map-entry>
+    </xsl:template>
+
+    <xsl:template name="seed:parameter-descriptors" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'parameterDescriptors'">
+            <xsl:variable name="params" as="map(*)*">
+                <xsl:apply-templates mode="stylesheet-params" select="$stylesheet"/>
+            </xsl:variable>
+            <xsl:sequence select="map:merge($params, $merge-options)"/>
+        </xsl:map-entry>
+    </xsl:template>
+
+
     <xsl:mode name="libraries" on-no-match="shallow-skip"/>
     <xsl:mode name="stylesheet-params" on-no-match="shallow-skip"/>
 
diff --git a/test/media-type/id.xsl b/test/media-type/id.xsl
new file mode 100644
index 0000000..71636df
--- /dev/null
+++ b/test/media-type/id.xsl
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:math="http://www.w3.org/2005/xpath-functions/math" exclude-result-prefixes="#all"
+    version="3.0">
+
+    <xsl:param name="fingers" as="xs:integer" select="10"/>
+
+    <xsl:mode on-no-match="shallow-copy"/>
+
+</xsl:stylesheet>
diff --git a/test/media-type/saxon.xml b/test/media-type/saxon.xml
new file mode 100644
index 0000000..224d920
--- /dev/null
+++ b/test/media-type/saxon.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+     This is a Saxon configuration file.
+     
+     For documentation on the contents of a Saxon configuration file, see
+     http://www.saxonica.com/documentation/index/configuration-file.html
+     
+     While you edit, oXygen will also show you the documentation for each element
+     and attribute next to the content completion proposals.
+     
+     If have oXygen Author mode then switch to the Author page to get a graphical 
+     interface for editing this configuration file  
+-->
+<configuration edition="HE" xmlns="http://saxon.sf.net/ns/configuration"> </configuration>

From 51295056ffa66e4e2b488399a2bbcfc8e4fac51a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Fri, 22 May 2026 10:24:36 +0200
Subject: [PATCH 02/28] adds chained transformation correctly to libraries

This is related to #20.
---
 distribution/seed/seed-config-chain.xsl   | 48 +++++++++++---
 distribution/seed/seed-config-chain.xspec | 22 ++++++-
 distribution/seed/seed-config.xsl         | 78 +++++++++++++++++++----
 test/media-type/id.xsl                    | 11 ++--
 test/media-type/saxon.xml                 | 17 ++---
 5 files changed, 136 insertions(+), 40 deletions(-)

diff --git a/distribution/seed/seed-config-chain.xsl b/distribution/seed/seed-config-chain.xsl
index 19b49cd..3adeec9 100644
--- a/distribution/seed/seed-config-chain.xsl
+++ b/distribution/seed/seed-config-chain.xsl
@@ -31,9 +31,16 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
 
     <xsl:import _href="{$seed-config-xsl}"/>
 
+    <!-- set this to the empty string or () if you do not want pass on to a mediaType processor -->
+    <xsl:param name="media-type-package" as="xs:string" required="true"/>
+
+    <!-- version of the mediaType processor package -->
+    <xsl:param name="media-type-package-version" as="xs:string" select="'1.0.0'"/>
+
+    <!-- base URI of the dts-transformations project -->
     <xsl:param name="dts-root" as="xs:string" select="resolve-uri('../../', static-base-uri())"/>
 
-    <!-- document.xsl stylesheet -->
+    <!-- stylesheet for document endpoint -->
     <xsl:param name="document-xsl" as="xs:string"
         select="resolve-uri('xsl/document.xsl', $dts-root)"/>
 
@@ -53,6 +60,21 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
 
     <xsl:template name="xsl:initial-template">
         <xsl:map>
+            <!-- start with document.xsl -->
+            <xsl:variable name="document-relative-path"
+                select="substring($document-xsl, string-length(resolve-uri('.', base-uri($dts-saxon-config))) + 1)"/>
+            <xsl:apply-templates mode="transformation" select="$document-transformation">
+                <xsl:with-param name="transformation-id"
+                    select="seed:get-transformation-id($document-relative-path, .)" tunnel="true"/>
+                <xsl:with-param name="location" select="$document-relative-path" tunnel="true"/>
+            </xsl:apply-templates>
+            <!-- on with chained transformation given as source -->
+            <xsl:variable name="transformation-relative-path"
+                select="substring(base-uri(), string-length(resolve-uri('.', $base-uri)) + 1)"/>
+            <xsl:apply-templates mode="libraries" select="."/>
+        </xsl:map>
+
+        <!--xsl:map>
             <xsl:for-each select="$transformations">
                 <xsl:variable name="location" select="resolve-uri(., $base-uri)"/>
                 <xsl:variable name="stylesheet" as="document-node()" select="doc($location)"/>
@@ -62,32 +84,36 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
                     <xsl:with-param name="location" tunnel="true" select="."/>
                 </xsl:apply-templates>
             </xsl:for-each>
-        </xsl:map>
+        </xsl:map-->
     </xsl:template>
 
     <xsl:template match="document-node()">
+        <xsl:message>document-node in default mode</xsl:message>
         <xsl:map>
+            <xsl:variable name="relative-path"
+                select="seed:configured-package($media-type-package, $media-type-package-version, $saxon-config)/@sourceLocation"/>
             <!-- start with document.xsl -->
             <xsl:variable name="document-relative-path"
                 select="substring($document-xsl, string-length(resolve-uri('.', base-uri($dts-saxon-config))) + 1)"/>
             <xsl:apply-templates mode="transformation" select="$document-transformation">
                 <xsl:with-param name="transformation-id"
-                    select="seed:get-transformation-id($document-relative-path, .)" tunnel="true"/>
+                    select="seed:get-transformation-id($relative-path, .)" tunnel="true"/>
                 <xsl:with-param name="location" select="$document-relative-path" tunnel="true"/>
             </xsl:apply-templates>
-            <!-- on with chained transformation given as source -->
-            <xsl:variable name="transformation-relative-path"
-                select="substring(base-uri(), string-length(resolve-uri('.', $base-uri)) + 1)"/>
-            <xsl:apply-templates mode="libraries" select="."/>
         </xsl:map>
     </xsl:template>
 
     <xsl:template name="seed:libraries" as="item()">
         <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:message>NT seed:libraries overwrite</xsl:message>
         <xsl:map-entry key="'libraries'">
             <xsl:variable name="libs" as="map(*)*">
                 <xsl:apply-templates mode="libraries" select="$stylesheet"/>
-                <xsl:apply-templates mode="libraries" select="$chained-transformation"/>
+                <xsl:call-template name="seed:package-with-mode">
+                    <xsl:with-param name="name" select="$media-type-package"/>
+                    <xsl:with-param name="version" select="$media-type-package-version"/>
+                    <xsl:with-param name="mode" select="'libraries'"/>
+                </xsl:call-template>
             </xsl:variable>
             <xsl:sequence select="array {$libs => reverse() => seed:distinct-maps-in-order(())}"/>
         </xsl:map-entry>
@@ -98,7 +124,11 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         <xsl:map-entry key="'parameterDescriptors'">
             <xsl:variable name="params" as="map(*)*">
                 <xsl:apply-templates mode="stylesheet-params" select="$stylesheet"/>
-                <xsl:apply-templates mode="stylesheet-params" select="$chained-transformation"/>
+                <xsl:call-template name="seed:package-with-mode">
+                    <xsl:with-param name="name" select="$media-type-package"/>
+                    <xsl:with-param name="version" select="$media-type-package-version"/>
+                    <xsl:with-param name="mode" select="'stylesheet-params'"/>
+                </xsl:call-template>
             </xsl:variable>
             <xsl:sequence select="map:merge($params, $merge-options)"/>
         </xsl:map-entry>
diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
index 8409c90..8e46efc 100644
--- a/distribution/seed/seed-config-chain.xspec
+++ b/distribution/seed/seed-config-chain.xspec
@@ -1,16 +1,32 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <x:description xmlns:x="http://www.jenitennison.com/xslt/xspec"
     xmlns:xs="http://www.w3.org/2001/XMLSchema"
-    xmlns:map="http://www.w3.org/2005/xpath-functions/map" stylesheet="seed-config-chain.xsl"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map"
+    xmlns:array="http://www.w3.org/2005/xpath-functions/array" stylesheet="seed-config-chain.xsl"
     run-as="external">
 
-    <x:variable name="id-xsl-transformation-id" as="xs:string" select="'xsl-document'"/>
+    <x:variable name="id-xsl-transformation-id" as="xs:string" select="'id'"/>
 
     <x:scenario label="chained id.xsl">
         <x:param name="saxon-config-uri" select="'../../test/media-type/saxon.xml'"/>
+        <x:param name="media-type-package" select="'http://example.com/xsl/identity'"/>
         <x:context href="../../test/media-type/id.xsl"/>
         <x:expect label="transformation ID" test="map:contains(., $id-xsl-transformation-id)"/>
-        <x:expect label="has parameter descriptions"
+        <x:expect label="document.xsl as stylesheet location (start with)"
+            test=". => map:get($id-xsl-transformation-id) => map:get('location') => starts-with('xsl')"/>
+        <x:expect label="document.xsl as stylesheet location (ends with)"
+            test=". => map:get($id-xsl-transformation-id) => map:get('location') => ends-with('document.xsl')"/>
+        <x:expect label="has libraries"
+            test=". => map:get($id-xsl-transformation-id) => map:contains('libraries')"/>
+        <x:expect label="1 library"
+            test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:size()"
+            as="xs:integer" select="1"/>
+        <x:expect label="library has location"
+            test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:get(1) => map:contains('location')"/>
+        <x:expect label="library has location"
+            test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:get(1) => map:get('location')"
+            as="xs:string" select="'id.xsl'"/>
+        <x:expect label="has parameter descriptors"
             test=". => map:get($id-xsl-transformation-id) => map:contains('parameterDescriptors')"/>
         <x:expect label="parameter descriptions from chained transformation"
             test=". => map:get($id-xsl-transformation-id) => map:get('parameterDescriptors') => map:contains('fingers')"
diff --git a/distribution/seed/seed-config.xsl b/distribution/seed/seed-config.xsl
index 3d0c2d2..57df946 100644
--- a/distribution/seed/seed-config.xsl
+++ b/distribution/seed/seed-config.xsl
@@ -78,6 +78,7 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     </xsl:template>
 
     <xsl:template match="document-node()">
+        <xsl:message>document-node in default mode</xsl:message>
         <xsl:map>
             <xsl:variable name="relative-path"
                 select="substring(base-uri(), string-length(resolve-uri('.', $base-uri)) + 1)"/>
@@ -94,6 +95,7 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     <xsl:template match="document-node()" mode="transformation">
         <xsl:param name="transformation-id" as="xs:string" tunnel="true"/>
         <xsl:param name="location" as="xs:string" tunnel="true"/>
+        <xsl:message>document-node in mode transformation</xsl:message>
         <xsl:variable name="stylesheet" as="document-node()" select="."/>
         <xsl:map-entry key="$transformation-id">
             <xsl:map>
@@ -141,6 +143,7 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
 
     <xsl:template name="seed:libraries" as="item()">
         <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:message>NT seed:libraries</xsl:message>
         <xsl:map-entry key="'libraries'">
             <xsl:variable name="libs" as="map(*)*">
                 <xsl:apply-templates mode="libraries" select="$stylesheet"/>
@@ -169,8 +172,62 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     </xsl:template>
 
     <xsl:template mode="libraries stylesheet-params" match="use-package">
-        <xsl:variable name="name" select="@name"/>
-        <xsl:variable name="version" select="@package-version"/>
+        <xsl:variable name="pkg" as="element(cfg:package)?"
+            select="seed:configured-package(@name, @version, $saxon-config)"/>
+        <xsl:if test="$pkg">
+            <xsl:variable name="package" as="document-node()" select="seed:read-package($pkg)"/>
+            <!-- make entry for this package -->
+            <xsl:apply-templates mode="#current" select="$pkg">
+                <xsl:with-param name="name" select="$pkg/@name" tunnel="true"/>
+                <xsl:with-param name="version" select="$pkg/@version" tunnel="true"/>
+                <xsl:with-param name="package" select="$package" tunnel="true"/>
+            </xsl:apply-templates>
+            <!-- recurse into packages used by the package -->
+            <xsl:apply-templates mode="#current" select="$package"/>
+        </xsl:if>
+    </xsl:template>
+
+    <xsl:template name="seed:package-with-mode" visibility="final">
+        <xsl:param name="name" as="xs:string?"/>
+        <xsl:param name="version" as="xs:string?"/>
+        <xsl:param name="mode" as="xs:string"/>
+        <xsl:variable name="pkg" as="element(cfg:package)?"
+            select="seed:configured-package($name, $version, $saxon-config)"/>
+        <xsl:variable name="package" as="document-node()?" select="$pkg ! seed:read-package(.)"/>
+        <xsl:choose>
+            <xsl:when test="empty($package)"/>
+            <xsl:when test="$mode = 'libraries'">
+                <!-- make entry for this package -->
+                <xsl:apply-templates mode="libraries" select="$pkg">
+                    <xsl:with-param name="name" select="$pkg/@name" tunnel="true"/>
+                    <xsl:with-param name="version" select="$pkg/@version" tunnel="true"/>
+                    <xsl:with-param name="package" select="$package" tunnel="true"/>
+                </xsl:apply-templates>
+                <!-- recurse into packages used by the package -->
+                <xsl:apply-templates mode="libraries" select="$package"/>
+            </xsl:when>
+            <xsl:when test="$mode = 'stylesheet-params'">
+                <!-- make entry for this package -->
+                <xsl:apply-templates mode="stylesheet-params" select="$pkg">
+                    <xsl:with-param name="name" select="$pkg/@name" tunnel="true"/>
+                    <xsl:with-param name="version" select="$pkg/@version" tunnel="true"/>
+                    <xsl:with-param name="package" select="$package" tunnel="true"/>
+                </xsl:apply-templates>
+                <!-- recurse into packages used by the package -->
+                <xsl:apply-templates mode="stylesheet-params" select="$package"/>
+            </xsl:when>
+        </xsl:choose>
+    </xsl:template>
+
+    <xsl:function name="seed:configured-package" as="element(cfg:package)?">
+        <xsl:param name="name" as="xs:string?"/>
+        <xsl:param name="version" as="xs:string?"/>
+        <xsl:param name="saxon-config" as="document-node()"/>
+        <xsl:message use-when="system-property('debug') eq 'true'">
+            <xsl:text>selecting package </xsl:text>
+            <xsl:value-of select="$name"/>
+            <xsl:value-of select="$version"/>
+        </xsl:message>
         <!-- There may be several packages configured for the same @name and @version.
             In this case we disambiguate using @priority. -->
         <xsl:variable name="pkgs" as="element()*">
@@ -202,17 +259,14 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
                     <xsl:value-of select="$pkg-uri"/>
                 </xsl:message>
             </xsl:if>
-            <xsl:variable name="package" select="doc($pkg-uri)" as="document-node()"/>
-            <!-- make entry for this package -->
-            <xsl:apply-templates mode="#current" select="$pkg">
-                <xsl:with-param name="name" select="$pkg/@name" tunnel="true"/>
-                <xsl:with-param name="version" select="$pkg/@version" tunnel="true"/>
-                <xsl:with-param name="package" select="$package" tunnel="true"/>
-            </xsl:apply-templates>
-            <!-- recurse into packages used by the package -->
-            <xsl:apply-templates mode="#current" select="$package"/>
+            <xsl:sequence select="$pkg"/>
         </xsl:if>
-    </xsl:template>
+    </xsl:function>
+
+    <xsl:function name="seed:read-package" as="document-node(element(xsl:package))">
+        <xsl:param name="pkg" as="element(cfg:package)"/>
+        <xsl:sequence select="resolve-uri($pkg/@sourceLocation, base-uri($pkg)) => doc()"/>
+    </xsl:function>
 
     <xsl:template mode="libraries" match="cfg:package">
         <xsl:param name="name" as="xs:string" tunnel="true"/>
diff --git a/test/media-type/id.xsl b/test/media-type/id.xsl
index 71636df..0c11838 100644
--- a/test/media-type/id.xsl
+++ b/test/media-type/id.xsl
@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-    xmlns:xs="http://www.w3.org/2001/XMLSchema"
-    xmlns:math="http://www.w3.org/2005/xpath-functions/math" exclude-result-prefixes="#all"
-    version="3.0">
+<xsl:package name="http://example.com/xsl/identity" package-version="1.0.0"
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    exclude-result-prefixes="#all" version="3.0" default-mode="identity">
 
     <xsl:param name="fingers" as="xs:integer" select="10"/>
 
-    <xsl:mode on-no-match="shallow-copy"/>
+    <xsl:mode name="identity" on-no-match="shallow-copy"/>
 
-</xsl:stylesheet>
+</xsl:package>
diff --git a/test/media-type/saxon.xml b/test/media-type/saxon.xml
index 224d920..7605a8d 100644
--- a/test/media-type/saxon.xml
+++ b/test/media-type/saxon.xml
@@ -1,14 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- 
      This is a Saxon configuration file.
-     
-     For documentation on the contents of a Saxon configuration file, see
-     http://www.saxonica.com/documentation/index/configuration-file.html
-     
-     While you edit, oXygen will also show you the documentation for each element
-     and attribute next to the content completion proposals.
-     
-     If have oXygen Author mode then switch to the Author page to get a graphical 
-     interface for editing this configuration file  
 -->
-<configuration edition="HE" xmlns="http://saxon.sf.net/ns/configuration"> </configuration>
+<configuration edition="HE" xmlns="http://saxon.sf.net/ns/configuration">
+
+     <xsltPackages>
+          <package name="http://example.com/xsl/identity" version="1.0.0" sourceLocation="id.xsl"/>
+     </xsltPackages>
+
+</configuration>

From ee599124bf4bfd1de94096ee35789ead6a2d1876 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Fri, 22 May 2026 11:51:08 +0200
Subject: [PATCH 03/28] supports the 4 compile time parameters required for
 media-type

This is related to #20.
---
 distribution/seed/seed-config-chain.xsl   | 49 +++++++++++++++++++++++
 distribution/seed/seed-config-chain.xspec | 10 ++++-
 distribution/seed/seed-config.xsl         |  8 ++++
 3 files changed, 66 insertions(+), 1 deletion(-)

diff --git a/distribution/seed/seed-config-chain.xsl b/distribution/seed/seed-config-chain.xsl
index 3adeec9..a51b027 100644
--- a/distribution/seed/seed-config-chain.xsl
+++ b/distribution/seed/seed-config-chain.xsl
@@ -37,6 +37,13 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     <!-- version of the mediaType processor package -->
     <xsl:param name="media-type-package-version" as="xs:string" select="'1.0.0'"/>
 
+    <!-- should be 'template', 'mode', or 'function' -->
+    <xsl:param name="media-type-component" as="xs:string" select="'template'"/>
+
+    <!-- name of the template, mode or function used as an entry point for mediaType processing -->
+    <xsl:param name="media-type-processor" as="xs:string" select="'post-proc'"/>
+
+
     <!-- base URI of the dts-transformations project -->
     <xsl:param name="dts-root" as="xs:string" select="resolve-uri('../../', static-base-uri())"/>
 
@@ -134,6 +141,48 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         </xsl:map-entry>
     </xsl:template>
 
+    <xsl:template name="seed:compile-time-parameters" as="item()">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <xsl:map-entry key="'compileTimeParameters'">
+            <xsl:variable name="parameter-descriptor-maps" as="map(*)*">
+                <xsl:apply-templates mode="stylesheet-params" select="$stylesheet"/>
+            </xsl:variable>
+            <xsl:variable name="parameter-descriptors" as="map(xs:string, item()*)"
+                select="map:merge($parameter-descriptor-maps, $merge-options)"/>
+            <xsl:variable name="media-type-parameters" as="map(xs:string, item()*)*">
+                <xsl:map>
+                    <xsl:map-entry key="'name'">media-type-package</xsl:map-entry>
+                    <xsl:map-entry key="'value'" select="$media-type-package"/>
+                    <xsl:map-entry key="'type'"
+                        select="map:get($parameter-descriptors, 'media-type-package') => map:get('type')"
+                    />
+                </xsl:map>
+                <xsl:map>
+                    <xsl:map-entry key="'name'">media-type-package-version</xsl:map-entry>
+                    <xsl:map-entry key="'value'" select="$media-type-package-version"/>
+                    <xsl:map-entry key="'type'"
+                        select="map:get($parameter-descriptors, 'media-type-package-version') => map:get('type')"
+                    />
+                </xsl:map>
+                <xsl:map>
+                    <xsl:map-entry key="'name'">media-type-component</xsl:map-entry>
+                    <xsl:map-entry key="'value'" select="$media-type-component"/>
+                    <xsl:map-entry key="'type'"
+                        select="map:get($parameter-descriptors, 'media-type-component') => map:get('type')"
+                    />
+                </xsl:map>
+                <xsl:map>
+                    <xsl:map-entry key="'name'">media-type-processor</xsl:map-entry>
+                    <xsl:map-entry key="'value'" select="$media-type-processor"/>
+                    <xsl:map-entry key="'type'"
+                        select="map:get($parameter-descriptors, 'media-type-processor') => map:get('type')"
+                    />
+                </xsl:map>
+            </xsl:variable>
+            <xsl:sequence select="array {$media-type-parameters}"/>
+        </xsl:map-entry>
+    </xsl:template>
+
 
 
 </xsl:stylesheet>
diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
index 8e46efc..91e241f 100644
--- a/distribution/seed/seed-config-chain.xspec
+++ b/distribution/seed/seed-config-chain.xspec
@@ -29,7 +29,15 @@
         <x:expect label="has parameter descriptors"
             test=". => map:get($id-xsl-transformation-id) => map:contains('parameterDescriptors')"/>
         <x:expect label="parameter descriptions from chained transformation"
-            test=". => map:get($id-xsl-transformation-id) => map:get('parameterDescriptors') => map:contains('fingers')"
+            test=". => map:get($id-xsl-transformation-id) => map:get('parameterDescriptors') => map:contains('fingers')"/>
+        <x:expect label="has compile time parameters"
+            test=". => map:get($id-xsl-transformation-id) => map:contains('compileTimeParameters')"/>
+        <x:expect label="has 4 compile time parameters"
+            test=". => map:get($id-xsl-transformation-id) => map:get('compileTimeParameters') => array:size()"
+            as="xs:integer" select="4"/>
+        <x:expect label="has the 4 media-type related compile time parameters"
+            test=". => map:get($id-xsl-transformation-id) => map:get('compileTimeParameters') => array:for-each(function ($x) as xs:string { map:get($x, 'name') })"
+            select="array {'media-type-package','media-type-package-version','media-type-component','media-type-processor'}"
         />
     </x:scenario>
 
diff --git a/distribution/seed/seed-config.xsl b/distribution/seed/seed-config.xsl
index 57df946..4a4b964 100644
--- a/distribution/seed/seed-config.xsl
+++ b/distribution/seed/seed-config.xsl
@@ -120,6 +120,8 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
                 <xsl:call-template name="seed:libraries"/>
                 <!-- parameters -->
                 <xsl:call-template name="seed:parameter-descriptors"/>
+                <!-- compile time parameters -->
+                <xsl:call-template name="seed:compile-time-parameters"/>
             </xsl:map>
         </xsl:map-entry>
     </xsl:template>
@@ -162,6 +164,12 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         </xsl:map-entry>
     </xsl:template>
 
+    <xsl:template name="seed:compile-time-parameters" as="item()?">
+        <xsl:param name="stylesheet" as="document-node()" select="."/>
+        <!--xsl:map-entry key="'compileTimeParameters'"/-->
+    </xsl:template>
+
+
 
     <xsl:mode name="libraries" on-no-match="shallow-skip"/>
     <xsl:mode name="stylesheet-params" on-no-match="shallow-skip"/>

From e93763c249960f81c588f369825c7ddd28c45e4c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Fri, 22 May 2026 11:52:13 +0200
Subject: [PATCH 04/28] fixes typo

---
 xsl/document.xsl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xsl/document.xsl b/xsl/document.xsl
index 819b16c..7d5a50c 100644
--- a/xsl/document.xsl
+++ b/xsl/document.xsl
@@ -13,7 +13,7 @@ target/bin/xslt.sh \
     -it \
     resource=test/matt.xml
 
-All the entpoints parameters are supported through stylesheet parameters.
+All the endpoints parameters are supported through stylesheet parameters.
 
 Post-processing for returning another mediaType than application/tei+xml can be customized
 by the static parameters $media-type-*. It is turned of by default. Set to $media-type-package

From fae955a1b57aef38d96c6cd5fc7ea770a3d6e0fe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 14:12:14 +0200
Subject: [PATCH 05/28] makes test more robust against changes in library

---
 distribution/seed/seed-config-chain.xspec | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
index 91e241f..dc07d1c 100644
--- a/distribution/seed/seed-config-chain.xspec
+++ b/distribution/seed/seed-config-chain.xspec
@@ -23,9 +23,9 @@
             as="xs:integer" select="1"/>
         <x:expect label="library has location"
             test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:get(1) => map:contains('location')"/>
-        <x:expect label="library has location"
-            test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:get(1) => map:get('location')"
-            as="xs:string" select="'id.xsl'"/>
+        <x:expect label="compiles the media-type package as a library"
+            test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => ends-with('id.xsl') }) => array:size()"
+            as="xs:integer" select="1"/>
         <x:expect label="has parameter descriptors"
             test=". => map:get($id-xsl-transformation-id) => map:contains('parameterDescriptors')"/>
         <x:expect label="parameter descriptions from chained transformation"

From 8e9adc2f8e4ee3c2850ae87e15697b8ca3c22996 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 14:13:10 +0200
Subject: [PATCH 06/28] adds sample chaining to plain text output as test case

---
 distribution/seed/seed-config-chain.xspec | 27 +++++++
 test/media-type/saxon.xml                 |  2 +
 test/media-type/tei2txt.xsl               | 90 +++++++++++++++++++++++
 3 files changed, 119 insertions(+)
 create mode 100644 test/media-type/tei2txt.xsl

diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
index dc07d1c..17f0208 100644
--- a/distribution/seed/seed-config-chain.xspec
+++ b/distribution/seed/seed-config-chain.xspec
@@ -41,4 +41,31 @@
         />
     </x:scenario>
 
+
+    <x:variable name="txt-xsl-transformation-id" as="xs:string" select="'tei2txt'"/>
+
+    <x:scenario label="chained tei2txt.xsl">
+        <x:param name="saxon-config-uri" select="'../../test/media-type/saxon.xml'"/>
+        <x:param name="media-type-package" select="'http://example.com/xsl/tei2txt'"/>
+        <x:param name="media-type-component" select="'mode'"/>
+        <x:param name="media-type-processor" select="'tei'"/>
+        <x:context href="../../test/media-type/tei2txt.xsl"/>
+        <x:expect label="transformation ID" test="map:contains(., $txt-xsl-transformation-id)"/>
+        <x:expect label="compiles the media-type package as a library"
+            test=". => map:get($txt-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => ends-with('tei2txt.xsl') }) => array:size()"
+            as="xs:integer" select="1"/>
+        <x:expect label="has the 4 media-type related compile time parameters"
+            test=". => map:get($txt-xsl-transformation-id) => map:get('compileTimeParameters') => array:for-each(function ($x) as xs:string { map:get($x, 'name') })"
+            select="array {'media-type-package','media-type-package-version','media-type-component','media-type-processor'}"/>
+        <x:expect label="media-type package"
+            test=". => map:get($txt-xsl-transformation-id) => map:get('compileTimeParameters') => array:filter(function ($x) as xs:boolean { map:get($x, 'name') eq 'media-type-package' }) => array:head() => map:get('value')"
+            select="'http://example.com/xsl/tei2txt'"/>
+        <x:expect label="media-type component"
+            test=". => map:get($txt-xsl-transformation-id) => map:get('compileTimeParameters') => array:filter(function ($x) as xs:boolean { map:get($x, 'name') eq 'media-type-component' }) => array:head() => map:get('value')"
+            select="'mode'"/>
+        <x:expect label="media-type processor"
+            test=". => map:get($txt-xsl-transformation-id) => map:get('compileTimeParameters') => array:filter(function ($x) as xs:boolean { map:get($x, 'name') eq 'media-type-processor' }) => array:head() => map:get('value')"
+            select="'tei'"/>
+    </x:scenario>
+
 </x:description>
diff --git a/test/media-type/saxon.xml b/test/media-type/saxon.xml
index 7605a8d..7e935f4 100644
--- a/test/media-type/saxon.xml
+++ b/test/media-type/saxon.xml
@@ -6,6 +6,8 @@
 
      <xsltPackages>
           <package name="http://example.com/xsl/identity" version="1.0.0" sourceLocation="id.xsl"/>
+          <package name="http://example.com/xsl/tei2txt" version="1.0.0"
+               sourceLocation="tei2txt.xsl"/>
      </xsltPackages>
 
 </configuration>
diff --git a/test/media-type/tei2txt.xsl b/test/media-type/tei2txt.xsl
new file mode 100644
index 0000000..7fda2ff
--- /dev/null
+++ b/test/media-type/tei2txt.xsl
@@ -0,0 +1,90 @@
+<!-- a simple transformation from TEI to plain text -->
+<xsl:package name="http://example.com/xsl/tei2txt" package-version="1.0.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
+  xpath-default-namespace="http://www.tei-c.org/ns/1.0" version="3.0" default-mode="tei">
+
+  <xsl:output method="text"/>
+
+  <xsl:mode name="tei" on-no-match="shallow-skip"/>
+
+  <xsl:mode name="prose" on-no-match="shallow-skip"/>
+
+  <xsl:mode name="verse" on-no-match="shallow-skip"/>
+
+  <xsl:template mode="#all" match="TEI">
+    <xsl:apply-templates mode="#current" select="text"/>
+  </xsl:template>
+
+  <xsl:template mode="#all" match="p | ab | head">
+    <xsl:apply-templates mode="prose"/>
+    <xsl:text>&#xa;&#xa;</xsl:text>
+  </xsl:template>
+
+  <xsl:template mode="#all" match="div | div1 | div2 | div3 | div4 | div5 | div6 | div7">
+    <xsl:apply-templates mode="#current" select="*"/>
+  </xsl:template>
+
+  <xsl:template mode="#all" match="l">
+    <xsl:text>&#xa;</xsl:text>
+    <xsl:apply-templates mode="verse"/>
+  </xsl:template>
+
+  <xsl:template mode="verse" match="caesura">
+    <xsl:text>&#x9;</xsl:text>
+  </xsl:template>
+
+  <xsl:template mode="#all" match="lg">
+    <xsl:text>&#xa;</xsl:text>
+    <xsl:apply-templates mode="#current" select="*"/>
+  </xsl:template>
+
+
+  <xsl:template mode="#all" match="app[//variantEncoding/@method eq 'parallel-segmenation']">
+    <xsl:apply-templates mode="#current" select="lem"/>
+  </xsl:template>
+
+  <xsl:template mode="#all" match="app[//variantEncoding/@method ne 'parallel-segmenation']"/>
+
+  <xsl:template mode="#all" match="note[@type eq 'editorial']"/>
+
+  <xsl:template mode="#all" match="span | interp"/>
+
+
+  <!-- handling of text leafs -->
+
+  <!-- shrinks multiple linebreaks to a single one -->
+  <xsl:template mode="prose" match="text()">
+    <xsl:analyze-string select="." regex="(&#xa;&#xd;?)(\s*&#xa;&#xd;?)*">
+      <xsl:matching-substring>
+        <xsl:value-of select="regex-group(1)"/>
+        <xsl:text>&#xa;</xsl:text>
+      </xsl:matching-substring>
+      <xsl:non-matching-substring>
+        <xsl:value-of select="."/>
+      </xsl:non-matching-substring>
+    </xsl:analyze-string>
+  </xsl:template>
+
+  <!-- a verse is to be printed in one line -->
+  <xsl:template mode="verse" match="text()">
+    <xsl:analyze-string select="." regex="(&#xa;&#xd;?|\s+)">
+      <xsl:matching-substring>
+        <xsl:text>&#x20;</xsl:text>
+      </xsl:matching-substring>
+      <xsl:non-matching-substring>
+        <xsl:value-of select="."/>
+      </xsl:non-matching-substring>
+    </xsl:analyze-string>
+  </xsl:template>
+
+  <xsl:template mode="tei" match="text()[normalize-space(.) ne '']">
+    <xsl:message>
+      <xsl:text>dropping text in </xsl:text>
+      <xsl:value-of select="name(..)"/>
+      <xsl:text>: '</xsl:text>
+      <xsl:value-of select="tokenize(.)[1 or last()] => string-join(' ... ')"/>
+      <xsl:text>'</xsl:text>
+    </xsl:message>
+  </xsl:template>
+
+</xsl:package>

From 14dccd1edb0a27723eab6986ad1064205aee5ced Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 16:36:34 +0200
Subject: [PATCH 07/28] uses saxon configuration file for testing

---
 distribution/seed/seed-config-chain.xspec |  8 ++++----
 test/media-type/saxon.xml                 | 13 -------------
 test/saxon.xml                            |  4 ++++
 3 files changed, 8 insertions(+), 17 deletions(-)
 delete mode 100644 test/media-type/saxon.xml

diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
index 17f0208..fad4ab8 100644
--- a/distribution/seed/seed-config-chain.xspec
+++ b/distribution/seed/seed-config-chain.xspec
@@ -5,10 +5,10 @@
     xmlns:array="http://www.w3.org/2005/xpath-functions/array" stylesheet="seed-config-chain.xsl"
     run-as="external">
 
-    <x:variable name="id-xsl-transformation-id" as="xs:string" select="'id'"/>
+    <x:variable name="id-xsl-transformation-id" as="xs:string" select="'media-type-id'"/>
 
     <x:scenario label="chained id.xsl">
-        <x:param name="saxon-config-uri" select="'../../test/media-type/saxon.xml'"/>
+        <x:param name="saxon-config-uri" select="'../../test/saxon.xml'"/>
         <x:param name="media-type-package" select="'http://example.com/xsl/identity'"/>
         <x:context href="../../test/media-type/id.xsl"/>
         <x:expect label="transformation ID" test="map:contains(., $id-xsl-transformation-id)"/>
@@ -42,10 +42,10 @@
     </x:scenario>
 
 
-    <x:variable name="txt-xsl-transformation-id" as="xs:string" select="'tei2txt'"/>
+    <x:variable name="txt-xsl-transformation-id" as="xs:string" select="'media-type-tei2txt'"/>
 
     <x:scenario label="chained tei2txt.xsl">
-        <x:param name="saxon-config-uri" select="'../../test/media-type/saxon.xml'"/>
+        <x:param name="saxon-config-uri" select="'../../test/saxon.xml'"/>
         <x:param name="media-type-package" select="'http://example.com/xsl/tei2txt'"/>
         <x:param name="media-type-component" select="'mode'"/>
         <x:param name="media-type-processor" select="'tei'"/>
diff --git a/test/media-type/saxon.xml b/test/media-type/saxon.xml
deleted file mode 100644
index 7e935f4..0000000
--- a/test/media-type/saxon.xml
+++ /dev/null
@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- 
-     This is a Saxon configuration file.
--->
-<configuration edition="HE" xmlns="http://saxon.sf.net/ns/configuration">
-
-     <xsltPackages>
-          <package name="http://example.com/xsl/identity" version="1.0.0" sourceLocation="id.xsl"/>
-          <package name="http://example.com/xsl/tei2txt" version="1.0.0"
-               sourceLocation="tei2txt.xsl"/>
-     </xsltPackages>
-
-</configuration>
diff --git a/test/saxon.xml b/test/saxon.xml
index 2f5767a..2287dc0 100644
--- a/test/saxon.xml
+++ b/test/saxon.xml
@@ -41,6 +41,10 @@ This configuration
             version="1.0.0" sourceLocation="post-proc-call.xsl"/>
         <package name="https://scdh.github.io/dts-transformations/xsl/post-proc-fun.xsl"
             version="1.0.0" sourceLocation="post-proc-fun.xsl"/>
+        <package name="http://example.com/xsl/identity" version="1.0.0"
+            sourceLocation="media-type/id.xsl"/>
+        <package name="http://example.com/xsl/tei2txt" version="1.0.0"
+            sourceLocation="media-type/tei2txt.xsl"/>
     </xsltPackages>
 
 </configuration>

From b65e26c5cb3355ffa5fffb863b65300d3860b2d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 17:31:29 +0200
Subject: [PATCH 08/28] adds tests for the plain SEED configuration

---
 build.xml                           |  7 ++++++
 distribution/seed/seed-config.xspec | 37 +++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 distribution/seed/seed-config.xspec

diff --git a/build.xml b/build.xml
index 3626b8e..1026b31 100644
--- a/build.xml
+++ b/build.xml
@@ -28,6 +28,7 @@
         <antcall target="test-xsl-uri-templates-query-parameters.xsl"/>
         <antcall target="test-xsl-uri-templates-path-parameters.xsl"/>
         <!-- testing utils -->
+        <antcall target="test-distribution-seed-seed-config.xsl"/>
         <antcall target="test-distribution-seed-seed-config-chain.xsl"/>
     </target>
 
@@ -81,6 +82,12 @@
 
     <!-- tests for utils -->
 
+    <target name="test-distribution-seed-seed-config.xsl">
+        <antcall target="xspec.xspec" inheritall="false">
+            <param name="xspec.xml" location="${basedir}/distribution/seed/seed-config.xspec"/>
+        </antcall>
+    </target>
+
     <target name="test-distribution-seed-seed-config-chain.xsl">
         <antcall target="xspec.xspec" inheritall="false">
             <param name="xspec.xml" location="${basedir}/distribution/seed/seed-config-chain.xspec"
diff --git a/distribution/seed/seed-config.xspec b/distribution/seed/seed-config.xspec
new file mode 100644
index 0000000..96cb799
--- /dev/null
+++ b/distribution/seed/seed-config.xspec
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<x:description xmlns:x="http://www.jenitennison.com/xslt/xspec"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map"
+    xmlns:array="http://www.w3.org/2005/xpath-functions/array" stylesheet="seed-config.xsl"
+    run-as="external">
+
+    <x:param name="id-prefix">dts</x:param>
+
+    <x:scenario label="config for document.xsl">
+        <x:param name="saxon-config-uri" select="'../../saxon.xml'"/>
+        <x:context href="../../xsl/document.xsl"/>
+        <x:expect label="config has dts-xsl-document transformation"
+            test="map:contains(., 'dts-xsl-document')"/>
+        <x:expect label="has stylesheet location"
+            test="map:get(., 'dts-xsl-document') => map:get('location')"
+            select="'dts/xsl/document.xsl'"/>
+        <x:expect label="transforms to text/xml"
+            test="map:get(., 'dts-xsl-document') => map:get('mediaType')" select="'text/xml'"/>
+        <x:expect label="transformation class is xslt"
+            test="map:get(., 'dts-xsl-document') => map:get('class')" select="'xslt'"/>
+        <x:expect label="requires source"
+            test="map:get(., 'dts-xsl-document') => map:get('requiresSource') => xs:string()"
+            select="'false'"/>
+        <x:expect label="has description"
+            test="map:get(., 'dts-xsl-document') => map:contains('description')"/>
+        <x:expect label="uses multiple libraries"
+            test="map:get(., 'dts-xsl-document') => map:get('libraries') => array:size() gt 0"/>
+        <x:expect label="uses tree.xsl as library"
+            test=". => map:get('dts-xsl-document') => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') eq 'dts/xsl/tree.xsl' }) => array:size()"
+            select="1"/>
+        <x:expect label="has more than the 6 stylesheet parameters with are in document.xsl"
+            test="map:get(., 'dts-xsl-document') => map:get('parameterDescriptors') => map:size() gt 6"
+        />
+    </x:scenario>
+
+</x:description>

From fae717251557f86f8510d88cf77f0a4c23033a33 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 18:09:51 +0200
Subject: [PATCH 09/28] adds test for chaining with dependencies in chained
 stylesheet

---
 distribution/seed/seed-config-chain.xspec | 43 +++++++++++++++++++++--
 test/media-type/a.xsl                     | 12 +++++++
 test/media-type/b.xsl                     |  8 +++++
 test/saxon.xml                            |  2 ++
 4 files changed, 62 insertions(+), 3 deletions(-)
 create mode 100644 test/media-type/a.xsl
 create mode 100644 test/media-type/b.xsl

diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
index fad4ab8..2b9a833 100644
--- a/distribution/seed/seed-config-chain.xspec
+++ b/distribution/seed/seed-config-chain.xspec
@@ -18,11 +18,11 @@
             test=". => map:get($id-xsl-transformation-id) => map:get('location') => ends-with('document.xsl')"/>
         <x:expect label="has libraries"
             test=". => map:get($id-xsl-transformation-id) => map:contains('libraries')"/>
-        <x:expect label="1 library"
-            test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:size()"
-            as="xs:integer" select="1"/>
         <x:expect label="library has location"
             test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:get(1) => map:contains('location')"/>
+        <x:expect label="uses tree.xsl as library"
+            test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') eq '../xsl/tree.xsl' }) => array:size()"
+            select="1"/>
         <x:expect label="compiles the media-type package as a library"
             test=". => map:get($id-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => ends-with('id.xsl') }) => array:size()"
             as="xs:integer" select="1"/>
@@ -42,6 +42,40 @@
     </x:scenario>
 
 
+    <x:variable name="a-xsl-transformation-id" as="xs:string" select="'media-type-a'"/>
+
+    <x:scenario label="chained a.xsl">
+        <x:param name="saxon-config-uri" select="'../../test/saxon.xml'"/>
+        <x:param name="media-type-package" select="'http://example.com/xsl/a'"/>
+        <x:context href="../../test/media-type/a.xsl"/>
+        <x:expect label="transformation ID" test="map:contains(., $a-xsl-transformation-id)"/>
+        <x:expect label="document.xsl as stylesheet location (start with)"
+            test=". => map:get($a-xsl-transformation-id) => map:get('location') => starts-with('xsl')"/>
+        <x:expect label="document.xsl as stylesheet location (ends with)"
+            test=". => map:get($a-xsl-transformation-id) => map:get('location') => ends-with('document.xsl')"/>
+        <x:expect label="has libraries"
+            test=". => map:get($a-xsl-transformation-id) => map:contains('libraries')"/>
+        <x:expect label="library has location"
+            test=". => map:get($a-xsl-transformation-id) => map:get('libraries') => array:get(1) => map:contains('location')"/>
+        <x:expect label="uses tree.xsl as library"
+            test=". => map:get($a-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') eq '../xsl/tree.xsl' }) => array:size()"
+            select="1"/>
+        <x:expect label="compiles the media-type package as a library"
+            test=". => map:get($a-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => ends-with('a.xsl') }) => array:size()"
+            as="xs:integer" select="1"/>
+        <x:expect label="compiles the media-type package's dependency b.xsl as a library"
+            test=". => map:get($a-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => ends-with('b.xsl') }) => array:size()"
+            as="xs:integer" select="1"/>
+        <x:expect label="has parameter descriptors"
+            test=". => map:get($a-xsl-transformation-id) => map:contains('parameterDescriptors')"/>
+        <x:expect label="parameter descriptions from chained transformation: fingers"
+            test=". => map:get($a-xsl-transformation-id) => map:get('parameterDescriptors') => map:contains('fingers')"/>
+        <x:expect label="parameter descriptions from b.xsl: toes"
+            test=". => map:get($a-xsl-transformation-id) => map:get('parameterDescriptors') => map:contains('toes')"
+        />
+    </x:scenario>
+
+
     <x:variable name="txt-xsl-transformation-id" as="xs:string" select="'media-type-tei2txt'"/>
 
     <x:scenario label="chained tei2txt.xsl">
@@ -51,6 +85,9 @@
         <x:param name="media-type-processor" select="'tei'"/>
         <x:context href="../../test/media-type/tei2txt.xsl"/>
         <x:expect label="transformation ID" test="map:contains(., $txt-xsl-transformation-id)"/>
+        <x:expect label="uses tree.xsl as library"
+            test=". => map:get($txt-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') eq '../xsl/tree.xsl' }) => array:size()"
+            select="1"/>
         <x:expect label="compiles the media-type package as a library"
             test=". => map:get($txt-xsl-transformation-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => ends-with('tei2txt.xsl') }) => array:size()"
             as="xs:integer" select="1"/>
diff --git a/test/media-type/a.xsl b/test/media-type/a.xsl
new file mode 100644
index 0000000..65fb311
--- /dev/null
+++ b/test/media-type/a.xsl
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:package name="http://example.com/xsl/a" package-version="1.0.0"
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    exclude-result-prefixes="#all" version="3.0" default-mode="identity">
+
+    <xsl:param name="fingers" as="xs:integer" select="10"/>
+
+    <xsl:use-package name="http://example.com/xsl/b" package-version="1.0.0"/>
+
+    <xsl:mode name="identity" on-no-match="shallow-copy"/>
+
+</xsl:package>
diff --git a/test/media-type/b.xsl b/test/media-type/b.xsl
new file mode 100644
index 0000000..3ff2b66
--- /dev/null
+++ b/test/media-type/b.xsl
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:package name="http://example.com/xsl/b" package-version="1.0.0"
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    exclude-result-prefixes="#all" version="3.0">
+
+    <xsl:param name="toes" as="xs:integer" select="10"/>
+
+</xsl:package>
diff --git a/test/saxon.xml b/test/saxon.xml
index 2287dc0..b0fed8e 100644
--- a/test/saxon.xml
+++ b/test/saxon.xml
@@ -45,6 +45,8 @@ This configuration
             sourceLocation="media-type/id.xsl"/>
         <package name="http://example.com/xsl/tei2txt" version="1.0.0"
             sourceLocation="media-type/tei2txt.xsl"/>
+        <package name="http://example.com/xsl/a" version="1.0.0" sourceLocation="media-type/a.xsl"/>
+        <package name="http://example.com/xsl/b" version="1.0.0" sourceLocation="media-type/b.xsl"/>
     </xsltPackages>
 
 </configuration>

From a15f8f7ababd4e155811e46d3f51c048123a9d44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 18:50:23 +0200
Subject: [PATCH 10/28] makes tests for SEED configuration generation pass
 again

---
 distribution/seed/seed-config.xsl | 37 ++++++++++++++++++++-----------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/distribution/seed/seed-config.xsl b/distribution/seed/seed-config.xsl
index 4a4b964..565ef22 100644
--- a/distribution/seed/seed-config.xsl
+++ b/distribution/seed/seed-config.xsl
@@ -59,6 +59,8 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
                 }
             }"/>
 
+    <xsl:param name="fail-on-package-not-found" as="xs:boolean" select="true()" static="true"/>
+
     <xsl:variable name="saxon-config" select="doc($saxon-config-uri)"/>
 
 
@@ -179,20 +181,29 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         <xsl:apply-templates mode="#current" select="doc(resolve-uri(@href, base-uri(.)))"/>
     </xsl:template>
 
-    <xsl:template mode="libraries stylesheet-params" match="use-package">
+    <!-- just match use-package with name and version, but not with compile-time name and version -->
+    <xsl:template mode="libraries stylesheet-params" match="use-package[@name and @package-version]">
         <xsl:variable name="pkg" as="element(cfg:package)?"
-            select="seed:configured-package(@name, @version, $saxon-config)"/>
-        <xsl:if test="$pkg">
-            <xsl:variable name="package" as="document-node()" select="seed:read-package($pkg)"/>
-            <!-- make entry for this package -->
-            <xsl:apply-templates mode="#current" select="$pkg">
-                <xsl:with-param name="name" select="$pkg/@name" tunnel="true"/>
-                <xsl:with-param name="version" select="$pkg/@version" tunnel="true"/>
-                <xsl:with-param name="package" select="$package" tunnel="true"/>
-            </xsl:apply-templates>
-            <!-- recurse into packages used by the package -->
-            <xsl:apply-templates mode="#current" select="$package"/>
-        </xsl:if>
+            select="seed:configured-package(@name, @package-version, $saxon-config)"/>
+        <xsl:choose>
+            <xsl:when test="$pkg">
+                <xsl:variable name="package" as="document-node()" select="seed:read-package($pkg)"/>
+                <!-- make entry for this package -->
+                <xsl:apply-templates mode="#current" select="$pkg">
+                    <xsl:with-param name="name" select="$pkg/@name" tunnel="true"/>
+                    <xsl:with-param name="version" select="$pkg/@version" tunnel="true"/>
+                    <xsl:with-param name="package" select="$package" tunnel="true"/>
+                </xsl:apply-templates>
+                <!-- recurse into packages used by the package -->
+                <xsl:apply-templates mode="#current" select="$package"/>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:message _terminate="{$fail-on-package-not-found}">
+                    <xsl:text>package not found: </xsl:text>
+                    <xsl:value-of select="concat(@name, ' (', @package-version, ')')"/>
+                </xsl:message>
+            </xsl:otherwise>
+        </xsl:choose>
     </xsl:template>
 
     <xsl:template name="seed:package-with-mode" visibility="final">

From c6853c6bb9cbccc78f179fe5cdc46a6088f72881 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 18:51:30 +0200
Subject: [PATCH 11/28] adds command line equivalent for debugging

---
 distribution/seed/seed-config-chain.xspec | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/distribution/seed/seed-config-chain.xspec b/distribution/seed/seed-config-chain.xspec
index 2b9a833..016cf72 100644
--- a/distribution/seed/seed-config-chain.xspec
+++ b/distribution/seed/seed-config-chain.xspec
@@ -7,6 +7,10 @@
 
     <x:variable name="id-xsl-transformation-id" as="xs:string" select="'media-type-id'"/>
 
+    <!--
+        command line equivalent:
+        target/bin/xslt.sh -xsl:distribution/seed/seed-config-chain.xsl -s:test/media-type/id.xsl saxon-config-uri=$(realpath test/saxon.xml ) media-type-package='http://example.com/xsl/identity'
+    -->
     <x:scenario label="chained id.xsl">
         <x:param name="saxon-config-uri" select="'../../test/saxon.xml'"/>
         <x:param name="media-type-package" select="'http://example.com/xsl/identity'"/>

From 47e972fa47330868b13a66979c13cfe554684b70 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 18:56:49 +0200
Subject: [PATCH 12/28] removes debugging messages

---
 distribution/seed/seed-config-chain.xsl | 2 --
 distribution/seed/seed-config.xsl       | 3 ---
 2 files changed, 5 deletions(-)

diff --git a/distribution/seed/seed-config-chain.xsl b/distribution/seed/seed-config-chain.xsl
index a51b027..9bdff2a 100644
--- a/distribution/seed/seed-config-chain.xsl
+++ b/distribution/seed/seed-config-chain.xsl
@@ -95,7 +95,6 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     </xsl:template>
 
     <xsl:template match="document-node()">
-        <xsl:message>document-node in default mode</xsl:message>
         <xsl:map>
             <xsl:variable name="relative-path"
                 select="seed:configured-package($media-type-package, $media-type-package-version, $saxon-config)/@sourceLocation"/>
@@ -112,7 +111,6 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
 
     <xsl:template name="seed:libraries" as="item()">
         <xsl:param name="stylesheet" as="document-node()" select="."/>
-        <xsl:message>NT seed:libraries overwrite</xsl:message>
         <xsl:map-entry key="'libraries'">
             <xsl:variable name="libs" as="map(*)*">
                 <xsl:apply-templates mode="libraries" select="$stylesheet"/>
diff --git a/distribution/seed/seed-config.xsl b/distribution/seed/seed-config.xsl
index 565ef22..39da64a 100644
--- a/distribution/seed/seed-config.xsl
+++ b/distribution/seed/seed-config.xsl
@@ -80,7 +80,6 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     </xsl:template>
 
     <xsl:template match="document-node()">
-        <xsl:message>document-node in default mode</xsl:message>
         <xsl:map>
             <xsl:variable name="relative-path"
                 select="substring(base-uri(), string-length(resolve-uri('.', $base-uri)) + 1)"/>
@@ -97,7 +96,6 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     <xsl:template match="document-node()" mode="transformation">
         <xsl:param name="transformation-id" as="xs:string" tunnel="true"/>
         <xsl:param name="location" as="xs:string" tunnel="true"/>
-        <xsl:message>document-node in mode transformation</xsl:message>
         <xsl:variable name="stylesheet" as="document-node()" select="."/>
         <xsl:map-entry key="$transformation-id">
             <xsl:map>
@@ -147,7 +145,6 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
 
     <xsl:template name="seed:libraries" as="item()">
         <xsl:param name="stylesheet" as="document-node()" select="."/>
-        <xsl:message>NT seed:libraries</xsl:message>
         <xsl:map-entry key="'libraries'">
             <xsl:variable name="libs" as="map(*)*">
                 <xsl:apply-templates mode="libraries" select="$stylesheet"/>

From 10b6ddbdf3238a6390fcc7c20a45cc5f4ef6a5af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 19:08:08 +0200
Subject: [PATCH 13/28] updates the documentation of SEED config generation

---
 distribution/seed/seed-config-chain.xsl | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/distribution/seed/seed-config-chain.xsl b/distribution/seed/seed-config-chain.xsl
index 9bdff2a..de42355 100644
--- a/distribution/seed/seed-config-chain.xsl
+++ b/distribution/seed/seed-config-chain.xsl
@@ -1,21 +1,18 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- Generate a configuration file for the SEED XML Transformer
+<!-- Generate a configuration file for the SEED XC DTS REST API
 
-The transformations given as the "transformation" parameter is
-resolved relative to the URI given in the transformation-saxon-config-uri. The
-saxon-config-uri is resolved relative to the stylesheet URI, aka
-as static-base-uri().
-
-The parameter upload-uri can be used to set a base URL for all
-relevant locations.
+This transformations makes configuration for transformations chained (internally)
+to document.xsl. The chained package must be given as source and as the
+'media-type-package' parameter. The other `media-type-*' parameters in document.xsl
+are used to set the chained process.
 
 USAGE EXAMPLES:
 
-target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl -s:xsl/projects/alea/prose-page saxon-config-uri=../../saxon.xml
-
-target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl -it saxon-config-uri=../../saxon.xml transformations=xsl/projects/alea/prose-page.xsl
-
-target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https://scdh.zivgitlabpages.uni-muenster.de/tei-processing/seed-tei-transformations/saxon.xml transformations=xsl/projects/alea/prose-page.xsl -it
+target/bin/xslt.sh \
+    -xsl:distribution/seed/seed-config-chain.xsl \
+    -s:test/media-type/id.xsl \
+    saxon-config-uri=$(realpath test/saxon.xml ) \
+    media-type-package='http://example.com/xsl/identity'
 
 -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

From c584128b257685279838e7bb78975d4a74e9ef18 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Thu, 4 Jun 2026 22:21:30 +0200
Subject: [PATCH 14/28] merge SEED configurations in JSON format and include it
 into package

---
 distribution/seed/assembly.xml | 14 ++++++++++++
 distribution/seed/merge.xsl    | 39 ++++++++++++++++++++++++++++++++++
 pom.xml                        | 27 ++++++++++++++++++++---
 3 files changed, 77 insertions(+), 3 deletions(-)
 create mode 100644 distribution/seed/merge.xsl

diff --git a/distribution/seed/assembly.xml b/distribution/seed/assembly.xml
index f2fe437..37a92a4 100644
--- a/distribution/seed/assembly.xml
+++ b/distribution/seed/assembly.xml
@@ -37,6 +37,13 @@
             <exclude>wiki/**</exclude>
          </excludes>
       </fileSet>
+      <fileSet>
+         <directory>${project.build.directory}/generated-resources/xml/xslt</directory>
+         <outputDirectory>/${project.artifactId}</outputDirectory>
+         <includes>
+            <include>**/*.seed.json</include>
+         </includes>
+      </fileSet>
       <fileSet>
          <!-- include all dependencies unpacked in target/dependencies -->
          <directory>target/dependencies</directory>
@@ -85,4 +92,11 @@
       </fileSet>
    </fileSets>
 
+   <files>
+      <file>
+         <source>${project.build.directory}/generated-resources/xml/xslt/pom.json</source>
+         <destName>${project.artifactId}.json</destName>
+      </file>
+   </files>
+
 </assembly>
diff --git a/distribution/seed/merge.xsl b/distribution/seed/merge.xsl
new file mode 100644
index 0000000..eeff083
--- /dev/null
+++ b/distribution/seed/merge.xsl
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map" exclude-result-prefixes="#all"
+    version="3.0">
+
+    <xsl:output method="json" indent="true"/>
+
+    <xsl:param name="json-files-csv" as="xs:string?" select="()"/>
+
+    <xsl:param name="json-collection" as="xs:anyURI?" select="()"/>
+
+    <xsl:param name="json-files" as="xs:string*">
+        <xsl:choose>
+            <xsl:when test="$json-files-csv">
+                <xsl:sequence select="tokenize($json-files-csv, ',')"/>
+            </xsl:when>
+            <xsl:when test="$json-collection">
+                <xsl:message>
+                    <xsl:text>collection URI: </xsl:text>
+                    <xsl:value-of select="$json-collection"/>
+                </xsl:message>
+                <xsl:sequence select="uri-collection($json-collection)"/>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:message terminate="yes">No JSON files</xsl:message>
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:param>
+
+    <xsl:template match="document-node()">
+        <xsl:message>
+            <xsl:text>JSON files: </xsl:text>
+            <xsl:value-of select="$json-files"/>
+        </xsl:message>
+        <xsl:sequence select="($json-files ! unparsed-text(.) ! parse-json(.)) => map:merge()"/>
+    </xsl:template>
+
+</xsl:stylesheet>
diff --git a/pom.xml b/pom.xml
index e6a9de1..1e5ee89 100644
--- a/pom.xml
+++ b/pom.xml
@@ -28,6 +28,7 @@
 
         <!-- XSLT resources for generating the configuration for the SEED distribution -->
         <seed-config-xsl.url>${project.basedir}/distribution/seed/seed-config.xsl</seed-config-xsl.url>
+        <seed-merge-xsl.url>${project.basedir}/distribution/seed/merge.xsl</seed-merge-xsl.url>
         <sef-config-xsl.url>${project.basedir}/distribution/seed/sef-config.xsl</sef-config-xsl.url>
 
         <!-- SEF package -->
@@ -402,7 +403,7 @@
                                         </fileMapper>
                                     </fileMappers>
                                 </transformationSet>
-                                
+
                                 <!-- an example with prioritized package -->
                                 <!--
                                 <transformationSet>
@@ -462,6 +463,26 @@
                                         </parameter>
                                     </parameters>
                                     <stylesheet>${seed-config-xsl.url}</stylesheet>
+                                    <fileMappers>
+                                        <fileMapper
+                                            implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
+                                            <targetExtension>.seed.json</targetExtension>
+                                        </fileMapper>
+                                    </fileMappers>
+                                </transformationSet>
+                                <transformationSet>
+                                    <!-- merge SEED configurations -->
+                                    <dir>${project.basedir}</dir>
+                                    <includes>
+                                        <include>pom.xml</include>
+                                    </includes>
+                                    <parameters>
+                                        <parameter>
+                                            <name>json-collection</name>
+                                            <value>file:${project.build.directory}/generated-resources?select=*.seed.json;recurse=yes</value>
+                                        </parameter>
+                                    </parameters>
+                                    <stylesheet>${seed-merge-xsl.url}</stylesheet>
                                     <fileMappers>
                                         <fileMapper
                                             implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
@@ -500,7 +521,7 @@
                                     <directory>${project.build.directory}/generated-resources/xml/xslt</directory>
                                     <filtering>false</filtering>
                                     <includes>
-                                        <include>**/*.json</include>
+                                        <include>**/*.seed.json</include>
                                     </includes>
                                 </resource>
                             </resources>
@@ -520,7 +541,7 @@
                                     <directory>${project.build.directory}/generated-resources/xml/xslt</directory>
                                     <filtering>false</filtering>
                                     <includes>
-                                        <include>**/*.json</include>
+                                        <include>**/*.seed.json</include>
                                     </includes>
                                 </resource>
                             </resources>

From 89f71f639ad911c25dd350d57e742b60e0545656 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 09:56:26 +0200
Subject: [PATCH 15/28] adds named template and function as entry points for
 generating config

---
 distribution/seed/seed-config.xsl   | 23 ++++++++++++++++++++--
 distribution/seed/seed-config.xspec | 30 +++++++++++++++++++++++++++--
 2 files changed, 49 insertions(+), 4 deletions(-)

diff --git a/distribution/seed/seed-config.xsl b/distribution/seed/seed-config.xsl
index 39da64a..897fa0c 100644
--- a/distribution/seed/seed-config.xsl
+++ b/distribution/seed/seed-config.xsl
@@ -64,8 +64,8 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
     <xsl:variable name="saxon-config" select="doc($saxon-config-uri)"/>
 
 
-
-    <xsl:template name="xsl:initial-template">
+    <!-- entry point for running the processor with an initial template -->
+    <xsl:template name="xsl:initial-template" visibility="final">
         <xsl:map>
             <xsl:for-each select="$transformations">
                 <xsl:variable name="location" select="resolve-uri(., $base-uri)"/>
@@ -79,6 +79,23 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         </xsl:map>
     </xsl:template>
 
+
+    <!-- entry point for running the processor with an initial function -->
+    <xsl:function name="seed:mk-config" visibility="final">
+        <xsl:map>
+            <xsl:for-each select="$transformations">
+                <xsl:variable name="location" select="resolve-uri(., $base-uri)"/>
+                <xsl:variable name="stylesheet" as="document-node()" select="doc($location)"/>
+                <xsl:apply-templates select="$stylesheet" mode="transformation">
+                    <xsl:with-param name="transformation-id" tunnel="true"
+                        select="seed:get-transformation-id(., $stylesheet)"/>
+                    <xsl:with-param name="location" tunnel="true" select="."/>
+                </xsl:apply-templates>
+            </xsl:for-each>
+        </xsl:map>
+    </xsl:function>
+
+    <!-- entry point for generating a config for the transformation given as source -->
     <xsl:template match="document-node()">
         <xsl:map>
             <xsl:variable name="relative-path"
@@ -91,6 +108,8 @@ target/bin/xslt.sh -xsl:distribution/seed/seed-config.xsl saxon-config-uri=https
         </xsl:map>
     </xsl:template>
 
+
+    <!-- the mode 'transformation' run on a package or stylesheet acually does the job -->
     <xsl:mode name="transformation" on-no-match="shallow-skip"/>
 
     <xsl:template match="document-node()" mode="transformation">
diff --git a/distribution/seed/seed-config.xspec b/distribution/seed/seed-config.xspec
index 96cb799..cdc0403 100644
--- a/distribution/seed/seed-config.xspec
+++ b/distribution/seed/seed-config.xspec
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <x:description xmlns:x="http://www.jenitennison.com/xslt/xspec"
-    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
     xmlns:map="http://www.w3.org/2005/xpath-functions/map"
     xmlns:array="http://www.w3.org/2005/xpath-functions/array" stylesheet="seed-config.xsl"
-    run-as="external">
+    xmlns:seed="http://scdh.wwu.de/transform/seed#" run-as="external">
 
     <x:param name="id-prefix">dts</x:param>
 
@@ -34,4 +34,30 @@
         />
     </x:scenario>
 
+    <x:scenario label="config for document.xsl by seed:mk-config#0">
+        <x:param name="saxon-config-uri" select="'../../saxon.xml'"/>
+        <x:param name="transformations" select="'xsl/document.xsl'"/>
+        <x:call function="seed:mk-config"/>
+        <x:expect label="config has dts-xsl-document transformation"
+            test="map:contains(., 'dts-xsl-document')"/>
+        <x:expect label="has stylesheet location"
+            test="map:get(., 'dts-xsl-document') => map:get('location')"
+            select="'dts/xsl/document.xsl'"/>
+        <x:expect label="transforms to text/xml"
+            test="map:get(., 'dts-xsl-document') => map:get('mediaType')" select="'text/xml'"/>
+    </x:scenario>
+
+    <x:scenario label="config for document.xsl by initial template">
+        <x:param name="saxon-config-uri" select="'../../saxon.xml'"/>
+        <x:param name="transformations" select="'xsl/document.xsl'"/>
+        <x:call template="xsl:initial-template"/>
+        <x:expect label="config has dts-xsl-document transformation"
+            test="map:contains(., 'dts-xsl-document')"/>
+        <x:expect label="has stylesheet location"
+            test="map:get(., 'dts-xsl-document') => map:get('location')"
+            select="'dts/xsl/document.xsl'"/>
+        <x:expect label="transforms to text/xml"
+            test="map:get(., 'dts-xsl-document') => map:get('mediaType')" select="'text/xml'"/>
+    </x:scenario>
+
 </x:description>

From 950ddf954f577860a71c35e1069681682dffe0bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 12:51:17 +0200
Subject: [PATCH 16/28] XSLT for making chained configs from JSON configs

---
 distribution/seed/chain.xsl   | 72 +++++++++++++++++++++++++++++++++++
 distribution/seed/chain.xspec | 48 +++++++++++++++++++++++
 2 files changed, 120 insertions(+)
 create mode 100644 distribution/seed/chain.xsl
 create mode 100644 distribution/seed/chain.xspec

diff --git a/distribution/seed/chain.xsl b/distribution/seed/chain.xsl
new file mode 100644
index 0000000..3a6072f
--- /dev/null
+++ b/distribution/seed/chain.xsl
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Merges SEED configuration files in JSON format
+
+USAGE:
+target/bin/xslt.sh \
+    -xsl:distribution/seed/merge.xsl \
+    -s:pom.xml \
+    json-collection="file:$(realpath target/generated-resources/)?select=*.seed.json;recurse=yes"
+
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map"
+    xmlns:array="http://www.w3.org/2005/xpath-functions/array"
+    xmlns:seed="http://scdh.wwu.de/transform/seed#" exclude-result-prefixes="#all" version="3.0">
+
+    <xsl:output method="json" indent="true"/>
+
+    <xsl:param name="document-config" as="xs:string" required="true"/>
+
+    <xsl:param name="chained-config" as="xs:string" required="true"/>
+
+    <!-- set this to the empty string or () if you do not want pass on to a mediaType processor -->
+    <xsl:param name="media-type-package" as="xs:string" required="true"/>
+
+    <!-- version of the mediaType processor package -->
+    <xsl:param name="media-type-package-version" as="xs:string" select="'1.0.0'"/>
+
+    <!-- should be 'template', 'mode', or 'function' -->
+    <xsl:param name="media-type-component" as="xs:string" select="'template'"/>
+
+    <!-- name of the template, mode or function used as an entry point for mediaType processing -->
+    <xsl:param name="media-type-processor" as="xs:string" select="'post-proc'"/>
+
+
+    <xsl:template match="document-node()">
+        <xsl:sequence select="seed:merge()"/>
+    </xsl:template>
+
+    <xsl:template name="xsl:initial-template">
+        <xsl:sequence select="seed:merge()"/>
+    </xsl:template>
+
+    <xsl:function name="seed:merge" as="map(xs:string, item()*)">
+        <xsl:sequence select="
+                (
+                $document-config => unparsed-text() => parse-json(),
+                $chained-config => unparsed-text() => parse-json() => seed:as-library()
+                ) => map:merge()"/>
+    </xsl:function>
+
+    <xsl:function name="seed:as-library" as="map(xs:string, item()*)" visibility="final">
+        <xsl:param name="config" as="map(xs:string, item()*)"/>
+        <xsl:variable name="transformation-id" as="xs:string" select="map:keys($config)[1]"/>
+        <xsl:variable name="transformation" as="map(*)"
+            select="map:get($config, $transformation-id)"/>
+        <xsl:variable name="stylesheet" as="map(*)" select="
+                (
+                map:entry('location', map:get($transformation, 'location')),
+                map:entry('asName', $media-type-package),
+                map:entry('asVersion', $media-type-package-version)
+                ) => map:merge()"/>
+        <xsl:variable name="libraries" as="array(*)"
+            select="array:join((array {$stylesheet}, map:get($transformation, 'libraries')))"/>
+        <xsl:map>
+            <xsl:map-entry key="'libraries'" select="$libraries"/>
+            <xsl:map-entry key="'parameterDescriptors'"
+                select="map:get($transformation, 'parameterDescriptors')"/>
+        </xsl:map>
+    </xsl:function>
+
+</xsl:stylesheet>
diff --git a/distribution/seed/chain.xspec b/distribution/seed/chain.xspec
new file mode 100644
index 0000000..17f8b1e
--- /dev/null
+++ b/distribution/seed/chain.xspec
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<x:description xmlns:x="http://www.jenitennison.com/xslt/xspec"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map"
+    xmlns:array="http://www.w3.org/2005/xpath-functions/array"
+    xmlns:seed="http://scdh.wwu.de/transform/seed#" stylesheet="chain.xsl" run-as="external">
+
+    <x:helper stylesheet="seed-config.xsl"/>
+
+    <x:param name="saxon-config-uri" select="'../../saxon.xml'"/>
+    <x:param name="transformations" select="'xsl/document.xsl'"/>
+    <x:variable name="document.json" select="seed:mk-config()"/>
+
+
+    <x:scenario label="seed:as-library">
+        <x:param name="document-config" as="xs:string" select="''"/>
+        <x:param name="chained-config" as="xs:string" select="''"/>
+        <x:param name="media-type-package" as="xs:string" select="'http://th.is'"/>
+        <x:call function="seed:as-library">
+            <x:param as="map(*)" select="$document.json"/>
+        </x:call>
+        <x:expect label="keeps transformation id" test="map:contains(., 'libraries')"/>
+        <x:expect label="document.xsl entry package in libraries"
+            test="map:get(., 'libraries') => array:filter(function ($x) {map:get($x, 'location') => ends-with('document.xsl')}) => array:size()"
+            select="1"/>
+        <x:expect label="one more libraries than before"
+            test="map:get(., 'libraries') => array:size()"
+            select="map:get($document.json, 'xsl-document') => map:get('libraries') => array:size() + 1"/>
+        <x:expect label="document.xsl is first library"
+            test="map:get(., 'libraries') => array:get(1) => map:get('location')"
+            select="'xsl/document.xsl'"/>
+        <x:expect label="library as name"
+            test="map:get(., 'libraries') => array:get(1) => map:get('asName')"
+            select="'http://th.is'"/>
+        <x:expect label="library as version"
+            test="map:get(., 'libraries') => array:get(1) => map:get('asVersion')" select="'1.0.0'"/>
+        <x:expect label="has parameter descriptors property"
+            test="map:contains(., 'parameterDescriptors')"/>
+        <x:expect label="same number of parameter descriptors"
+            test="map:get(., 'parameterDescriptors') => map:size()"
+            select="map:get($document.json, 'xsl-document') => map:get('parameterDescriptors') => map:size()"
+        />
+    </x:scenario>
+
+
+
+
+</x:description>

From 298a5e31b84ba631405a2e7b90000983ca8585aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 22:44:17 +0200
Subject: [PATCH 17/28] refactoring to prepare merging of document and chained
 XSLT

---
 build.xml                     |  7 +++++
 distribution/seed/chain.xsl   | 57 ++++++++++++++++++++++++++---------
 distribution/seed/chain.xspec |  4 +--
 3 files changed, 52 insertions(+), 16 deletions(-)

diff --git a/build.xml b/build.xml
index 1026b31..bca8976 100644
--- a/build.xml
+++ b/build.xml
@@ -30,6 +30,7 @@
         <!-- testing utils -->
         <antcall target="test-distribution-seed-seed-config.xsl"/>
         <antcall target="test-distribution-seed-seed-config-chain.xsl"/>
+        <antcall target="test-distribution-seed-chain.xsl"/>
     </target>
 
     <target name="test-xsl-dts.xsl">
@@ -88,6 +89,12 @@
         </antcall>
     </target>
 
+    <target name="test-distribution-seed-chain.xsl">
+        <antcall target="xspec.xspec" inheritall="false">
+            <param name="xspec.xml" location="${basedir}/distribution/seed/chain.xspec"/>
+        </antcall>
+    </target>
+
     <target name="test-distribution-seed-seed-config-chain.xsl">
         <antcall target="xspec.xspec" inheritall="false">
             <param name="xspec.xml" location="${basedir}/distribution/seed/seed-config-chain.xspec"
diff --git a/distribution/seed/chain.xsl b/distribution/seed/chain.xsl
index 3a6072f..3503d34 100644
--- a/distribution/seed/chain.xsl
+++ b/distribution/seed/chain.xsl
@@ -1,11 +1,13 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- Merges SEED configuration files in JSON format
+<!-- Makes a SEED configuration from the document config and a config of a transformation to be chained to it
 
 USAGE:
 target/bin/xslt.sh \
-    -xsl:distribution/seed/merge.xsl \
-    -s:pom.xml \
-    json-collection="file:$(realpath target/generated-resources/)?select=*.seed.json;recurse=yes"
+    -xsl:distribution/seed/chain.xsl \
+    -it \
+    document-config-uri=PATH_TO_DOCUMENT.json \
+    chained-config-uri=PATH_TO_CHAINED.json \
+    media-type-package=CHAINED_PACKAGE_NAME
 
 -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
@@ -16,9 +18,24 @@ target/bin/xslt.sh \
 
     <xsl:output method="json" indent="true"/>
 
-    <xsl:param name="document-config" as="xs:string" required="true"/>
+    <!-- PATH to JSON config file for XSLT for document endpoint -->
+    <xsl:param name="document-config-uri" as="xs:string" required="true"/>
 
-    <xsl:param name="chained-config" as="xs:string" required="true"/>
+    <xsl:param name="document-config" as="map(*)"
+        select="$document-config-uri => unparsed-text() => parse-json()"/>
+
+    <!-- PATH to JSON config file fof XSLT to be chained to document endpoint XSLT -->
+    <xsl:param name="chained-config-uri" as="xs:string" required="true"/>
+
+    <xsl:param name="chained-config" as="map(*)"
+        select="$chained-config-uri => unparsed-text() => parse-json()"/>
+
+    <!-- name (ID) of the resulting transformation -->
+    <xsl:param name="name" as="xs:string">
+        <xsl:value-of
+            select="seed:transformation-id($document-config) || '+' || seed:transformation-id($chained-config)"
+        />
+    </xsl:param>
 
     <!-- set this to the empty string or () if you do not want pass on to a mediaType processor -->
     <xsl:param name="media-type-package" as="xs:string" required="true"/>
@@ -41,19 +58,31 @@ target/bin/xslt.sh \
         <xsl:sequence select="seed:merge()"/>
     </xsl:template>
 
+
+
     <xsl:function name="seed:merge" as="map(xs:string, item()*)">
-        <xsl:sequence select="
-                (
-                $document-config => unparsed-text() => parse-json(),
-                $chained-config => unparsed-text() => parse-json() => seed:as-library()
-                ) => map:merge()"/>
+        <xsl:map>
+            <xsl:map-entry key="$name">
+                <xsl:sequence select="
+                        ($document-config => seed:bare-config(), $chained-config => seed:as-library()) => map:merge()"
+                />
+            </xsl:map-entry>
+        </xsl:map>
+    </xsl:function>
+
+    <xsl:function name="seed:transformation-id" as="xs:string">
+        <xsl:param name="named-config" as="map(xs:string, map(xs:string, item()*))"/>
+        <xsl:value-of select="map:keys($named-config)[1]"/>
+    </xsl:function>
+
+    <xsl:function name="seed:bare-config" as="map(xs:string, item()*)">
+        <xsl:param name="named-config" as="map(xs:string, map(xs:string, item()*))"/>
+        <xsl:sequence select="map:get($named-config, seed:transformation-id($named-config))"/>
     </xsl:function>
 
     <xsl:function name="seed:as-library" as="map(xs:string, item()*)" visibility="final">
         <xsl:param name="config" as="map(xs:string, item()*)"/>
-        <xsl:variable name="transformation-id" as="xs:string" select="map:keys($config)[1]"/>
-        <xsl:variable name="transformation" as="map(*)"
-            select="map:get($config, $transformation-id)"/>
+        <xsl:variable name="transformation" as="map(*)" select="seed:bare-config($config)"/>
         <xsl:variable name="stylesheet" as="map(*)" select="
                 (
                 map:entry('location', map:get($transformation, 'location')),
diff --git a/distribution/seed/chain.xspec b/distribution/seed/chain.xspec
index 17f8b1e..aacfa9c 100644
--- a/distribution/seed/chain.xspec
+++ b/distribution/seed/chain.xspec
@@ -13,8 +13,8 @@
 
 
     <x:scenario label="seed:as-library">
-        <x:param name="document-config" as="xs:string" select="''"/>
-        <x:param name="chained-config" as="xs:string" select="''"/>
+        <x:param name="document-config-uri" as="xs:string" select="''"/>
+        <x:param name="chained-config-uri" as="xs:string" select="''"/>
         <x:param name="media-type-package" as="xs:string" select="'http://th.is'"/>
         <x:call function="seed:as-library">
             <x:param as="map(*)" select="$document.json"/>

From 415fd73e96a53fa4f02f2c4dbd24a15291200f1d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 23:05:25 +0200
Subject: [PATCH 18/28] adds regression test for merging SEED JSON
 configurations

---
 build.xml                     |  7 +++++++
 distribution/seed/merge.xsl   | 23 +++++++++++++++++++++--
 distribution/seed/merge.xspec | 17 +++++++++++++++++
 3 files changed, 45 insertions(+), 2 deletions(-)
 create mode 100644 distribution/seed/merge.xspec

diff --git a/build.xml b/build.xml
index bca8976..ba30e47 100644
--- a/build.xml
+++ b/build.xml
@@ -30,6 +30,7 @@
         <!-- testing utils -->
         <antcall target="test-distribution-seed-seed-config.xsl"/>
         <antcall target="test-distribution-seed-seed-config-chain.xsl"/>
+        <antcall target="test-distribution-seed-merge.xsl"/>
         <antcall target="test-distribution-seed-chain.xsl"/>
     </target>
 
@@ -89,6 +90,12 @@
         </antcall>
     </target>
 
+    <target name="test-distribution-seed-merge.xsl">
+        <antcall target="xspec.xspec" inheritall="false">
+            <param name="xspec.xml" location="${basedir}/distribution/seed/merge.xspec"/>
+        </antcall>
+    </target>
+
     <target name="test-distribution-seed-chain.xsl">
         <antcall target="xspec.xspec" inheritall="false">
             <param name="xspec.xml" location="${basedir}/distribution/seed/chain.xspec"/>
diff --git a/distribution/seed/merge.xsl b/distribution/seed/merge.xsl
index eeff083..3c4b312 100644
--- a/distribution/seed/merge.xsl
+++ b/distribution/seed/merge.xsl
@@ -1,4 +1,13 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!-- Merges SEED configuration files in JSON format
+
+USAGE:
+target/bin/xslt.sh \
+    -xsl:distribution/seed/merge.xsl \
+    -s:pom.xml \
+    json-collection="file:$(realpath target/generated-resources/)?select=*.seed.json;recurse=yes"
+
+-->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
     xmlns:xs="http://www.w3.org/2001/XMLSchema"
     xmlns:map="http://www.w3.org/2005/xpath-functions/map" exclude-result-prefixes="#all"
@@ -10,10 +19,12 @@
 
     <xsl:param name="json-collection" as="xs:anyURI?" select="()"/>
 
+    <xsl:param name="base" as="xs:string?" select=". ! base-uri(.)"/>
+
     <xsl:param name="json-files" as="xs:string*">
         <xsl:choose>
-            <xsl:when test="$json-files-csv">
-                <xsl:sequence select="tokenize($json-files-csv, ',')"/>
+            <xsl:when test="$json-files-csv and $base and $base ne ''">
+                <xsl:sequence select="tokenize($json-files-csv, ',') ! resolve-uri(., $base)"/>
             </xsl:when>
             <xsl:when test="$json-collection">
                 <xsl:message>
@@ -36,4 +47,12 @@
         <xsl:sequence select="($json-files ! unparsed-text(.) ! parse-json(.)) => map:merge()"/>
     </xsl:template>
 
+    <xsl:template name="xsl:initial-template">
+        <xsl:message>
+            <xsl:text>JSON files: </xsl:text>
+            <xsl:value-of select="$json-files"/>
+        </xsl:message>
+        <xsl:sequence select="($json-files ! unparsed-text(.) ! parse-json(.)) => map:merge()"/>
+    </xsl:template>
+
 </xsl:stylesheet>
diff --git a/distribution/seed/merge.xspec b/distribution/seed/merge.xspec
new file mode 100644
index 0000000..8914fd0
--- /dev/null
+++ b/distribution/seed/merge.xspec
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<x:description xmlns:x="http://www.jenitennison.com/xslt/xspec"
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map"
+    xmlns:array="http://www.w3.org/2005/xpath-functions/array"
+    xmlns:seed="http://scdh.wwu.de/transform/seed#" stylesheet="merge.xsl" run-as="external">
+
+    <x:scenario label="merge json collection">
+        <x:param name="json-collection"
+            select="xs:anyURI('../../target/generated-resources/xml/xslt/xsl?select=*.seed.json')"/>
+        <x:call template="xsl:initial-template"/>
+        <x:expect label="result is a map with two entries" test="map:size(.)" select="2"/>
+        <x:expect label="the map's property names are the transformations IDs" test="map:keys(.)"
+            select="('dts-transformations-xsl-document', 'dts-transformations-xsl-navigation')"/>
+    </x:scenario>
+
+</x:description>

From 5a20212383e42b5365d12f084f931394011ff92e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 23:10:31 +0200
Subject: [PATCH 19/28] generate configuration for the chained testing XSLT

---
 pom.xml | 32 +++++++++++++++++++++++++++++---
 1 file changed, 29 insertions(+), 3 deletions(-)

diff --git a/pom.xml b/pom.xml
index 1e5ee89..7493a04 100644
--- a/pom.xml
+++ b/pom.xml
@@ -479,7 +479,7 @@
                                     <parameters>
                                         <parameter>
                                             <name>json-collection</name>
-                                            <value>file:${project.build.directory}/generated-resources?select=*.seed.json;recurse=yes</value>
+                                            <value>file:${project.build.directory}/generated-resources/xml/xslt/xsl?select=*.seed.json;recurse=yes</value>
                                         </parameter>
                                     </parameters>
                                     <stylesheet>${seed-merge-xsl.url}</stylesheet>
@@ -490,6 +490,32 @@
                                         </fileMapper>
                                     </fileMappers>
                                 </transformationSet>
+                                <transformationSet>
+                                    <!-- generate configuration for SEED XML Transformer for chained transformations in test package -->
+                                    <dir>${project.basedir}</dir>
+                                    <!-- Include every transformation resource for the SEED XML Transformer
+                                                in an <include>path</include> element! -->
+                                    <includes>
+                                        <include>test/media-type/tei2txt.xsl</include>
+                                    </includes>
+                                    <parameters>
+                                        <parameter>
+                                            <name>saxon-config-uri</name>
+                                            <value>${project.basedir}/test/saxon.xml</value>
+                                        </parameter>
+                                        <parameter>
+                                            <name>id-prefix</name>
+                                            <value>chained</value>
+                                        </parameter>
+                                    </parameters>
+                                    <stylesheet>${seed-config-xsl.url}</stylesheet>
+                                    <fileMappers>
+                                        <fileMapper
+                                            implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
+                                            <targetExtension>.seed.json</targetExtension>
+                                        </fileMapper>
+                                    </fileMappers>
+                                </transformationSet>
                             </transformationSets>
                         </configuration>
                     </execution>
@@ -518,7 +544,7 @@
                         <configuration>
                             <resources>
                                 <resource>
-                                    <directory>${project.build.directory}/generated-resources/xml/xslt</directory>
+                                    <directory>${project.build.directory}/generated-resources/xml/xslt/xsl</directory>
                                     <filtering>false</filtering>
                                     <includes>
                                         <include>**/*.seed.json</include>
@@ -538,7 +564,7 @@
                         <configuration>
                             <resources>
                                 <resource>
-                                    <directory>${project.build.directory}/generated-resources/xml/xslt</directory>
+                                    <directory>${project.build.directory}/generated-resources/xml/xslt/xsl</directory>
                                     <filtering>false</filtering>
                                     <includes>
                                         <include>**/*.seed.json</include>

From 8ffaee390674a7b46d5be4385ae622ef1ff91b16 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 23:12:19 +0200
Subject: [PATCH 20/28] adds a regression test for the testing chaining with
 tei2txt.xsl

---
 build.xml                     |  6 ++++++
 test/media-type/tei2txt.xsl   | 27 +++++++++++++++------------
 test/media-type/tei2txt.xspec | 22 ++++++++++++++++++++++
 3 files changed, 43 insertions(+), 12 deletions(-)
 create mode 100644 test/media-type/tei2txt.xspec

diff --git a/build.xml b/build.xml
index ba30e47..dfd95c7 100644
--- a/build.xml
+++ b/build.xml
@@ -82,6 +82,12 @@
         </antcall>
     </target>
 
+    <target name="test-test-media-type-tei2txt.xsl">
+        <antcall target="xspec.xspec" inheritall="false">
+            <param name="xspec.xml" location="${basedir}/test/media-type/tei2txt.xspec"/>
+        </antcall>
+    </target>
+
     <!-- tests for utils -->
 
     <target name="test-distribution-seed-seed-config.xsl">
diff --git a/test/media-type/tei2txt.xsl b/test/media-type/tei2txt.xsl
index 7fda2ff..fdfd8e0 100644
--- a/test/media-type/tei2txt.xsl
+++ b/test/media-type/tei2txt.xsl
@@ -5,26 +5,27 @@
 
   <xsl:output method="text"/>
 
-  <xsl:mode name="tei" on-no-match="shallow-skip"/>
+  <xsl:mode name="tei" on-no-match="shallow-skip" visibility="public"/>
 
-  <xsl:mode name="prose" on-no-match="shallow-skip"/>
+  <xsl:mode name="prose" on-no-match="shallow-skip" visibility="public"/>
 
-  <xsl:mode name="verse" on-no-match="shallow-skip"/>
+  <xsl:mode name="verse" on-no-match="shallow-skip" visibility="public"/>
 
-  <xsl:template mode="#all" match="TEI">
+  <xsl:template mode="tei prose verse" match="TEI">
+    <xsl:message>CHAINED PROC</xsl:message>
     <xsl:apply-templates mode="#current" select="text"/>
   </xsl:template>
 
-  <xsl:template mode="#all" match="p | ab | head">
+  <xsl:template mode="tei prose verse" match="p | ab | head">
     <xsl:apply-templates mode="prose"/>
     <xsl:text>&#xa;&#xa;</xsl:text>
   </xsl:template>
 
-  <xsl:template mode="#all" match="div | div1 | div2 | div3 | div4 | div5 | div6 | div7">
+  <xsl:template mode="tei prose verse" match="div | div1 | div2 | div3 | div4 | div5 | div6 | div7">
     <xsl:apply-templates mode="#current" select="*"/>
   </xsl:template>
 
-  <xsl:template mode="#all" match="l">
+  <xsl:template mode="tei prose verse" match="l">
     <xsl:text>&#xa;</xsl:text>
     <xsl:apply-templates mode="verse"/>
   </xsl:template>
@@ -33,21 +34,23 @@
     <xsl:text>&#x9;</xsl:text>
   </xsl:template>
 
-  <xsl:template mode="#all" match="lg">
+  <xsl:template mode="tei prose verse" match="lg">
     <xsl:text>&#xa;</xsl:text>
     <xsl:apply-templates mode="#current" select="*"/>
   </xsl:template>
 
 
-  <xsl:template mode="#all" match="app[//variantEncoding/@method eq 'parallel-segmenation']">
+  <xsl:template mode="tei prose verse"
+    match="app[//variantEncoding/@method eq 'parallel-segmenation']">
     <xsl:apply-templates mode="#current" select="lem"/>
   </xsl:template>
 
-  <xsl:template mode="#all" match="app[//variantEncoding/@method ne 'parallel-segmenation']"/>
+  <xsl:template mode="tei prose verse"
+    match="app[//variantEncoding/@method ne 'parallel-segmenation']"/>
 
-  <xsl:template mode="#all" match="note[@type eq 'editorial']"/>
+  <xsl:template mode="tei prose verse" match="note[@type eq 'editorial']"/>
 
-  <xsl:template mode="#all" match="span | interp"/>
+  <xsl:template mode="tei prose verse" match="span | interp"/>
 
 
   <!-- handling of text leafs -->
diff --git a/test/media-type/tei2txt.xspec b/test/media-type/tei2txt.xspec
new file mode 100644
index 0000000..0e36793
--- /dev/null
+++ b/test/media-type/tei2txt.xspec
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<x:description xmlns:x="http://www.jenitennison.com/xslt/xspec"
+    xmlns:map="http://www.w3.org/2005/xpath-functions/map"
+    xmlns:array="http://www.w3.org/2005/xpath-functions/array"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:dts="https://w3id.org/api/dts#"
+    xmlns:t="http://www.tei-c.org/ns/1.0" stylesheet="../../xsl/document.xsl" run-as="external">
+
+    <x:variable name="x:saxon-config" href="../saxon.xml"/>
+
+    <x:param name="media-type-package" select="'http://example.com/xsl/tei2txt'" static="true"/>
+
+    <x:param name="media-type-component" select="'mode'" static="true"/>
+
+    <x:param name="media-type-processor" select="'tei'" static="true"/>
+
+    <x:scenario label="whole doc of john as txt">
+        <x:context href="../john.xml"/>
+        <x:expect label="result"/>
+    </x:scenario>
+
+
+</x:description>

From d6d28c59d0a669f28382691520d181b032d9e63c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 23:41:41 +0200
Subject: [PATCH 21/28] assembles a chained XSLT for testing on SEED

---
 distribution/seed/test-assembly.xml | 61 +++++++++++++++++++++++++++++
 pom.xml                             | 15 +++++++
 2 files changed, 76 insertions(+)
 create mode 100644 distribution/seed/test-assembly.xml

diff --git a/distribution/seed/test-assembly.xml b/distribution/seed/test-assembly.xml
new file mode 100644
index 0000000..71c724a
--- /dev/null
+++ b/distribution/seed/test-assembly.xml
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="utf-8"?>
+<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
+   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+   xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
+   <id>seed-tests</id>
+   <includeBaseDirectory>true</includeBaseDirectory>
+   <baseDirectory/>
+
+   <formats>
+      <format>tar.gz</format>
+   </formats>
+
+   <fileSets>
+      <fileSet>
+         <directory>${project.basedir}/test</directory>
+         <outputDirectory>/${project.artifactId}-test</outputDirectory>
+         <includes>
+            <include>**/tei2txt.xsl</include>
+         </includes>
+         <excludes>
+            <exclude>post-proc-*</exclude>
+            <exclude>specs/**</exclude>
+            <exclude>**/xspec/**.xsl</exclude>
+            <exclude>distribution/**</exclude>
+            <exclude>scripts/**</exclude>
+            <exclude>doc/**</exclude>
+            <exclude>test/**</exclude>
+            <exclude>utils/**</exclude>
+            <exclude>target/**</exclude>
+            <exclude>frameworks/**</exclude>
+            <exclude>cases/**</exclude>
+            <exclude>dist/**</exclude>
+            <exclude>wiki/**</exclude>
+         </excludes>
+      </fileSet>
+      <fileSet>
+         <directory>${project.build.directory}/generated-resources/xml/xslt/test</directory>
+         <outputDirectory>/${project.artifactId}-test</outputDirectory>
+         <includes>
+            <include>**/*.seed.json</include>
+         </includes>
+      </fileSet>
+      <fileSet>
+         <directory>${project.basedir}/test</directory>
+         <outputDirectory>/${project.artifactId}-test</outputDirectory>
+         <includes>
+            <include>saxon.xml</include>
+            <include>saxon-no-local.xml</include>
+         </includes>
+      </fileSet>
+   </fileSets>
+
+   <files>
+      <file>
+         <!-- TODO: make source be the chained config -->
+         <source>${project.build.directory}/generated-resources/xml/xslt/pom.json</source>
+         <destName>${project.artifactId}-test.json</destName>
+      </file>
+   </files>
+
+</assembly>
diff --git a/pom.xml b/pom.xml
index 7493a04..547f0b6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -736,6 +736,21 @@
                             </descriptors>
                         </configuration>
                     </execution>
+                    <execution>
+                        <!-- paketize resources for the SEED XML transformer or SEED DTS -->
+                        <id>seed-test</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <finalName>${project.artifactId}-${project.version}</finalName>
+                            <archiveBaseDirectory>${project.basedir}</archiveBaseDirectory>
+                            <descriptors>
+                                <descriptor>distribution/seed/test-assembly.xml</descriptor>
+                            </descriptors>
+                        </configuration>
+                    </execution>
                 </executions>
             </plugin>
 

From d4505a1d7830b5b2429c6f4b0151746e3dea6f2a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Tue, 9 Jun 2026 23:42:35 +0200
Subject: [PATCH 22/28] exclude testing material

---
 distribution/seed/assembly.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/distribution/seed/assembly.xml b/distribution/seed/assembly.xml
index 37a92a4..07a4883 100644
--- a/distribution/seed/assembly.xml
+++ b/distribution/seed/assembly.xml
@@ -43,6 +43,9 @@
          <includes>
             <include>**/*.seed.json</include>
          </includes>
+         <excludes>
+            <exclude>test/**</exclude>
+         </excludes>
       </fileSet>
       <fileSet>
          <!-- include all dependencies unpacked in target/dependencies -->
@@ -66,6 +69,9 @@
          <includes>
             <include>saxon.*.xml</include>
          </includes>
+         <excludes>
+            <exclude>test/**</exclude>
+         </excludes>
       </fileSet>
       <fileSet>
          <directory>distribution/seed</directory>

From cd628bb84173c5f3389be70b4d245212eb94264c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Wed, 10 Jun 2026 16:58:57 +0200
Subject: [PATCH 23/28] adds a parameter that for testing purpose only

---
 test/media-type/tei2txt.xsl | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/test/media-type/tei2txt.xsl b/test/media-type/tei2txt.xsl
index fdfd8e0..7a4721c 100644
--- a/test/media-type/tei2txt.xsl
+++ b/test/media-type/tei2txt.xsl
@@ -11,6 +11,8 @@
 
   <xsl:mode name="verse" on-no-match="shallow-skip" visibility="public"/>
 
+  <xsl:param name="something" as="xs:string" select="'something'"/>
+
   <xsl:template mode="tei prose verse" match="TEI">
     <xsl:message>CHAINED PROC</xsl:message>
     <xsl:apply-templates mode="#current" select="text"/>

From f834f25ab8265d5167f44c1d9e32e55a160c938a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Wed, 10 Jun 2026 17:00:05 +0200
Subject: [PATCH 24/28] makes chain.xsl work and pass tests

---
 distribution/seed/chain.xsl   | 39 +++++++++++++++--
 distribution/seed/chain.xspec | 79 +++++++++++++++++++++++++++++++++++
 2 files changed, 114 insertions(+), 4 deletions(-)

diff --git a/distribution/seed/chain.xsl b/distribution/seed/chain.xsl
index 3503d34..6171e17 100644
--- a/distribution/seed/chain.xsl
+++ b/distribution/seed/chain.xsl
@@ -49,22 +49,53 @@ target/bin/xslt.sh \
     <!-- name of the template, mode or function used as an entry point for mediaType processing -->
     <xsl:param name="media-type-processor" as="xs:string" select="'post-proc'"/>
 
+    <xsl:variable name="media-type-parameters" as="map(xs:string, item()*)*">
+        <xsl:map>
+            <xsl:map-entry key="'name'">media-type-package</xsl:map-entry>
+            <xsl:map-entry key="'value'" select="$media-type-package"/>
+            <xsl:map-entry key="'type'">xs:string?</xsl:map-entry>
+        </xsl:map>
+        <xsl:map>
+            <xsl:map-entry key="'name'">media-type-package-version</xsl:map-entry>
+            <xsl:map-entry key="'value'" select="$media-type-package-version"/>
+            <xsl:map-entry key="'type'">xs:string</xsl:map-entry>
+        </xsl:map>
+        <xsl:map>
+            <xsl:map-entry key="'name'">media-type-component</xsl:map-entry>
+            <xsl:map-entry key="'value'" select="$media-type-component"/>
+            <xsl:map-entry key="'type'">xs:string</xsl:map-entry>
+        </xsl:map>
+        <xsl:map>
+            <xsl:map-entry key="'name'">media-type-processor</xsl:map-entry>
+            <xsl:map-entry key="'value'" select="$media-type-processor"/>
+            <xsl:map-entry key="'type'">xs:string</xsl:map-entry>
+        </xsl:map>
+    </xsl:variable>
 
     <xsl:template match="document-node()">
-        <xsl:sequence select="seed:merge()"/>
+        <xsl:sequence select="seed:chain()"/>
     </xsl:template>
 
     <xsl:template name="xsl:initial-template">
-        <xsl:sequence select="seed:merge()"/>
+        <xsl:sequence select="seed:chain()"/>
     </xsl:template>
 
+    <xsl:variable name="document-bare-config" as="map(xs:string, item()*)"
+        select="seed:bare-config($document-config)"/>
+
+    <xsl:variable name="chained-bare-config" as="map(xs:string, item()*)"
+        select="seed:bare-config($chained-config)"/>
 
 
-    <xsl:function name="seed:merge" as="map(xs:string, item()*)">
+    <xsl:function name="seed:chain" as="map(xs:string, item()*)" visibility="final">
         <xsl:map>
             <xsl:map-entry key="$name">
                 <xsl:sequence select="
-                        ($document-config => seed:bare-config(), $chained-config => seed:as-library()) => map:merge()"
+                        map:merge((map:remove($chained-bare-config, ('location', 'requiresSource')), $document-bare-config), map {'duplicates': 'use-first'}) =>
+                        map:put('libraries', array:join((map:get($document-bare-config, 'libraries'), seed:as-library($chained-config) => map:get('libraries')))) =>
+                        map:put('parameterDescriptors', map:merge((map:get($document-bare-config, 'parameterDescriptors'), seed:as-library($chained-config) => map:get('parameterDescriptors')))) =>
+                        map:put('compileTimeParameters', array {$media-type-parameters}) =>
+                        map:put('description', concat(seed:transformation-id($chained-config), ' chained to ', seed:transformation-id($document-config), ': ', map:get($chained-bare-config, 'description')))"
                 />
             </xsl:map-entry>
         </xsl:map>
diff --git a/distribution/seed/chain.xspec b/distribution/seed/chain.xspec
index aacfa9c..e1741ee 100644
--- a/distribution/seed/chain.xspec
+++ b/distribution/seed/chain.xspec
@@ -11,6 +11,27 @@
     <x:param name="transformations" select="'xsl/document.xsl'"/>
     <x:variable name="document.json" select="seed:mk-config()"/>
 
+    <x:variable name="config-base-uri"
+        select="resolve-uri('../../../target/generated-resources/xml/xslt/', static-base-uri())"/>
+
+    <x:variable name="document-cfg-uri" as="xs:string"
+        select="resolve-uri('xsl/document.seed.json', $config-base-uri)"/>
+    <x:variable name="tei2txt-config-uri" as="xs:string"
+        select="resolve-uri('test/media-type/tei2txt.seed.json', $config-base-uri)"/>
+
+    <x:variable name="document-cfg" as="map(*)"
+        select="$document-cfg-uri => unparsed-text() => parse-json()"/>
+    <x:variable name="tei2txt-config" as="map(*)"
+        select="$tei2txt-config-uri => unparsed-text() => parse-json()"/>
+
+    <x:variable name="document-id" as="xs:string" select="map:keys($document-cfg)"/>
+    <x:variable name="tei2txt-id" as="xs:string" select="map:keys($tei2txt-config)"/>
+
+    <x:variable name="document-tei2txt-id" as="xs:string"
+        select="($document-id, $tei2txt-id) => string-join('+')"/>
+
+    <x:variable name="media-type-parameters" as="xs:string*"
+        select="'media-type-package','media-type-package-version','media-type-component','media-type-processor'"/>
 
     <x:scenario label="seed:as-library">
         <x:param name="document-config-uri" as="xs:string" select="''"/>
@@ -42,7 +63,65 @@
         />
     </x:scenario>
 
+    <x:scenario label="chain tei2txt.xsl to document.xsl">
+        <x:param name="document-config-uri" as="xs:string" select="''"/>
+        <x:param name="chained-config-uri" as="xs:string" select="''"/>
+        <x:param name="document-config" as="map(*)" select="$document-cfg"/>
+        <x:param name="chained-config" as="map(*)" select="$tei2txt-config"/>
+        <x:param name="media-type-package" as="xs:string" select="'http://example.com/xsl/tei2txt'"/>
+        <x:call function="seed:chain"/>
+        <x:expect label="results in 1 transformation config" test="map:size(.)" select="1"/>
+        <x:expect label="result transformation ID" test="map:keys(.)" select="$document-tei2txt-id"/>
+
+        <x:expect label="has hint about chaining in description"
+            test="map:get(., $document-tei2txt-id) => map:get('description') => matches('tei2txt.+chained\s+to.+document')"/>
+        <x:expect label="uses description from chained"
+            test="map:get(., $document-tei2txt-id) => map:get('description') => ends-with(map:get($tei2txt-config, $tei2txt-id) => map:get('description'))"/>
 
+        <x:expect label="content type determined by chained transformation"
+            test="map:get(., $document-tei2txt-id) => map:get('mediaType')"
+            select="map:get($tei2txt-config, $tei2txt-id) => map:get('mediaType')"/>
 
+        <x:expect label="location of document.xsl"
+            test="map:get(., $document-tei2txt-id) => map:get('location')"
+            select="map:get($document-cfg, $document-id) => map:get('location')"/>
+
+        <x:expect label="transformation to have the document libraries and tei2txt"
+            test="map:get(., $document-tei2txt-id) => map:get('libraries') => array:size()"
+            select="map:get($document-cfg, $document-id) => map:get('libraries') => array:size() + 1"/>
+        <x:expect label="chained stylesheet (tei2txt.xsl) is a library"
+            test=". => map:get($document-tei2txt-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => matches('tei2txt\.xsl') }) => array:size()"
+            select="1"/>
+        <x:expect label="chained stylesheet (tei2txt.xsl) has location"
+            test=". => map:get($document-tei2txt-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => matches('tei2txt\.xsl') }) => array:get(1) => map:get('location')"
+            select="map:get($tei2txt-config, $tei2txt-id) => map:get('location')"/>
+        <x:expect label="chained stylesheet (tei2txt.xsl) has asName"
+            test=". => map:get($document-tei2txt-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => matches('tei2txt\.xsl') }) => array:get(1) => map:get('asName')"
+            select="'http://example.com/xsl/tei2txt'"/>
+        <x:expect label="chained stylesheet (tei2txt.xsl) has asVersion"
+            test=". => map:get($document-tei2txt-id) => map:get('libraries') => array:filter(function ($x) as xs:boolean { map:get($x, 'location') => matches('tei2txt\.xsl') }) => array:get(1) => map:get('asVersion')"
+            select="'1.0.0'"/>
+
+        <x:expect label="transformation to have parameters of document and of tei2txt"
+            test="map:get(., $document-tei2txt-id) => map:get('parameterDescriptors') => map:size()"
+            select="map:get($document-cfg, $document-id) => map:get('parameterDescriptors') => map:size() + map:get($tei2txt-config, $tei2txt-id) => map:get('parameterDescriptors') => map:size()"/>
+
+        <x:expect label="has the media-type related compile time parameters"
+            test=". => map:get($document-tei2txt-id) => map:get('compileTimeParameters') => array:for-each(function ($x) as xs:string { map:get($x, 'name') })"
+            select="array {$media-type-parameters}"/>
+    </x:scenario>
+
+
+    <x:scenario label="chain tei2txt.xsl to document.xsl when called with a source document">
+        <x:param name="document-config-uri" as="xs:string" select="''"/>
+        <x:param name="chained-config-uri" as="xs:string" select="''"/>
+        <x:param name="document-config" as="map(*)" select="$document-cfg"/>
+        <x:param name="chained-config" as="map(*)" select="$tei2txt-config"/>
+        <x:param name="media-type-package" as="xs:string" select="'http://example.com/xsl/tei2txt'"/>
+        <x:context href="test-assembly.xml"/>
+        <x:expect label="results in 1 transformation config" test="map:size(.)" select="1"/>
+        <x:expect label="result transformation ID" test="map:keys(.)" select="$document-tei2txt-id"
+        />
+    </x:scenario>
 
 </x:description>

From 896cea5dafa1779bc634a3e000e29ad7cedcdb47 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Wed, 10 Jun 2026 18:02:53 +0200
Subject: [PATCH 25/28] make a package of testing resources for deployment on
 SEED

---
 distribution/seed/test-assembly.xml | 14 +++----
 pom.xml                             | 64 ++++++++++++++++++++++++++++-
 2 files changed, 70 insertions(+), 8 deletions(-)

diff --git a/distribution/seed/test-assembly.xml b/distribution/seed/test-assembly.xml
index 71c724a..a0bbede 100644
--- a/distribution/seed/test-assembly.xml
+++ b/distribution/seed/test-assembly.xml
@@ -2,7 +2,7 @@
 <assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
-   <id>seed-tests</id>
+   <id>seed-testing</id>
    <includeBaseDirectory>true</includeBaseDirectory>
    <baseDirectory/>
 
@@ -13,7 +13,7 @@
    <fileSets>
       <fileSet>
          <directory>${project.basedir}/test</directory>
-         <outputDirectory>/${project.artifactId}-test</outputDirectory>
+         <outputDirectory>/${project.artifactId}-testing</outputDirectory>
          <includes>
             <include>**/tei2txt.xsl</include>
          </includes>
@@ -35,13 +35,14 @@
       </fileSet>
       <fileSet>
          <directory>${project.build.directory}/generated-resources/xml/xslt/test</directory>
-         <outputDirectory>/${project.artifactId}-test</outputDirectory>
+         <outputDirectory>/${project.artifactId}-testing</outputDirectory>
          <includes>
             <include>**/*.seed.json</include>
+            <include>**/*.chain.json</include>
          </includes>
       </fileSet>
       <fileSet>
-         <directory>${project.basedir}/test</directory>
+         <directory>${project.basedir}/testing</directory>
          <outputDirectory>/${project.artifactId}-test</outputDirectory>
          <includes>
             <include>saxon.xml</include>
@@ -52,9 +53,8 @@
 
    <files>
       <file>
-         <!-- TODO: make source be the chained config -->
-         <source>${project.build.directory}/generated-resources/xml/xslt/pom.json</source>
-         <destName>${project.artifactId}-test.json</destName>
+         <source>${project.build.directory}/generated-resources/xml/xslt/build.json</source>
+         <destName>${project.artifactId}-testing.json</destName>
       </file>
    </files>
 
diff --git a/pom.xml b/pom.xml
index 547f0b6..337ea42 100644
--- a/pom.xml
+++ b/pom.xml
@@ -29,7 +29,9 @@
         <!-- XSLT resources for generating the configuration for the SEED distribution -->
         <seed-config-xsl.url>${project.basedir}/distribution/seed/seed-config.xsl</seed-config-xsl.url>
         <seed-merge-xsl.url>${project.basedir}/distribution/seed/merge.xsl</seed-merge-xsl.url>
+        <seed-chain-xsl.url>${project.basedir}/distribution/seed/chain.xsl</seed-chain-xsl.url>
         <sef-config-xsl.url>${project.basedir}/distribution/seed/sef-config.xsl</sef-config-xsl.url>
+        <seed-json-config.dir>${project.build.directory}/generated-resources/xml/xslt</seed-json-config.dir>
 
         <!-- SEF package -->
         <!-- whether to generate the package with sef compilations -->
@@ -505,10 +507,50 @@
                                         </parameter>
                                         <parameter>
                                             <name>id-prefix</name>
-                                            <value>chained</value>
+                                            <value>${project.artifactId}-testing</value>
                                         </parameter>
                                     </parameters>
                                     <stylesheet>${seed-config-xsl.url}</stylesheet>
+                                    <fileMappers>
+                                        <fileMapper
+                                            implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
+                                            <targetExtension>.chain.json</targetExtension>
+                                        </fileMapper>
+                                    </fileMappers>
+                                </transformationSet>
+                                <transformationSet>
+                                    <!-- generate chained configuration for tei2txt -->
+                                    <dir>${project.basedir}</dir>
+                                    <includes>
+                                        <include>test/media-type/tei2txt.xsl</include>
+                                    </includes>
+                                    <parameters>
+                                        <parameter>
+                                            <name>document-config-uri</name>
+                                            <value>${seed-json-config.dir}/xsl/document.seed.json</value>
+                                        </parameter>
+                                        <parameter>
+                                            <name>chained-config-uri</name>
+                                            <value>${seed-json-config.dir}/test/media-type/tei2txt.chain.json</value>
+                                        </parameter>
+                                        <parameter>
+                                            <name>media-type-package</name>
+                                            <value>http://example.com/xsl/tei2txt</value>
+                                        </parameter>
+                                        <parameter>
+                                            <name>media-type-package-version</name>
+                                            <value>1.0.0</value>
+                                        </parameter>
+                                        <parameter>
+                                            <name>media-type-component</name>
+                                            <value>mode</value>
+                                        </parameter>
+                                        <parameter>
+                                            <name>media-type-processor</name>
+                                            <value>tei</value>
+                                        </parameter>
+                                    </parameters>
+                                    <stylesheet>${seed-chain-xsl.url}</stylesheet>
                                     <fileMappers>
                                         <fileMapper
                                             implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
@@ -516,6 +558,26 @@
                                         </fileMapper>
                                     </fileMappers>
                                 </transformationSet>
+                                <transformationSet>
+                                    <!-- merge SEED configurations for testing package -->
+                                    <dir>${project.basedir}</dir>
+                                    <includes>
+                                        <include>build.xml</include>
+                                    </includes>
+                                    <parameters>
+                                        <parameter>
+                                            <name>json-collection</name>
+                                            <value>file:${project.build.directory}/generated-resources/xml/xslt?select=*.seed.json;recurse=yes</value>
+                                        </parameter>
+                                    </parameters>
+                                    <stylesheet>${seed-merge-xsl.url}</stylesheet>
+                                    <fileMappers>
+                                        <fileMapper
+                                            implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">
+                                            <targetExtension>.json</targetExtension>
+                                        </fileMapper>
+                                    </fileMappers>
+                                </transformationSet>
                             </transformationSets>
                         </configuration>
                     </execution>

From 940981213404c10abc9065316ed12472e6a99353 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Wed, 10 Jun 2026 18:24:47 +0200
Subject: [PATCH 26/28] make YAML config for SEED from merged JSON
 configurations

---
 distribution/seed/assembly.xml      | 12 +++----
 distribution/seed/test-assembly.xml |  4 +++
 pom.xml                             | 51 ++---------------------------
 3 files changed, 11 insertions(+), 56 deletions(-)

diff --git a/distribution/seed/assembly.xml b/distribution/seed/assembly.xml
index 07a4883..502f8dd 100644
--- a/distribution/seed/assembly.xml
+++ b/distribution/seed/assembly.xml
@@ -88,14 +88,6 @@
             <include>${project.artifactId}.yaml</include>
          </includes>
       </fileSet>
-      <fileSet>
-         <!-- the user-provided yaml config file overwrites the generated one -->
-         <directory>${project.basedir}</directory>
-         <outputDirectory>/</outputDirectory>
-         <includes>
-            <include>${project.artifactId}.yaml</include>
-         </includes>
-      </fileSet>
    </fileSets>
 
    <files>
@@ -103,6 +95,10 @@
          <source>${project.build.directory}/generated-resources/xml/xslt/pom.json</source>
          <destName>${project.artifactId}.json</destName>
       </file>
+      <file>
+         <source>${project.build.directory}/generated-resources/yml/pom.yml</source>
+         <destName>${project.artifactId}.yaml</destName>
+      </file>
    </files>
 
 </assembly>
diff --git a/distribution/seed/test-assembly.xml b/distribution/seed/test-assembly.xml
index a0bbede..197a840 100644
--- a/distribution/seed/test-assembly.xml
+++ b/distribution/seed/test-assembly.xml
@@ -56,6 +56,10 @@
          <source>${project.build.directory}/generated-resources/xml/xslt/build.json</source>
          <destName>${project.artifactId}-testing.json</destName>
       </file>
+      <file>
+         <source>${project.build.directory}/generated-resources/yml/build.yml</source>
+         <destName>${project.artifactId}-testing.yaml</destName>
+      </file>
    </files>
 
 </assembly>
diff --git a/pom.xml b/pom.xml
index 337ea42..c39e4a5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -606,30 +606,11 @@
                         <configuration>
                             <resources>
                                 <resource>
-                                    <directory>${project.build.directory}/generated-resources/xml/xslt/xsl</directory>
+                                    <directory>${project.build.directory}/generated-resources/xml/xslt</directory>
                                     <filtering>false</filtering>
                                     <includes>
-                                        <include>**/*.seed.json</include>
-                                    </includes>
-                                </resource>
-                            </resources>
-                            <outputExtension>yml</outputExtension>
-                            <outputDirectory>${project.build.directory}/generated-resources/yml</outputDirectory>
-                        </configuration>
-                    </execution>
-                    <execution>
-                        <id>seed-config-yaml-2-yaml</id>
-                        <phase>generate-resources</phase>
-                        <goals>
-                            <goal>json-2-yaml</goal>
-                        </goals>
-                        <configuration>
-                            <resources>
-                                <resource>
-                                    <directory>${project.build.directory}/generated-resources/xml/xslt/xsl</directory>
-                                    <filtering>false</filtering>
-                                    <includes>
-                                        <include>**/*.seed.json</include>
+                                        <include>pom.json</include>
+                                        <include>build.json</include>
                                     </includes>
                                 </resource>
                             </resources>
@@ -720,32 +701,6 @@
                             </target>
                         </configuration>
                     </execution>
-                    <!-- concat SEED XML Transformer configurations to seed-config.yaml -->
-                    <execution>
-                        <id>concat-seed-xml-transformer-configurations</id>
-                        <phase>generate-resources</phase>
-                        <goals>
-                            <goal>run</goal>
-                        </goals>
-                        <configuration>
-                            <target>
-                                <concat
-                                    destfile="${project.build.directory}/${project.artifactId}.yaml"
-                                    force="yes">
-                                    <fileset
-                                        dir="${project.build.directory}/generated-resources/yml">
-                                        <include name="**/*.yml"/>
-                                    </fileset>
-                                    <filterchain>
-                                        <!-- remove structure from yaml files -->
-                                        <linecontainsregexp negate="true">
-                                            <regexp pattern="^---$"/>
-                                        </linecontainsregexp>
-                                    </filterchain>
-                                </concat>
-                            </target>
-                        </configuration>
-                    </execution>
                 </executions>
             </plugin>
 

From 509acacfcc923dd794bdcb6628d607df95f3e430 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Wed, 10 Jun 2026 18:32:48 +0200
Subject: [PATCH 27/28] reflects recent change of names of build artifacts

---
 distribution/seed/chain.xspec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/distribution/seed/chain.xspec b/distribution/seed/chain.xspec
index e1741ee..3cc085e 100644
--- a/distribution/seed/chain.xspec
+++ b/distribution/seed/chain.xspec
@@ -17,7 +17,7 @@
     <x:variable name="document-cfg-uri" as="xs:string"
         select="resolve-uri('xsl/document.seed.json', $config-base-uri)"/>
     <x:variable name="tei2txt-config-uri" as="xs:string"
-        select="resolve-uri('test/media-type/tei2txt.seed.json', $config-base-uri)"/>
+        select="resolve-uri('test/media-type/tei2txt.chain.json', $config-base-uri)"/>
 
     <x:variable name="document-cfg" as="map(*)"
         select="$document-cfg-uri => unparsed-text() => parse-json()"/>

From c48ab48404df7af597dc474b9619daf928783466 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20L=C3=BCck?= <christian.lueck@uni-muenster.de>
Date: Wed, 10 Jun 2026 18:49:48 +0200
Subject: [PATCH 28/28] report changes in 0.4.11

---
 CHANGELOG.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53708cb..cc55b93 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Changes
 
+## 0.4.11
+
+- adds utilities for generating SEED config for chained transformations (fixes issue #20)
+- adds a testing package for SEED with chained transformation
+
 ## 0.4.10
 
 - adds saxon config for SEED with assertions enabled (fixes issue #18)