@blockml/compiler 0.9.4 → 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
- BlockML Compiler Runtime Library
3
- FQN: org.blockml.bml.compiler.runtime.Library
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
+ <!--BlockML Compiler Runtime Library
2
+ FQN: org.blockml.bml.compiler.runtime.Library-->
3
+ <runtime:Library 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,36 +19,35 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>Library</name>
29
- <type>runtime:Library</type>
30
- <baseType>core:BlockLibrary</baseType>
31
- <is>The BlockML compiler runtime package library catalog</is>
32
-
22
+ <baseType>
23
+ core:BlockLibrary
24
+ </baseType>
25
+ <is>
26
+ The BlockML compiler runtime package library catalog
27
+ </is>
28
+ <version>
29
+ 0.9.5
30
+ </version>
33
31
  <documentation>
34
32
  Canonical compiler runtime specification for BlockML — compileToOutput, Target
35
33
  Registry, compile scope, RenderContext (C1–C7). TypeScript in packages/compiler/src/
36
34
  implements this library. Membership is defined exclusively by this blocks list.
37
35
  </documentation>
38
-
39
- <version>0.9.4</version>
40
-
41
36
  <language>
42
- <English />
37
+ <blockml:language.English />
43
38
  </language>
44
-
45
39
  <properties>
46
40
  <description override="true">
47
41
  <value>BlockML Compiler runtime library</value>
48
42
  </description>
49
43
  </properties>
50
-
51
44
  <aggregations>
52
- <readMe>
45
+ <readMe override="true">
53
46
  <composition>
54
47
  <runtime:README />
55
48
  </composition>
56
49
  </readMe>
57
- <dependencies>
50
+ <dependencies override="true">
58
51
  <composition>
59
52
  <blockml:Library />
60
53
  <bom:Library />
@@ -63,8 +56,9 @@
63
56
  <validator:Library />
64
57
  </composition>
65
58
  </dependencies>
66
- <blocks>
67
- <composition><runtime:RuntimeType />
59
+ <blocks override="true">
60
+ <composition>
61
+ <runtime:RuntimeType />
68
62
  <runapi:CompileScopeKind />
69
63
  <runapi:CompileInput />
70
64
  <runapi:CompileScope />
@@ -111,5 +105,4 @@
111
105
  </composition>
112
106
  </blocks>
113
107
  </aggregations>
114
-
115
- </block>
108
+ </runtime:Library>
@@ -1,12 +1,6 @@
1
- <!--
2
- BlockML Compiler Runtime — README
3
- FQN: org.blockml.bml.compiler.runtime.README
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
+ <!--BlockML Compiler Runtime — README
2
+ FQN: org.blockml.bml.compiler.runtime.README-->
3
+ <runtime:README 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,36 +19,35 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>README</name>
29
- <type>runtime:README</type>
30
- <baseType>core:ReadMe</baseType>
31
- <is>Reading entry for the compiler runtime library</is>
32
-
22
+ <baseType>
23
+ core:ReadMe
24
+ </baseType>
25
+ <is>
26
+ Reading entry for the compiler runtime library
27
+ </is>
33
28
  <documentation>
34
29
  The @blockml/compiler package implements the Stage-3 facade and Target Registry.
35
30
  This library (org.blockml.bml.compiler.runtime.*) is the SSOT; TypeScript in
36
31
  packages/compiler/src/ implements it. Tests in packages/compiler/test/ verify contracts.
37
-
32
+
38
33
  Start reading at org.blockml.bml.compiler.runtime.documentation.Introduction (ReadNext chain).
39
-
34
+
40
35
  V1: compileToOutput with document|library|corpus|auto scope, empty Target Registry
41
36
  (hosts register targets), RenderContext/Session, opaque RenderOutput. CLI owns
42
37
  bootstrap, write, C5/C6.
43
-
38
+
44
39
  Layer separation:
45
40
  • parser / validator / framework — Stage 1–2 and TypeRegistry
46
41
  • org.blockml.bml.compiler.runtime.* (this library) — facade and registry
47
42
  • org.blockml.bml.cli.* — host orchestration
48
43
  • target libraries — render emit
49
-
44
+
50
45
  Modules: documentation, api/config, capability.
51
46
  </documentation>
52
-
53
47
  <references>
54
48
  <see type="rundocumentation:Introduction" relation="ReadFirst" />
55
49
  <see type="rundocumentation:DesignDecisions" relation="SeeAlso" />
56
50
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
57
51
  <see type="runcap:CompileToOutput" relation="SeeAlso" />
58
52
  </references>
