@reqlan/language 1.4.0

package/out/src/reqlan-path-references.js

@@ -0,0 +1,124 @@
+import { findCommentReferencesInText } from './reqlan-comment-resolver.js';
+import { findEmbeddedFileReferencesInText } from './reqlan-embedded-file-references.js';
+import { parseFileReferenceString } from './reqlan-file-references.js';
+import { parseReqlanQuotedString, REQLAN_QUOTED_STRING_CAPTURE } from './reqlan-quoted-strings.js';
+const IMPORT_PATH_PATTERN = new RegExp(`(?:\\bfrom|\\bimport)\\s+(${REQLAN_QUOTED_STRING_CAPTURE})`, 'g');
+export function findImportPathReferencesInText(text, lineOffset = 0) {
+    const references = [];
+    const lines = text.split(/\r?\n/);
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        for (const match of line.matchAll(IMPORT_PATH_PATTERN)) {
+            const quoted = match[1];
+            const path = parseReqlanQuotedString(quoted);
+            const start = match.index + match[0].indexOf(quoted);
+            references.push({
+                path,
+                range: {
+                    start: { line: lineOffset + lineIndex, character: start },
+                    end: { line: lineOffset + lineIndex, character: start + quoted.length }
+                }
+            });
+        }
+    }
+    return references;
+}
+export function findEmbeddedPathReferencesInText(text, lineOffset = 0) {
+    const references = [];
+    for (const embedded of findEmbeddedFileReferencesInText(text, lineOffset)) {
+        const parsed = parseFileReferenceString(embedded.file);
+        if (!parsed.filePath) {
+            continue;
+        }
+        const quotedPattern = new RegExp(REQLAN_QUOTED_STRING_CAPTURE);
+        const embeddedText = text.slice(textOffsetAtPosition(text, embedded.range.start), textOffsetAtPosition(text, embedded.range.end));
+        const quotedMatch = quotedPattern.exec(embeddedText);
+        if (!quotedMatch) {
+            continue;
+        }
+        const quoted = quotedMatch[0];
+        const pathIndex = quotedMatch.index ?? embeddedText.indexOf(quoted);
+        const absoluteStart = textOffsetAtPosition(text, embedded.range.start) + pathIndex;
+        const startPos = offsetToPosition(text, absoluteStart);
+        references.push({
+            path: parsed.filePath,
+            range: {
+                start: startPos,
+                end: { line: startPos.line, character: startPos.character + quoted.length }
+            }
+        });
+    }
+    return references;
+}
+export function findCommentPathReferencesInText(text, lineOffset = 0) {
+    const references = [];
+    for (const commentRef of findCommentReferencesInText(text, lineOffset)) {
+        if (!commentRef.path) {
+            continue;
+        }
+        const quotedPattern = new RegExp(REQLAN_QUOTED_STRING_CAPTURE);
+        const segmentStart = textOffsetAtPosition(text, commentRef.range.start);
+        const segmentEnd = textOffsetAtPosition(text, commentRef.range.end);
+        const segment = text.slice(segmentStart, segmentEnd);
+        const quotedMatch = quotedPattern.exec(segment);
+        if (!quotedMatch) {
+            continue;
+        }
+        const quoted = quotedMatch[0];
+        const pathIndex = quotedMatch.index ?? segment.indexOf(quoted);
+        const absoluteStart = segmentStart + pathIndex;
+        const startPos = offsetToPosition(text, absoluteStart);
+        references.push({
+            path: commentRef.path,
+            range: {
+                start: startPos,
+                end: { line: startPos.line, character: startPos.character + quoted.length }
+            }
+        });
+    }
+    return references;
+}
+export function findPathReferencesInMovedFile(text, isRqFile) {
+    const references = isRqFile
+        ? [...findImportPathReferencesInText(text), ...findEmbeddedPathReferencesInText(text)]
+        : findCommentPathReferencesInText(text);
+    return dedupePathReferences(references);
+}
+function dedupePathReferences(references) {
+    const seen = new Set();
+    const unique = [];
+    for (const reference of references) {
+        const key = [
+            reference.range.start.line,
+            reference.range.start.character,
+            reference.range.end.line,
+            reference.range.end.character
+        ].join(':');
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(reference);
+    }
+    return unique;
+}
+function textOffsetAtLine(text, lineIndex) {
+    const lines = text.split(/\r?\n/);
+    let offset = 0;
+    for (let index = 0; index < lineIndex; index++) {
+        offset += lines[index].length + 1;
+    }
+    return offset;
+}
+function textOffsetAtPosition(text, position) {
+    return textOffsetAtLine(text, position.line) + position.character;
+}
+function offsetToPosition(text, offset) {
+    const before = text.slice(0, offset);
+    const lines = before.split(/\r?\n/);
+    return {
+        line: lines.length - 1,
+        character: lines[lines.length - 1].length
+    };
+}
+//# sourceMappingURL=reqlan-path-references.js.map

