xslt-processor 4.5.0 → 4.6.0

package/index.d.mts

@@ -170,6 +170,21 @@ type XPathFunctions = Record<string, XPathFunction>;
  * Type for namespace bindings (prefix -> namespace URI).
  */
 type XPathNamespaces = Record<string, string>;
+/**
+ * Type for available documents mapping (URI -> root node).
+ * Used by fn:doc() and related functions (XPath 2.0+).
+ */
+type XPathDocuments = Record<string, XPathNode | null>;
+/**
+ * Type for available collections mapping (URI -> sequence of nodes).
+ * Used by fn:collection() function (XPath 2.0+).
+ */
+type XPathCollections = Record<string, XPathNode[]>;
+/**
+ * Type for function implementations registry.
+ * Maps function names (with optional namespace) to their implementations.
+ */
+type XPathFunctionRegistry = Record<string, XPathFunction>;
 /**
  * The evaluation context for XPath expressions.
  *
@@ -178,6 +193,7 @@ type XPathNamespaces = Record<string, string>;
  * - Position information for predicates
  * - Variable bindings
  * - Custom function definitions
+ * - Dynamic properties like current dateTime, available documents, etc.
  */
 interface XPathContext {
     /**
@@ -220,11 +236,85 @@ interface XPathContext {
      * Used by functions like json-to-xml() which are only available in XSLT 3.0+
      */
     xsltVersion?: string;
+    /**
+     * XPath specification version being used.
+     * Default: '1.0'
+     *
+     * This affects:
+     * - Function library available
+     * - Type system behavior
+     * - Sequence vs node-set handling
+     */
+    xpathVersion?: '1.0' | '2.0' | '3.0' | '3.1';
+    /**
+     * Enable XPath 1.0 backward compatibility mode (Phase 8.1).
+     * When true, XPath 2.0+ expressions follow XPath 1.0 type conversion rules.
+     * This enables:
+     * - XPath 1.0 boolean conversion semantics
+     * - XPath 1.0 numeric conversion (with NaN for empty sequences)
+     * - XPath 1.0 comparison rules (node-set to string conversion)
+     * - XPath 1.0 logical operator behavior (short-circuit, error suppression)
+     * Default: false (XPath 2.0 semantics)
+     */
+    xpath10CompatibilityMode?: boolean;
+    /**
+     * Default collation for string comparisons (XPath 2.0+).
+     * Default: Unicode codepoint collation
+     */
+    defaultCollation?: string;
+    /**
+     * Base URI for resolving relative URIs (XPath 2.0+).
+     */
+    baseUri?: string;
+    /**
+     * Implicit timezone as duration offset from UTC (XPath 2.0+).
+     * Example: '-PT5H' for US Eastern Time (UTC-5)
+     */
+    implicitTimezone?: string;
+    /**
+     * Extension data for XSLT or custom implementations.
+     * This allows attaching arbitrary data to the context without
+     * polluting the main interface.
+     */
+    extensions?: Record<string, any>;
+    /**
+     * Current dateTime in the dynamic context (XPath 2.0+).
+     * Returned by fn:current-dateTime().
+     * If not provided, defaults to system time when accessed.
+     */
+    currentDateTime?: Date;
+    /**
+     * Available documents mapping for fn:doc() function (XPath 2.0+).
+     * Maps document URIs to their root document nodes.
+     * Example: { "http://example.com/data.xml": rootNode }
+     */
+    availableDocuments?: XPathDocuments;
+    /**
+     * Available collections mapping for fn:collection() function (XPath 2.0+).
+     * Maps collection URIs to sequences of nodes.
+     * Example: { "http://example.com/collection": [node1, node2, ...] }
+     */
+    availableCollections?: XPathCollections;
+    /**
+     * Default collection URI when fn:collection() is called without arguments (XPath 2.0+).
+     * If provided, fn:collection() returns availableCollections[defaultCollection].
+     */
+    defaultCollection?: string;
+    /**
+     * Function implementations registry (XPath 2.0+).
+     * Maps QName function names to their implementations.
+     * Allows defining custom/XSLT functions at evaluation time.
+     * Format: "localName" or "prefix:localName"
+     */
+    functionRegistry?: XPathFunctionRegistry;
 }
 /**
  * Result types that can be returned from XPath evaluation.
+ *
+ * XPath 1.0: node-set, string, number, boolean
+ * XPath 2.0+: sequences (which subsume node-sets), atomic values, functions
  */
