@blockml/compiler 0.9.3 → 0.9.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/blocks/org/blockml/bml/compiler/runtime/Library.bml +19 -26
  2. package/blocks/org/blockml/bml/compiler/runtime/README.bml +14 -21
  3. package/blocks/org/blockml/bml/compiler/runtime/RuntimeType.bml +16 -18
  4. package/blocks/org/blockml/bml/compiler/runtime/api/CompileBomOptions.bml +34 -22
  5. package/blocks/org/blockml/bml/compiler/runtime/api/CompileInput.bml +28 -20
  6. package/blocks/org/blockml/bml/compiler/runtime/api/CompileOptions.bml +29 -21
  7. package/blocks/org/blockml/bml/compiler/runtime/api/CompileRequest.bml +23 -19
  8. package/blocks/org/blockml/bml/compiler/runtime/api/CompileScope.bml +38 -22
  9. package/blocks/org/blockml/bml/compiler/runtime/api/CompileScopeKind.bml +33 -21
  10. package/blocks/org/blockml/bml/compiler/runtime/api/CompilerResult.bml +28 -20
  11. package/blocks/org/blockml/bml/compiler/runtime/api/RenderContext.bml +28 -20
  12. package/blocks/org/blockml/bml/compiler/runtime/api/RenderOutput.bml +28 -20
  13. package/blocks/org/blockml/bml/compiler/runtime/api/RenderOutputFile.bml +23 -19
  14. package/blocks/org/blockml/bml/compiler/runtime/api/RenderSession.bml +49 -25
  15. package/blocks/org/blockml/bml/compiler/runtime/api/RenderTarget.bml +33 -21
  16. package/blocks/org/blockml/bml/compiler/runtime/api/ResolvedScope.bml +33 -21
  17. package/blocks/org/blockml/bml/compiler/runtime/api/ScopeConfigHints.bml +28 -20
  18. package/blocks/org/blockml/bml/compiler/runtime/api/ValidateRegistryResult.bml +28 -20
  19. package/blocks/org/blockml/bml/compiler/runtime/capability/BuildRenderSession.bml +20 -22
  20. package/blocks/org/blockml/bml/compiler/runtime/capability/ClearTargets.bml +13 -20
  21. package/blocks/org/blockml/bml/compiler/runtime/capability/CompileBmlToBom.bml +22 -22
  22. package/blocks/org/blockml/bml/compiler/runtime/capability/CompileBmlToOutput.bml +25 -23
  23. package/blocks/org/blockml/bml/compiler/runtime/capability/CompileBomToOutput.bml +27 -27
  24. package/blocks/org/blockml/bml/compiler/runtime/capability/CompileToOutput.bml +28 -24
  25. package/blocks/org/blockml/bml/compiler/runtime/capability/CreateRenderContext.bml +25 -23
  26. package/blocks/org/blockml/bml/compiler/runtime/capability/GetTarget.bml +19 -21
  27. package/blocks/org/blockml/bml/compiler/runtime/capability/RegisterTarget.bml +17 -21
  28. package/blocks/org/blockml/bml/compiler/runtime/capability/RegisteredTargetNames.bml +16 -19
  29. package/blocks/org/blockml/bml/compiler/runtime/capability/ResolveScope.bml +25 -23
  30. package/blocks/org/blockml/bml/compiler/runtime/capability/ScopeAccepts.bml +22 -22
  31. package/blocks/org/blockml/bml/compiler/runtime/capability/ValidateRegistryDocuments.bml +23 -23
  32. package/blocks/org/blockml/bml/compiler/runtime/config/RuntimeConstants.bml +39 -23
  33. package/blocks/org/blockml/bml/compiler/runtime/documentation/ArchitectureOverview.bml +15 -19
  34. package/blocks/org/blockml/bml/compiler/runtime/documentation/CompileIO.bml +14 -20
  35. package/blocks/org/blockml/bml/compiler/runtime/documentation/CompileScopeRules.bml +15 -21
  36. package/blocks/org/blockml/bml/compiler/runtime/documentation/DesignDecisions.bml +17 -23
  37. package/blocks/org/blockml/bml/compiler/runtime/documentation/Diagnostics.bml +17 -23
  38. package/blocks/org/blockml/bml/compiler/runtime/documentation/ExternalTargetContract.bml +18 -22
  39. package/blocks/org/blockml/bml/compiler/runtime/documentation/Introduction.bml +16 -20
  40. package/blocks/org/blockml/bml/compiler/runtime/documentation/LayerSeparation.bml +15 -19
  41. package/blocks/org/blockml/bml/compiler/runtime/documentation/PackageOwnership.bml +15 -19
  42. package/blocks/org/blockml/bml/compiler/runtime/documentation/PublicApi.bml +15 -19
  43. package/blocks/org/blockml/bml/compiler/runtime/documentation/RenderContextRules.bml +14 -20
  44. package/blocks/org/blockml/bml/compiler/runtime/documentation/ScopeExclusions.bml +14 -18
  45. package/blocks/org/blockml/bml/compiler/runtime/documentation/TargetRegistry.bml +14 -20
  46. package/blocks/org/blockml/bml/compiler/runtime/documentation/V1Scope.bml +15 -19
  47. package/package.json +6 -6
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — RenderContext
3
- FQN: org.blockml.bml.compiler.runtime.api.RenderContext
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — RenderContext
2
+ FQN: org.blockml.bml.compiler.runtime.api.RenderContext-->
3
+ <runapi:RenderContext xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,19 +19,33 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>RenderContext</name>
29
- <type>runapi:RenderContext</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Per-node render context with child fork</is>
32
-
33
- <documentation>C1: session plus blockFqn and outputRelativePath; child() forks without mutating session.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Per-node render context with child fork
27
+ </is>
28
+ <documentation>
29
+ C1: session plus blockFqn and outputRelativePath; child() forks without mutating session.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <session type="runapi:RenderSession"><documentation>Shared session. (required)</documentation></session>
39
- <blockFqn type="type:Text"><documentation>Current block FQN. (required)</documentation></blockFqn>
40
- <outputRelativePath type="type:Text"><documentation>Relative output path hint. (required)</documentation></outputRelativePath>
35
+ <session type="runapi:RenderSession">
36
+ <documentation>
37
+ Shared session. (required)
38
+ </documentation>
39
+ </session>
40
+ <blockFqn type="type:Text">
41
+ <documentation>
42
+ Current block FQN. (required)
43
+ </documentation>
44
+ </blockFqn>
45
+ <outputRelativePath type="type:Text">
46
+ <documentation>
47
+ Relative output path hint. (required)
48
+ </documentation>
49
+ </outputRelativePath>
41
50
  </properties>