package/out/src/reqlan-path-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqlan-path-references.js","sourceRoot":"","sources":["../../src/reqlan-path-references.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAEnG,MAAM,mBAAmB,GAAG,IAAI,MAAM,CAAC,6BAA6B,4BAA4B,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1G,MAAM,UAAU,8BAA8B,CAAC,IAAY,EAAE,UAAU,GAAG,CAAC;IACvE,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,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,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACzB,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,KAAK,EAAE;oBACH,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE;oBACzD,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE;iBAC1E;aACJ,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAAY,EAAE,UAAU,GAAG,CAAC;IACzE,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,KAAK,MAAM,QAAQ,IAAI,gCAAgC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnB,SAAS;QACb,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,4BAA4B,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAC3B,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAChD,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CACjD,CAAC;QACF,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,SAAS;QACb,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpE,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;QACnF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACvD,UAAU,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC,QAAQ;YACrB,KAAK,EAAE;gBACH,KAAK,EAAE,QAAQ;gBACf,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE;aAC9E;SACJ,CAAC,CAAC;IACP,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAAY,EAAE,UAAU,GAAG,CAAC;IACxE,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,KAAK,MAAM,UAAU,IAAI,2BAA2B,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACnB,SAAS;QACb,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,4BAA4B,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,SAAS;QACb,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;QAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACvD,UAAU,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,KAAK,EAAE;gBACH,KAAK,EAAE,QAAQ;gBACf,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE;aAC9E;SACJ,CAAC,CAAC;IACP,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY,EAAE,QAAiB;IACzE,MAAM,UAAU,GAAG,QAAQ;QACvB,CAAC,CAAC,CAAC,GAAG,8BAA8B,CAAC,IAAI,CAAC,EAAE,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC;QACtF,CAAC,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,oBAAoB,CAAC,UAA2B;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG;YACR,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;YAC1B,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS;YAC/B,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI;YACxB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS;SAChC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,SAAS;QACb,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,KAAK,CAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY,EAAE,QAAwB;IAChE,OAAO,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC;AACtE,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,MAAc;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO;QACH,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;QACtB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,MAAM;KAC7C,CAAC;AACN,CAAC"}

