@blockml/builder 0.9.1

package/blocks/org/blockml/bml/builder/AddAggregationOptions.bml

@@ -0,0 +1,35 @@
+<!--
+  Builder — AddAggregationOptions
+  FQN: org.blockml.bml.builder.AddAggregationOptions
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>AddAggregationOptions</name>
+  <type>builder:AddAggregationOptions</type>
+  <baseType>builder:BuilderType</baseType>
+  <is>Declared aggregation to append on the draft block</is>
+  <properties>
+    <name type="type:Text">
+      <documentation>Logical aggregation name. (required)</documentation>
+    </name>
+    <typeFqn type="type:Text">
+      <documentation>Element type FQN. (required)</documentation>
+    </typeFqn>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/AddPropertyOptions.bml

@@ -0,0 +1,38 @@
+<!--
+  Builder — AddPropertyOptions
+  FQN: org.blockml.bml.builder.AddPropertyOptions
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>AddPropertyOptions</name>
+  <type>builder:AddPropertyOptions</type>
+  <baseType>builder:BuilderType</baseType>
+  <is>Declared property to append on the draft block</is>
+  <properties>
+    <name type="type:Text">
+      <documentation>Logical property name. (required)</documentation>
+    </name>
+    <typeFqn type="type:Text">
+      <documentation>Property type FQN. (required)</documentation>
+    </typeFqn>
+    <value type="type:Text">
+      <documentation>Optional literal value. (optional)</documentation>
+    </value>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/BomBuilder.bml

@@ -0,0 +1,36 @@
+<!--
+  Builder — BomBuilder
+  FQN: org.blockml.bml.builder.BomBuilder
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>BomBuilder</name>
+  <type>builder:BomBuilder</type>
+  <baseType>builder:BuilderType</baseType>
+  <is>Writable authoring session over a BOM draft</is>
+  <documentation>Session created by Create or Edit. Mutations apply only to the draft.
+    seal() returns an immutable BomDocument (Urmodell). Does not parse, serialize,
+    validate, or write files. Does not use forkBom (resolve-only).</documentation>
+  <references>
+    <see type="buildercap:Create" relation="SeeAlso" />
+    <see type="buildercap:Edit" relation="SeeAlso" />
+    <see type="buildercap:Seal" relation="SeeAlso" />
+    <see type="bomdoc:BomDocument" relation="SeeAlso" />
+  </references>
+</block>

package/blocks/org/blockml/bml/builder/BuilderType.bml

@@ -0,0 +1,32 @@
+<!--
+  Builder — BuilderType
+  FQN: org.blockml.bml.builder.BuilderType
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>BuilderType</name>
+  <type>builder:BuilderType</type>
+  <baseType>core:Entity</baseType>
+  <is>Abstract marker for Builder implementation data-structure blocks</is>
+  <documentation>BomBuilder, CreateBlockOptions, and related ValueTypes used as capability payloads.</documentation>
+  <abstract>true</abstract>
+  <references>
+    <see type="bom:UrmodellType" relation="SeeAlso" />
+  </references>
+</block>

package/blocks/org/blockml/bml/builder/CreateBlockOptions.bml

@@ -0,0 +1,50 @@
+<!--
+  Builder — CreateBlockOptions
+  FQN: org.blockml.bml.builder.CreateBlockOptions
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>CreateBlockOptions</name>
+  <type>builder:CreateBlockOptions</type>
+  <baseType>builder:BuilderType</baseType>
+  <is>Identity and source options for BomBuilder.create</is>
+  <documentation>type is the root FQN. name defaults to the last FQN segment.
+    baseType defaults to org.blockml.bml.core.Block. is defaults to name.
+    filePath is stored on SourceInfo for later serialize.</documentation>
+  <properties>
+    <typeFqn type="type:Text">
+      <documentation>Root block FQN. TS field: type. (required)</documentation>
+    </typeFqn>
+    <name type="type:Text">
+      <documentation>Short class name. Defaults to last FQN segment. (optional)</documentation>
+    </name>
+    <baseType type="type:Text">
+      <documentation>Parent type FQN. (optional)</documentation>
+    </baseType>
+    <is type="type:Text">
+      <documentation>Idea (Urbild) prose. (optional)</documentation>
+    </is>
+    <documentationText type="type:Text">
+      <documentation>Optional documentation prose. TS field: documentation. (optional)</documentation>
+    </documentationText>
+    <filePath type="type:Text">
+      <documentation>SourceInfo.filePath. (optional)</documentation>
+    </filePath>
+  </properties>
+</block>

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

