codemirror-lang-raku 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,3 +1,49 @@
+## 0.4.0 (2026-10-07)
+
+Most of this was found by parsing the test suite of
+[mutsu](https://github.com/tokuhirom/mutsu), an implementation of Raku.
+
+### Breaking changes
+
+- The name of a constant with a sigil, as in `constant $LIMIT = 3`, is a
+  `ConstantName` inside the `ConstantDeclaration`. It was a
+  `VariableName` after the declaration, which had no name.
+- A `:sym<…>` that follows the name of a declaration after blanks, as in
+  `token word :sym<long> { }`, is part of the `RegexName`.
+- A declarator comment with brackets, `#|( … )` or `#=( … )`, is one
+  `DocComment` up to its closing bracket. It ended with its first line,
+  and still does when the bracket is not closed.
+
+### New features
+
+- Corner quotes (`｢…｣`), also after a quote word (`Q｢…｣`), the low
+  curly quotes (`„…”`, `„…“`, `‚…’`, `‚…‘`) and the reversed `”…”`.
+- A quote word takes a backtick or a symbol outside of ASCII for a
+  delimiter: ``qx`…` ``, `Q♥…♥`.
+- Fractions that are one character (`½`, `⅔`) are numbers, and a power
+  in superscript (`$x²`) is an operator.
+- Symbols outside of ASCII are operators: the atomic operators
+  (`⚛+=`), and the operators of one's own (`1 ⚡ 2`).
+- The set operators that are written in parentheses, as in
+  `$a (<=) $b` and `$x (elem) $s`, are operators.
+- An operator in brackets as a routine, as in `&[+]`, is a
+  `VariableName`.
+- The name of an operator can be written in double angles:
+  `infix:<< plus-one >>`, `&infix:<<(>=)>>`.
+- The variable `$¢`.
+
+### Bug fixes
+
+- In a regex, `‘…’`, `“…”`, `‚…’`, `„…”` and `｢…｣` are quotes, in which
+  the delimiter of the regex does not end it: `m/ab ‘/’ c/`.
+- A list of words in a regex, `/ < a ' b > /`, no longer starts a quote
+  at a `'` in it.
+- A regex does not end at its delimiter in code: in the arguments of an
+  assertion (`<name: /a/ >`, `<:name(/a/)>`), in `$( … )`, and in a
+  declaration (`:my $m = $/;`).
+- A `$/` in the replacement of a substitution does not end it:
+  `s/(a)/[$/]/`.
+
 ## 0.3.0 (2026-10-07)
 
 ### Breaking changes

package/README.md

@@ -87,8 +87,8 @@ on incomplete code.
 |---|---|
 | `PackageDeclaration` | `class`, `role`, `grammar`, `module`, `package`, with a `PackageName` child, up to the body `Block` or the `;` of a `unit` declaration |
 | `RoutineDeclaration` | `sub`, `method`, `submethod`, with a `RoutineName` child (absent for anonymous routines), up to the body `Block`. Also the `foo(…) { }` of `multi foo(…) { }`, which declares a sub without the word `sub`: that node starts with its `RoutineName` |
-| `RegexDeclaration` | `token`, `rule`, `regex`, with a `RegexName` child, up to the body `Block`, which holds one `Regex` |
-| `EnumDeclaration`, `SubsetDeclaration`, `ConstantDeclaration` | The declarator and its `EnumName`, `SubsetName` or `ConstantName` |
+| `RegexDeclaration` | `token`, `rule`, `regex`, with a `RegexName` child, up to the body `Block`, which holds one `Regex`. The name includes a `:sym<…>`, with the blanks before it if there are any (`word :sym<long>`) |
+| `EnumDeclaration`, `SubsetDeclaration`, `ConstantDeclaration` | The declarator and its `EnumName`, `SubsetName` or `ConstantName`. The name of a constant includes its sigil if it has one (`constant $LIMIT`). A constant without a sigil that is declared with a backslash (`constant \x`) has no `ConstantName` |
 | `Block`, `Parens`, `Brackets` | `{ }`, `( )`, `[ ]` |
 | `VariableName`, `AttributeName`, `SpecialVariable` | `$x` / `$^a`, `$!x` / `$.x`, `$*x` / `$?x` |
 | `StringLiteral` | A quote of any kind. One that interpolates has `Escape`, `Interpolation`, variable, `Brackets`, `Parens` and `MethodCall` children, and a `NestedDelimiters` for each pair of its own delimiters in it (the `[b]` of `qq[a [b] c]`) |
@@ -113,7 +113,9 @@ Not supported yet:
   token, with the code or the nested `<…>` in it, and has to be closed on
   its line unless it is a character class. Groups (`[ ]`, `( )`) and
   adverbs (`:i`, `:my`) are plain text, so the text after `:my` is read
-  as regex.
+  as regex, and so is the code in `$( … )`. Such code does not end the
+  regex when it holds the delimiter (`/ :my $m = $/; /`), if it is on
+  one line.
 - A heredoc is interpolated when everything interpolates in it, as in
   `qq:to`. One that interpolates in part (`q:c:to`, `qq:!s:to`) is not
   highlighted inside. When a line opens several heredocs, they are
@@ -132,6 +134,10 @@ Not supported yet:
 - A Pod block is read where a statement or a term can stand, not
   everywhere that whitespace can: one between `class` and the name of
   the class is not read as Pod.
+- In a quote that has braces for delimiters, a `{ }` is taken to be a
+  nested pair of the delimiters, not a block of code: the `{$b + 1}` of
+  `qq{a {$b + 1} c}` is text, in which `$b` is interpolated. With other
+  delimiters, as in `qq[a {$b + 1} c]`, it is a block.
 - A quote adverb is switched off by the argument `False` or `0`, as in
   `qq:c(False)[…]`. With any other argument, such as a variable, it
   counts as switched on.
@@ -139,8 +145,13 @@ Not supported yet:
   command. Text that unbalances every bracket that is tried gets
   `` #`( `` … `)`, which then does not cover exactly that text.
 - A user-defined operator is recognized where it is declared
-  (`sub infix:<+++>`) and as a routine (`&infix:<+++>`), not where it is
-  used as an operator.
+  (`sub infix:<+++>`) and as a routine (`&infix:<+++>`). Where it is
+  used, it is an operator when it is made of operator characters or of
+  symbols outside of ASCII (`1 ⚡ 2`). One that is a word is a plain
+  name, also between hyper marks (`@a »plus« @b`), and a term or a
+  circumfix of one's own is not known.
+- The `native` declarator, which NativeCall uses internally, does not
+  make a declaration node.
 - Completion does not know types. After a `.` it offers the built-in
   methods and every method that the document declares, whatever the
   invocant is. Names from other files are not offered.