@blockml/framework 0.7.1 → 0.8.0

package/blocks/org/blockml/bml/framework/FrameworkType.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>FrameworkType</name>
   <type>framework:FrameworkType</type>

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

@@ -44,14 +44,14 @@
     Membership is defined exclusively by this blocks list.
   </documentation>
 
-  <version>0.7.1</version>
+  <version>0.8.0</version>
 
   <language>
     <English />
   </language>
 
   <properties>
-    <description>
+    <description override="true">
       <value>BlockML Framework utilities library</value>
     </description>
   </properties>
@@ -70,11 +70,14 @@
       </composition>
     </dependencies>
     <blocks>
-      <composition><framework:FrameworkType />
+      <composition>
+        <framework:FrameworkType />
         <fwregistry:BootstrapResult />
+        <fwregistry:BootstrapTrace />
         <fwexpression:ExpressionNode />
         <fwexpression:LiteralExpressionNode />
         <fwexpression:ArrayExpressionNode />
+        <fwexpression:ObjectExpressionEntry />
         <fwexpression:ObjectExpressionNode />
         <fwexpression:PropertyExpressionNode />
         <fwexpression:CallExpressionNode />
@@ -87,6 +90,7 @@
         <fwcap:TypeRegistry />
         <fwcap:BootstrapTypeRegistry />
         <fwcap:DefaultBootstrapPaths />
+        <fwcap:ResolveLibrarySeeds />
         <fwcap:ForkBom />
         <fwcap:ResolveContracts />
         <fwcap:ResolveEffectiveMembers />

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

@@ -32,7 +32,7 @@
   xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>README</name>
-  <type>blockml:README</type>
+  <type>framework:README</type>
   <baseType>core:ReadMe</baseType>
   <is>Reading entry for the Framework utilities library</is>
 

package/blocks/org/blockml/bml/framework/capability/BootstrapTypeRegistry.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>BootstrapTypeRegistry</name>
   <type>fwcap:BootstrapTypeRegistry</type>
@@ -37,6 +40,7 @@
 
   <references>
     <see type="fwcap:DefaultBootstrapPaths" relation="SeeAlso" />
+    <see type="fwcap:ResolveLibrarySeeds" relation="SeeAlso" />
     <see type="fwregistry:BootstrapOptions" relation="SeeAlso" />
     <see type="parser:Library" relation="SeeAlso" />
   </references>

package/blocks/org/blockml/bml/framework/capability/CollectBaseTypeChain.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>CollectBaseTypeChain</name>
   <type>fwcap:CollectBaseTypeChain</type>

package/blocks/org/blockml/bml/framework/capability/DefaultBootstrapPaths.bml

@@ -26,14 +26,17 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>DefaultBootstrapPaths</name>
   <type>fwcap:DefaultBootstrapPaths</type>
   <baseType>core:Capability</baseType>
-  <is>Default TypeRegistry corpus paths under node_modules</is>
+  <is>Corpus fallback paths from production BlockML npm dependencies</is>
 
-  <documentation>Default TypeRegistry corpus paths under node_modules</documentation>
+  <documentation>Nearest package.json dependencies + optionalDependencies that have blockml.library or blockml.config.json. Resolve via node_modules walk-up. Package source root is srcDir (default blocks; foreign blockml.config.json may override srcDir only).</documentation>
 
   <properties>
     <rootDir type="type:Text">

package/blocks/org/blockml/bml/framework/capability/ForkBom.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ForkBom</name>
   <type>fwcap:ForkBom</type>

package/blocks/org/blockml/bml/framework/capability/GetExportedFqns.bml

@@ -8,23 +8,42 @@
   xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
                       "
   xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
   xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>GetExportedFqns</name>
   <type>fwcap:GetExportedFqns</type>
   <baseType>core:Capability</baseType>
   <is>Exported block FQNs for a library path from BootstrapResult</is>
 
+  <documentation>Exported block FQNs for a library path from BootstrapResult</documentation>
+
   <properties>
     <libraryPath type="type:Text">
-      <documentation>libraryPath. (required)</documentation>
+      <documentation>libraryPath. TS type: type:Text. (required)</documentation>
     </libraryPath>
     <bootstrap type="fwregistry:BootstrapResult">
-      <documentation>bootstrap. (required)</documentation>
+      <documentation>bootstrap. TS type: fwregistry:BootstrapResult. (required)</documentation>
     </bootstrap>
     <rootDir type="type:Text">
       <documentation>rootDir — default process.cwd(). (optional)</documentation>

package/blocks/org/blockml/bml/framework/capability/GetPropertyNumericValue.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>GetPropertyNumericValue</name>
   <type>fwcap:GetPropertyNumericValue</type>

