@reqlan/language 1.4.0

package/out/reqlan-file-link-resolver.js

@@ -0,0 +1,347 @@
+import { AstUtils, CstUtils, GrammarUtils } from 'langium';
+import { resolveFileUri } from './reqlan-comment-resolver.js';
+import { findEmbeddedFileReferencesInText } from './reqlan-embedded-file-references.js';
+import { findImportedDocument, resolveExistingImportUri } from './reqlan-imports.js';
+import { qualifiedReferenceImportPath } from './reqlan-references.js';
+import { findTestLineInText, parseFileReferenceString } from './reqlan-file-references.js';
+import { isFileReference, isFileSymbolReference, isImport, isLocalReference, isMarkdownLink, isQualifiedReference } from './generated/ast.js';
+import { parseMarkdownLink } from './reqlan-references.js';
+import { reqlanStringDelimiter } from './reqlan-quoted-strings.js';
+import { isNamespaceImportOnlyReference, resolveNamespaceImportReferenceLink } from './reqlan-namespace-import-links.js';
+function withFileSystem(fileSystem, context) {
+    return { ...context, fileSystem: context?.fileSystem ?? fileSystem };
+}
+export function classifyReferenceUri(targetUri, documents, fileSystem) {
+    if (findTargetDocument(targetUri, documents)) {
+        return 'file';
+    }
+    if (!fileSystem.existsSync(targetUri)) {
+        return 'missing';
+    }
+    return fileSystem.statSync(targetUri).isDirectory ? 'folder' : 'file';
+}
+export function listFolderFileNames(fileSystem, folderUri) {
+    return fileSystem.readDirectorySync(folderUri)
+        .filter(entry => entry.isFile)
+        .map(entry => {
+        const segments = entry.uri.path.split('/');
+        return segments[segments.length - 1] ?? '';
+    })
+        .filter(name => name.length > 0)
+        .sort((left, right) => left.localeCompare(right));
+}
+export function resolveFileReferenceLink(reference, documents, fileSystem, context) {
+    const document = AstUtils.getDocument(reference);
+    const parsed = parseFileReferenceString(reference.file);
+    const pathNode = GrammarUtils.findNodeForProperty(reference.$cstNode, 'file');
+    if (!pathNode) {
+        return undefined;
+    }
+    return resolveParsedFileLink(document, documents, fileSystem, parsed, pathNode, context);
+}
+export function resolveImportPathLink(importDecl, documents, context) {
+    const document = AstUtils.getDocument(importDecl);
+    const pathNode = GrammarUtils.findNodeForProperty(importDecl.$cstNode, 'path');
+    if (!pathNode) {
+        return undefined;
+    }
+    const imported = findImportedDocument(importDecl.path, document, documents, context);
+    const target = imported?.parseResult.value.$cstNode;
+    if (!imported || !target) {
+        return undefined;
+    }
+    return {
+        sourceRange: pathNode.range,
+        targetUri: imported.textDocument.uri,
+        targetRange: target.range
+    };
+}
+export function resolveQualifiedReferencePathLink(reference, documents, context) {
+    const pathNode = reference.path?.$refNode;
+    if (!pathNode) {
+        return undefined;
+    }
+    const document = AstUtils.getDocument(reference);
+    const path = qualifiedReferenceImportPath(reference);
+    if (!path) {
+        return undefined;
+    }
+    const imported = findImportedDocument(path, document, documents, context);
+    const target = imported?.parseResult.value.$cstNode;
+    if (!imported || !target) {
+        return undefined;
+    }
+    return {
+        sourceRange: pathNode.range,
+        targetUri: imported.textDocument.uri,
+        targetRange: target.range
+    };
+}
+export function resolveMarkdownLinkTargetLink(link, document, documents, fileSystem, context) {
+    const parsedLink = parseMarkdownLink(link.raw);
+    if (!parsedLink) {
+        return undefined;
+    }
+    const pathNode = GrammarUtils.findNodeForProperty(link.$cstNode, 'raw');
+    if (!pathNode) {
+        return undefined;
+    }
+    const targetStart = link.raw.indexOf('](') + 2;
+    const targetLength = parsedLink.target.length;
+    const sourceRange = {
+        start: {
+            line: pathNode.range.start.line,
+            character: pathNode.range.start.character + targetStart
+        },
+        end: {
+            line: pathNode.range.start.line,
+            character: pathNode.range.start.character + targetStart + targetLength
+        }
+    };
+    const parsed = parseFileReferenceString(parsedLink.target);
+    const targetUri = resolveFileUri(parsed.filePath, document, withFileSystem(fileSystem, context));
+    return resolvePathStringLink(document, documents, fileSystem, parsed, targetUri, sourceRange);
+}
+export function resolveEmbeddedFileReferenceLink(reference, document, documents, fileSystem, context) {
+    const parsed = parseFileReferenceString(reference.file);
+    const targetUri = resolveFileUri(parsed.filePath, document, withFileSystem(fileSystem, context));
+    return resolvePathStringLink(document, documents, fileSystem, parsed, targetUri, reference.range);
+}
+export function resolveParsedFileLink(document, documents, fileSystem, parsed, pathNode, context) {
+    const targetUri = resolveFileUri(parsed.filePath, document, withFileSystem(fileSystem, context));
+    const sourceRange = parsed.testName
+        ? stringContentRange(pathNode)
+        : filePathRangeInStringNode(pathNode, parsed);
+    return resolvePathStringLink(document, documents, fileSystem, parsed, targetUri, sourceRange);
+}
+function resolvePathStringLink(_document, documents, fileSystem, parsed, targetUri, sourceRange) {
+    const resolution = classifyReferenceUri(targetUri, documents, fileSystem);
+    if (resolution === 'missing') {
+        return undefined;
+    }
+    if (resolution === 'folder') {
+        return {
+            sourceRange,
+            targetUri: targetUri.toString(),
+            resolution,
+            folderFiles: listFolderFileNames(fileSystem, targetUri)
+        };
+    }
+    const text = readTargetText(targetUri, documents, fileSystem);
+    if (text === undefined) {
+        return undefined;
+    }
+    const targetIssue = detectFileLinkTargetIssue(text, findTargetDocument(targetUri, documents));
+    let targetRange;
+    if (parsed.testName) {
+        const line = findTestLineInText(text, parsed.testName);
+        if (line !== undefined) {
+            targetRange = lineRangeFromText(text, line);
+        }
+    }
+    else if (parsed.lineStart !== undefined) {
+        targetRange = lineRangeFromText(text, parsed.lineStart - 1);
+    }
+    else {
+        targetRange = fileStartRange();
+    }
+    return {
+        sourceRange,
+        targetUri: targetUri.toString(),
+        targetRange,
+        resolution: 'file',
+        targetIssue
+    };
+}
+export function detectFileLinkTargetIssue(text, targetDocument) {
+    if (text.length === 0) {
+        return 'empty';
+    }
+    if (targetDocument && targetDocument.parseResult.parserErrors.length > 0) {
+        return 'parse-error';
+    }
+    return undefined;
+}
+export function fileLinkTargetIssueMessage(issue) {
+    switch (issue) {
+        case 'empty':
+            return 'Referenced file is empty.';
+        case 'parse-error':
+            return 'Referenced file has parse errors.';
+    }
+}
+function findTargetDocument(targetUri, documents) {
+    const direct = documents.getDocument(targetUri);
+    if (direct) {
+        return direct;
+    }
+    const normalizedTarget = normalizeUriPath(targetUri);
+    for (const document of documents.all) {
+        if (normalizeUriPath(document.uri) === normalizedTarget) {
+            return document;
+        }
+    }
+    return undefined;
+}
+function normalizeUriPath(uri) {
+    return decodeURIComponent(uri.path).replace(/\\/g, '/');
+}
+function readTargetText(targetUri, documents, fileSystem) {
+    const targetDocument = findTargetDocument(targetUri, documents);
+    if (targetDocument) {
+        return targetDocument.textDocument.getText();
+    }
+    if (!fileSystem.existsSync(targetUri)) {
+        return undefined;
+    }
+    if (fileSystem.statSync(targetUri).isDirectory) {
+        return undefined;
+    }
+    return fileSystem.readFileSync(targetUri);
+}
+export function bindingNameSourceRange(bindingNode, bindingName) {
+    const line = bindingNode.range.start.line;
+    const startCharacter = bindingNode.range.start.character;
+    return {
+        start: { line, character: startCharacter },
+        end: { line, character: startCharacter + bindingName.length }
+    };
+}
+export function resolveImportedFileLink(document, documents, fileSystem, filePath, sourceRange, context) {
+    const targetUri = resolveExistingImportUri(filePath, document, documents, fileSystem, context);
+    return resolvePathStringLink(document, documents, fileSystem, { filePath }, targetUri, sourceRange);
+}
+export function filePathRangeInStringNode(pathNode, parsed) {
+    const text = pathNode.text;
+    const contentStart = pathNode.range.start.character + (reqlanStringDelimiter(text) ? 1 : 0);
+    return {
+        start: { line: pathNode.range.start.line, character: contentStart },
+        end: { line: pathNode.range.start.line, character: contentStart + parsed.filePath.length }
+    };
+}
+function stringContentRange(pathNode) {
+    const text = pathNode.text;
+    const quoteOffset = reqlanStringDelimiter(text) ? 1 : 0;
+    const trailingQuote = quoteOffset;
+    return {
+        start: { line: pathNode.range.start.line, character: pathNode.range.start.character + quoteOffset },
+        end: { line: pathNode.range.end.line, character: pathNode.range.end.character - trailingQuote }
+    };
+}
+function lineRangeFromText(text, line) {
+    const lineText = text.split(/\r?\n/)[line] ?? '';
+    return {
+        start: { line, character: 0 },
+        end: { line, character: lineText.length }
+    };
+}
+function fileStartRange() {
+    return {
+        start: { line: 0, character: 0 },
+        end: { line: 0, character: 0 }
+    };
+}
+export function collectFileLinks(document, documents, fileSystem, context) {
+    const pathContext = withFileSystem(fileSystem, context);
+    const links = [];
+    const linkedRanges = [];
+    for (const node of AstUtils.streamAst(document.parseResult.value)) {
+        if (isFileReference(node) || isFileSymbolReference(node)) {
+            const link = resolveFileReferenceLink(node, documents, fileSystem, pathContext);
+            if (link) {
+                links.push(link);
+                linkedRanges.push(rangeKey(link.sourceRange));
+            }
+        }
+        if ((isLocalReference(node) || isQualifiedReference(node)) && isNamespaceImportOnlyReference(node)) {
+            const link = resolveNamespaceImportReferenceLink(node, documents, fileSystem, pathContext);
+            if (link) {
+                links.push(link);
+                linkedRanges.push(rangeKey(link.sourceRange));
+            }
+        }
+        if (isImport(node)) {
+            const link = resolveImportPathLink(node, documents, pathContext);
+            if (link) {
+                links.push(link);
+                linkedRanges.push(rangeKey(link.sourceRange));
+            }
+        }
+        if (isQualifiedReference(node) && node.path && !node.path.ref) {
+            const link = resolveQualifiedReferencePathLink(node, documents, pathContext);
+            if (link) {
+                links.push(link);
+                linkedRanges.push(rangeKey(link.sourceRange));
+            }
+        }
+        if (isMarkdownLink(node)) {
+            const link = resolveMarkdownLinkTargetLink(node, document, documents, fileSystem, pathContext);
+            if (link) {
+                links.push(link);
+                linkedRanges.push(rangeKey(link.sourceRange));
+            }
+        }
+    }
+    for (const reference of findEmbeddedFileReferencesInText(document.textDocument.getText())) {
+        const key = rangeKey(reference.range);
+        if (linkedRanges.includes(key) || links.some(link => rangesOverlap(link.sourceRange, reference.range))) {
+            continue;
+        }
+        const link = resolveEmbeddedFileReferenceLink(reference, document, documents, fileSystem, pathContext);
+        if (link) {
+            links.push(link);
+            linkedRanges.push(key);
+        }
+    }
+    return links;
+}
+function rangeKey(range) {
+    return `${range.start.line}:${range.start.character}-${range.end.line}:${range.end.character}`;
+}
+function rangesOverlap(left, right) {
+    if (left.start.line !== right.start.line || right.start.line !== right.end.line || left.start.line !== left.end.line) {
+        return left.start.line === right.start.line;
+    }
+    return left.start.character <= right.end.character && right.start.character <= left.end.character;
+}
+export function resolvedFileLinkTargetUri(link) {
+    if (link.resolution === 'folder' || link.resolution === 'missing') {
+        return undefined;
+    }
+    if (link.targetRange) {
+        return `${link.targetUri}#L${link.targetRange.start.line + 1}`;
+    }
+    return link.targetUri;
+}
+export function resolvedFileLinkToGoToTarget(link, sourceNode, targetDocument) {
+    const root = targetDocument.parseResult.value.$cstNode;
+    if (!root) {
+        return undefined;
+    }
+    const target = link.targetRange
+        ? {
+            range: link.targetRange,
+            astNode: root.astNode
+        }
+        : root;
+    return {
+        source: CstUtils.getDatatypeNode(sourceNode) ?? sourceNode,
+        target,
+        targetDocument
+    };
+}
+export function resolvedFileLinkToGoToTargetFromFilesystem(link, sourceNode) {
+    if (!link.targetRange) {
+        return undefined;
+    }
+    const target = { range: link.targetRange };
+    const targetDocument = {
+        textDocument: { uri: link.targetUri }
+    };
+    return {
+        source: CstUtils.getDatatypeNode(sourceNode) ?? sourceNode,
+        target,
+        targetDocument
+    };
+}
+//# sourceMappingURL=reqlan-file-link-resolver.js.map

