linecraft 0.5.4 → 0.5.5

package/lib/components/code-debug.test.js

@@ -0,0 +1,253 @@
+// Unit tests for code-debug component
+import { describe, it, expect, beforeEach } from 'vitest';
+import { CodeDebug } from './code-debug.js';
+import { TerminalRegion } from '../region.js';
+import { callComponent } from '../component.js';
+import { stripAnsi } from '../utils/text.js';
+describe('code-debug component', () => {
+    let region;
+    beforeEach(() => {
+        region = new TerminalRegion({ disableRendering: true, width: 100 });
+    });
+    function render(component, width = 100) {
+        const ctx = {
+            availableWidth: width,
+            region: region,
+            columnIndex: 0,
+            rowIndex: 0,
+        };
+        const result = callComponent(component, ctx);
+        if (Array.isArray(result)) {
+            return result;
+        }
+        else if (result) {
+            return [result];
+        }
+        return [];
+    }
+    describe('truncated code with ellipsis', () => {
+        it('should correctly point to .v at columns 77-78 when code is truncated with start ellipsis', () => {
+            // This is the extend-chaining example that's failing
+            const errorLine = '  .ma:extend(.a,.b,.c,.d,.e,.f,.g,.h,.i,.j,.k,.l,.m,.n,.o,.p,.q,.r,.s,.t,.u,.v) {};';
+            const startColumn = 77; // Should point to '.'
+            const endColumn = 78; // Should point to 'v'
+            // Verify original columns
+            expect(errorLine[startColumn - 1]).toBe('.');
+            expect(errorLine[endColumn - 1]).toBe('v');
+            // Test with width that causes truncation (80 chars should truncate this 83-char line)
+            const width = 80;
+            const component = CodeDebug({
+                startLine: 77,
+                startColumn,
+                endColumn,
+                errorLine,
+                message: 'Extend target ".v" not accessible',
+                shortMessage: 'extend target not accessible',
+                filePath: 'test.less',
+                fullPath: '/test/test.less',
+                baseDir: '/test',
+                type: 'warning',
+            });
+            const output = render(component, width);
+            const outputText = output.join('\n');
+            const outputTextPlain = stripAnsi(outputText);
+            // Find the error line (line with │ and the code) - format: "77 │ ..."
+            const errorLineRegex = /^\s*\d+\s*│\s*(.+)$/m;
+            const errorLineMatch = outputTextPlain.match(errorLineRegex);
+            expect(errorLineMatch, `Error line should be found in:\n${outputTextPlain}`).toBeTruthy();
+            const renderedErrorLinePlain = errorLineMatch[1];
+            // Find the indicator line (line with │ and the underline) - format: "  │ ..."
+            // Look for lines with indicator characters (┖, ┬, ┚, ╿)
+            const lines = outputTextPlain.split('\n');
+            let indicatorLinePlain = null;
+            let fullIndicatorLine = null;
+            for (const line of lines) {
+                if (line.includes('│') && (line.includes('┖') || line.includes('┬') || line.includes('┚') || line.includes('╿'))) {
+                    fullIndicatorLine = line;
+                    const match = line.match(/│ (.*)$/);
+                    if (match) {
+                        indicatorLinePlain = match[1];
+                        break;
+                    }
+                }
+            }
+            expect(indicatorLinePlain, `Indicator line should be found in:\n${outputTextPlain}`).toBeTruthy();
+            // The indicator should point to .v in the rendered error line
+            // Find where .v appears in the rendered error line
+            const dotVIndex = renderedErrorLinePlain.indexOf('.v');
+            expect(dotVIndex, `.v should be visible in rendered line: "${renderedErrorLinePlain}"`).toBeGreaterThanOrEqual(0);
+            // The indicator (┖, ┬, ┚, or ╿) should be positioned at or near .v
+            // Find the position of the T-bar (┬) or bracket (┖/┚) in the indicator line
+            const tBarIndex = indicatorLinePlain.indexOf('┬');
+            const bracketStart = indicatorLinePlain.indexOf('┖');
+            const bracketEnd = indicatorLinePlain.indexOf('┚');
+            const indicatorPos = tBarIndex >= 0 ? tBarIndex : (bracketStart >= 0 ? bracketStart : bracketEnd);
+            expect(indicatorPos, `Indicator should be found in: "${indicatorLinePlain}"`).toBeGreaterThanOrEqual(0);
+            // Account for ellipsis at start if present
+            // renderedErrorLinePlain includes ellipsis if present
+            const expectedIndicatorPos = dotVIndex;
+            // The indicator should be at or near where .v is (within 2 characters)
+            expect(Math.abs(indicatorPos - expectedIndicatorPos), `Indicator at ${indicatorPos} should be near .v at ${expectedIndicatorPos} in error line "${renderedErrorLinePlain}" and indicator "${indicatorLinePlain}"`).toBeLessThanOrEqual(2);
+        });
+    });
+    describe('short message alignment', () => {
+        it('should correctly align left-placed short message (message on right side)', () => {
+            // Left placement means message appears to the right of the code
+            const component = CodeDebug({
+                startLine: 50,
+                startColumn: 16,
+                endColumn: 35,
+                errorLine: 'const result = veryLongFunctionName(withManyParameters, andMoreParameters)',
+                message: 'Line too long',
+                shortMessage: 'line too long',
+                shortMessagePlacement: 'left',
+                filePath: 'test.ts',
+                fullPath: '/test/test.ts',
+                baseDir: '/test',
+                type: 'error',
+            });
+            const output = render(component, 100);
+            // Find the short message line (should have connector ──╯ pointing left)
+            const shortMessageLineRegex = /^\s*│\s*(.+)$/m;
+            const lines = output.join('\n').split('\n');
+            let shortMessageLine = null;
+            for (const line of lines) {
+                if (line.includes('──╯') || line.includes('line too long')) {
+                    shortMessageLine = line;
+                    break;
+                }
+            }
+            expect(shortMessageLine).toBeTruthy();
+            const shortMessageLinePlain = stripAnsi(shortMessageLine);
+            // Find the indicator line to get the T-bar position
+            const indicatorLineRegex = /^\s*│\s*(.+)$/m;
+            let indicatorLine = null;
+            for (const line of lines) {
+                if (line.includes('┬') || line.includes('┖')) {
+                    indicatorLine = line;
+                    break;
+                }
+            }
+            expect(indicatorLine).toBeTruthy();
+            const indicatorLinePlain = stripAnsi(indicatorLine);
+            // Find T-bar position in indicator line
+            const tBarPos = indicatorLinePlain.indexOf('┬');
+            expect(tBarPos).toBeGreaterThanOrEqual(0);
+            // Find connector end (╯) position in short message line
+            const connectorEndPos = shortMessageLinePlain.indexOf('╯');
+            expect(connectorEndPos).toBeGreaterThanOrEqual(0);
+            // The connector end (╯) should be at the T-bar position (exactly)
+            // Account for the │ prefix (lineNumWidth + 3)
+            const lineNumWidth = 2; // "50" is 2 chars
+            const prefixWidth = lineNumWidth + 3; // lineNumWidth + space + │ + space
+            const tBarPosInLine = tBarPos + prefixWidth;
+            const connectorEndPosInLine = connectorEndPos + prefixWidth;
+            // Should be exactly aligned (within 1 char tolerance)
+            expect(Math.abs(connectorEndPosInLine - tBarPosInLine), `Left-placed message: T-bar at ${tBarPosInLine}, connector end at ${connectorEndPosInLine}, difference: ${Math.abs(connectorEndPosInLine - tBarPosInLine)}`).toBeLessThanOrEqual(1);
+        });
+        it('should correctly align right-placed short message (message on left side)', () => {
+            // Right placement means message appears to the left of the code
+            const component = CodeDebug({
+                startLine: 12,
+                startColumn: 12,
+                endColumn: 16,
+                errorLine: '    return x + y + z;',
+                message: 'Type error: cannot add string and number',
+                shortMessage: 'string + number',
+                shortMessagePlacement: 'right',
+                filePath: 'test.ts',
+                fullPath: '/test/test.ts',
+                baseDir: '/test',
+                type: 'error',
+            });
+            const output = render(component, 100);
+            // Find the short message line (should have connector ╰── pointing right)
+            const lines = output.join('\n').split('\n');
+            let shortMessageLine = null;
+            for (const line of lines) {
+                if (line.includes('╰──') || line.includes('string + number')) {
+                    shortMessageLine = line;
+                    break;
+                }
+            }
+            expect(shortMessageLine).toBeTruthy();
+            const shortMessageLinePlain = stripAnsi(shortMessageLine);
+            // Find the indicator line to get the T-bar position
+            let indicatorLine = null;
+            for (const line of lines) {
+                if (line.includes('┬') || line.includes('┖')) {
+                    indicatorLine = line;
+                    break;
+                }
+            }
+            expect(indicatorLine).toBeTruthy();
+            const indicatorLinePlain = stripAnsi(indicatorLine);
+            // Find T-bar position in indicator line
+            const tBarPos = indicatorLinePlain.indexOf('┬');
+            expect(tBarPos).toBeGreaterThanOrEqual(0);
+            // Find connector start (╰) position in short message line
+            const connectorStartPos = shortMessageLinePlain.indexOf('╰');
+            expect(connectorStartPos).toBeGreaterThanOrEqual(0);
+            // The connector "╰── " has the last dash at position 3 from start
+            // So connectorStartPos + 3 should be at T-bar position
+            const lineNumWidth = 2; // "12" is 2 chars
+            const prefixWidth = lineNumWidth + 3; // lineNumWidth + space + │ + space
+            const tBarPosInLine = tBarPos + prefixWidth;
+            const connectorLastDashPosInLine = connectorStartPos + prefixWidth + 3;
+            // Should be exactly aligned (within 1 char tolerance)
+            expect(Math.abs(connectorLastDashPosInLine - tBarPosInLine), `Right-placed message: T-bar at ${tBarPosInLine}, connector last dash at ${connectorLastDashPosInLine}, difference: ${Math.abs(connectorLastDashPosInLine - tBarPosInLine)}`).toBeLessThanOrEqual(1);
+        });
+    });
+    describe('hyperlink preservation', () => {
+        it('should preserve OSC 8 hyperlink on truncated file path', () => {
+            // When a file path with a hyperlink is truncated, the entire visible portion should remain clickable
+            const component = CodeDebug({
+                startLine: 77,
+                startColumn: 77,
+                endColumn: 78,
+                errorLine: '  .ma:extend(.a,.b,.c,.d,.e,.f,.g,.h,.i,.j,.k,.l,.m,.n,.o,.p,.q,.r,.s,.t,.u,.v) {};',
+                message: 'Extend target ".v" not accessible',
+                shortMessage: 'extend target not accessible',
+                filePath: '../less.js/packages/test-data/tests-unit/extend-chaining/extend-chaining.less',
+                fullPath: '/project/../less.js/packages/test-data/tests-unit/extend-chaining/extend-chaining.less',
+                baseDir: '/project',
+                type: 'warning',
+            });
+            const output = render(component, 80); // Narrow width to force truncation
+            const outputText = output.join('\n');
+            const outputTextPlain = stripAnsi(outputText);
+            // Find the location line (has the file path with hyperlink)
+            // Format: "  ╭─[path:line:column]"
+            const locationLineMatch = outputTextPlain.match(/╭─\[(.+?)\]/);
+            expect(locationLineMatch, `Location line should be found in:\n${outputTextPlain.substring(0, 200)}`).toBeTruthy();
+            // Get the actual line with ANSI codes for hyperlink checking
+            const locationLineWithAnsi = output.join('\n').split('\n').find(line => stripAnsi(line).includes('╭─['));
+            expect(locationLineWithAnsi, 'Location line with ANSI should be found').toBeTruthy();
+            const locationLine = locationLineWithAnsi;
+            // Check that the entire visible path (not just ellipsis) has the OSC 8 hyperlink
+            // OSC 8 format: \x1b]8;;<url>\x1b\\<text>\x1b]8;;\x1b\\
+            // The hyperlink should wrap the entire visible text, not just the ellipsis
+            const hasOsc8Start = locationLine.includes('\x1b]8;;');
+            expect(hasOsc8Start, 'Location line should contain OSC 8 hyperlink start').toBe(true);
+            // Extract the visible path portion (after ellipsis if present)
+            const pathMatch = locationLine.match(/\[(.+?)\]/);
+            expect(pathMatch, 'Path should be found in location line').toBeTruthy();
+            const visiblePath = pathMatch[1];
+            const visiblePathPlain = stripAnsi(visiblePath);
+            // If truncated with ellipsis, check that text after ellipsis is still in the link
+            if (visiblePathPlain.startsWith('...')) {
+                // Find where the ellipsis ends and the actual path text begins
+                const pathAfterEllipsis = visiblePathPlain.substring(3);
+                // The path after ellipsis should still be part of the hyperlink
+                // We can't easily test this without parsing OSC 8, but we can check that
+                // the hyperlink sequence appears before the ellipsis and continues after
+                const ellipsisIndex = locationLine.indexOf('...');
+                const pathAfterEllipsisIndex = locationLine.indexOf(pathAfterEllipsis.substring(0, Math.min(10, pathAfterEllipsis.length)));
+                // There should be an OSC 8 start before the ellipsis
+                const osc8BeforeEllipsis = locationLine.substring(0, ellipsisIndex).includes('\x1b]8;;');
+                expect(osc8BeforeEllipsis || pathAfterEllipsisIndex > ellipsisIndex, 'Hyperlink should start before ellipsis and continue on the visible path text').toBe(true);
+            }
+        });
+    });
+});
+//# sourceMappingURL=code-debug.test.js.map

