@blockml/parser 0.9.4 → 0.9.5

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

@@ -1,12 +1,6 @@
-<!--
-  Parser Documentation — ScopeExclusions
-  FQN: org.blockml.bml.compiler.parser.documentation.ScopeExclusions
--->
-<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
-                      "
+<!--Parser Documentation — ScopeExclusions
+  FQN: org.blockml.bml.compiler.parser.documentation.ScopeExclusions-->
+<pardocumentation:ScopeExclusions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -30,13 +24,15 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ScopeExclusions</name>
-  <type>pardocumentation:ScopeExclusions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Explicit out-of-scope for the parser package</is>
-
-  <documentation>Out of scope for @blockml/parser:
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Explicit out-of-scope for the parser package
+  </is>
+  <documentation>
+    Out of scope for @blockml/parser:
+    
     • BOM → BML emit — @blockml/serializer
     • Semantic validation — @blockml/validator
     • TypeRegistry bootstrap / cross-file resolve — @blockml/cli + @blockml/framework
@@ -44,11 +40,10 @@
     • Render target output — @blockml/compiler
     • parseFile, async, streaming — deferred API
     • Meta-driven mapping from Definition blocks — V2
-
-    In scope: single-file BML XML → lossless BomDocument.</documentation>
-
+    
+    In scope: single-file BML XML → lossless BomDocument.
+  </documentation>
   <references>
     <see type="pardocumentation:Introduction" relation="SeeAlso" />
   </references>
-
-</block>
+</pardocumentation:ScopeExclusions>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser Documentation — SingleFileScope
-  FQN: org.blockml.bml.compiler.parser.documentation.SingleFileScope
--->
-<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
-                      "
+<!--Parser Documentation — SingleFileScope
+  FQN: org.blockml.bml.compiler.parser.documentation.SingleFileScope-->
+<pardocumentation:SingleFileScope xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -30,23 +24,24 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>SingleFileScope</name>
-  <type>pardocumentation:SingleFileScope</type>
-  <baseType>core:Documentation</baseType>
-  <is>One BomDocument per parse(); external refs as strings (B5)</is>
-
-  <documentation>parse() produces exactly one BomDocument per invocation.
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    One BomDocument per parse(); external refs as strings (B5)
+  </is>
+  <documentation>
+    parse() produces exactly one BomDocument per invocation.
+    
     Cross-file references stored in authored form:
     • type/baseType FQNs as resolved strings
     • Preset refs as FQN::id strings (unmerged)
     • bml:version on instances — no registry lookup at parse time
-
+    
     TypeRegistry bootstrap, effective member resolution, cross-file validation →
-    @blockml/cli orchestrator + @blockml/framework utilities + @blockml/validator.</documentation>
-
+    @blockml/cli orchestrator + @blockml/framework utilities + @blockml/validator.
+  </documentation>
   <references>
     <see type="pardocumentation:DesignDecisions" relation="ReadNext" />
   </references>
-
-</block>
+</pardocumentation:SingleFileScope>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser Documentation — StructuralGrammar
-  FQN: org.blockml.bml.compiler.parser.documentation.StructuralGrammar
--->
-<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
-                      "
+<!--Parser Documentation — StructuralGrammar
+  FQN: org.blockml.bml.compiler.parser.documentation.StructuralGrammar-->
+<pardocumentation:StructuralGrammar xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -30,38 +24,39 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>StructuralGrammar</name>
-  <type>pardocumentation:StructuralGrammar</type>
-  <baseType>core:Documentation</baseType>
-  <is>Closed root vocabulary and preserve-on-error for structural BML errors</is>
-
-  <documentation>A document is valid BlockML if it is well-formed XML, structurally conforms
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Closed root vocabulary and preserve-on-error for structural BML errors
+  </is>
+  <documentation>
+    A document is valid BlockML if it is well-formed XML, structurally conforms
     to the BlockML definitions, and passes semantic validation against a complete registry.
     XSD is not part of this definition.
-
+    
     Error classes: XML Syntax Error (malformed XML; document may be null);
     Structural BML Error (unknown Gerüst tag/attribute/directive — this package);
     Semantic BML Error (unknown type/member/library — @blockml/validator).
-
+    
     Root children are closed: only identity and container names from the effective
     Block / document grammar (name, type, baseType, properties, aggregations, …).
     Direct aggregations at root are not allowed. User content lives only inside
     predefined containers and members.
-
+    
     Preserve-on-error: invalid authored constructs that can be represented are stored
     as unknownElements / unknownAttributes residuals. Diagnostics MUST NOT require
     destructive recovery. An error invalidates validity, not the whole BOM.
