@blockml/bom 0.9.4 → 0.9.5

package/blocks/org/blockml/bml/bom/document/BomDocument.bml

@@ -1,12 +1,6 @@
-<!--
-  BOM Urmodell — BomDocument
-  FQN: org.blockml.bml.bom.document.BomDocument
--->
-<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 Urmodell — BomDocument
+  FQN: org.blockml.bml.bom.document.BomDocument-->
+<bomdoc:BomDocument xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -23,27 +17,35 @@
   xmlns:def="org.blockml.bml.definition"
   xmlns:type="org.blockml.bml.type">
 
-  <name>BomDocument</name>
-  <type>bomdoc:BomDocument</type>
-  <baseType>bom:UrmodellType</baseType>
-  <is>Root Urmodell document — every parsed BML file</is>
-
-  <documentation>Immutable after parse or BomBuilder.seal(). kind is always "block" in V1.</documentation>
-
+  <baseType>
+    bom:UrmodellType
+  </baseType>
+  <is>
+    Root Urmodell document — every parsed BML file
+  </is>
+  <documentation>
+    Immutable after parse or BomBuilder.seal(). kind is always "block" in V1.
+  </documentation>
   <examples>
-    <example title="Calibrator reference shape">Reference BomDocument from com.machineblocks.bml.calibration.Calibrator. Root BlockDefinition with declared members, subBlocks (Utils, Base, StudDiameter, …), and compositions from _utils/_parts aggregations. Inherited native properties are NOT in members[].</example>
+    <example title="Calibrator reference shape">
+      Reference BomDocument from com.machineblocks.bml.calibration.Calibrator. Root BlockDefinition with declared members, subBlocks (Utils, Base, StudDiameter, …), and compositions from _utils/_parts aggregations. Inherited native properties are NOT in members[].
+    </example>
   </examples>
-
   <properties>
     <kind type="type:Text">
-      <documentation>V1: always "block". (required)</documentation>
+      <documentation>
+        V1: always "block". (required)
+      </documentation>
     </kind>
     <source type="bomcommon:SourceInfo">
-      <documentation>source (required). TS type: bomcommon:SourceInfo.</documentation>
+      <documentation>
+        source (required). TS type: bomcommon:SourceInfo.
+      </documentation>
     </source>
     <block type="bomblock:BlockDefinition">
-      <documentation>block (required). TS type: bomblock:BlockDefinition.</documentation>
+      <documentation>
+        block (required). TS type: bomblock:BlockDefinition.
+      </documentation>
     </block>
   </properties>
-
-</block>
+</bomdoc:BomDocument>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — AbstractionPrinciple
-  FQN: org.blockml.bml.bom.documentation.AbstractionPrinciple
--->
-<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 — AbstractionPrinciple
+  FQN: org.blockml.bml.bom.documentation.AbstractionPrinciple-->
+<bomdocumentation:AbstractionPrinciple xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,23 +18,24 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>AbstractionPrinciple</name>
-  <type>bomdocumentation:AbstractionPrinciple</type>
-  <baseType>core:Documentation</baseType>
-  <is>Lossless representation and roundtrip guarantee</is>
-
-  <documentation>A BOM document is a lossless representation of BML source. It preserves authored
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Lossless representation and roundtrip guarantee
+  </is>
+  <documentation>
+    A BOM document is a lossless representation of BML source. It preserves authored
     structure and values — directives, aggregation declarations, literal syntax, unresolved
     type references, namespace bindings, and bml:xml metadata. BOM makes no statement about
     directive expansion, aggregation interpretation, or block rendering.
-
+    
     Maximum authored surface: render targets and the serializer must read as much of the
     original document as the Urmodell can carry. Prefer first-class fields over hidden side channels.
-
-    BML → BOM → BML must always be possible.</documentation>
-
+    
+    BML → BOM → BML must always be possible.
+  </documentation>
   <references>
     <see type="bomdocumentation:AuthoredSurfaceTable" relation="ReadNext" />
   </references>
-
-</block>
+</bomdocumentation:AbstractionPrinciple>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — ArchitectureOverview
-  FQN: org.blockml.bml.bom.documentation.ArchitectureOverview
--->
-<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 — ArchitectureOverview
+  FQN: org.blockml.bml.bom.documentation.ArchitectureOverview-->
+<bomdocumentation:ArchitectureOverview 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,27 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ArchitectureOverview</name>
-  <type>bomdocumentation:ArchitectureOverview</type>
-  <baseType>core:Documentation</baseType>
-  <is>BML source to render pipeline</is>
-
-  <documentation>Pipeline roles:
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    BML source to render pipeline
+  </is>
+  <documentation>
+    Pipeline roles:
+    
     BML source → universal authoring and interchange format
     Urmodell (BOM) → canonical, immutable, lossless parse/build result (SSOT, read-only)
     BomBuilder (V3) → planned writable session; seal() → Urmodell (same types)
     Pragmatic Model → validator default fork + optional renderer forks (resolve only)
     Framework Utilities → derived views / merges on forks — never mutate Urmodell
     Render Target → chooses Urmodell / pragmatic / own forks + optional target working model
