@quenty/nevermore-cli 4.18.0 → 4.19.0

package/dist/utils/testing/parsers/jest-lua-parser.js

@@ -0,0 +1,222 @@
+/**
+ * Parser for Jest-lua verbose output (`verbose=true, ci=true`).
+ *
+ * Handles two failure modes:
+ *
+ * 1. **Jest assertion failures** — `●` blocks:
+ *    ```
+ *      ● ObservableList > add and remove > should track count
+ *
+ *        expect(received).toEqual(expected)
+ *
+ *        Expected: 3
+ *        Received: 2
+ *
+ *          at ServerScriptService.observablecollection.Shared.ObservableList.spec:45
+ *    ```
+ *
+ * 2. **Runtime errors** — `Stack Begin`/`Stack End` blocks:
+ *    ```
+ *    Error: attempt to index nil with "Connect"
+ *    Stack Begin
+ *    Script 'ServerScriptService.maid.Shared.Maid.spec', Line 23
+ *    Stack End
+ *    ```
+ *
+ * The parser is intentionally lenient — it extracts what it can, skips what
+ * it can't, and never crashes on unexpected input.
+ */
+import * as fs from 'fs';
+import { OutputHelper } from '@quenty/cli-output-helpers';
+import { resolveRobloxTestPath } from './roblox-path-resolver.js';
+/** Matches `at ServerScriptService.pkg.Path.spec:45` (with line number) */
+const AT_LOCATION_PATTERN = /^\s+at\s+(.+):(\d+)\s*$/;
+/** Matches `at ServerScriptService.pkg.Path.spec` (without line number) */
+const AT_LOCATION_NO_LINE_PATTERN = /^\s+at\s+(\S+)\s*$/;
+/** Matches `Script 'ServerScriptService.pkg.Path.spec', Line 23` */
+const SCRIPT_LOCATION_PATTERN = /Script '([^']+)', Line (\d+)/;
+/** Matches the Jest failure header: `● TestSuite > nested > test name` */
+const FAILURE_HEADER_PATTERN = /^\s*●\s+(.+)$/;
+/**
+ * Search a `.spec.lua` file for an `it()` call matching `testName`.
+ * Returns the 1-indexed line number, or `undefined` if not found.
+ */
+function _findTestLineInFile(filePath, testName) {
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes(`it("${testName}"`) ||
+            lines[i].includes(`it('${testName}'`)) {
+            return i + 1;
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse Jest-lua verbose output into `Diagnostic[]`.
+ *
+ * @param raw - Raw test output (may include ANSI codes)
+ * @param options.packageName - Package name for fallback path resolution
+ */
+export function parseJestLuaOutput(raw, options) {
+    const diagnostics = [];
+    const clean = OutputHelper.stripAnsi(raw);
+    const lines = clean.split('\n');
+    let state = 0 /* State.IDLE */;
+    let failureCtx;
+    let stackCtx;
+    let lastNonEmptyLine = '';
+    function _emitFailure(ctx) {
+        const message = ctx.messageLines
+            .join('\n')
+            .trim();
+        // 3-tier line resolution:
+        //  1. Primary: line number extracted from `at <path>:<line>` or similar
+        //  2. Secondary: search the resolved .spec.lua file for the it() call
+        //  3. Tertiary: fall back to line 1
+        let file;
+        let line;
+        if (ctx.file) {
+            file = resolveRobloxTestPath(ctx.file, options.sourcemapResolver);
+            if (ctx.line) {
+                line = ctx.line;
+            }
+            else {
+                const segments = ctx.title.split(' > ');
+                const testName = segments[segments.length - 1].trim();
+                line = _findTestLineInFile(file, testName) ?? 1;
+            }
+        }
+        else {
+            file = `src/${options.packageName}/src`;
+            line = 1;
+        }
+        diagnostics.push({
+            file,
+            line,
+            severity: 'error',
+            title: ctx.title,
+            message: message || 'Test failed',
+            source: 'jest-lua',
+        });
+    }
+    function _emitStack(ctx) {
+        const file = ctx.file
+            ? resolveRobloxTestPath(ctx.file, options.sourcemapResolver)
+            : `src/${options.packageName}/src`;
+        const line = ctx.line ?? 1;
+        diagnostics.push({
+            file,
+            line,
+            severity: 'error',
+            title: 'Runtime error',
+            message: ctx.errorMessage || 'Unknown runtime error',
+            source: 'jest-lua',
+        });
+    }
+    for (const rawLine of lines) {
+        switch (state) {
+            case 0 /* State.IDLE */: {
+                const failureMatch = rawLine.match(FAILURE_HEADER_PATTERN);
+                if (failureMatch) {
+                    failureCtx = {
+                        title: failureMatch[1].trim(),
+                        messageLines: [],
+                    };
+                    state = 1 /* State.FAILURE_BLOCK */;
+                    break;
+                }
+                if (rawLine.trim() === 'Stack Begin') {
+                    stackCtx = {
+                        errorMessage: lastNonEmptyLine,
+                    };
+                    state = 2 /* State.STACK_BLOCK */;
+                    break;
+                }
+                if (rawLine.trim() !== '') {
+                    lastNonEmptyLine = rawLine.trim();
+                }
+                break;
+            }
+            case 1 /* State.FAILURE_BLOCK */: {
+                if (!failureCtx) {
+                    state = 0 /* State.IDLE */;
+                    break;
+                }
+                const atMatch = rawLine.match(AT_LOCATION_PATTERN);
+                if (atMatch) {
+                    failureCtx.file = atMatch[1];
+                    failureCtx.line = parseInt(atMatch[2], 10);
+                    _emitFailure(failureCtx);
+                    failureCtx = undefined;
+                    state = 0 /* State.IDLE */;
+                    break;
+                }
+                const atNoLineMatch = rawLine.match(AT_LOCATION_NO_LINE_PATTERN);
+                if (atNoLineMatch) {
+                    failureCtx.file = atNoLineMatch[1];
+                    _emitFailure(failureCtx);
+                    failureCtx = undefined;
+                    state = 0 /* State.IDLE */;
+                    break;
+                }
+                const nextFailure = rawLine.match(FAILURE_HEADER_PATTERN);
+                if (nextFailure) {
+                    _emitFailure(failureCtx);
+                    failureCtx = {
+                        title: nextFailure[1].trim(),
+                        messageLines: [],
+                    };
+                    break;
+                }
+                if (rawLine.trim() === 'Stack Begin') {
+                    _emitFailure(failureCtx);
+                    stackCtx = {
+                        errorMessage: failureCtx.messageLines.length > 0
+                            ? failureCtx.messageLines[failureCtx.messageLines.length - 1].trim()
+                            : failureCtx.title,
+                    };
+                    failureCtx = undefined;
+                    state = 2 /* State.STACK_BLOCK */;
+                    break;
+                }
+                failureCtx.messageLines.push(rawLine);
+                break;
+            }
+            case 2 /* State.STACK_BLOCK */: {
+                if (!stackCtx) {
+                    state = 0 /* State.IDLE */;
+                    break;
+                }
+                const scriptMatch = rawLine.match(SCRIPT_LOCATION_PATTERN);
+                if (scriptMatch) {
+                    stackCtx.file = scriptMatch[1];
+                    stackCtx.line = parseInt(scriptMatch[2], 10);
+                    break;
+                }
+                if (rawLine.trim() === 'Stack End') {
+                    _emitStack(stackCtx);
+                    stackCtx = undefined;
+                    state = 0 /* State.IDLE */;
+                    break;
+                }
+                break;
+            }
+        }
+    }
+    // Flush any pending context at end of input
+    if (failureCtx && state === 1 /* State.FAILURE_BLOCK */) {
+        _emitFailure(failureCtx);
+    }
+    if (stackCtx && state === 2 /* State.STACK_BLOCK */) {
+        _emitStack(stackCtx);
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=jest-lua-parser.js.map

package/dist/utils/testing/parsers/jest-lua-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest-lua-parser.js","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/jest-lua-parser.ts"],"names":[],"mappings":"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"}

package/dist/utils/testing/parsers/jest-lua-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jest-lua-parser.test.d.ts.map

package/dist/utils/testing/parsers/jest-lua-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest-lua-parser.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/jest-lua-parser.test.ts"],"names":[],"mappings":""}

package/dist/utils/testing/parsers/jest-lua-parser.test.js

@@ -0,0 +1,297 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { parseJestLuaOutput } from './jest-lua-parser.js';
+import { SourcemapResolver } from '../../sourcemap/index.js';
+// Mock fs.readFileSync for _findTestLineInFile
+vi.mock('fs', () => ({
+    readFileSync: vi.fn(() => {
+        throw new Error('ENOENT');
+    }),
+}));
+describe('parseJestLuaOutput', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('parses a single assertion failure with at location', () => {
+        const input = [
+            '  ● ObservableList > add and remove > should track count',
+            '',
+            '    expect(received).toEqual(expected)',
+            '',
+            '    Expected: 3',
+            '    Received: 2',
+            '',
+            '      at ServerScriptService.observablecollection.Shared.ObservableList.spec:45',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, {
+            packageName: 'observablecollection',
+        });
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({
+            file: 'src/observablecollection/src/Shared/ObservableList.spec.lua',
+            line: 45,
+            severity: 'error',
+            title: 'ObservableList > add and remove > should track count',
+            message: expect.stringContaining('expect(received).toEqual(expected)'),
+            source: 'jest-lua',
+        });
+        expect(result[0].message).toContain('Expected: 3');
+        expect(result[0].message).toContain('Received: 2');
+    });
+    it('parses multiple failures in one log', () => {
+        const input = [
+            '  ● Suite > test one',
+            '',
+            '    Expected: 1',
+            '    Received: 2',
+            '',
+            '      at ServerScriptService.mypkg.Shared.Foo.spec:10',
+            '',
+            '  ● Suite > test two',
+            '',
+            '    Expected: true',
+            '    Received: false',
+            '',
+            '      at ServerScriptService.mypkg.Shared.Bar.spec:20',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'mypkg' });
+        expect(result).toHaveLength(2);
+        expect(result[0].title).toBe('Suite > test one');
+        expect(result[0].line).toBe(10);
+        expect(result[1].title).toBe('Suite > test two');
+        expect(result[1].line).toBe(20);
+    });
+    it('parses nested 3+ level test hierarchy', () => {
+        const input = [
+            '  ● Level1 > Level2 > Level3 > Level4 > deep test',
+            '',
+            '    failure message',
+            '',
+            '      at ServerScriptService.pkg.Shared.Deep.spec:99',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'pkg' });
+        expect(result).toHaveLength(1);
+        expect(result[0].title).toBe('Level1 > Level2 > Level3 > Level4 > deep test');
+    });
+    it('falls back to line 1 when no at location and file not found', () => {
+        const input = [
+            '  ● Suite > test without location',
+            '',
+            '    some error happened',
+            '',
+            'Test Suites: 1 failed, 1 total',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'mypkg' });
+        expect(result).toHaveLength(1);
+        expect(result[0].line).toBe(1);
+        expect(result[0].file).toBe('src/mypkg/src');
+    });
+    it('searches spec file for it() call when at location has no line number', async () => {
+        const { readFileSync } = await import('fs');
+        const mockedReadFileSync = vi.mocked(readFileSync);
+        mockedReadFileSync.mockReturnValue([
+            'local require = require(script.Parent.loader).load(script)',
+            '',
+            'describe("Suite", function()',
+            '  it("my test name", function()',
+            '    -- test body',
+            '  end)',
+            'end)',
+        ].join('\n'));
+        const input = [
+            '  ● Suite > my test name',
+            '',
+            '    assertion failed',
+            '',
+            '      at ServerScriptService.mypkg.Shared.Foo.spec',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'mypkg' });
+        expect(result).toHaveLength(1);
+        expect(result[0].file).toBe('src/mypkg/src/Shared/Foo.spec.lua');
+        expect(result[0].line).toBe(4);
+    });
+    it('parses a runtime error with Stack Begin/Stack End', () => {
+        const input = [
+            'Error: attempt to index nil with "Connect"',
+            'Stack Begin',
+            "Script 'ServerScriptService.maid.Shared.Maid.spec', Line 23",
+            'Stack End',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'maid' });
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({
+            file: 'src/maid/src/Shared/Maid.spec.lua',
+            line: 23,
+            severity: 'error',
+            title: 'Runtime error',
+            message: 'Error: attempt to index nil with "Connect"',
+            source: 'jest-lua',
+        });
+    });
+    it('parses mixed Jest failures and runtime errors', () => {
+        const input = [
+            '  ● Suite > assertion test',
+            '',
+            '    Expected: 1',
+            '    Received: 2',
+            '',
+            '      at ServerScriptService.pkg.Shared.Foo.spec:10',
+            '',
+            'Error: attempt to call nil value',
+            'Stack Begin',
+            "Script 'ServerScriptService.pkg.Shared.Bar.spec', Line 5",
+            'Stack End',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'pkg' });
+        expect(result).toHaveLength(2);
+        expect(result[0].title).toBe('Suite > assertion test');
+        expect(result[0].source).toBe('jest-lua');
+        expect(result[1].title).toBe('Runtime error');
+        expect(result[1].line).toBe(5);
+    });
+    it('returns empty array for all-passing output', () => {
+        const input = [
+            'PASS  ServerScriptService.maid',
+            '  Maid',
+            '    ✓ should create (5 ms)',
+            '    ✓ should destroy (2 ms)',
+            '',
+            'Test Suites: 1 passed, 1 total',
+            'Tests:       2 passed, 2 total',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'maid' });
+        expect(result).toEqual([]);
+    });
+    it('strips ANSI escape codes cleanly', () => {
+        const input = [
+            '  \x1b[31m●\x1b[39m \x1b[1mSuite > test\x1b[22m',
+            '',
+            '    \x1b[31mExpected: 1\x1b[39m',
+            '    \x1b[32mReceived: 2\x1b[39m',
+            '',
+            '      at ServerScriptService.pkg.Shared.Foo.spec:10',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'pkg' });
+        expect(result).toHaveLength(1);
+        expect(result[0].title).toBe('Suite > test');
+        expect(result[0].line).toBe(10);
+        // Ensure no ANSI codes leaked into the message
+        expect(result[0].message).not.toMatch(/\x1b/);
+    });
+    it('handles truncated/incomplete output without crashing', () => {
+        const input = [
+            '  ● Suite > incomplete test',
+            '',
+            '    partial error message',
+            // No at-line, no Stack Begin, just ends
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'pkg' });
+        // Should still emit a diagnostic with fallback location
+        expect(result).toHaveLength(1);
+        expect(result[0].title).toBe('Suite > incomplete test');
+        expect(result[0].line).toBe(1);
+    });
+    it('handles empty input', () => {
+        const result = parseJestLuaOutput('', { packageName: 'pkg' });
+        expect(result).toEqual([]);
+    });
+    it('uses last stack frame for location in multi-frame stack', () => {
+        const input = [
+            'Error: bad argument',
+            'Stack Begin',
+            "Script 'ServerScriptService.pkg.Shared.Inner', Line 10",
+            "Script 'ServerScriptService.pkg.Shared.Outer.spec', Line 30",
+            'Stack End',
+        ].join('\n');
+        const result = parseJestLuaOutput(input, { packageName: 'pkg' });
+        expect(result).toHaveLength(1);
+        expect(result[0].file).toBe('src/pkg/src/Shared/Outer.spec.lua');
+        expect(result[0].line).toBe(30);
+    });
+    describe('with sourcemap resolver', () => {
+        const repoRoot = '/repo';
+        const sourcemap = {
+            name: 'Nevermore',
+            className: 'DataModel',
+            children: [
+                {
+                    name: 'mypkg',
+                    className: 'Folder',
+                    filePaths: [`${repoRoot}/src/mypkg/default.project.json`],
+                    children: [
+                        {
+                            name: 'Shared',
+                            className: 'Folder',
+                            children: [
+                                {
+                                    name: 'Foo',
+                                    className: 'ModuleScript',
+                                    filePaths: [`${repoRoot}/src/mypkg/src/Shared/Foo.lua`],
+                                    children: [
+                                        {
+                                            name: 'Foo.spec',
+                                            className: 'ModuleScript',
+                                            filePaths: [
+                                                `${repoRoot}/src/mypkg/src/Shared/Foo.spec.lua`,
+                                            ],
+                                        },
+                                    ],
+                                },
+                            ],
+                        },
+                    ],
+                },
+            ],
+        };
+        const resolver = SourcemapResolver.fromSourcemap(sourcemap, repoRoot);
+        it('uses sourcemap resolver for assertion failure paths', () => {
+            const input = [
+                '  ● Suite > test one',
+                '',
+                '    Expected: 1',
+                '    Received: 2',
+                '',
+                '      at ServerScriptService.mypkg.Shared.Foo.Foo.spec:10',
+            ].join('\n');
+            const result = parseJestLuaOutput(input, {
+                packageName: 'mypkg',
+                sourcemapResolver: resolver,
+            });
+            expect(result).toHaveLength(1);
+            expect(result[0].file).toBe('src/mypkg/src/Shared/Foo.spec.lua');
+            expect(result[0].line).toBe(10);
+        });
+        it('uses sourcemap resolver for runtime error paths', () => {
+            const input = [
+                'Error: attempt to index nil',
+                'Stack Begin',
+                "Script 'ServerScriptService.mypkg.Shared.Foo.Foo.spec', Line 5",
+                'Stack End',
+            ].join('\n');
+            const result = parseJestLuaOutput(input, {
+                packageName: 'mypkg',
+                sourcemapResolver: resolver,
+            });
+            expect(result).toHaveLength(1);
+            expect(result[0].file).toBe('src/mypkg/src/Shared/Foo.spec.lua');
+            expect(result[0].line).toBe(5);
+        });
+        it('falls back to heuristic when sourcemap has no mapping', () => {
+            const input = [
+                '  ● Suite > test one',
+                '',
+                '    Expected: 1',
+                '    Received: 2',
+                '',
+                '      at ServerScriptService.unknown.Shared.Bar.spec:10',
+            ].join('\n');
+            const result = parseJestLuaOutput(input, {
+                packageName: 'unknown',
+                sourcemapResolver: resolver,
+            });
+            expect(result).toHaveLength(1);
+            // Falls back to heuristic
+            expect(result[0].file).toBe('src/unknown/src/Shared/Bar.spec.lua');
+        });
+    });
+});
+//# sourceMappingURL=jest-lua-parser.test.js.map