-
+    
     Definition/grammar nodes: unknown children/attributes → BML_UNKNOWN_ELEMENT /
     BML_UNKNOWN_ATTRIBUTE. Unknown bml:* → BML_UNKNOWN_DIRECTIVE.
     Non-whitespace text on element-only grammar nodes → BML_UNEXPECTED_TEXT.
     Formatting whitespace is ignored (B13). Character-data hosts keep text
     (name, is, documentation, value, property host text, …).
-    Block instances: extra attributes stay in memberValues for semantic checking.</documentation>
-
+    Block instances: extra attributes stay in memberValues for semantic checking.
+  </documentation>
   <references>
     <see type="pardocumentation:XmlCommentsParse" relation="ReadNext" />
     <see type="valdocumentation:ValidityContract" relation="SeeAlso" />
   </references>
-
-</block>
+</pardocumentation:StructuralGrammar>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser Documentation — TypeDescriptorParsing
-  FQN: org.blockml.bml.compiler.parser.documentation.TypeDescriptorParsing
--->
-<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
-                      "
+<!--Parser Documentation — TypeDescriptorParsing
+  FQN: org.blockml.bml.compiler.parser.documentation.TypeDescriptorParsing-->
+<pardocumentation:TypeDescriptorParsing xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -30,24 +24,25 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>TypeDescriptorParsing</name>
-  <type>pardocumentation:TypeDescriptorParsing</type>
-  <baseType>core:Documentation</baseType>
-  <is>TypeExpression parsing at map time</is>
-
-  <documentation>Parse type attribute strings into BOM TypeExpression shapes (defined in @blockml/bom).
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    TypeExpression parsing at map time
+  </is>
+  <documentation>
+    Parse type attribute strings into BOM TypeExpression shapes (defined in @blockml/bom).
+    
     • Named type refs → resolved FQN via namespace bindings + implicit namespaces
     • Union (A | B), struct ({ a: T }), multiplicity, nested (T[])[], generics (including unions as arguments), self refs
     • Ungrouped stacked multiplicity Integer[][] → BML_INVALID_TYPE_REFERENCE
     • Boolean.True/Boolean.False preserved as type refs (B16) — not rewritten to literals
     • Boolean values normalized to lowercase (B15)
     • Failure → BML_UNKNOWN_TYPE
-    • Anonymous struct at specialized sites; context-bound implicit namespaces per 02_mbml.md</documentation>
-
+    • Anonymous struct at specialized sites; context-bound implicit namespaces per 02_mbml.md
+  </documentation>
   <references>
     <see type="parcap:ParseTypeExpression" relation="Defines" />
     <see type="pardocumentation:BlockMetadataMapping" relation="ReadNext" />
   </references>