-
+    
     Block in BML is the mandatory input concept — not a uniform runtime object model.
     The parser must read block documents; validators walk baseType chains. Internal
-    representation after parse is implementation freedom.</documentation>
-
+    representation after parse is implementation freedom.
+  </documentation>
   <references>
     <see type="bomdocumentation:AbstractionPrinciple" relation="ReadNext" />
   </references>
-
-</block>
+</bomdocumentation:ArchitectureOverview>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — AuthoredSurfaceTable
-  FQN: org.blockml.bml.bom.documentation.AuthoredSurfaceTable
--->
-<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 — AuthoredSurfaceTable
+  FQN: org.blockml.bml.bom.documentation.AuthoredSurfaceTable-->
+<bomdocumentation:AuthoredSurfaceTable xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,17 +18,21 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>AuthoredSurfaceTable</name>
-  <type>bomdocumentation:AuthoredSurfaceTable</type>
-  <baseType>core:Documentation</baseType>
-  <is>What BOM stores vs what downstream interprets</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What BOM stores vs what downstream interprets
+  </is>
   <documentation>
     # What BOM stores vs what downstream interprets
-
+    
     - bml:each / bml:if / bml:with → directives[] unexpanded → Renderer expands
     - xmlns / xmlns:prefix → SourceInfo.namespaceBindings 1:1 authored → Serializer QName emit (B21)
     - xsi:schemaLocation / xsi:noNamespaceSchemaLocation → SourceInfo (B25) → re-emit on root
+    - document root tag → SourceInfo.rootForm ("block" | "type") → Serializer form-fidelity (doc:DocumentFormat)
+    - Sub-Block / embed wrapper tag → BlockDefinition.wrapperForm → Serializer form-fidelity
+    - child name / type elements on a definition → authoredNameChild / authoredTypeChild → style warnings (doc:DocumentFormat)
     - bml:xml → xmlRendering block+member — NOT directives[] → Serializer, FatBlock, XSD
     - bml:generics → BlockInstance.generics (and illegal-host copies) — NOT directives[] → Validator binds genericTypes (open params required; defaultType may be overridden)
     - element|attribute dual placement → authoredPlacement (D9) → MUST roundtrip authored form
@@ -49,5 +47,4 @@
     - Capabilities → CapabilityDefinition in BOM → Renderer interprets (not invoked at parse)
     - XML comments → XmlTrivia on following element (B11) → Serializer re-emits
   </documentation>
-
-</block>
+</bomdocumentation:AuthoredSurfaceTable>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — CalibratorExample
-  FQN: org.blockml.bml.bom.documentation.CalibratorExample
--->
-<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 — CalibratorExample
+  FQN: org.blockml.bml.bom.documentation.CalibratorExample-->
+<bomdocumentation:CalibratorExample xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,30 +18,31 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>CalibratorExample</name>
-  <type>bomdocumentation:CalibratorExample</type>
-  <baseType>core:Documentation</baseType>
-  <is>Reference BomDocument walkthrough</is>
-
-  <documentation>Source: com.machineblocks.bml.calibration.Calibrator.bml
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Reference BomDocument walkthrough
+  </is>
+  <documentation>
+    Source: com.machineblocks.bml.calibration.Calibrator.bml
+    
     BomDocument kind block → BlockDefinition Calibrator
     type com.machineblocks.bml.calibration.Calibrator, baseType CompositeBlock, version 1.0.0
-
+    
     Declared members only (not inherited size, offset, baseColor):
     numberOfSamples, font, size (ExpressionValue), _utils aggregation (Utils bean context),
     _parts aggregation (4 calibration rows).
-
+    
     subBlocks: Utils, Base, StudDiameter, BaseWallThickness, TubeDiameter, PinDiameter.
-
+    
     compositions: _utils → Utils instance; _parts → Base, StudDiameter, Base (id=base_wall), …
-
+    
     Observations: Sub-Block refs by short name resolved via subBlocks[] tree.
     @utils.formatValue and #math.* stored as ExpressionValue { raw }.
-    Inherited native properties not in members[] — validator uses resolveEffectiveMembers().</documentation>
-
+    Inherited native properties not in members[] — validator uses resolveEffectiveMembers().
+  </documentation>
   <references>
     <see type="bomdoc:BomDocument" relation="SeeAlso" />
   </references>
