@blockml/parser 0.7.1 → 0.8.1

package/blocks/org/blockml/bml/compiler/parser/documentation/Diagnostics.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>Diagnostics</name>
@@ -30,7 +35,7 @@
   <baseType>core:Documentation</baseType>
   <is>Map-time and pipeline diagnostic codes</is>
 
-  <documentation>Pipeline hard-fail codes (parse.ts):
+  <documentation><![CDATA[Pipeline hard-fail codes (parse.ts):
     • BML_UNSUPPORTED_FORMAT — format detect failed
     • BML_MALFORMED_XML — DOM parse error
     • BML_MISSING_ROOT — no document element
@@ -52,11 +57,11 @@
     (attribute value or first occurrence in the throwing element), not the document root.
 
     Host policy: whether to abort after diagnostics is orchestrator decision.
-    Diagnostic type: org.blockml.bml.bom.common.Diagnostic.</documentation>
+    Diagnostic type: org.blockml.bml.bom.common.Diagnostic.]]></documentation>
 
   <references>
-    <see type="parconfig:MapTimeDiagnosticCodes" relation="Defines"></see>
-    <see type="pardocumentation:PackageOwnership" relation="ReadNext"></see>
+    <see type="parconfig:MapTimeDiagnosticCodes" relation="Defines" />
+    <see type="pardocumentation:PackageOwnership" relation="ReadNext" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/ExpressionCapture.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>ExpressionCapture</name>
@@ -34,13 +39,13 @@
     Implementation CDATA → embeddedExpressions[] with source offsets.
 
     Parser step [5] captures raw text only. AST construction via parseExpression()
-    in @blockml/core (Stage 2 utility) — never stored on Urmodell.
+    in @blockml/framework (Stage 2 utility) — never stored on Urmodell.
 
     inputType/outputType on capabilities → TypeExpression at map time (B3).</documentation>
 
   <references>
-    <see type="pardocumentation:SingleFileScope" relation="ReadNext"></see>
-    <see type="parcap:ExpressionFromRaw" relation="SeeAlso"></see>
+    <see type="pardocumentation:SingleFileScope" relation="ReadNext" />
+    <see type="parcap:ExpressionFromRaw" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/Introduction.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>Introduction</name>
@@ -45,8 +50,8 @@
     depend on @blockml/serializer, @blockml/validator, or TypeRegistry bootstrap.</documentation>
 
   <references>
-    <see type="pardocumentation:LayerSeparation" relation="ReadNext"></see>
-    <see type="bomdocumentation:Introduction" relation="SeeAlso"></see>
+    <see type="pardocumentation:LayerSeparation" relation="ReadNext" />
+    <see type="bomdocumentation:Introduction" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/LayerSeparation.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>LayerSeparation</name>
@@ -48,8 +53,8 @@
     Parser stores ExpressionValue.raw only (B4); never writes AST to Urmodell.</documentation>
 
   <references>
-    <see type="pardocumentation:ArchitectureOverview" relation="ReadNext"></see>
-    <see type="bomdocumentation:LayerSeparation" relation="SeeAlso"></see>
+    <see type="pardocumentation:ArchitectureOverview" relation="ReadNext" />
+    <see type="bomdocumentation:LayerSeparation" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/MappingPrinciples.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>MappingPrinciples</name>
@@ -41,8 +46,8 @@
     block rendering. Maximum authored surface: store as much as Urmodell can carry.</documentation>
 
   <references>
-    <see type="pardocumentation:MemberMappingOrder" relation="ReadNext"></see>
-    <see type="bomdocumentation:AbstractionPrinciple" relation="SeeAlso"></see>
+    <see type="pardocumentation:MemberMappingOrder" relation="ReadNext" />
+    <see type="bomdocumentation:AbstractionPrinciple" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/MemberMapping.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>MemberMapping</name>
@@ -30,7 +35,7 @@
   <baseType>core:Documentation</baseType>
   <is>Member definition and composition mapping</is>
 
-  <documentation>Property/aggregation/association/capability members:
+  <documentation><![CDATA[Property/aggregation/association/capability members:
     • Element QName = member identity (deprecated namespace= attr → error)
     • type attribute → TypeExpression; value/memberValues for properties
     • One <composition> per aggregation member, as a direct child of that member
@@ -41,11 +46,11 @@
     • Sub-Blocks and embedded blocks → nested BlockDefinition trees
     • Redundant aggregation type on override → validator warning B19; parser must not apply
 
-    Directives on composition: bml:each, bml:if, bml:unless, bml:with — stored unexpanded.</documentation>
+    Directives on composition: bml:each, bml:if, bml:unless, bml:with — stored unexpanded.]]></documentation>
 
   <references>
