@blockml/compiler 0.9.4 → 0.9.5

package/blocks/org/blockml/bml/compiler/runtime/documentation/PackageOwnership.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — PackageOwnership
-  FQN: org.blockml.bml.compiler.runtime.documentation.PackageOwnership
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — PackageOwnership
+  FQN: org.blockml.bml.compiler.runtime.documentation.PackageOwnership-->
+<rundocumentation:PackageOwnership xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,21 +20,23 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PackageOwnership</name>
-  <type>rundocumentation:PackageOwnership</type>
-  <baseType>core:Documentation</baseType>
-  <is>What belongs in @blockml/compiler vs neighbors</is>
-
-  <documentation>Owns: compileToOutput and sugar, Target Registry API, ResolveScope/ScopeAccepts,
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What belongs in @blockml/compiler vs neighbors
+  </is>
+  <documentation>
+    Owns: compileToOutput and sugar, Target Registry API, ResolveScope/ScopeAccepts,
     RenderContext/Session, CompileRequest/Options, CompilerResult, C1–C7 contracts,
     orchestration of parse/validate/bootstrap for Stage-3.
-
+    
     Does not own: CLI commands, file write, exit codes, C5/C6 (cli);
     parser/serializer/validator algorithms; framework TypeRegistry internals;
-    target Options and emit; MachineBlocks SCAD NativeBlock.</documentation>
+    target Options and emit; MachineBlocks SCAD NativeBlock.
+  </documentation>
   <references>
     <see type="rundocumentation:ScopeExclusions" relation="ReadNext" />
     <see type="cli:Library" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:PackageOwnership>

package/blocks/org/blockml/bml/compiler/runtime/documentation/PublicApi.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — PublicApi
-  FQN: org.blockml.bml.compiler.runtime.documentation.PublicApi
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — PublicApi
+  FQN: org.blockml.bml.compiler.runtime.documentation.PublicApi-->
+<rundocumentation:PublicApi xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,12 +20,14 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>PublicApi</name>
-  <type>rundocumentation:PublicApi</type>
-  <baseType>core:Documentation</baseType>
-  <is>Public TypeScript surface mirrored in this library</is>
-
-  <documentation>Exports (packages/compiler/src/index.ts):
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Public TypeScript surface mirrored in this library
+  </is>
+  <documentation>
+    Exports (packages/compiler/src/index.ts):
     Types: CompileScopeKind, CompileInput, CompileScope, CompileRequest, CompileOptions,
     CompileBomOptions, CompilerResult, ValidateRegistryResult, RenderOutput, RenderOutputFile, RenderSession,
     RenderContext, RenderTarget, ScopeConfigHints, ResolvedScope.
@@ -40,13 +36,13 @@
     Stage 1–2 helpers: compileBmlToBom, validateRegistryDocuments.
     Facade: compileToOutput, compileBomToOutput, compileBmlToOutput.
     Context: createRenderContext, buildRenderSession.
