@openrewrite/rewrite 8.66.0-SNAPSHOT → 8.66.1

package/dist/javascript/templating/engine.js

@@ -0,0 +1,228 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateApplier = exports.TemplateEngine = void 0;
+/*
+ * Copyright 2025 the original author or authors.
+ * <p>
+ * Licensed under the Moderne Source Available License (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * <p>
+ * https://docs.moderne.io/licensing/moderne-source-available-license
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const __1 = require("../..");
+const java_1 = require("../../java");
+const __2 = require("..");
+const immer_1 = require("immer");
+const utils_1 = require("./utils");
+const capture_1 = require("./capture");
+const placeholder_replacement_1 = require("./placeholder-replacement");
+/**
+ * Cache for compiled templates.
+ */
+const templateCache = new utils_1.TemplateCache();
+/**
+ * Internal template engine - handles the core templating logic.
+ * Not exported from index, so only visible within the templating module.
+ */
+class TemplateEngine {
+    /**
+     * Applies a template with optional match results from pattern matching.
+     *
+     * @param templateParts The string parts of the template
+     * @param parameters The parameters between the string parts
+     * @param cursor The cursor pointing to the current location in the AST
+     * @param coordinates The coordinates specifying where and how to insert the generated AST
+     * @param values Map of capture names to values to replace the parameters with
+     * @param wrappersMap Map of capture names to J.RightPadded wrappers (for preserving markers)
+     * @param contextStatements Context declarations (imports, types, etc.) to prepend for type attribution
+     * @param dependencies NPM dependencies for type attribution
+     * @returns A Promise resolving to the generated AST node
+     */
+    static applyTemplate(templateParts_1, parameters_1, cursor_1, coordinates_1) {
+        return __awaiter(this, arguments, void 0, function* (templateParts, parameters, cursor, coordinates, values = new Map(), wrappersMap = new Map(), contextStatements = [], dependencies = {}) {
+            // Build the template string with parameter placeholders
+            const templateString = TemplateEngine.buildTemplateString(templateParts, parameters);
+            // If the template string is empty, return undefined
+            if (!templateString.trim()) {
+                return undefined;
+            }
+            // Use cache to get or parse the compilation unit
+            // For templates, we don't have captures, so use empty array
+            const cu = yield templateCache.getOrParse(templateString, [], // templates don't have captures in the cache key
+            contextStatements, dependencies);
+            // Check if there are any statements
+            if (!cu.statements || cu.statements.length === 0) {
+                throw new Error(`Failed to parse template code (no statements):\n${templateString}`);
+            }
+            // Skip context statements to get to the actual template code
+            const templateStatementIndex = contextStatements.length;
+            if (templateStatementIndex >= cu.statements.length) {
+                return undefined;
+            }
+            // Extract the relevant part of the AST
+            const firstStatement = cu.statements[templateStatementIndex].element;
+            let extracted;
+            // Check if this is a wrapped template (function __TEMPLATE__() { ... })
+            if (firstStatement.kind === java_1.J.Kind.MethodDeclaration) {
+                const func = firstStatement;
+                if (func.name.simpleName === '__TEMPLATE__' && func.body) {
+                    // __TEMPLATE__ wrapper indicates the original template was a block.
+                    // Always return the block to preserve the block structure.
+                    extracted = func.body;
+                }
+                else {
+                    // Not a __TEMPLATE__ wrapper
+                    extracted = firstStatement;
+                }
+            }
+            else if (firstStatement.kind === __2.JS.Kind.ExpressionStatement) {
+                extracted = firstStatement.expression;
+            }
+            else {
+                extracted = firstStatement;
+            }
+            // Create a copy to avoid sharing cached AST instances
+            const ast = (0, immer_1.produce)(extracted, _ => { });
+            // Create substitutions map for placeholders
+            const substitutions = new Map();
+            for (let i = 0; i < parameters.length; i++) {
+                const placeholder = `${utils_1.PlaceholderUtils.PLACEHOLDER_PREFIX}${i}__`;
+                substitutions.set(placeholder, parameters[i]);
+            }
+            // Unsubstitute placeholders with actual parameter values and match results
+            const visitor = new placeholder_replacement_1.PlaceholderReplacementVisitor(substitutions, values, wrappersMap);
+            const unsubstitutedAst = (yield visitor.visit(ast, null));
+            // Apply the template to the current AST
+            return new TemplateApplier(cursor, coordinates, unsubstitutedAst).apply();
+        });
+    }
+    /**
+     * Builds a template string with parameter placeholders.
+     *
+     * @param templateParts The string parts of the template
+     * @param parameters The parameters between the string parts
+     * @returns The template string
+     */
+    static buildTemplateString(templateParts, parameters) {
+        let result = '';
+        for (let i = 0; i < templateParts.length; i++) {
+            result += templateParts[i];
+            if (i < parameters.length) {
+                const param = parameters[i].value;
+                // Use a placeholder for Captures, TemplateParams, CaptureValues, Tree nodes, and Tree arrays
+                // Inline everything else (strings, numbers, booleans) directly
+                // Check for Capture (could be a Proxy, so check for symbol property)
+                const isCapture = param instanceof capture_1.CaptureImpl ||
+                    (param && typeof param === 'object' && param[capture_1.CAPTURE_NAME_SYMBOL]);
+                const isTemplateParam = param instanceof capture_1.TemplateParamImpl;
+                const isCaptureValue = param instanceof capture_1.CaptureValue;
+                const isTreeArray = Array.isArray(param) && param.length > 0 && (0, __1.isTree)(param[0]);
+                if (isCapture || isTemplateParam || isCaptureValue || (0, __1.isTree)(param) || isTreeArray) {
+                    const placeholder = `${utils_1.PlaceholderUtils.PLACEHOLDER_PREFIX}${i}__`;
+                    result += placeholder;
+                }
+                else {
+                    result += param;
+                }
+            }
+        }
+        // Detect if this is a block template that needs wrapping
+        const trimmed = result.trim();
+        if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
+            result = `function __TEMPLATE__() ${result}`;
+        }
+        return result;
+    }
+}
+exports.TemplateEngine = TemplateEngine;
+/**
+ * Helper class for applying a template to an AST.
+ */
+class TemplateApplier {
+    constructor(cursor, coordinates, ast) {
+        this.cursor = cursor;
+        this.coordinates = coordinates;
+        this.ast = ast;
+    }
+    /**
+     * Applies the template to the current AST.
+     *
+     * @returns A Promise resolving to the modified AST
+     */
+    apply() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { loc } = this.coordinates;
+            // Apply the template based on the location and mode
+            switch (loc || 'EXPRESSION_PREFIX') {
+                case 'EXPRESSION_PREFIX':
+                    return this.applyToExpression();
+                case 'STATEMENT_PREFIX':
+                    return this.applyToStatement();
+                case 'BLOCK_END':
+                    return this.applyToBlock();
+                default:
+                    throw new Error(`Unsupported location: ${loc}`);
+            }
+        });
+    }
+    /**
+     * Applies the template to an expression.
+     *
+     * @returns A Promise resolving to the modified AST
+     */
+    applyToExpression() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { tree } = this.coordinates;
+            // Create a copy of the AST with the prefix from the target
+            return tree ? (0, immer_1.produce)(this.ast, draft => {
+                draft.prefix = tree.prefix;
+            }) : this.ast;
+        });
+    }
+    /**
+     * Applies the template to a statement.
+     *
+     * @returns A Promise resolving to the modified AST
+     */
+    applyToStatement() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { tree } = this.coordinates;
+            // Create a copy of the AST with the prefix from the target
+            return (0, immer_1.produce)(this.ast, draft => {
+                draft.prefix = tree.prefix;
+            });
+        });
+    }
+    /**
+     * Applies the template to a block.
+     *
+     * @returns A Promise resolving to the modified AST
+     */
+    applyToBlock() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { tree } = this.coordinates;
+            // Create a copy of the AST with the prefix from the target
+            return (0, immer_1.produce)(this.ast, draft => {
+                draft.prefix = tree.prefix;
+            });
+        });
+    }
+}
+exports.TemplateApplier = TemplateApplier;
+//# sourceMappingURL=engine.js.map

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

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

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

