@gguf/coder 0.0.1

package/dist/utils/file-content-loader.spec.js

@@ -0,0 +1,140 @@
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test from 'ava';
+import { formatFileForContext, loadFileContent } from './file-content-loader.js';
+console.log(`\nfile-content-loader.spec.ts`);
+// Test setup - create temp directory for test files
+let testDir;
+test.before(async () => {
+    // Create a unique temp directory for our tests
+    testDir = join(tmpdir(), `coder-test-${Date.now()}`);
+    await mkdir(testDir, { recursive: true });
+    // Create test files
+    await writeFile(join(testDir, 'test.txt'), 'Line 1\nLine 2\nLine 3\nLine 4\nLine 5', 'utf-8');
+    await writeFile(join(testDir, 'app.tsx'), 'import React from "react";\n\nexport function App() {\n  return <div>Hello</div>;\n}', 'utf-8');
+});
+test.after.always(async () => {
+    // Clean up temp directory
+    try {
+        await rm(testDir, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+});
+// Tests for loadFileContent()
+test('loads file content successfully', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'));
+    t.true(result.success);
+    t.truthy(result.content);
+    t.is(result.metadata.lineCount, 5);
+    t.true(result.metadata.size > 0);
+});
+test('loads file with line range', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'), {
+        start: 2,
+        end: 4,
+    });
+    t.true(result.success);
+    t.truthy(result.content);
+    t.is(result.metadata.lineCount, 3); // Lines 2, 3, 4
+    t.deepEqual(result.metadata.lineRange, { start: 2, end: 4 });
+});
+test('loads single line', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'), {
+        start: 3,
+    });
+    t.true(result.success);
+    t.is(result.metadata.lineCount, 1);
+    t.deepEqual(result.metadata.lineRange, { start: 3, end: undefined });
+});
+test('handles line range beyond file length', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'), {
+        start: 3,
+        end: 100,
+    });
+    t.true(result.success);
+    t.is(result.metadata.lineCount, 3); // Lines 3, 4, 5 (only 3 lines available)
+});
+test('handles line start beyond file length', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'), {
+        start: 100,
+        end: 200,
+    });
+    t.true(result.success);
+    t.is(result.metadata.lineCount, 0); // No lines available
+});
+test('handles non-existent file', async (t) => {
+    const result = await loadFileContent(join(testDir, 'nonexistent.txt'));
+    t.false(result.success);
+    t.truthy(result.error);
+    t.is(result.metadata.size, 0);
+    t.is(result.metadata.lineCount, 0);
+});
+test('formats content with line numbers', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'), {
+        start: 2,
+        end: 3,
+    });
+    t.true(result.success);
+    t.truthy(result.content);
+    // Should have line numbers like "   2: Line 2"
+    t.true(result.content.includes('   2:'));
+    t.true(result.content.includes('   3:'));
+});
+test('calculates token estimate', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'));
+    t.true(result.success);
+    t.true(result.metadata.tokens > 0);
+    // Rough token estimate should be ~1/4 of character count
+    t.true(result.metadata.tokens <= result.metadata.size);
+});
+test('stores absolute path in metadata', async (t) => {
+    const relativePath = join(testDir, 'test.txt');
+    const result = await loadFileContent(relativePath);
+    t.true(result.success);
+    t.is(result.metadata.path, relativePath);
+    t.truthy(result.metadata.absolutePath);
+    // Absolute path should be longer or equal (handles relative paths)
+    t.true(result.metadata.absolutePath.length >= relativePath.length);
+});
+// Tests for formatFileForContext()
+test('formats file for LLM context with header and footer', async (t) => {
+    const result = await loadFileContent(join(testDir, 'app.tsx'));
+    const formatted = formatFileForContext(result);
+    // The header includes the full path, not just filename
+    t.true(formatted.includes('=== File:'));
+    t.true(formatted.includes('app.tsx'));
+    t.true(formatted.includes('==='));
+    t.true(result.content ? formatted.includes(result.content) : false);
+});
+test('formats file with line range info', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'), {
+        start: 2,
+        end: 4,
+    });
+    const formatted = formatFileForContext(result);
+    t.true(formatted.includes('Lines 2-4'));
+    t.true(formatted.includes('(3 lines'));
+});
+test('formats file with single line info', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'), {
+        start: 3,
+    });
+    const formatted = formatFileForContext(result);
+    t.true(formatted.includes('Lines 3'));
+    t.false(formatted.includes('Lines 3-')); // Should not have a range
+});
+test('handles error in formatFileForContext', async (t) => {
+    const result = await loadFileContent(join(testDir, 'nonexistent.txt'));
+    const formatted = formatFileForContext(result);
+    t.true(formatted.includes('Error loading file'));
+});
+test('includes token estimate in formatted output', async (t) => {
+    const result = await loadFileContent(join(testDir, 'test.txt'));
+    const formatted = formatFileForContext(result);
+    t.true(formatted.includes('tokens'));
+    t.true(/~\d+ tokens/.test(formatted)); // Should have "~123 tokens" format
+});
+//# sourceMappingURL=file-content-loader.spec.js.map

