@blockml/parser 0.8.0 → 0.9.0

package/blocks/org/blockml/bml/compiler/parser/Library.bml

@@ -35,13 +35,15 @@
   <is>The BlockML Parser compiler package library catalog</is>
 
   <documentation>
+    # The BlockML Parser compiler package library catalog
+
     Canonical parser specification for BlockML — BML → BOM mapping algorithm,
     Stage 1 pipeline [1]–[5], and parse() contract. TypeScript in packages/parser/src/
     implements this library. Input/output Urmodell types live in org.blockml.bml.bom.*
     (@blockml/bom). Membership is defined exclusively by this blocks list.
   </documentation>
 
-  <version>0.8.0</version>
+  <version>0.9.0</version>
 
   <language>
     <English />
@@ -113,6 +115,7 @@
         <parcap:FqnToQName />
         <parcap:SourceLoc />
         <parcap:ElementSourceLoc />
+        <parcap:ElementStartTagIsSelfClosing />
         <parcap:IsElement />
         <parcap:IsComment />
         <parcap:IsTextNode />

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

@@ -34,7 +34,7 @@
   <baseType>core:Capability</baseType>
   <is>Format detector — step [1] (B24)</is>
 
-  <documentation>Strip UTF-8 BOM; detect xml when first non-whitespace is '&lt;'.</documentation>
+  <documentation><![CDATA[Strip UTF-8 BOM; detect xml when first non-whitespace is '<'.]]></documentation>
 
   <references>
     <see type="pardocumentation:ArchitectureOverview" relation="SeeAlso" />

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

@@ -0,0 +1,52 @@
+<!--
+  Parser Capability — ElementStartTagIsSelfClosing
+  FQN: org.blockml.bml.compiler.parser.capability.ElementStartTagIsSelfClosing
+-->
+<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>ElementStartTagIsSelfClosing</name>
+  <type>parcap:ElementStartTagIsSelfClosing</type>
+  <baseType>core:Capability</baseType>
+  <is>Detect whether an element's start tag is authored as self-closing</is>
+
+  <documentation>True when the start tag ends with slash-greater-than. Used to record
+    authoredEmptyElementForm on empty see references.</documentation>
+
+  <properties>
+    <source type="type:Text">
+      <documentation>source. TS type: type:Text. (required)</documentation>
+    </source>
+    <element type="parmap:XmlDomNode">
+      <documentation>element. TS type: parmap:XmlDomNode. (required)</documentation>
+    </element>
+    <result type="type:Boolean">
+      <documentation>result. TS type: type:Boolean. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

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

@@ -34,7 +34,7 @@
   <baseType>core:Capability</baseType>
   <is>Map &lt;composition> element to CompositionTemplate</is>
 
-  <documentation>Map &lt;composition> element to CompositionTemplate</documentation>
+  <documentation><![CDATA[Map <composition> element to CompositionTemplate]]></documentation>
 
   <properties>
     <element type="parmap:XmlDomNode">

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

@@ -34,7 +34,7 @@
   <baseType>core:Capability</baseType>
   <is>Map root &lt;block> to BomDocument — step [5] entry</is>
 
-  <documentation>Map root &lt;block> to BomDocument — step [5] entry</documentation>
+  <documentation><![CDATA[Map root <block> to BomDocument — step [5] entry]]></documentation>
 
   <references>
     <see type="parcap:MapBlock" relation="SeeAlso" />

package/blocks/org/blockml/bml/compiler/parser/config/MapTimeDiagnosticCodes.bml

@@ -38,7 +38,7 @@
 
   <properties>
     <codes type="type:Text[]">