package/blocks/org/blockml/bml/framework/capability/IsLiteralValue.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>IsLiteralValue</name>
   <type>fwcap:IsLiteralValue</type>

package/blocks/org/blockml/bml/framework/capability/MemberIdentityKey.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>MemberIdentityKey</name>
   <type>fwcap:MemberIdentityKey</type>

package/blocks/org/blockml/bml/framework/capability/ParseExpression.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ParseExpression</name>
   <type>fwcap:ParseExpression</type>

package/blocks/org/blockml/bml/framework/capability/ResolveContracts.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ResolveContracts</name>
   <type>fwcap:ResolveContracts</type>

package/blocks/org/blockml/bml/framework/capability/ResolveEffectiveMembers.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ResolveEffectiveMembers</name>
   <type>fwcap:ResolveEffectiveMembers</type>

package/blocks/org/blockml/bml/framework/capability/ResolveLibrarySeeds.bml

@@ -0,0 +1,57 @@
+<!--
+  Framework Capability — ResolveLibrarySeeds
+  FQN: org.blockml.bml.framework.capability.ResolveLibrarySeeds
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
+  xmlns:fwregistry="org.blockml.bml.framework.registry"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
+
+  <name>ResolveLibrarySeeds</name>
+  <type>fwcap:ResolveLibrarySeeds</type>
+  <baseType>core:Capability</baseType>
+  <is>Merge package.json blockml.library with extra Library.bml paths</is>
+
+  <documentation>Identity seed from package.json blockml.library first, then extras (config.libraries or --libraries). Absolute paths, deduped by realpath. Missing files keep resolve().</documentation>
+
+  <references>
+    <see type="fwcap:BootstrapTypeRegistry" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <rootDir type="type:Text">
+      <documentation>Package directory. Default process.cwd(). (optional)</documentation>
+    </rootDir>
+    <extras type="type:Text[]">
+      <documentation>Additional Library.bml paths. (optional)</documentation>
+    </extras>
+    <seeds type="type:Text[]">
+      <documentation>seeds. TS type: type:Text[]. (required)</documentation>
+    </seeds>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/capability/RootFqnByFilePath.bml

@@ -9,18 +9,35 @@
                       "
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
   xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
   xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>RootFqnByFilePath</name>
   <type>fwcap:RootFqnByFilePath</type>
   <baseType>core:Capability</baseType>
   <is>Map file path to document-root block FQN from TypeRegistry</is>
 
+  <documentation>Map file path to document-root block FQN from TypeRegistry</documentation>
+
   <properties>
     <registry type="fwcap:TypeRegistry">
       <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>

package/blocks/org/blockml/bml/framework/capability/RootFqns.bml

@@ -8,22 +8,42 @@
   xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
                       "
   xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
   xmlns:fwcap="org.blockml.bml.framework.capability"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
+  xmlns:fwregistry="org.blockml.bml.framework.registry"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>RootFqns</name>
   <type>fwcap:RootFqns</type>
   <baseType>core:Capability</baseType>
-  <is>Sorted root FQNs from TypeRegistry index</is>
+  <is>Root block FQNs from TypeRegistry</is>
+
+  <documentation>Root block FQNs from TypeRegistry</documentation>
 
   <properties>
     <registry type="fwcap:TypeRegistry">
       <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
     </registry>
     <fqns type="type:Text[]">
-      <documentation>root FQNs sorted. (required)</documentation>
+      <documentation>fqns. TS type: type:Text[]. (required)</documentation>
     </fqns>
   </properties>
 

package/blocks/org/blockml/bml/framework/capability/TypeRegistry.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>TypeRegistry</name>
   <type>fwcap:TypeRegistry</type>

package/blocks/org/blockml/bml/framework/capability/ValidateConstraints.bml

@@ -26,7 +26,10 @@
   xmlns:fwexpression="org.blockml.bml.framework.expression"
   xmlns:fwregistry="org.blockml.bml.framework.registry"
   xmlns:parser="org.blockml.bml.compiler.parser"
-  xmlns:type="org.blockml.bml.type">
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ValidateConstraints</name>
   <type>fwcap:ValidateConstraints</type>

package/blocks/org/blockml/bml/framework/capability/ValidateEmbeddedBlocks.bml

@@ -8,23 +8,42 @@
   xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
                       "
   xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
   xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
-  xmlns:fwcap="org.blockml.bml.framework.capability">
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
+  xmlns:fwregistry="org.blockml.bml.framework.registry"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ValidateEmbeddedBlocks</name>
   <type>fwcap:ValidateEmbeddedBlocks</type>
   <baseType>core:Capability</baseType>
   <is>Embedded block and sub-block placement rules</is>
 
+  <documentation>Embedded block and sub-block placement rules</documentation>
+
   <properties>
     <document type="bomdoc:BomDocument">