59
-
60
- </block>
53
+ </runtime:README>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime — RuntimeType
3
- FQN: org.blockml.bml.compiler.runtime.RuntimeType
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 — RuntimeType
2
+ FQN: org.blockml.bml.compiler.runtime.RuntimeType-->
3
+ <runtime:RuntimeType 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,12 +19,16 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>RuntimeType</name>
29
- <type>runtime:RuntimeType</type>
30
- <baseType>core:Entity</baseType>
31
- <is>Abstract marker for compiler runtime API and config data-structure blocks</is>
32
-
33
- <documentation>All org.blockml.bml.compiler.runtime.api|config.* types extend this marker. Distinct from core:Capability and bom Urmodell types.</documentation>
34
- <abstract>true</abstract>
35
-
36
- </block>
22
+ <baseType>
23
+ core:Entity
24
+ </baseType>
25
+ <is>
26
+ Abstract marker for compiler runtime API and config data-structure blocks
27
+ </is>
28
+ <documentation>
29
+ All org.blockml.bml.compiler.runtime.api|config.* types extend this marker. Distinct from core:Capability and bom Urmodell types.
30
+ </documentation>
31
+ <abstract>
32
+ true
33
+ </abstract>
34
+ </runtime:RuntimeType>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — CompileBomOptions
3
- FQN: org.blockml.bml.compiler.runtime.api.CompileBomOptions
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 — CompileBomOptions
2
+ FQN: org.blockml.bml.compiler.runtime.api.CompileBomOptions-->
3
+ <runapi:CompileBomOptions 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,22 +19,40 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>CompileBomOptions</name>
29
- <type>runapi:CompileBomOptions</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Host options for compileBomToOutput (BOM-first Stage-3)</is>
32
-
33
- <documentation>typeRegistry is required and passed through unchanged — no bootstrap or re-parse.
34
- Domain-specific host fields (e.g. MachineBlocks lib path) belong in targetOptions, not here.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Host options for compileBomToOutput (BOM-first Stage-3)
27
+ </is>
28
+ <documentation>
29
+ typeRegistry is required and passed through unchanged — no bootstrap or re-parse.
30
+ Domain-specific host fields (e.g. MachineBlocks lib path) belong in targetOptions, not here.
31
+ </documentation>
35
32
  <references>
36
33
  <see type="runcap:CompileBomToOutput" relation="SeeAlso" />
37
34
  <see type="rundocumentation:ExternalTargetContract" relation="SeeAlso" />
38
35
  </references>
39
36
  <properties>
40
- <typeRegistry type="type:Text"><documentation>Pre-built TypeRegistry; required. (required)</documentation></typeRegistry>
41
- <outputBasePath type="type:Text"><documentation>Output base path for session. (optional)</documentation></outputBasePath>
42
- <rootDir type="type:Text"><documentation>Project root for diagnostics source paths. (optional)</documentation></rootDir>
43
- <targetOptions type="type:Text"><documentation>Opaque options forwarded on the synthetic CompileRequest. (optional)</documentation></targetOptions>
37
+ <typeRegistry type="type:Text">
38
+ <documentation>
39
+ Pre-built TypeRegistry; required. (required)
40
+ </documentation>
41
+ </typeRegistry>
42
+ <outputBasePath type="type:Text">
43
+ <documentation>
44
+ Output base path for session. (optional)
45
+ </documentation>
46
+ </outputBasePath>
47
+ <rootDir type="type:Text">
48
+ <documentation>
49
+ Project root for diagnostics source paths. (optional)
50
+ </documentation>
51
+ </rootDir>
52
+ <targetOptions type="type:Text">
53
+ <documentation>
54
+ Opaque options forwarded on the synthetic CompileRequest. (optional)
55
+ </documentation>
56
+ </targetOptions>
44
57
  </properties>
45
-
46
- </block>
58
+ </runapi:CompileBomOptions>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — CompileInput
3
- FQN: org.blockml.bml.compiler.runtime.api.CompileInput
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 — CompileInput
2
+ FQN: org.blockml.bml.compiler.runtime.api.CompileInput-->
3
+ <runapi:CompileInput 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>CompileInput</name>
29
- <type>runapi:CompileInput</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Single BML source unit for document scope</is>
32
-
33
- <documentation>Used as CompileScope.document and by CompileBmlToBom / CompileBmlToOutput.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Single BML source unit for document scope
27
+ </is>
28
+ <documentation>
29
+ Used as CompileScope.document and by CompileBmlToBom / CompileBmlToOutput.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <source type="type:Text"><documentation>BML source text. (required)</documentation></source>
39
- <filePath type="type:Text"><documentation>Logical file path for diagnostics. (required)</documentation></filePath>
40
- <format type="type:Text"><documentation>Optional format hint; V1 only xml. (optional)</documentation></format>
35
+ <source type="type:Text">
36
+ <documentation>
37
+ BML source text. (required)
38
+ </documentation>
39
+ </source>
40
+ <filePath type="type:Text">
41
+ <documentation>
42
+ Logical file path for diagnostics. (required)
43
+ </documentation>
44
+ </filePath>
45
+ <format type="type:Text">
46
+ <documentation>
47
+ Optional format hint; V1 only xml. (optional)
48
+ </documentation>
49
+ </format>
41
50
  </properties>