-    <see type="pardocumentation:ExpressionCapture" relation="ReadNext"></see>
-    <see type="parcap:MapBlockInstanceNode" relation="SeeAlso"></see>
+    <see type="pardocumentation:ExpressionCapture" relation="ReadNext" />
+    <see type="parcap:MapBlockInstanceNode" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/MemberMappingOrder.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>MemberMappingOrder</name>
@@ -40,7 +45,7 @@
     Inside containers (properties/aggregations/…): filter by kind, keep BOM array order.</documentation>
 
   <references>
-    <see type="pardocumentation:AttributeClassification" relation="ReadNext"></see>
+    <see type="pardocumentation:AttributeClassification" relation="ReadNext" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/PackageOwnership.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>PackageOwnership</name>
@@ -43,8 +48,8 @@
     @blockml/cli — TypeRegistry bootstrap and orchestration.</documentation>
 
   <references>
-    <see type="pardocumentation:ScopeExclusions" relation="ReadNext"></see>
-    <see type="bomdocumentation:PackageOwnership" relation="SeeAlso"></see>
+    <see type="pardocumentation:ScopeExclusions" relation="ReadNext" />
+    <see type="bomdocumentation:PackageOwnership" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/PublicApi.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>PublicApi</name>
@@ -30,7 +35,7 @@
   <baseType>core:Documentation</baseType>
   <is>parse() entry point (B26)</is>
 
-  <documentation>parse(source: string, options?: ParseOptions): ParseResult
+  <documentation><![CDATA[parse(source: string, options?: ParseOptions): ParseResult
 
     ParseOptions (owned by @blockml/bom):
     • filePath — default "<memory>"; written to BomDocument.source.filePath
@@ -48,13 +53,13 @@
       carries a span; otherwise BML_MAP_ERROR at 1:1. continueOnError still returns
       document when possible
     • Sync only; no throw on recoverable errors
-    • Does NOT call validator; does NOT expand directives</documentation>
+    • Does NOT call validator; does NOT expand directives]]></documentation>
 
   <references>
-    <see type="bomapi:ParseOptions" relation="Defines"></see>
-    <see type="bomapi:ParseResult" relation="Defines"></see>
-    <see type="parcap:Parse" relation="Defines"></see>
-    <see type="pardocumentation:MappingPrinciples" relation="ReadNext"></see>
+    <see type="bomapi:ParseOptions" relation="Defines" />
+    <see type="bomapi:ParseResult" relation="Defines" />
+    <see type="parcap:Parse" relation="Defines" />
+    <see type="pardocumentation:MappingPrinciples" relation="ReadNext" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/RoundtripContract.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>RoundtripContract</name>
@@ -42,9 +47,9 @@
     XML byte fidelity NOT a gate — see @blockml/serializer RoundtripContract.</documentation>
 
   <references>
-    <see type="bomcap:BomEquals" relation="SeeAlso"></see>
-    <see type="serdocumentation:RoundtripContract" relation="SeeAlso"></see>
-    <see type="pardocumentation:Diagnostics" relation="ReadNext"></see>
+    <see type="bomcap:BomEquals" relation="SeeAlso" />
+    <see type="serdocumentation:RoundtripContract" relation="SeeAlso" />
+    <see type="pardocumentation:Diagnostics" relation="ReadNext" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/ScopeExclusions.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>ScopeExclusions</name>
@@ -43,7 +48,7 @@
     In scope: single-file BML XML → lossless BomDocument.</documentation>
 
   <references>
-    <see type="pardocumentation:Introduction" relation="SeeAlso"></see>
+    <see type="pardocumentation:Introduction" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/SingleFileScope.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>SingleFileScope</name>
@@ -38,10 +43,10 @@
     • bml:version on instances — no registry lookup at parse time
 
     TypeRegistry bootstrap, effective member resolution, cross-file validation →
-    @blockml/cli orchestrator + @blockml/core utilities + @blockml/validator.</documentation>
+    @blockml/cli orchestrator + @blockml/framework utilities + @blockml/validator.</documentation>
 
   <references>
-    <see type="pardocumentation:DesignDecisions" relation="ReadNext"></see>
+    <see type="pardocumentation:DesignDecisions" relation="ReadNext" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/StructuralGrammar.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,8 +24,11 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
-  xmlns:doc="org.blockml.bml.documentation"
-  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
+  xmlns:doc="org.blockml.bml.documentation">
 
   <name>StructuralGrammar</name>
   <type>pardocumentation:StructuralGrammar</type>
@@ -56,8 +60,8 @@
     Block instances: extra attributes stay in memberValues for semantic checking.</documentation>
 
   <references>
-    <see type="pardocumentation:AttributeClassification" relation="SeeAlso"></see>
-    <see type="valdocumentation:ValidityContract" relation="SeeAlso"></see>
+    <see type="pardocumentation:XmlCommentsParse" relation="ReadNext" />
+    <see type="valdocumentation:ValidityContract" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/TypeDescriptorParsing.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>TypeDescriptorParsing</name>
@@ -41,8 +46,8 @@
     • Anonymous struct at specialized sites; context-bound implicit namespaces per 02_mbml.md</documentation>
 
   <references>