package/dist/utils/testing/parsers/jest-lua-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest-lua-parser.test.js","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/jest-lua-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,+CAA+C;AAC/C,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACnB,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE;QACvB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG;YACZ,0DAA0D;YAC1D,EAAE;YACF,wCAAwC;YACxC,EAAE;YACF,iBAAiB;YACjB,iBAAiB;YACjB,EAAE;YACF,iFAAiF;SAClF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE;YACvC,WAAW,EAAE,sBAAsB;SACpC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,6DAA6D;YACnE,IAAI,EAAE,EAAE;YACR,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,sDAAsD;YAC7D,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,oCAAoC,CAAC;YACtE,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GAAG;YACZ,sBAAsB;YACtB,EAAE;YACF,iBAAiB;YACjB,iBAAiB;YACjB,EAAE;YACF,uDAAuD;YACvD,EAAE;YACF,sBAAsB;YACtB,EAAE;YACF,oBAAoB;YACpB,qBAAqB;YACrB,EAAE;YACF,uDAAuD;SACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,KAAK,GAAG;YACZ,mDAAmD;YACnD,EAAE;YACF,qBAAqB;YACrB,EAAE;YACF,sDAAsD;SACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAC1B,+CAA+C,CAChD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,KAAK,GAAG;YACZ,mCAAmC;YACnC,EAAE;YACF,yBAAyB;YACzB,EAAE;YACF,gCAAgC;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,kBAAkB,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACnD,kBAAkB,CAAC,eAAe,CAChC;YACE,4DAA4D;YAC5D,EAAE;YACF,8BAA8B;YAC9B,iCAAiC;YACjC,kBAAkB;YAClB,QAAQ;YACR,MAAM;SACP,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QAEF,MAAM,KAAK,GAAG;YACZ,0BAA0B;YAC1B,EAAE;YACF,sBAAsB;YACtB,EAAE;YACF,oDAAoD;SACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,KAAK,GAAG;YACZ,4CAA4C;YAC5C,aAAa;YACb,6DAA6D;YAC7D,WAAW;SACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QAElE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,mCAAmC;YACzC,IAAI,EAAE,EAAE;YACR,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,4CAA4C;YACrD,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG;YACZ,4BAA4B;YAC5B,EAAE;YACF,iBAAiB;YACjB,iBAAiB;YACjB,EAAE;YACF,qDAAqD;YACrD,EAAE;YACF,kCAAkC;YAClC,aAAa;YACb,0DAA0D;YAC1D,WAAW;SACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,KAAK,GAAG;YACZ,gCAAgC;YAChC,QAAQ;YACR,4BAA4B;YAC5B,6BAA6B;YAC7B,EAAE;YACF,gCAAgC;YAChC,gCAAgC;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QAElE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG;YACZ,iDAAiD;YACjD,EAAE;YACF,iCAAiC;YACjC,iCAAiC;YACjC,EAAE;YACF,qDAAqD;SACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,+CAA+C;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAG;YACZ,6BAA6B;YAC7B,EAAE;YACF,2BAA2B;YAC3B,wCAAwC;SACzC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjE,wDAAwD;QACxD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,KAAK,GAAG;YACZ,qBAAqB;YACrB,aAAa;YACb,wDAAwD;YACxD,6DAA6D;YAC7D,WAAW;SACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC;QAEzB,MAAM,SAAS,GAAkB;YAC/B,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,WAAW;YACtB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,OAAO;oBACb,SAAS,EAAE,QAAQ;oBACnB,SAAS,EAAE,CAAC,GAAG,QAAQ,iCAAiC,CAAC;oBACzD,QAAQ,EAAE;wBACR;4BACE,IAAI,EAAE,QAAQ;4BACd,SAAS,EAAE,QAAQ;4BACnB,QAAQ,EAAE;gCACR;oCACE,IAAI,EAAE,KAAK;oCACX,SAAS,EAAE,cAAc;oCACzB,SAAS,EAAE,CAAC,GAAG,QAAQ,+BAA+B,CAAC;oCACvD,QAAQ,EAAE;wCACR;4CACE,IAAI,EAAE,UAAU;4CAChB,SAAS,EAAE,cAAc;4CACzB,SAAS,EAAE;gDACT,GAAG,QAAQ,oCAAoC;6CAChD;yCACF;qCACF;iCACF;6BACF;yBACF;qBACF;iBACF;aACF;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEtE,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,KAAK,GAAG;gBACZ,sBAAsB;gBACtB,EAAE;gBACF,iBAAiB;gBACjB,iBAAiB;gBACjB,EAAE;gBACF,2DAA2D;aAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE;gBACvC,WAAW,EAAE,OAAO;gBACpB,iBAAiB,EAAE,QAAQ;aAC5B,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,KAAK,GAAG;gBACZ,6BAA6B;gBAC7B,aAAa;gBACb,gEAAgE;gBAChE,WAAW;aACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE;gBACvC,WAAW,EAAE,OAAO;gBACpB,iBAAiB,EAAE,QAAQ;aAC5B,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,KAAK,GAAG;gBACZ,sBAAsB;gBACtB,EAAE;gBACF,iBAAiB;gBACjB,iBAAiB;gBACjB,EAAE;gBACF,yDAAyD;aAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE;gBACvC,WAAW,EAAE,SAAS;gBACtB,iBAAiB,EAAE,QAAQ;aAC5B,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,0BAA0B;YAC1B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/testing/parsers/roblox-path-resolver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Converts Roblox instance paths from Jest-lua output back to
+ * repo-relative local filesystem paths.
+ *
+ * Two strategies:
+ *
+ * 1. **Sourcemap** (preferred) — Uses the authoritative `sourcemap.json`
+ *    mapping from `rojo sourcemap --absolute`. Exact and handles all
+ *    project layouts.
+ *
+ * 2. **Heuristic** (fallback) — Assumes `src/{slug}/src/` layout and
+ *    hard-codes `.spec`/`.story` as known dotted suffixes. Works when no
+ *    sourcemap is available.
+ */
+import type { SourcemapResolver } from '../../sourcemap/index.js';
+/**
+ * Resolve a Roblox instance path (from Jest-lua or a stack trace) to a
+ * repo-relative filesystem path.
+ *
+ * When a `sourcemapResolver` is provided, it is tried first. Falls back to
+ * the heuristic if the resolver doesn't have a mapping.
+ */
+export declare function resolveRobloxTestPath(instancePath: string, sourcemapResolver?: SourcemapResolver): string;
+//# sourceMappingURL=roblox-path-resolver.d.ts.map