@@ -0,0 +1,86 @@
+<!--
+  BlockML Builder Library Descriptor
+  FQN: org.blockml.bml.builder.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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>Library</name>
+  <type>builder:Library</type>
+  <baseType>core:BlockLibrary</baseType>
+  <is>The BlockML Builder package library catalog</is>
+
+  <documentation>
+    Canonical BomBuilder specification for BlockML — writable authoring session
+    that create/edit/seal BomDocument graphs. TypeScript in packages/builder/src/
+    implements this library. Membership is defined exclusively by this blocks list.
+  </documentation>
+
+  <version>0.9.1</version>
+
+  <language>
+    <English />
+  </language>
+
+  <properties>
+    <description override="true">
+      <value>BlockML Builder library</value>
+    </description>
+  </properties>
+
+  <aggregations>
+    <readMe>
+      <composition>
+        <builder:README />
+      </composition>
+    </readMe>
+    <dependencies>
+      <composition>
+        <blockml:Library />
+        <bom:Library />
+        <framework:Library />
+      </composition>
+    </dependencies>
+    <blocks>
+      <composition>
+        <builder:BuilderType />
+        <builder:BomBuilder />
+        <builder:CreateBlockOptions />
+        <builder:AddPropertyOptions />
+        <builder:AddAggregationOptions />
+        <buildercap:Create />
+        <buildercap:Edit />
+        <buildercap:Seal />
+        <buildercap:QuerySelector />
+        <buildercap:AddProperty />
+        <buildercap:AddAggregation />
+        <buildercap:AddCompositionChild />
+        <buildercap:SetMemberValue />
+        <buildercap:EnsureNamespaceBinding />
+        <builderdocumentation:Introduction />
+        <builderdocumentation:LayerSeparation />
+        <builderdocumentation:ArchitectureOverview />
+        <builderdocumentation:V1Scope />
+        <builderdocumentation:PublicApi />
+        <builderdocumentation:PackageOwnership />
+        <builderdocumentation:ScopeExclusions />
+      </composition>
+    </blocks>
+  </aggregations>
+
+</block>

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

@@ -0,0 +1,36 @@
+<!--
+  BlockML Builder — README
+  FQN: org.blockml.bml.builder.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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>README</name>
+  <type>builder:README</type>
+  <baseType>core:ReadMe</baseType>
+  <is>Reading entry for the Builder library</is>
+  <documentation>The @blockml/builder package provides BomBuilder, a writable authoring
+    session that creates or edits a BOM graph and seal()s it to an immutable
+    Urmodell (BomDocument). Serializer and validator consume that document.
+
+    Start at org.blockml.bml.builder.documentation.Introduction.</documentation>
+  <references>
+    <see type="builderdocumentation:Introduction" relation="ReadFirst" />
+    <see type="builderdocumentation:PublicApi" relation="SeeAlso" />
+  </references>
+</block>

package/blocks/org/blockml/bml/builder/capability/AddAggregation.bml

@@ -0,0 +1,40 @@
+<!--
+  Builder Capability — AddAggregation
+  FQN: org.blockml.bml.builder.capability.AddAggregation
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>AddAggregation</name>
+  <type>buildercap:AddAggregation</type>
+  <baseType>core:Capability</baseType>
+  <is>Declare an aggregation on the draft block</is>
+  <documentation>Appends an aggregation member with a named type expression.
+    Duplicate names throw.</documentation>
+  <references>
+    <see type="builder:AddAggregationOptions" relation="SeeAlso" />
+  </references>
+  <properties>
+    <options type="builder:AddAggregationOptions">
+      <documentation>options (required).</documentation>
+    </options>
+    <result type="builder:BomBuilder">
+      <documentation>This session. (required)</documentation>
+    </result>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/capability/AddCompositionChild.bml

@@ -0,0 +1,44 @@
+<!--
+  Builder Capability — AddCompositionChild
+  FQN: org.blockml.bml.builder.capability.AddCompositionChild
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>AddCompositionChild</name>
+  <type>buildercap:AddCompositionChild</type>
+  <baseType>core:Capability</baseType>
+  <is>Append a composition instance under a named aggregation</is>
+  <documentation>Used to add a Library.blocks catalog export. Creates the composition
+    wrapper when missing. Skips when typeFqn is already a child. Ensures xmlns
+    for the child package.</documentation>
+  <references>
+    <see type="builder:BomBuilder" relation="SeeAlso" />
+  </references>
+  <properties>
+    <aggregationName type="type:Text">
+      <documentation>Target aggregation name, e.g. blocks. (required)</documentation>
+    </aggregationName>
+    <typeFqn type="type:Text">
+      <documentation>Child block FQN. (required)</documentation>
+    </typeFqn>
+    <result type="builder:BomBuilder">
+      <documentation>This session. (required)</documentation>
+    </result>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/capability/AddProperty.bml

@@ -0,0 +1,40 @@
+<!--
+  Builder Capability — AddProperty
+  FQN: org.blockml.bml.builder.capability.AddProperty
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>AddProperty</name>
+  <type>buildercap:AddProperty</type>
+  <baseType>core:Capability</baseType>
+  <is>Declare a property on the draft block</is>
+  <documentation>Appends a property member. Ensures a namespace binding for typeFqn.
+    Duplicate names throw.</documentation>
+  <references>
+    <see type="builder:AddPropertyOptions" relation="SeeAlso" />
+  </references>
+  <properties>
+    <options type="builder:AddPropertyOptions">
+      <documentation>options (required).</documentation>
+    </options>
+    <result type="builder:BomBuilder">
+      <documentation>This session. (required)</documentation>
+    </result>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/capability/Create.bml