42
-
43
- </block>
51
+ </runapi:RenderContext>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — RenderOutput
3
- FQN: org.blockml.bml.compiler.runtime.api.RenderOutput
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — RenderOutput
2
+ FQN: org.blockml.bml.compiler.runtime.api.RenderOutput-->
3
+ <runapi:RenderOutput xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,19 +19,33 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>RenderOutput</name>
29
- <type>runapi:RenderOutput</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Opaque Stage-3 render result</is>
32
-
33
- <documentation>C4/C6: base shape is files[] with optional rootFiles[] and diagnostics[]. Thumbnails are not part of RenderOutput.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Opaque Stage-3 render result
27
+ </is>
28
+ <documentation>
29
+ C4/C6: base shape is files[] with optional rootFiles[] and diagnostics[]. Thumbnails are not part of RenderOutput.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <files type="runapi:RenderOutputFile"><documentation>Primary artifacts under outputBasePath. (required)</documentation></files>
39
- <rootFiles type="runapi:RenderOutputFile"><documentation>Root-level artifacts (e.g. catalog.xml). (optional)</documentation></rootFiles>
40
- <diagnostics type="type:Text"><documentation>Target-emitted diagnostics for CLI merge. (optional)</documentation></diagnostics>
35
+ <files type="runapi:RenderOutputFile">
36
+ <documentation>
37
+ Primary artifacts under outputBasePath. (required)
38
+ </documentation>
39
+ </files>
40
+ <rootFiles type="runapi:RenderOutputFile">
41
+ <documentation>
42
+ Root-level artifacts (e.g. catalog.xml). (optional)
43
+ </documentation>
44
+ </rootFiles>
45
+ <diagnostics type="type:Text">
46
+ <documentation>
47
+ Target-emitted diagnostics for CLI merge. (optional)
48
+ </documentation>
49
+ </diagnostics>
41
50
  </properties>
