fix SoftNcRunner GM code normalization.

This commit is contained in:
2026-05-06 13:21:19 +08:00
parent 0fe9497552
commit 2f57932000
1238 changed files with 69405 additions and 22511 deletions
@@ -278,6 +278,32 @@ Class JsAceAttribute
<h2 id="Hi_ScriptApiUtils_JsAceAttribute_remarks">Remarks</h2>
<div class="markdown level0 remarks"><p>
<b>Do not add new usages.</b> Retained only so the legacy HiNcRcl (Blazor)
Ace editor completion pipeline keeps working until that app is retired:
<code>RuntimeApi.JsAceCompletionProfileJsonArray</code> scans <code>[JsAce]</code>
members by reflection and <code>CommonRcl.AceEditor</code> feeds the resulting
JSON into Ace's completer list.
</p>
<p>
New code should rely on Roslyn <code>CompletionService</code> served over
<code>POST /api/script/completions</code> and consumed by CodeMirror 6 on the
HiNC-2025-webservice Quasar frontend. XML <code>&lt;summary&gt;</code> comments
become the single source of truth for tooltip content, so no duplicated
attribute metadata is needed.
</p>
<p>
Deprecation lifecycle:
<ol><li><b>Now</b> — discouraged for new code (this remark);
existing call sites in HiNcRcl / <code>RuntimeApi</code> /
<code>MachiningStep</code> keep building without warnings.</li><li><b>When HiNcRcl retires</b> — this attribute will be
marked <code>[Obsolete]</code>, surfacing a compiler warning on every
remaining call site so they can be cleaned up.</li><li><b>After all call sites are gone</b> — this file
(and <code>RuntimeApi.JsAceCompletionProfileJsonArray</code>) will be
deleted entirely.</li></ol>
</div>
<h2 class="section" id="constructors">Constructors