package/out/reqlan-file-link-resolver.js.map

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

package/out/reqlan-file-references.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parses file path strings from bracket references, including L# line suffixes and :test name suffixes.
+ */
+export interface ParsedFileReference {
+    filePath: string;
+    lineStart?: number;
+    lineEnd?: number;
+    testName?: string;
+}
+export declare function parseFileReferenceString(file: string): ParsedFileReference;
+/**
+ * True when a bracketed quoted path is an arbitrary file reference, not an inline .rq import path.
+ */
+export declare function isOpaqueFileReferencePath(path: string): boolean;
+export declare function findTestLineInText(text: string, testName: string): number | undefined;

package/out/reqlan-file-references.js

@@ -0,0 +1,72 @@
+/**
+ * Parses file path strings from bracket references, including L# line suffixes and :test name suffixes.
+ */
+const LINE_SUFFIX_PATTERN = /^(.*?)L#(\d+)(?:-(\d+))?$/;
+export function parseFileReferenceString(file) {
+    const lineMatch = LINE_SUFFIX_PATTERN.exec(file);
+    const lineParsed = lineMatch
+        ? {
+            filePath: lineMatch[1],
+            lineStart: Number.parseInt(lineMatch[2], 10),
+            lineEnd: lineMatch[3] ? Number.parseInt(lineMatch[3], 10) : Number.parseInt(lineMatch[2], 10)
+        }
+        : { filePath: file };
+    const testParsed = parseTestNameSuffix(lineParsed.filePath);
+    return {
+        filePath: testParsed.filePath,
+        lineStart: lineParsed.lineStart,
+        lineEnd: lineParsed.lineEnd,
+        testName: testParsed.testName
+    };
+}
+function parseTestNameSuffix(file) {
+    let colonIndex = -1;
+    for (let index = file.length - 1; index >= 0; index--) {
+        if (file[index] !== ':') {
+            continue;
+        }
+        if (index > 0 && file[index - 1] === '/' && index > 1 && file[index - 2] === '/') {
+            continue;
+        }
+        colonIndex = index;
+        break;
+    }
+    if (colonIndex < 0) {
+        return { filePath: file };
+    }
+    const testName = file.slice(colonIndex + 1);
+    if (!testName) {
+        return { filePath: file };
+    }
+    return {
+        filePath: file.slice(0, colonIndex),
+        testName
+    };
+}
+const NON_RQ_FILE_EXTENSION = /\.[^./\\]+$/;
+/**
+ * True when a bracketed quoted path is an arbitrary file reference, not an inline .rq import path.
+ */
+export function isOpaqueFileReferencePath(path) {
+    const parsed = parseFileReferenceString(path);
+    if (parsed.testName !== undefined || parsed.lineStart !== undefined) {
+        return true;
+    }
+    const filePath = parsed.filePath;
+    if (/\.rq$/i.test(filePath)) {
+        return false;
+    }
+    return NON_RQ_FILE_EXTENSION.test(filePath);
+}
+export function findTestLineInText(text, testName) {
+    const escaped = testName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`\\b(?:test|it)\\(\\s*['\`]${escaped}['\`]`);
+    const lines = text.split(/\r?\n/);
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        if (pattern.test(lines[lineIndex])) {
+            return lineIndex;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=reqlan-file-references.js.map

package/out/reqlan-file-references.js.map

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

package/out/reqlan-grammar-config.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Grammar configuration for rename and comment handling in requirement documents.
+ */
+import type { GrammarConfig, LangiumCoreServices } from 'langium';
+export declare function createReqlanGrammarConfig(services: LangiumCoreServices): GrammarConfig;

package/out/reqlan-grammar-config.js

@@ -0,0 +1,9 @@
+import { createGrammarConfig } from 'langium';
+const ReqlanNameRegexp = /"[^"]*"|'[^']*'|\w[\w_]*/;
+export function createReqlanGrammarConfig(services) {
+    return {
+        ...createGrammarConfig(services),
+        nameRegexp: ReqlanNameRegexp
+    };
+}
+//# sourceMappingURL=reqlan-grammar-config.js.map

