@blockml/parser 0.9.4 → 0.9.6

package/blocks/org/blockml/bml/compiler/parser/capability/ParseGenericArgumentList.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ParseGenericArgumentList
-  FQN: org.blockml.bml.compiler.parser.capability.ParseGenericArgumentList
--->
-<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 Capability — ParseGenericArgumentList
+  FQN: org.blockml.bml.compiler.parser.capability.ParseGenericArgumentList-->
+<parcap:ParseGenericArgumentList xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,29 +23,35 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ParseGenericArgumentList</name>
-  <type>parcap:ParseGenericArgumentList</type>
-  <baseType>core:Capability</baseType>
-  <is>Parse a parenthesized TypeExpression list for bml:generics</is>
-
-  <documentation>Parse a parenthesized TypeExpression list for bml:generics.
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Parse a parenthesized TypeExpression list for bml:generics
+  </is>
+  <documentation>
+    Parse a parenthesized TypeExpression list for bml:generics.
     Outer parentheses are required. Reuses the TypeExpression parser used by
-    baseType generic applications, without a leading type name.</documentation>
-
+    baseType generic applications, without a leading type name.
+  </documentation>
   <references>
     <see type="parcap:ParseTypeExpression" relation="SeeAlso" />
   </references>
-
   <properties>
     <raw type="type:Text">
-      <documentation>raw. TS type: type:Text. (required)</documentation>
+      <documentation>
+        raw. TS type: type:Text. (required)
+      </documentation>
     </raw>
     <bindings type="type:Text">
-      <documentation>xmlns prefix bindings. (required)</documentation>
+      <documentation>
+        xmlns prefix bindings. (required)
+      </documentation>
     </bindings>
     <arguments type="bomtype:TypeExpression[]">
-      <documentation>arguments. TS type: bomtype:TypeExpression[]. (required)</documentation>
+      <documentation>
+        arguments. TS type: bomtype:TypeExpression[]. (required)
+      </documentation>
     </arguments>
   </properties>
-
-</block>
+</parcap:ParseGenericArgumentList>

package/blocks/org/blockml/bml/compiler/parser/capability/ParseGenericsBinding.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ParseGenericsBinding
-  FQN: org.blockml.bml.compiler.parser.capability.ParseGenericsBinding
--->
-<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 Capability — ParseGenericsBinding
+  FQN: org.blockml.bml.compiler.parser.capability.ParseGenericsBinding-->
+<parcap:ParseGenericsBinding xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,30 +23,36 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ParseGenericsBinding</name>
-  <type>parcap:ParseGenericsBinding</type>
-  <baseType>core:Capability</baseType>
-  <is>Parse bml:generics attribute or child element into GenericsBinding</is>
-
-  <documentation>Parse bml:generics as attribute or child element. Attribute form wins.
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Parse bml:generics attribute or child element into GenericsBinding
+  </is>
+  <documentation>
+    Parse bml:generics as attribute or child element. Attribute form wins.
     Stores lossless raw plus parsed TypeExpression arguments when parentheses
-    are present and well-formed.</documentation>
-
+    are present and well-formed.
+  </documentation>
   <references>
     <see type="parcap:ParseGenericArgumentList" relation="SeeAlso" />
     <see type="pardocumentation:AttributeClassification" relation="SeeAlso" />
   </references>
-
   <properties>
     <element type="parmap:XmlDomNode">
-      <documentation>element. TS type: parmap:XmlDomNode. (required)</documentation>
+      <documentation>
+        element. TS type: parmap:XmlDomNode. (required)
+      </documentation>
     </element>
     <ctx type="parmap:MapContext">
-      <documentation>ctx. TS type: parmap:MapContext. (required)</documentation>
+      <documentation>
+        ctx. TS type: parmap:MapContext. (required)
+      </documentation>
     </ctx>
     <binding type="bomcomp:GenericsBinding">
-      <documentation>binding. TS type: bomcomp:GenericsBinding. (optional)</documentation>
+      <documentation>
+        binding. TS type: bomcomp:GenericsBinding. (optional)
+      </documentation>
     </binding>
   </properties>
-
-</block>
+</parcap:ParseGenericsBinding>

package/blocks/org/blockml/bml/compiler/parser/capability/ParseMemberValue.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ParseMemberValue
-  FQN: org.blockml.bml.compiler.parser.capability.ParseMemberValue
--->
-<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 Capability — ParseMemberValue
+  FQN: org.blockml.bml.compiler.parser.capability.ParseMemberValue-->
+<parcap:ParseMemberValue xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,40 +23,56 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ParseMemberValue</name>
-  <type>parcap:ParseMemberValue</type>
-  <baseType>core:Capability</baseType>
-  <is>Parse attribute/element value to MemberValue</is>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Parse attribute/element value to MemberValue
+  </is>
   <documentation>
     Parse attribute/element value to MemberValue.
