@blockml/framework 0.7.1 → 0.8.1

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

@@ -37,21 +37,26 @@
   <is>The BlockML Framework utilities package library catalog</is>
 
   <documentation>
+    # The BlockML Framework utilities package library catalog
+
     Canonical framework specification for BlockML Stage-2 utilities — TypeRegistry,
     bootstrap, fork/resolve, parseExpression, validateTypes/validateConstraints.
+
     TypeScript in packages/framework/src/ implements this library.
+
     Urmodell types live in org.blockml.bml.bom.* (@blockml/bom).
+
     Membership is defined exclusively by this blocks list.
   </documentation>
 
-  <version>0.7.1</version>
+  <version>0.8.1</version>
 
   <language>
     <English />
   </language>
 
   <properties>
-    <description>
+    <description override="true">
       <value>BlockML Framework utilities library</value>
     </description>
   </properties>
@@ -70,11 +75,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 />
@@ -86,7 +94,13 @@
         <fwconfig:FrameworkDiagnosticCodes />
         <fwcap:TypeRegistry />
         <fwcap:BootstrapTypeRegistry />
+        <fwcap:BootstrapFullProjectRegistry />
         <fwcap:DefaultBootstrapPaths />
+        <fwcap:ResolveLibrarySeeds />
+        <fwcap:ProjectSourceRoots />
+        <fwcap:ProjectLibraryPackageRoots />
+        <fwcap:ProjectLibraryPackageDirs />
+        <fwcap:RegistryFilesUnderRoots />
         <fwcap:ForkBom />
         <fwcap:ResolveContracts />
         <fwcap:ResolveEffectiveMembers />
@@ -99,6 +113,7 @@
         <fwcap:RootFqnByFilePath />
         <fwcap:RootFqns />
         <fwcap:GetExportedFqns />
+        <fwcap:PeekLibraryTypeFqn />
         <fwcap:ValidateEmbeddedBlocks />
         <fwcap:ValidateInstances />
         <fwcap:ValidatePresets />

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/BootstrapFullProjectRegistry.bml

@@ -0,0 +1,62 @@
+<!--
+  Framework Capability — BootstrapFullProjectRegistry
+  FQN: org.blockml.bml.framework.capability.BootstrapFullProjectRegistry
+-->
+<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>BootstrapFullProjectRegistry</name>
+  <type>fwcap:BootstrapFullProjectRegistry</type>
+  <baseType>core:Capability</baseType>
+  <is>Bootstrap the same corpus as blockml validate --all</is>
+
+  <documentation>projectSourceRoots plus resolveLibrarySeeds, then bootstrapTypeRegistry. Resulting registry includes local project BML and the library graph (npm BlockML packages). Search and validate --all must use this entry point.</documentation>
+
+  <references>
+    <see type="fwcap:ProjectSourceRoots" relation="SeeAlso" />
+    <see type="fwcap:BootstrapTypeRegistry" relation="SeeAlso" />
+    <see type="fwcap:ResolveLibrarySeeds" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <rootDir type="type:Text">
+      <documentation>Project root. (required)</documentation>
+    </rootDir>
+    <srcDir type="type:Text">
+      <documentation>Default blocks. (optional)</documentation>
+    </srcDir>
+    <libraries type="type:Text[]">
+      <documentation>Extra Library.bml seeds (config.libraries / --libraries). (optional)</documentation>
+    </libraries>
+    <result type="fwregistry:BootstrapResult">
+      <documentation>result. TS type: fwregistry:BootstrapResult. (required)</documentation>
+    </result>
+  </properties>
+
+</block>

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/PeekLibraryTypeFqn.bml

@@ -0,0 +1,54 @@
+<!--
+  Framework Capability — PeekLibraryTypeFqn
+  FQN: org.blockml.bml.framework.capability.PeekLibraryTypeFqn
+-->
+<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>PeekLibraryTypeFqn</name>
+  <type>fwcap:PeekLibraryTypeFqn</type>
+  <baseType>core:Capability</baseType>
+  <is>Root type FQN of a Library.bml file</is>
+
+  <documentation>Reads Library.bml and returns document.block.type, or undefined if the file is missing or invalid. Used to compare library identity across realpaths (workspace vs npm copy).</documentation>
+
+  <references>
+    <see type="fwcap:ResolveLibrarySeeds" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <libraryPath type="type:Text">
+      <documentation>libraryPath. TS type: type:Text. (required)</documentation>
+    </libraryPath>
+    <typeFqn type="type:Text">
+      <documentation>Library type FQN, or undefined. (optional)</documentation>
+    </typeFqn>
+  </properties>
+
+</block>

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

