feat: support array shapes (close #27)

grammar.js

@@ -321,13 +321,19 @@ module.exports = grammar({
     _var_tag: ($) =>
       seq(
         alias('@var', $.tag_name),
-        choice(
-          // @var int|string[]|array<string, int> description
-          seq($._type, $._description_after_type),
-          // @var int|string[]|array<string, int>
-          seq($._type, $.variable_name),
-          // @var int|string[]|array<string, int> $foo description
-          seq($._type, $.variable_name, $.description),
+        $._type,
+        // for psalm and phpstan, the var name is optional
+        optional(
+          choice(
+            // @var int description
+            $._description_after_type,
+
+            // @var int $foo
+            $.variable_name,
+
+            // @var int $foo description
+            seq($.variable_name, $.description),
+          ),
         ),
       ),
 
@@ -540,6 +546,7 @@ module.exports = grammar({
         alias($._phpdoc_array_types, $.array_type),
         alias($._psalm_generic_array_types, $.array_type),
         alias($._psalm_list_array_types, $.array_type),
+        alias($._psalm_shaped_array_types, $.array_type),
       ),
     _regular_types: ($) => PHP.rules._types,
     _phpdoc_array_types: ($) => seq($._regular_types, repeat1('[]')),
@@ -563,6 +570,37 @@ module.exports = grammar({
         '>',
       ),
 
+    _psalm_shaped_array_types: ($) =>
+      prec(
+        2,
+        seq(
+          'array',
+          '{',
+          sep1(alias($._shaped_array_element, $.array_element), ','),
+          '}',
+        ),
+      ),
+
+    _shaped_array_element: ($) =>
+      seq(
+        field(
+          'key',
+          optional(
+            seq(
+              choice(
+                $.name,
+                seq("'", $.name, "'"),
+                seq('"', $.name, '"'),
+                alias(/\d+/, $.name),
+              ),
+              optional('?'),
+              ':',
+            ),
+          ),
+        ),
+        field('value', $._regular_types),
+      ),
+
     _psalm_scalar_type: ($) =>
       choice(
         seq('class-string', optional($._type_argument_named_type)),