@blockml/framework 0.1.0

package/blocks/org/blockml/bml/framework/documentation/TypeRegistryBootstrap.bml

@@ -0,0 +1,64 @@
+<!--
+  Framework Documentation — TypeRegistryBootstrap
+  FQN: org.blockml.bml.framework.documentation.TypeRegistryBootstrap
+-->
+<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:doc="org.blockml.bml.documentation">
+
+  <name>TypeRegistryBootstrap</name>
+  <type>fwdocumentation:TypeRegistryBootstrap</type>
+  <baseType>core:Documentation</baseType>
+  <is>defaultBootstrapPaths and bootstrapTypeRegistry</is>
+
+  <documentation>bootstrapTypeRegistry(options?) supports two modes:
+
+    corpus (default) — walks options.paths (or defaultBootstrapPaths()) for all .bml files,
+    parses via @blockml/parser parse(), registers each document root block.
+
+    library — when options.libraryPaths is set, resolves each Library.bml dependency graph
+    (dependencies, subLibraries) in order, then registers blocks from each library blocks root.
+    Missing Library path → BML_LIBRARY_RESOLVE_ERROR. Outer re-export of inner-only block →
+    BML_LIBRARY_NESTING_VIOLATION (minimal check).
+
+    defaultBootstrapPaths(rootDir?) returns:
+    • node_modules/@blockml/core/blocks
+    • node_modules/@machineblocks/core/blocks
+
+    BootstrapResult: { registry: TypeRegistry, diagnostics: Diagnostic[] }
+    Read errors emit BML_BOOTSTRAP_READ_ERROR (warning). Parse diagnostics are collected
+    but do not stop registration of successfully parsed documents.
+
+    Hosts (@blockml/cli, @blockml/validator) may inject a pre-built TypeRegistry via
+    ValidateOptions.typeRegistry instead of bootstrapping. ValidateOptions.libraryPaths
+    selects library mode when typeRegistry is omitted.</documentation>
+
+  <references>
+    <see type="fwdocumentation:EffectiveMembers" relation="ReadNext"></see>
+    <see type="fwcap:BootstrapTypeRegistry" relation="Defines"></see>
+  </references>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/ArrayExpressionNode.bml

@@ -0,0 +1,48 @@
+<!--
+  Framework — ArrayExpressionNode
+  FQN: org.blockml.bml.framework.expression.ArrayExpressionNode
+-->
+<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>ArrayExpressionNode</name>
+  <type>fwexpression:ArrayExpressionNode</type>
+  <baseType>fwexpression:ExpressionNode</baseType>
+  <is>Array expression AST node</is>
+
+  <documentation>kind: array. elements: ExpressionNode[].</documentation>
+
+  <properties>
+    <kind type="type:Text">
+      <documentation>kind. TS type: type:Text. (required)</documentation>
+      <value>array</value>
+    </kind>
+    <elements type="fwexpression:ExpressionNode[]">
+      <documentation>elements. TS type: fwexpression:ExpressionNode[]. (required)</documentation>
+    </elements>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/BinaryExpressionNode.bml

@@ -0,0 +1,54 @@
+<!--
+  Framework — BinaryExpressionNode
+  FQN: org.blockml.bml.framework.expression.BinaryExpressionNode
+-->
+<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>BinaryExpressionNode</name>
+  <type>fwexpression:BinaryExpressionNode</type>
+  <baseType>fwexpression:ExpressionNode</baseType>
+  <is>Binary operator expression AST node</is>
+
+  <documentation>kind: binary. operator: + | - | * | /. left/right: ExpressionNode.</documentation>
+
+  <properties>
+    <kind type="type:Text">
+      <documentation>kind. TS type: type:Text. (required)</documentation>
+      <value>binary</value>
+    </kind>
+    <operator type="type:Text">
+      <documentation>operator. TS type: type:Text. (required)</documentation>
+    </operator>
+    <left type="fwexpression:ExpressionNode">
+      <documentation>left. TS type: fwexpression:ExpressionNode. (required)</documentation>
+    </left>
+    <right type="fwexpression:ExpressionNode">
+      <documentation>right. TS type: fwexpression:ExpressionNode. (required)</documentation>
+    </right>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/CallExpressionNode.bml

