@blockml/bom 0.1.0

package/blocks/org/blockml/bml/bom/Library.bml

@@ -0,0 +1,153 @@
+<!--
+  BlockML BOM Library Descriptor
+  FQN: org.blockml.bml.bom.Library
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type"
+  xmlns:cap="org.blockml.bml.capability">
+
+  <name>Library</name>
+  <type>blockml:Library</type>
+  <baseType>core:BlockLibrary</baseType>
+  <is>The BlockML BOM Urmodell library catalog</is>
+
+  <documentation>
+    Canonical BOM object model (Urmodell) for BlockML — TypeScript contracts in packages/bom/src/
+    implement this library. Consumed by parser, serializer, validator, compiler, and LSP.
+    Distinct from org.blockml.bml.definition.* (BML meta-model in @blockml/core).
+    Membership is defined exclusively by this blocks list.
+  </documentation>
+
+  <version>0.1.0</version>
+
+  <language>
+    <English />
+  </language>
+
+  <properties>
+    <description>
+      <value>BlockML BOM Urmodell library</value>
+    </description>
+  </properties>
+
+  <aggregations>
+    <readMe>
+      <composition>
+        <bom:README />
+      </composition>
+    </readMe>
+    <dependencies>
+      <composition>
+        <blockml:Library />
+      </composition>
+    </dependencies>
+    <blocks>
+      <composition><bom:UrmodellType /></composition>
+      <composition><bomcommon:SourceLocation /></composition>
+      <composition><bomcommon:SourceInfo /></composition>
+      <composition><bomcommon:XmlTrivia /></composition>
+      <composition><bomcommon:MemberSectionName /></composition>
+      <composition><bomcommon:MetadataElementTrivia /></composition>
+      <composition><bomcommon:XmlNodeKind /></composition>
+      <composition><bomcommon:CharacterDataForm /></composition>
+      <composition><bomcommon:XmlRenderingBlock /></composition>
+      <composition><bomcommon:XmlRenderingMember /></composition>
+      <composition><bomcommon:DiagnosticSeverity /></composition>
+      <composition><bomcommon:Diagnostic /></composition>
+      <composition><bomvalue:Address /></composition>
+      <composition><bomvalue:MemberValue /></composition>
+      <composition><bomvalue:LiteralValue /></composition>
+      <composition><bomvalue:ExpressionValue /></composition>
+      <composition><bomvalue:AddressValue /></composition>
+      <composition><bomtype:Multiplicity /></composition>
+      <composition><bomtype:InstanceConfiguration /></composition>
+      <composition><bomtype:TypeExpression /></composition>
+      <composition><bomtype:TypeDescriptor /></composition>
+      <composition><bomtype:NamedTypeReference /></composition>
+      <composition><bomtype:UnionTypeExpression /></composition>
+      <composition><bomtype:GenericParameterReference /></composition>
+      <composition><bomtype:SelfTypeReference /></composition>
+      <composition><bomtype:StructField /></composition>
+      <composition><bomtype:AnonymousStructType /></composition>
+      <composition><bomblock:TypeReferenceEntityInstance /></composition>
+      <composition><bomblock:GenericType /></composition>
+      <composition><bomblock:KeywordEntry /></composition>
+      <composition><bomblock:DocumentationProseEntry /></composition>
+      <composition><bomblock:AliasEntry /></composition>
+      <composition><bomblock:ChangelogEntry /></composition>
+      <composition><bomblock:DocumentationExample /></composition>
+      <composition><bomblock:DocumentationReference /></composition>
+      <composition><bomblock:BlockDefinition /></composition>
+      <composition><bommember:ConstrainableDefinition /></composition>
+      <composition><bommember:MemberDefinitionBase /></composition>
+      <composition><bommember:MemberDefinition /></composition>
+      <composition><bommember:PropertyValueEntry /></composition>
+      <composition><bommember:PropertyDefinition /></composition>
+      <composition><bommember:AggregationDefinition /></composition>
+      <composition><bommember:AssociationDefinition /></composition>
+      <composition><bommember:EmbeddedExpression /></composition>
+      <composition><bommember:ImplementationBlock /></composition>
+      <composition><bommember:CapabilityDefinition /></composition>
+      <composition><bomcomp:WithBinding /></composition>
+      <composition><bomcomp:DirectiveAttribute /></composition>
+      <composition><bomcomp:EachDirective /></composition>
+      <composition><bomcomp:IfDirective /></composition>
+      <composition><bomcomp:UnlessDirective /></composition>
+      <composition><bomcomp:WithDirective /></composition>
+      <composition><bomcomp:BlockInstance /></composition>
+      <composition><bomcomp:CompositionTemplate /></composition>
+      <composition><bomcomp:InstanceAggregationComposition /></composition>
+      <composition><bomcomp:CompositionNode /></composition>
+      <composition><bomcomp:BlockInstanceNode /></composition>
+      <composition><bomcomp:VirtualContainerNode /></composition>
+      <composition><bomdoc:BomDocument /></composition>
+      <composition><bomapi:ParseOptions /></composition>
+      <composition><bomapi:SerializeOptions /></composition>
+      <composition><bomapi:ParseResult /></composition>
+      <composition><bomapi:SerializeResult /></composition>
+      <composition><bomapi:ValidateOptions /></composition>
+      <composition><bomapi:ValidateResult /></composition>
+      <composition><bomapi:TypeRegistryReader /></composition>
+      <composition><bomcap:StripProvenance /></composition>
+      <composition><bomcap:BomEquals /></composition>
+      <composition><bomdocumentation:Introduction /></composition>
+      <composition><bomdocumentation:LayerSeparation /></composition>
+      <composition><bomdocumentation:ArchitectureOverview /></composition>
+      <composition><bomdocumentation:AbstractionPrinciple /></composition>
+      <composition><bomdocumentation:AuthoredSurfaceTable /></composition>
+      <composition><bomdocumentation:DesignDecisions /></composition>
+      <composition><bomdocumentation:PackageOwnership /></composition>
+      <composition><bomdocumentation:PublicApi /></composition>
+      <composition><bomdocumentation:XmlComments /></composition>
+      <composition><bomdocumentation:SubBlockAndEmbeddedBlocks /></composition>
+      <composition><bomdocumentation:TypeExpressionsOverview /></composition>
+      <composition><bomdocumentation:MemberValueSemantics /></composition>
+      <composition><bomdocumentation:CompositionDirectives /></composition>
+      <composition><bomdocumentation:InstanceIdRules /></composition>
+      <composition><bomdocumentation:VersionRules /></composition>
+      <composition><bomdocumentation:ValidationResponsibilities /></composition>
+      <composition><bomdocumentation:RelatedDiagnostics /></composition>
+      <composition><bomdocumentation:CalibratorExample /></composition>
+      <composition><bomdocumentation:ScopeExclusions /></composition>
+    </blocks>
+  </aggregations>
+
+</block>

