@reqlan/language 1.4.0

package/out/src/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/src/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/src/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/src/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/src/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/src/reqlan-idea-summary.d.ts

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

package/out/src/reqlan-idea-summary.js

@@ -0,0 +1,78 @@
+/**
+ * Compact idea body summaries for inline editor hints.
+ */
+import { isBodyLine, isBracketReference, isIdea, isMarkdownLink, isOneLinerIdea, isRichTextPart, isWikiLink } from './generated/ast.js';
+import { parseMarkdownLink } from './reqlan-references.js';
+function summarizeOneLinerPart(part) {
+    if (typeof part === 'string') {
+        return part;
+    }
+    if (isMarkdownLink(part)) {
+        return parseMarkdownLink(part.raw)?.label ?? part.raw;
+    }
+    if (isWikiLink(part) || isBracketReference(part)) {
+        return '[ref]';
+    }
+    return '';
+}
+function summarizeRichTextPart(part) {
+    if (typeof part === 'string') {
+        return part;
+    }
+    if (isRichTextPart(part) && part.$type === 'RichTextPart') {
+        return part.text ?? part.inlineCode ?? part.punct ?? part.lparen ?? part.rparen ?? '';
+    }
+    if (isMarkdownLink(part)) {
+        return parseMarkdownLink(part.raw)?.label ?? part.raw;
+    }
+    if (isWikiLink(part) || isBracketReference(part)) {
+        return '[ref]';
+    }
+    return '';
+}
+function summarizeOneLinerBody(idea) {
+    return idea.body.content
+        .map(summarizeOneLinerPart)
+        .join(' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function summarizeBlockIdeaBody(idea) {
+    if (!isIdea(idea)) {
+        return '';
+    }
+    const lines = [];
+    for (const element of idea.elements) {
+        if (!isBodyLine(element)) {
+            continue;
+        }
+        const line = element.parts
+            .map(summarizeRichTextPart)
+            .filter(part => part.length > 0)
+            .join(' ')
+            .replace(/\s+([.,!?;:])/g, '$1')
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (line) {
+            lines.push(line);
+        }
+    }
+    return lines.join('\n');
+}
+export function summarizeIdeaDeclaration(idea) {
+    if (isOneLinerIdea(idea)) {
+        return summarizeOneLinerBody(idea);
+    }
+    if (isIdea(idea)) {
+        return summarizeBlockIdeaBody(idea);
+    }
+    return '';
+}
+export function truncateSummary(text, maxLength = 80) {
+    const normalized = text.replace(/\s+/g, ' ').trim();
+    if (normalized.length <= maxLength) {
+        return normalized;
+    }
+    return `${normalized.slice(0, maxLength - 1).trimEnd()}…`;
+}
+//# sourceMappingURL=reqlan-idea-summary.js.map

package/out/src/reqlan-idea-summary.js.map

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

package/out/src/reqlan-ignore-error.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Suppresses diagnostics on lines immediately following `//rq-ignore-error`.
+ * rq:["../../../reqlan rq/language/syntax.rq".comment_reference_ignore]
+ */
+import { type LangiumDocument, type LangiumSharedCoreServices } from 'langium';
+import type { Diagnostic } from 'vscode-languageserver';
+export declare function findRqIgnoreErrorTargetLines(text: string): Set<number>;
+export declare function filterRqIgnoredDiagnostics(text: string, diagnostics: Diagnostic[]): Diagnostic[];
+export declare function applyRqIgnoreErrorFiltering(document: LangiumDocument): void;
+export declare function registerRqIgnoreErrorFiltering(shared: LangiumSharedCoreServices): void;

package/out/src/reqlan-ignore-error.js

@@ -0,0 +1,42 @@
+/**
+ * Suppresses diagnostics on lines immediately following `//rq-ignore-error`.
+ * rq:["../../../reqlan rq/language/syntax.rq".comment_reference_ignore]
+ */
+import { DocumentState } from 'langium';
+import { findLineCommentStart } from './reqlan-comment-resolver.js';
+const RQ_IGNORE_ERROR = /\/\/\s*rq-ignore-error\b/;
+export function findRqIgnoreErrorTargetLines(text) {
+    const lines = text.split(/\r?\n/);
+    const targetLines = new Set();
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        const commentStart = findLineCommentStart(line);
+        if (commentStart < 0) {
+            continue;
+        }
+        const commentText = line.slice(commentStart);
+        if (RQ_IGNORE_ERROR.test(commentText) && lineIndex + 1 < lines.length) {
+            targetLines.add(lineIndex + 1);
+        }
+    }
+    return targetLines;
+}
+export function filterRqIgnoredDiagnostics(text, diagnostics) {
+    const ignoredLines = findRqIgnoreErrorTargetLines(text);
+    if (ignoredLines.size === 0) {
+        return diagnostics;
+    }
+    return diagnostics.filter(diagnostic => !ignoredLines.has(diagnostic.range.start.line));
+}
+export function applyRqIgnoreErrorFiltering(document) {
+    if (!document.diagnostics?.length) {
+        return;
+    }
+    document.diagnostics = filterRqIgnoredDiagnostics(document.textDocument.getText(), document.diagnostics);
+}
+export function registerRqIgnoreErrorFiltering(shared) {
+    shared.workspace.DocumentBuilder.onDocumentPhase(DocumentState.Validated, (document) => {
+        applyRqIgnoreErrorFiltering(document);
+    });
+}
+//# sourceMappingURL=reqlan-ignore-error.js.map