42
-
43
- </block>
51
+ </runapi:RenderOutput>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — RenderOutputFile
3
- FQN: org.blockml.bml.compiler.runtime.api.RenderOutputFile
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — RenderOutputFile
2
+ FQN: org.blockml.bml.compiler.runtime.api.RenderOutputFile-->
3
+ <runapi:RenderOutputFile xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,18 +19,28 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>RenderOutputFile</name>
29
- <type>runapi:RenderOutputFile</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Single path/content pair in RenderOutput</is>
32
-
33
- <documentation>C4: targets emit zero or more files; host writes them.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Single path/content pair in RenderOutput
27
+ </is>
28
+ <documentation>
29
+ C4: targets emit zero or more files; host writes them.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <path type="type:Text"><documentation>Relative output path. (required)</documentation></path>
39
- <content type="type:Text"><documentation>File content. (required)</documentation></content>
35
+ <path type="type:Text">
36
+ <documentation>
37
+ Relative output path. (required)
38
+ </documentation>
39
+ </path>
40
+ <content type="type:Text">
41
+ <documentation>
42
+ File content. (required)
43
+ </documentation>
44
+ </content>
40
45
  </properties>
41
-
42
- </block>
46
+ </runapi:RenderOutputFile>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — RenderSession
3
- FQN: org.blockml.bml.compiler.runtime.api.RenderSession
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — RenderSession
2
+ FQN: org.blockml.bml.compiler.runtime.api.RenderSession-->
3
+ <runapi:RenderSession xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,25 +19,55 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>RenderSession</name>
29
- <type>runapi:RenderSession</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Immutable per-compile session shared by RenderContext forks</is>
32
-
33
- <documentation>C1: built by BuildRenderSession after scope bootstrap or BOM-first host registry.
34
- Domain-agnostic — no MachineBlocks or product-profile fields.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Immutable per-compile session shared by RenderContext forks
27
+ </is>
28
+ <documentation>
29
+ C1: built by BuildRenderSession after scope bootstrap or BOM-first host registry.
30
+ Domain-agnostic — no MachineBlocks or product-profile fields.
31
+ </documentation>
35
32
  <references>
36
33
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
37
34
  <see type="rundocumentation:ExternalTargetContract" relation="SeeAlso" />
38
35
  </references>
39
36
  <properties>