-
-</block>
+</pardocumentation:TypeDescriptorParsing>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser Documentation — V1Scope
-  FQN: org.blockml.bml.compiler.parser.documentation.V1Scope
--->
-<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
-                      "
+<!--Parser Documentation — V1Scope
+  FQN: org.blockml.bml.compiler.parser.documentation.V1Scope-->
+<pardocumentation:V1Scope xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -30,24 +24,27 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>V1Scope</name>
-  <type>pardocumentation:V1Scope</type>
-  <baseType>core:Documentation</baseType>
-  <is>Phase A parser slice and deferred features</is>
-
-  <documentation><![CDATA[V1 (Phase A) parser implements:
-    • Hardcoded BML → BOM mapper for <block> root documents
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Phase A parser slice and deferred features
+  </is>
+  <documentation>
+    <![CDATA[
+    V1 (Phase A) parser implements:
+    • Hardcoded BML → BOM mapper for document roots (<block> or type tag; doc:DocumentFormat)
     • 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)
     • JSON BML authoring not planned (B6)
     • 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 type="pardocumentation:SingleFileScope" relation="SeeAlso" />
   </references>
-
-</block>
+</pardocumentation:V1Scope>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser Documentation — XmlCommentsParse
-  FQN: org.blockml.bml.compiler.parser.documentation.XmlCommentsParse
--->
-<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
-                      "
+<!--Parser Documentation — XmlCommentsParse
+  FQN: org.blockml.bml.compiler.parser.documentation.XmlCommentsParse-->
+<pardocumentation:XmlCommentsParse xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -30,24 +24,27 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>XmlCommentsParse</name>
-  <type>pardocumentation:XmlCommentsParse</type>
-  <baseType>core:Documentation</baseType>
-  <is>Comment binding algorithm (B11 parse side)</is>
-
-  <documentation><![CDATA[Cross-ref: org.blockml.bml.bom.documentation.XmlComments for Urmodell storage model.
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Comment binding algorithm (B11 parse side)
+  </is>
+  <documentation>
+    <![CDATA[
+    Cross-ref: org.blockml.bml.bom.documentation.XmlComments for Urmodell storage model.
+    
     Parse algorithm:
     • pendingLeading comments → bind to next element as leadingComments
     • Comments after element end tag → trailingComments on that element
     • 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 type="pardocumentation:TypeDescriptorParsing" relation="ReadNext" />
   </references>
-
-</block>
+</pardocumentation:XmlCommentsParse>

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

@@ -1,12 +1,6 @@
-<!--
-  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
-                      "
+<!--Parser — BmlMeta
+  FQN: org.blockml.bml.compiler.parser.map.BmlMeta-->
+<parmap:BmlMeta xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,26 +23,35 @@
   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>
-
+  <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>
+      <documentation>
+        id. TS type: bomvalue:MemberValue. (optional)
+      </documentation>
     </id>
     <version type="bomvalue:MemberValue">
-      <documentation>version. TS type: bomvalue:MemberValue. (optional)</documentation>
+      <documentation>
+        version. TS type: bomvalue:MemberValue. (optional)
+      </documentation>
     </version>
     <bean type="bomvalue:MemberValue">
-      <documentation>bean. TS type: bomvalue:MemberValue. (optional)</documentation>
+      <documentation>
+        bean. TS type: bomvalue:MemberValue. (optional)
+      </documentation>
     </bean>
     <scope type="type:Text">
-      <documentation>scope. TS type: type:Text. (optional)</documentation>
+      <documentation>
+        scope. TS type: type:Text. (optional)
+      </documentation>
     </scope>
   </properties>
-
-</block>
+</parmap:BmlMeta>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser — CharacterData
-  FQN: org.blockml.bml.compiler.parser.map.CharacterData
--->
-<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
-                      "
+<!--Parser — CharacterData
+  FQN: org.blockml.bml.compiler.parser.map.CharacterData-->
+<parmap:CharacterData xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,20 +23,25 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>CharacterData</name>
-  <type>parmap:CharacterData</type>
-  <baseType>parser:ParserType</baseType>
-  <is>Trimmed element character data and authored form</is>
-
-  <documentation>BML type gap: stands for TypeScript { text: string; form: "text" | "cdata" } from getCharacterData() (packages/parser/src/util/xml.ts).</documentation>
-
+  <baseType>
+    parser:ParserType
+  </baseType>
+  <is>
+    Trimmed element character data and authored form
+  </is>
+  <documentation>
+    BML type gap: stands for TypeScript { text: string; form: "text" | "cdata" } from getCharacterData() (packages/parser/src/util/xml.ts).
+  </documentation>
   <properties>
     <text type="type:Text">
-      <documentation>text. TS type: type:Text. (required)</documentation>
+      <documentation>
+        text. TS type: type:Text. (required)
+      </documentation>
     </text>
     <form type="bomcommon:CharacterDataForm">
-      <documentation>form. TS type: bomcommon:CharacterDataForm. (required)</documentation>
+      <documentation>
+        form. TS type: bomcommon:CharacterDataForm. (required)
+      </documentation>
     </form>
   </properties>
-
-</block>
+</parmap:CharacterData>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser — MapContext
-  FQN: org.blockml.bml.compiler.parser.map.MapContext
--->
-<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
-                      "
+<!--Parser — MapContext
+  FQN: org.blockml.bml.compiler.parser.map.MapContext-->
+<parmap:MapContext xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,41 +23,60 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>MapContext</name>
-  <type>parmap:MapContext</type>
-  <baseType>parser:ParserType</baseType>
-  <is>Per-parse mapping configuration and namespace context</is>
-
-  <documentation>Created by createMapContext(). Passed through map/* modules during step [5].</documentation>
-
+  <baseType>
+    parser:ParserType
+  </baseType>
+  <is>
+    Per-parse mapping configuration and namespace context
+  </is>
+  <documentation>
+    Created by createMapContext(). Passed through map/* modules during step [5].
+  </documentation>
   <properties>
     <filePath type="type:Text">
-      <documentation>filePath. TS type: type:Text. (required)</documentation>
+      <documentation>
+        filePath. TS type: type:Text. (required)
+      </documentation>
     </filePath>
     <source type="type:Text">
-      <documentation>Original source string. (required)</documentation>
+      <documentation>
+        Original source string. (required)
+      </documentation>
     </source>
     <bindings type="type:Text">
-      <documentation>Record&lt;string, string> namespace bindings. (required)</documentation>
+      <documentation>
+        Record&lt;string, string> namespace bindings. (required)
+      </documentation>
     </bindings>
     <subBlockIndex type="type:Text">
-      <documentation>Map&lt;string, string> sub-block lookup. (required)</documentation>
+      <documentation>
+        Map&lt;string, string> sub-block lookup. (required)
+      </documentation>
     </subBlockIndex>
     <parentBlockType type="type:Text">
-      <documentation>Enclosing block type FQN when nested. (optional)</documentation>
+      <documentation>
+        Enclosing block type FQN when nested. (optional)
+      </documentation>
     </parentBlockType>
     <isRoot type="type:Boolean">
-      <documentation>isRoot. TS type: type:Boolean. (required)</documentation>
+      <documentation>
+        isRoot. TS type: type:Boolean. (required)
+      </documentation>
     </isRoot>
     <isEmbedded type="type:Boolean">
-      <documentation>isEmbedded. TS type: type:Boolean. (required)</documentation>
+      <documentation>
+        isEmbedded. TS type: type:Boolean. (required)
+      </documentation>
     </isEmbedded>
     <diagnostics type="bomcommon:Diagnostic[]">
-      <documentation>Shared map-time diagnostics; structural errors append here without aborting. (required)</documentation>
+      <documentation>
+        Shared map-time diagnostics; structural errors append here without aborting. (required)
+      </documentation>
     </diagnostics>
     <parseValue type="type:Text">
-      <documentation>Optional host parseValue hook from ParseOptions. (optional)</documentation>
+      <documentation>
+        Optional host parseValue hook from ParseOptions. (optional)
+      </documentation>
     </parseValue>
   </properties>
-
-</block>
+</parmap:MapContext>

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

@@ -1,12 +1,6 @@
-<!--
-  Parser — MapContextOptions
-  FQN: org.blockml.bml.compiler.parser.map.MapContextOptions
--->
-<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
-                      "
+<!--Parser — MapContextOptions
+  FQN: org.blockml.bml.compiler.parser.map.MapContextOptions-->
+<parmap:MapContextOptions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,32 +23,45 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>MapContextOptions</name>
-  <type>parmap:MapContextOptions</type>
-  <baseType>parser:ParserType</baseType>
-  <is>Optional extras when building MapContext</is>
-
-  <documentation>BML type gap: stands for the options argument of createMapContext() (packages/parser/src/map/context.ts).</documentation>
-
+  <baseType>
+    parser:ParserType
+  </baseType>
+  <is>
+    Optional extras when building MapContext
+  </is>
+  <documentation>
+    BML type gap: stands for the options argument of createMapContext() (packages/parser/src/map/context.ts).
+  </documentation>
   <properties>
     <subBlockIndex type="type:Text">
-      <documentation>Map&lt;string, string&gt; sub-block lookup. (optional)</documentation>
+      <documentation>
+        Map&lt;string, string> sub-block lookup. (optional)
+      </documentation>
     </subBlockIndex>
     <parentBlockType type="type:Text">
-      <documentation>Enclosing block type FQN when nested. (optional)</documentation>
+      <documentation>
+        Enclosing block type FQN when nested. (optional)
+      </documentation>
     </parentBlockType>
     <isRoot type="type:Boolean">
-      <documentation>isRoot. TS type: type:Boolean. (optional)</documentation>
+      <documentation>
+        isRoot. TS type: type:Boolean. (optional)
+      </documentation>
     </isRoot>
     <isEmbedded type="type:Boolean">
-      <documentation>isEmbedded. TS type: type:Boolean. (optional)</documentation>
+      <documentation>
+        isEmbedded. TS type: type:Boolean. (optional)
+      </documentation>
     </isEmbedded>
     <diagnostics type="bomcommon:Diagnostic[]">
-      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (optional)</documentation>
+      <documentation>
+        diagnostics. TS type: bomcommon:Diagnostic[]. (optional)
+      </documentation>
     </diagnostics>
     <parseValue type="type:Text">
-      <documentation>Optional host parseValue hook from ParseOptions. (optional)</documentation>
+      <documentation>
+        Optional host parseValue hook from ParseOptions. (optional)
+      </documentation>
     </parseValue>
   </properties>
-
-</block>
+</parmap:MapContextOptions>