package/lib/components/code-debug.test.js.map

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

package/lib/utils/text.d.ts

@@ -15,8 +15,8 @@ export declare function stripAnsi(text: string): string;
  * Truncate text to a maximum visual width while preserving ANSI escape codes
  *
  * This function truncates text based on its visual width (ignoring ANSI codes),
- * but preserves all ANSI escape sequences in the output. This is the base function
- * used by all other truncate functions.
+ * but preserves all ANSI escape sequences in the output. Active ANSI codes are
+ * preserved in the truncated result.
  *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
@@ -29,6 +29,9 @@ export declare function truncateToWidth(text: string, maxWidth: number): string;
 /**
  * Truncate text with ellipsis at the end, preserving ANSI escape codes
  *
+ * Active ANSI codes from the truncated portion are preserved, and the ellipsis
+ * is added after the truncated text (without ANSI codes).
+ *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
  * @returns Truncated text with '...' at the end, ANSI codes preserved
@@ -40,6 +43,10 @@ export declare function truncateEnd(text: string, maxWidth: number): string;
 /**
  * Truncate text with ellipsis at the beginning, preserving ANSI escape codes
  *
+ * When truncating from the start, we preserve ANSI codes that are active in the
+ * remaining portion. The ellipsis is added at the beginning (without ANSI codes),
+ * and active codes from the original text are re-applied to the remaining portion.
+ *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
  * @returns Truncated text with '...' at the beginning, ANSI codes preserved
@@ -51,6 +58,9 @@ export declare function truncateStart(text: string, maxWidth: number): string;
 /**
  * Truncate text with ellipsis in the middle, preserving ANSI escape codes
  *
+ * When truncating in the middle, we preserve ANSI codes from the start portion
+ * and re-apply them to the end portion to maintain consistent styling.
+ *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
  * @returns Truncated text with '...' in the middle, ANSI codes preserved
@@ -59,6 +69,56 @@ export declare function truncateStart(text: string, maxWidth: number): string;
  * truncateMiddle('\x1b[31mHello World\x1b[0m', 8) // '\x1b[31mHel...ld\x1b[0m'
  */
 export declare function truncateMiddle(text: string, maxWidth: number): string;