package/blocks/org/blockml/bml/bom/README.bml

@@ -0,0 +1,55 @@
+<!--
+  BlockML BOM — README
+  FQN: org.blockml.bml.bom.README
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>README</name>
+  <type>blockml:README</type>
+  <baseType>core:ReadMe</baseType>
+  <is>Reading entry for the BOM Urmodell library</is>
+
+  <documentation>
+    The @blockml/bom package owns the Canonical BOM (Urmodell) — lossless, immutable parse results.
+    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.
+
+    Start reading at org.blockml.bml.bom.documentation.Introduction (ReadNext chain).
+
+    Layer separation:
+    • org.blockml.bml.definition.* (@blockml/core) — BML meta-model (what block documents mean)
+    • org.blockml.bml.bom.* (this library) — parse-result data structures (BomDocument graph)
+
+    Modules: documentation (narrative specs), common, block, member, composition, type, value,
+    document (BomDocument root), api (B26), capability (bomEquals).
+
+    Not in this library: EffectiveMemberSet, TypeRegistry (@blockml/framework); BML→BOM mapping (@blockml/parser).
+  </documentation>
+
+  <references>
+    <see type="bomdocumentation:Introduction" relation="ReadFirst" />
+    <see type="bomdocumentation:DesignDecisions" relation="SeeAlso" />
+    <see type="bomdocumentation:ValidationResponsibilities" relation="SeeAlso" />
+    <see type="def:BlockDefinition" relation="SeeAlso" />
+  </references>
+
+</block>