-      <documentation>document. (required)</documentation>
+      <documentation>document. TS type: bomdoc:BomDocument. (required)</documentation>
     </document>
     <diagnostics type="bomcommon:Diagnostic[]">
-      <documentation>diagnostics. (required)</documentation>
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (required)</documentation>
     </diagnostics>
   </properties>
 

package/blocks/org/blockml/bml/framework/capability/ValidateInstances.bml

@@ -8,29 +8,45 @@
   xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
                       "
   xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
   xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
-  xmlns:fwcap="org.blockml.bml.framework.capability">
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
+  xmlns:fwregistry="org.blockml.bml.framework.registry"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ValidateInstances</name>
   <type>fwcap:ValidateInstances</type>
   <baseType>core:Capability</baseType>
-  <is>Instance type, member, id, and cross-reference rules</is>
+  <is>Instance member rules against TypeRegistry</is>
 
-  <documentation>Unknown instance typeFqn → BML_UNKNOWN_TYPE. memberValues keys not in
-    resolveEffectiveMembers → BML_UNKNOWN_PROPERTY. Unresolved refs and missing bml:id on bml:each remain.</documentation>
+  <documentation>Instance member rules against TypeRegistry</documentation>
 
   <properties>
     <document type="bomdoc:BomDocument">
-      <documentation>document. (required)</documentation>
+      <documentation>document. TS type: bomdoc:BomDocument. (required)</documentation>
     </document>
     <registry type="fwcap:TypeRegistry">
-      <documentation>registry. (required)</documentation>
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
     </registry>
     <diagnostics type="bomcommon:Diagnostic[]">
-      <documentation>diagnostics. (required)</documentation>
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (required)</documentation>
     </diagnostics>
   </properties>
 

package/blocks/org/blockml/bml/framework/capability/ValidatePresets.bml

@@ -8,26 +8,45 @@
   xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
                       "
   xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
   xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
-  xmlns:fwcap="org.blockml.bml.framework.capability">
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
+  xmlns:fwregistry="org.blockml.bml.framework.registry"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ValidatePresets</name>
   <type>fwcap:ValidatePresets</type>
   <baseType>core:Capability</baseType>
-  <is>Preset inheritance and property binding rules</is>
+  <is>Preset member rules against TypeRegistry</is>
+
+  <documentation>Preset member rules against TypeRegistry</documentation>
 
   <properties>
     <document type="bomdoc:BomDocument">
-      <documentation>document. (required)</documentation>
+      <documentation>document. TS type: bomdoc:BomDocument. (required)</documentation>
     </document>
     <registry type="fwcap:TypeRegistry">
-      <documentation>registry. (required)</documentation>
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
     </registry>
     <diagnostics type="bomcommon:Diagnostic[]">
-      <documentation>diagnostics. (required)</documentation>
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (required)</documentation>
     </diagnostics>
   </properties>
 

package/blocks/org/blockml/bml/framework/capability/ValidateReadOnly.bml

@@ -8,26 +8,45 @@
   xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
                       "
   xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomblock="org.blockml.bml.bom.block"
   xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomcomp="org.blockml.bml.bom.composition"
   xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns: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:framework="org.blockml.bml.framework"
-  xmlns:fwcap="org.blockml.bml.framework.capability">
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwconfig="org.blockml.bml.framework.config"
+  xmlns:fwdocumentation="org.blockml.bml.framework.documentation"
+  xmlns:fwexpression="org.blockml.bml.framework.expression"
+  xmlns:fwregistry="org.blockml.bml.framework.registry"
+  xmlns:parser="org.blockml.bml.compiler.parser"
+  xmlns:type="org.blockml.bml.type"
+  xmlns:bomdocumentation="org.blockml.bml.bom.documentation"
+  xmlns:pardocumentation="org.blockml.bml.compiler.parser.documentation"
+  xmlns:valdocumentation="org.blockml.bml.compiler.validator.documentation">
 
   <name>ValidateReadOnly</name>
   <type>fwcap:ValidateReadOnly</type>
   <baseType>core:Capability</baseType>
-  <is>readOnly member write enforcement on block instances</is>
+  <is>Read-only member rules against TypeRegistry</is>
+
+  <documentation>Read-only member rules against TypeRegistry</documentation>
 
   <properties>
     <document type="bomdoc:BomDocument">
-      <documentation>document. (required)</documentation>
+      <documentation>document. TS type: bomdoc:BomDocument. (required)</documentation>
     </document>
     <registry type="fwcap:TypeRegistry">
-      <documentation>registry. (required)</documentation>
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
     </registry>
     <diagnostics type="bomcommon:Diagnostic[]">
-      <documentation>diagnostics. (required)</documentation>
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (required)</documentation>
     </diagnostics>
   </properties>