@blockml/bom 0.9.4 → 0.9.6

package/blocks/org/blockml/bml/bom/documentation/MemberValueSemantics.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — MemberValueSemantics
-  FQN: org.blockml.bml.bom.documentation.MemberValueSemantics
--->
-<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
-                      "
+<!--BOM Documentation — MemberValueSemantics
+  FQN: org.blockml.bml.bom.documentation.MemberValueSemantics-->
+<bomdocumentation:MemberValueSemantics xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,26 +18,30 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>MemberValueSemantics</name>
-  <type>bomdocumentation:MemberValueSemantics</type>
-  <baseType>core:Documentation</baseType>
-  <is>Property value deep-copy rules</is>
-
-  <documentation>Property values are never linked — always deep copies on instances and definitions.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Property value deep-copy rules
+  </is>
+  <documentation>
+    Property values are never linked — always deep copies on instances and definitions.
     Cross-instance FQN::id references exist only on associations (basePresets, Step.part, …).
-
+    Collection payloads (type multiplicity) use a JSON-like ['a', 'b'] array in one
+    attribute or element, or repeated instance elements of the same member name.
+    Space-separated association tokens are not a value form.
+    
     EnumType tokens (Standard, FQN::id) are resolution keys — BOM stores id + typeFqn only.
     Struct/primitive literals stay inline in authored form — not normalized at parse time.
-
+    
     LiteralValue: kind literal, opaque value, typeFqn, optional authoredPlacement (D9).
     ExpressionValue: kind expression, raw ${} text only in BOM; AST via parseExpression().
     InterpolatedTextValue: kind interpolated, full authored text with ${} holes; AST via parseInterpolatedText().
     AddressValue: parsed org.blockml.bml.type.Address shape.
-
-    Preset/config merge copies into render-time view — never writes references back to BomDocument.</documentation>
-
+    
+    Preset/config merge copies into render-time view — never writes references back to BomDocument.
+  </documentation>
   <references>
     <see type="bomvalue:MemberValue" relation="Defines" />
   </references>
-
-</block>
+</bomdocumentation:MemberValueSemantics>

package/blocks/org/blockml/bml/bom/documentation/PackageOwnership.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — PackageOwnership
-  FQN: org.blockml.bml.bom.documentation.PackageOwnership
--->
-<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
-                      "
+<!--BOM Documentation — PackageOwnership
+  FQN: org.blockml.bml.bom.documentation.PackageOwnership-->
+<bomdocumentation:PackageOwnership xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,34 +18,36 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PackageOwnership</name>
-  <type>bomdocumentation:PackageOwnership</type>
-  <baseType>core:Documentation</baseType>
-  <is>Toolchain package responsibilities for the Urmodell</is>
-
-  <documentation>@blockml/bom — all Urmodell interfaces, ParseResult/SerializeResult/ValidateResult (B26 + Stage 2),
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Toolchain package responsibilities for the Urmodell
+  </is>
+  <documentation>
+    @blockml/bom — all Urmodell interfaces, ParseResult/SerializeResult/ValidateResult (B26 + Stage 2),
     ValidateOptions, TypeRegistryReader, Diagnostic (compiler result type), bomEquals/stripProvenance (B20).
-
+    
     @blockml/builder — BomBuilder writable session; seal() → BomDocument.
-
+    
     @blockml/framework — TypeRegistry, forkBom, resolveEffectiveMembers, validateTypes, parseExpression.
     Utilities never mutate Urmodell.
-
+    
     @blockml/core — BlockML language BML corpus (org.blockml.bml.*); npm SSOT in node_modules.
-
+    
     @blockml/parser — BML → BomDocument mapper; single file per invocation; parse() → ParseResult.
     Does not own BOM interfaces or expand directives.
-
+    
     @blockml/serializer — BomDocument → canonical BML XML; serialize() → SerializeResult.
-
+    
     @blockml/validator — checks on BomDocument using framework utilities.
-
+    
     @blockml/cli — TypeRegistry bootstrap, validateTypes/validateConstraints, compile pipeline.