package/out/src/reqlan-ignore-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqlan-ignore-error.js","sourceRoot":"","sources":["../../src/reqlan-ignore-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAwD,MAAM,SAAS,CAAC;AAE9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACnB,SAAS;QACb,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACpE,WAAW,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,WAAyB;IAC9E,MAAM,YAAY,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC;IACvB,CAAC;IACD,OAAO,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAyB;IACjE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAChC,OAAO;IACX,CAAC;IACD,QAAQ,CAAC,WAAW,GAAG,0BAA0B,CAC7C,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,EAC/B,QAAQ,CAAC,WAAW,CACvB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAiC;IAC5E,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,eAAe,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,QAAyB,EAAE,EAAE;QACpG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/out/src/reqlan-import-bindings.d.ts

@@ -0,0 +1,12 @@
+import type { AstNode } from 'langium';
+import { type FromImportSpecifier, type Import } from './generated/ast.js';
+export interface ImportBinding {
+    name: string;
+    node: AstNode;
+    property: 'alias' | 'idea';
+}
+export declare function specifierBindingName(specifier: FromImportSpecifier): string | undefined;
+export declare function importBindings(importDecl: Import): ImportBinding[];
+export declare function importedIdeaNames(importDecl: Import): string[];
+export declare function findNamespaceImportByAlias(imports: Import[], alias: string): Import | undefined;
+export declare function findFromImportSpecifierByBinding(imports: Import[], bindingName: string): FromImportSpecifier | undefined;

package/out/src/reqlan-import-bindings.js