package/blocks/org/blockml/bml/bom/UrmodellType.bml

@@ -0,0 +1,39 @@
+<!--
+  BOM Urmodell — UrmodellType
+  FQN: org.blockml.bml.bom.UrmodellType
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>UrmodellType</name>
+  <type>bom:UrmodellType</type>
+  <baseType>core:Entity</baseType>
+  <is>Abstract marker for BOM Urmodell data-structure blocks</is>
+
+  <documentation>All org.blockml.bml.bom.* Urmodell types extend this abstract marker. These blocks describe parse-result data structures (Canonical BOM), not BML authoring grammar. Contrast with org.blockml.bml.definition.* (meta-model in @blockml/core).</documentation>
+
+  <references>
+    <see type="def:BlockDefinition" relation="SeeAlso" />
+  </references>
+
+  <abstract>true</abstract>
+
+</block>

package/blocks/org/blockml/bml/bom/api/ParseOptions.bml

@@ -0,0 +1,42 @@
+<!--
+  BOM Urmodell — ParseOptions
+  FQN: org.blockml.bml.bom.api.ParseOptions
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>ParseOptions</name>
+  <type>bomapi:ParseOptions</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Options for parse() (B26)</is>
+
+  <documentation>Options for parse() (B26)</documentation>
+
+  <properties>
+    <filePath type="type:Text">
+      <documentation>Default: "<memory>". (optional)</documentation>
+    </filePath>
+    <continueOnError type="type:Boolean">
+      <documentation>Default: true. (optional)</documentation>
+    </continueOnError>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/bom/api/ParseResult.bml

@@ -0,0 +1,45 @@
+<!--
+  BOM Urmodell — ParseResult
+  FQN: org.blockml.bml.bom.api.ParseResult
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>ParseResult</name>
+  <type>bomapi:ParseResult</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Result of parse() (B26)</is>
+
+  <documentation>Result of parse() (B26)</documentation>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>BomDocument | null — null on hard fail. (required)</documentation>
+    </document>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics (required). TS type: bomcommon:Diagnostic[].</documentation>
+    </diagnostics>
+    <success type="type:Boolean">
+      <documentation>success (required). TS type: type:Boolean.</documentation>
+    </success>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/bom/api/SerializeOptions.bml

@@ -0,0 +1,42 @@
+<!--
+  BOM Urmodell — SerializeOptions
+  FQN: org.blockml.bml.bom.api.SerializeOptions
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>SerializeOptions</name>
+  <type>bomapi:SerializeOptions</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Options for serialize() (B26)</is>
+
+  <documentation>Options for serialize() (B26)</documentation>
+
+  <properties>
+    <indent type="type:Integer">
+      <documentation>Default: 2. 0 = compact (B13). (optional)</documentation>
+    </indent>
+    <xmlDeclaration type="type:Boolean">
+      <documentation>Default: false (B17/B24). (optional)</documentation>
+    </xmlDeclaration>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/bom/api/SerializeResult.bml

@@ -0,0 +1,45 @@
+<!--
+  BOM Urmodell — SerializeResult
+  FQN: org.blockml.bml.bom.api.SerializeResult
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>SerializeResult</name>
+  <type>bomapi:SerializeResult</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Result of serialize() (B26)</is>
+
+  <documentation>Result of serialize() (B26)</documentation>
+
+  <properties>
+    <text type="type:Text">
+      <documentation>string | null — null if serialize cannot produce text. (required)</documentation>
+    </text>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics (required). TS type: bomcommon:Diagnostic[].</documentation>
+    </diagnostics>
+    <success type="type:Boolean">
+      <documentation>success (required). TS type: type:Boolean.</documentation>
+    </success>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/bom/api/TypeRegistryReader.bml

