@blockml/parser 0.7.1 → 0.8.0

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>

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>
@@ -33,7 +38,7 @@
   <documentation>parse(source: string, options?: ParseOptions): ParseResult
 
     ParseOptions (owned by @blockml/bom):
-    • filePath — default "<memory>"; written to BomDocument.source.filePath
+    • filePath — default "&lt;memory>"; written to BomDocument.source.filePath
     • continueOnError — default true; keep mapping after errors when possible
 
     ParseResult (owned by @blockml/bom):

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>

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>

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,7 +43,7 @@
     • 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>

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,7 +60,7 @@
     Block instances: extra attributes stay in memberValues for semantic checking.</documentation>
 
   <references>
-    <see type="pardocumentation:AttributeClassification" relation="SeeAlso"></see>
+    <see type="pardocumentation:XmlCommentsParse" relation="ReadNext"></see>
     <see type="valdocumentation:ValidityContract" relation="SeeAlso"></see>
   </references>
 

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>

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>
@@ -31,7 +36,7 @@
   <is>Phase A parser slice and deferred features</is>
 
   <documentation>V1 (Phase A) parser implements:
-    • Hardcoded BML → BOM mapper for <block> root documents
+    • Hardcoded BML → BOM mapper for &lt;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)
     • JSON BML authoring not planned (B6)

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>
@@ -37,7 +42,7 @@
     • Comments after element end tag → trailingComments on that element
     • Storage: xmlTrivia on elements, memberSectionTrivia, metadataTrivia
 
-    Comment bodies only — without <!-- / -->. Whitespace/layout not stored (B13).
+    Comment bodies only — without &lt;!-- / -->. Whitespace/layout not stored (B13).
     Re-emit rules (B22) → @blockml/serializer.</documentation>
 
   <references>

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>

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

@@ -0,0 +1,48 @@
+<!--
+  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
+                      "
+  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>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>
+
+  <properties>
+    <text type="type:Text">
+      <documentation>text. TS type: type:Text. (required)</documentation>
+    </text>
+    <form type="bomcommon:CharacterDataForm">
+      <documentation>form. TS type: bomcommon:CharacterDataForm. (required)</documentation>
+    </form>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/compiler/parser/map/MapContext.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"
@@ -22,7 +23,11 @@
   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: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>MapContext</name>
   <type>parmap:MapContext</type>
@@ -39,10 +44,10 @@
       <documentation>Original source string. (required)</documentation>
     </source>
     <bindings type="type:Text">
-      <documentation>Record<string, string> namespace bindings. (required)</documentation>
+      <documentation>Record&lt;string, string> namespace bindings. (required)</documentation>
     </bindings>
     <subBlockIndex type="type:Text">
-      <documentation>Map<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>

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

@@ -0,0 +1,57 @@
+<!--
+  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
+                      "
+  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>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>
+
+  <properties>
+    <subBlockIndex type="type:Text">
+      <documentation>Map&lt;string, string&gt; sub-block lookup. (optional)</documentation>
+    </subBlockIndex>
+    <parentBlockType type="type:Text">
+      <documentation>Enclosing block type FQN when nested. (optional)</documentation>
+    </parentBlockType>
+    <isRoot type="type:Boolean">
+      <documentation>isRoot. TS type: type:Boolean. (optional)</documentation>
+    </isRoot>
+    <isEmbedded type="type:Boolean">
+      <documentation>isEmbedded. TS type: type:Boolean. (optional)</documentation>
+    </isEmbedded>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (optional)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,48 @@
+<!--
+  Parser — QNameParts
+  FQN: org.blockml.bml.compiler.parser.map.QNameParts
+-->
+<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>QNameParts</name>
+  <type>parmap:QNameParts</type>
+  <baseType>parser:ParserType</baseType>
+  <is>Prefix and local name from a QName split</is>
+
+  <documentation>BML type gap: stands for TypeScript { prefix: string; local: string } from splitQName() (packages/parser/src/util/qname.ts).</documentation>
+
+  <properties>
+    <prefix type="type:Text">
+      <documentation>prefix. TS type: type:Text. (required)</documentation>
+    </prefix>
+    <local type="type:Text">
+      <documentation>local. TS type: type:Text. (required)</documentation>
+    </local>
+  </properties>
+
+</block>

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

@@ -0,0 +1,48 @@
+<!--
+  Parser — VisibilityParse
+  FQN: org.blockml.bml.compiler.parser.map.VisibilityParse
+-->
+<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>VisibilityParse</name>
+  <type>parmap:VisibilityParse</type>
+  <baseType>parser:ParserType</baseType>
+  <is>Logical name plus visibility from a localName prefix</is>
+
+  <documentation>BML type gap: stands for TypeScript { name: string; visibility: string } from parseVisibilityFromName().</documentation>
+
+  <properties>
+    <name type="type:Text">
+      <documentation>name. TS type: type:Text. (required)</documentation>
+    </name>
+    <visibility type="type:Text">
+      <documentation>visibility. TS type: type:Text. (required)</documentation>
+    </visibility>
+  </properties>
+
+</block>

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

@@ -0,0 +1,39 @@
+<!--
+  Parser — XmlDomNode
+  FQN: org.blockml.bml.compiler.parser.map.XmlDomNode
+-->
+<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>XmlDomNode</name>
+  <type>parmap:XmlDomNode</type>
+  <baseType>parser:ParserType</baseType>
+  <is>Host XML DOM node from @xmldom/xmldom</is>
+
+  <documentation>BML type gap: stands for TypeScript Node | Element | Document (@xmldom/xmldom). Core has no DOM ValueType; this is a host-boundary type, not a reconstructed DOM struct.</documentation>
+
+</block>

package/dist/map/type-expression.js

@@ -231,14 +231,6 @@ function parseTypeExpressionInternal(raw, ctx) {
     }
     const { prefix, local } = splitQName(base);
     if (!prefix) {
-        const nested = ctx.subBlockIndex?.get(local);
-        if (nested) {
-            const namedNested = { kind: "named", fqn: nested };
-            if (config) {
-                namedNested.instanceConfiguration = config;
-            }
-            return namedNested;
-        }
         const selfLocal = ctx.currentTypeFqn?.split(".").pop();
         if (ctx.currentTypeFqn && selfLocal === local) {
             const namedSelf = { kind: "named", fqn: ctx.currentTypeFqn };
@@ -247,6 +239,14 @@ function parseTypeExpressionInternal(raw, ctx) {
             }
             return namedSelf;
         }
+        const nested = ctx.subBlockIndex?.get(local);
+        if (nested) {
+            const namedNested = { kind: "named", fqn: nested };
+            if (config) {
+                namedNested.instanceConfiguration = config;
+            }
+            return namedNested;
+        }
     }
     const named = {
         kind: "named",