-      <documentation>Ordered: BML_UNSUPPORTED_FORMAT, BML_MALFORMED_XML, BML_MISSING_ROOT, BML_INVALID_ROOT, BML_MAP_ERROR, BML_UNKNOWN_NAMESPACE_PREFIX, BML_UNQUALIFIED_BLOCK_REFERENCE, BML_UNKNOWN_TYPE, BML_INVALID_TYPE_REFERENCE, BML_UNKNOWN_ELEMENT, BML_UNKNOWN_ATTRIBUTE, BML_UNKNOWN_DIRECTIVE, BML_STANDALONE_COMPOSITION, BML_DUPLICATE_COMPOSITION, BML_UNEXPECTED_TEXT (required)</documentation>
+      <documentation>Ordered: BML_UNSUPPORTED_FORMAT, BML_MALFORMED_XML, BML_MISSING_ROOT, BML_INVALID_ROOT, BML_MAP_ERROR, BML_UNKNOWN_NAMESPACE_PREFIX, BML_UNQUALIFIED_BLOCK_REFERENCE, BML_UNKNOWN_TYPE, BML_INVALID_TYPE_REFERENCE, BML_UNKNOWN_ELEMENT, BML_UNKNOWN_ATTRIBUTE, BML_UNKNOWN_DIRECTIVE, BML_STANDALONE_COMPOSITION, BML_NESTED_COMPOSITION, BML_DUPLICATE_COMPOSITION, BML_DUPLICATE_PROPERTY_VALUE, BML_UNEXPECTED_TEXT (required)</documentation>
     </codes>
   </properties>
 

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

@@ -35,12 +35,12 @@
   <baseType>core:Documentation</baseType>
   <is>Parse pipeline [1]–[5] and module decomposition</is>
 
