spec - reqlan rq/extension/syntax

Idea	File	Status	Summary
activity_bar_module	reqlan rq/extension/syntax/features-syntax-highlighting.rq		the extension should provide a activity bar module for the ide. the activity bar module should display the following information: - the current file - the current idea - ideas referencing the current idea / selection - a local graph see ["../module/activitybar.rq"] for more details.
attribute_code_completion_attribute_key	reqlan rq/extension/syntax/features-syntax-highlighting.rq		the attribute key should complete based on endorsed keys and what is present in the index i. e. after the @ symbol at the start of a line, the used attributes should be completed. subsquently, values of the attribute key should be completed based on the values in that attribute key.
attribute_code_completion_main_descriptiption	reqlan rq/extension/syntax/features-syntax-highlighting.rq		the main description attribute is expected to be prose, so, the dropdown shouldn't be rendered in this context.
code_lens_reference_types	reqlan rq/extension/syntax/features-syntax-highlighting.rq	done	References should have a ["../vsc-primitives.rq".codelens] button. The button should be togleable in settings. The button should the classification of the reference. e. g. ' open reqlan file', " open { extension } file', ' open folder', ' open idea' Clicking the CodeLens should open a reference card with summary stats — not navigate, because references already act as editor links. The card should offer open / reveal / file-selector actions when useful. Folders should be handled by focusing on the ide explorer, or by opening a file selector. Some summary stats should be shown for references - e. g. last edited, count of references, count of referencers, etc. Implemented by ["../../../packages/language/src/reqlan-code-lens-provider.ts"], ["../../../packages/language/src/reqlan-reference-code-lens.ts"], ["../../../packages/language/src/reqlan-code-lens-settings.ts"], ["../../../packages/extension/src/extension/register-reference-code-lens.ts"], and ["../../../packages/extension/src/extension/reference-code-lens-card.ts"].
complementary_information_rendering	reqlan rq/extension/syntax/features-syntax-highlighting.rq		The extension should render computed information inline in the editor as complementary text. Complementary rendering should include resolved references and optionally indirect references behind a toggle. Complementary rendering should not mutate source files unless the user explicitly applies a change.
inbound_inlay_hints_whole_graph	reqlan rq/extension/syntax/features-syntax-highlighting.rq	done	Inbound references shown in [view_references_as_inlay_hints] should include referencers from the whole requirement graph across the workspace, not only ideas declared in the current file. Implemented by ["../../../packages/language/src/reqlan-inbound-reference-inlay-label.ts"], ["../../../packages/language/src/reqlan-inlay-hint-provider.ts"]. [view_references_as_inlay_hints] [traceable_inlay_hints]
reference_code_completion	reqlan rq/extension/syntax/features-syntax-highlighting.rq		references should code complete the available namespace of ideas this includes both ideas using hte standards idea namespace syntax, and ideas using file paths, and relative file paths. Implemented by ["../../../packages/language/src/reqlan-completion-provider.ts"]. ["../code_completion.rq"]
reference_code_completion_sequencing	reqlan rq/extension/syntax/features-syntax-highlighting.rq		[reference_code_completion] should be offered, not alphabetically, but by distance, then alphabetically. Implemented by ["../../../packages/language/src/reqlan-completion-provider.ts"]. ["../code_completion.rq".code_completion]
reference_rendering	reqlan rq/extension/syntax/features-syntax-highlighting.rq		Resolved references should be visually distinguishable from unresolved or broken references. Indirect references inferred by graph traversal should be showable via a user toggle. Reference kinds ( dependency, incompatible with, applies to, related to ) should be surfaced where declared or inferred.
reference_resolution_folder	reqlan rq/extension/syntax/features-syntax-highlighting.rq		If the reference path is a folder, the extension should render a popup with a list of files in that folder. The link should not try to resolve to a file if it doesn't exist.
traceable_inlay_hints	reqlan rq/extension/syntax/features-syntax-highlighting.rq	done	Inlay hints should be traceable, i. e. if a user clicks a specific idea reference, it should open that idea, if a user clicks the all references hint, it should open a search webview with the idea preselected / targets prefiltered Implemented by ["../../../packages/language/src/reqlan-inbound-reference-inlay-label.ts"], ["../../../packages/language/src/reqlan-inlay-hint-provider.ts"], and ["../../../packages/extension/src/webview_module/register-webview.ts"].
view_references_as_inlay_hints	reqlan rq/extension/syntax/features-syntax-highlighting.rq	incomplete	References should be shown as inlay hints in the editor. This should be a toggleable setting, which should be available in the command palette. N-lines ( configurable setting ) of hints should be shown below the idea. Implemented by ["../../../packages/language/src/reqlan-inlay-hint-provider.ts"], ["../../../packages/language/src/reqlan-inbound-reference-inlay-label.ts"], ["../../../packages/language/src/reqlan-inlay-hint-settings.ts"], and ["../../../packages/extension/src/extension/register-reference-inlay-hints.ts"].
at_sign_in_idea_text_block	reqlan rq/extension/syntax/features-syntax.rq		the @ symbol should only indicate an attribute if at the start of a line. it should be escapeable with a backslash ( although any character would work as the @ would no longer be at the start of the line ) so @ this_is_not_an_attribute
code_completion	reqlan rq/extension/syntax/features-syntax.rq		The extension should support sensible code completion. - support for references - support for imports, including import-root alias paths such as `@/` from ["../../language/imports.rq".configuration_import_root_alias] and ["../configuration.rq".configuration_import_roots] - support for semantic search - support for graph-proximity based ranking
code_completion_import_file_paths	reqlan rq/extension/syntax/features-syntax.rq		import files should code complete nicely based on the current file's path; and the resolved import config. it should support normal ".. / string / paths "; and if " @ / the-paths / are- @ - aliased " ["../configuration.rq"] ["../../language/imports.rq"] ["../code_completion.rq"]
comment_support	reqlan rq/extension/syntax/features-syntax.rq		The extension should recognise reqlan references embedded in comments of arbitrary source files. Comment reference syntax should follow the form `rq:"../reqfile.rq".idea_name` in line comments. Comment references in non-. rq files should support syntax highlighting, hover, and go-to-definition. Arbitrary file references should be supported from both. rq files and comment references.
file_references	reqlan rq/extension/syntax/features-syntax.rq		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. Implemented by ["../../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../../packages/language/src/reqlan-document-link-provider.ts"], ["../../../packages/language/src/reqlan-definition-provider.ts"], and ["../../../packages/language/src/reqlan-validator.ts"].
refactor_support	reqlan rq/extension/syntax/features-syntax.rq		syntactic symbols should be available for renaming, moving, and deleting. the extension should watch for the change. Detailed behaviour lives in ["../refactor_support.rq"]. Implemented by ["../../../packages/language/src/reqlan-rename-provider.ts"], ["../../../packages/language/src/reqlan-idea-refactor.ts"], and ["../../../packages/extension/src/refactor_module/index.ts"].
sensible_alias_support	reqlan rq/extension/syntax/features-syntax.rq		if an imported idea shares a name with an idea in the current file: When the import uses an alias, the base name may be reused locally — see ["../../language/imports.rq".import_tokenisation].
syntax_features	reqlan rq/extension/syntax/features-syntax.rq		The extension should provide language support for. rq files via the lsp. Syntax features should cover ideas, ideasets, imports, references, attributes, comments, and lists. Broken imports and references should be validated and reported in the editor. Go-to-definition and find-references should work for ideas, imports, and cross-file links. Autoformatting should be supported for. rq files.
syntax_highlighting	reqlan rq/extension/syntax/features-syntax.rq		. rq files should receive full syntax highlighting coverage for all reqlan constructs. Semantic token highlighting should distinguish ideas, attributes, references, imports, and keywords.
syntax_hovering	reqlan rq/extension/syntax/features-syntax.rq		Hovering on an idea, ideaset, import, or reference should show a text summary of its content and resolved target. Hovering on a reference should show where it resolves and any declared reference kind.

Initialising graph…

Members

Cluster graph