@@ -0,0 +1,6 @@
+export type { VariadicOptions, CaptureOptions, Capture, Any, TemplateParam, PatternOptions, TemplateParameter, TemplateOptions, RewriteRule, RewriteConfig } from './types';
+export { and, or, not, capture, any, param, _ } from './capture';
+export { Pattern, PatternBuilder, MatchResult, pattern } from './pattern';
+export { rewrite } from './rewrite';
+export { Template, TemplateBuilder, template } from './template';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/javascript/templating/index.ts"],"names":[],"mappings":"AAiBA,YAAY,EACR,eAAe,EACf,cAAc,EACd,OAAO,EACP,GAAG,EACH,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,aAAa,EAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,GAAG,EACH,EAAE,EACF,GAAG,EACH,OAAO,EACP,GAAG,EACH,KAAK,EACL,CAAC,EACJ,MAAM,WAAW,CAAC;AAGnB,OAAO,EACH,OAAO,EACP,cAAc,EACd,WAAW,EACX,OAAO,EACV,MAAM,WAAW,CAAC;AAGnB,OAAO,EACH,OAAO,EACV,MAAM,WAAW,CAAC;AAGnB,OAAO,EACH,QAAQ,EACR,eAAe,EACf,QAAQ,EACX,MAAM,YAAY,CAAC"}

