xslt-processor 4.6.0 → 4.6.1

package/index.d.mts

@@ -308,13 +308,24 @@ interface XPathContext {
      */
     functionRegistry?: XPathFunctionRegistry;
 }
+/**
+ * Represents an XPath 3.0 function item.
+ * This is a simplified interface to avoid circular dependencies.
+ */
+interface XPathFunctionItem {
+    __isFunctionItem: true;
+    implementation: (...args: any[]) => any;
+    arity: number;
+    name?: string;
+    namespace?: string;
+}
 /**
  * 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 | any[] | Map<any, any> | null | Function;
+type XPathResult = XPathNode[] | string | number | boolean | any[] | Map<any, any> | null | XPathFunctionItem;
 
 declare abstract class XPathExpression {
     abstract evaluate(context: XPathContext): XPathResult;
@@ -694,6 +705,15 @@ declare class Xslt {
     outputOmitXmlDeclaration: string;
     version: string;
     firstTemplateRan: boolean;
+    /**
+     * Forwards-compatible processing mode (XSLT 1.0 Section 2.5).
+     * When true, the processor is running a stylesheet with version > 1.0.
+     * In this mode:
+     * - Unknown top-level elements are silently ignored
+     * - Unknown XSLT instructions use xsl:fallback if available, otherwise are ignored
+     * - Unknown attributes on XSLT elements are ignored
+     */
+    forwardsCompatible: boolean;
     /**
      * List of element name patterns from xsl:strip-space declarations.
      * Whitespace-only text nodes inside matching elements will be stripped.
@@ -756,6 +776,21 @@ declare class Xslt {
      * @param output If set, the output where the transformation should occur.
      */
     protected xsltProcessContext(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Handle unknown XSLT instructions per XSLT 1.0 Section 2.5 (Forwards-Compatible Processing).
+     *
+     * In forwards-compatible mode (version > 1.0):
+     * - If the instruction has an xsl:fallback child, execute the fallback
+     * - Otherwise, the instruction is silently ignored
+     *
+     * In strict mode (version = 1.0):
+     * - Unknown instructions are an error
+     *
+     * @param context The Expression Context
+     * @param template The unknown XSLT instruction element
+     * @param output The output node
+     */
+    protected xsltUnknownInstruction(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
     /**
      * Implements `xsl:apply-templates`.
      * @param context The Expression Context.
@@ -909,29 +944,57 @@ declare class Xslt {
      * @param context The Expression Context.
      * @param level The counting level: 'single', 'multiple', or 'any'.
      * @param count Pattern to match nodes to count.
-     * @param from Pattern to start counting from.
-     * @returns The count value.
+     * @param from Pattern to define counting boundary.
+     * @returns Array of count values (single element for 'single'/'any', multiple for 'multiple').
      */
-    protected xsltNumberCount(context: ExprContext, level: string, count: string | null, from: string | null): number;
+    protected xsltNumberCount(context: ExprContext, level: string, count: string | null, from: string | null): number[];
     /**
-     * Checks if a node matches a simple name pattern.
+     * Checks if a node matches a pattern (supports simple names and union patterns).
      * @param node The node to check.
-     * @param pattern The pattern (node name) to match.
+     * @param pattern The pattern (node name, wildcard, or union like "a|b|c").
      * @returns True if the node matches.
      */
     protected nodeMatchesPattern(node: XNode, pattern: string): boolean;
+    /**
+     * Checks if a node matches a single (non-union) pattern.
+     * @param node The node to check.
+     * @param pattern The pattern (node name or wildcard).
+     * @returns True if the node matches.
+     */
+    protected nodeMatchesSinglePattern(node: XNode, pattern: string): boolean;
     /**
      * Gets all nodes preceding the given node in document order.
      * @param node The reference node.
+     * @param fromPattern Optional pattern to define counting boundary.
      * @returns Array of preceding nodes.
      */
-    protected getAllPrecedingNodes(node: XNode): XNode[];
+    protected getAllPrecedingNodes(node: XNode, fromPattern?: string | null): XNode[];
     /**
      * Collects all descendant nodes of a given node.
      * @param node The parent node.
      * @param result The array to collect into.
      */
     protected collectDescendants(node: XNode, result: XNode[]): void;
+    /**
+     * Formats an array of numbers according to the format string.
+     * For level="multiple", numbers like [1, 2, 3] with format "1.1.1" produce "1.2.3".
+     * @param numbers The numbers to format.
+     * @param format The format string (e.g., "1", "1.1", "1.a.i").
+     * @param groupingSeparator Optional grouping separator.
+     * @param groupingSize Optional grouping size.
+     * @returns The formatted number string.
+     */
+    protected xsltFormatNumbers(numbers: number[], format: string, groupingSeparator: string | null, groupingSize: string | null): string;
+    /**
+     * Parses a format string into tokens and separators.
+     * E.g., "1.a.i" -> tokens: ["1", "a", "i"], separators: [".", "."]
+     * @param format The format string.
+     * @returns Object with tokens and separators arrays.
+     */
+    protected parseFormatString(format: string): {
+        tokens: string[];
+        separators: string[];
+    };
     /**
      * Formats a number according to the format string.
      * @param number The number to format.

package/index.d.ts

@@ -308,13 +308,24 @@ interface XPathContext {
      */
     functionRegistry?: XPathFunctionRegistry;
 }
+/**
+ * Represents an XPath 3.0 function item.
+ * This is a simplified interface to avoid circular dependencies.
+ */
+interface XPathFunctionItem {
+    __isFunctionItem: true;
+    implementation: (...args: any[]) => any;
+    arity: number;
+    name?: string;
+    namespace?: string;
+}
 /**
  * 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 | any[] | Map<any, any> | null | Function;
+type XPathResult = XPathNode[] | string | number | boolean | any[] | Map<any, any> | null | XPathFunctionItem;
 
 declare abstract class XPathExpression {
     abstract evaluate(context: XPathContext): XPathResult;
@@ -694,6 +705,15 @@ declare class Xslt {
     outputOmitXmlDeclaration: string;
     version: string;
     firstTemplateRan: boolean;
+    /**
+     * Forwards-compatible processing mode (XSLT 1.0 Section 2.5).
+     * When true, the processor is running a stylesheet with version > 1.0.
+     * In this mode:
+     * - Unknown top-level elements are silently ignored
+     * - Unknown XSLT instructions use xsl:fallback if available, otherwise are ignored
+     * - Unknown attributes on XSLT elements are ignored
+     */
+    forwardsCompatible: boolean;
     /**
      * List of element name patterns from xsl:strip-space declarations.
      * Whitespace-only text nodes inside matching elements will be stripped.
@@ -756,6 +776,21 @@ declare class Xslt {
      * @param output If set, the output where the transformation should occur.
      */
     protected xsltProcessContext(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Handle unknown XSLT instructions per XSLT 1.0 Section 2.5 (Forwards-Compatible Processing).
+     *
+     * In forwards-compatible mode (version > 1.0):
+     * - If the instruction has an xsl:fallback child, execute the fallback
+     * - Otherwise, the instruction is silently ignored
+     *
+     * In strict mode (version = 1.0):
+     * - Unknown instructions are an error
+     *
+     * @param context The Expression Context
+     * @param template The unknown XSLT instruction element
+     * @param output The output node
+     */
+    protected xsltUnknownInstruction(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
     /**
      * Implements `xsl:apply-templates`.
      * @param context The Expression Context.
@@ -909,29 +944,57 @@ declare class Xslt {
      * @param context The Expression Context.
      * @param level The counting level: 'single', 'multiple', or 'any'.
      * @param count Pattern to match nodes to count.
-     * @param from Pattern to start counting from.
-     * @returns The count value.
+     * @param from Pattern to define counting boundary.
+     * @returns Array of count values (single element for 'single'/'any', multiple for 'multiple').
      */
-    protected xsltNumberCount(context: ExprContext, level: string, count: string | null, from: string | null): number;
+    protected xsltNumberCount(context: ExprContext, level: string, count: string | null, from: string | null): number[];
     /**
-     * Checks if a node matches a simple name pattern.
+     * Checks if a node matches a pattern (supports simple names and union patterns).
      * @param node The node to check.
-     * @param pattern The pattern (node name) to match.
+     * @param pattern The pattern (node name, wildcard, or union like "a|b|c").
      * @returns True if the node matches.
      */
     protected nodeMatchesPattern(node: XNode, pattern: string): boolean;
+    /**
+     * Checks if a node matches a single (non-union) pattern.
+     * @param node The node to check.
+     * @param pattern The pattern (node name or wildcard).
+     * @returns True if the node matches.
+     */
+    protected nodeMatchesSinglePattern(node: XNode, pattern: string): boolean;
     /**
      * Gets all nodes preceding the given node in document order.
      * @param node The reference node.
+     * @param fromPattern Optional pattern to define counting boundary.
      * @returns Array of preceding nodes.
      */
-    protected getAllPrecedingNodes(node: XNode): XNode[];
+    protected getAllPrecedingNodes(node: XNode, fromPattern?: string | null): XNode[];
     /**
      * Collects all descendant nodes of a given node.
      * @param node The parent node.
      * @param result The array to collect into.
      */
     protected collectDescendants(node: XNode, result: XNode[]): void;
+    /**
+     * Formats an array of numbers according to the format string.
+     * For level="multiple", numbers like [1, 2, 3] with format "1.1.1" produce "1.2.3".
+     * @param numbers The numbers to format.
+     * @param format The format string (e.g., "1", "1.1", "1.a.i").
+     * @param groupingSeparator Optional grouping separator.
+     * @param groupingSize Optional grouping size.
+     * @returns The formatted number string.
+     */
+    protected xsltFormatNumbers(numbers: number[], format: string, groupingSeparator: string | null, groupingSize: string | null): string;
+    /**
+     * Parses a format string into tokens and separators.
+     * E.g., "1.a.i" -> tokens: ["1", "a", "i"], separators: [".", "."]
+     * @param format The format string.
+     * @returns Object with tokens and separators arrays.
+     */
+    protected parseFormatString(format: string): {
+        tokens: string[];
+        separators: string[];
+    };
     /**
      * Formats a number according to the format string.
      * @param number The number to format.