@blockml/framework 0.1.0

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

@@ -0,0 +1,51 @@
+<!--
+  Framework Capability — ParseExpression
+  FQN: org.blockml.bml.framework.capability.ParseExpression
+-->
+<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">
+
+  <name>ParseExpression</name>
+  <type>fwcap:ParseExpression</type>
+  <baseType>core:Capability</baseType>
+  <is>Parse expression source text into ExpressionNode AST</is>
+
+  <documentation>Parse expression source text into ExpressionNode AST</documentation>
+
+  <references>
+    <see type="fwdocumentation:ExpressionParsing" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <source type="type:Text">
+      <documentation>source. TS type: type:Text. (required)</documentation>
+    </source>
+    <outcome type="fwexpression:ParseExpressionOutcome">
+      <documentation>outcome. TS type: fwexpression:ParseExpressionOutcome. (required)</documentation>
+    </outcome>
+  </properties>
+
+</block>

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

@@ -0,0 +1,55 @@
+<!--
+  Framework Capability — ResolveContracts
+  FQN: org.blockml.bml.framework.capability.ResolveContracts
+-->
+<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">
+
+  <name>ResolveContracts</name>
+  <type>fwcap:ResolveContracts</type>
+  <baseType>core:Capability</baseType>
+  <is>Merge contract Block members into effective member slice</is>
+
+  <documentation>Resolves block.contracts[] in declaration order via TypeRegistry. Returns merged members from contract Blocks only (ignores contract subBlocks/compositions/embeddedBlocks). Unknown contract FQN → BML_UNKNOWN_CONTRACT in validateTypes.</documentation>
+
+  <references>
+    <see type="fwcap:ResolveEffectiveMembers" relation="SeeAlso" />
+    <see type="fwcap:MemberIdentityKey" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <block type="bomblock:BlockDefinition">
+      <documentation>block. TS type: bomblock:BlockDefinition. (required)</documentation>
+    </block>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <members type="bommember:MemberDefinition[]">
+      <documentation>members. TS type: bommember:MemberDefinition[]. (required)</documentation>
+    </members>
+  </properties>
+
+</block>

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

@@ -0,0 +1,56 @@
+<!--
+  Framework Capability — ResolveEffectiveMembers
+  FQN: org.blockml.bml.framework.capability.ResolveEffectiveMembers
+-->
+<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">
+
+  <name>ResolveEffectiveMembers</name>
+  <type>fwcap:ResolveEffectiveMembers</type>
+  <baseType>core:Capability</baseType>
+  <is>Merge members along baseType chain, contracts, and local declarations</is>
+
+  <documentation>Merge members along baseType chain, contracts, and local declarations</documentation>
+
+  <references>
+    <see type="fwcap:CollectBaseTypeChain" relation="SeeAlso" />
+    <see type="fwcap:MemberIdentityKey" relation="SeeAlso" />
+    <see type="fwcap:ResolveContracts" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <block type="bomblock:BlockDefinition">
+      <documentation>block. TS type: bomblock:BlockDefinition. (required)</documentation>
+    </block>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <members type="bommember:MemberDefinition[]">
+      <documentation>members. TS type: bommember:MemberDefinition[]. (required)</documentation>
+    </members>
+  </properties>
+
+</block>

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

@@ -0,0 +1,33 @@
+<!--
+  Framework Capability — RootFqnByFilePath
+  FQN: org.blockml.bml.framework.capability.RootFqnByFilePath
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:fwregistry="org.blockml.bml.framework.registry"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>RootFqnByFilePath</name>
+  <type>fwcap:RootFqnByFilePath</type>
+  <baseType>core:Capability</baseType>
+  <is>Map file path to document-root block FQN from TypeRegistry</is>
+
+  <properties>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <roots type="type:Text">
+      <documentation>Map&lt;filePath, rootFqn&gt;. (required)</documentation>
+    </roots>
+  </properties>
+
+</block>

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