package/dist/utils/file-content-loader.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-content-loader.spec.js","sourceRoot":"","sources":["../../source/utils/file-content-loader.spec.ts"],"names":[],"mappings":"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"}

package/dist/utils/file-mention-handler.d.ts

@@ -0,0 +1,21 @@
+import { InputState, PlaceholderContent } from '../types/hooks.js';
+/**
+ * Handle @file mention by creating a placeholder
+ * Called when file is selected from autocomplete or on message submit
+ *
+ * Returns null if file doesn't exist (silent failure per spec)
+ */
+export declare function handleFileMention(filePath: string, currentDisplayValue: string, currentPlaceholderContent: Record<string, PlaceholderContent>, mentionText: string, // The original "@src/app.tsx:10-20" text to replace
+lineRange?: {
+    start: number;
+    end?: number;
+}): Promise<InputState | null>;
+/**
+ * Parse line range from mention text if present
+ * e.g., "@app.tsx:10-20" -> {start: 10, end: 20}
+ */
+export declare function parseLineRangeFromMention(mentionText: string): {
+    start: number;
+    end?: number;
+} | undefined;
+//# sourceMappingURL=file-mention-handler.d.ts.map

package/dist/utils/file-mention-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mention-handler.d.ts","sourceRoot":"","sources":["../../source/utils/file-mention-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,kBAAkB,EAElB,MAAM,mBAAmB,CAAC;AAG3B;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,MAAM,EAChB,mBAAmB,EAAE,MAAM,EAC3B,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC7D,WAAW,EAAE,MAAM,EAAE,oDAAoD;AACzE,SAAS,CAAC,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAC,GACvC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA8C5B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,MAAM,GACjB;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,SAAS,CAU3C"}

package/dist/utils/file-mention-handler.js

@@ -0,0 +1,59 @@
+import { PlaceholderType, } from '../types/hooks.js';
+import { loadFileContent } from './file-content-loader.js';
+/**
+ * Handle @file mention by creating a placeholder
+ * Called when file is selected from autocomplete or on message submit
+ *
+ * Returns null if file doesn't exist (silent failure per spec)
+ */
+export async function handleFileMention(filePath, currentDisplayValue, currentPlaceholderContent, mentionText, // The original "@src/app.tsx:10-20" text to replace
+lineRange) {
+    // Load file content
+    const fileResult = await loadFileContent(filePath, lineRange);
+    // If file doesn't exist or failed to load, return null (silently skip per spec)
+    if (!fileResult.success) {
+        return null;
+    }
+    // Generate unique ID for this file placeholder
+    const existingFileCount = Object.values(currentPlaceholderContent).filter(content => content.type === PlaceholderType.FILE).length;
+    const fileId = `file_${existingFileCount + 1}`;
+    // Create compact placeholder for display
+    const placeholder = lineRange
+        ? `[@${filePath}:${lineRange.start}${lineRange.end ? `-${lineRange.end}` : ''}]`
+        : `[@${filePath}]`;
+    // Create file placeholder content
+    // Use the existing FilePlaceholderContent interface
+    const fileContent = {
+        type: PlaceholderType.FILE,
+        displayText: placeholder,
+        filePath: fileResult.metadata.absolutePath,
+        content: fileResult.content || '',
+        lastModified: Date.now(),
+        encoding: 'utf-8',
+        fileSize: fileResult.metadata.size,
+    };
+    const newPlaceholderContent = {
+        ...currentPlaceholderContent,
+        [fileId]: fileContent,
+    };
+    // Replace the @mention text with placeholder in display
+    const newDisplayValue = currentDisplayValue.replace(mentionText, placeholder);
+    return {
+        displayValue: newDisplayValue,
+        placeholderContent: newPlaceholderContent,
+    };
+}
+/**
+ * Parse line range from mention text if present
+ * e.g., "@app.tsx:10-20" -> {start: 10, end: 20}
+ */
+export function parseLineRangeFromMention(mentionText) {
+    const match = mentionText.match(/:(\d+)(?:-(\d+))?$/);
+    if (!match) {
+        return undefined;
+    }
+    const start = parseInt(match[1], 10);
+    const end = match[2] ? parseInt(match[2], 10) : undefined;
+    return { start, end };
+}
+//# sourceMappingURL=file-mention-handler.js.map