@@ -0,0 +1,51 @@
+<!--
+  Framework — CallExpressionNode
+  FQN: org.blockml.bml.framework.expression.CallExpressionNode
+-->
+<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>CallExpressionNode</name>
+  <type>fwexpression:CallExpressionNode</type>
+  <baseType>fwexpression:ExpressionNode</baseType>
+  <is>Function call expression AST node</is>
+
+  <documentation>kind: call. callee: string. args: ExpressionNode[].</documentation>
+
+  <properties>
+    <kind type="type:Text">
+      <documentation>kind. TS type: type:Text. (required)</documentation>
+      <value>call</value>
+    </kind>
+    <callee type="type:Text">
+      <documentation>callee. TS type: type:Text. (required)</documentation>
+    </callee>
+    <args type="fwexpression:ExpressionNode[]">
+      <documentation>args. TS type: fwexpression:ExpressionNode[]. (required)</documentation>
+    </args>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/ExpressionNode.bml

@@ -0,0 +1,44 @@
+<!--
+  Framework — ExpressionNode
+  FQN: org.blockml.bml.framework.expression.ExpressionNode
+-->
+<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>ExpressionNode</name>
+  <type>fwexpression:ExpressionNode</type>
+  <baseType>framework:FrameworkType</baseType>
+  <is>Abstract union of expression AST node variants</is>
+
+  <documentation>Discriminated by kind: literal | array | object | property | call | binary.</documentation>
+
+  <references>
+    <see type="fwexpression:LiteralExpressionNode" relation="SeeAlso" />
+  </references>
+
+  <abstract>true</abstract>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/LiteralExpressionNode.bml

@@ -0,0 +1,48 @@
+<!--
+  Framework — LiteralExpressionNode
+  FQN: org.blockml.bml.framework.expression.LiteralExpressionNode
+-->
+<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>LiteralExpressionNode</name>
+  <type>fwexpression:LiteralExpressionNode</type>
+  <baseType>fwexpression:ExpressionNode</baseType>
+  <is>Literal expression AST node</is>
+
+  <documentation>kind: literal. value: string | number | boolean | null.</documentation>
+
+  <properties>
+    <kind type="type:Text">
+      <documentation>kind. TS type: type:Text. (required)</documentation>
+      <value>literal</value>
+    </kind>
+    <value type="core:Any">
+      <documentation>value. TS type: core:Any. (required)</documentation>
+    </value>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/ObjectExpressionNode.bml

@@ -0,0 +1,48 @@
+<!--
+  Framework — ObjectExpressionNode
+  FQN: org.blockml.bml.framework.expression.ObjectExpressionNode
+-->
+<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>ObjectExpressionNode</name>
+  <type>fwexpression:ObjectExpressionNode</type>
+  <baseType>fwexpression:ExpressionNode</baseType>
+  <is>Object expression AST node</is>
+
+  <documentation>kind: object. entries: Record<string, ExpressionNode>.</documentation>
+
+  <properties>
+    <kind type="type:Text">
+      <documentation>kind. TS type: type:Text. (required)</documentation>
+      <value>object</value>
+    </kind>
+    <entries type="core:Any">
+      <documentation>Record<string, ExpressionNode>. (required)</documentation>
+    </entries>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/ParseExpressionError.bml

@@ -0,0 +1,47 @@
+<!--
+  Framework — ParseExpressionError
+  FQN: org.blockml.bml.framework.expression.ParseExpressionError
+-->
+<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>ParseExpressionError</name>
+  <type>fwexpression:ParseExpressionError</type>
+  <baseType>framework:FrameworkType</baseType>
+  <is>Failed parseExpression error detail</is>
+
+  <documentation>Returned when ParseExpressionOutcome.ok === false.</documentation>
+
+  <properties>
+    <message type="type:Text">
+      <documentation>message. TS type: type:Text. (required)</documentation>
+    </message>
+    <offset type="type:Integer">
+      <documentation>offset. TS type: type:Integer. (required)</documentation>
+    </offset>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/ParseExpressionOutcome.bml