-    <see type="parcap:ParseTypeExpression" relation="Defines"></see>
-    <see type="pardocumentation:BlockMetadataMapping" relation="ReadNext"></see>
+    <see type="parcap:ParseTypeExpression" relation="Defines" />
+    <see type="pardocumentation:BlockMetadataMapping" relation="ReadNext" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/V1Scope.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>V1Scope</name>
@@ -30,7 +35,7 @@
   <baseType>core:Documentation</baseType>
   <is>Phase A parser slice and deferred features</is>
 
-  <documentation>V1 (Phase A) parser implements:
+  <documentation><![CDATA[V1 (Phase A) parser implements:
     • Hardcoded BML → BOM mapper for <block> root documents
     • Single-file scope (B5) — no TypeRegistry bootstrap in parse()
     • Stage 1 structural BML validation (unknown Gerüst tags/attributes/directives); no TypeRegistry semantic checks (B8: XSD not Stage 1)
@@ -38,11 +43,11 @@
     • Tolerant parse by default (continueOnError: true)
 
     Deferred: cross-file resolution, parseFile/async, streaming, parse({ validate: true }),
-    meta-driven mapping from Definition blocks (V2).</documentation>
+    meta-driven mapping from Definition blocks (V2).]]></documentation>
 
   <references>
-    <see type="pardocumentation:PublicApi" relation="ReadNext"></see>
-    <see type="pardocumentation:SingleFileScope" relation="SeeAlso"></see>
+    <see type="pardocumentation:PublicApi" relation="ReadNext" />
+    <see type="pardocumentation:SingleFileScope" relation="SeeAlso" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/documentation/XmlCommentsParse.bml

@@ -15,6 +15,7 @@
   xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
   xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
   xmlns:core="org.blockml.bml.core"
   xmlns:def="org.blockml.bml.definition"
   xmlns:parser="org.blockml.bml.compiler.parser"
@@ -23,6 +24,10 @@
   xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
   xmlns:parmap="org.blockml.bml.compiler.parser.map"
   xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
   <name>XmlCommentsParse</name>
@@ -30,7 +35,7 @@
   <baseType>core:Documentation</baseType>
   <is>Comment binding algorithm (B11 parse side)</is>
 
-  <documentation>Cross-ref: org.blockml.bml.bom.documentation.XmlComments for Urmodell storage model.
+  <documentation><![CDATA[Cross-ref: org.blockml.bml.bom.documentation.XmlComments for Urmodell storage model.
 
     Parse algorithm:
     • pendingLeading comments → bind to next element as leadingComments
@@ -38,11 +43,11 @@
     • Storage: xmlTrivia on elements, memberSectionTrivia, metadataTrivia
 
     Comment bodies only — without <!-- / -->. Whitespace/layout not stored (B13).
-    Re-emit rules (B22) → @blockml/serializer.</documentation>
+    Re-emit rules (B22) → @blockml/serializer.]]></documentation>
 
   <references>
-    <see type="bomdocumentation:XmlComments" relation="SeeAlso"></see>
-    <see type="pardocumentation:TypeDescriptorParsing" relation="ReadNext"></see>
+    <see type="bomdocumentation:XmlComments" relation="SeeAlso" />
+    <see type="pardocumentation:TypeDescriptorParsing" relation="ReadNext" />
   </references>
 
 </block>

package/blocks/org/blockml/bml/compiler/parser/map/BmlMeta.bml

@@ -0,0 +1,54 @@
+<!--
+  Parser — BmlMeta
+  FQN: org.blockml.bml.compiler.parser.map.BmlMeta
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomtype="org.blockml.bml.bom.type"
+  xmlns:bomvalue="org.blockml.bml.bom.value"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:parcap="org.blockml.bml.compiler.parser.capability"
+  xmlns:parconfig="org.blockml.bml.compiler.parser.config"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:parmap="org.blockml.bml.compiler.parser.map"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bomcap="org.blockml.bml.bom.capability"
+  xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
+
+  <name>BmlMeta</name>
+  <type>parmap:BmlMeta</type>
+  <baseType>parser:ParserType</baseType>
+  <is>Parsed bml:id/version/bean/scope on a BlockInstance</is>
+
+  <documentation>BML type gap: stands for the object returned by parseBmlMeta() (packages/parser/src/map/directives.ts).</documentation>
+
+  <properties>
+    <id type="bomvalue:MemberValue">
+      <documentation>id. TS type: bomvalue:MemberValue. (optional)</documentation>
+    </id>
+    <version type="bomvalue:MemberValue">
+      <documentation>version. TS type: bomvalue:MemberValue. (optional)</documentation>
+    </version>
+    <bean type="bomvalue:MemberValue">
+      <documentation>bean. TS type: bomvalue:MemberValue. (optional)</documentation>
+    </bean>
+    <scope type="type:Text">
+      <documentation>scope. TS type: type:Text. (optional)</documentation>
+    </scope>
+  </properties>
+
+</block>