package/out/src/reqlan-path-resolve.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Resolves document-relative and import-root-aliased paths (default `@/`).
+ * rq:["../../../reqlan rq/extension/configuration.rq".configuration_location]
+ * rq:["../../../reqlan rq/extension/configuration.rq".configuration_import_roots]
+ * rq:["../../../reqlan rq/language/imports.rq".configuration_import_root_alias]
+ */
+import type { FileSystemProvider, LangiumDocument, URI } from 'langium';
+export declare const DEFAULT_IMPORT_ROOT_ALIAS = "@";
+export declare const RQCONFIG_FILENAME = ".rqconfig.json";
+export interface ImportRootMapping {
+    alias: string;
+    /** Absolute URI of that alias’s import-root directory, when set. */
+    rootUri?: URI;
+}
+export interface RqConfig {
+    importRoots: ImportRootMapping[];
+}
+export interface PathResolveContext {
+    /** Workspace folders that contain documents (longest match wins). */
+    workspaceFolderUris?: readonly URI[];
+    /** Explicit workspace folder for tests; preferred over list lookup when set. */
+    workspaceFolderUri?: URI;
+    fileSystem?: FileSystemProvider;
+    /**
+     * Preloaded config. `undefined` loads nearest `.rqconfig.json` when fileSystem is set.
+     * `null` skips loading and uses defaults only.
+     */
+    config?: RqConfig | null;
+}
+export declare function defaultRqConfig(): RqConfig;
+export declare function matchImportRootAlias(path: string, alias: string): string | undefined;
+/** Longest matching alias wins when several mappings could apply. */
+export declare function matchImportRootMapping(path: string, mappings: readonly ImportRootMapping[]): {
+    mapping: ImportRootMapping;
+    remainder: string;
+} | undefined;
+export declare function findWorkspaceFolderUri(documentUri: URI, folderUris: readonly URI[] | undefined): URI | undefined;
+export declare function loadApplyingRqConfig(startDirUri: URI, fileSystem: FileSystemProvider): RqConfig | undefined;
+export declare function resolveRqConfig(document: LangiumDocument, context?: PathResolveContext): RqConfig;
+export declare function resolveImportRootUri(document: LangiumDocument, context: PathResolveContext | undefined, mapping: ImportRootMapping): URI | undefined;
+/**
+ * Resolves a path string against the document directory, or against an import root when aliased.
+ */
+export declare function resolveDocumentPathUri(path: string, document: LangiumDocument, context?: PathResolveContext): URI;
+export declare function workspaceFolderUrisFromManager(folders: ReadonlyArray<{
+    uri: string;
+}> | undefined): URI[];
+export declare function pathResolveContextFromServices(services: {
+    shared: {
+        workspace: {
+            WorkspaceManager: {
+                workspaceFolders?: ReadonlyArray<{
+                    uri: string;
+                }>;
+            };
+            FileSystemProvider: FileSystemProvider;
+        };
+    };
+}): PathResolveContext;

package/out/src/reqlan-path-resolve.js

