skir-internal 0.0.1

package/dist/definition_finder.js.map

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

package/dist/definition_finder.test.d.ts

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

package/dist/definition_finder.test.d.ts.map

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

package/dist/definition_finder.test.js

@@ -0,0 +1,164 @@
+import { expect } from "buckwheat";
+import { describe, it } from "mocha";
+import { findDefinition, findTokensWithDefinition, } from "./definition_finder.js";
+import { ModuleSet } from "./module_set.js";
+class FakeFileReader {
+    constructor() {
+        this.pathToCode = new Map();
+    }
+    readTextFile(modulePath) {
+        return this.pathToCode.get(modulePath);
+    }
+}
+describe("definition finder", () => {
+    const fakeFileReader = new FakeFileReader();
+    fakeFileReader.pathToCode.set("path/to/root/path/to/module", `
+        import * as other_module from "./other/module";
+
+        struct Outer {
+          struct Foo {}
+        }
+
+        struct Bar {
+          foo: Outer.Foo;
+          foo2: .Outer.Foo;
+
+          struct Inner {}
+          inner: Inner;
+          zoo: other_module.Outer.Zoo;
+        }
+
+        method GetBar(Outer.Foo): Bar;
+        method GetBar2(Outer.Foo): Bar = 100;
+
+        const FOO: Outer.Foo = {};
+      `);
+    fakeFileReader.pathToCode.set("path/to/root/path/to/other/module", `
+        struct Outer {
+          struct Zoo {}
+        }
+      `);
+    const moduleSet = ModuleSet.create(fakeFileReader, "path/to/root");
+    const module = moduleSet.parseAndResolve("path/to/module").result;
+    if (module === null) {
+        return Error("Failed to parse module");
+    }
+    it("works with module paths", () => {
+        expect(findDefinition(module, 45)).toMatch({
+            modulePath: "path/to/other/module",
+            position: 0,
+        });
+    });
+    it("works with record type", () => {
+        expect(findDefinition(module, 154)).toMatch({
+            modulePath: "path/to/module",
+            position: 73,
+        });
+    });
+    it("works with nested record type", () => {
+        expect(findDefinition(module, 187)).toMatch({
+            modulePath: "path/to/module",
+            position: 98,
+        });
+    });
+    it("works with module alias", () => {
+        expect(findDefinition(module, 262)).toMatch({
+            modulePath: "path/to/module",
+            position: 21,
+        });
+    });
+    it("works with request type", () => {
+        expect(findDefinition(module, 316)).toMatch({
+            modulePath: "path/to/module",
+            position: 73,
+        });
+    });
+    it("works with response type", () => {
+        expect(findDefinition(module, 367)).toMatch({
+            modulePath: "path/to/module",
+            position: 131,
+        });
+    });
+    it("works with constant type", () => {
+        expect(findDefinition(module, 404)).toMatch({
+            modulePath: "path/to/module",
+            position: 98,
+        });
+    });
+    it("findTokensWithDefinition works", () => {
+        expect(findTokensWithDefinition(module)).toMatch([
+            {
+                text: '"./other/module"',
+                position: 39,
+                line: {
+                    modulePath: "path/to/module",
+                },
+            },
+            {
+                text: "Outer",
+                position: 152,
+            },
+            {
+                text: "Foo",
+                position: 158,
+            },
+            {
+                text: "Outer",
+                position: 180,
+            },
+            {
+                text: "Foo",
+                position: 186,
+            },
+            {
+                text: "Inner",
+                position: 235,
+            },
+            {
+                text: "other_module",
+                position: 257,
+            },
+            {
+                text: "Outer",
+                position: 270,
+            },
+            {
+                text: "Zoo",
+                position: 276,
+            },
+            {
+                text: "Outer",
+                position: 314,
+            },
+            {
+                text: "Foo",
+                position: 320,
+            },
+            {
+                text: "Bar",
+                position: 326,
+            },
+            {
+                text: "Outer",
+                position: 354,
+            },
+            {
+                text: "Foo",
+                position: 360,
+            },
+            {
+                text: "Bar",
+                position: 366,
+            },
+            {
+                text: "Outer",
+                position: 397,
+            },
+            {
+                text: "Foo",
+                position: 403,
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=definition_finder.test.js.map

package/dist/definition_finder.test.js.map

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

package/dist/doc_comment_parser.d.ts

@@ -0,0 +1,3 @@
+import { Doc, Result, Token } from "./types.js";
+export declare function parseDocComments(docComments: readonly Token[]): Result<Doc>;
+//# sourceMappingURL=doc_comment_parser.d.ts.map

package/dist/doc_comment_parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc_comment_parser.d.ts","sourceRoot":"","sources":["../src/doc_comment_parser.ts"],"names":[],"mappings":"AACA,OAAO,EACL,GAAG,EAGH,MAAM,EAEN,KAAK,EACN,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAG3E"}

package/dist/doc_comment_parser.js

@@ -0,0 +1,219 @@
+import { assert } from "node:console";
+export function parseDocComments(docComments) {
+    const parser = new DocCommentsParser(docComments);
+    return parser.parse();
+}
+class DocCommentsParser {
+    constructor(docComments) {
+        this.docComments = docComments;
+        this.pieces = [];
+        this.errors = [];
+        this.currentText = "";
+        this.docCommentIndex = -1;
+        this.charIndex = -1;
+        this.contentOffset = -1;
+    }
+    parse() {
+        while (this.nextDocComment()) {
+            this.parseCurrentDocComment();
+        }
+        // Add any remaining text
+        if (this.currentText.length > 0) {
+            this.pieces.push({ kind: "text", text: this.currentText });
+        }
+        return {
+            result: {
+                pieces: this.pieces,
+            },
+            errors: this.errors,
+        };
+    }
+    parseCurrentDocComment() {
+        // Matches unescaped [ or ], OR escaped [[ or ]]
+        const specialCharRegex = /\[\[|\]\]|\[|\]/g;
+        while (this.charIndex < this.content.length) {
+            // Find next special character or escaped bracket
+            specialCharRegex.lastIndex = this.charIndex;
+            const match = specialCharRegex.exec(this.content);
+            if (!match) {
+                // No more special characters, add rest as text
+                this.currentText += this.content.slice(this.charIndex);
+                break;
+            }
+            // Add text before the special character
+            if (match.index > this.charIndex) {
+                this.currentText += this.content.slice(this.charIndex, match.index);
+            }
+            const matched = match[0];
+            this.charIndex = match.index;
+            if (matched === "[[") {
+                // Escaped left bracket
+                this.currentText += "[";
+                this.charIndex += 2;
+            }
+            else if (matched === "]]") {
+                // Escaped right bracket
+                this.currentText += "]";
+                this.charIndex += 2;
+            }
+            else if (matched === "[") {
+                // Start of a reference - save current text if any
+                if (this.currentText.length > 0) {
+                    this.pieces.push({ kind: "text", text: this.currentText });
+                    this.currentText = "";
+                }
+                // Parse the reference
+                const reference = this.parseReference();
+                this.pieces.push(reference);
+            }
+            else if (matched === "]") {
+                // Unmatched right bracket - treat as text
+                this.currentText += matched;
+                this.charIndex++;
+            }
+        }
+        // Add newline between comment lines (except after the last line)
+        if (this.docCommentIndex < this.docComments.length - 1) {
+            this.currentText += "\n";
+        }
+    }
+    parseReference() {
+        const { content, docComment } = this;
+        const leftBracketCharIndex = this.charIndex;
+        const startPosition = docComment.position + leftBracketCharIndex;
+        const rightBracketCharIndex = content.indexOf("]", leftBracketCharIndex);
+        // End position: right after the closing bracket or at end of the line if
+        // not found.
+        const endCharIndex = rightBracketCharIndex < 0 ? content.length : rightBracketCharIndex + 1;
+        const referenceText = content.slice(leftBracketCharIndex, endCharIndex);
+        const referenceRange = {
+            text: referenceText,
+            originalText: referenceText,
+            position: startPosition,
+            line: docComment.line,
+            colNumber: startPosition - docComment.line.position,
+        };
+        let hasError = false;
+        if (rightBracketCharIndex < 0) {
+            hasError = true;
+            this.errors.push({
+                token: referenceRange,
+                message: "Unterminated reference",
+            });
+        }
+        // Move past the left bracket
+        this.charIndex++;
+        const wordRegex = /[a-zA-Z][_a-zA-Z0-9]*/g;
+        const tokens = [];
+        while (this.charIndex < endCharIndex) {
+            const char = content[this.charIndex];
+            const position = docComment.position + this.charIndex;
+            const makeToken = (text) => ({
+                text: text,
+                originalText: text,
+                position: position,
+                line: docComment.line,
+                colNumber: position - docComment.line.position,
+            });
+            if (char === ".") {
+                // Dot token
+                tokens.push(makeToken("."));
+                this.charIndex++;
+            }
+            else if (/^[a-zA-Z]/.test(char)) {
+                // Start of a word token - use regex to match the whole word
+                wordRegex.lastIndex = this.charIndex;
+                const match = wordRegex.exec(content);
+                const word = match[0];
+                tokens.push(makeToken(word));
+                this.charIndex += word.length;
+            }
+            else if (char === "]") {
+                // Reached the end of the reference
+                tokens.push(makeToken("]"));
+                this.charIndex++;
+            }
+            else {
+                // Invalid character in reference (including whitespace)
+                const column = this.docComment.colNumber + this.charIndex;
+                hasError = true;
+                this.errors.push({
+                    token: referenceRange,
+                    message: `Invalid character in reference at column ${column + 1}`,
+                });
+                // Exit loop
+                this.charIndex = endCharIndex;
+            }
+        }
+        const nameChain = hasError ? [] : this.parseNameChain(tokens);
+        return {
+            kind: "reference",
+            nameChain: nameChain,
+            absolute: tokens[0]?.text === ".",
+            referee: undefined,
+            docComment: this.docComment,
+            referenceRange: referenceRange,
+        };
+    }
+    parseNameChain(tokens) {
+        const nameChain = [];
+        let expect = "identifier or '.'";
+        for (const token of tokens) {
+            let expected;
+            if (/^[a-zA-Z]/.test(token.text)) {
+                expected = expect === "identifier or '.'" || expect === "identifier";
+                expect = "'.' or ']'";
+                nameChain.push(token);
+            }
+            else if (token.text === ".") {
+                expected = expect === "identifier or '.'" || expect === "'.' or ']'";
+                expect = "identifier";
+            }
+            else {
+                assert(token.text === "]");
+                expected = expect === "'.' or ']'";
+            }
+            if (!expected) {
+                this.errors.push({
+                    token: token,
+                    expected: expect,
+                });
+                return [];
+            }
+            if (token.text === "]") {
+                return nameChain;
+            }
+        }
+        // An error has already been pushed to signify the unterminated reference.
+        return [];
+    }
+    /// The current doc comment being parsed.
+    get docComment() {
+        return this.docComments[this.docCommentIndex];
+    }
+    /// The text of the current doc comment being parsed.
+    get content() {
+        return this.docComment.text;
+    }
+    nextDocComment() {
+        if (this.docCommentIndex < this.docComments.length - 1) {
+            this.docCommentIndex++;
+            const { content } = this;
+            if (content.startsWith("/// ")) {
+                this.contentOffset = 4;
+            }
+            else if (content.startsWith("///")) {
+                this.contentOffset = 3;
+            }
+            else {
+                throw new Error("Expected doc comment to start with ///");
+            }
+            this.charIndex = this.contentOffset;
+            return true;
+        }
+        else {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=doc_comment_parser.js.map

package/dist/doc_comment_parser.js.map

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

package/dist/doc_comment_parser.test.d.ts

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

package/dist/doc_comment_parser.test.d.ts.map

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