40
- <typeRegistry type="type:Text"><documentation>TypeRegistry for this compile. (required)</documentation></typeRegistry>
41
- <sourceFilePath type="type:Text"><documentation>Document path or scope placeholder. (required)</documentation></sourceFilePath>
42
- <outputBasePath type="type:Text"><documentation>Output base path. (required)</documentation></outputBasePath>
43
- <targetName type="type:Text"><documentation>Registered target name. (required)</documentation></targetName>
44
- <scopeKind type="type:Text"><documentation>Resolved kind without auto. (required)</documentation></scopeKind>
45
- <libraryPaths type="type:Text"><documentation>When scope is library. (optional)</documentation></libraryPaths>
46
- <corpusRoots type="type:Text"><documentation>When scope is corpus. (optional)</documentation></corpusRoots>
37
+ <typeRegistry type="type:Text">
38
+ <documentation>
39
+ TypeRegistry for this compile. (required)
40
+ </documentation>
41
+ </typeRegistry>
42
+ <sourceFilePath type="type:Text">
43
+ <documentation>
44
+ Document path or scope placeholder. (required)
45
+ </documentation>
46
+ </sourceFilePath>
47
+ <outputBasePath type="type:Text">
48
+ <documentation>
49
+ Output base path. (required)
50
+ </documentation>
51
+ </outputBasePath>
52
+ <targetName type="type:Text">
53
+ <documentation>
54
+ Registered target name. (required)
55
+ </documentation>
56
+ </targetName>
57
+ <scopeKind type="type:Text">
58
+ <documentation>
59
+ Resolved kind without auto. (required)
60
+ </documentation>
61
+ </scopeKind>
62
+ <libraryPaths type="type:Text">
63
+ <documentation>
64
+ When scope is library. (optional)
65
+ </documentation>
66
+ </libraryPaths>
67
+ <corpusRoots type="type:Text">
68
+ <documentation>
69
+ When scope is corpus. (optional)
70
+ </documentation>
71
+ </corpusRoots>
47
72
  </properties>
48
-
49
- </block>
73
+ </runapi:RenderSession>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — RenderTarget
3
- FQN: org.blockml.bml.compiler.runtime.api.RenderTarget
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — RenderTarget
2
+ FQN: org.blockml.bml.compiler.runtime.api.RenderTarget-->
3
+ <runapi:RenderTarget xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,20 +19,38 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>RenderTarget</name>
29
- <type>runapi:RenderTarget</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Registered Stage-3 render target contract</is>
32
-
33
- <documentation>C3/C7: name, accepts[], optional validateRequest, render(request, ctx).</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Registered Stage-3 render target contract
27
+ </is>
28
+ <documentation>
29
+ C3/C7: name, accepts[], optional validateRequest, render(request, ctx).
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <name type="type:Text"><documentation>Registry key / CLI target name. (required)</documentation></name>
39
- <accepts type="type:Text"><documentation>CompileScopeKind values this target accepts. (required)</documentation></accepts>
40
- <validateRequest type="type:Text"><documentation>Optional request validation returning diagnostics. (optional)</documentation></validateRequest>
41
- <render type="type:Text"><documentation>Produce RenderOutput from request and context. (required)</documentation></render>
35
+ <name type="type:Text">
36
+ <documentation>
37
+ Registry key / CLI target name. (required)
38
+ </documentation>
39
+ </name>
40
+ <accepts type="type:Text">
41
+ <documentation>
42
+ CompileScopeKind values this target accepts. (required)
43
+ </documentation>
44
+ </accepts>
45
+ <validateRequest type="type:Text">
46
+ <documentation>
47
+ Optional request validation returning diagnostics. (optional)
48
+ </documentation>
49
+ </validateRequest>
50
+ <render type="type:Text">
51
+ <documentation>
52
+ Produce RenderOutput from request and context. (required)
53
+ </documentation>
54
+ </render>
42
55
  </properties>
43
-
44
- </block>
56
+ </runapi:RenderTarget>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — ResolvedScope
3
- FQN: org.blockml.bml.compiler.runtime.api.ResolvedScope
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — ResolvedScope
2
+ FQN: org.blockml.bml.compiler.runtime.api.ResolvedScope-->
3
+ <runapi:ResolvedScope xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,20 +19,38 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>ResolvedScope</name>
29
- <type>runapi:ResolvedScope</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Concrete scope after ResolveScope (never auto)</is>
32
-
33
- <documentation>kind is document | library | corpus with corresponding payload fields.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Concrete scope after ResolveScope (never auto)
27
+ </is>
28
+ <documentation>
29
+ kind is document | library | corpus with corresponding payload fields.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <kind type="type:Text"><documentation>Resolved kind without auto. (required)</documentation></kind>
39
- <document type="runapi:CompileInput"><documentation>When kind is document. (optional)</documentation></document>
40
- <libraries type="type:Text"><documentation>When kind is library. (optional)</documentation></libraries>
41
- <roots type="type:Text"><documentation>When kind is corpus. (optional)</documentation></roots>
35
+ <kind type="type:Text">
36
+ <documentation>
37
+ Resolved kind without auto. (required)
38
+ </documentation>
39
+ </kind>
40
+ <document type="runapi:CompileInput">
41
+ <documentation>
42
+ When kind is document. (optional)
43
+ </documentation>
44
+ </document>
45
+ <libraries type="type:Text">
46
+ <documentation>
47
+ When kind is library. (optional)
48
+ </documentation>
49
+ </libraries>
50
+ <roots type="type:Text">
51
+ <documentation>
52
+ When kind is corpus. (optional)
53
+ </documentation>
54
+ </roots>
42
55
  </properties>