@@ -0,0 +1,173 @@
+import { URI as UriCtor, UriUtils } from 'langium';
+export const DEFAULT_IMPORT_ROOT_ALIAS = '@';
+export const RQCONFIG_FILENAME = '.rqconfig.json';
+export function defaultRqConfig() {
+    return { importRoots: [{ alias: DEFAULT_IMPORT_ROOT_ALIAS }] };
+}
+export function matchImportRootAlias(path, alias) {
+    if (!alias || !path.startsWith(alias)) {
+        return undefined;
+    }
+    const afterAlias = path.slice(alias.length);
+    if (!afterAlias.startsWith('/')) {
+        return undefined;
+    }
+    return afterAlias.slice(1);
+}
+/** Longest matching alias wins when several mappings could apply. */
+export function matchImportRootMapping(path, mappings) {
+    const ordered = [...mappings]
+        .filter(mapping => mapping.alias.length > 0)
+        .sort((left, right) => right.alias.length - left.alias.length);
+    for (const mapping of ordered) {
+        const remainder = matchImportRootAlias(path, mapping.alias);
+        if (remainder !== undefined) {
+            return { mapping, remainder };
+        }
+    }
+    return undefined;
+}
+export function findWorkspaceFolderUri(documentUri, folderUris) {
+    if (!folderUris || folderUris.length === 0) {
+        return undefined;
+    }
+    const documentPath = documentUri.toString();
+    let best;
+    let bestLength = -1;
+    for (const folder of folderUris) {
+        const folderPath = folder.path.endsWith('/')
+            ? folder.toString()
+            : `${folder.toString()}/`;
+        const folderBase = folder.toString();
+        if (documentPath === folderBase || documentPath.startsWith(folderPath)) {
+            const length = folderBase.length;
+            if (length > bestLength) {
+                best = folder;
+                bestLength = length;
+            }
+        }
+    }
+    return best;
+}
+export function loadApplyingRqConfig(startDirUri, fileSystem) {
+    let dir = startDirUri;
+    for (;;) {
+        const configUri = UriUtils.joinPath(dir, RQCONFIG_FILENAME);
+        if (fileSystem.existsSync(configUri) && !fileSystem.statSync(configUri).isDirectory) {
+            return parseRqConfig(configUri, fileSystem);
+        }
+        const parent = UriUtils.dirname(dir);
+        if (UriUtils.equals(parent, dir)) {
+            return undefined;
+        }
+        dir = parent;
+    }
+}
+function parseRqConfig(configUri, fileSystem) {
+    let raw;
+    try {
+        raw = JSON.parse(fileSystem.readFileSync(configUri));
+    }
+    catch {
+        return undefined;
+    }
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return undefined;
+    }
+    const record = raw;
+    if (!('importRoots' in record)) {
+        return defaultRqConfig();
+    }
+    if (!Array.isArray(record.importRoots)) {
+        return undefined;
+    }
+    const configDir = UriUtils.dirname(configUri);
+    const importRoots = [];
+    for (const entry of record.importRoots) {
+        const mapping = parseImportRootEntry(entry, configDir);
+        if (mapping) {
+            importRoots.push(mapping);
+        }
+    }
+    if (importRoots.length === 0) {
+        return defaultRqConfig();
+    }
+    return { importRoots };
+}
+function parseImportRootEntry(entry, configDir) {
+    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+        return undefined;
+    }
+    const record = entry;
+    if (typeof record.alias !== 'string' || record.alias.length === 0) {
+        return undefined;
+    }
+    const mapping = { alias: record.alias };
+    if (typeof record.root === 'string' && record.root.length > 0) {
+        mapping.rootUri = isAbsoluteUriOrPath(record.root)
+            ? toDirectoryUri(record.root)
+            : UriUtils.resolvePath(configDir, record.root);
+    }
+    return mapping;
+}
+function isAbsoluteUriOrPath(value) {
+    return /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(value) || value.startsWith('/');
+}
+function toDirectoryUri(value) {
+    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(value)) {
+        return UriCtor.parse(value);
+    }
+    return UriCtor.file(value);
+}
+export function resolveRqConfig(document, context) {
+    if (context?.config === null) {
+        return defaultRqConfig();
+    }
+    if (context?.config) {
+        return context.config;
+    }
+    if (context?.fileSystem) {
+        const loaded = loadApplyingRqConfig(UriUtils.dirname(document.uri), context.fileSystem);
+        if (loaded) {
+            return loaded;
+        }
+    }
+    return defaultRqConfig();
+}
+export function resolveImportRootUri(document, context, mapping) {
+    if (mapping.rootUri) {
+        return mapping.rootUri;
+    }
+    if (context?.workspaceFolderUri) {
+        return context.workspaceFolderUri;
+    }
+    return findWorkspaceFolderUri(document.uri, context?.workspaceFolderUris);
+}
+/**
+ * Resolves a path string against the document directory, or against an import root when aliased.
+ */
+export function resolveDocumentPathUri(path, document, context) {
+    const config = resolveRqConfig(document, context);
+    const matched = matchImportRootMapping(path, config.importRoots);
+    if (!matched) {
+        return UriUtils.resolvePath(UriUtils.dirname(document.uri), path);
+    }
+    const importRoot = resolveImportRootUri(document, context, matched.mapping);
+    if (!importRoot) {
+        return UriUtils.resolvePath(UriUtils.dirname(document.uri), path);
+    }
+    return UriUtils.resolvePath(importRoot, matched.remainder);
+}
+export function workspaceFolderUrisFromManager(folders) {
+    if (!folders) {
+        return [];
+    }
+    return folders.map(folder => UriCtor.parse(folder.uri));
+}
+export function pathResolveContextFromServices(services) {
+    return {
+        fileSystem: services.shared.workspace.FileSystemProvider,
+        workspaceFolderUris: workspaceFolderUrisFromManager(services.shared.workspace.WorkspaceManager.workspaceFolders)
+    };
+}
+//# sourceMappingURL=reqlan-path-resolve.js.map