-  <documentation>Entry point: parse(source, options?) → ParseResult (B26).
+  <documentation><![CDATA[Entry point: parse(source, options?) → ParseResult (B26).
 
     Stage 1 pipeline:
-    [1] Format detect (B24) — detectFormat(); strip UTF-8 BOM; first '&lt;' → xml
+    [1] Format detect (B24) — detectFormat(); strip UTF-8 BOM; first '<' → xml
     [2] XML DOM (B18) — parseXmlDom() via @xmldom/xmldom
-    [3] Root type resolver — assertBlockRoot(); V1: &lt;block> only
+    [3] Root type resolver — assertBlockRoot(); V1: <block> only
     [4] Namespace resolver — extractNamespaceBindings(), mergeSourceInfo(); FQN resolution
     [5] BML → BOM mapper — mapDocumentBlock() → BomDocument
 
@@ -56,11 +56,11 @@
     • map/type-expression.ts → parcap:ParseTypeExpression
     • map/member-value.ts → parcap:ParseMemberValue
     • map/directives.ts → parcap:ParseDirectives, ParseBmlMeta
-    • util/* → visibility, boolean, qname, xml helpers</documentation>
+    • util/* → visibility, boolean, qname, xml helpers]]></documentation>
 
   <references>
-    <see type="pardocumentation:V1Scope" relation="ReadNext"></see>
-    <see type="parcap:Parse" relation="Defines"></see>
+    <see type="pardocumentation:V1Scope" relation="ReadNext" />
+    <see type="parcap:Parse" relation="Defines" />
   </references>
 
 </block>

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

@@ -54,8 +54,8 @@
     Serialize side of Rule 1 (B25 re-emit) → @blockml/serializer.</documentation>
 
   <references>
-    <see type="pardocumentation:StructuralGrammar" relation="ReadNext"></see>
-    <see type="parcap:ParseDirectives" relation="SeeAlso"></see>
+    <see type="pardocumentation:StructuralGrammar" relation="ReadNext" />
+    <see type="parcap:ParseDirectives" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -35,7 +35,7 @@
   <baseType>core:Documentation</baseType>
   <is>Block definition metadata field mapping</is>
 
-  <documentation>Map &lt;block> child elements to BlockDefinition fields:
+  <documentation><![CDATA[Map <block> child elements to BlockDefinition fields:
 
     Identity: name, type, baseType, is, isNot, version, definition
     Structural: since, status, summary, documentation, abstract, final
@@ -47,11 +47,11 @@
     • authoredPlacement stored for dual element|attribute forms (D9)
     • authoredCharacterDataForm for text vs CDATA (D8)
     • TrimText on character data: common leading indent stripped, then trim (B13)
-    • Visibility prefixes stripped → logical name + visibility (B14 parse half)</documentation>
+    • Visibility prefixes stripped → logical name + visibility (B14 parse half)]]></documentation>
 
   <references>
-    <see type="pardocumentation:MemberMapping" relation="ReadNext"></see>
-    <see type="def:BlockDefinition" relation="SeeAlso"></see>
+    <see type="pardocumentation:MemberMapping" relation="ReadNext" />
+    <see type="def:BlockDefinition" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -35,24 +35,28 @@
   <baseType>core:Documentation</baseType>
   <is>Normative parser design decisions</is>
 
-  <documentation>B2: unknown bml:* → error at map (BML_UNKNOWN_DIRECTIVE); unknown instance members → validator error (BML_UNKNOWN_PROPERTY).
-    B3: inputType/outputType → TypeExpression at map time.
-    B4: ExpressionValue.raw only; AST via core utility.
-    B5: single-file parser scope.
-    B6: JSON not planned.
-    B7/B8: Phase A slice; XSD not Stage 1.
-    B11: XML comments bound to elements (parse side).
-    B14: strip _/__ → logical name + visibility.
-    B15/B16: boolean values vs type refs.
-    B18: @xmldom/xmldom for DOM.
-    B19: redundant aggregation type — map must not apply.
-    B23: preserve xmlRendering + D6 recipe at Stage 1.
-    B24: format detector (BOM strip, first '&lt;').
-    B25: store xmlns:xsi + schemaLocation on SourceInfo.
-    B26: parse() entry; types in @blockml/bom.</documentation>
+  <documentation><![CDATA[
+    # Normative parser design decisions
+
+    - B2: unknown bml:* → error at map (BML_UNKNOWN_DIRECTIVE); unknown instance members → validator error (BML_UNKNOWN_PROPERTY).
+    - B3: inputType/outputType → TypeExpression at map time.
+    - B4: ExpressionValue.raw only; AST via core utility.
+    - B5: single-file parser scope.
+    - B6: JSON not planned.
+    - B7/B8: Phase A slice; XSD not Stage 1.
+    - B11: XML comments bound to elements (parse side).
+    - B14: strip _/__ → logical name + visibility.
+    - B15/B16: boolean values vs type refs.
+    - B18: @xmldom/xmldom for DOM.
+    - B19: redundant aggregation type — map must not apply.
+    - B23: preserve xmlRendering + D6 recipe at Stage 1.
+    - B24: format detector (BOM strip, first '<').
+    - B25: store xmlns:xsi + schemaLocation on SourceInfo.
+    - B26: parse() entry; types in @blockml/bom.
+  ]]></documentation>
 
   <references>
-    <see type="pardocumentation:RoundtripContract" relation="ReadNext"></see>
+    <see type="pardocumentation:RoundtripContract" relation="ReadNext" />
   </references>
 
 </block>

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

@@ -35,11 +35,11 @@
   <baseType>core:Documentation</baseType>
   <is>Map-time and pipeline diagnostic codes</is>
 
-  <documentation>Pipeline hard-fail codes (parse.ts):
+  <documentation><![CDATA[Pipeline hard-fail codes (parse.ts):
     • BML_UNSUPPORTED_FORMAT — format detect failed
     • BML_MALFORMED_XML — DOM parse error
     • BML_MISSING_ROOT — no document element
-    • BML_INVALID_ROOT — not &lt;block> (V1)
+    • BML_INVALID_ROOT — not <block> (V1)
     • BML_MAP_ERROR — mapping exception
 
     Map-time codes (mapper modules):
@@ -49,19 +49,21 @@
     • BML_UNKNOWN_ELEMENT — child not in closed Block grammar (structural)
     • BML_UNKNOWN_ATTRIBUTE — attribute not allowed on a grammar node (structural)
     • BML_UNKNOWN_DIRECTIVE — unknown bml:* attribute (B2)
-    • BML_STANDALONE_COMPOSITION — &lt;composition> not a direct child of an aggregation member
-    • BML_DUPLICATE_COMPOSITION — more than one &lt;composition> on the same aggregation member
+    • BML_STANDALONE_COMPOSITION — <composition> not a direct child of an aggregation member
+    • BML_NESTED_COMPOSITION — <composition> inside an aggregation that is already nested in a composition
+    • BML_DUPLICATE_COMPOSITION — more than one <composition> on the same aggregation member
+    • BML_DUPLICATE_PROPERTY_VALUE — more than one <value> for the same namespace on a property
     • BML_UNEXPECTED_TEXT — non-whitespace text on an element-only grammar node
 
     Map-time diagnostics attach Diagnostic.source to the use-site token when known
     (attribute value or first occurrence in the throwing element), not the document root.
 
     Host policy: whether to abort after diagnostics is orchestrator decision.
-    Diagnostic type: org.blockml.bml.bom.common.Diagnostic.</documentation>
+    Diagnostic type: org.blockml.bml.bom.common.Diagnostic.]]></documentation>
 
   <references>
-    <see type="parconfig:MapTimeDiagnosticCodes" relation="Defines"></see>
-    <see type="pardocumentation:PackageOwnership" relation="ReadNext"></see>
+    <see type="parconfig:MapTimeDiagnosticCodes" relation="Defines" />
+    <see type="pardocumentation:PackageOwnership" relation="ReadNext" />
   </references>
 
 </block>

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

@@ -44,8 +44,8 @@
     inputType/outputType on capabilities → TypeExpression at map time (B3).</documentation>
 
   <references>
-    <see type="pardocumentation:SingleFileScope" relation="ReadNext"></see>
-    <see type="parcap:ExpressionFromRaw" relation="SeeAlso"></see>
+    <see type="pardocumentation:SingleFileScope" relation="ReadNext" />
+    <see type="parcap:ExpressionFromRaw" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -50,8 +50,8 @@
     depend on @blockml/serializer, @blockml/validator, or TypeRegistry bootstrap.</documentation>
 
   <references>
-    <see type="pardocumentation:LayerSeparation" relation="ReadNext"></see>
-    <see type="bomdocumentation:Introduction" relation="SeeAlso"></see>
+    <see type="pardocumentation:LayerSeparation" relation="ReadNext" />
+    <see type="bomdocumentation:Introduction" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -53,8 +53,8 @@
     Parser stores ExpressionValue.raw only (B4); never writes AST to Urmodell.</documentation>
 
   <references>
-    <see type="pardocumentation:ArchitectureOverview" relation="ReadNext"></see>
-    <see type="bomdocumentation:LayerSeparation" relation="SeeAlso"></see>
+    <see type="pardocumentation:ArchitectureOverview" relation="ReadNext" />
+    <see type="bomdocumentation:LayerSeparation" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -46,8 +46,8 @@
     block rendering. Maximum authored surface: store as much as Urmodell can carry.</documentation>
 
   <references>
-    <see type="pardocumentation:MemberMappingOrder" relation="ReadNext"></see>
-    <see type="bomdocumentation:AbstractionPrinciple" relation="SeeAlso"></see>
+    <see type="pardocumentation:MemberMappingOrder" relation="ReadNext" />
+    <see type="bomdocumentation:AbstractionPrinciple" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -35,22 +35,33 @@
   <baseType>core:Documentation</baseType>
   <is>Member definition and composition mapping</is>
 
-  <documentation>Property/aggregation/association/capability members:
+  <documentation><![CDATA[Property/aggregation/association/capability members:
     • Element QName = member identity (deprecated namespace= attr → error)
     • type attribute → TypeExpression; value/memberValues for properties
-    • One &lt;composition> per aggregation member, as a direct child of that member
-      (not of &lt;block>, &lt;aggregations>, or nested inside metadata). Extra copies →
-      BML_DUPLICATE_COMPOSITION. Misplaced → BML_STANDALONE_COMPOSITION.
-      Sugar without a &lt;composition> wrapper (instances as direct children) stays allowed.
+    • One <value> per namespace on a property member. Unprefixed <value> /
+      value="…" is the canonical namespace (""). Prefixed <prefix:value>
+      (Annotation xmlns) is a separate facet. Extra copies of the same
+      namespace → BML_DUPLICATE_PROPERTY_VALUE.
+    • One <composition> per aggregation member on a Block definition, as a direct
+      child of that member (not of <block>, <aggregations>, nested inside metadata,
+      or inside an aggregation that is already nested in a composition). Extra
+      copies → BML_DUPLICATE_COMPOSITION. Misplaced → BML_STANDALONE_COMPOSITION.
+      Wrapper inside a composition instance aggregation → BML_NESTED_COMPOSITION
+      (children still mapped). On Block instances, aggregations are filled by
+      member name with children as direct descendants — no <composition> wrapper.
+      Sugar without a <composition> wrapper (instances as direct children) stays
+      allowed on definitions.
     • Constraints/suggestions → BlockInstance[] in document order
+    • Capability <throws> → TypeReferenceEntityInstance[] (empty-QName sugar or
+      explicit type:TypeReferenceEntity); bound B = core:Exception
     • Sub-Blocks and embedded blocks → nested BlockDefinition trees
     • Redundant aggregation type on override → validator warning B19; parser must not apply
 
-    Directives on composition: bml:each, bml:if, bml:unless, bml:with — stored unexpanded.</documentation>
+    Directives on composition: bml:each, bml:if, bml:unless, bml:with — stored unexpanded.]]></documentation>
 
   <references>
-    <see type="pardocumentation:ExpressionCapture" relation="ReadNext"></see>
-    <see type="parcap:MapBlockInstanceNode" relation="SeeAlso"></see>
+    <see type="pardocumentation:ExpressionCapture" relation="ReadNext" />
+    <see type="parcap:MapBlockInstanceNode" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -45,7 +45,7 @@
     Inside containers (properties/aggregations/…): filter by kind, keep BOM array order.</documentation>
 
   <references>
-    <see type="pardocumentation:AttributeClassification" relation="ReadNext"></see>
+    <see type="pardocumentation:AttributeClassification" relation="ReadNext" />
   </references>
 
 </block>

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

@@ -48,8 +48,8 @@
     @blockml/cli — TypeRegistry bootstrap and orchestration.</documentation>
 
   <references>
-    <see type="pardocumentation:ScopeExclusions" relation="ReadNext"></see>
-    <see type="bomdocumentation:PackageOwnership" relation="SeeAlso"></see>
+    <see type="pardocumentation:ScopeExclusions" relation="ReadNext" />
+    <see type="bomdocumentation:PackageOwnership" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -35,10 +35,10 @@
   <baseType>core:Documentation</baseType>
   <is>parse() entry point (B26)</is>
 
-  <documentation>parse(source: string, options?: ParseOptions): ParseResult
+  <documentation><![CDATA[parse(source: string, options?: ParseOptions): ParseResult
 
     ParseOptions (owned by @blockml/bom):
-    • filePath — default "&lt;memory>"; written to BomDocument.source.filePath
+    • filePath — default "<memory>"; written to BomDocument.source.filePath
     • continueOnError — default true; keep mapping after errors when possible
 
     ParseResult (owned by @blockml/bom):
@@ -53,13 +53,13 @@
       carries a span; otherwise BML_MAP_ERROR at 1:1. continueOnError still returns
       document when possible
     • Sync only; no throw on recoverable errors
-    • Does NOT call validator; does NOT expand directives</documentation>
+    • Does NOT call validator; does NOT expand directives]]></documentation>
 
   <references>
-    <see type="bomapi:ParseOptions" relation="Defines"></see>
-    <see type="bomapi:ParseResult" relation="Defines"></see>
-    <see type="parcap:Parse" relation="Defines"></see>
-    <see type="pardocumentation:MappingPrinciples" relation="ReadNext"></see>
+    <see type="bomapi:ParseOptions" relation="Defines" />
+    <see type="bomapi:ParseResult" relation="Defines" />
+    <see type="parcap:Parse" relation="Defines" />
+    <see type="pardocumentation:MappingPrinciples" relation="ReadNext" />
   </references>
 
 </block>

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

@@ -47,9 +47,9 @@
     XML byte fidelity NOT a gate — see @blockml/serializer RoundtripContract.</documentation>
 
   <references>
-    <see type="bomcap:BomEquals" relation="SeeAlso"></see>
-    <see type="serdocumentation:RoundtripContract" relation="SeeAlso"></see>
-    <see type="pardocumentation:Diagnostics" relation="ReadNext"></see>
+    <see type="bomcap:BomEquals" relation="SeeAlso" />
+    <see type="serdocumentation:RoundtripContract" relation="SeeAlso" />
+    <see type="pardocumentation:Diagnostics" relation="ReadNext" />
   </references>
 
 </block>

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

@@ -48,7 +48,7 @@
     In scope: single-file BML XML → lossless BomDocument.</documentation>
 
   <references>
-    <see type="pardocumentation:Introduction" relation="SeeAlso"></see>
+    <see type="pardocumentation:Introduction" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -46,7 +46,7 @@
     @blockml/cli orchestrator + @blockml/framework utilities + @blockml/validator.</documentation>
 
   <references>
-    <see type="pardocumentation:DesignDecisions" relation="ReadNext"></see>
+    <see type="pardocumentation:DesignDecisions" relation="ReadNext" />
   </references>
 
 </block>

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

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

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

@@ -46,8 +46,8 @@
     • Anonymous struct at specialized sites; context-bound implicit namespaces per 02_mbml.md</documentation>
 
   <references>
-    <see type="parcap:ParseTypeExpression" relation="Defines"></see>
-    <see type="pardocumentation:BlockMetadataMapping" relation="ReadNext"></see>
+    <see type="parcap:ParseTypeExpression" relation="Defines" />
+    <see type="pardocumentation:BlockMetadataMapping" relation="ReadNext" />
   </references>
 
 </block>

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

@@ -35,19 +35,19 @@
   <baseType>core:Documentation</baseType>
   <is>Phase A parser slice and deferred features</is>
 
-  <documentation>V1 (Phase A) parser implements:
-    • Hardcoded BML → BOM mapper for &lt;block> root documents
+  <documentation><![CDATA[V1 (Phase A) parser implements:
+    • Hardcoded BML → BOM mapper for <block> root documents
     • Single-file scope (B5) — no TypeRegistry bootstrap in parse()
     • Stage 1 structural BML validation (unknown Gerüst tags/attributes/directives); no TypeRegistry semantic checks (B8: XSD not Stage 1)
     • 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>
-    <see type="pardocumentation:SingleFileScope" relation="SeeAlso"></see>
+    <see type="pardocumentation:PublicApi" relation="ReadNext" />
+    <see type="pardocumentation:SingleFileScope" relation="SeeAlso" />
   </references>
 
 </block>

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

@@ -35,19 +35,19 @@
   <baseType>core:Documentation</baseType>
   <is>Comment binding algorithm (B11 parse side)</is>
 
-  <documentation>Cross-ref: org.blockml.bml.bom.documentation.XmlComments for Urmodell storage model.
+  <documentation><![CDATA[Cross-ref: org.blockml.bml.bom.documentation.XmlComments for Urmodell storage model.
 
     Parse algorithm:
     • pendingLeading comments → bind to next element as leadingComments
     • Comments after element end tag → trailingComments on that element
     • Storage: xmlTrivia on elements, memberSectionTrivia, metadataTrivia
 
-    Comment bodies only — without &lt;!-- / -->. Whitespace/layout not stored (B13).
-    Re-emit rules (B22) → @blockml/serializer.</documentation>
+    Comment bodies only — without <!-- / -->. Whitespace/layout not stored (B13).
+    Re-emit rules (B22) → @blockml/serializer.]]></documentation>
 
   <references>
-    <see type="bomdocumentation:XmlComments" relation="SeeAlso"></see>
-    <see type="pardocumentation:TypeDescriptorParsing" relation="ReadNext"></see>
+    <see type="bomdocumentation:XmlComments" relation="SeeAlso" />
+    <see type="pardocumentation:TypeDescriptorParsing" relation="ReadNext" />
   </references>
 
 </block>

package/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;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"}
+{"version":3,"file":"map-block.d.ts","sourceRoot":"","sources":["../../src/map/map-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,eAAe,EAKf,UAAU,EAkBX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAgtCjE,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"}