@blockml/parser 0.7.0 → 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/map-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-block.d.ts","sourceRoot":"","sources":["../../src/map/map-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,eAAe,EAKf,UAAU,EAiBX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAklCjE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,eAAe,CAE3E;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,WAAW,GAAE,UAAU,EAAO,GAC7B,eAAe,CAGjB"}
+{"version":3,"file":"map-block.d.ts","sourceRoot":"","sources":["../../src/map/map-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,eAAe,EAKf,UAAU,EAiBX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AA6mCjE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,GAAG,eAAe,CAE3E;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,WAAW,GAAE,UAAU,EAAO,GAC7B,eAAe,CAGjB"}

package/dist/map/map-block.js

@@ -416,7 +416,11 @@ function mapMetadataFields(element, block, ctx) {
             case "baseType": {
                 const bt = getTextOrAttr(child);
                 if (bt) {
-                    block.baseType = withElementLocation(ctx.filePath, ctx.source, child, () => namedTypeFqn(bt, ctx, block.type));
+                    const parsed = withElementLocation(ctx.filePath, ctx.source, child, () => parseBaseType(bt, ctx, block.type));
+                    block.baseType = parsed.fqn;
+                    if (parsed.expression) {
+                        block.baseTypeExpression = parsed.expression;
+                    }
                 }
                 block.baseTypeSource = elementSourceLoc(ctx.filePath, ctx.source, child);
                 break;
@@ -562,8 +566,20 @@ function mapProseEntry(element, ctx) {
 function blockEffectiveLanguage(_ctx) {
     return "org.blockml.bml.language.English";
 }
+const FREE_TEXT_KEYWORD = "org.blockml.bml.meta.FreeTextKeyword";
+const FREE_TEXT_ALIAS = "org.blockml.bml.meta.FreeTextAlias";
+function commaSeparatedTokens(text) {
+    return text
+        .split(",")
+        .map((token) => token.trim())
+        .filter((token) => token.length > 0);
+}
 function mapKeywords(element, ctx) {
     const entries = [];
+    const { text } = getCharacterData(element);
+    for (const term of commaSeparatedTokens(text)) {
+        entries.push({ typeFqn: FREE_TEXT_KEYWORD, term });
+    }
     for (const child of elementChildren(element)) {
         const local = elementLocalName(child);
         const prefix = elementPrefix(child);
@@ -586,6 +602,10 @@ function mapKeywords(element, ctx) {
 }
 function mapAliases(element, ctx) {
     const entries = [];
+    const { text } = getCharacterData(element);
+    for (const name of commaSeparatedTokens(text)) {
+        entries.push({ typeFqn: FREE_TEXT_ALIAS, name });
+    }
     for (const child of elementChildren(element)) {
         const local = elementLocalName(child);
         const prefix = elementPrefix(child);
@@ -719,12 +739,27 @@ function typeResolveOptions(ctx) {
     }
     return options;
 }
-function namedTypeFqn(raw, ctx, fallbackParent) {
+function isRichNamedType(expr) {
+    return (expr.kind === "named" &&
+        ((expr.typeArguments?.length ?? 0) > 0 ||
+            expr.instanceConfiguration !== undefined ||
+            expr.multiplicity !== undefined));
+}
+function parseBaseType(raw, ctx, fallbackParent) {
     const expr = parseTypeExpression(raw, ctx.bindings, "type", typeResolveOptions(ctx));
     if (expr.kind === "named") {
-        return expr.fqn;
+        if (isRichNamedType(expr)) {
+            return { fqn: expr.fqn, expression: expr };
+        }
+        return { fqn: expr.fqn };
     }
-    return resolveBlockReference(raw, ctx.bindings, ctx.subBlockIndex, fallbackParent);
+    return {
+        fqn: resolveBlockReference(raw, ctx.bindings, ctx.subBlockIndex, fallbackParent),
+        expression: expr,
+    };
+}
+function namedTypeFqn(raw, ctx, fallbackParent) {
+    return parseBaseType(raw, ctx, fallbackParent).fqn;
 }
 function mapGenericTypes(element, ctx) {
     return elementChildren(element).map((c) => {