@openrewrite/rewrite 8.66.1 → 8.66.3

package/dist/javascript/templating/capture.d.ts

@@ -1,5 +1,6 @@
-import { J } from '../../java';
-import { Capture, Any, TemplateParam, CaptureOptions, VariadicOptions } from './types';
+import { Cursor } from '../..';
+import { J, Type } from '../../java';
+import { Any, Capture, CaptureOptions, ConstraintFunction, TemplateParam, VariadicOptions } from './types';
 /**
  * Combines multiple constraints with AND logic.
  * All constraints must return true for the combined constraint to pass.
@@ -13,7 +14,7 @@ import { Capture, Any, TemplateParam, CaptureOptions, VariadicOptions } from './
  *     )
  * });
  */
-export declare function and<T>(...constraints: ((node: T) => boolean)[]): (node: T) => boolean;
+export declare function and<T>(...constraints: ((node: T, cursor?: Cursor) => boolean)[]): (node: T, cursor?: Cursor) => boolean;
 /**
  * Combines multiple constraints with OR logic.
  * At least one constraint must return true for the combined constraint to pass.
@@ -26,7 +27,7 @@ export declare function and<T>(...constraints: ((node: T) => boolean)[]): (node:
  *     )
  * });
  */
-export declare function or<T>(...constraints: ((node: T) => boolean)[]): (node: T) => boolean;
+export declare function or<T>(...constraints: ((node: T, cursor?: Cursor) => boolean)[]): (node: T, cursor?: Cursor) => boolean;
 /**
  * Negates a constraint.
  * Returns true when the constraint returns false, and vice versa.
@@ -36,23 +37,27 @@ export declare function or<T>(...constraints: ((node: T) => boolean)[]): (node:
  *     constraint: not((node) => typeof node.value === 'string')
  * });
  */
-export declare function not<T>(constraint: (node: T) => boolean): (node: T) => boolean;
+export declare function not<T>(constraint: (node: T, cursor?: Cursor) => boolean): (node: T, cursor?: Cursor) => boolean;
 export declare const CAPTURE_NAME_SYMBOL: unique symbol;
 export declare const CAPTURE_VARIADIC_SYMBOL: unique symbol;
 export declare const CAPTURE_CONSTRAINT_SYMBOL: unique symbol;
 export declare const CAPTURE_CAPTURING_SYMBOL: unique symbol;