@@ -0,0 +1,50 @@
+<!--
+  Framework — ParseExpressionOutcome
+  FQN: org.blockml.bml.framework.expression.ParseExpressionOutcome
+-->
+<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>ParseExpressionOutcome</name>
+  <type>fwexpression:ParseExpressionOutcome</type>
+  <baseType>framework:FrameworkType</baseType>
+  <is>Discriminated union result of parseExpression</is>
+
+  <documentation>TS: { ok: true, result: ParseExpressionResult } | { ok: false, error: ParseExpressionError }.</documentation>
+
+  <properties>
+    <ok type="type:Boolean">
+      <documentation>ok. TS type: type:Boolean. (required)</documentation>
+    </ok>
+    <result type="fwexpression:ParseExpressionResult">
+      <documentation>Present when ok === true. (optional)</documentation>
+    </result>
+    <error type="fwexpression:ParseExpressionError">
+      <documentation>Present when ok === false. (optional)</documentation>
+    </error>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/ParseExpressionResult.bml

@@ -0,0 +1,47 @@
+<!--
+  Framework — ParseExpressionResult
+  FQN: org.blockml.bml.framework.expression.ParseExpressionResult
+-->
+<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>ParseExpressionResult</name>
+  <type>fwexpression:ParseExpressionResult</type>
+  <baseType>framework:FrameworkType</baseType>
+  <is>Successful parseExpression result</is>
+
+  <documentation>Returned when ParseExpressionOutcome.ok === true.</documentation>
+
+  <properties>
+    <ast type="fwexpression:ExpressionNode">
+      <documentation>ast. TS type: fwexpression:ExpressionNode. (required)</documentation>
+    </ast>
+    <resultTypeFqn type="type:Text">
+      <documentation>Optional resolved result type FQN. (optional)</documentation>
+    </resultTypeFqn>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/expression/PropertyExpressionNode.bml

@@ -0,0 +1,48 @@
+<!--
+  Framework — PropertyExpressionNode
+  FQN: org.blockml.bml.framework.expression.PropertyExpressionNode
+-->
+<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>PropertyExpressionNode</name>
+  <type>fwexpression:PropertyExpressionNode</type>
+  <baseType>fwexpression:ExpressionNode</baseType>
+  <is>Property path expression AST node</is>
+
+  <documentation>kind: property. path: string[] (dot-separated property access).</documentation>
+
+  <properties>
+    <kind type="type:Text">
+      <documentation>kind. TS type: type:Text. (required)</documentation>
+      <value>property</value>
+    </kind>
+    <path type="type:Text[]">
+      <documentation>path. TS type: type:Text[]. (required)</documentation>
+    </path>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/registry/BootstrapOptions.bml

@@ -0,0 +1,50 @@
+<!--
+  Framework — BootstrapOptions
+  FQN: org.blockml.bml.framework.registry.BootstrapOptions
+-->
+<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>BootstrapOptions</name>
+  <type>fwregistry:BootstrapOptions</type>
+  <baseType>framework:FrameworkType</baseType>
+  <is>Options for bootstrapTypeRegistry corpus or library graph modes</is>
+
+  <documentation>paths — flat corpus scan roots. libraryPaths — Library.bml entry points for dependency-ordered library mode. rootDir — relative path resolution base.</documentation>
+
+  <properties>
+    <paths type="type:Text[]">
+      <documentation>Corpus roots for flat scan mode. (optional)</documentation>
+    </paths>
+    <libraryPaths type="type:Text[]">
+      <documentation>Library.bml file paths for library graph mode. (optional)</documentation>
+    </libraryPaths>
+    <rootDir type="type:Text">
+      <documentation>Working directory for relative paths. (optional)</documentation>
+    </rootDir>
+  </properties>
+
+</block>

package/blocks/org/blockml/bml/framework/registry/BootstrapResult.bml

@@ -0,0 +1,53 @@
+<!--
+  Framework — BootstrapResult
+  FQN: org.blockml.bml.framework.registry.BootstrapResult
+-->
+<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>BootstrapResult</name>
+  <type>fwregistry:BootstrapResult</type>
+  <baseType>framework:FrameworkType</baseType>
+  <is>Result of bootstrapTypeRegistry corpus walk</is>
+
+  <documentation>Returned by fwcap:BootstrapTypeRegistry. Registry may be partially populated when diagnostics are present.
+
+    exportsByLibrary — optional Map from absolute Library.bml path to exported block FQNs;
+    present only when bootstrap used libraryPaths mode.</documentation>
+
+  <properties>
+    <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>
+    <exportsByLibrary type="type:Text">
+      <documentation>exportsByLibrary — Map&lt;libraryPath, Set&lt;exportedFqn&gt;&gt; when libraryPaths bootstrap. (optional)</documentation>
+    </exportsByLibrary>
+  </properties>
+
+</block>