reqlanOverviewIdeasFilesCode filesClustersAttributesGraphPrint
Ideas/code_snippets

Idea detail

code_snippets

reqlan rq/language/syntax.rq:206

block

Summary

Idea bodies and block attribute values may embed fenced code blocks delimited by triple backticks.
An opening fence is three backticks on a line, optionally followed by a language tag such as python or rq.
A closing fence is three backticks on a line.
Everything between the fences is literal opaque text — it is not parsed as reqlan syntax.
Keywords, imports, attributes, braces, and quotes inside a fence are inert for the parser and may be shown as examples without parse errors.
Fenced blocks may span multiple lines and preserve their inner content verbatim.
Brace-depth tracking must skip fence interiors so example braces cannot desync surrounding structure ( no_name_idea_safe_warning ).

Jump to outbound references

Jump to inbound references

Navigation

Source file

reqlan rq/language/syntax.rq

community 39

community cluster

syntax.rq

file cluster

reqlan rq/language

folder cluster

status: Not present

status cluster

tag: Not present

tag cluster

Printable page

Static print-friendly idea sheet.

Attributes

KeyValue
example ```python
print("hello")
```
tests parsing.test.ts:parse code snippet in block idea, parsing.test.ts:parse fenced code block in attribute value, parsing.test.ts:treats fenced rq example as opaque text, parsing.test.ts:treats fenced TypeScript braces as opaque for surrounding structure

Browse all attributes

Ancestor context

no_name_idea_safe_warning

A top-level nameless curly-brace block — `{... }` with no idea name — must not take down the parser or the language server workspace. Parse the block as a recoverable anonymous top-level element, emit a descriptive warning that a name is required before `{`, and continue so later ideas, imports, and links still work. Nameless blocks inside parenthesized lists remain valid list items per [lists]; only top-level nameless blocks warn. Related recovery posture: ["./imports.rq".import_error_recovery]. Block shape: [block_idea]. Fenced examples must stay opaque per [code_snippets] so braces inside snippets cannot desync structural depth. Non-termination ( lex / parse never finishes ) is a different failure mode: ["./parser_lexer.rq".parse_budget_timeout].

lists

Parenthesized lists contain newline-separated items. Each list item is either a one-liner or a nameless block idea in curly braces. Lists may appear as attribute values and inside block bodies. Named lists use a label followed by a parenthesized item list; the opening parenthesis must be followed by a newline before the first item. Nested lists may appear inside block values or as list items; the opening parenthesis must be followed by a newline before the first item. Inline parentheses in body prose — for example continuous ( " live " ) physics or ( pixelRatio 1, no WebGL ) — are plain text, not lists.

block_idea

A block idea is written as a name followed by curly braces containing a body and optional attributes. The first unstructured text in an idea body is the main description when no other body attribute is marked.

Outbound references

KindIdeaPathSnippet
file_reference ../../packages/language/test/parsing.test.ts:parse code snippet in block idea packages/language/test/parsing.test.ts:parse code snippet in block idea parsing.test.ts:parse code snippet in block idea
file_reference ../../packages/language/test/parsing.test.ts:parse fenced code block in attribute value packages/language/test/parsing.test.ts:parse fenced code block in attribute value parsing.test.ts:parse fenced code block in attribute value
file_reference ../../packages/language/test/parsing.test.ts:treats fenced TypeScript braces as opaque for surrounding structure packages/language/test/parsing.test.ts:treats fenced TypeScript braces as opaque for surrounding structure parsing.test.ts:treats fenced TypeScript braces as opaque for surrounding structure
file_reference ../../packages/language/test/parsing.test.ts:treats fenced rq example as opaque text packages/language/test/parsing.test.ts:treats fenced rq example as opaque text parsing.test.ts:treats fenced rq example as opaque text
references no_name_idea_safe_warning reqlan rq/language/syntax.rq no_name_idea_safe_warning

Inbound references

KindIdeaPathSnippet
references no_name_idea_safe_warning reqlan rq/language/syntax.rq code_snippets

Unresolved references

KindIdeaPathSnippet
None

Local graph

Initialising graph…