@@ -0,0 +1,30 @@
+<!--
+  Framework Capability — RootFqns
+  FQN: org.blockml.bml.framework.capability.RootFqns
+-->
+<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:core="org.blockml.bml.core"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>RootFqns</name>
+  <type>fwcap:RootFqns</type>
+  <baseType>core:Capability</baseType>
+  <is>Sorted root FQNs from TypeRegistry index</is>
+
+  <properties>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <fqns type="type:Text[]">
+      <documentation>root FQNs sorted. (required)</documentation>
+    </fqns>
+  </properties>
+
+</block>

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

@@ -0,0 +1,43 @@
+<!--
+  Framework Capability — TypeRegistry
+  FQN: org.blockml.bml.framework.capability.TypeRegistry
+-->
+<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">
+
+  <name>TypeRegistry</name>
+  <type>fwcap:TypeRegistry</type>
+  <baseType>core:Capability</baseType>
+  <is>In-memory index of BlockDefinition documents by type FQN</is>
+
+  <documentation>Class exported from registry/type-registry.ts. Implements bomapi:TypeRegistryReader (get/has).</documentation>
+
+  <references>
+    <see type="bomapi:TypeRegistryReader" relation="SeeAlso" />
+    <see type="fwdocumentation:TypeRegistryBootstrap" relation="SeeAlso" />
+  </references>
+
+</block>

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

@@ -0,0 +1,54 @@
+<!--
+  Framework Capability — ValidateConstraints
+  FQN: org.blockml.bml.framework.capability.ValidateConstraints
+-->
+<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">
+
+  <name>ValidateConstraints</name>
+  <type>fwcap:ValidateConstraints</type>
+  <baseType>core:Capability</baseType>
+  <is>Evaluate constraint BlockInstances in composition tree</is>
+
+  <documentation>Evaluate constraint BlockInstances in composition tree</documentation>
+
+  <references>
+    <see type="fwdocumentation:ConstraintValidation" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. TS type: bomdoc:BomDocument. (required)</documentation>
+    </document>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,31 @@
+<!--
+  Framework Capability — ValidateEmbeddedBlocks
+  FQN: org.blockml.bml.framework.capability.ValidateEmbeddedBlocks
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability">
+
+  <name>ValidateEmbeddedBlocks</name>
+  <type>fwcap:ValidateEmbeddedBlocks</type>
+  <baseType>core:Capability</baseType>
+  <is>Embedded block and sub-block placement rules</is>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. (required)</documentation>
+    </document>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,34 @@
+<!--
+  Framework Capability — ValidateInstances
+  FQN: org.blockml.bml.framework.capability.ValidateInstances
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability">
+
+  <name>ValidateInstances</name>
+  <type>fwcap:ValidateInstances</type>
+  <baseType>core:Capability</baseType>
+  <is>Instance id and cross-reference rules</is>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. (required)</documentation>
+    </document>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. (required)</documentation>
+    </registry>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,34 @@
+<!--
+  Framework Capability — ValidatePresets
+  FQN: org.blockml.bml.framework.capability.ValidatePresets
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability">
+
+  <name>ValidatePresets</name>
+  <type>fwcap:ValidatePresets</type>
+  <baseType>core:Capability</baseType>
+  <is>Preset inheritance and property binding rules</is>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. (required)</documentation>
+    </document>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. (required)</documentation>
+    </registry>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,34 @@
+<!--
+  Framework Capability — ValidateReadOnly
+  FQN: org.blockml.bml.framework.capability.ValidateReadOnly
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability">
+
+  <name>ValidateReadOnly</name>
+  <type>fwcap:ValidateReadOnly</type>
+  <baseType>core:Capability</baseType>
+  <is>readOnly member write enforcement on block instances</is>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. (required)</documentation>
+    </document>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. (required)</documentation>
+    </registry>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,55 @@
+<!--
+  Framework Capability — ValidateTypes
+  FQN: org.blockml.bml.framework.capability.ValidateTypes
+-->
+<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">
+
+  <name>ValidateTypes</name>
+  <type>fwcap:ValidateTypes</type>
+  <baseType>core:Capability</baseType>
+  <is>Semantic type checks on BomDocument using TypeRegistry</is>
+
+  <documentation>Semantic type checks on BomDocument using TypeRegistry</documentation>
+
+  <references>
+    <see type="fwcap:ResolveEffectiveMembers" relation="SeeAlso" />
+    <see type="fwcap:ParseExpression" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. TS type: bomdoc:BomDocument. (required)</documentation>
+    </document>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,54 @@
+<!--
+  Framework Capability — ValidateVersions
+  FQN: org.blockml.bml.framework.capability.ValidateVersions
+-->
+<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">
+
+  <name>ValidateVersions</name>
+  <type>fwcap:ValidateVersions</type>
+  <baseType>core:Capability</baseType>
+  <is>Minimal effectiveBlockVersion and bml:version assert checks</is>
+
+  <documentation>BML_MISSING_VERSION on standalone root blocks outside framework library convention. BML_UNKNOWN_VERSION when bml:version pin does not match a registered block version.</documentation>
+
+  <references>
+    <see type="bomdocumentation:VersionRules" relation="SeeAlso" />
+  </references>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. TS type: bomdoc:BomDocument. (required)</documentation>
+    </document>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. TS type: fwcap:TypeRegistry. (required)</documentation>
+    </registry>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. TS type: bomcommon:Diagnostic[]. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

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

