xslt-processor 4.8.0 → 4.8.2

package/index.d.mts

@@ -833,11 +833,21 @@ declare class Xslt {
      * Manages loaded packages and their components.
      */
     private packageRegistry;
+    /**
+     * Callback for loading external packages.
+     * Called when a package is not found in the registry.
+     */
+    private packageLoader?;
     /**
      * Current package being processed (for XSLT 3.0).
      * null if processing a non-package stylesheet.
      */
     private currentPackage;
+    /**
+     * Current override context (for XSLT 3.0 xsl:original).
+     * Tracks the original component when executing an override.
+     */
+    private currentOverrideContext;
     /**
      * Accumulator registry for XSLT 3.0 accumulators.
      * Stores accumulator definitions and current state during processing.
@@ -1100,6 +1110,15 @@ declare class Xslt {
      * @param output The output node.
      */
     protected xsltPackage(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Loads and registers an external package.
+     * Creates a temporary context and processes the package document.
+     *
+     * @param name The package name/URI.
+     * @param packageDoc The parsed package document.
+     * @param version Optional semantic version string.
+     */
+    protected loadAndRegisterPackage(name: string, packageDoc: XNode, version?: string): Promise<void>;
     /**
      * Implements `<xsl:use-package>` (XSLT 3.0 Section 3.7).
      * Imports another package and makes its public components available.
@@ -1115,6 +1134,14 @@ declare class Xslt {
      * @param template The xsl:expose element.
      */
     protected xsltExpose(context: ExprContext, template: XNode): void;
+    /**
+     * Find a component definition in the package root.
+     * @param packageRoot The package root element
+     * @param type The component type to find
+     * @param name The component name (null for all matching type)
+     * @returns Component information or null if not found
+     */
+    private findComponentInPackageRoot;
     /**
      * Implements `<xsl:accept>` (XSLT 3.0 Section 3.9).
      * Accepts and optionally overrides a component from a used package.
@@ -1122,6 +1149,55 @@ declare class Xslt {
      * @param template The xsl:accept element.
      */
     protected xsltAccept(context: ExprContext, template: XNode): void;
+    /**
+     * Implements <xsl:override> (XSLT 3.0 Section 3.7.2).
+     * Overrides components from a used package.
+     */
+    protected xsltOverride(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Find components in a package matching the given criteria.
+     * Used by xsl:accept to locate components from used packages.
+     *
+     * @param pkg The package to search in
+     * @param componentType The type of component to find
+     * @param namePatterns Array of name patterns ('*' for all, or specific names)
+     * @returns Array of matching components
+     */
+    private findComponentsInPackage;
+    /**
+     * Get the name to use when matching components.
+     * For named components (functions, variables, attribute-sets), returns the name.
+     * For templates, returns the name if present, otherwise returns null (match-based templates).
+     *
+     * @param component The component to get the name from
+     * @returns The component name for matching, or null if unnamed
+     */
+    private getComponentNameForMatching;
+    /**
+     * Implements <xsl:original> (XSLT 3.0 Section 3.7.2).
+     * Calls the original component from within an override.
+     */
+    protected xsltOriginal(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Implements `<xsl:mode>` (XSLT 3.0 Section 3.5).
+     * Declares a mode with visibility and other properties.
+     * Only valid within an xsl:package.
+     */
+    protected xsltMode(context: ExprContext, template: XNode): void;
+    /**
+     * Get the effective component, checking for overrides first.
+     * If the component has been overridden in the current package, returns the override.
+     * Otherwise, returns the original component.
+     * @param component The original component
+     * @returns The effective component (override or original)
+     */
+    private getEffectiveComponent;
+    /**
+     * Collect templates from accepted components in used packages.
+     * @param mode The mode to match (null for default mode)
+     * @returns Array of template priority interfaces
+     */
+    private collectAcceptedTemplates;
     /**
      * Implements `<xsl:stream>` (XSLT 3.0 Section 16).
      * Enables streaming processing of large documents.
@@ -1372,6 +1448,14 @@ declare class Xslt {
      * @param template The xsl:function element.
      */
     protected xsltFunction(context: ExprContext, template: XNode): void;
+    /**
+     * Coerce a NodeValue to a specific type based on the 'as' attribute.
+     *
+     * @param value The value to coerce.
+     * @param type The target type (e.g., "xs:integer", "xs:string", "xs:boolean").
+     * @returns The coerced value.
+     */
+    protected coerceToType(value: NodeValue, type: string): NodeValue;
     /**
      * Execute a user-defined xsl:function.
      * Called when a function from userDefinedFunctions is invoked from XPath.
@@ -1408,6 +1492,24 @@ declare class Xslt {
      * @returns A map of href URIs to serialized output strings.
      */
     getResultDocuments(): Map<string, string>;
+    /**
+     * Sets the package loader callback.
+     * The callback is called when a package is referenced via xsl:use-package
+     * but is not found in the registry.
+     *
+     * @param loader A function that loads package documents by URI and optional version.
+     *               Returns the parsed package document, or null if not found.
+     */
+    setPackageLoader(loader: (uri: string, version?: string) => Promise<XNode | null>): void;
+    /**
+     * Pre-registers a package for use in transformations.
+     * The package is parsed and stored in the internal registry.
+     *
+     * @param name The package name/URI.
+     * @param packageDoc The parsed package document.
+     * @param version Optional semantic version string.
+     */
+    registerPackage(name: string, packageDoc: XNode, version?: string): Promise<void>;
     /**
      * Implements `xsl:perform-sort` (XSLT 2.0).
      *
@@ -1441,6 +1543,12 @@ declare class Xslt {
      * value. `xsl:variable` and `xsl:with-param` override; `xsl:param` doesn't.
      */
     protected xsltVariable(context: ExprContext, template: XNode, override: boolean): Promise<void>;
+    /**
+     * Register accepted variables from used packages into the context.
+     * Called after processing package use-package declarations.
+     * @param context The expression context.
+     */
+    private registerAcceptedVariables;
     /**
      * Traverses the template node tree. Calls the main processing
      * function with the current input context for every child node of the
@@ -1553,6 +1661,15 @@ declare class Xslt {
      * @param context The expression context.
      */
     private registerUserDefinedFunctionsInContext;
+    /**
+     * Check if there are any accepted functions in used packages.
+     */
+    private hasAcceptedFunctions;
+    /**
+     * Register accepted functions from used packages.
+     * @param functionsMap The map to register functions into.
+     */
+    private registerAcceptedFunctions;
     /**
      * Apply one or more attribute sets to an element.
      * Parses space-separated attribute set names and applies them.

package/index.d.ts

@@ -833,11 +833,21 @@ declare class Xslt {
      * Manages loaded packages and their components.
      */
     private packageRegistry;
+    /**
+     * Callback for loading external packages.
+     * Called when a package is not found in the registry.
+     */
+    private packageLoader?;
     /**
      * Current package being processed (for XSLT 3.0).
      * null if processing a non-package stylesheet.
      */
     private currentPackage;
+    /**
+     * Current override context (for XSLT 3.0 xsl:original).
+     * Tracks the original component when executing an override.
+     */
+    private currentOverrideContext;
     /**
      * Accumulator registry for XSLT 3.0 accumulators.
      * Stores accumulator definitions and current state during processing.
@@ -1100,6 +1110,15 @@ declare class Xslt {
      * @param output The output node.
      */
     protected xsltPackage(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Loads and registers an external package.
+     * Creates a temporary context and processes the package document.
+     *
+     * @param name The package name/URI.
+     * @param packageDoc The parsed package document.
+     * @param version Optional semantic version string.
+     */
+    protected loadAndRegisterPackage(name: string, packageDoc: XNode, version?: string): Promise<void>;
     /**
      * Implements `<xsl:use-package>` (XSLT 3.0 Section 3.7).
      * Imports another package and makes its public components available.
@@ -1115,6 +1134,14 @@ declare class Xslt {
      * @param template The xsl:expose element.
      */
     protected xsltExpose(context: ExprContext, template: XNode): void;
+    /**
+     * Find a component definition in the package root.
+     * @param packageRoot The package root element
+     * @param type The component type to find
+     * @param name The component name (null for all matching type)
+     * @returns Component information or null if not found
+     */
+    private findComponentInPackageRoot;
     /**
      * Implements `<xsl:accept>` (XSLT 3.0 Section 3.9).
      * Accepts and optionally overrides a component from a used package.
@@ -1122,6 +1149,55 @@ declare class Xslt {
      * @param template The xsl:accept element.
      */
     protected xsltAccept(context: ExprContext, template: XNode): void;
+    /**
+     * Implements <xsl:override> (XSLT 3.0 Section 3.7.2).
+     * Overrides components from a used package.
+     */
+    protected xsltOverride(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Find components in a package matching the given criteria.
+     * Used by xsl:accept to locate components from used packages.
+     *
+     * @param pkg The package to search in
+     * @param componentType The type of component to find
+     * @param namePatterns Array of name patterns ('*' for all, or specific names)
+     * @returns Array of matching components
+     */
+    private findComponentsInPackage;
+    /**
+     * Get the name to use when matching components.
+     * For named components (functions, variables, attribute-sets), returns the name.
+     * For templates, returns the name if present, otherwise returns null (match-based templates).
+     *
+     * @param component The component to get the name from
+     * @returns The component name for matching, or null if unnamed
+     */
+    private getComponentNameForMatching;
+    /**
+     * Implements <xsl:original> (XSLT 3.0 Section 3.7.2).
+     * Calls the original component from within an override.
+     */
+    protected xsltOriginal(context: ExprContext, template: XNode, output?: XNode): Promise<void>;
+    /**
+     * Implements `<xsl:mode>` (XSLT 3.0 Section 3.5).
+     * Declares a mode with visibility and other properties.
+     * Only valid within an xsl:package.
+     */
+    protected xsltMode(context: ExprContext, template: XNode): void;
+    /**
+     * Get the effective component, checking for overrides first.
+     * If the component has been overridden in the current package, returns the override.
+     * Otherwise, returns the original component.
+     * @param component The original component
+     * @returns The effective component (override or original)
+     */
+    private getEffectiveComponent;
+    /**
+     * Collect templates from accepted components in used packages.
+     * @param mode The mode to match (null for default mode)
+     * @returns Array of template priority interfaces
+     */
+    private collectAcceptedTemplates;
     /**
      * Implements `<xsl:stream>` (XSLT 3.0 Section 16).
      * Enables streaming processing of large documents.
@@ -1372,6 +1448,14 @@ declare class Xslt {
      * @param template The xsl:function element.
      */
     protected xsltFunction(context: ExprContext, template: XNode): void;
+    /**
+     * Coerce a NodeValue to a specific type based on the 'as' attribute.
+     *
+     * @param value The value to coerce.
+     * @param type The target type (e.g., "xs:integer", "xs:string", "xs:boolean").
+     * @returns The coerced value.
+     */
+    protected coerceToType(value: NodeValue, type: string): NodeValue;
     /**
      * Execute a user-defined xsl:function.
      * Called when a function from userDefinedFunctions is invoked from XPath.
@@ -1408,6 +1492,24 @@ declare class Xslt {
      * @returns A map of href URIs to serialized output strings.
      */
     getResultDocuments(): Map<string, string>;
+    /**
+     * Sets the package loader callback.
+     * The callback is called when a package is referenced via xsl:use-package
+     * but is not found in the registry.
+     *
+     * @param loader A function that loads package documents by URI and optional version.
+     *               Returns the parsed package document, or null if not found.
+     */
+    setPackageLoader(loader: (uri: string, version?: string) => Promise<XNode | null>): void;
+    /**
+     * Pre-registers a package for use in transformations.
+     * The package is parsed and stored in the internal registry.
+     *
+     * @param name The package name/URI.
+     * @param packageDoc The parsed package document.
+     * @param version Optional semantic version string.
+     */
+    registerPackage(name: string, packageDoc: XNode, version?: string): Promise<void>;
     /**
      * Implements `xsl:perform-sort` (XSLT 2.0).
      *
@@ -1441,6 +1543,12 @@ declare class Xslt {
      * value. `xsl:variable` and `xsl:with-param` override; `xsl:param` doesn't.
      */
     protected xsltVariable(context: ExprContext, template: XNode, override: boolean): Promise<void>;
+    /**
+     * Register accepted variables from used packages into the context.
+     * Called after processing package use-package declarations.
+     * @param context The expression context.
+     */
+    private registerAcceptedVariables;
     /**
      * Traverses the template node tree. Calls the main processing
      * function with the current input context for every child node of the
@@ -1553,6 +1661,15 @@ declare class Xslt {
      * @param context The expression context.
      */
     private registerUserDefinedFunctionsInContext;
+    /**
+     * Check if there are any accepted functions in used packages.
+     */
+    private hasAcceptedFunctions;
+    /**
+     * Register accepted functions from used packages.
+     * @param functionsMap The map to register functions into.
+     */
+    private registerAcceptedFunctions;
     /**
      * Apply one or more attribute sets to an element.
      * Parses space-separated attribute set names and applies them.