-type XPathResult = XPathNode[] | string | number | boolean;
+type XPathResult = XPathNode[] | string | number | boolean | any[] | Map<any, any> | null | Function;
 
 declare abstract class XPathExpression {
     abstract evaluate(context: XPathContext): XPathResult;
@@ -315,6 +405,25 @@ declare class ExprContext {
     knownNamespaces: {
         [alias: string]: string;
     };
+    /**
+     * Custom system properties for system-property() function.
+     * Overrides the default properties (xsl:version, xsl:vendor, xsl:vendor-url).
+     */
+    systemProperties?: {
+        [name: string]: string;
+    };
+    /**
+     * Document loader function for the document() function.
+     * Takes a URI and returns an XNode document, or null if loading fails.
+     */
+    documentLoader?: (uri: string) => XNode | null;
+    /**
+     * Unparsed entity URIs for the unparsed-entity-uri() function.
+     * Maps entity names to their URIs (from DTD declarations).
+     */
+    unparsedEntities?: {
+        [name: string]: string;
+    };
     caseInsensitive: any;
     ignoreAttributesWithoutValue: any;
     returnOnFirstMatch: any;
@@ -417,6 +526,8 @@ declare class NodeConverter {
     private convertVariables;
     /**
      * Create custom functions for XPath context (like key(), document(), etc.).
+     * Note: Custom functions receive the XPathContext as their first argument,
+     * followed by the evaluated function arguments.
      */
     private createCustomFunctions;
     /**

package/index.d.ts

@@ -170,6 +170,21 @@ type XPathFunctions = Record<string, XPathFunction>;
  * Type for namespace bindings (prefix -> namespace URI).
  */
 type XPathNamespaces = Record<string, string>;
+/**
+ * Type for available documents mapping (URI -> root node).
+ * Used by fn:doc() and related functions (XPath 2.0+).
+ */
+type XPathDocuments = Record<string, XPathNode | null>;
+/**
+ * Type for available collections mapping (URI -> sequence of nodes).
+ * Used by fn:collection() function (XPath 2.0+).
+ */
+type XPathCollections = Record<string, XPathNode[]>;
+/**
+ * Type for function implementations registry.
+ * Maps function names (with optional namespace) to their implementations.
+ */
+type XPathFunctionRegistry = Record<string, XPathFunction>;
 /**
  * The evaluation context for XPath expressions.
  *
@@ -178,6 +193,7 @@ type XPathNamespaces = Record<string, string>;
  * - Position information for predicates
  * - Variable bindings
  * - Custom function definitions
+ * - Dynamic properties like current dateTime, available documents, etc.
  */
 interface XPathContext {
     /**
@@ -220,11 +236,85 @@ interface XPathContext {
      * Used by functions like json-to-xml() which are only available in XSLT 3.0+
      */
     xsltVersion?: string;
+    /**
+     * XPath specification version being used.
+     * Default: '1.0'
+     *
+     * This affects:
+     * - Function library available
+     * - Type system behavior
+     * - Sequence vs node-set handling
+     */
+    xpathVersion?: '1.0' | '2.0' | '3.0' | '3.1';
+    /**
+     * Enable XPath 1.0 backward compatibility mode (Phase 8.1).
+     * When true, XPath 2.0+ expressions follow XPath 1.0 type conversion rules.
+     * This enables:
+     * - XPath 1.0 boolean conversion semantics
+     * - XPath 1.0 numeric conversion (with NaN for empty sequences)
+     * - XPath 1.0 comparison rules (node-set to string conversion)
+     * - XPath 1.0 logical operator behavior (short-circuit, error suppression)
+     * Default: false (XPath 2.0 semantics)
+     */
+    xpath10CompatibilityMode?: boolean;
+    /**
+     * Default collation for string comparisons (XPath 2.0+).
+     * Default: Unicode codepoint collation
+     */
+    defaultCollation?: string;
+    /**
+     * Base URI for resolving relative URIs (XPath 2.0+).
+     */
+    baseUri?: string;
+    /**
+     * Implicit timezone as duration offset from UTC (XPath 2.0+).
+     * Example: '-PT5H' for US Eastern Time (UTC-5)
+     */
+    implicitTimezone?: string;
+    /**
+     * Extension data for XSLT or custom implementations.
+     * This allows attaching arbitrary data to the context without
+     * polluting the main interface.
+     */
+    extensions?: Record<string, any>;
+    /**
+     * Current dateTime in the dynamic context (XPath 2.0+).
+     * Returned by fn:current-dateTime().
+     * If not provided, defaults to system time when accessed.
+     */
+    currentDateTime?: Date;
+    /**
+     * Available documents mapping for fn:doc() function (XPath 2.0+).
+     * Maps document URIs to their root document nodes.
+     * Example: { "http://example.com/data.xml": rootNode }
+     */
+    availableDocuments?: XPathDocuments;
+    /**
+     * Available collections mapping for fn:collection() function (XPath 2.0+).
+     * Maps collection URIs to sequences of nodes.
+     * Example: { "http://example.com/collection": [node1, node2, ...] }
+     */
+    availableCollections?: XPathCollections;
+    /**
+     * Default collection URI when fn:collection() is called without arguments (XPath 2.0+).
+     * If provided, fn:collection() returns availableCollections[defaultCollection].
+     */
+    defaultCollection?: string;
+    /**
+     * Function implementations registry (XPath 2.0+).
+     * Maps QName function names to their implementations.
+     * Allows defining custom/XSLT functions at evaluation time.
+     * Format: "localName" or "prefix:localName"
+     */
+    functionRegistry?: XPathFunctionRegistry;
 }
 /**
  * Result types that can be returned from XPath evaluation.
+ *
+ * XPath 1.0: node-set, string, number, boolean
+ * XPath 2.0+: sequences (which subsume node-sets), atomic values, functions
  */
-type XPathResult = XPathNode[] | string | number | boolean;
+type XPathResult = XPathNode[] | string | number | boolean | any[] | Map<any, any> | null | Function;
 
 declare abstract class XPathExpression {
     abstract evaluate(context: XPathContext): XPathResult;
@@ -315,6 +405,25 @@ declare class ExprContext {
     knownNamespaces: {
         [alias: string]: string;
     };
+    /**
+     * Custom system properties for system-property() function.
+     * Overrides the default properties (xsl:version, xsl:vendor, xsl:vendor-url).
+     */
+    systemProperties?: {
+        [name: string]: string;
+    };
+    /**
+     * Document loader function for the document() function.
+     * Takes a URI and returns an XNode document, or null if loading fails.
+     */
+    documentLoader?: (uri: string) => XNode | null;
+    /**
+     * Unparsed entity URIs for the unparsed-entity-uri() function.
+     * Maps entity names to their URIs (from DTD declarations).
+     */
+    unparsedEntities?: {
+        [name: string]: string;
+    };
     caseInsensitive: any;
     ignoreAttributesWithoutValue: any;
     returnOnFirstMatch: any;
@@ -417,6 +526,8 @@ declare class NodeConverter {
     private convertVariables;
     /**
      * Create custom functions for XPath context (like key(), document(), etc.).
+     * Note: Custom functions receive the XPathContext as their first argument,
+     * followed by the evaluated function arguments.
      */
     private createCustomFunctions;
     /**