-
+    
     @blockml/lsp (V2) — reuses parser, validator, serializer; no parallel IDE AST.
-
+    
     @blockml/compiler — Target Registry facade.
-
-    @machineblocks/core — domain BML; extends TypeRegistry bootstrap.</documentation>
-
-</block>
+    
+    @machineblocks/core — domain BML; extends TypeRegistry bootstrap.
+  </documentation>
+</bomdocumentation:PackageOwnership>

package/blocks/org/blockml/bml/bom/documentation/PublicApi.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — PublicApi
-  FQN: org.blockml.bml.bom.documentation.PublicApi
--->
-<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
-                      "
+<!--BOM Documentation — PublicApi
+  FQN: org.blockml.bml.bom.documentation.PublicApi-->
+<bomdocumentation:PublicApi xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,37 +18,40 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PublicApi</name>
-  <type>bomdocumentation:PublicApi</type>
-  <baseType>core:Documentation</baseType>
-  <is>Shared parse/serialize/validate results (B26 + Stage 2)</is>
-
-  <documentation><![CDATA[ParseResult: document (BomDocument | null), diagnostics[], success (false if any error).
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Shared parse/serialize/validate results (B26 + Stage 2)
+  </is>
+  <documentation>
+    <![CDATA[
+    ParseResult: document (BomDocument | null), diagnostics[], success (false if any error).
+    
     SerializeResult: text (string | null), diagnostics[], success.
-
+    
     ValidateResult: optional pragmaticModel (forked BomDocument), diagnostics[], success.
-
+    
     ParseOptions: filePath (default "<memory>"), continueOnError (default true),
     optional parseValue host hook (injected after TypeRegistry bootstrap).
-
+    
     SerializeOptions: indent (default 2; 0=compact B13), xmlDeclaration (default false B17/B24).
-
+    
     ValidateOptions: typeRegistry (TypeRegistryReader), bootstrapPaths, libraryPaths, continueOnError (default true).
-
+    
     TypeRegistryReader: minimal get/has surface for ValidateOptions — implemented by @blockml/framework.
-
+    
     bomEquals(a, b): structural equality modulo provenance (B20).
     stripProvenance(node): deep-clone omitting sourceLocation, endLine, endColumn, provenance source.
     Drops SourceLocation-shaped fields such as typeSource/baseTypeSource.
     Preserves ImplementationBlock.source (code body).
-
-    Sync only. No throw on recoverable diagnostics. Diagnostic distinct from org.blockml.bml.core.Diagnostic.]]></documentation>
-
+    
+    Sync only. No throw on recoverable diagnostics. Diagnostic distinct from org.blockml.bml.core.Diagnostic.
+    ]]>
+  </documentation>
   <references>
     <see type="bomapi:ParseResult" relation="Defines" />
     <see type="bomapi:ValidateResult" relation="Defines" />
     <see type="bomcap:BomEquals" relation="Defines" />
   </references>
-
-</block>
+</bomdocumentation:PublicApi>

package/blocks/org/blockml/bml/bom/documentation/RelatedDiagnostics.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — RelatedDiagnostics
-  FQN: org.blockml.bml.bom.documentation.RelatedDiagnostics
--->
-<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
-                      "
+<!--BOM Documentation — RelatedDiagnostics
+  FQN: org.blockml.bml.bom.documentation.RelatedDiagnostics-->
+<bomdocumentation:RelatedDiagnostics xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,12 +18,14 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>RelatedDiagnostics</name>
-  <type>bomdocumentation:RelatedDiagnostics</type>
-  <baseType>core:Documentation</baseType>
-  <is>BOM-relevant diagnostic codes</is>
-
-  <documentation>BML_MISSING_BASE_TYPE, BML_MISSING_BLOCK_TYPE, BML_BLOCK_NAME_TYPE_MISMATCH,
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    BOM-relevant diagnostic codes
+  </is>
+  <documentation>
+    BML_MISSING_BASE_TYPE, BML_MISSING_BLOCK_TYPE, BML_BLOCK_NAME_TYPE_MISMATCH,
     BML_MISSING_SUBBLOCK_NAME, BML_SUBBLOCK_TYPE_MISMATCH, BML_EMBEDDED_BLOCKS_ON_SUBBLOCK,
     BML_NESTED_EMBEDDED_BLOCKS, BML_DUPLICATE_EMBEDDED_BLOCK, BML_DEFINITION_TYPE_MISMATCH,
     BML_MISSING_EMBEDDED_BLOCK_TYPE, BML_UNQUALIFIED_EMBEDDED_BLOCK_TYPE, BML_AMBIGUOUS_TYPE,
