spec - file_references

Katz0.118

Summary

A file reference should act as a link in the editor.
If the target file is empty or has a parse error, the link should remain available and clickable, but should show a warning underline.
If the target file is missing, show an error underline and do not create a document link — see file_reference_errors.
Same-file and imported idea bracket references use the same editor activation as file targets.
See editor_reference_activation.
Implemented by reqlan-file-link-resolver.ts, reqlan-document-link-provider.ts, reqlan-definition-provider.ts, and reqlan-validator.ts.

Jump to outbound references

Jump to inbound references

Navigation

Source file

reqlan rq/extension/language/syntax/features-syntax.rq

community 1

community cluster

features-syntax.rq

file cluster

reqlan rq/extension/language/syntax

folder cluster

status: Not present

status cluster

tag: Not present

tag cluster

Printable page

Static print-friendly idea sheet.

Attributes

Key	Value
tests	linking.test.ts:document links resolve test file references to the matching test, references.test.ts:keeps colons inside the test name suffix, linking.test.ts:classifyReferenceUri treats existing directories as folders, linking.test.ts:folder file references resolve without reading the directory as a file, linking.test.ts:empty file references produce document links and warning diagnostics, linking.test.ts:parse-error file references produce document links and warning diagnostics, linking.test.ts:missing file references do not produce document links, linking.test.ts:same-file idea references produce document links

Key

Value

tests

linking.test.ts:document links resolve test file references to the matching test, references.test.ts:keeps colons inside the test name suffix, linking.test.ts:classifyReferenceUri treats existing directories as folders, linking.test.ts:folder file references resolve without reading the directory as a file, linking.test.ts:empty file references produce document links and warning diagnostics, linking.test.ts:parse-error file references produce document links and warning diagnostics, linking.test.ts:missing file references do not produce document links, linking.test.ts:same-file idea references produce document links

Browse all attributes

Ancestor context

No ancestor chain recorded.

Outbound references

Inbound references

Kind	Idea	Path	Snippet
references	import_folder_targets	reqlan rq/extension/language/support/features-imports.rq	file_references
references	file_reference_errors	reqlan rq/extension/language/support/language-server-errors.rq	file_references
references	unresolved_reference_diagnostics	reqlan rq/extension/language/syntax/features-syntax-highlighting.rq	file_references
references	file_reference	reqlan rq/reference_types.rq	file_references

Unresolved references

Kind	Idea	Path	Snippet
None

Local graph

Initialising graph…