@@ -0,0 +1,34 @@
+<!--
+  Framework Capability — ValidateVisibility
+  FQN: org.blockml.bml.framework.capability.ValidateVisibility
+-->
+<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:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability">
+
+  <name>ValidateVisibility</name>
+  <type>fwcap:ValidateVisibility</type>
+  <baseType>core:Capability</baseType>
+  <is>Member visibility variant rules</is>
+
+  <properties>
+    <document type="bomdoc:BomDocument">
+      <documentation>document. (required)</documentation>
+    </document>
+    <registry type="fwcap:TypeRegistry">
+      <documentation>registry. (required)</documentation>
+    </registry>
+    <diagnostics type="bomcommon:Diagnostic[]">
+      <documentation>diagnostics. (required)</documentation>
+    </diagnostics>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/config/FrameworkDiagnosticCodes.bml

@@ -0,0 +1,44 @@
+<!--
+  Framework — FrameworkDiagnosticCodes
+  FQN: org.blockml.bml.framework.config.FrameworkDiagnosticCodes
+-->
+<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">
+
+  <name>FrameworkDiagnosticCodes</name>
+  <type>fwconfig:FrameworkDiagnosticCodes</type>
+  <baseType>framework:FrameworkType</baseType>
+  <is>Diagnostic codes emitted by framework utilities</is>
+
+  <documentation>Used by validateTypes, validateConstraints, and bootstrapTypeRegistry.</documentation>
+
+  <properties>
+    <codes type="type:Text[]">
+      <documentation>Ordered: BML_UNKNOWN_BASE_TYPE, BML_UNKNOWN_CONTRACT, BML_MEMBER_COLLISION, BML_OVERRIDE_WITHOUT_PARENT, BML_OVERRIDE_REQUIRED, BML_EXPRESSION_PARSE_ERROR, BML_CONSTRAINT_VIOLATION, BML_CONSTRAINT_WARNING, BML_CONSTRAINT_INFORMATION, BML_CONSTRAINT_UNKNOWN, BML_CONSTRAINT_TARGET_MISMATCH, BML_EMBEDDED_BLOCKS_ON_SUBBLOCK, BML_NESTED_EMBEDDED_BLOCKS, BML_DUPLICATE_EMBEDDED_BLOCK, BML_SUBBLOCK_TYPE_MISMATCH, BML_MISSING_ID, BML_UNRESOLVABLE_INSTANCE_REF, BML_PRESET_CYCLE, BML_UNKNOWN_PROPERTY, BML_DUPLICATE_MEMBER_VISIBILITY_VARIANT, BML_VISIBILITY_PRIVATE_OVERRIDE, BML_READONLY_MEMBER_WRITE, BML_MISSING_VERSION, BML_UNKNOWN_VERSION, BML_LIBRARY_RESOLVE_ERROR, BML_LIBRARY_NESTING_VIOLATION, BML_BOOTSTRAP_READ_ERROR (required)</documentation>
+    </codes>
+  </properties>
+
+</block>