@bscotch/gml-parser 1.14.2

package/dist/jsdoc.js

@@ -0,0 +1,468 @@
+import { keysOf } from '@bscotch/utility';
+import { flattenFeatherTypes } from './jsdoc.feather.js';
+import { assert } from './util.js';
+const patterns = {
+    param: `@(param(eter)?|arg(ument)?)\\b`,
+    description: `@desc(ription)?\\b`,
+    function: `@func(tion)?\\b`,
+    returns: `@returns?\\b`,
+    pure: `@pure\\b`,
+    mixin: `@mixin\\b`,
+    ignore: `@ignore\\b`,
+    deprecated: `@deprecated\\b`,
+    self: `@(context|self)\\b`,
+    type: `@type\\b`,
+    localvar: `@(localvar|var)\\b`,
+    globalvar: `@globalvar\\b`,
+    instancevar: `@(instancevar|prop(erty)?)\\b`,
+    template: `@template\\b`,
+    unknown: `@\\w+\\b`,
+};
+const typeGroupPattern = `(?<typeGroup>{\\s*(?<typeUnion>[^}]*?)?\\s*})`;
+const linePrefixPattern = `^(\\s*(?<delim>///|\\*)\\s*)?`;
+const descriptionPattern = `(?:\\s*-\\s*)?(?<info>.*)`;
+const paramNamePattern = `(?<name>[a-zA-Z_][a-zA-Z_0-9]*)`;
+const paramDefaultPattern = `(?:\\s*=\\s*(?<default>[^\\]]+?)\\s*)`;
+const dotdotdot = `\\.\\.\\.`;
+const optionalParamNamePattern = `\\[\\s*(?<optionalName>(?:[a-zA-Z_][a-zA-Z_0-9]*|${dotdotdot}))\\s*${paramDefaultPattern}?\\]`;
+const names = keysOf(patterns);
+for (const tagName of names) {
+    // Add the line prefix and a tag capture group
+    patterns[tagName] = `${linePrefixPattern}(?<tag>(?<${tagName}>${patterns[tagName]}))`;
+}
+// Types with required typeGroups
+const typeTags = ['returns', 'type'];
+for (const tagName of typeTags) {
+    patterns[tagName] = `${patterns[tagName]}\\s*${typeGroupPattern}`;
+}
+// Params
+patterns.param = `${patterns.param}(\\s+${typeGroupPattern})?\\s+(${paramNamePattern}|${optionalParamNamePattern})`;
+// Variable declaration patterns
+for (const tagName of [
+    'localvar',
+    'globalvar',
+    'instancevar',
+    'template',
+]) {
+    patterns[tagName] = `${patterns[tagName]}(\\s+${typeGroupPattern})?\\s+${paramNamePattern}`;
+}
+// Self (has a type but no group. Make brackets optional to be more forgiving)
+patterns.self = `${patterns.self}\\s+(?<extraBracket>\\{\\s*)?(?<type>[a-zA-Z_][a-zA-Z_0-9.]*)(?:\\s*\\})?`;
+// Descriptions
+for (const tagName of names) {
+    patterns[tagName] = `${patterns[tagName]}(\\s+${descriptionPattern})?`;
+}
+const descriptionLine = `${linePrefixPattern}\\s*${descriptionPattern}`;
+const regexes = names.reduce((acc, tagName) => {
+    // The 'd' flag is only supported in Node 18+, which VSCode doesn't support yet.
+    acc[tagName] = new RegExp(patterns[tagName]);
+    return acc;
+}, {});
+/**
+ * Given an IToken containing an entire JSDoc block,
+ * convert it to a list of lines, each with its own position.
+ */
+function jsdocBlockToLines(raw) {
+    raw = { ...raw }; // Clone so we don't mutate the original
+    const startPosition = {
+        line: raw.startLine,
+        column: raw.startColumn,
+        offset: raw.startOffset,
+    };
+    // If this starts with a /**, remove that.
+    raw.image = raw.image.replace(/^\/\*\*/, '   ');
+    // If this ends with a */, remove that.
+    raw.image = raw.image.replace(/\*\/$/, '  ');
+    const rawLines = raw.image.split(/(\r?\n)/);
+    const jsdocLines = [];
+    let jsdocLine = {
+        content: '',
+        start: startPosition,
+    };
+    for (let l = 0; l < rawLines.length; l++) {
+        const line = rawLines[l];
+        if (!line)
+            continue;
+        if (line.match(/\r?\n/)) {
+            // Then we need to add more space to the current jsdocline
+            // start position
+            jsdocLine.start.line++;
+            jsdocLine.start.column = 1;
+            jsdocLine.start.offset += line.length;
+            continue;
+        }
+        jsdocLine.content += line;
+        jsdocLines.push(jsdocLine);
+        // Create the next jsdoc line
+        jsdocLine = {
+            content: '',
+            start: {
+                line: jsdocLine.start.line,
+                column: jsdocLine.start.column + line.length,
+                offset: jsdocLine.start.offset + line.length,
+            },
+        };
+    }
+    return jsdocLines;
+}
+/**
+ * Given an array of ITokens, each containing a single line
+ * from a block of ///-style JSDoc comments, convert it to
+ * a common format.
+ */
+function jsdocGmlToLines(raw) {
+    // We already have lines as required, so just convert formats
+    return raw.map((token) => ({
+        content: token.image,
+        start: {
+            line: token.startLine,
+            column: token.startColumn,
+            offset: token.startOffset,
+        },
+    }));
+}
+/**
+ * Given a raw string containing a JSDoc block in either GML
+ * or JS style, convert it
+ * to a list of lines, each with its own position.
+ */
+function jsdocStringToLines(raw, startPosition) {
+    const asIToken = {
+        image: raw,
+        startLine: startPosition?.line || 1,
+        startColumn: startPosition?.column || 1,
+        startOffset: startPosition?.offset || 0,
+    };
+    return jsdocBlockToLines(asIToken);
+}
+/**
+ * Since single-line style comments make it impossible to
+ * tell when we're in a NEW doc, we need to break lines into
+ * groups
+ */
+export function gmlLinesByGroup(gmlLines) {
+    const lines = jsdocGmlToLines(gmlLines);
+    const groups = [[]];
+    let currentGroup = groups[0];
+    lines: for (const line of lines) {
+        if (!line) {
+            continue;
+        }
+        let match = null;
+        for (const tagName of names) {
+            match = line.content.match(regexes[tagName]);
+            if (!match) {
+                continue;
+            }
+            const parts = match.groups;
+            // Consider simpler groups and let the rest fall together
+            if (parts.localvar || parts.globalvar || parts.instancevar) {
+                // Then this is a new block!
+                currentGroup = [];
+                groups.push(currentGroup);
+            }
+            currentGroup.push(line);
+            continue lines; // Matches are exclusive, so go to the next line
+        }
+        // If we make it here then we didn't fine a match. Just add it to the currentgruop
+        currentGroup.push(line);
+    }
+    return groups.filter((g) => g.length);
+}
+export function parseJsdoc(raw, 
+/**
+ * The position of the first character of the jsdoc string,
+ * if it has been parsed out of a larger document. This is
+ * used to offset the positions of discovered tag components.
+ */
+startPosition) {
+    let lines;
+    if (typeof raw === 'string') {
+        lines = jsdocStringToLines(raw, startPosition);
+    }
+    else if (Array.isArray(raw)) {
+        if (raw[0] && 'image' in raw[0]) {
+            // Then this is a list of ITokens
+            lines = jsdocGmlToLines(raw);
+        }
+        else {
+            // Then this is a list of JsdocLines
+            lines = raw;
+        }
+    }
+    else {
+        // Then this is a single IToken
+        lines = jsdocBlockToLines(raw);
+    }
+    assert(lines, 'Lines must be an array');
+    if (!lines.length)
+        return undefined;
+    assert(lines[0], 'No lines found in jsdoc block');
+    const start = lines[0].start;
+    const end = { ...lines.at(-1).start };
+    end.column += lines.at(-1).content.length;
+    end.offset += lines.at(-1).content.length;
+    // Default to a description-only doc, and update its type
+    // if we can infer it based on the tags.
+    const doc = {
+        kind: 'description',
+        description: '',
+        start,
+        end,
+        tags: [],
+        diagnostics: [],
+        typeRanges: [],
+    };
+    const addTypeRanges = (component) => {
+        if (!component)
+            return;
+        const types = flattenFeatherTypes(component.content);
+        for (const type of types) {
+            // Convert the offset to a range and add it to typeRanges
+            const start = {
+                line: component.start.line,
+                column: component.start.column + type.name.offset,
+                offset: component.start.offset + type.name.offset,
+            };
+            const end = { ...start };
+            end.column += type.name.content.length - 1;
+            end.offset += type.name.content.length - 1;
+            doc.typeRanges.push({
+                content: type.name.content,
+                start,
+                end,
+            });
+        }
+    };
+    let describing = doc;
+    const appendDescription = (currentDescription, newDescription) => {
+        newDescription ||= '';
+        if (currentDescription) {
+            return `${currentDescription}\n${newDescription}`;
+        }
+        return newDescription;
+    };
+    for (const line of lines) {
+        assert(line, 'Line does not exist');
+        // Check for a match against each of the tag patterns
+        // until we fined one. If we don't then `match` will
+        // stay null, and we can use the line as a description.
+        let match = null;
+        for (const tagName of names) {
+            match = line.content.match(regexes[tagName]);
+            const parts = match?.groups;
+            // TODO: In Node <18, this will be undefined. Once VSCode
+            // updates to use Node 18+ we can remove the `undefined` union.
+            // const indices = match?.indices?.groups as MatchIndices | undefined;
+            if (!match) {
+                // Then we haven't found a tag yet
+                continue;
+            }
+            // Add the tag to the list of tags
+            const tagMatch = line.content.match(/@\w+\b/);
+            assert(tagMatch, 'Tag match should exist');
+            assert(tagMatch[0], 'Tag match must be an array');
+            const tagIndices = [
+                tagMatch.index,
+                tagMatch.index + tagMatch[0].length,
+            ];
+            doc.tags.push({
+                content: parts.tag,
+                ...matchIndexToRange(line.start, tagIndices),
+            });
+            // Based on the tag type, update the doc
+            const impliesFunction = parts.function ||
+                parts.param ||
+                parts.returns ||
+                parts.pure ||
+                parts.template;
+            if (impliesFunction) {
+                doc.kind = 'function';
+            }
+            const matchIndices = [
+                match.index,
+                match.index + match[0].length,
+            ];
+            const entireMatchRange = matchIndexToRange(line.start, matchIndices);
+            // If this uses an @description tag, then apply that description
+            // to the root doc.
+            if (parts.description) {
+                doc.description = appendDescription(doc.description, parts.info);
+            }
+            // If it's an unfamiliar tag, just skip it
+            else if (parts.unknown) {
+                // Unset the describe target
+                describing = null;
+            }
+            // Handle params, templates, and variables
+            else if (parts.param ||
+                parts.template ||
+                parts.localvar ||
+                parts.globalvar ||
+                parts.instancevar) {
+                // Until VSCode ships Node 18, and therefore has group
+                // indices, we'll have to get positions with a simple search
+                // per group.
+                const kind = parts.param
+                    ? 'param'
+                    : parts.template
+                        ? 'template'
+                        : parts.localvar
+                            ? 'localvar'
+                            : parts.globalvar
+                                ? 'globalvar'
+                                : 'instancevar';
+                const typeString = substringRange(line.content, parts.typeUnion, line.start);
+                addTypeRanges(typeString);
+                const entity = {
+                    kind,
+                    name: substringRange(line.content, parts.name || parts.optionalName, line.start),
+                    optional: !!parts.optionalName,
+                    type: typeString,
+                    description: parts.info || '',
+                    ...entireMatchRange,
+                };
+                if (kind === 'param') {
+                    doc.params = doc.params || [];
+                    doc.params.push(entity);
+                }
+                else if (kind === 'template') {
+                    doc.templates = doc.templates || [];
+                    doc.templates.push(entity);
+                }
+                else {
+                    doc.kind = kind;
+                    doc.type = entity.type;
+                    doc.name = entity.name;
+                    doc.description = entity.description;
+                }
+                // Update the current describing object in case the next line is a description
+                describing = entity;
+            }
+            // Handle returns
+            else if (parts.returns) {
+                if (doc.returns) {
+                    // Then we don't want to overwrite.
+                    break;
+                }
+                const typeString = substringRange(line.content, parts.typeUnion, line.start);
+                addTypeRanges(typeString);
+                const returns = {
+                    kind: 'returns',
+                    type: typeString,
+                    description: parts.info || '',
+                    ...entireMatchRange,
+                };
+                doc.returns = returns;
+                // Update the current describing object in case the next line is a description
+                describing = returns;
+            }
+            // Handle Self
+            else if (parts.self) {
+                doc.self = substringRange(line.content, parts.type, line.start);
+                addTypeRanges(doc.self);
+                if (parts.extraBracket) {
+                    doc.diagnostics.push({
+                        message: '@self types should not be wrapped in brackets',
+                        start: doc.self.start,
+                        end: doc.self.end,
+                    });
+                }
+            }
+            // Handle Type
+            else if (parts.type) {
+                doc.kind = 'type';
+                doc.type = substringRange(line.content, parts.typeUnion, line.start);
+                addTypeRanges(doc.type);
+                doc.description = appendDescription(doc.description, parts.info);
+            }
+            // Handle modifiers
+            else if (parts.deprecated) {
+                doc.deprecated = true;
+            }
+            else if (parts.ignore) {
+                doc.ignore = true;
+            }
+            else if (parts.mixin) {
+                doc.mixin = true;
+            }
+            break;
+        }
+        // If we haven't found a tag, then this is a description line
+        // Then this is a description-only line (or something invalid).
+        // Apply it to the current describing object.
+        if (!match && describing) {
+            const descriptionMatch = line.content.match(descriptionLine);
+            if (descriptionMatch) {
+                describing.description = appendDescription(describing.description, descriptionMatch.groups?.info);
+            }
+        }
+    }
+    if (doc.kind === 'description' && doc.self) {
+        // Then we don't know for sure what this context is for,
+        // but it's useful to call it a self doc.
+        doc.kind = 'self';
+    }
+    // Ensure that there are no redundantly-named params, since that
+    // is both not allowed and likely to cause weird problems later.
+    // The safest thing to do if we see a duplicate is to skip it and all
+    // subsequent params.
+    const paramNames = new Set();
+    for (let i = 0; i < (doc.params?.length || 0); i++) {
+        const param = doc.params[i];
+        if (paramNames.has(param.name.content)) {
+            doc.diagnostics.push({
+                message: `Duplicate param name: ${param.name.content}`,
+                start: param.name.start,
+                end: param.name.end,
+            });
+            // Add diagnostics for all subsequent params
+            for (let j = i + 1; j < doc.params.length; j++) {
+                const laterParam = doc.params[j];
+                doc.diagnostics.push({
+                    message: `Skipping due to previous duplicate param`,
+                    start: laterParam.name.start,
+                    end: laterParam.name.end,
+                });
+            }
+            doc.params.splice(i);
+            break;
+        }
+        paramNames.add(param.name.content);
+    }
+    return doc;
+}
+function substringRange(string, substring, start) {
+    if (!substring) {
+        return undefined;
+    }
+    start = { ...start };
+    const index = string.indexOf(substring);
+    if (index < 0) {
+        return undefined;
+    }
+    start.column += index;
+    start.offset += index;
+    return {
+        start,
+        end: {
+            column: start.column + substring.length - 1,
+            line: start.line,
+            offset: start.offset + substring.length - 1,
+        },
+        content: substring,
+    };
+}
+function matchIndexToRange(startPosition, index) {
+    // Note that the IRange uses column and line indexes that start at 1, while the offset starts at 0.
+    const range = {
+        start: { ...startPosition },
+        end: { ...startPosition },
+    };
+    range.start.column += index?.[0] || 0;
+    range.start.offset += index?.[0] || 0;
+    range.end.column += index?.[1] || 0;
+    range.end.offset += index?.[1] || 0;
+    return range;
+}
+//# sourceMappingURL=jsdoc.js.map

package/dist/jsdoc.js.map

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

package/dist/jsdoc.test.d.ts

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

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

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