@@ -45,7 +41,7 @@
     BML_ABSTRACT_MEMBER_NOT_IMPLEMENTED, BML_READONLY_MEMBER_WRITE, BML_STANDALONE_COMPOSITION,
     BML_NESTED_COMPOSITION, BML_NAMESPACE_*, BML_XML_*, BML_PRESET_CYCLE, BML_GENERIC_*, BML_TYPE_BOUND_NOT_SATISFIED,
     BML_UNKNOWN_CONTRACT, BML_CONTRACT_*, BML_EXPR_UNKNOWN_PROPERTY.
-
-    Full catalog: org.blockml.bml.diagnostic.* (@blockml/core) and 06_compiler.md.</documentation>
-
-</block>
+    
+    Full catalog: org.blockml.bml.diagnostic.* (@blockml/core) and 06_compiler.md.
+  </documentation>
+</bomdocumentation:RelatedDiagnostics>

package/blocks/org/blockml/bml/bom/documentation/ScopeExclusions.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — ScopeExclusions
-  FQN: org.blockml.bml.bom.documentation.ScopeExclusions
--->
-<block
-  xmlns="http://blockml.org/bml"
-  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
-                      "
+<!--BOM Documentation — ScopeExclusions
+  FQN: org.blockml.bml.bom.documentation.ScopeExclusions-->
+<bomdocumentation:ScopeExclusions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,13 +18,15 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ScopeExclusions</name>
-  <type>bomdocumentation:ScopeExclusions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Topics intentionally outside @blockml/bom</is>
-
-  <documentation>Not specified in this library:
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Topics intentionally outside @blockml/bom
+  </is>
+  <documentation>
+    Not specified in this library:
+    
     Expression AST node union → 10_expression_language.md
     Embedded expressions in implementations → 10_expression_language.md
     BML → BOM mapping algorithm → @blockml/parser, 13_bml_to_bom_mapping.md
@@ -41,7 +37,7 @@
     MBOM → SCAD → 04_types.md, 05_scad_renderer.md
     ManagedObject / synthetic accessors → 08_managed_object.md
     Built-in #math / #strings → @blockml/core services
-
-    Also outside Urmodell: EffectiveMemberSet, TypeRegistry (core utilities).</documentation>
-
-</block>
+    
+    Also outside Urmodell: EffectiveMemberSet, TypeRegistry (core utilities).
+  </documentation>
+</bomdocumentation:ScopeExclusions>

package/blocks/org/blockml/bml/bom/documentation/SubBlockAndEmbeddedBlocks.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — SubBlockAndEmbeddedBlocks
-  FQN: org.blockml.bml.bom.documentation.SubBlockAndEmbeddedBlocks
--->
-<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
-                      "
+<!--BOM Documentation — SubBlockAndEmbeddedBlocks
+  FQN: org.blockml.bml.bom.documentation.SubBlockAndEmbeddedBlocks-->
+<bomdocumentation:SubBlockAndEmbeddedBlocks xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,22 +18,24 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>SubBlockAndEmbeddedBlocks</name>
-  <type>bomdocumentation:SubBlockAndEmbeddedBlocks</type>
-  <baseType>core:Documentation</baseType>
-  <is>Sub-Block FQN derivation and inline library embeds</is>
-
-  <documentation>Sub-Blocks omit type in BML by convention. FQN derived recursively:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Sub-Block FQN derivation and inline library embeds
+  </is>
+  <documentation>
+    Sub-Blocks omit type in BML by convention. FQN derived recursively:
     parent.type + "." + name (BML_SUBBLOCK_TYPE_MISMATCH if explicit type differs).
