rbxstudio-mcp 2.3.1 → 2.4.0

package/README.md

@@ -1,6 +1,6 @@
 # Roblox Studio MCP Server
 
-MCP server for AI-powered Roblox Studio integration. 29 specialized tools for exploring projects, analyzing scripts, and performing bulk operations. **Now with Claude Code-style script editing and visual feedback!**
+MCP server for AI-powered Roblox Studio integration. 43 specialized tools for exploring projects, analyzing scripts, and performing bulk operations. **Now with Claude Code-style script editing and visual feedback!**
 
 https://devforum.roblox.com/t/v180-roblox-studio-mcp-speed-up-your-workflow-by-letting-ai-read-paths-and-properties/3707071
 
@@ -132,12 +132,12 @@ graph TB
 ```
 
 ### Key Components:
-- MCP Server (Node.js/TypeScript) - Exposes 24 tools via stdio
+- MCP Server (Node.js/TypeScript) - Exposes 46 tools via stdio
 - HTTP Bridge - Request/response queue on localhost:3002
 - Studio Plugin (Luau) - Polls server and executes API calls
 - Smart Caching - Efficient data transfer
 
-## 29 AI Tools
+## 43 AI Tools
 
 ### File System Tools
 - `get_file_tree` - Complete project hierarchy with scripts, models, folders
@@ -179,17 +179,23 @@ graph TB
 ### Script Validation Tool (NEW in v1.9.0)
 - `validate_script` - Validate Lua/Luau syntax without running, includes deprecation warnings
 
-### Undo/Redo Tools (NEW in v1.10.0)
-- `undo` - Undo the last MCP operation in Studio's history
-- `redo` - Redo a previously undone operation
+### Undo/Redo Tools (expanded in v2.5.0)
+- `undo(count?)` - Undo the last MCP operation(s) in Studio's history. Pass `count` (default 1, max 100) to roll back several steps in one call. Returns an `entries` array describing each step undone; reports `stopped_early: true` if Studio's undo stack runs out.
+- `redo(count?)` - Mirror of `undo`. Redo previously undone change(s).
+- `get_history({ limit?, include_details? })` - **NEW.** Read-only peek at the MCP undo/redo stacks. Returns Studio's authoritative `can_undo`/`can_redo` flags plus the recent entries (default last 20, max 100) with action/target/summary/timestamp. Useful for "what am I about to undo?" before committing, or for situational awareness after a session resume.
 
-### Claude Code-Style Script Editing (NEW in v1.12.0) ⭐
+**Coverage:** Every mutation tool — including `execute_lua`, `edit_script`, and `find_and_replace_in_scripts` — is wrapped in a single ChangeHistoryService recording per call (one tool call = one Ctrl+Z). If a handler errors, the recording is canceled and Studio rolls back any partial mutations. The plugin keeps an in-memory log of the last 100 MCP actions for human-readable summaries; Studio's own undo stack is authoritative.
+
+**`execute_lua` caveat:** mutations performed inside `task.spawn`/`task.delay` callbacks that run AFTER the handler returns are not captured in the waypoint. Keep mutation work synchronous within the call for reliable undo.
+
+### Claude Code-Style Script Editing ⭐
 String-based script editing that works just like Claude Code's Edit tool - no more line number guessing!
 
-- `edit_script` - **RECOMMENDED**: Find exact text and replace it, no line numbers needed. Auto-validates syntax and rejects broken code.
+- `edit_script` - **RECOMMENDED** for partial edits: find exact text and replace it, no line numbers needed. Auto-validates Luau syntax and rejects broken code.
 - `search_script` - Search for patterns within scripts (like grep), with optional context lines
 - `get_script_function` - Extract a specific function by name with line numbers
 - `find_and_replace_in_scripts` - Batch find & replace across multiple scripts
+- `validate_script` - Standalone Luau syntax check (also runs automatically after every `edit_script`)
 
 ```typescript
 // Example: Safe string-based editing