package/dist/utils/file-mention-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mention-handler.js","sourceRoot":"","sources":["../../source/utils/file-mention-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,eAAe,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,QAAgB,EAChB,mBAA2B,EAC3B,yBAA6D,EAC7D,WAAmB,EAAE,oDAAoD;AACzE,SAAyC;IAEzC,oBAAoB;IACpB,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE9D,gFAAgF;IAChF,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,+CAA+C;IAC/C,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,MAAM,CACxE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI,CAChD,CAAC,MAAM,CAAC;IACT,MAAM,MAAM,GAAG,QAAQ,iBAAiB,GAAG,CAAC,EAAE,CAAC;IAE/C,yCAAyC;IACzC,MAAM,WAAW,GAAG,SAAS;QAC5B,CAAC,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,GAChC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EACvC,GAAG;QACJ,CAAC,CAAC,KAAK,QAAQ,GAAG,CAAC;IAEpB,kCAAkC;IAClC,oDAAoD;IACpD,MAAM,WAAW,GAAuB;QACvC,IAAI,EAAE,eAAe,CAAC,IAAI;QAC1B,WAAW,EAAE,WAAW;QACxB,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,YAAY;QAC1C,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,EAAE;QACjC,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;QACxB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI;KAClC,CAAC;IAEF,MAAM,qBAAqB,GAAG;QAC7B,GAAG,yBAAyB;QAC5B,CAAC,MAAM,CAAC,EAAE,WAAW;KACrB,CAAC;IAEF,wDAAwD;IACxD,MAAM,eAAe,GAAG,mBAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAE9E,OAAO;QACN,YAAY,EAAE,eAAe;QAC7B,kBAAkB,EAAE,qBAAqB;KACzC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACxC,WAAmB;IAEnB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1D,OAAO,EAAC,KAAK,EAAE,GAAG,EAAC,CAAC;AACrB,CAAC"}

package/dist/utils/file-mention-handler.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-mention-handler.spec.d.ts.map

package/dist/utils/file-mention-handler.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mention-handler.spec.d.ts","sourceRoot":"","sources":["../../source/utils/file-mention-handler.spec.ts"],"names":[],"mappings":""}

package/dist/utils/file-mention-handler.spec.js