package/out/src/reqlan-path-resolve.js.map

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

package/out/src/reqlan-quoted-strings.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared helpers for reqlan double- and single-quoted string literals.
+ */
+/** Capturing group for one quoted string (double or single). */
+export declare const REQLAN_QUOTED_STRING_CAPTURE = "(?:\"(?:\\\\.|[^\"\\\\])*\"|'(?:\\\\.|[^'\\\\])*')";
+export declare const REQLAN_QUOTED_STRING_PATTERN: RegExp;
+export declare function reqlanStringDelimiter(text: string): '"' | "'" | undefined;
+export declare function unquoteReqlanString(text: string): string;
+export declare function parseReqlanQuotedString(quoted: string): string;

package/out/src/reqlan-quoted-strings.js

@@ -0,0 +1,26 @@
+/**
+ * Shared helpers for reqlan double- and single-quoted string literals.
+ */
+/** Capturing group for one quoted string (double or single). */
+export const REQLAN_QUOTED_STRING_CAPTURE = '(?:"(?:\\\\.|[^"\\\\])*"|\'(?:\\\\.|[^\'\\\\])*\')';
+export const REQLAN_QUOTED_STRING_PATTERN = new RegExp(REQLAN_QUOTED_STRING_CAPTURE, 'g');
+export function reqlanStringDelimiter(text) {
+    if (text.startsWith('"')) {
+        return '"';
+    }
+    if (text.startsWith("'")) {
+        return "'";
+    }
+    return undefined;
+}
+export function unquoteReqlanString(text) {
+    const delimiter = reqlanStringDelimiter(text);
+    if (!delimiter || !text.endsWith(delimiter)) {
+        return text;
+    }
+    return text.slice(1, -1).replace(/\\(.)/g, '$1');
+}
+export function parseReqlanQuotedString(quoted) {
+    return unquoteReqlanString(quoted);
+}
+//# sourceMappingURL=reqlan-quoted-strings.js.map

package/out/src/reqlan-quoted-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reqlan-quoted-strings.js","sourceRoot":"","sources":["../../src/reqlan-quoted-strings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAG,oDAAoD,CAAC;AAEjG,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,MAAM,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;AAE1F,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACf,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC5C,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc;IAClD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/out/src/reqlan-reference-at-position.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Locates file path references at a cursor position and resolves them to files, folders, or missing paths.
+ */
+import type { FileSystemProvider, LangiumDocument, LangiumDocuments } from 'langium';
+import type { Position, LocationLink } from 'vscode-languageserver';
+import { type ReferenceResolution, type ResolvedFileLink } from './reqlan-file-link-resolver.js';
+import type { PathResolveContext } from './reqlan-path-resolve.js';
+export declare const REQLAN_OPEN_FOLDER_COMMAND = "reqlan.openFolderReference";
+export declare const REQLAN_FILE_REFERENCE_AT_REQUEST = "reqlan/fileReferenceAt";
+export declare const REQLAN_COMMENT_DEFINITION_REQUEST = "reqlan/commentDefinition";
+export declare function folderReferenceCommandTarget(folderUri: string): string;
+export declare function findFileReferenceAtPosition(document: LangiumDocument, position: Position, documents: LangiumDocuments, fileSystem: FileSystemProvider, context?: PathResolveContext): ResolvedFileLink | undefined;
+export interface FileReferenceAtRequestResult {
+    sourceRange: ResolvedFileLink['sourceRange'];
+    targetUri: string;
+    resolution: ReferenceResolution;
+    folderFiles?: string[];
+}
+export declare function findCommentDefinitionAtPosition(document: LangiumDocument, position: Position, documents: LangiumDocuments, context?: PathResolveContext): LocationLink[] | undefined;
+export declare function fileReferenceAtRequestResult(link: ResolvedFileLink): FileReferenceAtRequestResult;