43
-
44
- </block>
56
+ </runapi:ResolvedScope>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — ScopeConfigHints
3
- FQN: org.blockml.bml.compiler.runtime.api.ScopeConfigHints
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — ScopeConfigHints
2
+ FQN: org.blockml.bml.compiler.runtime.api.ScopeConfigHints-->
3
+ <runapi:ScopeConfigHints xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,19 +19,33 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>ScopeConfigHints</name>
29
- <type>runapi:ScopeConfigHints</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Host hints merged into ResolveScope</is>
32
-
33
- <documentation>CLI passes libraries/roots/rootDir from blockml.config.json.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Host hints merged into ResolveScope
27
+ </is>
28
+ <documentation>
29
+ CLI passes libraries/roots/rootDir from blockml.config.json.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <libraries type="type:Text"><documentation>Fallback Library.bml paths. (optional)</documentation></libraries>
39
- <roots type="type:Text"><documentation>Fallback corpus roots. (optional)</documentation></roots>
40
- <rootDir type="type:Text"><documentation>Root for empty-scope diagnostics. (optional)</documentation></rootDir>
35
+ <libraries type="type:Text">
36
+ <documentation>
37
+ Fallback Library.bml paths. (optional)
38
+ </documentation>
39
+ </libraries>
40
+ <roots type="type:Text">
41
+ <documentation>
42
+ Fallback corpus roots. (optional)
43
+ </documentation>
44
+ </roots>
45
+ <rootDir type="type:Text">
46
+ <documentation>
47
+ Root for empty-scope diagnostics. (optional)
48
+ </documentation>
49
+ </rootDir>
41
50
  </properties>
42
-
43
- </block>
51
+ </runapi:ScopeConfigHints>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — ValidateRegistryResult
3
- FQN: org.blockml.bml.compiler.runtime.api.ValidateRegistryResult
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime API — ValidateRegistryResult
2
+ FQN: org.blockml.bml.compiler.runtime.api.ValidateRegistryResult-->
3
+ <runapi:ValidateRegistryResult xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,19 +19,33 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>ValidateRegistryResult</name>
29
- <type>runapi:ValidateRegistryResult</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Diagnostics plus per-document validation counts</is>
32
-
33
- <documentation>One unique filePath is one block. blocksWithErrors counts documents whose validate() result has severity error.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Diagnostics plus per-document validation counts
27
+ </is>
28
+ <documentation>
29
+ One unique filePath is one block. blocksWithErrors counts documents whose validate() result has severity error.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="runcap:ValidateRegistryDocuments" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <diagnostics type="type:Text"><documentation>Flattened Diagnostic list. (required)</documentation></diagnostics>
39
- <blocksTested type="type:Integer"><documentation>Unique documents validated after filePath dedupe. (required)</documentation></blocksTested>
40
- <blocksWithErrors type="type:Integer"><documentation>Documents with at least one error diagnostic. (required)</documentation></blocksWithErrors>
35
+ <diagnostics type="type:Text">
36
+ <documentation>
37
+ Flattened Diagnostic list. (required)
38
+ </documentation>
39
+ </diagnostics>
40
+ <blocksTested type="type:Integer">
41
+ <documentation>
42
+ Unique documents validated after filePath dedupe. (required)
43
+ </documentation>
44
+ </blocksTested>
45
+ <blocksWithErrors type="type:Integer">
46
+ <documentation>
47
+ Documents with at least one error diagnostic. (required)
48
+ </documentation>
49
+ </blocksWithErrors>
41
50
  </properties>