-
-</block>
+</bomdocumentation:CalibratorExample>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — CompositionDirectives
-  FQN: org.blockml.bml.bom.documentation.CompositionDirectives
--->
-<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 — CompositionDirectives
+  FQN: org.blockml.bml.bom.documentation.CompositionDirectives-->
+<bomdocumentation:CompositionDirectives 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>CompositionDirectives</name>
-  <type>bomdocumentation:CompositionDirectives</type>
-  <baseType>core:Documentation</baseType>
-  <is>Directive placement and Thymeleaf model</is>
-
-  <documentation>Directives follow Thymeleaf model — attributes on modified element, stored unexpanded.
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Directive placement and Thymeleaf model
+  </is>
+  <documentation>
+    Directives follow Thymeleaf model — attributes on modified element, stored unexpanded.
+    
     bml:id, bml:version, bml:bean, bml:scope, bml:generics → BlockInstance fields (NOT directives[]).
     bml:generics binds genericTypes (attribute or child element; parentheses required).
     Open parameters require a binding; parameters with defaultType may omit it.
@@ -38,12 +34,11 @@
     Misplaced bml:generics is still stored so validate() can emit BML_GENERICS_DIRECTIVE_NOT_ALLOWED.
     bml:with → composition, aggregation, bml:container, block instances.
     bml:each, bml:if, bml:unless → bml:container, block instances.
-
+    
     Dynamic ids: bml:id="${ 'val_' + i }" stored as ExpressionValue or literal on BlockInstance.id.
-    Omitted bml:id stored absent — parser does not assign auto-IDs.</documentation>
-
+    Omitted bml:id stored absent — parser does not assign auto-IDs.
+  </documentation>
   <references>
     <see type="bomcomp:DirectiveAttribute" relation="Defines" />
   </references>
-
-</block>
+</bomdocumentation:CompositionDirectives>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — DesignDecisions
-  FQN: org.blockml.bml.bom.documentation.DesignDecisions
--->
-<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 — DesignDecisions
+  FQN: org.blockml.bml.bom.documentation.DesignDecisions-->
+<bomdocumentation:DesignDecisions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,41 +18,43 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>DesignDecisions</name>
-  <type>bomdocumentation:DesignDecisions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Normative Urmodell design decisions</is>
-
-  <documentation>Immutability: Urmodell (BomDocument) is immutable after parse or BomBuilder.seal().
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Normative Urmodell design decisions
+  </is>
+  <documentation>
+    Immutability: Urmodell (BomDocument) is immutable after parse or BomBuilder.seal().
     No utility or renderer writes derived data back. Validator/renderers use pragmatic forks.
-
+    
     Builder / LSP reuse: construction-friendly, provenance-agnostic interfaces. Parser and
     BomBuilder produce the same graph. Source spans optional on types but populated by parser.
-
+    
     Member inheritance: utility lookup only. BOM stores declared members per block.
     resolveEffectiveMembers() → EffectiveMemberSet — never flattened into BOM.
-
+    
     Capabilities: stored in BOM; no synthetic getter/setter generation; renderer interprets.
-
+    
     Member identity: uniqueness by resolved (namespace, name).
-
+    
     Composition: nested inside aggregation on definitions only; instances open aggregations directly.
-
+    
     Sub-Blocks: nested in BlockDefinition.subBlocks[]; FQN = parent.type + "." + name.
-
+    
     Embedded Blocks: root embeddedBlocks[] only — virtual .bml files; FQN = type element.
-
+    
     Directives: flow-control bml:* → directives[] unexpanded. bml:id/version → BlockInstance fields.
     bml:xml → first-class xmlRendering (not directives[]).
-
+    
     XML comments (B11): bind to following element; trailing on next line + blank line (B22).
     Whitespace (B13): not on Urmodell. Dual placement (D9): store authoredPlacement.
     Visibility (B14): logical name in BOM; emit _/__ from visibility.
-
+    
     Instance version: bml:version optional exact assert on external refs (BML_UNKNOWN_VERSION).
     Definition version: effectiveBlockVersion = own version | library.version | error.
     Instance id: bml:id only on BlockInstance.id; no auto-ID in BomDocument; bml:each requires id.
