@reqlan/language 1.4.0

package/out/reqlan-reference-code-lens.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Classification labels and summary stats for reference CodeLens buttons.
+ * Click opens a reference card; navigation stays on document links / go-to-definition.
+ */
+import { type AstNode } from 'langium';
+import { type CodeLens } from 'vscode-languageserver';
+import { type ReferencedDeclaration } from './reqlan-inbound-reference-inlay-label.js';
+import { type ResolvedFileLink } from './reqlan-file-link-resolver.js';
+import type { ReqlanServices } from './reqlan-module.js';
+export type ReferenceCodeLensClassification = {
+    kind: 'idea';
+    declaration: ReferencedDeclaration;
+} | {
+    kind: 'reqlan-file';
+    link: ResolvedFileLink;
+} | {
+    kind: 'file';
+    link: ResolvedFileLink;
+    extension: string;
+} | {
+    kind: 'folder';
+    link: ResolvedFileLink;
+};
+export declare function classifyReferenceForCodeLens(services: ReqlanServices, node: AstNode): ReferenceCodeLensClassification | undefined;
+export declare function referenceCodeLensTitle(classification: ReferenceCodeLensClassification): string;
+export declare function buildReferenceCodeLens(services: ReqlanServices, node: AstNode, classification: ReferenceCodeLensClassification): CodeLens | undefined;
+export declare function buildReferenceCodeLensStats(services: ReqlanServices, classification: ReferenceCodeLensClassification): string[];
+/** @deprecated Prefer {@link buildReferenceCodeLensStats} — kept for existing tests. */
+export declare function buildReferenceCodeLensTooltip(services: ReqlanServices, classification: ReferenceCodeLensClassification): string | undefined;
+export declare function countOutboundReferences(declaration: ReferencedDeclaration): number;
+export declare function fileExtension(targetUri: string): string | undefined;
+export declare function fileLastEditedLabel(targetUri: string): string | undefined;

package/out/reqlan-reference-code-lens.js