+export declare const CAPTURE_TYPE_SYMBOL: unique symbol;
+export declare const RAW_CODE_SYMBOL: unique symbol;
 export declare class CaptureImpl<T = any> implements Capture<T> {
     readonly name: string;
     [CAPTURE_NAME_SYMBOL]: string;
     [CAPTURE_VARIADIC_SYMBOL]: VariadicOptions | undefined;
-    [CAPTURE_CONSTRAINT_SYMBOL]: ((node: T) => boolean) | undefined;
+    [CAPTURE_CONSTRAINT_SYMBOL]: ConstraintFunction<T> | undefined;
     [CAPTURE_CAPTURING_SYMBOL]: boolean;
+    [CAPTURE_TYPE_SYMBOL]: string | Type | undefined;
     constructor(name: string, options?: CaptureOptions<T>, capturing?: boolean);
     getName(): string;
     isVariadic(): boolean;
     getVariadicOptions(): VariadicOptions | undefined;
-    getConstraint(): ((node: T) => boolean) | undefined;
+    getConstraint(): ConstraintFunction<T> | undefined;
     isCapturing(): boolean;
+    getType(): string | Type | undefined;
 }
 export declare class TemplateParamImpl<T = any> implements TemplateParam<T> {
     readonly name: string;
@@ -85,16 +90,13 @@ export declare class CaptureValue {
      */
     isArrayExpansion(): boolean;
 }
-export declare function capture<T = any>(options: {
-    name?: string;
-    constraint: (node: T) => boolean;
-} & {
+export declare function capture<T = any>(options: CaptureOptions<T> & {
     variadic?: never;
 }): Capture<T> & T;
 export declare function capture<T = any>(options: {
     name?: string;
     variadic: true | VariadicOptions;
-    constraint?: (nodes: T[]) => boolean;
+    constraint?: ConstraintFunction<T[]>;
     min?: number;
     max?: number;
 }): Capture<T[]> & T[];
@@ -153,13 +155,13 @@ export declare namespace capture {
  * const pat = pattern`sum(${numericArgs})`;
  */
 export declare function any<T = any>(options: {
-    constraint: (node: T) => boolean;
+    constraint: ConstraintFunction<T>;
 } & {
     variadic?: never;
 }): Any<T> & T;
 export declare function any<T = any>(options: {
     variadic: true | VariadicOptions;
-    constraint?: (nodes: T[]) => boolean;
+    constraint?: ConstraintFunction<T[]>;
     min?: number;
     max?: number;
 }): Any<T[]> & T[];
@@ -211,6 +213,71 @@ export declare namespace any {
  * template`console.log(${node.name})`  // Error! Use capture() for property access
  */
 export declare function param<T = any>(name?: string): TemplateParam<T>;
+/**
+ * Represents raw code that should be inserted verbatim into templates at construction time.
+ * This is useful for dynamic code generation where the code structure is determined at runtime.
+ */
+export declare class RawCode {
+    readonly code: string;
+    [RAW_CODE_SYMBOL]: boolean;
+    constructor(code: string);
+}
+/**
+ * Creates a raw code specification for inserting literal code strings into templates.
+ *
+ * Use `raw()` when you need to insert code that is generated dynamically (e.g., from recipe options,
+ * computed field names, or programmatic string manipulation) directly into a template at construction time.
+ *
+ * The string is spliced into the template before parsing, so it becomes part of the template's AST.
+ * This is different from `param()` or `capture()` which are placeholders replaced during application.
+ *
+ * @param code The code string to insert verbatim into the template
+ * @returns A RawCode object that will be spliced into the template
+ *
+ * @remarks
+ * **When to use `raw()` vs `param()` vs `capture()`:**
+ *
+ * - Use `raw()` when you have a **code string** to insert at **template construction time**
+ * - Use `param()` when you have an **AST node** to substitute at **template application time**
+ * - Use `capture()` when working with **pattern matching** and need to reference matched values
+ *
+ * **Safety Considerations:**
+ * - No validation is performed on the code string
+ * - The code must be syntactically valid at the position where it's inserted
+ * - Recipe authors are trusted to provide valid code
+ *
+ * @example
+ * // Recipe option determines the log level
+ * class MyRecipe extends Recipe {
+ *     @Option
+ *     logLevel: string = "info";
+ *
+ *     getVisitor() {
+ *         // Template constructed with dynamic method name
+ *         const replacement = template`logger.${raw(this.logLevel)}(${_('msg')})`;
+ *         // Produces: logger.info(...) or logger.warn(...) etc.
+ *     }
+ * }
+ *
+ * @example
+ * // Build object literal from collected field names
+ * const fields = ["userId", "timestamp", "status"];
+ * template`{ ${raw(fields.join(', '))} }`
+ * // Produces: { userId, timestamp, status }
+ *
+ * @example
+ * // Dynamic import path
+ * const modulePath = "./utils";
+ * template`import { helper } from ${raw(`'${modulePath}'`)}`
+ * // Produces: import { helper } from './utils'
+ *
+ * @example
+ * // Configurable operator
+ * const operator = ">=";
+ * template`${_('value')} ${raw(operator)} threshold`
+ * // Produces: value >= threshold
+ */
+export declare function raw(code: string): RawCode;
 /**
  * Concise alias for `capture`. Works well for inline captures in patterns and templates.
  *

package/dist/javascript/templating/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/javascript/templating/capture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/javascript/templating/capture.ts"],"names":[],"mappings":"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"}

package/dist/javascript/templating/capture.js

@@ -1,12 +1,14 @@
 "use strict";
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._ = exports.CaptureValue = exports.TemplateParamImpl = exports.CaptureImpl = exports.CAPTURE_CAPTURING_SYMBOL = exports.CAPTURE_CONSTRAINT_SYMBOL = exports.CAPTURE_VARIADIC_SYMBOL = exports.CAPTURE_NAME_SYMBOL = void 0;
+exports._ = exports.RawCode = exports.CaptureValue = exports.TemplateParamImpl = exports.CaptureImpl = exports.RAW_CODE_SYMBOL = exports.CAPTURE_TYPE_SYMBOL = exports.CAPTURE_CAPTURING_SYMBOL = exports.CAPTURE_CONSTRAINT_SYMBOL = exports.CAPTURE_VARIADIC_SYMBOL = exports.CAPTURE_NAME_SYMBOL = void 0;
 exports.and = and;
 exports.or = or;
 exports.not = not;
 exports.capture = capture;
 exports.any = any;
 exports.param = param;
+exports.raw = raw;
 /**
  * Combines multiple constraints with AND logic.
  * All constraints must return true for the combined constraint to pass.
@@ -21,7 +23,7 @@ exports.param = param;
  * });
  */
 function and(...constraints) {
-    return (node) => constraints.every(c => c(node));
+    return (node, cursor) => constraints.every(c => c(node, cursor));
 }
 /**
  * Combines multiple constraints with OR logic.
@@ -36,7 +38,7 @@ function and(...constraints) {
  * });
  */
 function or(...constraints) {
-    return (node) => constraints.some(c => c(node));
+    return (node, cursor) => constraints.some(c => c(node, cursor));
 }
 /**
  * Negates a constraint.
@@ -48,7 +50,7 @@ function or(...constraints) {
  * });
  */
 function not(constraint) {
-    return (node) => !constraint(node);
+    return (node, cursor) => !constraint(node, cursor);
 }
 // Symbol to access the internal capture name without triggering Proxy
 exports.CAPTURE_NAME_SYMBOL = Symbol('captureName');
@@ -58,6 +60,10 @@ exports.CAPTURE_VARIADIC_SYMBOL = Symbol('captureVariadic');
 exports.CAPTURE_CONSTRAINT_SYMBOL = Symbol('captureConstraint');
 // Symbol to access capturing flag without triggering Proxy
 exports.CAPTURE_CAPTURING_SYMBOL = Symbol('captureCapturing');
+// Symbol to access type information without triggering Proxy
+exports.CAPTURE_TYPE_SYMBOL = Symbol('captureType');
+// Symbol to identify RawCode instances
+exports.RAW_CODE_SYMBOL = Symbol('rawCode');
 class CaptureImpl {
     constructor(name, options, capturing = true) {
         this.name = name;
@@ -79,6 +85,10 @@ class CaptureImpl {
         if (options === null || options === void 0 ? void 0 : options.constraint) {
             this[exports.CAPTURE_CONSTRAINT_SYMBOL] = options.constraint;
         }
+        // Store type if provided
+        if (options === null || options === void 0 ? void 0 : options.type) {
+            this[exports.CAPTURE_TYPE_SYMBOL] = options.type;
+        }
     }
     getName() {
         return this[exports.CAPTURE_NAME_SYMBOL];
@@ -95,6 +105,9 @@ class CaptureImpl {
     isCapturing() {
         return this[exports.CAPTURE_CAPTURING_SYMBOL];
     }
+    getType() {
+        return this[exports.CAPTURE_TYPE_SYMBOL];
+    }
 }
 exports.CaptureImpl = CaptureImpl;
 class TemplateParamImpl {
@@ -151,11 +164,11 @@ class CaptureValue {
      * Checks if this CaptureValue will resolve to an array that should be expanded.
      */
     isArrayExpansion() {
-        var _a, _b, _c;
+        var _b, _c, _d;
         // Only slice operations and the root variadic capture return arrays
-        return ((_a = this.arrayOperation) === null || _a === void 0 ? void 0 : _a.type) === 'slice' ||
+        return ((_b = this.arrayOperation) === null || _b === void 0 ? void 0 : _b.type) === 'slice' ||
             (this.arrayOperation === undefined && this.propertyPath.length === 0 &&
-                ((_c = (_b = this.rootCapture).isVariadic) === null || _c === void 0 ? void 0 : _c.call(_b)));
+                ((_d = (_c = this.rootCapture).isVariadic) === null || _d === void 0 ? void 0 : _d.call(_c)));
     }
 }
 exports.CaptureValue = CaptureValue;
@@ -251,8 +264,15 @@ function createCaptureProxy(impl) {
             if (prop === exports.CAPTURE_CAPTURING_SYMBOL) {
                 return target[exports.CAPTURE_CAPTURING_SYMBOL];
             }
+            if (prop === exports.CAPTURE_TYPE_SYMBOL) {
+                return target[exports.CAPTURE_TYPE_SYMBOL];
+            }
+            // Support using Capture as object key via computed properties {[x]: value}
+            if (prop === Symbol.toPrimitive || prop === 'toString' || prop === 'valueOf') {
+                return () => target[exports.CAPTURE_NAME_SYMBOL];
+            }
             // Allow methods to be called directly on the target
-            if (prop === 'getName' || prop === 'isVariadic' || prop === 'getVariadicOptions' || prop === 'getConstraint' || prop === 'isCapturing') {
+            if (prop === 'getName' || prop === 'isVariadic' || prop === 'getVariadicOptions' || prop === 'getConstraint' || prop === 'isCapturing' || prop === 'getType') {
                 return target[prop].bind(target);
             }
             // For variadic captures, support array-like operations
@@ -356,6 +376,76 @@ function param(name) {
     const paramName = name || `unnamed_${capture.nextUnnamedId++}`;
     return new TemplateParamImpl(paramName);
 }
+/**
+ * Represents raw code that should be inserted verbatim into templates at construction time.
+ * This is useful for dynamic code generation where the code structure is determined at runtime.
+ */
+class RawCode {
+    constructor(code) {
+        this.code = code;
+        this[_a] = true;
+    }
+}
+exports.RawCode = RawCode;
+_a = exports.RAW_CODE_SYMBOL;
+/**
+ * Creates a raw code specification for inserting literal code strings into templates.
+ *
+ * Use `raw()` when you need to insert code that is generated dynamically (e.g., from recipe options,
+ * computed field names, or programmatic string manipulation) directly into a template at construction time.
+ *
+ * The string is spliced into the template before parsing, so it becomes part of the template's AST.
+ * This is different from `param()` or `capture()` which are placeholders replaced during application.
+ *
+ * @param code The code string to insert verbatim into the template
+ * @returns A RawCode object that will be spliced into the template
+ *
+ * @remarks
+ * **When to use `raw()` vs `param()` vs `capture()`:**
+ *
+ * - Use `raw()` when you have a **code string** to insert at **template construction time**
+ * - Use `param()` when you have an **AST node** to substitute at **template application time**
+ * - Use `capture()` when working with **pattern matching** and need to reference matched values
+ *
+ * **Safety Considerations:**
+ * - No validation is performed on the code string
+ * - The code must be syntactically valid at the position where it's inserted
+ * - Recipe authors are trusted to provide valid code
+ *
+ * @example
+ * // Recipe option determines the log level
+ * class MyRecipe extends Recipe {
+ *     @Option
+ *     logLevel: string = "info";
+ *
+ *     getVisitor() {
+ *         // Template constructed with dynamic method name
+ *         const replacement = template`logger.${raw(this.logLevel)}(${_('msg')})`;
+ *         // Produces: logger.info(...) or logger.warn(...) etc.
+ *     }
+ * }
+ *
+ * @example
+ * // Build object literal from collected field names
+ * const fields = ["userId", "timestamp", "status"];
+ * template`{ ${raw(fields.join(', '))} }`
+ * // Produces: { userId, timestamp, status }
+ *
+ * @example
+ * // Dynamic import path
+ * const modulePath = "./utils";
+ * template`import { helper } from ${raw(`'${modulePath}'`)}`
+ * // Produces: import { helper } from './utils'
+ *
+ * @example
+ * // Configurable operator
+ * const operator = ">=";
+ * template`${_('value')} ${raw(operator)} threshold`
+ * // Produces: value >= threshold
+ */
+function raw(code) {
+    return new RawCode(code);
+}
 /**
  * Concise alias for `capture`. Works well for inline captures in patterns and templates.
  *

package/dist/javascript/templating/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/javascript/templating/capture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/javascript/templating/capture.ts"],"names":[],"mappings":"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"}

package/dist/javascript/templating/comparator.d.ts

@@ -2,27 +2,76 @@ import { Cursor, Tree } from '../..';
 import { J } from '../../java';
 import { JS } from '../index';
 import { JavaScriptSemanticComparatorVisitor } from '../comparator';
-import { CaptureStorageValue } from './utils';
+import { CaptureMarker, CaptureStorageValue } from './utils';
+import { DebugLogEntry, MatchExplanation } from './types';
+/**
+ * Debug callbacks for pattern matching.
+ * These are always used together - either all present or all absent.
+ * Part of Layer 1 (Core Instrumentation).
+ */
+export interface DebugCallbacks {
+    log: (level: DebugLogEntry['level'], scope: DebugLogEntry['scope'], message: string, data?: any) => void;
+    setExplanation: (reason: MatchExplanation['reason'], expected: string, actual: string, details?: string) => void;
+    getExplanation: () => MatchExplanation | undefined;
+    restoreExplanation: (explanation: MatchExplanation) => void;
+    clearExplanation: () => void;
+    pushPath: (name: string) => void;
+    popPath: () => void;
+}
+/**
+ * Snapshot of matcher state for backtracking.
+ * Includes both capture storage and debug state.
+ */
+export interface MatcherState {
+    storage: Map<string, CaptureStorageValue>;
+    debugState?: {
+        explanation?: MatchExplanation;
+        logLength: number;
+        path: string[];
+    };
+}
+/**
+ * Callbacks for the matcher (debug and capture handling).
+ * Part of Layer 1 (Core Instrumentation).
+ */
+export interface MatcherCallbacks {
+    handleCapture: (capture: CaptureMarker, target: J, wrapper?: J.RightPadded<J>) => boolean;
+    handleVariadicCapture: (capture: CaptureMarker, targets: J[], wrappers?: J.RightPadded<J>[]) => boolean;
+    saveState: () => MatcherState;
+    restoreState: (state: MatcherState) => void;
+    debug?: DebugCallbacks;
+}
 /**
  * A comparator for pattern matching that is lenient about optional properties.
  * Allows patterns without type annotations to match actual code with type annotations.
  * Uses semantic comparison to match semantically equivalent code (e.g., isDate() and util.isDate()).
  */
 export declare class PatternMatchingComparator extends JavaScriptSemanticComparatorVisitor {
-    private readonly matcher;
-    constructor(matcher: {
-        handleCapture: (pattern: J, target: J, wrapper?: J.RightPadded<J>) => boolean;
-        handleVariadicCapture: (pattern: J, targets: J[], wrappers?: J.RightPadded<J>[]) => boolean;
-        saveState: () => Map<string, CaptureStorageValue>;
-        restoreState: (state: Map<string, CaptureStorageValue>) => void;
-    }, lenientTypeMatching?: boolean);
-    /**
-     * Extracts the wrapper from the cursor if the parent is a RightPadded.
-     */
-    private getWrapperFromCursor;
+    protected readonly matcher: MatcherCallbacks;
+    constructor(matcher: MatcherCallbacks, lenientTypeMatching?: boolean);
     visit<R extends J>(j: Tree, p: J, parent?: Cursor): Promise<R | undefined>;
     protected hasSameKind(j: J, other: J): boolean;
-    visitIdentifier(identifier: J.Identifier, other: J): Promise<J | undefined>;
+    /**
+     * Additional specialized abort methods for pattern matching scenarios.
+     */
+    protected constraintFailed(captureName: string, targetKind: string): any;
+    protected captureConflict(captureName: string): any;
+    /**
+     * Override visitRightPadded to check if this wrapper has a CaptureMarker.
+     * If so, capture the entire wrapper (to preserve markers like semicolons).
+     */
+    visitRightPadded<T extends J | boolean>(right: J.RightPadded<T>, p: J): Promise<J.RightPadded<T>>;
+    visitContainer<T extends J>(container: J.Container<T>, p: J): Promise<J.Container<T>>;
+    /**
+     * Visit a single element in a container (for non-variadic matching).
+     * Extracted to allow debug subclass to add path tracking.
+     *
+     * @param element The pattern element
+     * @param otherElement The target element
+     * @param index The index in the container
+     * @returns true if matching should continue, false if it failed
+     */
+    protected visitContainerElement<T extends J>(element: J.RightPadded<T>, otherElement: J.RightPadded<T>, index: number): Promise<boolean>;
     visitMethodInvocation(methodInvocation: J.MethodInvocation, other: J): Promise<J | undefined>;
     visitBlock(block: J.Block, other: J): Promise<J | undefined>;
     visitJsCompilationUnit(compilationUnit: JS.CompilationUnit, other: J): Promise<J | undefined>;
@@ -43,7 +92,7 @@ export declare class PatternMatchingComparator extends JavaScriptSemanticCompara
      * @param filterEmpty Whether to filter out J.Empty elements when capturing (true for arguments, false for statements)
      * @returns true if the sequence matches, false otherwise
      */
-    private matchSequence;
+    protected matchSequence(patternElements: J.RightPadded<J>[], targetElements: J.RightPadded<J>[], filterEmpty: boolean): Promise<boolean>;
     /**
      * Optimized sequence matcher with pivot detection and backtracking.
      * For variadic patterns, tries to detect pivots (where next pattern matches) to avoid
@@ -56,6 +105,67 @@ export declare class PatternMatchingComparator extends JavaScriptSemanticCompara
      * @param filterEmpty Whether to filter out J.Empty elements when capturing
      * @returns true if the remaining sequence matches, false otherwise
      */
-    private matchSequenceOptimized;
+    protected matchSequenceOptimized(patternElements: J.RightPadded<J>[], targetElements: J.RightPadded<J>[], patternIdx: number, targetIdx: number, filterEmpty: boolean): Promise<boolean>;
+    /**
+     * Visit a single element in a sequence during non-variadic matching.
+     * Extracted to allow debug subclass to add path tracking.
+     *
+     * @param patternWrapper The pattern element
+     * @param targetWrapper The target element
+     * @param targetIdx The index in the target sequence
+     * @returns true if matching succeeded, false otherwise
+     */
+    protected visitSequenceElement(patternWrapper: J.RightPadded<J>, targetWrapper: J.RightPadded<J>, targetIdx: number): Promise<boolean>;
+}
+/**
+ * Debug-instrumented version of PatternMatchingComparator.
+ * Overrides methods to add path tracking, logging, and explanation capture.
+ * Zero cost when not instantiated - production code uses the base class.
+ */
+export declare class DebugPatternMatchingComparator extends PatternMatchingComparator {
+    private get debug();
+    /**
+     * Extracts the last segment of a kind string (after the last dot).
+     * For example: "org.openrewrite.java.tree.J.MethodInvocation" -> "MethodInvocation"
+     */
+    private formatKind;
+    /**
+     * Formats a value for display in error messages.
+     */
+    private formatValue;
+    /**
+     * Override abort to capture explanation when debug is enabled.
+     * Only sets explanation on the first abort call (when this.match is still true).
+     * This preserves the most specific explanation closest to the actual mismatch.
+     */
+    protected abort<T>(t: T, reason?: string, propertyName?: string, expected?: any, actual?: any): T;
+    /**
+     * Override helper methods to extract detailed context from cursors.
+     */
+    protected kindMismatch(): any;
+    protected structuralMismatch(propertyName: string): any;
+    protected arrayLengthMismatch(propertyName: string): any;
+    protected valueMismatch(propertyName?: string, expected?: any, actual?: any): any;
+    visit<R extends J>(j: Tree, p: J, parent?: Cursor): Promise<R | undefined>;
+    protected visitElement<T extends J>(j: T, other: T): Promise<T>;
+    visitRightPadded<T extends J | boolean>(right: J.RightPadded<T>, p: J): Promise<J.RightPadded<T>>;
+    visitContainer<T extends J>(container: J.Container<T>, p: J): Promise<J.Container<T>>;
+    /**
+     * Override visitContainerProperty to add path tracking with property context.
+     */
+    protected visitContainerProperty<T extends J>(propertyName: string, container: J.Container<T>, otherContainer: J.Container<T>): Promise<J.Container<T>>;
+    /**
+     * Override visitRightPaddedProperty to add path tracking with property context.
+     */
+    protected visitRightPaddedProperty<T extends J | boolean>(propertyName: string, rightPadded: J.RightPadded<T>, otherRightPadded: J.RightPadded<T>): Promise<J.RightPadded<T>>;
+    /**
+     * Override visitLeftPaddedProperty to add path tracking with property context.
+     */
+    protected visitLeftPaddedProperty<T extends J | J.Space | number | string | boolean>(propertyName: string, leftPadded: J.LeftPadded<T>, otherLeftPadded: J.LeftPadded<T>): Promise<J.LeftPadded<T>>;
+    protected visitContainerElement<T extends J>(element: J.RightPadded<T>, otherElement: J.RightPadded<T>, index: number): Promise<boolean>;
+    protected visitArrayProperty<T>(parent: J, propertyName: string, array1: T[], array2: T[], visitor: (item1: T, item2: T, index: number) => Promise<void>): Promise<void>;
+    protected matchSequence(patternElements: J.RightPadded<J>[], targetElements: J.RightPadded<J>[], filterEmpty: boolean): Promise<boolean>;
+    protected visitSequenceElement(patternWrapper: J.RightPadded<J>, targetWrapper: J.RightPadded<J>, targetIdx: number): Promise<boolean>;
+    protected matchSequenceOptimized(patternElements: J.RightPadded<J>[], targetElements: J.RightPadded<J>[], patternIdx: number, targetIdx: number, filterEmpty: boolean): Promise<boolean>;
 }
 //# sourceMappingURL=comparator.d.ts.map

package/dist/javascript/templating/comparator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comparator.d.ts","sourceRoot":"","sources":["../../../src/javascript/templating/comparator.ts"],"names":[],"mappings":"AAeA,OAAO,EAAC,MAAM,EAAE,IAAI,EAAC,MAAM,OAAO,CAAC;AACnC,OAAO,EAAC,CAAC,EAAC,MAAM,YAAY,CAAC;AAC7B,OAAO,EAAC,EAAE,EAAC,MAAM,UAAU,CAAC;AAC5B,OAAO,EAAC,mCAAmC,EAAC,MAAM,eAAe,CAAC;AAClE,OAAO,EAAmB,mBAAmB,EAAC,MAAM,SAAS,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,mCAAmC;IAE1E,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE;QACtB,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;QAC9E,qBAAqB,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC;QAC5F,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QAClD,YAAY,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,IAAI,CAAC;KACnE,EACD,mBAAmB,GAAE,OAAc;IAMvC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAYb,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAkBzF,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO;IAK/B,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAS3E,qBAAqB,CAAC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA2D7F,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA2B5D,sBAAsB,CAAC,eAAe,EAAE,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA2B5G;;;OAGG;YACW,cAAc;IAI5B;;;;;;;;;;;OAWG;YACW,aAAa;IAI3B;;;;;;;;;;;OAWG;YACW,sBAAsB;CAiMvC"}
+{"version":3,"file":"comparator.d.ts","sourceRoot":"","sources":["../../../src/javascript/templating/comparator.ts"],"names":[],"mappings":"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"}