-
-    Property values: deep copy only — never linked. FQN::id cross-instance refs only on associations.</documentation>
-
-</block>
+    
+    Property values: deep copy only — never linked. FQN::id cross-instance refs only on associations.
+  </documentation>
+</bomdocumentation:DesignDecisions>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — InstanceIdRules
-  FQN: org.blockml.bml.bom.documentation.InstanceIdRules
--->
-<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 — InstanceIdRules
+  FQN: org.blockml.bml.bom.documentation.InstanceIdRules-->
+<bomdocumentation:InstanceIdRules 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>InstanceIdRules</name>
-  <type>bomdocumentation:InstanceIdRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>bml:id identity and cross-instance references</is>
-
-  <documentation>bml:id identifies child within parent composition tree. No FQN fallback.
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    bml:id identity and cross-instance references
+  </is>
+  <documentation>
+    bml:id identifies child within parent composition tree. No FQN fallback.
+    
     Pipeline: Parse stores authored id → Validate cross-refs → Expand directives →
     Resolve/auto-ID static unreferenced children → Render.
-
+    
     Auto-IDs NOT in BomDocument — only on expanded composition tree.
     Referenced instances and bml:each require explicit bml:id (BML_MISSING_ID).
-
+    
     Auto-ID: hash(typeFqn, sibling index post-expansion, parent partId) → 6 hex chars.
-
+    
     Qualified FQN::id: target in public aggregation, literal id, literal reference token.
-    Same-document unqualified ids resolve within visible aggregations.</documentation>
-
-</block>
+    Same-document unqualified ids resolve within visible aggregations.
+  </documentation>
+</bomdocumentation:InstanceIdRules>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — Introduction
-  FQN: org.blockml.bml.bom.documentation.Introduction
--->
-<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 — Introduction
+  FQN: org.blockml.bml.bom.documentation.Introduction-->
+<bomdocumentation:Introduction xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -24,27 +18,28 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>Introduction</name>
-  <type>bomdocumentation:Introduction</type>
-  <baseType>core:Documentation</baseType>
-  <is>Purpose and scope of the BOM Urmodell package</is>
-
-  <documentation>The @blockml/bom package defines the formal Block Object Model (Urmodell) — canonical,
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Purpose and scope of the BOM Urmodell package
+  </is>
+  <documentation>
+    The @blockml/bom package defines the formal Block Object Model (Urmodell) — canonical,
     immutable, lossless parse/build results produced by @blockml/parser (or V3 BomBuilder.seal())
     and consumed by serializer, validator, compiler, LSP, and render targets.
-
+    
     This library (org.blockml.bml.bom.*) is the SSOT. TypeScript in packages/bom/src/ implements
     it. Parity tests in packages/bom/test/ verify BML ↔ TS alignment.
-
+    
     Related reading outside this package:
     • Conceptual foundations — 01_bom_core.md
     • BML authoring syntax — org.blockml.bml.documentation.* (@blockml/core)
     • BML → BOM mapping — @blockml/parser (13_bml_to_bom_mapping.md)
-    • Expression AST — 10_expression_language.md</documentation>
-
+    • Expression AST — 10_expression_language.md
+  </documentation>
   <references>
     <see type="bomdocumentation:LayerSeparation" relation="ReadNext" />
     <see type="bomdocumentation:ArchitectureOverview" relation="SeeAlso" />
   </references>
-
-</block>
+</bomdocumentation:Introduction>

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

@@ -1,12 +1,6 @@
-<!--
-  BOM Documentation — LayerSeparation
-  FQN: org.blockml.bml.bom.documentation.LayerSeparation
--->
-<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 — LayerSeparation
+  FQN: org.blockml.bml.bom.documentation.LayerSeparation-->
+<bomdocumentation:LayerSeparation 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,25 @@
   xmlns:type="org.blockml.bml.type"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>LayerSeparation</name>
-  <type>bomdocumentation:LayerSeparation</type>
-  <baseType>core:Documentation</baseType>
-  <is>Urmodell types vs BML definition meta-model</is>
-
-  <documentation>Two layers share names but differ in semantics:
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Urmodell types vs BML definition meta-model
+  </is>
+  <documentation>
+    Two layers share names but differ in semantics:
+    
     org.blockml.bml.definition.* (@blockml/core) — BML meta-model. Describes what block
     definition documents mean (PropertyDefinition, BlockDefinition meta-type, …).
-
+    
     org.blockml.bml.bom.* (this package) — Urmodell runtime. Parse-result data structures
     (BomDocument, BlockDefinition as TS interface, MemberDefinition, …).
-
+    
     Example: org.blockml.bml.definition.BlockDefinition describes BML syntax; org.blockml.bml.bom.block.BlockDefinition
-    describes the parser output shape. See 19_definition_blocks_and_bml_xml.md.</documentation>
-
+    describes the parser output shape. See 19_definition_blocks_and_bml_xml.md.
+  </documentation>
   <references>
     <see type="def:BlockDefinition" relation="SeeAlso" />
   </references>
-
-</block>
+</bomdocumentation:LayerSeparation>

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,27 @@
   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, …).
-
+    
     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>