package/out/src/reqlan-reference-at-position.js

@@ -0,0 +1,89 @@
+import { CstUtils, GrammarUtils } from 'langium';
+import { findCommentReferencePartAt, resolveCommentDefinitionLinks, resolveFileUri } from './reqlan-comment-resolver.js';
+import { findEmbeddedFileReferenceAt } from './reqlan-embedded-file-references.js';
+import { classifyReferenceUri, listFolderFileNames, resolveEmbeddedFileReferenceLink, resolveFileReferenceLink } from './reqlan-file-link-resolver.js';
+import { isFileReference, isFileSymbolReference } from './generated/ast.js';
+export const REQLAN_OPEN_FOLDER_COMMAND = 'reqlan.openFolderReference';
+export const REQLAN_FILE_REFERENCE_AT_REQUEST = 'reqlan/fileReferenceAt';
+export const REQLAN_COMMENT_DEFINITION_REQUEST = 'reqlan/commentDefinition';
+export function folderReferenceCommandTarget(folderUri) {
+    return `command:${REQLAN_OPEN_FOLDER_COMMAND}?${encodeURIComponent(JSON.stringify([folderUri]))}`;
+}
+export function findFileReferenceAtPosition(document, position, documents, fileSystem, context) {
+    const pathContext = { ...context, fileSystem: context?.fileSystem ?? fileSystem };
+    const commentPart = findCommentReferencePartAt(document, position);
+    if (commentPart?.property === 'path' && commentPart.reference.path) {
+        return resolvePathReference(document, commentPart.reference.path, commentPart.reference.range, documents, fileSystem, pathContext);
+    }
+    const embeddedReference = findEmbeddedFileReferenceAt(document, position);
+    if (embeddedReference) {
+        return resolveEmbeddedFileReferenceLink(embeddedReference, document, documents, fileSystem, pathContext);
+    }
+    const fileReference = findFileReferenceNodeAtPosition(document, position);
+    if (fileReference) {
+        return resolveFileReferenceLink(fileReference.node, documents, fileSystem, pathContext);
+    }
+    return undefined;
+}
+function resolvePathReference(document, path, sourceRange, documents, fileSystem, context) {
+    const targetUri = resolveFileUri(path, document, context);
+    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 targetDocument = documents.getDocument(targetUri);
+    const target = targetDocument?.parseResult.value.$cstNode;
+    if (!targetDocument || !target) {
+        return undefined;
+    }
+    return {
+        sourceRange,
+        targetUri: targetDocument.textDocument.uri,
+        targetRange: target.range,
+        resolution: 'file'
+    };
+}
+function findFileReferenceNodeAtPosition(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 assignment = GrammarUtils.findAssignment(current);
+        const container = current.astNode;
+        if ((isFileReference(container) || isFileSymbolReference(container)) && assignment?.feature === 'file') {
+            const pathNode = GrammarUtils.findNodeForProperty(container.$cstNode, 'file');
+            if (pathNode) {
+                return { node: container, pathNode };
+            }
+        }
+        current = current.container;
+    }
+    return undefined;
+}
+export function findCommentDefinitionAtPosition(document, position, documents, context) {
+    const commentPart = findCommentReferencePartAt(document, position);
+    if (commentPart?.property !== 'idea') {
+        return undefined;
+    }
+    return resolveCommentDefinitionLinks(commentPart.reference, document, documents, context);
+}
+export function fileReferenceAtRequestResult(link) {
+    return {
+        sourceRange: link.sourceRange,
+        targetUri: link.targetUri,
+        resolution: link.resolution ?? 'file',
+        folderFiles: link.folderFiles
+    };
+}
+//# sourceMappingURL=reqlan-reference-at-position.js.map

package/out/src/reqlan-reference-at-position.js.map

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

package/out/src/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/src/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/src/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/src/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;
+}