package/dist/utils/testing/parsers/roblox-path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roblox-path-resolver.d.ts","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/roblox-path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,MAAM,CAOR"}

package/dist/utils/testing/parsers/roblox-path-resolver.js

@@ -0,0 +1,71 @@
+/**
+ * Converts Roblox instance paths from Jest-lua output back to
+ * repo-relative local filesystem paths.
+ *
+ * Two strategies:
+ *
+ * 1. **Sourcemap** (preferred) — Uses the authoritative `sourcemap.json`
+ *    mapping from `rojo sourcemap --absolute`. Exact and handles all
+ *    project layouts.
+ *
+ * 2. **Heuristic** (fallback) — Assumes `src/{slug}/src/` layout and
+ *    hard-codes `.spec`/`.story` as known dotted suffixes. Works when no
+ *    sourcemap is available.
+ */
+const SSS_PREFIX = 'ServerScriptService.';
+/**
+ * Resolve a Roblox instance path (from Jest-lua or a stack trace) to a
+ * repo-relative filesystem path.
+ *
+ * When a `sourcemapResolver` is provided, it is tried first. Falls back to
+ * the heuristic if the resolver doesn't have a mapping.
+ */
+export function resolveRobloxTestPath(instancePath, sourcemapResolver) {
+    if (sourcemapResolver) {
+        const resolved = sourcemapResolver.resolve(instancePath);
+        if (resolved)
+            return resolved;
+    }
+    return _resolveHeuristic(instancePath);
+}
+/**
+ * Heuristic fallback: assumes `src/{slug}/src/` layout.
+ *
+ * Handles optional `:LINE` suffixes and missing `ServerScriptService.` prefix.
+ */
+function _resolveHeuristic(instancePath) {
+    // Strip :LINE suffix if present
+    let path = instancePath.replace(/:\d+$/, '');
+    // Strip ServerScriptService. prefix
+    if (path.startsWith(SSS_PREFIX)) {
+        path = path.slice(SSS_PREFIX.length);
+    }
+    // First dot-separated segment is the package slug
+    const dotIndex = path.indexOf('.');
+    if (dotIndex === -1) {
+        // Just a package name with no sub-path — return the src dir
+        return `src/${path}/src`;
+    }
+    const packageSlug = path.slice(0, dotIndex);
+    const remaining = path.slice(dotIndex + 1);
+    // Split into segments. In Rojo, dots in filenames (e.g. "Maid.spec.lua"
+    // becomes instance "Maid.spec") are ambiguous with the hierarchy separator.
+    // Rejoin known filename suffixes like ".spec" and ".story" with a dot
+    // instead of a slash.
+    const segments = remaining.split('.');
+    const rejoined = [];
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        // If this segment is a known file suffix, merge it with the previous
+        if (i > 0 &&
+            (seg === 'spec' || seg === 'story')) {
+            rejoined[rejoined.length - 1] += `.${seg}`;
+        }
+        else {
+            rejoined.push(seg);
+        }
+    }
+    const subPath = rejoined.join('/');
+    return `src/${packageSlug}/src/${subPath}.lua`;
+}
+//# sourceMappingURL=roblox-path-resolver.js.map

package/dist/utils/testing/parsers/roblox-path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roblox-path-resolver.js","sourceRoot":"","sources":["../../../../src/utils/testing/parsers/roblox-path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAoB,EACpB,iBAAqC;IAErC,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IAED,OAAO,iBAAiB,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,YAAoB;IAC7C,gCAAgC;IAChC,IAAI,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE7C,oCAAoC;IACpC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,4DAA4D;QAC5D,OAAO,OAAO,IAAI,MAAM,CAAC;IAC3B,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAE3C,wEAAwE;IACxE,4EAA4E;IAC5E,sEAAsE;IACtE,sBAAsB;IACtB,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,qEAAqE;QACrE,IACE,CAAC,GAAG,CAAC;YACL,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,CAAC,EACnC,CAAC;YACD,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,OAAO,WAAW,QAAQ,OAAO,MAAM,CAAC;AACjD,CAAC"}

package/dist/utils/testing/parsers/roblox-path-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=roblox-path-resolver.test.d.ts.map