@@ -0,0 +1,34 @@
+<!--
+  BOM Urmodell — TypeRegistryReader
+  FQN: org.blockml.bml.bom.api.TypeRegistryReader
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>TypeRegistryReader</name>
+  <type>bomapi:TypeRegistryReader</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Minimal TypeRegistry surface for ValidateOptions</is>
+
+  <documentation>TypeScript interface — get(fqn) and has(fqn). Full TypeRegistry in
+    @blockml/framework implements this reader for ValidateOptions.typeRegistry injection.</documentation>
+
+</block>

package/blocks/org/blockml/bml/bom/api/ValidateOptions.bml

@@ -0,0 +1,50 @@
+<!--
+  BOM Urmodell — ValidateOptions
+  FQN: org.blockml.bml.bom.api.ValidateOptions
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>ValidateOptions</name>
+  <type>bomapi:ValidateOptions</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Options for validate() (Stage 2)</is>
+
+  <documentation>Options for @blockml/validator validate(). When typeRegistry is omitted,
+    bootstrapPaths and/or libraryPaths (or framework default paths) populate the registry.
+    libraryPaths selects library-graph bootstrap mode (Library.bml dependency order).</documentation>
+
+  <properties>
+    <typeRegistry type="bomapi:TypeRegistryReader">
+      <documentation>Pre-built registry surface — optional. Implemented by @blockml/framework TypeRegistry.</documentation>
+    </typeRegistry>
+    <bootstrapPaths type="type:Text[]">
+      <documentation>Directories scanned for .bml when typeRegistry omitted (corpus mode). (optional)</documentation>
+    </bootstrapPaths>
+    <libraryPaths type="type:Text[]">
+      <documentation>Library.bml file paths for library-graph bootstrap when typeRegistry omitted. (optional)</documentation>
+    </libraryPaths>
+    <continueOnError type="type:Boolean">
+      <documentation>Default: true — continue after errors; still attach pragmaticModel when possible. (optional)</documentation>
+    </continueOnError>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/bom/api/ValidateResult.bml

@@ -0,0 +1,46 @@
+<!--
+  BOM Urmodell — ValidateResult
+  FQN: org.blockml.bml.bom.api.ValidateResult
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>ValidateResult</name>
+  <type>bomapi:ValidateResult</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Result of validate() (Stage 2)</is>
+
+  <documentation>Result of @blockml/validator validate(). success is false when any diagnostic
+    has severity error. pragmaticModel is the forked working copy when validation ran.</documentation>
+
+  <properties>
+    <pragmaticModel type="bomdoc:BomDocument">
+      <documentation>Pragmatic model fork — optional. TS type: bomdoc:BomDocument | undefined.</documentation>
+    </pragmaticModel>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics (required). TS type: bomcommon:Diagnostic[].</documentation>
+    </diagnostics>
+    <success type="type:Boolean">
+      <documentation>success (required). TS type: type:Boolean.</documentation>
+    </success>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/bom/block/AliasEntry.bml

@@ -0,0 +1,51 @@
+<!--
+  BOM Urmodell — AliasEntry
+  FQN: org.blockml.bml.bom.block.AliasEntry
+-->
+<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:bomcap="org.blockml.bml.bom.capability"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:bommember="org.blockml.bml.bom.member"
+  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:type="org.blockml.bml.type">
+
+  <name>AliasEntry</name>
+  <type>bomblock:AliasEntry</type>
+  <baseType>bom:UrmodellType</baseType>
+  <is>Alias Entity instance in BOM</is>
+
+  <documentation>Alias Entity instance in BOM</documentation>
+
+  <properties>
+    <typeFqn type="type:Text">
+      <documentation>typeFqn (required). TS type: type:Text.</documentation>
+    </typeFqn>
+    <name type="type:Text">
+      <documentation>name (optional). TS type: type:Text.</documentation>
+    </name>
+    <languageFqn type="type:Text">
+      <documentation>languageFqn (optional). TS type: type:Text.</documentation>
+    </languageFqn>
+    <legacy type="type:Boolean">
+      <documentation>legacy (optional). TS type: type:Boolean.</documentation>
+    </legacy>
+    <source type="bomcommon:SourceLocation">
+      <documentation>source (optional). TS type: bomcommon:SourceLocation.</documentation>
+    </source>
+  </properties>
+
+</block>