sysmlpy 0.27.4__tar.gz → 0.28.1__tar.gz

{sysmlpy-0.27.4 → sysmlpy-0.28.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sysmlpy
-Version: 0.27.4
+Version: 0.28.1
 Summary: SysML v2.0 Parser
 License: MIT License
          
@@ -59,6 +59,8 @@ The project had diverged so much from sysml2py that a new name, sysmlpy, was sel
 
 ![Lines of Code Over Time](loc_history.svg)
 
+**v0.28.0:** Complete Gap 4 coverage — Block Definition Diagram (BDD), Internal Block Diagram (IBD), Parametric Diagram, and Package Diagram views. All 6 specialized SysML v2 view types now implemented (144 PlantUML tests). IBD shows flow/connection arrows with endpoint extraction. Parametric view extracts constraint parameters with types. Package diagram renders nested folder-style hierarchy.
+
 **v0.27.0:** General View (GV), Package View, and three GridView specializations (Tabular View, Data Value Tabular View, Relationship Matrix View) with PlantUML, Markdown, and HTML output. 108 PlantUML tests. All 68+ `NotImplementedError` stubs in `grammar/classes.py` replaced with graceful handling.
 
 **v0.26.0:** Action Flow View, Interconnection View, and State Transition View with auto-include of connected elements. Grammar-level flow scanning. 101 PlantUML tests.
@@ -493,10 +495,42 @@ from sysmlpy.plantuml import as_package_view
 print(as_package_view(model, style="bw"))
 ```
 
+#### Package Diagram View — `as_package_diagram_view()`
+Folder-style package hierarchy with elements nested inside their containing packages. Shows containment structure clearly with color-coded element types.
+
+```python
+from sysmlpy.plantuml import as_package_diagram_view
+print(as_package_diagram_view(model, style="bw"))
+```
+
+#### Block Definition Diagram (BDD) — `as_block_definition_view()`
+Corresponds to SysML v2 Block Definition Diagrams. Shows block definitions with compartments for attributes, ports, and part references. Displays generalization relationships.
+
+```python
+from sysmlpy.plantuml import as_block_definition_view
+print(as_block_definition_view(model, style="bw"))
+```
+
+#### Internal Block Diagram (IBD) — `as_internal_block_diagram()`
+Corresponds to SysML v2 Internal Block Diagrams. Shows a single block's internal structure with boundary ports, nested parts, and flow/connection arrows between endpoints.
+
+```python
+from sysmlpy.plantuml import as_internal_block_diagram
+print(as_internal_block_diagram(model, style="bw"))
+```
+
+#### Parametric Diagram — `as_parametric_view()`
+Shows constraint definitions with parameter compartments (including types like `Real`). Supports constraint usages and parameter bindings.
+
+```python
+from sysmlpy.plantuml import as_parametric_view
+print(as_parametric_view(model, style="bw"))
+```
+
 #### Action Flow View (AFV) — `as_action_flow_view()`
 Corresponds to SysML v2 ``ActionFlowView`` (short name ``afv``). Shows actions with their control and object flows. Auto-includes connected flow elements.
 
-![Action Flow View](docs/plantuml-examples/09-action-flow-view.png)
+![Action Flow View](docs/plantuml-examples/13-action-flow-view.png)
 
 ```python
 from sysmlpy.plantuml import as_action_flow_view
@@ -516,7 +550,7 @@ print(as_interconnection_view(model, style="bw"))
 #### State Transition View (STV) — `as_state_transition_view()`
 Corresponds to SysML v2 ``StateTransitionView`` (short name ``stv``). State machine diagram with hierarchical states and transitions. Auto-includes connected transition elements.
 
-![State Transition View](docs/plantuml-examples/10-state-transition-view.png)
+![State Transition View](docs/plantuml-examples/14-state-transition-view.png)
 
 ```python
 from sysmlpy.plantuml import as_state_transition_view
@@ -526,19 +560,17 @@ print(as_state_transition_view(model, style="bw"))
 #### Tree Diagram — `as_tree_diagram()`
 Hierarchical containment tree using nested PlantUML containers. Shows ownership hierarchy with sharp corners for definitions and rounded corners for usages.
 
-![Tree Diagram](docs/plantuml-examples/11-tree-diagram.png)
+![Tree Diagram](docs/plantuml-examples/15-tree-diagram.png)
 
 ```python
 from sysmlpy.plantuml import as_tree_diagram
 print(as_tree_diagram(model, style="bw"))
 ```
 
-### Tabular View Rendering Functions
-
 #### Element Table — `as_element_table()`
 A simple tabular listing with columns Name, Type, Kind, and Parent.
 
-![Element Table](docs/plantuml-examples/12-element-table.png)
+![Element Table](docs/plantuml-examples/16-element-table.png)
 
 ```python
 from sysmlpy.plantuml import as_element_table
@@ -548,7 +580,7 @@ print(as_element_table(model, style="bw"))
 #### Textual Notation — `as_textual_notation()`
 Indented text representation inside a PlantUML note, similar to the SysML v2 textual concrete syntax.
 
-![Textual Notation](docs/plantuml-examples/13-textual-notation.png)
+![Textual Notation](docs/plantuml-examples/17-textual-notation.png)
 
 ```python
 from sysmlpy.plantuml import as_textual_notation
@@ -559,20 +591,22 @@ print(as_textual_notation(model, style="bw"))
 
 Per the SysML v2 standard, ``GridView`` (short name ``grv``) presents exposed model elements and their relationships in a rectangular grid. It has three specializations, all supporting **three output formats**:
 
-| Format | Use case |
-|--------|----------|
-| `"plantuml"` (default) | PlantUML table / salt matrix — embed in diagrams |
-| `"markdown"` | Standard pipe table — for GitHub, MkDocs, or Jupyter |
-| `"html"` | Rich `<table>` with CSS classes — for web dashboards |
+| Format | Use case | Compatibility |
+|--------|----------|---------------|
+| `"markdown"` (default) | Standard pipe table — for GitHub, MkDocs, or Jupyter | ✅ Universal |
+| `"html"` | Rich `<table>` with CSS classes — for web dashboards | ✅ Universal |
+| `"plantuml"` | PlantUML table / salt matrix — embed in diagrams | ⚠️ PlantUML <1.2024.7 only |
+
+**Note:** PlantUML 1.2024.7+ removed support for legacy table syntax. Use `"markdown"` or `"html"` output format for compatibility with all PlantUML versions.
 
 #### Tabular View — `as_tabular_view()`
 Extensible table with configurable columns. Default columns: Name, Type, Kind, Parent, Typed By, Specializes.
 
-![Tabular View (BW)](docs/plantuml-examples/14-tabular-view.png)
+See [`18-tabular-view.md`](docs/plantuml-examples/18-tabular-view.md) for example output.
 
 ```python
 from sysmlpy.plantuml import as_tabular_view
-print(as_tabular_view(model, output_format="markdown"))
+print(as_tabular_view(model))  # Default: markdown output
 ```
 
 Custom columns and other output formats:
@@ -583,18 +617,18 @@ print(as_tabular_view(model,
     columns=["Name", "Type", "Parent", "Typed By"],
     output_format="html"))
 
-# Markdown for documentation
+# Markdown for documentation (default)
 print(as_tabular_view(model, output_format="markdown"))
 ```
 
 #### Data Value Tabular View — `as_data_value_tabular_view()`
 Attribute-specific version showing Element, Attribute, Value, Unit, and Type columns. Uses `Attribute.get_value()` for pint.Quantity extraction.
 
-![Data Value View](docs/plantuml-examples/15-data-value-view.png)
+See [`19-data-value-view.md`](docs/plantuml-examples/19-data-value-view.md) for example output.
 
 ```python
 from sysmlpy.plantuml import as_data_value_tabular_view
-print(as_data_value_tabular_view(model, output_format="html"))
+print(as_data_value_tabular_view(model))  # Default: markdown output
 ```
 
 #### Relationship Matrix View — `as_relationship_matrix_view()`
@@ -605,11 +639,11 @@ Pairwise element×element matrix showing relationship types:
 - **G** = Specialization (generalization)
 - **B** = Binding, **F** = Flow, **R** = Redefinition, etc.
 
-![Relationship Matrix](docs/plantuml-examples/16-relationship-matrix.png)
+See [`20-relationship-matrix.md`](docs/plantuml-examples/20-relationship-matrix.md) for example output.
 
 ```python
 from sysmlpy.plantuml import as_relationship_matrix_view
-print(as_relationship_matrix_view(model, output_format="markdown"))
+print(as_relationship_matrix_view(model))  # Default: markdown output
 ```
 
 Type filtering and HTML output:
@@ -626,14 +660,14 @@ All rendering functions accept `style="color"` for colored output with CSS-style
 
 ```python
 from sysmlpy.plantuml import as_tabular_view
-print(as_tabular_view(model, style="color"))
+print(as_tabular_view(model, output_format="html", style="color"))
 ```
 
-![Tabular View (Color)](docs/plantuml-examples/17-tabular-view-color.png)
+See [`21-tabular-view-color.html`](docs/plantuml-examples/21-tabular-view-color.html) for example output.
 
 ### Complete Example Gallery
 
-See [`docs/plantuml-examples/`](docs/plantuml-examples/) for all 16 rendered example images, covering every view function.
+See [`docs/plantuml-examples/`](docs/plantuml-examples/) for all rendered example images, covering every view function.
 
 | # | Example | View Type |
 |---|---------|-----------|
@@ -645,15 +679,19 @@ See [`docs/plantuml-examples/`](docs/plantuml-examples/) for all 16 rendered exa
 | 6 | Interconnection | Interconnection View |
 | 7 | General View (GV) | General View |
 | 8 | Package View | Package View |
-| 9 | Action Flow View (AFV) | Action Flow View |
-| 10 | State Transition View (STV) | State Transition View |
-| 11 | Tree Diagram | Tree Diagram |
-| 12 | Element Table | Element Table |
-| 13 | Textual Notation | Textual Notation |
-| 14 | Tabular View (GridView) | Tabular View |
-| 15 | Data Value Tabular View (GridView) | Data Value View |
-| 16 | Relationship Matrix (GridView) | Relationship Matrix |
-| 17 | Tabular View — Color | Tabular View (color) |
+| 9 | Package Diagram | Package Diagram View |
+| 10 | Block Definition Diagram (BDD) | Block Definition View |
+| 11 | Internal Block Diagram (IBD) | Internal Block Diagram |
+| 12 | Parametric Diagram | Parametric View |
+| 13 | Action Flow View (AFV) | Action Flow View |
+| 14 | State Transition View (STV) | State Transition View |
+| 15 | Tree Diagram | Tree Diagram |
+| 16 | Element Table | Element Table |
+| 17 | Textual Notation | Textual Notation |
+| 18 | Tabular View (GridView) | Tabular View |
+| 19 | Data Value Tabular View (GridView) | Data Value View |
+| 20 | Relationship Matrix (GridView) | Relationship Matrix |
+| 21 | Tabular View — Color | Tabular View (color) |
 
 ## Conformance
 

{sysmlpy-0.27.4 → sysmlpy-0.28.1}/README.md

@@ -14,6 +14,8 @@ The project had diverged so much from sysml2py that a new name, sysmlpy, was sel
 
 ![Lines of Code Over Time](loc_history.svg)
 
+**v0.28.0:** Complete Gap 4 coverage — Block Definition Diagram (BDD), Internal Block Diagram (IBD), Parametric Diagram, and Package Diagram views. All 6 specialized SysML v2 view types now implemented (144 PlantUML tests). IBD shows flow/connection arrows with endpoint extraction. Parametric view extracts constraint parameters with types. Package diagram renders nested folder-style hierarchy.
+
 **v0.27.0:** General View (GV), Package View, and three GridView specializations (Tabular View, Data Value Tabular View, Relationship Matrix View) with PlantUML, Markdown, and HTML output. 108 PlantUML tests. All 68+ `NotImplementedError` stubs in `grammar/classes.py` replaced with graceful handling.
 
 **v0.26.0:** Action Flow View, Interconnection View, and State Transition View with auto-include of connected elements. Grammar-level flow scanning. 101 PlantUML tests.
@@ -448,10 +450,42 @@ from sysmlpy.plantuml import as_package_view
 print(as_package_view(model, style="bw"))
 ```
 
+#### Package Diagram View — `as_package_diagram_view()`
+Folder-style package hierarchy with elements nested inside their containing packages. Shows containment structure clearly with color-coded element types.
+
+```python
+from sysmlpy.plantuml import as_package_diagram_view
+print(as_package_diagram_view(model, style="bw"))
+```
+
+#### Block Definition Diagram (BDD) — `as_block_definition_view()`
+Corresponds to SysML v2 Block Definition Diagrams. Shows block definitions with compartments for attributes, ports, and part references. Displays generalization relationships.
+
+```python
+from sysmlpy.plantuml import as_block_definition_view
+print(as_block_definition_view(model, style="bw"))
+```
+
+#### Internal Block Diagram (IBD) — `as_internal_block_diagram()`
+Corresponds to SysML v2 Internal Block Diagrams. Shows a single block's internal structure with boundary ports, nested parts, and flow/connection arrows between endpoints.
+
+```python
+from sysmlpy.plantuml import as_internal_block_diagram
+print(as_internal_block_diagram(model, style="bw"))
+```
+
+#### Parametric Diagram — `as_parametric_view()`
+Shows constraint definitions with parameter compartments (including types like `Real`). Supports constraint usages and parameter bindings.
+
+```python
+from sysmlpy.plantuml import as_parametric_view
+print(as_parametric_view(model, style="bw"))
+```
+
 #### Action Flow View (AFV) — `as_action_flow_view()`
 Corresponds to SysML v2 ``ActionFlowView`` (short name ``afv``). Shows actions with their control and object flows. Auto-includes connected flow elements.
 
-![Action Flow View](docs/plantuml-examples/09-action-flow-view.png)
+![Action Flow View](docs/plantuml-examples/13-action-flow-view.png)
 
 ```python
 from sysmlpy.plantuml import as_action_flow_view
@@ -471,7 +505,7 @@ print(as_interconnection_view(model, style="bw"))
 #### State Transition View (STV) — `as_state_transition_view()`
 Corresponds to SysML v2 ``StateTransitionView`` (short name ``stv``). State machine diagram with hierarchical states and transitions. Auto-includes connected transition elements.
 
-![State Transition View](docs/plantuml-examples/10-state-transition-view.png)
+![State Transition View](docs/plantuml-examples/14-state-transition-view.png)
 
 ```python
 from sysmlpy.plantuml import as_state_transition_view
@@ -481,19 +515,17 @@ print(as_state_transition_view(model, style="bw"))
 #### Tree Diagram — `as_tree_diagram()`
 Hierarchical containment tree using nested PlantUML containers. Shows ownership hierarchy with sharp corners for definitions and rounded corners for usages.
 
-![Tree Diagram](docs/plantuml-examples/11-tree-diagram.png)
+![Tree Diagram](docs/plantuml-examples/15-tree-diagram.png)
 
 ```python
 from sysmlpy.plantuml import as_tree_diagram
 print(as_tree_diagram(model, style="bw"))
 ```
 
-### Tabular View Rendering Functions
-
 #### Element Table — `as_element_table()`
 A simple tabular listing with columns Name, Type, Kind, and Parent.
 
-![Element Table](docs/plantuml-examples/12-element-table.png)
+![Element Table](docs/plantuml-examples/16-element-table.png)
 
 ```python
 from sysmlpy.plantuml import as_element_table
@@ -503,7 +535,7 @@ print(as_element_table(model, style="bw"))
 #### Textual Notation — `as_textual_notation()`
 Indented text representation inside a PlantUML note, similar to the SysML v2 textual concrete syntax.
 
-![Textual Notation](docs/plantuml-examples/13-textual-notation.png)
+![Textual Notation](docs/plantuml-examples/17-textual-notation.png)
 
 ```python
 from sysmlpy.plantuml import as_textual_notation
@@ -514,20 +546,22 @@ print(as_textual_notation(model, style="bw"))
 
 Per the SysML v2 standard, ``GridView`` (short name ``grv``) presents exposed model elements and their relationships in a rectangular grid. It has three specializations, all supporting **three output formats**:
 
-| Format | Use case |
-|--------|----------|
-| `"plantuml"` (default) | PlantUML table / salt matrix — embed in diagrams |
-| `"markdown"` | Standard pipe table — for GitHub, MkDocs, or Jupyter |
-| `"html"` | Rich `<table>` with CSS classes — for web dashboards |
+| Format | Use case | Compatibility |
+|--------|----------|---------------|
+| `"markdown"` (default) | Standard pipe table — for GitHub, MkDocs, or Jupyter | ✅ Universal |
+| `"html"` | Rich `<table>` with CSS classes — for web dashboards | ✅ Universal |
+| `"plantuml"` | PlantUML table / salt matrix — embed in diagrams | ⚠️ PlantUML <1.2024.7 only |
+
+**Note:** PlantUML 1.2024.7+ removed support for legacy table syntax. Use `"markdown"` or `"html"` output format for compatibility with all PlantUML versions.
 
 #### Tabular View — `as_tabular_view()`
 Extensible table with configurable columns. Default columns: Name, Type, Kind, Parent, Typed By, Specializes.
 
-![Tabular View (BW)](docs/plantuml-examples/14-tabular-view.png)
+See [`18-tabular-view.md`](docs/plantuml-examples/18-tabular-view.md) for example output.
 
 ```python
 from sysmlpy.plantuml import as_tabular_view
-print(as_tabular_view(model, output_format="markdown"))
+print(as_tabular_view(model))  # Default: markdown output
 ```
 
 Custom columns and other output formats:
@@ -538,18 +572,18 @@ print(as_tabular_view(model,
     columns=["Name", "Type", "Parent", "Typed By"],
     output_format="html"))
 
-# Markdown for documentation
+# Markdown for documentation (default)
 print(as_tabular_view(model, output_format="markdown"))
 ```
 
 #### Data Value Tabular View — `as_data_value_tabular_view()`
 Attribute-specific version showing Element, Attribute, Value, Unit, and Type columns. Uses `Attribute.get_value()` for pint.Quantity extraction.
 
-![Data Value View](docs/plantuml-examples/15-data-value-view.png)
+See [`19-data-value-view.md`](docs/plantuml-examples/19-data-value-view.md) for example output.
 
 ```python
 from sysmlpy.plantuml import as_data_value_tabular_view
-print(as_data_value_tabular_view(model, output_format="html"))
+print(as_data_value_tabular_view(model))  # Default: markdown output
 ```
 
 #### Relationship Matrix View — `as_relationship_matrix_view()`
@@ -560,11 +594,11 @@ Pairwise element×element matrix showing relationship types:
 - **G** = Specialization (generalization)
 - **B** = Binding, **F** = Flow, **R** = Redefinition, etc.
 
-![Relationship Matrix](docs/plantuml-examples/16-relationship-matrix.png)
+See [`20-relationship-matrix.md`](docs/plantuml-examples/20-relationship-matrix.md) for example output.
 
 ```python
 from sysmlpy.plantuml import as_relationship_matrix_view
-print(as_relationship_matrix_view(model, output_format="markdown"))
+print(as_relationship_matrix_view(model))  # Default: markdown output
 ```
 
 Type filtering and HTML output:
@@ -581,14 +615,14 @@ All rendering functions accept `style="color"` for colored output with CSS-style
 
 ```python
 from sysmlpy.plantuml import as_tabular_view
-print(as_tabular_view(model, style="color"))
+print(as_tabular_view(model, output_format="html", style="color"))
 ```
 
-![Tabular View (Color)](docs/plantuml-examples/17-tabular-view-color.png)
+See [`21-tabular-view-color.html`](docs/plantuml-examples/21-tabular-view-color.html) for example output.
 
 ### Complete Example Gallery
 
-See [`docs/plantuml-examples/`](docs/plantuml-examples/) for all 16 rendered example images, covering every view function.
+See [`docs/plantuml-examples/`](docs/plantuml-examples/) for all rendered example images, covering every view function.
 
 | # | Example | View Type |
 |---|---------|-----------|
@@ -600,15 +634,19 @@ See [`docs/plantuml-examples/`](docs/plantuml-examples/) for all 16 rendered exa
 | 6 | Interconnection | Interconnection View |
 | 7 | General View (GV) | General View |
 | 8 | Package View | Package View |
-| 9 | Action Flow View (AFV) | Action Flow View |
-| 10 | State Transition View (STV) | State Transition View |
-| 11 | Tree Diagram | Tree Diagram |
-| 12 | Element Table | Element Table |
-| 13 | Textual Notation | Textual Notation |
-| 14 | Tabular View (GridView) | Tabular View |
-| 15 | Data Value Tabular View (GridView) | Data Value View |
-| 16 | Relationship Matrix (GridView) | Relationship Matrix |
-| 17 | Tabular View — Color | Tabular View (color) |
+| 9 | Package Diagram | Package Diagram View |
+| 10 | Block Definition Diagram (BDD) | Block Definition View |
+| 11 | Internal Block Diagram (IBD) | Internal Block Diagram |
+| 12 | Parametric Diagram | Parametric View |
+| 13 | Action Flow View (AFV) | Action Flow View |
+| 14 | State Transition View (STV) | State Transition View |
+| 15 | Tree Diagram | Tree Diagram |
+| 16 | Element Table | Element Table |
+| 17 | Textual Notation | Textual Notation |
+| 18 | Tabular View (GridView) | Tabular View |
+| 19 | Data Value Tabular View (GridView) | Data Value View |
+| 20 | Relationship Matrix (GridView) | Relationship Matrix |
+| 21 | Tabular View — Color | Tabular View (color) |
 
 ## Conformance
 

{sysmlpy-0.27.4 → sysmlpy-0.28.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "sysmlpy"
-version = "0.27.4"
+version = "0.28.1"
 description = "SysML v2.0 Parser"
 authors = [
   { name="Jon R. Fox (mycr0ft)", email="jon.fox@drfox.com" },
@@ -114,7 +114,7 @@ build_command = "pip install poetry && poetry build"
 
 [tool.poetry]
 name = "sysmlpy"
-version = "0.27.4"
+version = "0.28.1"
 description = ""
 authors = ["Jon R. Fox (mycr0ft) <jon.fox@drfox.com>"]
 readme = "README.md"

{sysmlpy-0.27.4 → sysmlpy-0.28.1}/src/sysmlpy/__init__.py

@@ -14,12 +14,13 @@ __all__ = [
     "Store", "InMemoryStore", "NetworkXStore", "KuzuStore", "CayleyStore", "create_store", "new_id",
     "to_plantuml", "PlantUMLGenerator",
     "as_action_flow_view", "as_interconnection_view", "as_state_transition_view",
-    "as_general_view", "as_package_view", "as_requirement_view",
+    "as_general_view", "as_package_view", "as_package_diagram_view", "as_block_definition_view", "as_internal_block_diagram",
+    "as_parametric_view", "as_requirement_view",
     "as_tabular_view", "as_data_value_tabular_view", "as_relationship_matrix_view",
     "analyze", "SemanticIssue", "SemanticAnalyzer",
 ]
 __author__ = "Jon Fox"
-__version__ = "0.27.4"
+__version__ = "0.28.1"
 
 from sysmlpy.usage import (
     Item, Attribute, Part, Port, Action, Reference, UseCase, Requirement, Interface, Message,
@@ -232,7 +233,8 @@ def load_antlr(fp):
 
 from sysmlpy.plantuml import (to_plantuml, PlantUMLGenerator,
     as_action_flow_view, as_interconnection_view, as_state_transition_view,
-    as_general_view, as_package_view, as_requirement_view,
+    as_general_view, as_package_view, as_package_diagram_view, as_block_definition_view, as_internal_block_diagram,
+    as_parametric_view, as_requirement_view,
     as_tabular_view, as_data_value_tabular_view, as_relationship_matrix_view)
 
 from sysmlpy.semantic import analyze, SemanticIssue, SemanticAnalyzer

{sysmlpy-0.27.4 → sysmlpy-0.28.1}/src/sysmlpy/antlr_visitor.py

@@ -245,10 +245,138 @@ def _visit_comment_dict(ctx):
     }
 
 
+def _visit_textual_representation_dict(ctx):
+    """Visit a textualRepresentation context and return a TextualRepresentation dictionary.
+    
+    Grammar: (REP identification?)? LANGUAGE DOUBLE_STRING REGULAR_COMMENT
+    """
+    identification = None
+    if ctx.identification():
+        identification = _build_identification_dict(ctx.identification())
+    
+    language = ""
+    if ctx.DOUBLE_STRING():
+        language = ctx.DOUBLE_STRING().getText().strip('"')
+    
+    body = ""
+    if ctx.REGULAR_COMMENT():
+        body = ctx.REGULAR_COMMENT().getText()
+    
+    return {
+        "name": "TextualRepresentation",
+        "identification": identification,
+        "language": language,
+        "body": body
+    }
+
+
+def _visit_metadata_feature_dict(ctx):
+    """Visit a metadataFeature context and return a MetadataFeature dictionary.
+    
+    Grammar: (prefixMetadataMember)* (AT_SIGN | METADATA) metadataFeatureDeclaration (
+        ABOUT annotation ( COMMA annotation)*
+    )? metadataBody
+    """
+    prefix_members = []
+    for pm in ctx.prefixMetadataMember():
+        prefix_members.append(_visit_prefix_metadata_member_dict(pm))
+    
+    identification = None
+    owned_feature_typing = None
+    if ctx.metadataFeatureDeclaration():
+        mfd = ctx.metadataFeatureDeclaration()
+        if mfd.identification():
+            identification = _build_identification_dict(mfd.identification())
+        if mfd.ownedFeatureTyping():
+            owned_feature_typing = _visit_owned_feature_typing_dict(mfd.ownedFeatureTyping())
+    
+    annotations = []
+    if ctx.ABOUT():
+        for ann_idx in range(len(ctx.annotation())):
+            ann_ctx = ctx.annotation(ann_idx)
+            if ann_ctx and ann_ctx.qualifiedName():
+                qn_text = ann_ctx.qualifiedName().getText()
+                annotations.append({
+                    "name": "Annotation",
+                    "annotatedElement": {
+                        "name": "QualifiedName",
+                        "names": qn_text.split("::")
+                    }
+                })
+    
+    body = ""
+    if ctx.metadataBody() and ctx.metadataBody().SEMI():
+        body = ";"
+    
+    return {
+        "name": "MetadataFeature",
+        "prefixMetadataMember": prefix_members,
+        "identification": identification,
+        "ownedFeatureTyping": owned_feature_typing,
+        "ownedRelationship_about": annotations,
+        "body": body
+    }
+
+
+def _visit_prefix_metadata_member_dict(ctx):
+    """Visit a prefixMetadataMember context."""
+    visibility = ""
+    direction = ""
+    
+    if ctx.PRIVATE():
+        visibility = "private"
+    elif ctx.PROTECTED():
+        visibility = "protected"
+    elif ctx.PUBLIC():
+        visibility = "public"
+    
+    if ctx.IN():
+        direction = "in"
+    elif ctx.OUT():
+        direction = "out"
+    elif ctx.INOUT():
+        direction = "inout"
+    
+    return {
+        "name": "PrefixMetadataMember",
+        "visibility": visibility,
+        "direction": direction
+    }
+
+
+def _visit_owned_feature_typing_dict(ctx):
+    """Visit an ownedFeatureTyping context and return an OwnedFeatureTyping dictionary."""
+    if ctx is None:
+        return None
+    
+    if hasattr(ctx, 'qualifiedName') and ctx.qualifiedName():
+        qns = ctx.qualifiedName()
+        if not isinstance(qns, list):
+            qns = [qns]
+        names = []
+        for qn in qns:
+            if qn:
+                names.append(qn.getText())
+        if names:
+            return {
+                "name": "OwnedFeatureTyping",
+                "type": {
+                    "name": "FeatureType",
+                    "type": {
+                        "name": "QualifiedName",
+                        "names": names
+                    },
+                    "ownedRelatedElement": []
+                },
+                "ownedRelatedElement": []
+            }
+    return None
+
+
 def _visit_annotating_element_dict(annot_elem_ctx):
     """Visit an annotating element context and return an AnnotatingElement dictionary.
     
-    Dispatches to documentation or comment based on the context.
+    Dispatches to documentation, comment, textualRepresentation, or metadataFeature.
     """
     if annot_elem_ctx is None:
         return None
@@ -258,6 +386,10 @@ def _visit_annotating_element_dict(annot_elem_ctx):
         inner = _visit_documentation_dict(annot_elem_ctx.documentation())
     elif hasattr(annot_elem_ctx, 'comment') and annot_elem_ctx.comment():
         inner = _visit_comment_dict(annot_elem_ctx.comment())
+    elif hasattr(annot_elem_ctx, 'textualRepresentation') and annot_elem_ctx.textualRepresentation():
+        inner = _visit_textual_representation_dict(annot_elem_ctx.textualRepresentation())
+    elif hasattr(annot_elem_ctx, 'metadataFeature') and annot_elem_ctx.metadataFeature():
+        inner = _visit_metadata_feature_dict(annot_elem_ctx.metadataFeature())
     
     if inner is None:
         return None