xslt-processor 4.4.1 → 4.5.0

package/index.d.mts

@@ -73,6 +73,7 @@ declare class XDocument extends XNode {
     createComment(data: any): XNode;
     createCDATASection(data: any): XNode;
     createDTDSection(data: any): XNode;
+    createProcessingInstruction(target: string, data: any): XNode;
 }
 
 /**
@@ -598,6 +599,37 @@ declare class Xslt {
      * Maps stylesheet namespace prefixes to result namespace prefixes.
      */
     namespaceAliases: Map<string, string>;
+    /**
+     * Set of supported extension element namespaces.
+     * Processors can register custom extension namespaces here.
+     * Currently only XSLT namespace is auto-registered.
+     */
+    supportedExtensions: Set<string>;
+    /**
+     * Map of attribute sets defined in the stylesheet.
+     * Keys are attribute set names, values are arrays of xsl:attribute nodes.
+     */
+    attributeSets: Map<string, XNode[]>;
+    /**
+     * Stack of stylesheet metadata for tracking import hierarchy.
+     * Used by apply-imports to find templates from imported stylesheets.
+     */
+    private styleSheetStack;
+    /**
+     * Map of imported stylesheet HREFs to their parsed XNodes.
+     * Prevents duplicate imports and allows precedence tracking.
+     */
+    private importedStylesheets;
+    /**
+     * Map templates to the stylesheet they came from.
+     * Enables apply-imports to find templates by import precedence.
+     */
+    private templateSourceMap;
+    /**
+     * Stack of currently executing templates with their metadata.
+     * Used by apply-imports to determine which template called it.
+     */
+    private currentTemplateStack;
     constructor(options?: Partial<XsltOptions>);
     /**
      * The exported entry point of the XSL-T processor.
@@ -621,6 +653,16 @@ declare class Xslt {
      * @protected
      */
     protected xsltApplyTemplates(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Implements `xsl:apply-imports`.
+     * Applies templates from imported stylesheets with the same match pattern and mode.
+     * This enables template overriding where a template in an importing stylesheet
+     * can call the overridden template from the imported stylesheet.
+     * @param context The Expression Context.
+     * @param template The apply-imports template node.
+     * @param output The output node.
+     */
+    protected xsltApplyImports(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
     /**
      * Implements `xsl:attribute`.
      * @param context The Expression Context.
@@ -658,6 +700,13 @@ declare class Xslt {
      * @param output The output. Only used if there's no corresponding output node already defined.
      */
     protected xsltComment(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Implements `xsl:processing-instruction`.
+     * @param context The Expression Context.
+     * @param template The template.
+     * @param output The output. Only used if there's no corresponding output node already defined.
+     */
+    protected xsltProcessingInstruction(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
     /**
      * Implements `xsl:copy-of` for node-set values of the select
      * expression. Recurses down the source node tree, which is part of
@@ -957,6 +1006,58 @@ declare class Xslt {
      * @param template The template node.
      */
     protected xsltWithParam(context: ExprContext, template: XNode): Promise<void>;
+    /**
+     * Recursively map all template nodes in a stylesheet to their metadata.
+     * Used to track which stylesheet each template comes from for apply-imports.
+     * @param stylesheetElement The stylesheet or transform element (or any parent element).
+     * @param metadata The metadata for this stylesheet.
+     */
+    private mapTemplatesFromStylesheet;
+    /**
+     * Collect all attribute set definitions from the stylesheet.
+     * Called at stylesheet initialization time.
+     * @param stylesheetElement The stylesheet or transform element.
+     */
+    private collectAttributeSets;
+    /**
+     * Apply one or more attribute sets to an element.
+     * Parses space-separated attribute set names and applies them.
+     * @param context The Expression Context.
+     * @param element The element to apply attributes to.
+     * @param setNames Space-separated attribute set names.
+     */
+    protected applyAttributeSets(context: ExprContext, element: XNode, setNames: string): Promise<void>;
+    /**
+     * Apply a single attribute set to an element.
+     * Handles recursive attribute sets with cycle detection.
+     * @param context The Expression Context.
+     * @param element The element to apply attributes to.
+     * @param setName The name of the attribute set to apply.
+     * @param processedSets Set of already-processed attribute set names (for cycle detection).
+     */
+    private applyAttributeSet;
+    /**
+     * Test if an element is a supported extension.
+     * Returns false for unrecognized elements in non-XSLT namespaces.
+     * @param node The element to test.
+     * @returns True if the element is supported, false if it's an unrecognized extension.
+     */
+    protected isExtensionElementSupported(node: XNode): boolean;
+    /**
+     * Get the fallback element from an extension element if it exists.
+     * Searches for the first direct xsl:fallback child.
+     * @param node The extension element.
+     * @returns The fallback element, or null if not found.
+     */
+    protected getFallbackElement(node: XNode): XNode | null;
+    /**
+     * Process an extension element with fallback support.
+     * If a fallback is defined, executes it; otherwise treats element as literal.
+     * @param context The Expression Context.
+     * @param element The extension element.
+     * @param output The output node.
+     */
+    protected xsltExtensionElement(context: ExprContext, element: XNode, output?: XNode): Promise<void>;
     /**
      * Test if the given element is an XSLT element, optionally the one with the given name.
      * @param {XNode} element The element.

package/index.d.ts

@@ -73,6 +73,7 @@ declare class XDocument extends XNode {
     createComment(data: any): XNode;
     createCDATASection(data: any): XNode;
     createDTDSection(data: any): XNode;
+    createProcessingInstruction(target: string, data: any): XNode;
 }
 
 /**
@@ -598,6 +599,37 @@ declare class Xslt {
      * Maps stylesheet namespace prefixes to result namespace prefixes.
      */
     namespaceAliases: Map<string, string>;
+    /**
+     * Set of supported extension element namespaces.
+     * Processors can register custom extension namespaces here.
+     * Currently only XSLT namespace is auto-registered.
+     */
+    supportedExtensions: Set<string>;
+    /**
+     * Map of attribute sets defined in the stylesheet.
+     * Keys are attribute set names, values are arrays of xsl:attribute nodes.
+     */
+    attributeSets: Map<string, XNode[]>;
+    /**
+     * Stack of stylesheet metadata for tracking import hierarchy.
+     * Used by apply-imports to find templates from imported stylesheets.
+     */
+    private styleSheetStack;
+    /**
+     * Map of imported stylesheet HREFs to their parsed XNodes.
+     * Prevents duplicate imports and allows precedence tracking.
+     */
+    private importedStylesheets;
+    /**
+     * Map templates to the stylesheet they came from.
+     * Enables apply-imports to find templates by import precedence.
+     */
+    private templateSourceMap;
+    /**
+     * Stack of currently executing templates with their metadata.
+     * Used by apply-imports to determine which template called it.
+     */
+    private currentTemplateStack;
     constructor(options?: Partial<XsltOptions>);
     /**
      * The exported entry point of the XSL-T processor.
@@ -621,6 +653,16 @@ declare class Xslt {
      * @protected
      */
     protected xsltApplyTemplates(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Implements `xsl:apply-imports`.
+     * Applies templates from imported stylesheets with the same match pattern and mode.
+     * This enables template overriding where a template in an importing stylesheet
+     * can call the overridden template from the imported stylesheet.
+     * @param context The Expression Context.
+     * @param template The apply-imports template node.
+     * @param output The output node.
+     */
+    protected xsltApplyImports(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
     /**
      * Implements `xsl:attribute`.
      * @param context The Expression Context.
@@ -658,6 +700,13 @@ declare class Xslt {
      * @param output The output. Only used if there's no corresponding output node already defined.
      */
     protected xsltComment(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Implements `xsl:processing-instruction`.
+     * @param context The Expression Context.
+     * @param template The template.
+     * @param output The output. Only used if there's no corresponding output node already defined.
+     */
+    protected xsltProcessingInstruction(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
     /**
      * Implements `xsl:copy-of` for node-set values of the select
      * expression. Recurses down the source node tree, which is part of
@@ -957,6 +1006,58 @@ declare class Xslt {
      * @param template The template node.
      */
     protected xsltWithParam(context: ExprContext, template: XNode): Promise<void>;
+    /**
+     * Recursively map all template nodes in a stylesheet to their metadata.
+     * Used to track which stylesheet each template comes from for apply-imports.
+     * @param stylesheetElement The stylesheet or transform element (or any parent element).
+     * @param metadata The metadata for this stylesheet.
+     */
+    private mapTemplatesFromStylesheet;
+    /**
+     * Collect all attribute set definitions from the stylesheet.
+     * Called at stylesheet initialization time.
+     * @param stylesheetElement The stylesheet or transform element.
+     */
+    private collectAttributeSets;
+    /**
+     * Apply one or more attribute sets to an element.
+     * Parses space-separated attribute set names and applies them.
+     * @param context The Expression Context.
+     * @param element The element to apply attributes to.
+     * @param setNames Space-separated attribute set names.
+     */
+    protected applyAttributeSets(context: ExprContext, element: XNode, setNames: string): Promise<void>;
+    /**
+     * Apply a single attribute set to an element.
+     * Handles recursive attribute sets with cycle detection.
+     * @param context The Expression Context.
+     * @param element The element to apply attributes to.
+     * @param setName The name of the attribute set to apply.
+     * @param processedSets Set of already-processed attribute set names (for cycle detection).
+     */
+    private applyAttributeSet;
+    /**
+     * Test if an element is a supported extension.
+     * Returns false for unrecognized elements in non-XSLT namespaces.
+     * @param node The element to test.
+     * @returns True if the element is supported, false if it's an unrecognized extension.
+     */
+    protected isExtensionElementSupported(node: XNode): boolean;
+    /**
+     * Get the fallback element from an extension element if it exists.
+     * Searches for the first direct xsl:fallback child.
+     * @param node The extension element.
+     * @returns The fallback element, or null if not found.
+     */
+    protected getFallbackElement(node: XNode): XNode | null;
+    /**
+     * Process an extension element with fallback support.
+     * If a fallback is defined, executes it; otherwise treats element as literal.
+     * @param context The Expression Context.
+     * @param element The extension element.
+     * @param output The output node.
+     */
+    protected xsltExtensionElement(context: ExprContext, element: XNode, output?: XNode): Promise<void>;
     /**
      * Test if the given element is an XSLT element, optionally the one with the given name.
      * @param {XNode} element The element.