package/out/reqlan-grammar-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqlan-grammar-config.js","sourceRoot":"","sources":["../src/reqlan-grammar-config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAEpD,MAAM,UAAU,yBAAyB,CAAC,QAA6B;IACnE,OAAO;QACH,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAChC,UAAU,EAAE,gBAAgB;KAC/B,CAAC;AACN,CAAC"}

package/out/reqlan-idea-reference-site.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Locate a bracket/wiki idea reference under the cursor for search code actions.
+ * rq:["../../../reqlan rq/extension/features-commands.rq".search_code_actions]
+ */
+import type { LangiumDocument } from 'langium';
+import type { Position, Range } from 'vscode-languageserver';
+export interface IdeaReferenceSite {
+    /** Current idea name text inside the reference (may be empty or partial). */
+    refText: string;
+    /** Range of text to replace with the chosen idea name (inside brackets). */
+    range: Range;
+    kind: 'bracket' | 'wikilink';
+}
+export declare function findIdeaReferenceAtPosition(document: LangiumDocument, position: Position): IdeaReferenceSite | undefined;

package/out/reqlan-idea-reference-site.js

@@ -0,0 +1,47 @@
+import { CstUtils } from 'langium';
+import { isBracketReference, isLocalReference, isQualifiedReference, isWikiLink } from './generated/ast.js';
+import { referenceIdea } from './reqlan-references.js';
+export function findIdeaReferenceAtPosition(document, position) {
+    const root = document.parseResult.value.$cstNode;
+    if (!root) {
+        return undefined;
+    }
+    const offset = document.textDocument.offsetAt(position);
+    let current = CstUtils.findLeafNodeAtOffset(root, offset);
+    while (current) {
+        const node = current.astNode;
+        if (isBracketReference(node) || isWikiLink(node)) {
+            return siteFromReferenceContainer(node);
+        }
+        current = current.container;
+    }
+    return undefined;
+}
+function siteFromReferenceContainer(node) {
+    const kind = isWikiLink(node) ? 'wikilink' : 'bracket';
+    const target = node.target;
+    if (!target) {
+        return undefined;
+    }
+    if (isLocalReference(target) || isQualifiedReference(target)) {
+        const idea = referenceIdea(target);
+        const ideaNode = idea?.$refNode;
+        if (ideaNode) {
+            return {
+                refText: idea.$refText,
+                range: ideaNode.range,
+                kind
+            };
+        }
+    }
+    const targetNode = target.$cstNode;
+    if (!targetNode) {
+        return undefined;
+    }
+    return {
+        refText: targetNode.text,
+        range: targetNode.range,
+        kind
+    };
+}
+//# sourceMappingURL=reqlan-idea-reference-site.js.map

package/out/reqlan-idea-reference-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqlan-idea-reference-site.js","sourceRoot":"","sources":["../src/reqlan-idea-reference-site.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EACH,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAUvD,MAAM,UAAU,2BAA2B,CACvC,QAAyB,EACzB,QAAkB;IAElB,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,OAAO,GAAwB,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/E,OAAO,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAC7B,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,0BAA0B,CAAC,IAAiC;IACjE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACX,OAAO;gBACH,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,IAAI;aACP,CAAC;QACN,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC;IACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO;QACH,OAAO,EAAE,UAAU,CAAC,IAAI;QACxB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,IAAI;KACP,CAAC;AACN,CAAC"}

package/out/reqlan-idea-summary.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compact idea body summaries for inline editor hints and indexing.
+ */
+import { type IdeaDeclaration } from './generated/ast.js';
+export declare function summarizeIdeaDeclaration(idea: IdeaDeclaration): string;
+export declare function truncateSummary(text: string, maxLength?: number): string;