+/**
+ * Map an original column position to its display position in truncated text
+ *
+ * This function takes the original text, the truncated result, and the visible range
+ * that was shown, and maps an original column to where it appears in the truncated text.
+ *
+ * @param originalText - The original text (plain, no ANSI)
+ * @param truncatedText - The truncated text result (may have ellipsis)
+ * @param visibleStartCol - The first column that was shown (1-based, includes truncated before)
+ * @param visibleEndCol - The last column that was shown (1-based, includes truncated after)
+ * @param originalCol - The original column to map (1-based)
+ * @param rangeStartCol - The start column of the main range (1-based, optional, for better accuracy)
+ * @param rangeEndCol - The end column of the main range (1-based, optional, for better accuracy)
+ * @returns The display position in the truncated text (1-based, visible characters)
+ */
+export declare function mapColumnToDisplay(originalText: string, truncatedText: string, visibleStartCol: number, visibleEndCol: number, originalCol: number, rangeStartCol?: number, rangeEndCol?: number): number;
+/**
+ * Result of truncateFocusRange, including information about what range was shown
+ */
+export interface TruncateFocusRangeResult {
+    /** The truncated text with target range visible */
+    text: string;
+    /** The first column that was shown (1-based, includes truncated before portion) */
+    visibleStartCol: number;
+    /** The last column that was shown (1-based, includes truncated after portion) */
+    visibleEndCol: number;
+    /** The start column of the main range (1-based, the focused portion) */
+    rangeStartCol: number;
+    /** The end column of the main range (1-based, the focused portion) */
+    rangeEndCol: number;
+}
+/**
+ * Truncate text to show a specific column range, with ellipsis as needed
+ *
+ * This function ensures a target range (startCol to endCol) is visible in the output,
+ * adding ellipsis at the start, end, or both as needed to fit within maxWidth.
+ * All ANSI codes and OSC 8 hyperlinks are preserved.
+ *
+ * @param text - Text that may contain ANSI escape codes
+ * @param maxWidth - Maximum visual width (number of visible characters)
+ * @param targetStartCol - Start column of target range (1-based)
+ * @param targetEndCol - End column of target range (1-based, optional)
+ * @param maxColumn - Maximum column to show (optional, for limiting display)
+ * @returns Truncated text with target range visible, ANSI codes preserved, and visible range info
+ *
+ * @example
+ * truncateFocusRange('console.log("hello world");', 20, 1, 11)
+ * // Returns text showing columns 1-11 with ellipsis if needed
+ */
+export declare function truncateFocusRange(text: string, maxWidth: number, targetStartCol: number, targetEndCol?: number, maxColumn?: number): TruncateFocusRangeResult;
 /**
  * Wrap text to fit within a width, breaking on spaces
  * Never breaks words mid-word - if a word is too long, it will extend the line

package/lib/utils/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB9C;AAwDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsCrE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuK9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAGD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBtD;AAwCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsCrG"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB9C;AAwDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgCtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsCrE;AAqBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CA+DR;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,wBAAwB,CAgK1B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuK9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAGD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBtD;AA2JD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyCrG"}