package/dist/javascript/templating/index.js

@@ -0,0 +1,42 @@
+"use strict";
+/*
+ * Copyright 2025 the original author or authors.
+ * <p>
+ * Licensed under the Moderne Source Available License (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * <p>
+ * https://docs.moderne.io/licensing/moderne-source-available-license
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.template = exports.TemplateBuilder = exports.Template = exports.rewrite = exports.pattern = exports.MatchResult = exports.PatternBuilder = exports.Pattern = exports._ = exports.param = exports.any = exports.capture = exports.not = exports.or = exports.and = void 0;
+// Export capture functionality
+var capture_1 = require("./capture");
+Object.defineProperty(exports, "and", { enumerable: true, get: function () { return capture_1.and; } });
+Object.defineProperty(exports, "or", { enumerable: true, get: function () { return capture_1.or; } });
+Object.defineProperty(exports, "not", { enumerable: true, get: function () { return capture_1.not; } });
+Object.defineProperty(exports, "capture", { enumerable: true, get: function () { return capture_1.capture; } });
+Object.defineProperty(exports, "any", { enumerable: true, get: function () { return capture_1.any; } });
+Object.defineProperty(exports, "param", { enumerable: true, get: function () { return capture_1.param; } });
+Object.defineProperty(exports, "_", { enumerable: true, get: function () { return capture_1._; } });
+// Export pattern functionality
+var pattern_1 = require("./pattern");
+Object.defineProperty(exports, "Pattern", { enumerable: true, get: function () { return pattern_1.Pattern; } });
+Object.defineProperty(exports, "PatternBuilder", { enumerable: true, get: function () { return pattern_1.PatternBuilder; } });
+Object.defineProperty(exports, "MatchResult", { enumerable: true, get: function () { return pattern_1.MatchResult; } });
+Object.defineProperty(exports, "pattern", { enumerable: true, get: function () { return pattern_1.pattern; } });
+// Export rewrite functionality
+var rewrite_1 = require("./rewrite");
+Object.defineProperty(exports, "rewrite", { enumerable: true, get: function () { return rewrite_1.rewrite; } });
+// Export template functionality
+var template_1 = require("./template");
+Object.defineProperty(exports, "Template", { enumerable: true, get: function () { return template_1.Template; } });
+Object.defineProperty(exports, "TemplateBuilder", { enumerable: true, get: function () { return template_1.TemplateBuilder; } });
+Object.defineProperty(exports, "template", { enumerable: true, get: function () { return template_1.template; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/javascript/templating/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAgBH,+BAA+B;AAC/B,qCAQmB;AAPf,8FAAA,GAAG,OAAA;AACH,6FAAA,EAAE,OAAA;AACF,8FAAA,GAAG,OAAA;AACH,kGAAA,OAAO,OAAA;AACP,8FAAA,GAAG,OAAA;AACH,gGAAA,KAAK,OAAA;AACL,4FAAA,CAAC,OAAA;AAGL,+BAA+B;AAC/B,qCAKmB;AAJf,kGAAA,OAAO,OAAA;AACP,yGAAA,cAAc,OAAA;AACd,sGAAA,WAAW,OAAA;AACX,kGAAA,OAAO,OAAA;AAGX,+BAA+B;AAC/B,qCAEmB;AADf,kGAAA,OAAO,OAAA;AAGX,gCAAgC;AAChC,uCAIoB;AAHhB,oGAAA,QAAQ,OAAA;AACR,2GAAA,eAAe,OAAA;AACf,oGAAA,QAAQ,OAAA"}

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

@@ -0,0 +1,171 @@
+import { J } from '../../java';
+import { Capture, Any, PatternOptions } from './types';
+import { CaptureStorageValue, WRAPPERS_MAP_SYMBOL } from './utils';
+/**
+ * Builder for creating patterns programmatically.
+ * Use when pattern structure is not known at compile time.
+ *
+ * @example
+ * // Loop-based pattern generation
+ * const builder = Pattern.builder().code('myFunction(');
+ * for (let i = 0; i < argCount; i++) {
+ *     if (i > 0) builder.code(', ');
+ *     builder.capture(capture(`arg${i}`));
+ * }
+ * builder.code(')');
+ * const pat = builder.build();
+ *
+ * @example
+ * // Conditional pattern construction
+ * const builder = Pattern.builder().code('foo(');
+ * builder.capture(capture('first'));
+ * if (needsSecondArg) {
+ *     builder.code(', ').capture(capture('second'));
+ * }
+ * builder.code(')');
+ * const pat = builder.build();
+ */
+export declare class PatternBuilder {
+    private parts;
+    private captures;
+    /**
+     * Adds a static string part to the pattern.
+     *
+     * @param str The string to add
+     * @returns This builder for chaining
+     */
+    code(str: string): this;
+    /**
+     * Adds a capture to the pattern.
+     *
+     * @param value The capture object (Capture or Any) or string name
+     * @returns This builder for chaining
+     */
+    capture(value: Capture | Any<any> | string): this;
+    /**
+     * Builds the pattern from accumulated parts and captures.
+     *
+     * @returns A Pattern instance
+     */
+    build(): Pattern;
+}
+/**
+ * Represents a pattern that can be matched against AST nodes.
+ */
+export declare class Pattern {
+    readonly templateParts: TemplateStringsArray;
+    readonly captures: (Capture | Any<any>)[];
+    private _options;
+    /**
+     * Gets the configuration options for this pattern.
+     * @readonly
+     */
+    get options(): Readonly<PatternOptions>;
+    /**
+     * Creates a new builder for constructing patterns programmatically.
+     *
+     * @returns A new PatternBuilder instance
+     *
+     * @example
+     * const pat = Pattern.builder()
+     *     .code('function ')
+     *     .capture(capture('name'))
+     *     .code('() { return ')
+     *     .capture(capture('value'))
+     *     .code('; }')
+     *     .build();
+     */
+    static builder(): PatternBuilder;
+    /**
+     * Creates a new pattern from template parts and captures.
+     *
+     * @param templateParts The string parts of the template
+     * @param captures The captures between the string parts (can be Capture or Any)
+     */
+    constructor(templateParts: TemplateStringsArray, captures: (Capture | Any<any>)[]);
+    /**
+     * Configures this pattern with additional options.
+     *
+     * @param options Configuration options
+     * @returns This pattern for method chaining
+     *
+     * @example
+     * pattern`isDate(${capture('date')})`
+     *     .configure({
+     *         imports: ['import { isDate } from \"util\"'],
+     *         dependencies: { 'util': '^1.0.0' }
+     *     })
+     */
+    configure(options: PatternOptions): Pattern;
+    /**
+     * Creates a matcher for this pattern against a specific AST node.
+     *
+     * @param ast The AST node to match against
+     * @returns A Matcher object
+     */
+    match(ast: J): Promise<MatchResult | undefined>;
+}
+/**
+ * Result of a successful pattern match containing captured values.
+ *
+ * Provides access to captured AST nodes from pattern matching operations.
+ * Use the `get()` method to retrieve captured values by name or by Capture object.
+ *
+ * @example
+ * const x = capture('x');
+ * const pat = pattern`foo(${x})`;
+ * const match = await pat.match(someNode);
+ * if (match) {
+ *     const captured = match.get('x');  // Get by name
+ *     // or
+ *     const captured = match.get(x);    // Get by Capture object
+ * }
+ *
+ * @example
+ * // Variadic captures return arrays
+ * const args = capture({ variadic: true });
+ * const pat = pattern`foo(${args})`;
+ * const match = await pat.match(methodInvocation);
+ * if (match) {
+ *     const capturedArgs = match.get(args);  // Returns J[] for variadic captures
+ * }
+ */
+export declare class MatchResult implements Pick<Map<string, J>, "get"> {
+    private readonly storage;
+    constructor(storage?: Map<string, CaptureStorageValue>);
+    get<T>(capture: Capture<T[]>): T[] | undefined;
+    get<T>(capture: Capture<T>): T | undefined;
+    get(capture: string): J | undefined;
+    /**
+     * Extracts semantic elements from storage value.
+     * For wrappers, extracts the .element; for arrays, returns array of elements.
+     *
+     * @param value The storage value
+     * @returns The semantic element(s)
+     */
+    private extractElements;
+    /**
+     * Internal method to get wrappers (used by template expansion).
+     * Returns both scalar and variadic wrappers.
+     * @internal
+     */
+    [WRAPPERS_MAP_SYMBOL](): Map<string, J.RightPadded<J> | J.RightPadded<J>[]>;
+}
+/**
+ * Tagged template function for creating patterns.
+ *
+ * @param strings The string parts of the template
+ * @param captures The captures between the string parts (Capture, Any, or string names)
+ * @returns A Pattern object
+ *
+ * @example
+ * // Using the same capture multiple times for repeated patterns
+ * const expr = capture('expr');
+ * const redundantOr = pattern`${expr} || ${expr}`;
+ *
+ * @example
+ * // Using any() for non-capturing matches
+ * const pat = pattern`foo(${any()})`;
+ */
+export declare function pattern(strings: TemplateStringsArray, ...captures: (Capture | Any<any> | string)[]): Pattern;
+//# sourceMappingURL=pattern.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../../src/javascript/templating/pattern.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,CAAC,EAAC,MAAM,YAAY,CAAC;AAG7B,OAAO,EAAC,OAAO,EAAE,GAAG,EAAE,cAAc,EAAC,MAAM,SAAS,CAAC;AAGrD,OAAO,EAAiD,mBAAmB,EAAE,mBAAmB,EAAC,MAAM,SAAS,CAAC;AAEjH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI;IAajD;;;;OAIG;IACH,KAAK,IAAI,OAAO;CAiBnB;AAED;;GAEG;AACH,qBAAa,OAAO;aAoCI,aAAa,EAAE,oBAAoB;aACnC,QAAQ,EAAE,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE;IApCpD,OAAO,CAAC,QAAQ,CAAsB;IAEtC;;;OAGG;IACH,IAAI,OAAO,IAAI,QAAQ,CAAC,cAAc,CAAC,CAEtC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,OAAO,IAAI,cAAc;IAIhC;;;;;OAKG;gBAEiB,aAAa,EAAE,oBAAoB,EACnC,QAAQ,EAAE,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE;IAIpD;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAK3C;;;;;OAKG;IACG,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;CAUxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAY,YAAW,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC;IAEvD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAa;IAK1E,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS;IAE9C,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAE1C,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAYnC;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;;OAIG;IACH,CAAC,mBAAmB,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;CAa9E;AA4ZD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,QAAQ,EAAE,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAY5G"}