-
+    
     Sub-Blocks share one BomDocument; may nest arbitrarily. Must not declare embeddedBlocks
     (BML_EMBEDDED_BLOCKS_ON_SUBBLOCK).
-
+    
     embeddedBlocks: Inline Library on document root only. Each entry is a virtual .bml file.
     FQN = fully qualified type element value — not nested under root. No nested embeds
     (BML_NESTED_EMBEDDED_BLOCKS). Duplicate FQNs → BML_DUPLICATE_EMBEDDED_BLOCK.
     Shadows library definitions within BomDocument; invisible externally.
-
-    Composition references to embeds must use fully qualified block type.</documentation>
-
-</block>
+    
+    Composition references to embeds must use fully qualified block type.
+  </documentation>
+</bomdocumentation:SubBlockAndEmbeddedBlocks>

package/blocks/org/blockml/bml/bom/documentation/TypeExpressionsOverview.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — TypeExpressionsOverview
-  FQN: org.blockml.bml.bom.documentation.TypeExpressionsOverview
--->
-<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
-                      "
+<!--BOM Documentation — TypeExpressionsOverview
+  FQN: org.blockml.bml.bom.documentation.TypeExpressionsOverview-->
+<bomdocumentation:TypeExpressionsOverview xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,25 +18,26 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>TypeExpressionsOverview</name>
-  <type>bomdocumentation:TypeExpressionsOverview</type>
-  <baseType>core:Documentation</baseType>
-  <is>Parse-time type expression model</is>
-
-  <documentation>TypeExpression (alias TypeDescriptor in V1) — structured parse-time AST, not a ValueType.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Parse-time type expression model
+  </is>
+  <documentation>
+    TypeExpression (alias TypeDescriptor in V1) — structured parse-time AST, not a ValueType.
     Used for Capability inputType/outputType and Property type attributes.
-
+    
     Union variants: named, union, grouped, genericParam, self, anonymousStruct.
     grouped wraps a TypeExpression for nested multiplicity: (T[])[] or (A | B)[].
-
+    
     Anonymous struct = shorthand for inline class with ordered fields (FunctionMapping positional order).
     Single primitive = NamedTypeReference directly — not wrapped in one-field struct.
-
+    
     Union variant discrimination and AST are validateTypes()/parseExpression() utility results —
-    not stored in Canonical BOM.</documentation>
-
+    not stored in Canonical BOM.
+  </documentation>
   <references>
     <see type="bomtype:TypeExpression" relation="Defines" />
   </references>
-
-</block>
+</bomdocumentation:TypeExpressionsOverview>

package/blocks/org/blockml/bml/bom/documentation/ValidationResponsibilities.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — ValidationResponsibilities
-  FQN: org.blockml.bml.bom.documentation.ValidationResponsibilities
--->
-<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
-                      "
+<!--BOM Documentation — ValidationResponsibilities
+  FQN: org.blockml.bml.bom.documentation.ValidationResponsibilities-->
+<bomdocumentation:ValidationResponsibilities xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,13 +18,15 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ValidationResponsibilities</name>
-  <type>bomdocumentation:ValidationResponsibilities</type>
-  <baseType>core:Documentation</baseType>
-  <is>Full validator checklist on BomDocument</is>
-
-  <documentation>Parser produces BomDocument. Validator (@blockml/validator + @blockml/framework) checks:
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Full validator checklist on BomDocument
+  </is>
+  <documentation>
+    Parser produces BomDocument. Validator (@blockml/validator + @blockml/framework) checks:
+    
     Member namespace uniqueness; baseType in TypeRegistry; property values inline deep copies;
     resolveEffectiveMembers for expression refs; effective version (BML_MISSING_VERSION);
     library block.version >= library.version; bml:version asserts (BML_UNKNOWN_VERSION);