42
-
43
- </block>
51
+ </runapi:CompileInput>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — CompileOptions
3
- FQN: org.blockml.bml.compiler.runtime.api.CompileOptions
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 — CompileOptions
2
+ FQN: org.blockml.bml.compiler.runtime.api.CompileOptions-->
3
+ <runapi:CompileOptions 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,34 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>CompileOptions</name>
29
- <type>runapi:CompileOptions</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Host options for compile helpers and compileToOutput</is>
32
-
33
- <documentation>typeRegistry, paths, and session fields supplied by the host (often CLI).
34
- Domain-specific passthrough fields belong in targetOptions, not here.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Host options for compile helpers and compileToOutput
27
+ </is>
28
+ <documentation>
29
+ typeRegistry, paths, and session fields supplied by the host (often CLI).
30
+ Domain-specific passthrough fields belong in targetOptions, not here.
31
+ </documentation>
35
32
  <references>
36
33
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
37
34
  </references>
38
35
  <properties>
39
- <typeRegistry type="type:Text"><documentation>Optional pre-built TypeRegistry. (optional)</documentation></typeRegistry>
40
- <outputBasePath type="type:Text"><documentation>Output base path for session. (optional)</documentation></outputBasePath>
41
- <rootDir type="type:Text"><documentation>Project root for bootstrap defaults. (optional)</documentation></rootDir>
36
+ <typeRegistry type="type:Text">
37
+ <documentation>
38
+ Optional pre-built TypeRegistry. (optional)
39
+ </documentation>
40
+ </typeRegistry>
41
+ <outputBasePath type="type:Text">
42
+ <documentation>
43
+ Output base path for session. (optional)
44
+ </documentation>
45
+ </outputBasePath>
46
+ <rootDir type="type:Text">
47
+ <documentation>
48
+ Project root for bootstrap defaults. (optional)
49
+ </documentation>
50
+ </rootDir>
42
51
  </properties>
43
-
44
- </block>
52
+ </runapi:CompileOptions>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — CompileRequest
3
- FQN: org.blockml.bml.compiler.runtime.api.CompileRequest
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 — CompileRequest
2
+ FQN: org.blockml.bml.compiler.runtime.api.CompileRequest-->
3
+ <runapi:CompileRequest 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>CompileRequest</name>
29
- <type>runapi:CompileRequest</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Primary Stage-3 request envelope</is>
32
-
33
- <documentation>C2: scope plus opaque targetOptions typed per target package.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Primary Stage-3 request envelope
27
+ </is>
28
+ <documentation>
29
+ C2: scope plus opaque targetOptions typed per target package.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <scope type="runapi:CompileScope"><documentation>Compile scope. (required)</documentation></scope>
39
- <targetOptions type="type:Text"><documentation>Opaque options for the named target. (optional)</documentation></targetOptions>
35
+ <scope type="runapi:CompileScope">
36
+ <documentation>
37
+ Compile scope. (required)
38
+ </documentation>
39
+ </scope>
40
+ <targetOptions type="type:Text">
41
+ <documentation>
42
+ Opaque options for the named target. (optional)
43
+ </documentation>
44
+ </targetOptions>
40
45
  </properties>
41
-
42
- </block>
46
+ </runapi:CompileRequest>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — CompileScope
3
- FQN: org.blockml.bml.compiler.runtime.api.CompileScope
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 — CompileScope
2
+ FQN: org.blockml.bml.compiler.runtime.api.CompileScope-->
3
+ <runapi:CompileScope 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,21 +19,43 @@
25
19
  xmlns:type="org.blockml.bml.type"
26
20
  xmlns:validator="org.blockml.bml.compiler.validator">
27
21
 
28
- <name>CompileScope</name>
29
- <type>runapi:CompileScope</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Compile scope payload on CompileRequest</is>
32
-
33
- <documentation>C7 scope kinds with optional document, libraries, roots, includeDependencies.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Compile scope payload on CompileRequest
27
+ </is>
28
+ <documentation>
29
+ C7 scope kinds with optional document, libraries, roots, includeDependencies.
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>CompileScopeKind value. (required)</documentation></kind>
39
- <document type="runapi:CompileInput"><documentation>Required when kind is document. (optional)</documentation></document>
40
- <libraries type="type:Text"><documentation>Library.bml paths. (optional)</documentation></libraries>
41
- <roots type="type:Text"><documentation>Corpus root directories. (optional)</documentation></roots>
42
- <includeDependencies type="type:Boolean"><documentation>Reserved; host may pass through. (optional)</documentation></includeDependencies>
35
+ <kind type="type:Text">
36
+ <documentation>
37
+ CompileScopeKind value. (required)
38
+ </documentation>
39
+ </kind>
40
+ <document type="runapi:CompileInput">
41
+ <documentation>
42
+ Required when kind is document. (optional)
43
+ </documentation>
44
+ </document>
45
+ <libraries type="type:Text">
46
+ <documentation>
47
+ Library.bml paths. (optional)
48
+ </documentation>
49
+ </libraries>
50
+ <roots type="type:Text">
51
+ <documentation>
52
+ Corpus root directories. (optional)
53
+ </documentation>
54
+ </roots>
55
+ <includeDependencies type="type:Boolean">
56
+ <documentation>
57
+ Reserved; host may pass through. (optional)
58
+ </documentation>
59
+ </includeDependencies>
43
60
  </properties>