@@ -0,0 +1,240 @@
+/**
+ * Classification labels and summary stats for reference CodeLens buttons.
+ * Click opens a reference card; navigation stays on document links / go-to-definition.
+ */
+import { AstUtils, GrammarUtils, URI } from 'langium';
+import { Command } from 'vscode-languageserver';
+import { statSync } from 'node:fs';
+import { isBracketReference, isFileReference, isFileSymbolReference, isIdea, isIdeaSet, isLocalReference, isOneLinerIdea, isQualifiedReference, isWikiLink } from './generated/ast.js';
+import { collectInboundReferencers } from './reqlan-inbound-reference-inlay-label.js';
+import { listFolderFileNames, resolveFileReferenceLink } from './reqlan-file-link-resolver.js';
+import { isNamespaceImportOnlyReference, resolveNamespaceImportReferenceLink } from './reqlan-namespace-import-links.js';
+import { pathResolveContextFromServices } from './reqlan-path-resolve.js';
+import { referenceIdea } from './reqlan-references.js';
+import { summarizeIdeaDeclaration, truncateSummary } from './reqlan-idea-summary.js';
+import { REQLAN_OPEN_REFERENCE_CODE_LENS_COMMAND } from './reqlan-code-lens-settings.js';
+export function classifyReferenceForCodeLens(services, node) {
+    if (!isBracketReference(node) && !isWikiLink(node)) {
+        return undefined;
+    }
+    const target = node.target;
+    if (isLocalReference(target) || isQualifiedReference(target)) {
+        if (isNamespaceImportOnlyReference(target)) {
+            const link = resolveNamespaceImportReferenceLink(target, services.shared.workspace.LangiumDocuments, services.shared.workspace.FileSystemProvider, pathResolveContextFromServices(services));
+            return classifyResolvedFileLink(link);
+        }
+        const ideaRef = referenceIdea(target);
+        if (ideaRef?.ref) {
+            return { kind: 'idea', declaration: ideaRef.ref };
+        }
+        if (isQualifiedReference(target) && target.ideaset?.ref) {
+            return { kind: 'idea', declaration: target.ideaset.ref };
+        }
+        return undefined;
+    }
+    if (isFileReference(target) || isFileSymbolReference(target)) {
+        const link = resolveFileReferenceLink(target, services.shared.workspace.LangiumDocuments, services.shared.workspace.FileSystemProvider, pathResolveContextFromServices(services));
+        if (isFileSymbolReference(target) && target.symbols.length > 0) {
+            const idea = resolveFileSymbolIdea(services, link, target.symbols[0]);
+            if (idea) {
+                return { kind: 'idea', declaration: idea };
+            }
+        }
+        return classifyResolvedFileLink(link);
+    }
+    return undefined;
+}
+function classifyResolvedFileLink(link) {
+    if (!link || link.resolution === 'missing') {
+        return undefined;
+    }
+    if (link.resolution === 'folder') {
+        return { kind: 'folder', link };
+    }
+    const extension = fileExtension(link.targetUri);
+    if (!extension || extension === 'rq') {
+        return { kind: 'reqlan-file', link };
+    }
+    return { kind: 'file', link, extension };
+}
+function resolveFileSymbolIdea(services, link, symbolName) {
+    if (!link || link.resolution !== 'file') {
+        return undefined;
+    }
+    const targetDocument = services.shared.workspace.LangiumDocuments.getDocument(URI.parse(link.targetUri));
+    if (!targetDocument) {
+        return undefined;
+    }
+    for (const candidate of AstUtils.streamAst(targetDocument.parseResult.value)) {
+        if ((isIdea(candidate) || isOneLinerIdea(candidate) || isIdeaSet(candidate)) && candidate.name === symbolName) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function referenceCodeLensTitle(classification) {
+    switch (classification.kind) {
+        case 'idea':
+            return 'open idea';
+        case 'reqlan-file':
+            return 'open reqlan file';
+        case 'file':
+            return `open ${classification.extension} file`;
+        case 'folder':
+            return 'open folder';
+    }
+}
+export function buildReferenceCodeLens(services, node, classification) {
+    const range = codeLensRange(node);
+    if (!range) {
+        return undefined;
+    }
+    const payload = payloadForClassification(services, classification);
+    if (!payload) {
+        return undefined;
+    }
+    const title = payload.classification;
+    const tooltip = payload.stats.length > 0
+        ? `${payload.displayName} · ${payload.stats.join(' · ')}`
+        : payload.displayName;
+    const command = Command.create(title, REQLAN_OPEN_REFERENCE_CODE_LENS_COMMAND, payload);
+    command.tooltip = tooltip;
+    return { range, command };
+}
+export function buildReferenceCodeLensStats(services, classification) {
+    const parts = [];
+    if (classification.kind === 'idea') {
+        const referencers = collectInboundReferencers(services, classification.declaration).length;
+        const references = countOutboundReferences(classification.declaration);
+        parts.push(`${referencers} referencer${referencers === 1 ? '' : 's'}`);
+        parts.push(`${references} reference${references === 1 ? '' : 's'}`);
+        const edited = fileLastEditedLabel(AstUtils.getDocument(classification.declaration).uri.toString());
+        if (edited) {
+            parts.push(`last edited ${edited}`);
+        }
+        return parts;
+    }
+    if (classification.kind === 'folder') {
+        const files = classification.link.folderFiles
+            ?? listFolderFileNames(services.shared.workspace.FileSystemProvider, URI.parse(classification.link.targetUri));
+        parts.push(`${files.length} file${files.length === 1 ? '' : 's'}`);
+        return parts;
+    }
+    const edited = fileLastEditedLabel(classification.link.targetUri);
+    if (edited) {
+        parts.push(`last edited ${edited}`);
+    }
+    if (classification.kind === 'reqlan-file') {
+        const targetDocument = services.shared.workspace.LangiumDocuments.getDocument(URI.parse(classification.link.targetUri));
+        if (targetDocument) {
+            let ideaCount = 0;
+            for (const candidate of AstUtils.streamAst(targetDocument.parseResult.value)) {
+                if (isIdea(candidate) || isOneLinerIdea(candidate) || isIdeaSet(candidate)) {
+                    ideaCount++;
+                }
+            }
+            parts.push(`${ideaCount} idea${ideaCount === 1 ? '' : 's'}`);
+        }
+    }
+    return parts;
+}
+/** @deprecated Prefer {@link buildReferenceCodeLensStats} — kept for existing tests. */
+export function buildReferenceCodeLensTooltip(services, classification) {
+    const parts = buildReferenceCodeLensStats(services, classification);
+    return parts.length > 0 ? parts.join(' · ') : undefined;
+}
+export function countOutboundReferences(declaration) {
+    let count = 0;
+    for (const node of AstUtils.streamAst(declaration)) {
+        if (isBracketReference(node) || isWikiLink(node)) {
+            count++;
+        }
+    }
+    return count;
+}
+export function fileExtension(targetUri) {
+    const path = URI.parse(targetUri).path;
+    const slash = Math.max(path.lastIndexOf('/'), path.lastIndexOf('\\'));
+    const base = slash >= 0 ? path.slice(slash + 1) : path;
+    const dot = base.lastIndexOf('.');
+    if (dot <= 0 || dot === base.length - 1) {
+        return undefined;
+    }
+    return base.slice(dot + 1).toLowerCase();
+}
+export function fileLastEditedLabel(targetUri) {
+    try {
+        const uri = URI.parse(targetUri);
+        if (uri.scheme !== 'file') {
+            return undefined;
+        }
+        const mtime = statSync(uri.fsPath).mtime;
+        return mtime.toISOString().slice(0, 10);
+    }
+    catch {
+        return undefined;
+    }
+}
+function displayNameForUri(targetUri) {
+    const path = URI.parse(targetUri).path;
+    const slash = Math.max(path.lastIndexOf('/'), path.lastIndexOf('\\'));
+    return slash >= 0 ? path.slice(slash + 1) : path;
+}
+function payloadForClassification(services, classification) {
+    const classificationLabel = referenceCodeLensTitle(classification);
+    const stats = buildReferenceCodeLensStats(services, classification);
+    if (classification.kind === 'idea') {
+        const declaration = classification.declaration;
+        const nameNode = GrammarUtils.findNodeForProperty(declaration.$cstNode, 'name');
+        const document = AstUtils.getDocument(declaration);
+        const summary = isIdea(declaration) || isOneLinerIdea(declaration)
+            ? truncateSummary(summarizeIdeaDeclaration(declaration), 240)
+            : undefined;
+        return {
+            kind: 'idea',
+            classification: classificationLabel,
+            displayName: declaration.name,
+            targetUri: document.uri.toString(),
+            line: nameNode?.range.start.line ?? 0,
+            character: nameNode?.range.start.character ?? 0,
+            summary: summary || undefined,
+            stats
+        };
+    }
+    const link = classification.link;
+    const displayName = displayNameForUri(link.targetUri);
+    if (classification.kind === 'folder') {
+        const folderFiles = link.folderFiles
+            ?? listFolderFileNames(services.shared.workspace.FileSystemProvider, URI.parse(link.targetUri));
+        return {
+            kind: 'folder',
+            classification: classificationLabel,
+            displayName,
+            targetUri: link.targetUri,
+            folderFiles,
+            summary: folderFiles.slice(0, 8).join(', ') + (folderFiles.length > 8 ? '…' : ''),
+            stats
+        };
+    }
+    return {
+        kind: classification.kind === 'reqlan-file' ? 'reqlan-file' : 'file',
+        classification: classificationLabel,
+        displayName,
+        targetUri: link.targetUri,
+        line: link.targetRange?.start.line ?? 0,
+        character: link.targetRange?.start.character ?? 0,
+        extension: classification.kind === 'file' ? classification.extension : undefined,
+        stats
+    };
+}
+function codeLensRange(node) {
+    const cst = node.$cstNode;
+    if (!cst) {
+        return undefined;
+    }
+    return {
+        start: { line: cst.range.start.line, character: 0 },
+        end: cst.range.end
+    };
+}
+//# sourceMappingURL=reqlan-reference-code-lens.js.map

package/out/reqlan-reference-code-lens.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * Locate places where a selection or word can become a [reference],
+ * and extract surrounding idea text for the search modal preview.
+ * rq:["../../../reqlan rq/extension/features-commands.rq".search_code_actions]
+ */
+import type { LangiumDocument } from 'langium';
+import type { Position, Range } from 'vscode-languageserver';
+import { type IdeaDeclaration } from './generated/ast.js';
+export type ReferenceSearchMode = 'replace' | 'wrap';
+export interface ReferenceSearchContext {
+    ideaName: string;
+    /** Text before the target within the idea source. */
+    before: string;
+    /** Selected / reference text that will become (or already is) the reference. */
+    target: string;
+    /** Text after the target within the idea source. */
+    after: string;
+}
+export interface ReferenceSearchSite {
+    refText: string;
+    range: Range;
+    mode: ReferenceSearchMode;
+    kind: 'bracket' | 'wikilink' | 'prose';
+    context?: ReferenceSearchContext;
+}
+/**
+ * Prefer an existing [reference]/[[wikilink]] under the cursor; otherwise a
+ * selection or word in idea-body prose that can be wrapped as `[name]`.
+ */
+export declare function findReferenceSearchSite(document: LangiumDocument, range: Range): ReferenceSearchSite | undefined;
+export declare function isAppropriateWrapLocation(document: LangiumDocument, position: Position): boolean;
+export declare function buildContextForRange(document: LangiumDocument, range: Range, idea?: IdeaDeclaration): ReferenceSearchContext | undefined;
+export declare function expandToWordAtPosition(document: LangiumDocument, position: Position): Range | undefined;
+export declare function isBlockOrOneLinerIdea(node: unknown): node is IdeaDeclaration;

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

@@ -0,0 +1,136 @@
+import { findContainingIdea, isInMainDescriptionProse } from './reqlan-completion-context.js';
+import { findIdeaReferenceAtPosition } from './reqlan-idea-reference-site.js';
+import { isIdea, isOneLinerIdea } from './generated/ast.js';
+/**
+ * Prefer an existing [reference]/[[wikilink]] under the cursor; otherwise a
+ * selection or word in idea-body prose that can be wrapped as `[name]`.
+ */
+export function findReferenceSearchSite(document, range) {
+    const existing = findIdeaReferenceAtPosition(document, range.start);
+    if (existing) {
+        return siteFromExistingReference(document, existing);
+    }
+    return findWrapSite(document, range);
+}
+function siteFromExistingReference(document, existing) {
+    return {
+        refText: existing.refText,
+        range: existing.range,
+        mode: 'replace',
+        kind: existing.kind,
+        context: buildContextForRange(document, existing.range)
+    };
+}
+function findWrapSite(document, range) {
+    const rawRange = isEmptyRange(range)
+        ? expandToWordAtPosition(document, range.start)
+        : normalizeForwardRange(range);
+    const wrapRange = rawRange ? trimRangeWhitespace(document, rawRange) : undefined;
+    if (!wrapRange || isEmptyRange(wrapRange)) {
+        return undefined;
+    }
+    // Both ends must sit in idea-body prose (not imports, attribute keys, refs, etc.)
+    const endProbe = document.textDocument.positionAt(Math.max(document.textDocument.offsetAt(wrapRange.start), document.textDocument.offsetAt(wrapRange.end) - 1));
+    if (!isAppropriateWrapLocation(document, wrapRange.start)
+        || !isAppropriateWrapLocation(document, endProbe)) {
+        return undefined;
+    }
+    // Keep wrap inside a single idea
+    const idea = findContainingIdea(document, wrapRange.start);
+    if (!idea || findContainingIdea(document, wrapRange.end) !== idea) {
+        return undefined;
+    }
+    const refText = document.textDocument.getText(wrapRange).trim();
+    if (!refText || /\n/.test(refText)) {
+        return undefined;
+    }
+    // Avoid wrapping text that is already bracket-wrapped
+    if (/^\[.*\]$/.test(refText) || /^\[\[.*\]\]$/.test(refText)) {
+        return undefined;
+    }
+    return {
+        refText,
+        range: wrapRange,
+        mode: 'wrap',
+        kind: 'prose',
+        context: buildContextForRange(document, wrapRange, idea)
+    };
+}
+export function isAppropriateWrapLocation(document, position) {
+    return isInMainDescriptionProse(document, position);
+}
+export function buildContextForRange(document, range, idea) {
+    const containing = idea ?? findContainingIdea(document, range.start);
+    if (!containing?.$cstNode) {
+        return undefined;
+    }
+    const ideaRange = containing.$cstNode.range;
+    const ideaText = document.textDocument.getText(ideaRange);
+    const ideaStart = document.textDocument.offsetAt(ideaRange.start);
+    const targetStart = document.textDocument.offsetAt(range.start) - ideaStart;
+    const targetEnd = document.textDocument.offsetAt(range.end) - ideaStart;
+    if (targetStart < 0 || targetEnd > ideaText.length || targetStart > targetEnd) {
+        return undefined;
+    }
+    return {
+        ideaName: containing.name,
+        before: ideaText.slice(0, targetStart),
+        target: ideaText.slice(targetStart, targetEnd),
+        after: ideaText.slice(targetEnd)
+    };
+}
+export function expandToWordAtPosition(document, position) {
+    const line = document.textDocument.getText({
+        start: { line: position.line, character: 0 },
+        end: { line: position.line + 1, character: 0 }
+    });
+    // Strip trailing newline for indexing
+    const lineText = line.replace(/\r?\n$/, '');
+    if (position.character > lineText.length) {
+        return undefined;
+    }
+    const isWord = (ch) => !!ch && /[A-Za-z0-9_]/.test(ch);
+    let start = position.character;
+    let end = position.character;
+    while (start > 0 && isWord(lineText[start - 1])) {
+        start -= 1;
+    }
+    while (end < lineText.length && isWord(lineText[end])) {
+        end += 1;
+    }
+    if (start === end) {
+        return undefined;
+    }
+    return {
+        start: { line: position.line, character: start },
+        end: { line: position.line, character: end }
+    };
+}
+function trimRangeWhitespace(document, range) {
+    const text = document.textDocument.getText(range);
+    const lead = /^\s*/.exec(text)?.[0].length ?? 0;
+    const trail = /\s*$/.exec(text)?.[0].length ?? 0;
+    if (lead + trail >= text.length) {
+        return undefined;
+    }
+    const startOffset = document.textDocument.offsetAt(range.start) + lead;
+    const endOffset = document.textDocument.offsetAt(range.end) - trail;
+    return {
+        start: document.textDocument.positionAt(startOffset),
+        end: document.textDocument.positionAt(endOffset)
+    };
+}
+function isEmptyRange(range) {
+    return range.start.line === range.end.line && range.start.character === range.end.character;
+}
+function normalizeForwardRange(range) {
+    if (range.start.line > range.end.line
+        || (range.start.line === range.end.line && range.start.character > range.end.character)) {
+        return { start: range.end, end: range.start };
+    }
+    return range;
+}
+export function isBlockOrOneLinerIdea(node) {
+    return isIdea(node) || isOneLinerIdea(node);
+}
+//# sourceMappingURL=reqlan-reference-search-site.js.map

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

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

package/out/reqlan-references.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared helpers for the reference target union types.
+ */
+import type { Reference } from 'langium';
+import { type IdeaDeclaration, type Import, type QualifiedReference, type ReferenceTarget } from './generated/ast.js';
+export declare function referenceImport(target: ReferenceTarget): Reference<Import> | undefined;
+export declare function referenceIdea(target: ReferenceTarget): Reference<IdeaDeclaration> | undefined;
+export declare function referenceFilePath(target: ReferenceTarget): string | undefined;
+export declare function qualifiedReferenceImportPath(reference: QualifiedReference): string | undefined;
+export declare function isAnonymousQualifiedReference(reference: QualifiedReference): boolean;
+export { unquoteReqlanString } from './reqlan-quoted-strings.js';
+export interface ParsedMarkdownLink {
+    label: string;
+    target: string;
+}
+export declare function parseMarkdownLink(raw: string): ParsedMarkdownLink | undefined;

package/out/reqlan-references.js

@@ -0,0 +1,51 @@
+import { isFileReference, isFileSymbolReference, isLocalReference, isQualifiedReference } from './generated/ast.js';
+import { unquoteReqlanString } from './reqlan-quoted-strings.js';
+export function referenceImport(target) {
+    if (isQualifiedReference(target)) {
+        return target.path?.ref || target.qualifier?.ref ? (target.path ?? target.qualifier) : undefined;
+    }
+    return undefined;
+}
+export function referenceIdea(target) {
+    if (isQualifiedReference(target) || isLocalReference(target)) {
+        return target.idea;
+    }
+    return undefined;
+}
+export function referenceFilePath(target) {
+    if (isFileReference(target) || isFileSymbolReference(target)) {
+        return target.file;
+    }
+    if (isQualifiedReference(target)) {
+        return qualifiedReferenceImportPath(target);
+    }
+    return undefined;
+}
+export function qualifiedReferenceImportPath(reference) {
+    if (reference.qualifier?.ref) {
+        return reference.qualifier.ref.path;
+    }
+    if (reference.path?.ref) {
+        return reference.path.ref.path;
+    }
+    if (reference.path?.$refText) {
+        return unquoteReqlanString(reference.path.$refText);
+    }
+    return undefined;
+}
+export function isAnonymousQualifiedReference(reference) {
+    return reference.path !== undefined && reference.path.ref === undefined && reference.qualifier === undefined;
+}
+export { unquoteReqlanString } from './reqlan-quoted-strings.js';
+const MARKDOWN_LINK_PATTERN = /^\[([^\]]+)\]\(([^)]+)\)$/;
+export function parseMarkdownLink(raw) {
+    const match = MARKDOWN_LINK_PATTERN.exec(raw);
+    if (!match) {
+        return undefined;
+    }
+    return {
+        label: match[1],
+        target: match[2]
+    };
+}
+//# sourceMappingURL=reqlan-references.js.map

