rbxstudio-mcp 2.3.1 → 2.4.0

package/dist/__tests__/tools-guards.test.js

@@ -0,0 +1,131 @@
+import { RobloxStudioTools } from '../tools/index';
+import { parseToolText } from './helpers';
+function setup(response = { success: true }) {
+    const bridge = {
+        sendRequest: jest.fn().mockResolvedValue(response),
+    };
+    const tools = new RobloxStudioTools(bridge);
+    return { bridge, tools };
+}
+describe('RobloxStudioTools argument validation', () => {
+    test.each([
+        ['getInstanceProperties', (tools) => tools.getInstanceProperties(''), /Instance path is required/],
+        ['getInstanceChildren', (tools) => tools.getInstanceChildren(''), /Instance path is required/],
+        ['searchByProperty', (tools) => tools.searchByProperty('', 'value'), /Property name and value/],
+        ['getClassInfo', (tools) => tools.getClassInfo(''), /Class name is required/],
+        ['grep', (tools) => tools.grep(''), /pattern is required/],
+        ['setProperty', (tools) => tools.setProperty('', 'Name', 'x'), /Instance path and property name/],
+        ['massSetProperty', (tools) => tools.massSetProperty([], 'Name', 'x'), /Paths array/],
+        ['massGetProperty', (tools) => tools.massGetProperty([], 'Name'), /Paths array/],
+        ['createObject', (tools) => tools.createObject('', 'game'), /Class name and parent/],
+        ['createObjectWithProperties', (tools) => tools.createObjectWithProperties('', 'game'), /Class name and parent/],
+        ['massCreateObjects', (tools) => tools.massCreateObjects([]), /Objects array/],
+        [
+            'massCreateObjectsWithProperties',
+            (tools) => tools.massCreateObjectsWithProperties([]),
+            /Objects array/,
+        ],
+        ['deleteObject', (tools) => tools.deleteObject(''), /Instance path is required/],
+        ['smartDuplicate', (tools) => tools.smartDuplicate('game.Workspace.Part', 0), /count > 0/],
+        ['massDuplicate', (tools) => tools.massDuplicate([]), /Duplications array/],
+        [
+            'setCalculatedProperty',
+            (tools) => tools.setCalculatedProperty([], 'Name', 'formula'),
+            /Paths, property name, and formula/,
+        ],
+        [
+            'setRelativeProperty',
+            (tools) => tools.setRelativeProperty([], 'Name', 'add', 1),
+            /Paths, property name, operation, and value/,
+        ],
+        ['getScriptSource', (tools) => tools.getScriptSource(''), /Instance path is required/],
+        [
+            'setScriptSource',
+            (tools) => tools.setScriptSource('game.Script', undefined),
+            /source code string/,
+        ],
+        ['editScript missing path', (tools) => tools.editScript('', 'a', 'b'), /Instance path/],
+        ['editScript missing old', (tools) => tools.editScript('game.Script', undefined, 'b'), /old_string/],
+        ['editScript missing new', (tools) => tools.editScript('game.Script', 'a', undefined), /new_string/],
+        ['editScript identical', (tools) => tools.editScript('game.Script', 'a', 'a'), /must be different/],
+        ['searchScript', (tools) => tools.searchScript('', 'pattern'), /Instance path and pattern/],
+        ['getScriptFunction', (tools) => tools.getScriptFunction('game.Script', ''), /function name/],
+        ['findAndReplaceInScripts paths', (tools) => tools.findAndReplaceInScripts([], 'a', 'b'), /Paths array/],
+        [
+            'findAndReplaceInScripts strings',
+            (tools) => tools.findAndReplaceInScripts(['game.Script'], undefined, 'b'),
+            /old_string and new_string/,
+        ],
+        ['getAttribute', (tools) => tools.getAttribute('', 'Health'), /Instance path and attribute name/],
+        ['setAttribute', (tools) => tools.setAttribute('', 'Health', 1), /Instance path and attribute name/],
+        ['getAttributes', (tools) => tools.getAttributes(''), /Instance path is required/],
+        ['deleteAttribute', (tools) => tools.deleteAttribute('', 'Health'), /Instance path and attribute name/],
+        ['getTags', (tools) => tools.getTags(''), /Instance path is required/],
+        ['addTag', (tools) => tools.addTag('', 'Enemy'), /Instance path and tag name/],
+        ['removeTag', (tools) => tools.removeTag('', 'Enemy'), /Instance path and tag name/],
+        ['getTagged', (tools) => tools.getTagged(''), /Tag name is required/],
+        ['cloneInstance', (tools) => tools.cloneInstance('', 'game'), /Source path and target parent/],
+        ['moveInstance', (tools) => tools.moveInstance('', 'game'), /Instance path and new parent/],
+        ['validateScript', (tools) => tools.validateScript(), /Either instance path or source/],
+        ['insertAsset', (tools) => tools.insertAsset(0), /Asset ID is required/],
+        ['renderObjectView', (tools) => tools.renderObjectView(''), /Instance path is required/],
+        ['focusCamera', (tools) => tools.focusCamera(''), /Instance path is required/],
+        ['executeLua', (tools) => tools.executeLua(''), /Code is required/],
+        ['searchRobloxDocs', (tools) => tools.searchRobloxDocs(''), /query is required/],
+        ['getRobloxDoc', (tools) => tools.getRobloxDoc(''), /path is required/],
+        ['getRobloxApiReference', (tools) => tools.getRobloxApiReference(''), /name is required/],
+    ])('%s rejects invalid input before bridge use', async (_name, call, message) => {
+        const { bridge, tools } = setup();
+        await expect(call(tools)).rejects.toThrow(message);
+        expect(bridge.sendRequest).not.toHaveBeenCalled();
+    });
+});
+describe('RobloxStudioTools MCP-internal companion guards', () => {
+    test.each([
+        ['deleteObject', (tools) => tools.deleteObject('game.ServerScriptService._MCPTestCompanion')],
+        ['setScriptSource', (tools) => tools.setScriptSource('game.ServerScriptService._MCPTestCompanion', 'print(1)')],
+        ['editScript', (tools) => tools.editScript('game.ServerScriptService._MCPTestCompanion', 'a', 'b')],
+        ['cloneInstance', (tools) => tools.cloneInstance('game.ServerScriptService._MCPTestCompanion', 'game.Workspace')],
+        ['moveInstance', (tools) => tools.moveInstance('game.ServerScriptService._MCPTestCompanion', 'game.Workspace')],
+    ])('%s refuses to mutate companion scripts', async (_name, call) => {
+        const { bridge, tools } = setup();
+        const body = parseToolText(await call(tools));
+        expect(body).toMatchObject({ success: false, error: 'mcp_internal' });
+        expect(body.message).toContain('_MCPTestCompanion');
+        expect(bridge.sendRequest).not.toHaveBeenCalled();
+    });
+    test('setProperty only blocks dangerous properties on companion scripts', async () => {
+        const { bridge, tools } = setup();
+        const blocked = parseToolText(await tools.setProperty('game.ServerScriptService._MCPTestCompanion', 'Disabled', true));
+        expect(blocked).toMatchObject({ success: false, error: 'mcp_internal' });
+        expect(bridge.sendRequest).not.toHaveBeenCalled();
+        await tools.setProperty('game.ServerScriptService._MCPTestCompanion', 'DisplayName', 'ok');
+        expect(bridge.sendRequest).toHaveBeenCalledWith('/api/set-property', {
+            instancePath: 'game.ServerScriptService._MCPTestCompanion',
+            propertyName: 'DisplayName',
+            propertyValue: 'ok',
+        });
+    });
+    test('findAndReplaceInScripts skips companion scripts but still edits allowed scripts', async () => {
+        const { bridge, tools } = setup({ success: true, changed: 1 });
+        const body = parseToolText(await tools.findAndReplaceInScripts(['game.ServerScriptService._MCPTestCompanion', 'game.ServerScriptService.Main'], 'old', 'new'));
+        expect(bridge.sendRequest).toHaveBeenCalledWith('/api/find-and-replace-in-scripts', {
+            paths: ['game.ServerScriptService.Main'],
+            oldString: 'old',
+            newString: 'new',
+            validateAfter: true,
+        });
+        expect(body).toMatchObject({
+            success: true,
+            changed: 1,
+            skippedMCPInternal: ['game.ServerScriptService._MCPTestCompanion'],
+        });
+    });
+    test('findAndReplaceInScripts refuses all-companion batches', async () => {
+        const { bridge, tools } = setup();
+        const body = parseToolText(await tools.findAndReplaceInScripts(['game.StarterPlayer._MCPTestCompanion_Client'], 'old', 'new'));
+        expect(body).toMatchObject({ success: false, error: 'mcp_internal' });
+        expect(bridge.sendRequest).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=tools-guards.test.js.map

package/dist/__tests__/tools-guards.test.js.map

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

package/dist/__tests__/tools-runtime.test.d.ts

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

package/dist/__tests__/tools-runtime.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-runtime.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tools-runtime.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tools-runtime.test.js

@@ -0,0 +1,214 @@
+import { BridgeService } from '../bridge-service';
+import { RobloxStudioTools } from '../tools/index';
+import { parseToolText } from './helpers';
+function setupWithRealBridge(response = { success: true }) {
+    const bridge = new BridgeService();
+    const sendRequest = jest.spyOn(bridge, 'sendRequest').mockResolvedValue(response);
+    const tools = new RobloxStudioTools(bridge);
+    return { bridge, sendRequest, tools };
+}
+describe('play-test runtime tools', () => {
+    afterEach(() => {
+        jest.useRealTimers();
+    });
+    test('playSolo starts a bridge session and passes its sessionId to Studio', async () => {
+        const { bridge, sendRequest, tools } = setupWithRealBridge({ success: true, mode: 'play' });
+        const body = parseToolText(await tools.playSolo());
+        expect(body).toMatchObject({
+            success: true,
+            mode: 'play',
+            note: 'Use get_playtest_output to read logs; stop_play to end.',
+        });
+        expect(body.sessionId).toBe(bridge.testSession?.sessionId);
+        expect(sendRequest).toHaveBeenCalledWith('/api/play-solo', { sessionId: body.sessionId });
+        expect(bridge.testSession?.status).toBe('active');
+    });
+    test('playSolo marks the bridge session ended when Studio rejects the start request', async () => {
+        const bridge = new BridgeService();
+        jest.spyOn(bridge, 'sendRequest').mockRejectedValue(new Error('studio unavailable'));
+        const tools = new RobloxStudioTools(bridge);
+        await expect(tools.playSolo()).rejects.toThrow('studio unavailable');
+        expect(bridge.testSession).toMatchObject({
+            status: 'ended',
+            endReason: 'plugin_request_failed',
+        });
+    });
+    test('stopPlay is idempotent when no session exists or the session already ended', async () => {
+        const { bridge, tools } = setupWithRealBridge();
+        expect(parseToolText(await tools.stopPlay())).toMatchObject({
+            success: true,
+            alreadyEnded: true,
+        });
+        const sessionId = bridge.startTestSession();
+        bridge.endTestSession(sessionId, 'user_stop');
+        expect(parseToolText(await tools.stopPlay())).toMatchObject({
+            success: true,
+            alreadyEnded: true,
+            sessionId,
+            endReason: 'user_stop',
+        });
+    });
+    test('stopPlay enqueues an end command and reports confirmed completion', async () => {
+        jest.useFakeTimers();
+        const { bridge, tools } = setupWithRealBridge();
+        const sessionId = bridge.startTestSession();
+        const stopPromise = tools.stopPlay();
+        const poll = bridge.popTestCommand(sessionId, 'server');
+        expect(poll.command).toEqual({ cmd: 'end', args: 'MCP_Stop' });
+        bridge.endTestSession(sessionId, 'companion_end');
+        const body = parseToolText(await stopPromise);
+        expect(body).toMatchObject({
+            success: true,
+            confirmed: true,
+            sessionId,
+            status: 'ended',
+            endReason: 'companion_end',
+        });
+    });
+    test('getPlaytestOutput reads the bridge buffer instead of calling Studio', async () => {
+        const { bridge, sendRequest, tools } = setupWithRealBridge();
+        const sessionId = bridge.startTestSession();
+        bridge.appendTestOutput(sessionId, [{ message: 'hello', messageType: 'MessageOutput', timestamp: 1 }]);
+        const body = parseToolText(await tools.getPlaytestOutput(0, 10, ['MessageOutput']));
+        expect(body).toMatchObject({
+            sessionId,
+            status: 'active',
+            nextSinceSeq: 1,
+            entries: [
+                {
+                    seq: 1,
+                    message: 'hello',
+                    messageType: 'MessageOutput',
+                    source: 'server',
+                },
+            ],
+        });
+        expect(sendRequest).not.toHaveBeenCalled();
+    });
+});
+describe('runLiveLua preflight and reply flow', () => {
+    test('returns structured failures for missing, ended, or unready sessions', async () => {
+        const { bridge, tools } = setupWithRealBridge();
+        expect(parseToolText(await tools.runLiveLua('return 1'))).toMatchObject({
+            success: false,
+            error: 'no_playtest',
+        });
+        const endedSessionId = bridge.startTestSession();
+        bridge.endTestSession(endedSessionId, 'done');
+        expect(parseToolText(await tools.runLiveLua('return 1'))).toMatchObject({
+            success: false,
+            error: 'playtest_ended',
+        });
+        bridge.startTestSession();
+        expect(parseToolText(await tools.runLiveLua('return 1'))).toMatchObject({
+            success: false,
+            error: 'companion_not_ready',
+        });
+    });
+    test('refuses server execution when the companion reports loadstring disabled', async () => {
+        const { bridge, tools } = setupWithRealBridge();
+        const sessionId = bridge.startTestSession();
+        bridge.popTestCommand(sessionId, 'server', { hello: { loadstringReady: false } });
+        expect(parseToolText(await tools.runLiveLua('return 1'))).toMatchObject({
+            success: false,
+            error: 'loadstring_disabled',
+            target: 'server',
+        });
+    });
+    test('executes server-targeted code through an eval command and resolves the reply', async () => {
+        const { bridge, tools } = setupWithRealBridge();
+        const sessionId = bridge.startTestSession();
+        bridge.popTestCommand(sessionId, 'server', { hello: { loadstringReady: true } });
+        const resultPromise = tools.runLiveLua('return 2', 'server', undefined, 1500, false);
+        const poll = bridge.popTestCommand(sessionId, 'server');
+        expect(poll.command?.cmd).toBe('eval');
+        expect(poll.command?.args).toMatchObject({
+            code: 'return 2',
+            timeoutMs: 1500,
+            captureLogs: false,
+        });
+        bridge.resolveEvalReply(sessionId, poll.command.args.replyId, {
+            ok: true,
+            values: [2],
+            logs: [{ message: 'ran', messageType: 'MessageOutput', timestamp: 1 }],
+            durationMs: 12,
+        });
+        expect(parseToolText(await resultPromise)).toMatchObject({
+            success: true,
+            target: 'server',
+            timeoutMs: 1500,
+            durationMs: 12,
+            values: [2],
+            logs: [{ message: 'ran' }],
+        });
+    });
+    test('maps eval error replies into structured failure output', async () => {
+        const { bridge, tools } = setupWithRealBridge();
+        const sessionId = bridge.startTestSession();
+        bridge.popTestCommand(sessionId, 'server', { hello: { loadstringReady: true } });
+        const resultPromise = tools.runLiveLua('error("boom")', 'server');
+        const poll = bridge.popTestCommand(sessionId, 'server');
+        bridge.resolveEvalReply(sessionId, poll.command.args.replyId, {
+            ok: false,
+            errorType: 'runtime_error',
+            error: 'boom',
+            traceback: 'trace',
+        });
+        expect(parseToolText(await resultPromise)).toMatchObject({
+            success: false,
+            error: 'runtime_error',
+            message: 'boom',
+            traceback: 'trace',
+        });
+    });
+    test('returns structured client-targeting failures before enqueueing eval', async () => {
+        const { bridge, tools } = setupWithRealBridge();
+        const sessionId = bridge.startTestSession();
+        expect(parseToolText(await tools.runLiveLua('return 1', 'client'))).toMatchObject({
+            success: false,
+            error: 'no_clients_connected',
+        });
+        bridge.popTestCommand(sessionId, 'client', {
+            userId: 1,
+            playerName: 'Alice',
+            hello: { loadstringReady: true },
+        });
+        bridge.popTestCommand(sessionId, 'client', {
+            userId: 2,
+            playerName: 'Bob',
+            hello: { loadstringReady: true },
+        });
+        expect(parseToolText(await tools.runLiveLua('return 1', 'client'))).toMatchObject({
+            success: false,
+            error: 'multiple_clients',
+        });
+        expect(parseToolText(await tools.runLiveLua('return 1', 'client', 'Carla'))).toMatchObject({
+            success: false,
+            error: 'no_such_player',
+        });
+    });
+    test('forwards client-targeted evals through the server companion queue', async () => {
+        const { bridge, tools } = setupWithRealBridge();
+        const sessionId = bridge.startTestSession();
+        bridge.popTestCommand(sessionId, 'client', {
+            userId: 1,
+            playerName: 'Alice',
+            hello: { loadstringReady: true },
+        });
+        const resultPromise = tools.runLiveLua('return game.Players.LocalPlayer.Name', 'client');
+        const poll = bridge.popTestCommand(sessionId, 'server');
+        expect(poll.command?.cmd).toBe('eval');
+        expect(poll.command?.args.forwardTo).toEqual({ userId: 1, playerName: 'Alice' });
+        bridge.resolveEvalReply(sessionId, poll.command.args.replyId, {
+            ok: true,
+            values: ['Alice'],
+        });
+        expect(parseToolText(await resultPromise)).toMatchObject({
+            success: true,
+            target: 'client',
+            player: { name: 'Alice', userId: 1 },
+            values: ['Alice'],
+        });
+    });
+});
+//# sourceMappingURL=tools-runtime.test.js.map

package/dist/__tests__/tools-runtime.test.js.map

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

package/dist/__tests__/tools-visual.test.d.ts

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

package/dist/__tests__/tools-visual.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-visual.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tools-visual.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tools-visual.test.js

@@ -0,0 +1,149 @@
+import { RobloxStudioTools } from '../tools/index';
+import { parseToolText } from './helpers';
+function setup(response) {
+    const bridge = {
+        sendRequest: jest.fn().mockResolvedValue(response),
+    };
+    return new RobloxStudioTools(bridge);
+}
+function onePixelRgbaBase64() {
+    return Buffer.from([255, 0, 0, 255]).toString('base64');
+}
+describe('visual tool PNG conversion', () => {
+    test('captureScreenshot converts RGBA payloads to PNG image content', async () => {
+        const tools = setup({
+            success: true,
+            message: 'captured',
+            originalWidth: 1,
+            originalHeight: 1,
+            width: 1,
+            height: 1,
+            base64: onePixelRgbaBase64(),
+        });
+        const result = await tools.captureScreenshot(1, 1);
+        const body = parseToolText(result);
+        expect(body).toMatchObject({
+            success: true,
+            message: 'captured',
+            width: 1,
+            height: 1,
+            format: 'PNG',
+        });
+        expect(result.content[1]).toMatchObject({
+            type: 'image',
+            mimeType: 'image/png',
+        });
+        expect(result.content[1].data).toMatch(/^iVBORw0KGgo/);
+    });
+    test('renderObjectView converts RGBA payloads to PNG image content', async () => {
+        const tools = setup({
+            success: true,
+            message: 'rendered',
+            viewInfo: { angle: 'iso' },
+            width: 1,
+            height: 1,
+            base64: onePixelRgbaBase64(),
+        });
+        const result = await tools.renderObjectView('game.Workspace.Part');
+        const body = parseToolText(result);
+        expect(body).toMatchObject({
+            success: true,
+            message: 'rendered',
+            viewInfo: { angle: 'iso' },
+            format: 'PNG',
+        });
+        expect(result.content[1]).toMatchObject({
+            type: 'image',
+            mimeType: 'image/png',
+        });
+        expect(result.content[1].data).toMatch(/^iVBORw0KGgo/);
+    });
+    test('renderGui converts RGBA payloads to PNG image content', async () => {
+        const tools = setup({
+            success: true,
+            message: 'rendered gui',
+            guiInfo: { objectClass: 'ScreenGui', renderedElements: 2 },
+            width: 1,
+            height: 1,
+            base64: onePixelRgbaBase64(),
+        });
+        const result = await tools.renderGui('game.StarterGui.MainMenu');
+        const body = parseToolText(result);
+        expect(body).toMatchObject({
+            success: true,
+            message: 'rendered gui',
+            guiInfo: { objectClass: 'ScreenGui', renderedElements: 2 },
+            format: 'PNG',
+        });
+        expect(result.content[1]).toMatchObject({
+            type: 'image',
+            mimeType: 'image/png',
+        });
+        expect(result.content[1].data).toMatch(/^iVBORw0KGgo/);
+    });
+    test('renderGui returns a structured conversion error for bad buffers', async () => {
+        const tools = setup({
+            success: true,
+            width: 2,
+            height: 2,
+            base64: onePixelRgbaBase64(),
+        });
+        const body = parseToolText(await tools.renderGui('game.StarterGui.MainMenu'));
+        expect(body).toMatchObject({ success: false });
+        expect(body.error).toContain('PNG conversion failed');
+        expect(body.error).toContain('Buffer size mismatch');
+    });
+    test('renderGui forwards instancePath and size caps, passing through non-image responses', async () => {
+        const bridge = {
+            sendRequest: jest.fn().mockResolvedValue({ success: false, error: 'not available' }),
+        };
+        const tools = new RobloxStudioTools(bridge);
+        const body = parseToolText(await tools.renderGui('game.StarterGui.HUD', { maxWidth: 512, maxHeight: 256 }));
+        expect(body).toEqual({ success: false, error: 'not available' });
+        expect(bridge.sendRequest).toHaveBeenCalledWith('/api/render-gui', {
+            instancePath: 'game.StarterGui.HUD',
+            region: 'element',
+            maxWidth: 512,
+            maxHeight: 256,
+        });
+    });
+    test('renderGui forwards an explicit screen region', async () => {
+        const bridge = {
+            sendRequest: jest.fn().mockResolvedValue({ success: false, error: 'not available' }),
+        };
+        const tools = new RobloxStudioTools(bridge);
+        await tools.renderGui('game.StarterGui.MainMenu', { region: 'screen' });
+        expect(bridge.sendRequest).toHaveBeenCalledWith('/api/render-gui', {
+            instancePath: 'game.StarterGui.MainMenu',
+            region: 'screen',
+            maxWidth: undefined,
+            maxHeight: undefined,
+        });
+    });
+    test('captureScreenshot returns a structured conversion error for bad buffers', async () => {
+        const tools = setup({
+            success: true,
+            width: 2,
+            height: 2,
+            base64: onePixelRgbaBase64(),
+        });
+        const body = parseToolText(await tools.captureScreenshot(2, 2));
+        expect(body.success).toBe(false);
+        expect(body.error).toContain('PNG conversion failed');
+        expect(body.error).toContain('Buffer size mismatch');
+        expect(body.originalResponse.width).toBe(2);
+    });
+    test('renderObjectView returns a structured conversion error for bad buffers', async () => {
+        const tools = setup({
+            success: true,
+            width: 2,
+            height: 2,
+            base64: onePixelRgbaBase64(),
+        });
+        const body = parseToolText(await tools.renderObjectView('game.Workspace.Part'));
+        expect(body).toMatchObject({ success: false });
+        expect(body.error).toContain('PNG conversion failed');
+        expect(body.error).toContain('Buffer size mismatch');
+    });
+});
+//# sourceMappingURL=tools-visual.test.js.map

package/dist/__tests__/tools-visual.test.js.map

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