44
-
45
- </block>
61
+ </runapi:CompileScope>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — CompileScopeKind
3
- FQN: org.blockml.bml.compiler.runtime.api.CompileScopeKind
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 — CompileScopeKind
2
+ FQN: org.blockml.bml.compiler.runtime.api.CompileScopeKind-->
3
+ <runapi:CompileScopeKind 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>CompileScopeKind</name>
29
- <type>runapi:CompileScopeKind</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Enumerated compile scope kinds</is>
32
-
33
- <documentation>C7: document | library | corpus | auto. auto is input-only; ResolveScope yields a concrete kind.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Enumerated compile scope kinds
27
+ </is>
28
+ <documentation>
29
+ C7: document | library | corpus | auto. auto is input-only; ResolveScope yields a concrete kind.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <document type="type:Text"><documentation>Single .bml document scope.</documentation></document>
39
- <library type="type:Text"><documentation>Library.bml roots plus dependency closure.</documentation></library>
40
- <corpus type="type:Text"><documentation>Directory roots / blocks trees.</documentation></corpus>
41
- <auto type="type:Text"><documentation>Resolve from libraries then roots; never left as auto after ResolveScope.</documentation></auto>
35
+ <document type="type:Text">
36
+ <documentation>
37
+ Single .bml document scope.
38
+ </documentation>
39
+ </document>
40
+ <library type="type:Text">
41
+ <documentation>
42
+ Library.bml roots plus dependency closure.
43
+ </documentation>
44
+ </library>
45
+ <corpus type="type:Text">
46
+ <documentation>
47
+ Directory roots / blocks trees.
48
+ </documentation>
49
+ </corpus>
50
+ <auto type="type:Text">
51
+ <documentation>
52
+ Resolve from libraries then roots; never left as auto after ResolveScope.
53
+ </documentation>
54
+ </auto>
42
55
  </properties>
43
-
44
- </block>
56
+ </runapi:CompileScopeKind>
@@ -1,12 +1,6 @@
1
- <!--
2
- Compiler Runtime API — CompilerResult
3
- FQN: org.blockml.bml.compiler.runtime.api.CompilerResult
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 — CompilerResult
2
+ FQN: org.blockml.bml.compiler.runtime.api.CompilerResult-->
3
+ <runapi:CompilerResult 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>CompilerResult</name>
29
- <type>runapi:CompilerResult</type>
30
- <baseType>runtime:RuntimeType</baseType>
31
- <is>Success flag, diagnostics, and optional output</is>
32
-
33
- <documentation>Generic envelope CompilerResult of T. success is false if any error diagnostic, including target output.diagnostics folded by renderWithTarget.</documentation>
22
+ <baseType>
23
+ runtime:RuntimeType
24
+ </baseType>
25
+ <is>
26
+ Success flag, diagnostics, and optional output
27
+ </is>
28
+ <documentation>
29
+ Generic envelope CompilerResult of T. success is false if any error diagnostic, including target output.diagnostics folded by renderWithTarget.
30
+ </documentation>
34
31
  <references>
35
32
  <see type="rundocumentation:PublicApi" relation="SeeAlso" />
36
33
  </references>
37
34
  <properties>
38
- <output type="type:Text"><documentation>Typed output or null. (optional)</documentation></output>
39
- <diagnostics type="type:Text"><documentation>Diagnostic list. (required)</documentation></diagnostics>
40
- <success type="type:Boolean"><documentation>True when no error diagnostics. (required)</documentation></success>
35
+ <output type="type:Text">
36
+ <documentation>
37
+ Typed output or null. (optional)
38
+ </documentation>
39
+ </output>
40
+ <diagnostics type="type:Text">
41
+ <documentation>
42
+ Diagnostic list. (required)
43
+ </documentation>
44
+ </diagnostics>
45
+ <success type="type:Boolean">
46
+ <documentation>
47
+ True when no error diagnostics. (required)
48
+ </documentation>
49
+ </success>
41
50
  </properties>
42
-
43
- </block>
51
+ </runapi:CompilerResult>