@@ -0,0 +1,147 @@
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test from 'ava';
+import { PlaceholderType } from '../types/hooks.js';
+import { handleFileMention, parseLineRangeFromMention, } from './file-mention-handler.js';
+console.log(`\nfile-mention-handler.spec.ts`);
+// Test setup - create temp directory for test files
+let testDir;
+test.before(async () => {
+    // Create a unique temp directory for our tests
+    testDir = join(tmpdir(), `coder-handler-test-${Date.now()}`);
+    await mkdir(testDir, { recursive: true });
+    // Create test files
+    await writeFile(join(testDir, 'test.txt'), 'Line 1\nLine 2\nLine 3\nLine 4\nLine 5', 'utf-8');
+    await writeFile(join(testDir, 'app.tsx'), 'import React from "react";\n\nexport function App() {\n  return <div>Hello</div>;\n}', 'utf-8');
+});
+test.after.always(async () => {
+    // Clean up temp directory
+    try {
+        await rm(testDir, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+});
+// Tests for handleFileMention()
+test('creates placeholder for existing file', async (t) => {
+    const filePath = join(testDir, 'test.txt');
+    const result = await handleFileMention(filePath, 'Check @test.txt', {}, '@test.txt');
+    t.truthy(result);
+    // Handler uses the filePath passed in for the placeholder display
+    t.is(result.displayValue, `Check [@${filePath}]`);
+    t.is(Object.keys(result.placeholderContent).length, 1);
+    const placeholder = Object.values(result.placeholderContent)[0];
+    t.is(placeholder.type, PlaceholderType.FILE);
+    t.true(placeholder.content.includes('Line 1'));
+});
+test('creates placeholder with line range', async (t) => {
+    const filePath = join(testDir, 'test.txt');
+    const result = await handleFileMention(filePath, 'Check @test.txt:2-4', {}, '@test.txt:2-4', { start: 2, end: 4 });
+    t.truthy(result);
+    t.is(result.displayValue, `Check [@${filePath}:2-4]`);
+    const placeholder = Object.values(result.placeholderContent)[0];
+    t.true(placeholder.content.includes('Line 2'));
+    t.true(placeholder.content.includes('Line 4'));
+    t.false(placeholder.content.includes('Line 1'));
+});
+test('creates placeholder with single line', async (t) => {
+    const filePath = join(testDir, 'test.txt');
+    const result = await handleFileMention(filePath, 'Check @test.txt:3', {}, '@test.txt:3', { start: 3 });
+    t.truthy(result);
+    t.is(result.displayValue, `Check [@${filePath}:3]`);
+    const placeholder = Object.values(result.placeholderContent)[0];
+    t.true(placeholder.content.includes('Line 3'));
+});
+test('returns null for non-existent file', async (t) => {
+    const result = await handleFileMention(join(testDir, 'nonexistent.txt'), 'Check @nonexistent.txt', {}, '@nonexistent.txt');
+    t.is(result, null);
+});
+test('generates unique file IDs', async (t) => {
+    // First file mention
+    const result1 = await handleFileMention(join(testDir, 'test.txt'), 'Check @test.txt', {}, '@test.txt');
+    t.truthy(result1);
+    t.true(Object.keys(result1.placeholderContent).includes('file_1'));
+    // Second file mention (with existing placeholder)
+    const result2 = await handleFileMention(join(testDir, 'app.tsx'), 'Check @test.txt and @app.tsx', result1.placeholderContent, '@app.tsx');
+    t.truthy(result2);
+    t.true(Object.keys(result2.placeholderContent).includes('file_1'));
+    t.true(Object.keys(result2.placeholderContent).includes('file_2'));
+});
+test('preserves existing placeholders', async (t) => {
+    const existingPlaceholder = {
+        file_1: {
+            type: PlaceholderType.FILE,
+            displayText: '[@existing.txt]',
+            filePath: '/test/existing.txt',
+            content: 'existing content',
+            fileSize: 100,
+        },
+    };
+    const result = await handleFileMention(join(testDir, 'test.txt'), 'Check @test.txt', existingPlaceholder, '@test.txt');
+    t.truthy(result);
+    t.is(Object.keys(result.placeholderContent).length, 2);
+    t.truthy(result.placeholderContent.file_1);
+    t.truthy(result.placeholderContent.file_2);
+});
+test('replaces mention text in display value', async (t) => {
+    const filePath = join(testDir, 'app.tsx');
+    const result = await handleFileMention(filePath, 'Please review the code in @app.tsx carefully', {}, '@app.tsx');
+    t.truthy(result);
+    t.is(result.displayValue, `Please review the code in [@${filePath}] carefully`);
+});
+test('handles multiple mentions in display value', async (t) => {
+    const testPath = join(testDir, 'test.txt');
+    const appPath = join(testDir, 'app.tsx');
+    // First mention
+    const result1 = await handleFileMention(testPath, 'Compare @test.txt and @app.tsx', {}, '@test.txt');
+    t.truthy(result1);
+    // Second mention
+    const result2 = await handleFileMention(appPath, result1.displayValue, result1.placeholderContent, '@app.tsx');
+    t.truthy(result2);
+    t.is(result2.displayValue, `Compare [@${testPath}] and [@${appPath}]`);
+});
+test('stores absolute path in placeholder', async (t) => {
+    const relativePath = join(testDir, 'test.txt');
+    const result = await handleFileMention(relativePath, 'Check @test.txt', {}, '@test.txt');
+    t.truthy(result);
+    const placeholder = Object.values(result.placeholderContent)[0];
+    // Absolute path should be stored
+    t.is(placeholder.type, PlaceholderType.FILE);
+    if (placeholder.type === PlaceholderType.FILE) {
+        t.true(placeholder.filePath.startsWith('/'));
+        t.true(placeholder.filePath.includes('test.txt'));
+    }
+});
+test('includes file content in placeholder', async (t) => {
+    const result = await handleFileMention(join(testDir, 'app.tsx'), 'Check @app.tsx', {}, '@app.tsx');
+    t.truthy(result);
+    const placeholder = Object.values(result.placeholderContent)[0];
+    t.truthy(placeholder.content);
+    t.true(placeholder.content.length > 0);
+    t.true(placeholder.content.includes('React'));
+});
+// Tests for parseLineRangeFromMention()
+test('parseLineRangeFromMention parses range', t => {
+    const result = parseLineRangeFromMention('@file.ts:10-20');
+    t.deepEqual(result, { start: 10, end: 20 });
+});
+test('parseLineRangeFromMention parses single line', t => {
+    const result = parseLineRangeFromMention('@file.ts:10');
+    t.deepEqual(result, { start: 10, end: undefined });
+});
+test('parseLineRangeFromMention returns undefined for no range', t => {
+    const result = parseLineRangeFromMention('@file.ts');
+    t.is(result, undefined);
+});
+test('parseLineRangeFromMention handles invalid range', t => {
+    const result = parseLineRangeFromMention('@file.ts:abc');
+    t.is(result, undefined);
+});
+test('parseLineRangeFromMention handles path with colons', t => {
+    // Should only parse the last colon as line range
+    const result = parseLineRangeFromMention('@src/path:to:file.ts:10-20');
+    t.deepEqual(result, { start: 10, end: 20 });
+});
+//# sourceMappingURL=file-mention-handler.spec.js.map

package/dist/utils/file-mention-handler.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mention-handler.spec.js","sourceRoot":"","sources":["../../source/utils/file-mention-handler.spec.ts"],"names":[],"mappings":"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"}

package/dist/utils/file-mention-parser.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Represents a parsed file mention from user input
+ * Supports:
+ * - @filename.ts
+ * - @src/components/Button.tsx
+ * - @file.ts:10-20 (line ranges)
+ * - @file.ts:10 (single line)
+ */
+interface FileMention {
+    rawText: string;
+    filePath: string;
+    lineRange?: {
+        start: number;
+        end?: number;
+    };
+    startIndex: number;
+    endIndex: number;
+}
+/**
+ * Parse all @mentions from user input
+ */
+export declare function parseFileMentions(input: string): FileMention[];
+/**
+ * Validate file path to prevent directory traversal attacks
+ * and ensure it's within the project directory
+ */
+export declare function isValidFilePath(filePath: string): boolean;
+/**
+ * Resolve a relative file path to an absolute path within the project
+ */
+export declare function resolveFilePath(filePath: string, cwd: string): string;
+/**
+ * Parse line range from a string like "10-20" or "10"
+ */
+export declare function parseLineRange(rangeStr: string): {
+    start: number;
+    end?: number;
+} | null;
+export {};
+//# sourceMappingURL=file-mention-parser.d.ts.map

package/dist/utils/file-mention-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mention-parser.d.ts","sourceRoot":"","sources":["../../source/utils/file-mention-parser.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,UAAU,WAAW;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAYD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAwC9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgCzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,MAAM,GACd;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,IAAI,CA2BtC"}

package/dist/utils/file-mention-parser.js

@@ -0,0 +1,122 @@
+import path from 'node:path';
+/**
+ * Regex pattern to match @file mentions
+ * Matches:
+ * - @file.ts
+ * - @src/path/to/file.tsx
+ * - @file.ts:10
+ * - @file.ts:10-20
+ */
+const FILE_MENTION_REGEX = /@([^\s:]+)(?::(\d+)(?:-(\d+))?)?/g;
+/**
+ * Parse all @mentions from user input
+ */
+export function parseFileMentions(input) {
+    const mentions = [];
+    let match;
+    // Reset regex state
+    FILE_MENTION_REGEX.lastIndex = 0;
+    while ((match = FILE_MENTION_REGEX.exec(input)) !== null) {
+        const rawText = match[0]; // Full match: "@src/app.tsx:10-20"
+        const filePath = match[1]; // Captured group 1: "src/app.tsx"
+        const lineStart = match[2]; // Captured group 2: "10"
+        const lineEnd = match[3]; // Captured group 3: "20"
+        // Skip if the file path is empty or invalid
+        if (!filePath || !isValidFilePath(filePath)) {
+            continue;
+        }
+        const mention = {
+            rawText,
+            filePath,
+            startIndex: match.index,
+            endIndex: match.index + rawText.length,
+        };
+        // Parse line range if present
+        if (lineStart) {
+            const start = parseInt(lineStart, 10);
+            const end = lineEnd ? parseInt(lineEnd, 10) : undefined;
+            // Validate line numbers
+            if (start > 0 && (!end || end >= start)) {
+                mention.lineRange = { start, end };
+            }
+        }
+        mentions.push(mention);
+    }
+    return mentions;
+}
+/**
+ * Validate file path to prevent directory traversal attacks
+ * and ensure it's within the project directory
+ */
+export function isValidFilePath(filePath) {
+    // Reject empty paths
+    if (!filePath || filePath.trim().length === 0) {
+        return false;
+    }
+    // Reject paths that try to escape parent directories
+    if (filePath.includes('..')) {
+        return false;
+    }
+    // Reject absolute paths (outside project)
+    if (path.isAbsolute(filePath)) {
+        return false;
+    }
+    // Reject Windows absolute paths (C:\, D:\, etc.) even on Unix systems
+    if (/^[A-Za-z]:[/\\]/.test(filePath)) {
+        return false;
+    }
+    // Reject paths with null bytes (security)
+    if (filePath.includes('\0')) {
+        return false;
+    }
+    // Reject paths that start with special characters that could be problematic
+    if (filePath.startsWith('/') || filePath.startsWith('\\')) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Resolve a relative file path to an absolute path within the project
+ */
+export function resolveFilePath(filePath, cwd) {
+    // Validate first
+    if (!isValidFilePath(filePath)) {
+        throw new Error(`Invalid file path: ${filePath}`);
+    }
+    // Resolve to absolute path
+    const absolutePath = path.resolve(cwd, filePath);
+    // Ensure the resolved path is still within the project directory
+    const normalizedCwd = path.resolve(cwd);
+    if (!absolutePath.startsWith(normalizedCwd)) {
+        throw new Error(`File path escapes project directory: ${filePath} -> ${absolutePath}`);
+    }
+    return absolutePath;
+}
+/**
+ * Parse line range from a string like "10-20" or "10"
+ */
+export function parseLineRange(rangeStr) {
+    if (!rangeStr) {
+        return null;
+    }
+    const parts = rangeStr.split('-');
+    if (parts.length === 1) {
+        // Single line: "10"
+        const line = parseInt(parts[0], 10);
+        if (isNaN(line) || line <= 0) {
+            return null;
+        }
+        return { start: line, end: undefined };
+    }
+    else if (parts.length === 2) {
+        // Range: "10-20"
+        const start = parseInt(parts[0], 10);
+        const end = parseInt(parts[1], 10);
+        if (isNaN(start) || isNaN(end) || start <= 0 || end < start) {
+            return null;
+        }
+        return { start, end };
+    }
+    return null;
+}
+//# sourceMappingURL=file-mention-parser.js.map

package/dist/utils/file-mention-parser.js.map

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

package/dist/utils/file-mention-parser.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-mention-parser.spec.d.ts.map

package/dist/utils/file-mention-parser.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-mention-parser.spec.d.ts","sourceRoot":"","sources":["../../source/utils/file-mention-parser.spec.ts"],"names":[],"mappings":""}