package/out/reqlan-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqlan-references.js","sourceRoot":"","sources":["../src/reqlan-references.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EAKvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,UAAU,eAAe,CAAC,MAAuB;IACnD,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrG,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAuB;IACjD,IAAI,oBAAoB,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO,MAAM,CAAC,IAAI,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACrD,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO,MAAM,CAAC,IAAI,CAAC;IACvB,CAAC;IACD,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,SAA6B;IACtE,IAAI,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;IACxC,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACnC,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3B,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,SAA6B;IACvE,OAAO,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC;AACjH,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAOjE,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAE1D,MAAM,UAAU,iBAAiB,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO;QACH,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE;QAChB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAE;KACpB,CAAC;AACN,CAAC"}

package/out/reqlan-scope.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Publishes idea and ideaset declarations for file-local and cross-file reference resolution.
+ */
+import type { AstNodeDescription, LangiumDocument, ReferenceInfo } from 'langium';
+import { DefaultScopeComputation, DefaultScopeProvider, type Scope } from 'langium';
+import type { ReqlanServices } from './reqlan-module.js';
+export declare class ReqlanScopeComputation extends DefaultScopeComputation {
+    collectExportedSymbols(document: LangiumDocument): Promise<AstNodeDescription[]>;
+}
+export declare class ReqlanScopeProvider extends DefaultScopeProvider {
+    protected readonly documents: ReqlanServices['shared']['workspace']['LangiumDocuments'];
+    private readonly services;
+    constructor(services: ReqlanServices);
+    getScope(context: ReferenceInfo): Scope;
+    private scopeForFileIdeas;
+    private scopeForIdeasetMembers;
+    private scopeForIdeasets;
+    private scopeForReferenceQualifiers;
+    private scopeForImportPaths;
+    private scopeForImportDeclaration;
+    private scopeForImportAliasName;
+    private scopeForImportPath;
+    private findImportedDocument;
+    private documentForQualifiedReference;
+}