-
-    Always classifies a whole `${ … }` as ExpressionValue and unescaped `${` in
-    running text as InterpolatedTextValue. JSON arrays/objects stay structural
-    list/struct tokenization.
-
+    
+    Classification of the entire value:
+    • unescaped whole `${ … }` → ExpressionValue (full expression language)
+    • running text with an unescaped `${` → InterpolatedTextValue (authored raw kept)
+    • only escaped openers (`\${`, `\\\${`, …) → LiteralValue after unescape
+    • JSON arrays/objects stay structural list/struct tokenization — the
+      compact collection form for any member (property or association).
+      Repeated instance elements are merged by MapBlockInstanceNode, not here.
+    
+    Escape is JS-template-like: a `${` opener is escaped when an odd number of
+    backslashes immediately precedes `$`. `\${` stores literal `${`. `\\${` is
+    one literal `\` plus a hole. Empty `${}` / `${ }` stays a parse error — write
+    `\${ }` when the delimiter characters are intended.
+    
+    Literal string storage is unescaped (`\${` → `${`). InterpolatedTextValue.raw
+    keeps the authored escapes; parseInterpolatedText / evaluate unescapes holes.
+    
     Without `ctx.parseValue` (library bootstrap): Boolean and number heuristics
     (Text / Integer / Boolean / TypeIdentifier) remain.
-
+    
     With the host hook: scalars go through parseValue only. Success stores the
     host value. Failure keeps the authored string and reports BML_INVALID_VALUE.
     Skip keeps the authored string — no Boolean/number coercion.
   </documentation>
-
   <references>
     <see type="pardocumentation:ExpressionCapture" relation="SeeAlso" />
   </references>
-
   <properties>
     <raw type="type:Text">
-      <documentation>raw. TS type: type:Text. (required)</documentation>
+      <documentation>
+        raw. TS type: type:Text. (required)
+      </documentation>
     </raw>
     <ctx type="parmap:MapContext">
-      <documentation>ctx. TS type: parmap:MapContext. (required)</documentation>
+      <documentation>
+        ctx. TS type: parmap:MapContext. (required)
+      </documentation>
     </ctx>
     <value type="bomvalue:MemberValue">
-      <documentation>value. TS type: bomvalue:MemberValue. (required)</documentation>
+      <documentation>
+        value. TS type: bomvalue:MemberValue. (required)
+      </documentation>
     </value>
   </properties>
-
-</block>
+</parcap:ParseMemberValue>

package/blocks/org/blockml/bml/compiler/parser/capability/ParseTypeExpression.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ParseTypeExpression
-  FQN: org.blockml.bml.compiler.parser.capability.ParseTypeExpression
--->
-<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 Capability — ParseTypeExpression
+  FQN: org.blockml.bml.compiler.parser.capability.ParseTypeExpression-->
+<parcap:ParseTypeExpression xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,30 +23,38 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ParseTypeExpression</name>
-  <type>parcap:ParseTypeExpression</type>
-  <baseType>core:Capability</baseType>
-  <is>Parse type attribute string to TypeExpression</is>
-
-  <documentation>Parse type attribute string to TypeExpression</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Parse type attribute string to TypeExpression
+  </is>
+  <documentation>
+    Parse type attribute string to TypeExpression
+  </documentation>
   <references>
     <see type="pardocumentation:TypeDescriptorParsing" relation="SeeAlso" />
   </references>
-
   <properties>
     <raw type="type:Text">
-      <documentation>raw. TS type: type:Text. (required)</documentation>
+      <documentation>
+        raw. TS type: type:Text. (required)
+      </documentation>
     </raw>
     <ctx type="parmap:MapContext">
-      <documentation>ctx. TS type: parmap:MapContext. (required)</documentation>
+      <documentation>
+        ctx. TS type: parmap:MapContext. (required)
+      </documentation>
     </ctx>
     <implicitContext type="type:Text">
-      <documentation>implicitContext. TS type: type:Text. (optional)</documentation>
+      <documentation>
+        implicitContext. TS type: type:Text. (optional)
+      </documentation>
     </implicitContext>
     <expression type="bomtype:TypeExpression">
-      <documentation>expression. TS type: bomtype:TypeExpression. (required)</documentation>
+      <documentation>
+        expression. TS type: bomtype:TypeExpression. (required)
+      </documentation>
     </expression>
   </properties>
-
-</block>
+</parcap:ParseTypeExpression>

package/blocks/org/blockml/bml/compiler/parser/capability/ParseVisibilityFromName.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ParseVisibilityFromName
-  FQN: org.blockml.bml.compiler.parser.capability.ParseVisibilityFromName
--->
-<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 Capability — ParseVisibilityFromName
+  FQN: org.blockml.bml.compiler.parser.capability.ParseVisibilityFromName-->
+<parcap:ParseVisibilityFromName xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,24 +23,28 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ParseVisibilityFromName</name>
-  <type>parcap:ParseVisibilityFromName</type>
-  <baseType>core:Capability</baseType>
-  <is>Strip _/__ prefix from localName → logical name + visibility (B14)</is>
-
-  <documentation>Strip _/__ prefix from localName → logical name + visibility (B14)</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Strip _/__ prefix from localName → logical name + visibility (B14)
+  </is>
+  <documentation>
+    Strip _/__ prefix from localName → logical name + visibility (B14)
+  </documentation>
   <references>
     <see type="pardocumentation:DesignDecisions" relation="SeeAlso" />
   </references>
-
   <properties>
     <localName type="type:Text">
-      <documentation>localName. TS type: type:Text. (required)</documentation>
+      <documentation>
+        localName. TS type: type:Text. (required)
+      </documentation>
     </localName>
     <result type="parmap:VisibilityParse">
-      <documentation>result. TS type: parmap:VisibilityParse. (required)</documentation>
+      <documentation>
+        result. TS type: parmap:VisibilityParse. (required)
+      </documentation>
     </result>
   </properties>
-
-</block>
+</parcap:ParseVisibilityFromName>

package/blocks/org/blockml/bml/compiler/parser/capability/ParseXmlDom.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ParseXmlDom
-  FQN: org.blockml.bml.compiler.parser.capability.ParseXmlDom
--->
-<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 Capability — ParseXmlDom
+  FQN: org.blockml.bml.compiler.parser.capability.ParseXmlDom-->
+<parcap:ParseXmlDom xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,27 +23,33 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ParseXmlDom</name>
-  <type>parcap:ParseXmlDom</type>
-  <baseType>core:Capability</baseType>
-  <is>XML DOM parser — step [2] (B18)</is>
-
-  <documentation>Uses @xmldom/xmldom. Browser and Node compatible.</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    XML DOM parser — step [2] (B18)
+  </is>
+  <documentation>
+    Uses @xmldom/xmldom. Browser and Node compatible.
+  </documentation>
   <references>
     <see type="pardocumentation:V1Scope" relation="SeeAlso" />
   </references>
-
   <properties>
     <source type="type:Text">
-      <documentation>source. TS type: type:Text. (required)</documentation>
+      <documentation>
+        source. TS type: type:Text. (required)
+      </documentation>
     </source>
     <filePath type="type:Text">
-      <documentation>filePath. TS type: type:Text. (optional)</documentation>
+      <documentation>
+        filePath. TS type: type:Text. (optional)
+      </documentation>
     </filePath>
     <document type="parmap:XmlDomNode">
-      <documentation>DOM Document (required)</documentation>
+      <documentation>
+        DOM Document (required)
+      </documentation>
     </document>
   </properties>
-
-</block>
+</parcap:ParseXmlDom>

package/blocks/org/blockml/bml/compiler/parser/capability/ResolveBlockReference.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ResolveBlockReference
-  FQN: org.blockml.bml.compiler.parser.capability.ResolveBlockReference
--->
-<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 Capability — ResolveBlockReference
+  FQN: org.blockml.bml.compiler.parser.capability.ResolveBlockReference-->
+<parcap:ResolveBlockReference xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,30 +23,38 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ResolveBlockReference</name>
-  <type>parcap:ResolveBlockReference</type>
-  <baseType>core:Capability</baseType>
-  <is>Resolve block type/baseType QName to FQN</is>
-
-  <documentation>Resolve block type/baseType QName to FQN</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Resolve block type/baseType QName to FQN
+  </is>
+  <documentation>
+    Resolve block type/baseType QName to FQN
+  </documentation>
   <references>
     <see type="parconfig:ParserConstants" relation="SeeAlso" />
   </references>
-
   <properties>
     <qname type="type:Text">
-      <documentation>qname. TS type: type:Text. (required)</documentation>
+      <documentation>
+        qname. TS type: type:Text. (required)
+      </documentation>
     </qname>
     <bindings type="type:Text">
-      <documentation>bindings. TS type: type:Text. (required)</documentation>
+      <documentation>
+        bindings. TS type: type:Text. (required)
+      </documentation>
     </bindings>
     <ctx type="parmap:MapContext">
-      <documentation>ctx. TS type: parmap:MapContext. (required)</documentation>
+      <documentation>
+        ctx. TS type: parmap:MapContext. (required)
+      </documentation>
     </ctx>
     <fqn type="type:Text">
-      <documentation>fqn. TS type: type:Text. (required)</documentation>
+      <documentation>
+        fqn. TS type: type:Text. (required)
+      </documentation>
     </fqn>
   </properties>
-
-</block>
+</parcap:ResolveBlockReference>

package/blocks/org/blockml/bml/compiler/parser/capability/ResolvePrefix.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ResolvePrefix
-  FQN: org.blockml.bml.compiler.parser.capability.ResolvePrefix
--->
-<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 Capability — ResolvePrefix
+  FQN: org.blockml.bml.compiler.parser.capability.ResolvePrefix-->
+<parcap:ResolvePrefix xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,23 +23,30 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ResolvePrefix</name>
-  <type>parcap:ResolvePrefix</type>
-  <baseType>core:Capability</baseType>
-  <is>Resolve namespace prefix to URI from bindings</is>
-
-  <documentation>Resolve namespace prefix to URI from bindings</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Resolve namespace prefix to URI from bindings
+  </is>
+  <documentation>
+    Resolve namespace prefix to URI from bindings
+  </documentation>
   <properties>
     <prefix type="type:Text">
-      <documentation>prefix. TS type: type:Text. (required)</documentation>
+      <documentation>
+        prefix. TS type: type:Text. (required)
+      </documentation>
     </prefix>
     <bindings type="type:Text">
-      <documentation>bindings. TS type: type:Text. (required)</documentation>
+      <documentation>
+        bindings. TS type: type:Text. (required)
+      </documentation>
     </bindings>
     <uri type="type:Text">
-      <documentation>uri. TS type: type:Text. (required)</documentation>
+      <documentation>
+        uri. TS type: type:Text. (required)
+      </documentation>
     </uri>
   </properties>
-
-</block>
+</parcap:ResolvePrefix>

package/blocks/org/blockml/bml/compiler/parser/capability/ResolveTypeName.bml

@@ -1,12 +1,6 @@
-<!--
-  Parser Capability — ResolveTypeName
-  FQN: org.blockml.bml.compiler.parser.capability.ResolveTypeName
--->
-<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 Capability — ResolveTypeName
+  FQN: org.blockml.bml.compiler.parser.capability.ResolveTypeName-->
+<parcap:ResolveTypeName xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -29,30 +23,38 @@
   xmlns:serdocumentation="org.blockml.bml.compiler.serializer.documentation"
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
-  <name>ResolveTypeName</name>
-  <type>parcap:ResolveTypeName</type>
-  <baseType>core:Capability</baseType>
-  <is>Resolve type name to FQN with implicit namespaces</is>
-
-  <documentation>Resolve type name to FQN with implicit namespaces</documentation>
-
+  <baseType>
+    core:Capability
+  </baseType>
+  <is>
+    Resolve type name to FQN with implicit namespaces
+  </is>
+  <documentation>
+    Resolve type name to FQN with implicit namespaces
+  </documentation>
   <references>
     <see type="pardocumentation:TypeDescriptorParsing" relation="SeeAlso" />
   </references>
-
   <properties>
     <name type="type:Text">
-      <documentation>name. TS type: type:Text. (required)</documentation>
+      <documentation>
+        name. TS type: type:Text. (required)
+      </documentation>
     </name>
     <bindings type="type:Text">
-      <documentation>bindings. TS type: type:Text. (required)</documentation>
+      <documentation>
+        bindings. TS type: type:Text. (required)
+      </documentation>
     </bindings>
     <implicitContext type="type:Text">
-      <documentation>implicitContext. TS type: type:Text. (optional)</documentation>
+      <documentation>
+        implicitContext. TS type: type:Text. (optional)
+      </documentation>
     </implicitContext>
     <fqn type="type:Text">
-      <documentation>fqn. TS type: type:Text. (required)</documentation>
+      <documentation>
+        fqn. TS type: type:Text. (required)
+      </documentation>
     </fqn>
   </properties>
-
-</block>
+</parcap:ResolveTypeName>