@@ -0,0 +1,41 @@
+<!--
+  Builder Capability — Create
+  FQN: org.blockml.bml.builder.capability.Create
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>Create</name>
+  <type>buildercap:Create</type>
+  <baseType>core:Capability</baseType>
+  <is>Start a BomBuilder session from scratch</is>
+  <documentation>BomBuilder.create(options). Builds a draft BlockDefinition with canonical xmlns
+    bindings for the BML URI, xsi, the block package, and the baseType package.</documentation>
+  <references>
+    <see type="builder:CreateBlockOptions" relation="SeeAlso" />
+    <see type="builder:BomBuilder" relation="SeeAlso" />
+  </references>
+  <properties>
+    <options type="builder:CreateBlockOptions">
+      <documentation>options (required).</documentation>
+    </options>
+    <result type="builder:BomBuilder">
+      <documentation>Writable session. (required)</documentation>
+    </result>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/capability/Edit.bml

@@ -0,0 +1,41 @@
+<!--
+  Builder Capability — Edit
+  FQN: org.blockml.bml.builder.capability.Edit
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>Edit</name>
+  <type>buildercap:Edit</type>
+  <baseType>core:Capability</baseType>
+  <is>Start a BomBuilder session from an existing Urmodell</is>
+  <documentation>BomBuilder.edit(document). Deep-clones the document into the session.
+    Does not use forkBom. The original BomDocument is not mutated.</documentation>
+  <references>
+    <see type="bomdoc:BomDocument" relation="SeeAlso" />
+    <see type="builder:BomBuilder" relation="SeeAlso" />
+  </references>
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>Parse-origin or previously sealed document. (required)</documentation>
+    </document>
+    <result type="builder:BomBuilder">
+      <documentation>Writable session. (required)</documentation>
+    </result>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/capability/EnsureNamespaceBinding.bml

@@ -0,0 +1,41 @@
+<!--
+  Builder Capability — EnsureNamespaceBinding
+  FQN: org.blockml.bml.builder.capability.EnsureNamespaceBinding
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>EnsureNamespaceBinding</name>
+  <type>buildercap:EnsureNamespaceBinding</type>
+  <baseType>core:Capability</baseType>
+  <is>Declare an xmlns prefix for a package FQN</is>
+  <documentation>No-op when the namespace is already bound. If the suggested prefix is
+    taken by another URI, a numeric suffix is used. Known org.blockml.bml.*
+    packages use conventional prefixes (core, type, cli, graph, …).</documentation>
+  <properties>
+    <prefix type="type:Text">
+      <documentation>Suggested prefix. (required)</documentation>
+    </prefix>
+    <namespace type="type:Text">
+      <documentation>Package FQN or XML namespace URI. (required)</documentation>
+    </namespace>
+    <result type="builder:BomBuilder">
+      <documentation>This session. (required)</documentation>
+    </result>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/capability/QuerySelector.bml

@@ -0,0 +1,40 @@
+<!--
+  Builder Capability — QuerySelector
+  FQN: org.blockml.bml.builder.capability.QuerySelector
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>QuerySelector</name>
+  <type>buildercap:QuerySelector</type>
+  <baseType>core:Capability</baseType>
+  <is>Find a declared member by section path</is>
+  <documentation><![CDATA[V1 selectors: properties.<name> and aggregations.<name>.
+    Returns the member or undefined.]]></documentation>
+  <references>
+    <see type="builder:BomBuilder" relation="SeeAlso" />
+  </references>
+  <properties>
+    <selector type="type:Text">
+      <documentation>Member path. (required)</documentation>
+    </selector>
+    <result type="type:Text">
+      <documentation>Found member name, or empty when missing. (optional)</documentation>
+    </result>
+  </properties>
+</block>

package/blocks/org/blockml/bml/builder/capability/Seal.bml

@@ -0,0 +1,37 @@
+<!--
+  Builder Capability — Seal
+  FQN: org.blockml.bml.builder.capability.Seal
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:builder="org.blockml.bml.builder"
+  xmlns:buildercap="org.blockml.bml.builder.capability"
+  xmlns:builderdocumentation="org.blockml.bml.builder.documentation"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>Seal</name>
+  <type>buildercap:Seal</type>
+  <baseType>core:Capability</baseType>
+  <is>Freeze the draft as an immutable Urmodell</is>
+  <documentation>session.seal() → BomDocument. Deep-clones the draft. Does not serialize
+    or validate. Callers pass the result to @blockml/serializer or @blockml/validator.</documentation>
+  <references>
+    <see type="bomdoc:BomDocument" relation="SeeAlso" />
+  </references>
+  <properties>
+    <result type="bomdoc:BomDocument">
+      <documentation>Sealed Urmodell. (required)</documentation>
+    </result>
+  </properties>
+</block>