@@ -0,0 +1,65 @@
+import { isFromImport, isNamespaceImport, isQualifiedImport } from './generated/ast.js';
+export function specifierBindingName(specifier) {
+    return specifier.alias ?? specifier.idea.$refText;
+}
+export function importBindings(importDecl) {
+    if (isFromImport(importDecl)) {
+        return importDecl.specifiers.flatMap(specifier => {
+            const name = specifierBindingName(specifier);
+            if (!name) {
+                return [];
+            }
+            return [{
+                    name,
+                    node: specifier,
+                    property: specifier.alias ? 'alias' : 'idea'
+                }];
+        });
+    }
+    if (isQualifiedImport(importDecl)) {
+        const name = importDecl.alias ?? importDecl.idea.$refText;
+        if (!name) {
+            return [];
+        }
+        return [{
+                name,
+                node: importDecl,
+                property: importDecl.alias ? 'alias' : 'idea'
+            }];
+    }
+    if (importDecl.alias) {
+        return [{ name: importDecl.alias, node: importDecl, property: 'alias' }];
+    }
+    return [];
+}
+export function importedIdeaNames(importDecl) {
+    if (isFromImport(importDecl)) {
+        return importDecl.specifiers.map(specifier => specifier.idea.$refText);
+    }
+    if (isQualifiedImport(importDecl)) {
+        return [importDecl.idea.$refText];
+    }
+    return [];
+}
+export function findNamespaceImportByAlias(imports, alias) {
+    for (const importDecl of imports) {
+        if (!isNamespaceImport(importDecl) || importDecl.alias !== alias) {
+            continue;
+        }
+        return importDecl;
+    }
+    return undefined;
+}
+export function findFromImportSpecifierByBinding(imports, bindingName) {
+    for (const importDecl of imports) {
+        if (!isFromImport(importDecl)) {
+            continue;
+        }
+        const specifier = importDecl.specifiers.find(entry => specifierBindingName(entry) === bindingName);
+        if (specifier) {
+            return specifier;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=reqlan-import-bindings.js.map

package/out/src/reqlan-import-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqlan-import-bindings.js","sourceRoot":"","sources":["../../src/reqlan-import-bindings.ts"],"names":[],"mappings":"AACA,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EAGpB,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,UAAU,oBAAoB,CAAC,SAA8B;IAC/D,OAAO,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC7C,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;YAC7C,MAAM,IAAI,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,OAAO,EAAE,CAAC;YACd,CAAC;YACD,OAAO,CAAC;oBACJ,IAAI;oBACJ,IAAI,EAAE,SAAS;oBACf,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,OAAgB,CAAC,CAAC,CAAC,MAAe;iBACjE,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IACD,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,CAAC;gBACJ,IAAI;gBACJ,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;aAChD,CAAC,CAAC;IACP,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAChD,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAiB,EAAE,KAAa;IACvE,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC/D,SAAS;QACb,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC5C,OAAiB,EACjB,WAAmB;IAEnB,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,SAAS;QACb,CAAC;QACD,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CACxC,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,WAAW,CACvD,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/out/src/reqlan-import-edits.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared WorkspaceEdit helpers for import insertion used by unresolved-reference quick fixes.
+ * rq:["../../../reqlan rq/extension/language-support/features-imports.rq".import_error]
+ */
+import type { LangiumDocument, URI } from 'langium';
+import type { Position, TextEdit } from 'vscode-languageserver';
+import { type FromImport, type Model } from './generated/ast.js';
+export declare function relativeRqImportPath(fromUri: URI, toUri: URI): string;
+export declare function findImportInsertPosition(model: Model): {
+    position: Position;
+    trailingNewline: boolean;
+};
+export declare function findExistingFromImport(model: Model, importPath: string): FromImport | undefined;
+export declare function hasNamespaceImport(model: Model, importPath: string): boolean;
+export declare function buildFromImportEdit(document: LangiumDocument, importPath: string, symbolName: string): TextEdit | undefined;
+export declare function buildNamespaceImportEdit(document: LangiumDocument, importPath: string, alias: string): TextEdit | undefined;
+export declare function fileBasenameAlias(fileUri: string | URI): string;

package/out/src/reqlan-import-edits.js

@@ -0,0 +1,96 @@
+import { UriUtils } from 'langium';
+import { isFromImport, isModel, isNamespaceImport } from './generated/ast.js';
+import { unquoteReqlanString } from './reqlan-references.js';
+export function relativeRqImportPath(fromUri, toUri) {
+    const sourceDir = UriUtils.dirname(fromUri);
+    let relativePath = UriUtils.relative(sourceDir, toUri);
+    if (!relativePath.startsWith('./') && !relativePath.startsWith('../')) {
+        relativePath = `./${relativePath}`;
+    }
+    return relativePath;
+}
+export function findImportInsertPosition(model) {
+    if (model.imports.length > 0) {
+        const last = model.imports[model.imports.length - 1];
+        const end = last.$cstNode?.range.end;
+        if (end) {
+            return {
+                position: { line: end.line + 1, character: 0 },
+                trailingNewline: false
+            };
+        }
+    }
+    const firstElement = model.elements[0];
+    if (firstElement?.$cstNode) {
+        return {
+            position: firstElement.$cstNode.range.start,
+            trailingNewline: true
+        };
+    }
+    return { position: { line: 0, character: 0 }, trailingNewline: true };
+}
+export function findExistingFromImport(model, importPath) {
+    return model.imports.find((decl) => {
+        if (!isFromImport(decl)) {
+            return false;
+        }
+        return unquoteReqlanString(decl.path) === importPath;
+    });
+}
+export function hasNamespaceImport(model, importPath) {
+    return model.imports.some(decl => isNamespaceImport(decl) && unquoteReqlanString(decl.path) === importPath);
+}
+export function buildFromImportEdit(document, importPath, symbolName) {
+    const model = document.parseResult.value;
+    if (!isModel(model)) {
+        return undefined;
+    }
+    const existing = findExistingFromImport(model, importPath);
+    if (existing) {
+        const alreadyImported = existing.specifiers.some(specifier => {
+            const binding = specifier.alias ?? specifier.idea.$refText;
+            return binding === symbolName || specifier.idea.$refText === symbolName;
+        });
+        if (alreadyImported) {
+            return undefined;
+        }
+        const lastSpecifier = existing.specifiers[existing.specifiers.length - 1];
+        const insertAt = lastSpecifier?.$cstNode?.range.end ?? existing.$cstNode?.range.end;
+        if (!insertAt) {
+            return undefined;
+        }
+        return {
+            range: { start: insertAt, end: insertAt },
+            newText: `, ${symbolName}`
+        };
+    }
+    const insert = findImportInsertPosition(model);
+    const line = `from "${importPath}" import ${symbolName}`;
+    return {
+        range: { start: insert.position, end: insert.position },
+        newText: insert.trailingNewline ? `${line}\n\n` : `${line}\n`
+    };
+}
+export function buildNamespaceImportEdit(document, importPath, alias) {
+    const model = document.parseResult.value;
+    if (!isModel(model)) {
+        return undefined;
+    }
+    if (hasNamespaceImport(model, importPath)) {
+        return undefined;
+    }
+    const insert = findImportInsertPosition(model);
+    const line = `import "${importPath}" as ${alias}`;
+    return {
+        range: { start: insert.position, end: insert.position },
+        newText: insert.trailingNewline ? `${line}\n\n` : `${line}\n`
+    };
+}
+export function fileBasenameAlias(fileUri) {
+    const uriString = typeof fileUri === 'string' ? fileUri : fileUri.toString();
+    const base = uriString.split('/').pop() ?? uriString;
+    const withoutExt = base.replace(/\.rq$/i, '');
+    const cleaned = withoutExt.replace(/[^A-Za-z0-9_]+/g, '_').replace(/^(\d)/, '_$1');
+    return cleaned || 'imported';
+}
+//# sourceMappingURL=reqlan-import-edits.js.map

package/out/src/reqlan-import-edits.js.map

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

package/out/src/reqlan-imports.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Resolves imported requirement documents from relative and import-root-aliased paths.
+ * Interacts with scope linking and go-to-definition for import paths.
+ * rq:["../../../reqlan rq/extension/language-support/features-imports.rq".implicit_file_extension]
+ */
+import type { FileSystemProvider, LangiumDocument, LangiumDocuments, URI } from 'langium';
+import { type PathResolveContext } from './reqlan-path-resolve.js';
+export type { PathResolveContext };
+export declare const IMPLICIT_IMPORT_EXTENSION = ".rq";
+/**
+ * Import paths written without an extension mean `.rq`; the literal path stays a fallback so
+ * extensionless files on disk keep resolving.
+ */
+export declare function importPathCandidates(path: string): string[];
+export declare function importPathWithImplicitExtension(path: string): string | undefined;
+export declare function resolveImportUri(path: string, document: LangiumDocument, context?: PathResolveContext): URI;
+/** Candidate URIs in preference order: implicit `.rq` first, then the path as written. */
+export declare function resolveImportCandidateUris(path: string, document: LangiumDocument, context?: PathResolveContext): URI[];
+export declare function isResolvableImportPath(path: string, document: LangiumDocument, documents: LangiumDocuments, fileSystem?: FileSystemProvider, context?: PathResolveContext): boolean;
+export declare function findImportedDocument(path: string, document: LangiumDocument, documents: LangiumDocuments, context?: PathResolveContext): LangiumDocument | undefined;
+/** First candidate that exists, falling back to the path as written when none do. */
+export declare function resolveExistingImportUri(path: string, document: LangiumDocument, documents: LangiumDocuments, fileSystem?: FileSystemProvider, context?: PathResolveContext): URI;

package/out/src/reqlan-imports.js

@@ -0,0 +1,61 @@
+import { resolveDocumentPathUri } from './reqlan-path-resolve.js';
+export const IMPLICIT_IMPORT_EXTENSION = '.rq';
+/**
+ * Import paths written without an extension mean `.rq`; the literal path stays a fallback so
+ * extensionless files on disk keep resolving.
+ */
+export function importPathCandidates(path) {
+    const implicit = importPathWithImplicitExtension(path);
+    return implicit ? [implicit, path] : [path];
+}
+export function importPathWithImplicitExtension(path) {
+    const basename = path.slice(path.lastIndexOf('/') + 1);
+    if (basename.length === 0 || basename === '.' || basename === '..') {
+        return undefined;
+    }
+    if (basename.includes('.', 1)) {
+        return undefined;
+    }
+    return `${path}${IMPLICIT_IMPORT_EXTENSION}`;
+}
+export function resolveImportUri(path, document, context) {
+    return resolveDocumentPathUri(path, document, context);
+}
+/** Candidate URIs in preference order: implicit `.rq` first, then the path as written. */
+export function resolveImportCandidateUris(path, document, context) {
+    return importPathCandidates(path).map(candidate => resolveDocumentPathUri(candidate, document, context));
+}
+export function isResolvableImportPath(path, document, documents, fileSystem, context) {
+    return resolveImportCandidateUris(path, document, withFileSystem(context, fileSystem))
+        .some(uri => isImportTarget(uri, documents, fileSystem));
+}
+export function findImportedDocument(path, document, documents, context) {
+    for (const uri of resolveImportCandidateUris(path, document, context)) {
+        const imported = documents.getDocument(uri);
+        if (imported) {
+            return imported;
+        }
+    }
+    return undefined;
+}
+/** First candidate that exists, falling back to the path as written when none do. */
+export function resolveExistingImportUri(path, document, documents, fileSystem, context) {
+    const uris = resolveImportCandidateUris(path, document, withFileSystem(context, fileSystem));
+    return uris.find(uri => isImportTarget(uri, documents, fileSystem)) ?? uris[uris.length - 1];
+}
+function isImportTarget(uri, documents, fileSystem) {
+    if (documents.getDocument(uri)) {
+        return true;
+    }
+    if (!fileSystem?.existsSync(uri)) {
+        return false;
+    }
+    return !fileSystem.statSync(uri).isDirectory;
+}
+function withFileSystem(context, fileSystem) {
+    if (!fileSystem && !context) {
+        return undefined;
+    }
+    return { ...context, fileSystem: fileSystem ?? context?.fileSystem };
+}
+//# sourceMappingURL=reqlan-imports.js.map

package/out/src/reqlan-imports.js.map

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

package/out/src/reqlan-inbound-reference-inlay-label.d.ts

@@ -0,0 +1,23 @@
+import { Location, type InlayHintLabelPart as InlayHintLabelPartType, type MarkupContent } from 'vscode-languageserver';
+import { type IdeaDeclaration, type IdeaSet } from './generated/ast.js';
+import type { ReqlanServices } from './reqlan-module.js';
+export interface InboundReferenceInlayLabel {
+    labelParts: InlayHintLabelPartType[];
+    tooltip?: MarkupContent;
+}
+export interface InboundReferencer {
+    name: string;
+    location: Location;
+}
+export type ReferencedDeclaration = IdeaDeclaration | IdeaSet;
+export declare function collectInboundReferencers(services: ReqlanServices, declaration: ReferencedDeclaration): InboundReferencer[];
+/** @deprecated Use {@link collectInboundReferencers} */
+export declare function collectInboundReferencingNames(services: ReqlanServices, declaration: ReferencedDeclaration): string[];
+export declare function referencerMarkdownLink(referrer: InboundReferencer): string;
+export declare function buildReferencersTooltipMarkup(referencers: InboundReferencer[]): MarkupContent;
+export declare function buildInboundReferencesInlayLabel(referencers: InboundReferencer[], targetDocumentUri: string, targetName: string): InboundReferenceInlayLabel | undefined;
+/** @deprecated Use {@link buildInboundReferencesInlayLabel} */
+export declare function formatInboundReferencesInlayLabel(referencers: string[]): {
+    label: string;
+    tooltip?: string;
+} | undefined;