-
-    Modeled as api/*, config/RuntimeConstants, and capability/* on Library.blocks.</documentation>
+    
+    Modeled as api/*, config/RuntimeConstants, and capability/* on Library.blocks.
+  </documentation>
   <references>
     <see type="rundocumentation:CompileIO" relation="ReadNext" />
     <see type="runapi:CompileRequest" relation="SeeAlso" />
     <see type="runcap:CompileToOutput" relation="SeeAlso" />
     <see type="runapi:RenderTarget" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:PublicApi>

package/blocks/org/blockml/bml/compiler/runtime/documentation/RenderContextRules.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — RenderContextRules
-  FQN: org.blockml.bml.compiler.runtime.documentation.RenderContextRules
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — RenderContextRules
+  FQN: org.blockml.bml.compiler.runtime.documentation.RenderContextRules-->
+<rundocumentation:RenderContextRules xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,23 +20,24 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>RenderContextRules</name>
-  <type>rundocumentation:RenderContextRules</type>
-  <baseType>core:Documentation</baseType>
-  <is>RenderSession and RenderContext (C1)</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    RenderSession and RenderContext (C1)
+  </is>
   <documentation>
     # RenderSession and RenderContext (C1)
-
+    
     RenderSession is immutable per compile after BuildRenderSession.
-
+    
     Stable session fields for registry targets: typeRegistry, sourceFilePath, outputBasePath,
     targetName, scopeKind, libraryPaths?, corpusRoots?.
-
+    
     RenderContext holds session + blockFqn + outputRelativePath; child(overrides) forks a new
     context sharing the same session. Per-node fields are for composition/domain renderers;
     registry targets may ignore them and rely on request.scope plus session.
-
+    
     CreateRenderContext defaults empty FQN and relative path for the root call into target.render.
   </documentation>
   <references>
@@ -50,5 +45,4 @@
     <see type="runcap:BuildRenderSession" relation="SeeAlso" />
     <see type="runcap:CreateRenderContext" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:RenderContextRules>

package/blocks/org/blockml/bml/compiler/runtime/documentation/ScopeExclusions.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — ScopeExclusions
-  FQN: org.blockml.bml.compiler.runtime.documentation.ScopeExclusions
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — ScopeExclusions
+  FQN: org.blockml.bml.compiler.runtime.documentation.ScopeExclusions-->
+<rundocumentation:ScopeExclusions xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,18 +20,20 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>ScopeExclusions</name>
-  <type>rundocumentation:ScopeExclusions</type>
-  <baseType>core:Documentation</baseType>
-  <is>Explicitly out of compiler runtime V1 library scope</is>
-
-  <documentation>Out of scope for this library / V1:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Explicitly out of compiler runtime V1 library scope
+  </is>
+  <documentation>
+    Out of scope for this library / V1:
     • CLI targets[] bootstrap order and dual CLI model
     • Writing RenderOutput files to disk
     • Incremental .bom-cache (C5) and thumbnails (C6)
     • Target-specific targetOptions schemas and emit
     • Parser/serializer/validator mapping and constraint algorithms
     • SCAD NativeBlock / engine-maker processors
-    • Codegen from BML to TypeScript (structural SSOT only)</documentation>
-
-</block>
+    • Codegen from BML to TypeScript (structural SSOT only)
+  </documentation>
+</rundocumentation:ScopeExclusions>

package/blocks/org/blockml/bml/compiler/runtime/documentation/TargetRegistry.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — TargetRegistry
-  FQN: org.blockml.bml.compiler.runtime.documentation.TargetRegistry
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — TargetRegistry
+  FQN: org.blockml.bml.compiler.runtime.documentation.TargetRegistry-->
+<rundocumentation:TargetRegistry xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,24 +20,25 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>TargetRegistry</name>
-  <type>rundocumentation:TargetRegistry</type>
-  <baseType>core:Documentation</baseType>
-  <is>Target Registry contract (C3)</is>
-
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    Target Registry contract (C3)
+  </is>
   <documentation>
     # Target Registry contract (C3)
-
+    
     In-memory Map of name → RenderTarget. registerTarget overwrites; getTarget may miss;
     clearTargets empties; registeredTargetNames lists keys.
-
+    
     No default targets ship in @blockml/compiler. Hosts (CLI bootstrapTargets, tests, browsers)
     call registerTarget before compileToOutput.
-
+    
     registerTarget validates: non-empty name; non-empty accepts with only valid CompileScopeKind
     values; render is a function; validateRequest if present is a function. Invalid hosts throw
     (programming error — not a BML authoring diagnostic).
-
+    
     Config targets[] and package loading order are CLI-owned (SeeAlso RuntimeBootstrap).
   </documentation>
   <references>
@@ -51,5 +46,4 @@
     <see type="runcap:RegisterTarget" relation="SeeAlso" />
     <see type="cli:Library" relation="SeeAlso" />
   </references>
-
-</block>
+</rundocumentation:TargetRegistry>

package/blocks/org/blockml/bml/compiler/runtime/documentation/V1Scope.bml

@@ -1,12 +1,6 @@
-<!--
-  Compiler Runtime Documentation — V1Scope
-  FQN: org.blockml.bml.compiler.runtime.documentation.V1Scope
--->
-<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
-                      "
+<!--Compiler Runtime Documentation — V1Scope
+  FQN: org.blockml.bml.compiler.runtime.documentation.V1Scope-->
+<rundocumentation:V1Scope xmlns="http://blockml.org/bml"
   xmlns:blockml="org.blockml.bml"
   xmlns:bom="org.blockml.bml.bom"
   xmlns:bomapi="org.blockml.bml.bom.api"
@@ -26,12 +20,14 @@
   xmlns:validator="org.blockml.bml.compiler.validator"
   xmlns:doc="org.blockml.bml.documentation">
 
-  <name>V1Scope</name>
-  <type>rundocumentation:V1Scope</type>
-  <baseType>core:Documentation</baseType>
-  <is>What V1 delivers</is>
-
-  <documentation>V1 includes:
+  <baseType>
+    core:Documentation
+  </baseType>
+  <is>
+    What V1 delivers
+  </is>
+  <documentation>
+    V1 includes:
     • compileToOutput / compileBmlToOutput; compileBomToOutput BOM-first with required TypeRegistry
     • In-memory Target Registry with no built-in targets; registerTarget validates contract
     • Scope kinds document | library | corpus | auto with ScopeConfigHints merge
@@ -40,11 +36,11 @@
     • Diagnostics BML_UNKNOWN_TARGET, BML_TARGET_SCOPE_MISMATCH, BML_COMPILE_SCOPE_EMPTY,
       BML_MISSING_TYPE_REGISTRY
     • Browser-safe package surface (no Node-only APIs in public contracts)
-
+    
     V1 does NOT include CLI targets[] bootstrap, file I/O, incremental cache (C5),
-    thumbnails (C6), or target-specific emit.</documentation>
+    thumbnails (C6), or target-specific emit.
+  </documentation>
   <references>
     <see type="rundocumentation:PublicApi" relation="ReadNext" />
   </references>
-
-</block>
+</rundocumentation:V1Scope>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockml/compiler",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "BlockML compiler — facade, target registry, render pipeline",
   "license": "Apache-2.0",
   "repository": {
@@ -32,11 +32,11 @@
     "test": "vitest run packages/compiler/test"
   },
   "dependencies": {
-    "@blockml/bom": "^0.9.4",
-    "@blockml/core": "^1.1.2",
-    "@blockml/framework": "^0.9.4",
-    "@blockml/parser": "^0.9.4",
-    "@blockml/validator": "^0.9.4"
+    "@blockml/bom": "^0.9.5",
+    "@blockml/core": "^1.2.1",
+    "@blockml/framework": "^0.9.5",
+    "@blockml/parser": "^0.9.5",
+    "@blockml/validator": "^0.9.5"
   },
   "engines": {
     "node": ">=20"