@@ -203,14 +209,21 @@ edit_script({
 // If it matches → clean replacement ✓
 ```
 
-**Why this is better:**
-| Line-based (old) | String-based (v1.12.0) |
+**Why string-based editing replaced line-based editing:**
+| Line-based (removed) | String-based (current) |
 |---|---|
 | "Edit lines 45-52" 🤞 | "Find this exact code" ✓ |
 | Line numbers shift after edits | Matches the actual content |
 | Can break `end` statements | Validates syntax before applying |
 | Requires counting lines | Just copy the text to replace |
 
+> **Note:** The legacy line-based partial editors (`edit_script_lines`,
+> `insert_script_lines`, `delete_script_lines`) were removed. They've been
+> fully superseded by `edit_script` — for example, "delete lines 10-15"
+> becomes `edit_script(old_string=<those lines>, new_string="")`,
+> and "insert after line 20" becomes
+> `edit_script(old_string=<line 20>, new_string=<line 20 + new code>)`.
+
 ### Visual Feedback Tools (NEW in v2.2.0) 👁️
 AI can now "see" what it creates! Camera control + screenshot = complete visual feedback loop.
 
@@ -231,10 +244,37 @@ capture_screenshot() // → AI sees what it created! 👀
 
 **Supported angles:** `front`, `back`, `left`, `right`, `top`, `bottom`, `iso` (isometric), `iso_front`, `iso_back`, `low_angle`, `high_angle`, or custom `{pitch, yaw, roll}` angles.
 
-> **Note:** All mutation tools (set_property, create_object, delete_object, etc.) are now automatically wrapped in ChangeHistoryService recordings, making every AI change undoable via Ctrl+Z in Studio or the `undo` tool.
+> **Note:** All mutation tools — including arbitrary `execute_lua` execution and the script editing tools — are automatically wrapped in ChangeHistoryService recordings, making every AI change undoable via Ctrl+Z in Studio or the `undo` tool. Errors auto-rollback partial mutations. See the **Undo/Redo Tools** section above for `count` and `get_history`.
 
 > Note: Previous tools removed: `get_file_content`, `get_file_properties`, `get_selection`, `get_dependencies`, `validate_references`. Use Rojo/Argon workflows instead.
 
+### Roblox Docs Tools (NEW in v2.4.0) 📚
+
+AI models often have stale or imprecise training data on Roblox-specific topics — animation, `Motor6D` `C0`/`C1`, R6/R15 rig anatomy, `AlignOrientation`, and so on. These tools give the model first-class access to the canonical reference: a local mirror of [github.com/Roblox/creator-docs](https://github.com/Roblox/creator-docs).
+
+- `search_roblox_docs` - Pure-JS regex search across the docs (like `grep`). Returns line-numbered hits with optional context.
+- `get_roblox_doc` - Read a full doc file by relative path.
+- `list_roblox_docs` - List a directory's contents (like `ls`).
+- `get_roblox_api_reference` - Resolve a class/datatype/enum/global/library by name (e.g. `"Motor6D"`, `"CFrame"`, `"Material"`) and return parsed YAML.
+
+**How the cache works:**
+- First use lazily downloads ~30MB of docs (~2s) to a per-OS cache directory:
+  - Linux: `~/.cache/rbxstudio-mcp-nodejs/docs`
+  - macOS: `~/Library/Caches/rbxstudio-mcp-nodejs/docs`
+  - Windows: `%LOCALAPPDATA%\rbxstudio-mcp-nodejs\Cache\docs`
+- Override with `RBXSTUDIO_DOCS_DIR=/some/path`.
+- Subsequent calls hit the cache instantly.
+- Every 24h, the next call hits GitHub's commits API for the latest SHA — if unchanged, no redownload (~20ms); if changed, the tarball is re-fetched.
+
+**Filtering:** to keep the cache small the tarball is filtered during extract to the parts AI tends to need: `reference/engine/` (full API ref) plus `animation/`, `characters/`, `ui/`, `scripting/`, `physics/`, `workspace/`, `players/`, `input/`, `cloud-services/`, `sound/`. The full creator-docs repo is ~200MB; our cached subset is ~7MB.
+
+```typescript
+// Typical workflow when stuck on Motor6D:
+search_roblox_docs("Motor6D C0", { extensions: ["yaml"] })
+get_roblox_api_reference("Motor6D")     // structured YAML
+get_roblox_doc("en-us/animation/using.md")  // long-form guide
+```
+
 ## AI-Optimized Features
 
 ### Mass Operations (v1.3.0)
@@ -356,13 +396,26 @@ validate_script("game.ServerScriptService.MainScript")
 // Monitor game output after testing
 get_output({ limit: 50, messageTypes: ["MessageError", "MessageWarning"] })
 
-// === NEW in v1.10.0 ===
+// === Undo / Redo / History (expanded in v2.5.0) ===
+
+// Peek at recent changes before undoing — non-destructive
+get_history({ limit: 5 })
+// → { can_undo: true, tracked_undo_count: 12,
+//     undo_stack: [{ index: 0, action: "set_property",
+//                    target: "game.Workspace.Part", summary: "Position = ...",
+//                    age_seconds: 3 }, ...] }
 
-// Undo the last MCP operation
+// Undo the last MCP operation (one Ctrl+Z worth)
 undo()
 
-// Redo a previously undone operation
+// Roll back several steps in one round-trip
+undo({ count: 5 })
+// → { undone_count: 5, entries: [...], remaining_undos: 7,
+//     stopped_early: false }
+
+// Redo (mirror of undo)
 redo()
+redo({ count: 3 })
 ```
 
 ## Configuration

package/dist/__tests__/bridge-service.test.js

@@ -1,4 +1,5 @@
 import { BridgeService } from '../bridge-service';
+import { observeRejection } from './helpers';
 describe('BridgeService', () => {
     let bridgeService;
     beforeEach(() => {
@@ -12,7 +13,7 @@ describe('BridgeService', () => {
         test('should create and store a pending request', async () => {
             const endpoint = '/api/test';
             const data = { test: 'data' };
-            const requestPromise = bridgeService.sendRequest(endpoint, data);
+            bridgeService.sendRequest(endpoint, data);
             // Check that request is pending
             const pendingRequest = bridgeService.getPendingRequest();
             expect(pendingRequest).toBeTruthy();
@@ -44,9 +45,10 @@ describe('BridgeService', () => {
             const endpoint = '/api/test';
             const data = { test: 'data' };
             const requestPromise = bridgeService.sendRequest(endpoint, data);
+            const rejection = observeRejection(requestPromise);
             // Fast-forward time by 31 seconds
             jest.advanceTimersByTime(31000);
-            await expect(requestPromise).rejects.toThrow('Request timeout');
+            await expect(rejection).resolves.toThrow('Request timeout');
         });
     });
     describe('Cleanup Operations', () => {
@@ -57,13 +59,14 @@ describe('BridgeService', () => {
                 bridgeService.sendRequest('/api/test2', {}),
                 bridgeService.sendRequest('/api/test3', {})
             ];
+            const rejections = promises.map(observeRejection);
             // Fast-forward time by 31 seconds
             jest.advanceTimersByTime(31000);
             // Clean up old requests
             bridgeService.cleanupOldRequests();
             // All requests should be rejected
-            for (const promise of promises) {
-                await expect(promise).rejects.toThrow('Request timeout');
+            for (const rejection of rejections) {
+                await expect(rejection).resolves.toThrow('Request timeout');
             }
             // No pending requests should remain
             expect(bridgeService.getPendingRequest()).toBeNull();
@@ -75,34 +78,43 @@ describe('BridgeService', () => {
                 bridgeService.sendRequest('/api/test2', {}),
                 bridgeService.sendRequest('/api/test3', {})
             ];
+            const rejections = promises.map(observeRejection);
             // Clear all requests
             bridgeService.clearAllPendingRequests();
             // All requests should be rejected with connection closed error
-            for (const promise of promises) {
-                await expect(promise).rejects.toThrow('Connection closed');
+            for (const rejection of rejections) {
+                await expect(rejection).resolves.toThrow('Connection closed');
             }
             // No pending requests should remain
             expect(bridgeService.getPendingRequest()).toBeNull();
         });
     });
     describe('Request Priority', () => {
-        test('should return oldest request first', async () => {
+        test('should return the oldest pending request without consuming it', async () => {
             // Create requests with small delays
-            bridgeService.sendRequest('/api/test1', { order: 1 });
-            // Small delay to ensure different timestamps
-            await new Promise(resolve => setTimeout(resolve, 10));
-            bridgeService.sendRequest('/api/test2', { order: 2 });
-            await new Promise(resolve => setTimeout(resolve, 10));
-            bridgeService.sendRequest('/api/test3', { order: 3 });
+            jest.setSystemTime(1000);
+            const first = bridgeService.sendRequest('/api/test1', { order: 1 });
+            jest.setSystemTime(1010);
+            const second = bridgeService.sendRequest('/api/test2', { order: 2 });
+            jest.setSystemTime(1020);
+            const third = bridgeService.sendRequest('/api/test3', { order: 3 });
             // Should get the first (oldest) request
             const firstRequest = bridgeService.getPendingRequest();
             expect(firstRequest?.request.data.order).toBe(1);
+            // Polling peeks; the same request remains pending until resolved.
+            expect(bridgeService.getPendingRequest()?.request.data.order).toBe(1);
+            bridgeService.resolveRequest(firstRequest.requestId, { ok: 1 });
             // Should get the second request next
             const secondRequest = bridgeService.getPendingRequest();
             expect(secondRequest?.request.data.order).toBe(2);
+            bridgeService.resolveRequest(secondRequest.requestId, { ok: 2 });
             // Should get the third request last
             const thirdRequest = bridgeService.getPendingRequest();
             expect(thirdRequest?.request.data.order).toBe(3);
+            bridgeService.resolveRequest(thirdRequest.requestId, { ok: 3 });
+            await expect(first).resolves.toEqual({ ok: 1 });
+            await expect(second).resolves.toEqual({ ok: 2 });
+            await expect(third).resolves.toEqual({ ok: 3 });
         });
     });
 });

package/dist/__tests__/bridge-service.test.js.map

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

package/dist/__tests__/bridge-session.test.d.ts

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

package/dist/__tests__/bridge-session.test.d.ts.map

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

package/dist/__tests__/bridge-session.test.js

@@ -0,0 +1,171 @@
+import { BridgeService } from '../bridge-service';
+describe('BridgeService test sessions', () => {
+    afterEach(() => {
+        jest.useRealTimers();
+    });
+    test('startTestSession initializes state and supersedes an active session', async () => {
+        jest.useFakeTimers();
+        const bridge = new BridgeService();
+        const first = bridge.startTestSession();
+        const waiter = bridge.waitForTestEnd(1000);
+        const second = bridge.startTestSession();
+        await expect(waiter).resolves.toBe(true);
+        expect(second).not.toBe(first);
+        expect(bridge.testSession).toMatchObject({
+            sessionId: second,
+            status: 'active',
+            serverReady: false,
+            serverLoadstringReady: false,
+        });
+    });
+    test('server companion polling records readiness and pops queued commands', () => {
+        const bridge = new BridgeService();
+        const sessionId = bridge.startTestSession();
+        expect(bridge.enqueueTestCommand({ cmd: 'end', args: 'stop' })).toBe(true);
+        const firstPoll = bridge.popTestCommand(sessionId, 'server', {
+            hello: { loadstringReady: true },
+        });
+        expect(firstPoll).toEqual({
+            command: { cmd: 'end', args: 'stop' },
+            ended: false,
+            sessionMatch: true,
+        });
+        expect(bridge.getTestSessionStatus()).toMatchObject({
+            sessionId,
+            serverReady: true,
+            serverLoadstringReady: true,
+        });
+        expect(bridge.popTestCommand(sessionId, 'server').command).toBeNull();
+    });
+    test('client companion polling registers, updates, and receives per-client commands', () => {
+        const bridge = new BridgeService();
+        const sessionId = bridge.startTestSession();
+        const firstPoll = bridge.popTestCommand(sessionId, 'client', {
+            userId: 42,
+            playerName: 'Alice',
+            hello: { loadstringReady: true },
+        });
+        expect(firstPoll).toMatchObject({ command: null, ended: false, sessionMatch: true });
+        expect(bridge.getTestSessionStatus()?.clients).toEqual([
+            { userId: 42, name: 'Alice', ready: true, loadstringReady: true },
+        ]);
+        expect(bridge.enqueueTestCommand({ cmd: 'eval', args: { replyId: 'client-reply' } }, { client: 42 })).toBe(true);
+        const secondPoll = bridge.popTestCommand(sessionId, 'client', {
+            userId: 42,
+            playerName: 'AliceRenamed',
+            hello: { loadstringReady: false },
+        });
+        expect(secondPoll.command).toEqual({ cmd: 'eval', args: { replyId: 'client-reply' } });
+        expect(bridge.getTestSessionStatus()?.clients).toEqual([
+            { userId: 42, name: 'AliceRenamed', ready: true, loadstringReady: false },
+        ]);
+        expect(bridge.enqueueTestCommand({ cmd: 'eval' }, { client: 404 })).toBe(false);
+    });
+    test('polling with the wrong or missing session returns non-matching ended state', () => {
+        const bridge = new BridgeService();
+        expect(bridge.popTestCommand('missing')).toEqual({
+            command: null,
+            ended: true,
+            sessionMatch: false,
+        });
+        const sessionId = bridge.startTestSession();
+        expect(bridge.popTestCommand(sessionId, 'client')).toEqual({
+            command: null,
+            ended: false,
+            sessionMatch: true,
+        });
+    });
+    test('appendTestOutput filters, limits, cursors, and trims the ring buffer', () => {
+        const bridge = new BridgeService();
+        const sessionId = bridge.startTestSession();
+        expect(bridge.appendTestOutput('wrong', [{ message: 'ignored', messageType: 'MessageOutput', timestamp: 1 }])).toEqual({ accepted: 0, sessionMatch: false });
+        bridge.appendTestOutput(sessionId, [
+            { message: 'one', messageType: 'MessageOutput', timestamp: 1 },
+            { message: 'warn', messageType: 'MessageWarning', timestamp: 2 },
+            { message: 'two', messageType: 'MessageOutput', timestamp: 3 },
+        ]);
+        expect(bridge.getTestOutput({ sinceSeq: 1, messageTypes: ['MessageOutput'], limit: 1 })).toMatchObject({
+            sessionId,
+            status: 'active',
+            nextSinceSeq: 3,
+            entries: [{ seq: 3, message: 'two' }],
+        });
+        const many = Array.from({ length: 5005 }, (_, index) => ({
+            message: `m${index}`,
+            messageType: 'MessageOutput',
+            timestamp: index,
+        }));
+        bridge.appendTestOutput(sessionId, many);
+        const capped = bridge.getTestOutput({ limit: 5000 });
+        expect(capped.entries).toHaveLength(5000);
+        expect(capped.entries[0].seq).toBeGreaterThan(1);
+    });
+    test('endTestSession is idempotent and wakes waiters', async () => {
+        jest.useFakeTimers();
+        const bridge = new BridgeService();
+        const sessionId = bridge.startTestSession();
+        const waiter = bridge.waitForTestEnd(1000);
+        expect(bridge.endTestSession('wrong', 'done')).toBe(false);
+        expect(bridge.endTestSession(sessionId, 'done', { ok: true })).toBe(true);
+        expect(bridge.endTestSession(sessionId, 'late')).toBe(true);
+        await expect(waiter).resolves.toBe(true);
+        expect(bridge.testSession).toMatchObject({
+            status: 'ended',
+            endReason: 'done',
+            endValue: { ok: true },
+        });
+    });
+    test('waitForTestEnd resolves false on timeout and true without an active session', async () => {
+        jest.useFakeTimers();
+        const bridge = new BridgeService();
+        await expect(bridge.waitForTestEnd(100)).resolves.toBe(true);
+        bridge.startTestSession();
+        const waiter = bridge.waitForTestEnd(100);
+        jest.advanceTimersByTime(100);
+        await expect(waiter).resolves.toBe(false);
+    });
+    test('registerEvalReply resolves delivered replies and rejects stale sessions', async () => {
+        const bridge = new BridgeService();
+        await expect(bridge.registerEvalReply('none', 'server', 1000)).resolves.toMatchObject({
+            ok: false,
+            errorType: 'companion_error',
+        });
+        const sessionId = bridge.startTestSession();
+        const reply = bridge.registerEvalReply('reply-1', 'server', 1000);
+        expect(bridge.resolveEvalReply('wrong', 'reply-1', { ok: true })).toBe(false);
+        expect(bridge.resolveEvalReply(sessionId, 'reply-1', { ok: true, values: ['ok'] })).toBe(true);
+        expect(bridge.resolveEvalReply(sessionId, 'reply-1', { ok: true })).toBe(false);
+        await expect(reply).resolves.toEqual({ ok: true, values: ['ok'] });
+    });
+    test('registerEvalReply watchdog distinguishes unclaimed commands from claimed timeouts', async () => {
+        jest.useFakeTimers();
+        const bridge = new BridgeService();
+        const sessionId = bridge.startTestSession();
+        const unclaimed = bridge.registerEvalReply('unclaimed', 'server', 1000);
+        jest.advanceTimersByTime(2500);
+        await expect(unclaimed).resolves.toMatchObject({
+            ok: false,
+            errorType: 'companion_error',
+        });
+        const claimed = bridge.registerEvalReply('claimed', 'server', 1000);
+        bridge.enqueueTestCommand({ cmd: 'eval', args: { replyId: 'claimed' } });
+        bridge.popTestCommand(sessionId, 'server');
+        jest.advanceTimersByTime(2500);
+        await expect(claimed).resolves.toMatchObject({
+            ok: false,
+            errorType: 'timeout',
+        });
+    });
+    test('ending a session resolves pending eval replies with companion_error', async () => {
+        const bridge = new BridgeService();
+        const sessionId = bridge.startTestSession();
+        const reply = bridge.registerEvalReply('reply', 'server', 5000);
+        bridge.endTestSession(sessionId, 'manual_stop');
+        await expect(reply).resolves.toMatchObject({
+            ok: false,
+            errorType: 'companion_error',
+            error: expect.stringContaining('manual_stop'),
+        });
+    });
+});
+//# sourceMappingURL=bridge-session.test.js.map

package/dist/__tests__/bridge-session.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-session.test.js","sourceRoot":"","sources":["../../src/__tests__/bridge-session.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACrF,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAEzC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,CAAC;YACvC,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,KAAK;YAClB,qBAAqB,EAAE,KAAK;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC/E,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAE5C,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE;YAC3D,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;YACxB,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;YACrC,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAC,aAAa,CAAC;YAClD,SAAS;YACT,WAAW,EAAE,IAAI;YACjB,qBAAqB,EAAE,IAAI;SAC5B,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACzF,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAE5C,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE;YAC3D,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,OAAO;YACnB,KAAK,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;YACrD,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;SAClE,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjH,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE;YAC5D,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,cAAc;YAC1B,KAAK,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;SAClC,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;YACrD,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;SAC1E,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACtF,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAEnC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/C,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAChF,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAE5C,MAAM,CACJ,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CACvG,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE;YACjC,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,EAAE;YAC9D,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,EAAE;YAChE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,EAAE;SAC/D,CAAC,CAAC;QAEH,MAAM,CACJ,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CACjF,CAAC,aAAa,CAAC;YACd,SAAS;YACT,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;SACtC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,IAAI,KAAK,EAAE;YACpB,WAAW,EAAE,eAAe;YAC5B,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAChE,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5D,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,CAAC;YACvC,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC7F,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAEnC,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7D,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAEnC,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YACpF,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,iBAAiB;SAC7B,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9E,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/F,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhF,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACnG,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAE5C,MAAM,SAAS,GAAG,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACxE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC7C,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,iBAAiB;SAC7B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3C,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEhE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAEhD,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YACzC,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,iBAAiB;YAC5B,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/chunker.test.d.ts

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

package/dist/__tests__/chunker.test.d.ts.map

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