rename XFactory.Regs to XFactory.Generators.

This commit is contained in:
2026-05-23 21:23:06 +08:00
parent 8b285cc863
commit 058003f395
155 changed files with 16416 additions and 1261 deletions
@@ -102,7 +102,7 @@ Class SyntaxPiece
<div class="markdown conceptual"></div>
<div class="codewrapper">
<pre><code class="lang-csharp hljs">public class SyntaxPiece : IGetSentence</code></pre>
<pre><code class="lang-csharp hljs">public class SyntaxPiece : ISentenceCarrier, IGetSentence, ISentenceIndexed</code></pre>
</div>
@@ -119,7 +119,9 @@ Class SyntaxPiece
<dl class="typelist implements">
<dt>Implements</dt>
<dd>
<div><a class="xref" href="Hi.NcParsers.ISentenceCarrier.html">ISentenceCarrier</a></div>
<div><a class="xref" href="Hi.NcParsers.IGetSentence.html">IGetSentence</a></div>
<div><a class="xref" href="Hi.NcParsers.ISentenceIndexed.html">ISentenceIndexed</a></div>
</dd>
</dl>
@@ -198,17 +200,17 @@ to store typed values at parse time.
<a id="Hi_NcParsers_Syntaxs_SyntaxPiece__ctor_" data-uid="Hi.NcParsers.Syntaxs.SyntaxPiece.#ctor*"></a>
<h3 id="Hi_NcParsers_Syntaxs_SyntaxPiece__ctor_Hi_NcParsers_Sentence_System_Text_Json_Nodes_JsonObject_" data-uid="Hi.NcParsers.Syntaxs.SyntaxPiece.#ctor(Hi.NcParsers.Sentence,System.Text.Json.Nodes.JsonObject)">
SyntaxPiece(Sentence, JsonObject)
<h3 id="Hi_NcParsers_Syntaxs_SyntaxPiece__ctor_Hi_NcParsers_Sentence_System_Text_Json_Nodes_JsonObject_System_Int32_" data-uid="Hi.NcParsers.Syntaxs.SyntaxPiece.#ctor(Hi.NcParsers.Sentence,System.Text.Json.Nodes.JsonObject,System.Int32)">
SyntaxPiece(Sentence, JsonObject, int)
</h3>
<div class="markdown level1 summary"><p>Creates a piece binding <code class="paramref">sentence</code> to <code class="paramref">jsonObject</code>.</p>
<div class="markdown level1 summary"><p>Creates a piece binding <code class="paramref">sentence</code> to <code class="paramref">jsonObject</code> with its execution-order <code class="paramref">sentenceIndex</code>.</p>
</div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
<pre><code class="lang-csharp hljs">public SyntaxPiece(Sentence sentence, JsonObject jsonObject)</code></pre>
<pre><code class="lang-csharp hljs">public SyntaxPiece(Sentence sentence, JsonObject jsonObject, int sentenceIndex)</code></pre>
</div>
<h4 class="section">Parameters</h4>
@@ -217,6 +219,8 @@ to store typed values at parse time.
<dd></dd>
<dt><code>jsonObject</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.text.json.nodes.jsonobject">JsonObject</a></dt>
<dd></dd>
<dt><code>sentenceIndex</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
<dd></dd>
</dl>
@@ -306,18 +310,23 @@ to store typed values at parse time.
</h3>
<div class="markdown level1 summary"><p>0-based ordinal in NC execution order. Stamped at piece construction
time by <a class="xref" href="Hi.NcParsers.Segmenters.ISegmenter.html">GetSyntaxPieces(ISegmenter, LazyLinkedList&lt;IndexedFileLine&gt;, int, NcDiagnosticProgress, CancellationToken)</a> from the destination
time by <a class="xref" href="Hi.NcParsers.Segmenters.ISegmenter.html">GetSyntaxPieces(ISegmenter, IEnumerable&lt;IndexedFileLine&gt;, int, NcDiagnosticProgress, CancellationToken)</a> from the destination
<code>layers[0]</code>'s running count, so subprogram pieces inlined by
<code>SubProgramCallSyntax</code> get sequential indices that interleave
correctly between host blocks. Useful as a cross-process alignment
key (messages, ClStripPos, MachiningStep) — unlike
<code>FileLineUtil.MixedIndex()</code>, it reflects execution order rather
than (FileIndex, LineIndex) source order.</p>
<p>
Required at construction: the index is identity, not optional metadata.
Read-only after construction; the pipeline guarantees one stamping per
piece at the wrapping chokepoint.
</p>
</div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
<pre><code class="lang-csharp hljs">public int SentenceIndex { get; set; }</code></pre>
<pre><code class="lang-csharp hljs">public int SentenceIndex { get; }</code></pre>
</div>