@@ -41,11 +37,10 @@
     contracts merge order; validateConstraints after resolveEffectiveMembers;
     readOnly enforcement (BML_READONLY_MEMBER_WRITE); library blocks/deps resolve;
     no outer library re-export from inner library (BML_LIBRARY_NESTING_VIOLATION).
-
-    Validator does NOT expand directives, assign auto-IDs, or interpret aggregations.</documentation>
-
+    
+    Validator does NOT expand directives, assign auto-IDs, or interpret aggregations.
+  </documentation>
   <references>
     <see type="bomdocumentation:RelatedDiagnostics" relation="SeeAlso" />
   </references>
-
-</block>
+</bomdocumentation:ValidationResponsibilities>

package/blocks/org/blockml/bml/bom/documentation/VersionRules.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — VersionRules
-  FQN: org.blockml.bml.bom.documentation.VersionRules
--->
-<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
-                      "
+<!--BOM Documentation — VersionRules
+  FQN: org.blockml.bml.bom.documentation.VersionRules-->
+<bomdocumentation:VersionRules xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,18 +18,20 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>VersionRules</name>
-  <type>bomdocumentation:VersionRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>Effective block version and instance version asserts</is>
-
-  <documentation>Definition effectiveBlockVersion = own version | library.version (if exported) | BML_MISSING_VERSION.
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Effective block version and instance version asserts
+  </is>
+  <documentation>
+    Definition effectiveBlockVersion = own version | library.version (if exported) | BML_MISSING_VERSION.
     Block in library: version >= library.version when both declared.
-
+    
     Same-document Sub-Block refs: bml:version not allowed as resolution hint.
     External refs: bml:version omitted → registry context; present → exact assert (BML_UNKNOWN_VERSION).
     Library catalog sugar (readMe, bootstrap, dependencies, blocks): same bml:version rules.
-
-    Framework convention: version only on Library.bml for org.blockml.bml.* / com.machineblocks.bml.*</documentation>
-
-</block>
+    
+    Framework convention: version only on Library.bml for org.blockml.bml.* / com.machineblocks.bml.*
+  </documentation>
+</bomdocumentation:VersionRules>

package/blocks/org/blockml/bml/bom/documentation/XmlComments.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — XmlComments
-  FQN: org.blockml.bml.bom.documentation.XmlComments
--->
-<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
-                      "
+<!--BOM Documentation — XmlComments
+  FQN: org.blockml.bml.bom.documentation.XmlComments-->
+<bomdocumentation:XmlComments xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,24 +18,26 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>XmlComments</name>
-  <type>bomdocumentation:XmlComments</type>
-  <baseType>core:Documentation</baseType>
-  <is>XML comment binding rules (B11, B22)</is>
-
-  <documentation>Comments are part of maximum authored surface — parser binds, never drops.
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    XML comment binding rules (B11, B22)
+  </is>
+  <documentation>
+    Comments are part of maximum authored surface — parser binds, never drops.
+    
     1. Comment(s) before element E → E.xmlTrivia.leadingComments[] (document order)
     2. Comment(s) after E end tag before next sibling → trailingComments[] (incl. same-line)
     3. File-header before root block → root BlockDefinition.xmlTrivia.leadingComments
     4. Before member-section container → memberSectionTrivia[section]
     5. Before metadata child (name, final, …) → metadataTrivia[localName]
     6. Dangling comment → trailingComments of previous sibling or root
-
+    
     NOT preserved (Phase A): processing instructions; formatting whitespace (B13); attribute order.
     DO preserve: comments (B11); dual placement (D9); CDATA form (D8).
-
+    
     Serializer: re-emit leading before element; trailing on next line after end tag + blank line (B22).
-    Sibling order follows B12. Layout whitespace not part of BOM equality (B10/B13).</documentation>
-
-</block>
+    Sibling order follows B12. Layout whitespace not part of BOM equality (B10/B13).
+  </documentation>
+</bomdocumentation:XmlComments>