feat(types): add JSDoc source links to generated type definitions

Add @see JSDoc comments to generated .d.ts files that link to the exact
line in the original Rust/Zig source file where each function is defined.
This improves IDE navigation by allowing developers to jump directly to
the source implementation from TypeScript definitions.

- Capture line numbers during Tree-sitter parsing
- Generate JSDoc @see tags with file:// URLs pointing to source:line
- Update FunctionType interface to include optional line number
- Works with both Rust and Zig loaders

Author: AugusDogus

src/loader.ts

@@ -61,11 +61,18 @@ export default class {
         if (types && Object.keys(types).length > 0) {
             for (const [symbol, type] of Object.entries(types)) {
                 const args = type.args.join(", ");
+                if (type.line) {
+                    // Convert Windows backslashes to forward slashes for proper file:// URL
+                    const filePath = this.config.importPath.replace(/\\/g, '/');
+                    configWriter.write(`\n\t\t/** Source: file:///${filePath}:${type.line} */`);
+                }
                 configWriter.write(`\n\t\t${symbol}: {\n\t\t\targs: [${args}],\n\t\t\treturns: ${type.returns}\n\t\t},`);
             }
         }
         configWriter.write(`\n\t}\n} satisfies LoaderConfig.Main;`);
         await configWriter.end();
+        
+        // Generate types.d.ts - simplified since JSDoc is in config.ts
         await Bun.write(
             `${this.cwd}/@types/${filename}/types.d.ts`,
             `declare module "*/${filename}" {\n\tconst symbols: import("bun:ffi").ConvertFns<typeof import("./config.ts").default.symbols>;\n\texport = symbols;\n}`

src/loaders/rs/parse-types.ts

@@ -55,6 +55,7 @@ async function getParser(): Promise<Parser> {
 export interface FunctionType {
     args: string[];
     returns: string;
+    line?: number;
 }
 
 // Parse Rust source code to extract FFI function signatures
@@ -156,7 +157,11 @@ export async function parseRustTypes(
             }
         }
 
-        types[fnName] = { args, returns: returnType };
+        types[fnName] = { 
+            args, 
+            returns: returnType,
+            line: fnNameNode.startPosition.row + 1
+        };
     }
 
     return types;

src/loaders/zig/parse-types.ts

@@ -57,6 +57,7 @@ async function getParser(): Promise<Parser> {
 export interface FunctionType {
     args: string[];
     returns: string;
+    line?: number;
 }
 
 // Parse Zig source code to extract FFI function signatures
@@ -161,9 +162,12 @@ export async function parseZigTypes(
             }
         }
 
-        types[fnName] = { args, returns: returnType };
+        types[fnName] = { 
+            args, 
+            returns: returnType,
+            line: fnNameNode.startPosition.row + 1
+        };
     }
 
     return types;
 }
-

src/types.ts

@@ -21,7 +21,7 @@ export namespace LoaderConfig {
         extension: string,
         buildCommand?: (importPath: string, outDir: string) => string[],
         outDir?: (importPath: string) => string,
-        parseTypes?: (importPath: string) => Promise<Record<string, { args: string[], returns: string }> | undefined>,
+        parseTypes?: (importPath: string) => Promise<Record<string, { args: string[], returns: string, line?: number }> | undefined>,
     }
 
     export interface Internal {