@@ -0,0 +1,50 @@
+<!--
+  Framework Capability — ProjectLibraryPackageDirs
+  FQN: org.blockml.bml.framework.capability.ProjectLibraryPackageDirs
+-->
+<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>ProjectLibraryPackageDirs</name>
+  <type>fwcap:ProjectLibraryPackageDirs</type>
+  <baseType>core:Capability</baseType>
+  <is>Package directories that declare blockml.library</is>
+
+  <documentation>This package and local packages/* that declare package.json blockml.library. Sorted, canonical, no node_modules walk.</documentation>
+
+  <properties>
+    <rootDir type="type:Text">
+      <documentation>Project root. (required)</documentation>
+    </rootDir>
+    <dirs type="type:Text[]">
+      <documentation>dirs. TS type: type:Text[]. (required)</documentation>
+    </dirs>
+  </properties>
+
+</block>

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

@@ -0,0 +1,50 @@
+<!--
+  Framework Capability — ProjectLibraryPackageRoots
+  FQN: org.blockml.bml.framework.capability.ProjectLibraryPackageRoots
+-->
+<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>ProjectLibraryPackageRoots</name>
+  <type>fwcap:ProjectLibraryPackageRoots</type>
+  <baseType>core:Capability</baseType>
+  <is>srcDir roots of local packages that declare blockml.library</is>
+
+  <documentation>Stricter than projectSourceRoots: config-only packages are omitted. Does not walk parent workspaces or node_modules.</documentation>
+
+  <properties>
+    <rootDir type="type:Text">
+      <documentation>Project root. (required)</documentation>
+    </rootDir>
+    <roots type="type:Text[]">
+      <documentation>roots. TS type: type:Text[]. (required)</documentation>
+    </roots>
+  </properties>
+
+</block>

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

@@ -0,0 +1,53 @@
+<!--
+  Framework Capability — ProjectSourceRoots
+  FQN: org.blockml.bml.framework.capability.ProjectSourceRoots
+-->
+<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>ProjectSourceRoots</name>
+  <type>fwcap:ProjectSourceRoots</type>
+  <baseType>core:Capability</baseType>
+  <is>Project-owned BML roots for this package plus local packages/*</is>
+
+  <documentation>This package's srcDir plus local packages/* BlockML modules (blockml.library or blockml.config.json). Does not walk parent workspaces or node_modules.</documentation>
+
+  <properties>
+    <rootDir type="type:Text">
+      <documentation>Project root. (required)</documentation>
+    </rootDir>
+    <srcDir type="type:Text">
+      <documentation>Default blocks. (optional)</documentation>
+    </srcDir>
+    <roots type="type:Text[]">
+      <documentation>roots. TS type: type:Text[]. (required)</documentation>
+    </roots>
+  </properties>
+
+</block>

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

@@ -0,0 +1,53 @@
+<!--
+  Framework Capability — RegistryFilesUnderRoots
+  FQN: org.blockml.bml.framework.capability.RegistryFilesUnderRoots
+-->
+<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>RegistryFilesUnderRoots</name>
+  <type>fwcap:RegistryFilesUnderRoots</type>
+  <baseType>core:Capability</baseType>
+  <is>Registry file paths whose realpath lies under given roots</is>
+
+  <documentation>Filters TypeRegistry document file paths to those under any of the given roots.</documentation>
+
+  <properties>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <roots type="type:Text[]">
+      <documentation>roots. TS type: type:Text[]. (required)</documentation>
+    </roots>
+    <files type="type:Text[]">
+      <documentation>files. TS type: type:Text[]. (required)</documentation>
+    </files>
+  </properties>
+
+</block>

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>