42
-
43
- </block>
51
+ </runapi:ValidateRegistryResult>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime Capability — BuildRenderSession
3
- FQN: org.blockml.bml.compiler.runtime.capability.BuildRenderSession
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime Capability — BuildRenderSession
2
+ FQN: org.blockml.bml.compiler.runtime.capability.BuildRenderSession-->
3
+ <runcap:BuildRenderSession xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,25 +19,29 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>BuildRenderSession</name>
29
- <type>runcap:BuildRenderSession</type>
30
- <baseType>core:Capability</baseType>
31
- <is>Construct RenderSession from bootstrap or BOM-first results</is>
32
-
33
- <documentation>C1: defaults sourceFilePath to the literal placeholder scope (angle brackets),
34
- outputBasePath to dot. Session fields are domain-agnostic.</documentation>
35
-
22
+ <baseType>
23
+ core:Capability
24
+ </baseType>
25
+ <is>
26
+ Construct RenderSession from bootstrap or BOM-first results
27
+ </is>
28
+ <documentation>
29
+ C1: defaults sourceFilePath to the literal placeholder scope (angle brackets),
30
+ outputBasePath to dot. Session fields are domain-agnostic.
31
+ </documentation>
36
32
  <references>
37
33
  <see type="rundocumentation:RenderContextRules" relation="SeeAlso" />
38
34
  </references>
39
-
40
35
  <properties>
41
36
  <options type="type:Text">
42
- <documentation>Session field bag including typeRegistry, targetName, scopeKind. (required)</documentation>
37
+ <documentation>
38
+ Session field bag including typeRegistry, targetName, scopeKind. (required)
39
+ </documentation>
43
40
  </options>
44
41
  <result type="runapi:RenderSession">
45
- <documentation>Immutable session. (required)</documentation>
42
+ <documentation>
43
+ Immutable session. (required)
44
+ </documentation>
46
45
  </result>
47
46
  </properties>
48
-
49
- </block>
47
+ </runcap:BuildRenderSession>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime Capability — ClearTargets
3
- FQN: org.blockml.bml.compiler.runtime.capability.ClearTargets
4
- -->
5
- <block
6
- xmlns="http://blockml.org/bml"
7
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
8
- xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
9
- "
1
+ <!--Compiler Runtime Capability — ClearTargets
2
+ FQN: org.blockml.bml.compiler.runtime.capability.ClearTargets-->
3
+ <runcap:ClearTargets xmlns="http://blockml.org/bml"
10
4
  xmlns:blockml="org.blockml.bml"
11
5
  xmlns:bom="org.blockml.bml.bom"
12
6
  xmlns:bomapi="org.blockml.bml.bom.api"
@@ -25,17 +19,16 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>ClearTargets</name>
29
- <type>runcap:ClearTargets</type>
30
- <baseType>core:Capability</baseType>
31
- <is>Clear all registered targets</is>
32
-
33
- <documentation>Used by tests and host re-bootstrap. C3: no default re-seed.</documentation>
34
-
22
+ <baseType>
23
+ core:Capability
24
+ </baseType>
25
+ <is>
26
+ Clear all registered targets
27
+ </is>
28
+ <documentation>
29
+ Used by tests and host re-bootstrap. C3: no default re-seed.
30
+ </documentation>
35
31
  <references>
36
32
  <see type="rundocumentation:TargetRegistry" relation="SeeAlso" />
37
33
  </references>
38
-
39
-
40
-
41
- </block>
34
+ </runcap:ClearTargets>