diff --git a/App/EngineMessages/engine-messages.json b/App/EngineMessages/engine-messages.json index b94548f7..5e7eb33c 100644 --- a/App/EngineMessages/engine-messages.json +++ b/App/EngineMessages/engine-messages.json @@ -1,8 +1,8 @@ { "schemaVersion": 1, - "engineVersion": "3.2.26.0", - "filesParsed": 1275, - "siteCount": 356, + "engineVersion": "3.2.27.0", + "filesParsed": 1276, + "siteCount": 365, "sites": [ { "id": "AddTimeDataByFile--Start", @@ -324,11 +324,26 @@ "template": "Meshed geometry file not found: {0}", "file": "HiMech/NcMech/Workpieces/WorkpieceService.cs" }, + { + "id": "Cutter-Shank--ThermalLayersUnbuildable", + "template": "an upper beam is configured but the shank thermal model cannot be built (shank mass {0} g and beam volume must both be positive); temperature evaluation will run without the shank.", + "file": "HiMech/Milling/Cutters/MillingCutter.cs" + }, { "id": "Cutter-Shank--ThermalModelUnavailable", "template": "MillingCutter on {0}: no usable shank thermal model (no upper beam, no inner-beam profile, or non-positive shank mass/volume) — temperature evaluation runs without the shank heat sink, so cutter temperatures will read higher than physical.", "file": "HiMech/MachiningProcs/MachiningActRunner.cs" }, + { + "id": "Cutter-UpperBeam--BelowFluteHeight", + "template": "upper beam ends at Z = {0} mm, at or below the flute top (flute height {1} mm), so the shank solid is inverted and thermal physics cannot build its shell layers; extend the beam above the flute.", + "file": "HiMech/Milling/Cutters/MillingCutter.cs" + }, + { + "id": "Cutter-UpperBeam--ExtendedCylinderFullLengthTooShort", + "template": "ExtendedCylinder.FullLength = {0} mm does not reach above the beam's start section at Z = {1} mm (the flute top), so the shank solid is inverted and thermal physics cannot build its shell layers. FullLength is measured from the cutter tip and includes the flute span — it is not the remainder above the flute; set it larger than the flute height.", + "file": "HiMech/Milling/Cutters/MillingCutter.cs" + }, { "id": "Cycle-Bore--MissingParam", "template": "[{0}] Missing required parameter: X={1}, Y={2}, Z={3}, R={4}.", @@ -799,6 +814,16 @@ "template": "{0}: CYCL DEF {1} is recognized but not simulated; the call is consumed with no motion effect.", "file": "HiMech/NcParsers/LogicSyntaxs/Heidenhain/HeidenhainCannedCycleSyntax.cs" }, + { + "id": "HeidenhainFn--Unsupported", + "template": "FN{0} is not simulated; the statement is skipped ({1}).", + "file": "HiMech/NcParsers/ParsingSyntaxs/Heidenhain/HeidenhainFnFeatureSyntax.cs" + }, + { + "id": "HeidenhainFn--UnsupportedSysread", + "template": "FN18 SYSREAD is not simulated offline ({0}); the target Q parameter stays vacant so dependent expressions fail soft.", + "file": "HiMech/NcParsers/ParsingSyntaxs/Heidenhain/HeidenhainFnFeatureSyntax.cs" + }, { "id": "HeidenhainGoto--ConditionNotEvaluated", "template": "{0}: a comparison operand did not reduce to a finite numeric (vacant Q parameter — e.g. an FN 18 SYSREAD target — or unparsed expression); falling through to next block.", @@ -949,6 +974,26 @@ "template": "MCALL {0}: modal calls are simulated for CYCLE81/82/83/85 only; the call is consumed without arming (motion state unchanged).", "file": "HiMech/NcParsers/LogicSyntaxs/Siemens/SiemensModalCycleSyntax.cs" }, + { + "id": "NcOpt-Feed--Progress", + "template": "Computing Optimized Feed by indivisual step.. FileNo:{0}, LineNo:{1}", + "file": "HiMech/NcOpt/StepFeedSolver.cs" + }, + { + "id": "NcOpt-Feed--Progress", + "template": "Computing Optimized Feed by indivisual step.. FileNo:{0}, LineNo:{1}", + "file": "HiNc/NcOpt/NcOptProc.cs" + }, + { + "id": "NcOpt-Feed--ProgressByStepIndex", + "template": "Computing Optimized Feed by indivisual step.. StepIndex:{0}", + "file": "HiMech/NcOpt/StepFeedSolver.cs" + }, + { + "id": "NcOpt-Feed--ProgressByStepIndex", + "template": "Computing Optimized Feed by indivisual step.. StepIndex:{0}", + "file": "HiNc/NcOpt/NcOptProc.cs" + }, { "id": "NcOpt-Feed--StepFailed", "template": "NC optimization step {0} ({1}) failed; its simulated feedrate is kept. {2}: {3}", diff --git a/App/Hi.WpfPlus.dll b/App/Hi.WpfPlus.dll index 2cff6838..9722ece3 100644 Binary files a/App/Hi.WpfPlus.dll and b/App/Hi.WpfPlus.dll differ diff --git a/App/HiCbtr.dll b/App/HiCbtr.dll index 9da0a665..722fac2c 100644 Binary files a/App/HiCbtr.dll and b/App/HiCbtr.dll differ diff --git a/App/HiDisp.dll b/App/HiDisp.dll index a02f5757..6145343d 100644 Binary files a/App/HiDisp.dll and b/App/HiDisp.dll differ diff --git a/App/HiGeom.dll b/App/HiGeom.dll index 39d3ee85..45e288c7 100644 Binary files a/App/HiGeom.dll and b/App/HiGeom.dll differ diff --git a/App/HiLicense.dll b/App/HiLicense.dll index d89ae5b0..e4a01594 100644 Binary files a/App/HiLicense.dll and b/App/HiLicense.dll differ diff --git a/App/HiMech.dll b/App/HiMech.dll index aa41f427..f48e418b 100644 Binary files a/App/HiMech.dll and b/App/HiMech.dll differ diff --git a/App/HiNC-2025-win-desktop.deps.json b/App/HiNC-2025-win-desktop.deps.json index 33e9be3b..93fa7ce3 100644 --- a/App/HiNC-2025-win-desktop.deps.json +++ b/App/HiNC-2025-win-desktop.deps.json @@ -11,9 +11,9 @@ "dependencies": { "AvalonEdit": "6.3.0.90", "FontAwesome.Sharp": "6.3.0", - "Hi.WpfPlus": "3.2.22", - "HiNc": "3.2.23", - "HiNc-Resource": "3.2.20", + "Hi.WpfPlus": "3.2.23", + "HiNc": "3.2.24", + "HiNc-Resource": "3.2.21", "Serilog.Extensions.Hosting": "10.0.0", "Serilog.Sinks.Console": "6.1.1", "Serilog.Sinks.File": "7.0.0", @@ -1598,36 +1598,36 @@ } } }, - "Hi.WpfPlus/3.2.22": { + "Hi.WpfPlus/3.2.23": { "dependencies": { - "HiDisp": "3.2.29" + "HiDisp": "3.2.30" }, "runtime": { "lib/net10.0-windows7.0/Hi.WpfPlus.dll": { - "assemblyVersion": "3.2.22.0", - "fileVersion": "3.2.22.0" + "assemblyVersion": "3.2.23.0", + "fileVersion": "3.2.23.0" } } }, - "HiCbtr/3.2.25": { + "HiCbtr/3.2.26": { "dependencies": { - "HiDisp": "3.2.29" + "HiDisp": "3.2.30" }, "runtime": { "lib/net10.0/HiCbtr.dll": { - "assemblyVersion": "3.2.25.0", - "fileVersion": "3.2.25.0" + "assemblyVersion": "3.2.26.0", + "fileVersion": "3.2.26.0" } } }, - "HiDisp/3.2.29": { + "HiDisp/3.2.30": { "dependencies": { - "HiGeom": "3.2.21" + "HiGeom": "3.2.23" }, "runtime": { "lib/net10.0/HiDisp.dll": { - "assemblyVersion": "3.2.29.0", - "fileVersion": "3.2.29.0" + "assemblyVersion": "3.2.30.0", + "fileVersion": "3.2.30.0" } }, "native": { @@ -1645,15 +1645,15 @@ } } }, - "HiGeom/3.2.21": { + "HiGeom/3.2.23": { "dependencies": { "MathNet.Numerics": "5.0.0", "Microsoft.CodeAnalysis.Scripting.Common": "5.9.0" }, "runtime": { "lib/net10.0/HiGeom.dll": { - "assemblyVersion": "3.2.21.0", - "fileVersion": "3.2.21.0" + "assemblyVersion": "3.2.23.0", + "fileVersion": "3.2.23.0" } }, "resources": { @@ -1665,27 +1665,27 @@ } } }, - "HiLicense/3.2.22": { + "HiLicense/3.2.23": { "dependencies": { - "HiGeom": "3.2.21" + "HiGeom": "3.2.23" }, "runtime": { "lib/net10.0/HiLicense.dll": { - "assemblyVersion": "3.2.22.0", - "fileVersion": "3.2.22.0" + "assemblyVersion": "3.2.23.0", + "fileVersion": "3.2.23.0" } } }, - "HiMech/3.2.26": { + "HiMech/3.2.27": { "dependencies": { "CommandLineParser": "2.9.1", - "HiCbtr": "3.2.25", + "HiCbtr": "3.2.26", "Microsoft.CodeAnalysis.CSharp.Scripting": "5.9.0" }, "runtime": { "lib/net10.0/HiMech.dll": { - "assemblyVersion": "3.2.26.0", - "fileVersion": "3.2.26.0" + "assemblyVersion": "3.2.27.0", + "fileVersion": "3.2.27.0" } }, "resources": { @@ -1694,19 +1694,19 @@ } } }, - "HiNc/3.2.23": { + "HiNc/3.2.24": { "dependencies": { "Dapper": "2.1.79", - "HiLicense": "3.2.22", - "HiMech": "3.2.26", - "HiUniNc": "3.2.24", + "HiLicense": "3.2.23", + "HiMech": "3.2.27", + "HiUniNc": "3.2.25", "Microsoft.Data.Sqlite": "10.0.9", "SQLitePCLRaw.bundle_e_sqlite3": "3.0.3" }, "runtime": { "lib/net10.0/HiNc.dll": { - "assemblyVersion": "3.2.23.0", - "fileVersion": "3.2.23.0" + "assemblyVersion": "3.2.24.0", + "fileVersion": "3.2.24.0" } }, "resources": { @@ -1718,22 +1718,22 @@ } } }, - "HiNc-Resource/3.2.20": { + "HiNc-Resource/3.2.21": { "runtime": { "lib/net10.0/HiNc-Resource.dll": { - "assemblyVersion": "3.2.20.0", - "fileVersion": "3.2.20.0" + "assemblyVersion": "3.2.21.0", + "fileVersion": "3.2.21.0" } } }, - "HiUniNc/3.2.24": { + "HiUniNc/3.2.25": { "dependencies": { - "HiMech": "3.2.26" + "HiMech": "3.2.27" }, "runtime": { "lib/net10.0/HiUniNc.dll": { - "assemblyVersion": "3.2.24.0", - "fileVersion": "3.2.24.0" + "assemblyVersion": "3.2.25.0", + "fileVersion": "3.2.25.0" } } }, @@ -2117,68 +2117,68 @@ "path": "fontawesome.sharp/6.3.0", "hashPath": "fontawesome.sharp.6.3.0.nupkg.sha512" }, - "Hi.WpfPlus/3.2.22": { + "Hi.WpfPlus/3.2.23": { "type": "package", "serviceable": true, - "sha512": "sha512-Ccbuy5UYWhRje54RoSaufdGQHx8j0HwtuDri6kDbj9r8cTq/PMkH+nMnC5H84QkXn7cWAAztoxGTl+L3igjCTg==", - "path": "hi.wpfplus/3.2.22", - "hashPath": "hi.wpfplus.3.2.22.nupkg.sha512" + "sha512": "sha512-KfbvR4lk3hML/AqbSefK9r+54WmJJnsvhjr6agmsrJlV5zNVW5UxEMonMD6ndjX4NnKFPtrusdS5yJmRZSa0eQ==", + "path": "hi.wpfplus/3.2.23", + "hashPath": "hi.wpfplus.3.2.23.nupkg.sha512" }, - "HiCbtr/3.2.25": { + "HiCbtr/3.2.26": { "type": "package", "serviceable": true, - "sha512": "sha512-vpVBenFALewpm86CSmnj6VmK5Z+GW3UXHeWxC/5/ClqGIaozy646vCiTpewRsYpGO2qr5Zkgz01doxU2tQ52bA==", - "path": "hicbtr/3.2.25", - "hashPath": "hicbtr.3.2.25.nupkg.sha512" + "sha512": "sha512-9dLKdrw91K620JeyhKmnsOWiWdPm5WAMuLZu3ezf5JDyEaUUh2sH0eiHu7ia2O856Uo5N/+4gOE+1M4wnFGP/A==", + "path": "hicbtr/3.2.26", + "hashPath": "hicbtr.3.2.26.nupkg.sha512" }, - "HiDisp/3.2.29": { + "HiDisp/3.2.30": { "type": "package", "serviceable": true, - "sha512": "sha512-xkpdAIcLQd5XkXhJxDpsYhRzWbj/LGNHB7hBGNiGl9SQd8inbBYr4KsoZfIoCgUvIM0tcnMxXy2x8gHLEQNnGQ==", - "path": "hidisp/3.2.29", - "hashPath": "hidisp.3.2.29.nupkg.sha512" + "sha512": "sha512-4lgDHCrYRpmDg64ltfk7wOfGkYGTkoq0/UHXinZyEwqVGkUBSnUs9LMh0qnQMzv4qZpEoYYrPQrBgasiqSiPSg==", + "path": "hidisp/3.2.30", + "hashPath": "hidisp.3.2.30.nupkg.sha512" }, - "HiGeom/3.2.21": { + "HiGeom/3.2.23": { "type": "package", "serviceable": true, - "sha512": "sha512-ufv3sFzP0/fF9nCkqtGbtjh+CgqMO4k1807nyI6mwp5hNnoyhb70FcWoXLHrrHPK7kkxFsev7pCL1VGEERDnTg==", - "path": "higeom/3.2.21", - "hashPath": "higeom.3.2.21.nupkg.sha512" + "sha512": "sha512-8NbqCnYokemejxzu+/meFJ1y0J7lOloshIzX0lDvHeHhmG1p3CxnXFEMf960+zSB3HVit7KG/X/MnCJ1br0K9A==", + "path": "higeom/3.2.23", + "hashPath": "higeom.3.2.23.nupkg.sha512" }, - "HiLicense/3.2.22": { + "HiLicense/3.2.23": { "type": "package", "serviceable": true, - "sha512": "sha512-lyIt6BOh2I6yrRm9I+/qxP7KUOShOgItybDcmMjAkqWB5/ChEgCvwxgurehDAf1AgpdlJshbOeR3SUgQXr57hw==", - "path": "hilicense/3.2.22", - "hashPath": "hilicense.3.2.22.nupkg.sha512" + "sha512": "sha512-uRXpo0b1vLnbGLPRJ/XSOoI7JXljfVAZmrqAvGOvhg4QsZxqj80lbwWhScnbLY9fhjF+LMRXBokUaThyKs+1zA==", + "path": "hilicense/3.2.23", + "hashPath": "hilicense.3.2.23.nupkg.sha512" }, - "HiMech/3.2.26": { + "HiMech/3.2.27": { "type": "package", "serviceable": true, - "sha512": "sha512-79VRbnja56CPobbk30f6gmTJuGoUvtvEv6qEo5DqCKBKoTYJwvSwYRtV31nydWCMnIlD3XZnLTmMHSav2gVPkA==", - "path": "himech/3.2.26", - "hashPath": "himech.3.2.26.nupkg.sha512" + "sha512": "sha512-t/Uzmb4uNrnXw2SYi66Op7uTzqoKUjPWMSwOl2xotE7PcKHV4dWJI7vTEasSyhQszC867wOmawdYKCy3bdLP1g==", + "path": "himech/3.2.27", + "hashPath": "himech.3.2.27.nupkg.sha512" }, - "HiNc/3.2.23": { + "HiNc/3.2.24": { "type": "package", "serviceable": true, - "sha512": "sha512-AI9bcj0jYY+qrVs1dawA/0ivnaL1PG/0y/liaBPPG+mqJYOBUai9P4tQt58j+yhzIJz4BgKIyZI2l8pPwDOebA==", - "path": "hinc/3.2.23", - "hashPath": "hinc.3.2.23.nupkg.sha512" + "sha512": "sha512-jviTXkgP61dfAN3jGJMb20RpkKdurz0xRjRJnXYElc+tQBwKnKtxIIRueHxkdnJeAXya4SG27UEyGPwd/s25IQ==", + "path": "hinc/3.2.24", + "hashPath": "hinc.3.2.24.nupkg.sha512" }, - "HiNc-Resource/3.2.20": { + "HiNc-Resource/3.2.21": { "type": "package", "serviceable": true, - "sha512": "sha512-sGoPktBf8Il9ivB6iIYnph1VuDug9nBQCr6SHT1BOyxVlcBmmZmhfYl7wvE+J83RpUP6nb872RSEDDmu2wP8zQ==", - "path": "hinc-resource/3.2.20", - "hashPath": "hinc-resource.3.2.20.nupkg.sha512" + "sha512": "sha512-LSF8i+B6vYvUlNk+Tfk/s9UAKjPM5n/f9NYtE1GpsjoTzl+bDF0ugclG0jBBhyOvtse45U8YaFZQwQAgUmHzWA==", + "path": "hinc-resource/3.2.21", + "hashPath": "hinc-resource.3.2.21.nupkg.sha512" }, - "HiUniNc/3.2.24": { + "HiUniNc/3.2.25": { "type": "package", "serviceable": true, - "sha512": "sha512-Ak2y16XYtzj31Ke4L5dS435Em2Y94ueFrAgiuJn60EL0V2V0TSe5lCTpsWyqjVdGWs84aJO6LSDLvwjOiWJ5kQ==", - "path": "hiuninc/3.2.24", - "hashPath": "hiuninc.3.2.24.nupkg.sha512" + "sha512": "sha512-L+rvtClSGfDlAGcHAOurrxtIki/YHvRHHz2ZEU3AipcWxqmVg8np0LiP44C7Kq79hDkQ3Cwt0KB0dQ2eSelHBA==", + "path": "hiuninc/3.2.25", + "hashPath": "hiuninc.3.2.25.nupkg.sha512" }, "MathNet.Numerics/5.0.0": { "type": "package", diff --git a/App/HiNC-2025-win-desktop.dll b/App/HiNC-2025-win-desktop.dll index d48f546c..4557016d 100644 Binary files a/App/HiNC-2025-win-desktop.dll and b/App/HiNC-2025-win-desktop.dll differ diff --git a/App/HiNC-2025-win-desktop.pdb b/App/HiNC-2025-win-desktop.pdb index 3a344a24..8eebf277 100644 Binary files a/App/HiNC-2025-win-desktop.pdb and b/App/HiNC-2025-win-desktop.pdb differ diff --git a/App/HiNc-Resource.dll b/App/HiNc-Resource.dll index 98db3d34..24441a7c 100644 Binary files a/App/HiNc-Resource.dll and b/App/HiNc-Resource.dll differ diff --git a/App/HiNc.dll b/App/HiNc.dll index 44c64c93..d5b08659 100644 Binary files a/App/HiNc.dll and b/App/HiNc.dll differ diff --git a/App/HiUniNc.dll b/App/HiUniNc.dll index b23ee840..393657b0 100644 Binary files a/App/HiUniNc.dll and b/App/HiUniNc.dll differ diff --git a/App/Resource/MachineTool/Table-B1.default/Table-B1.general-mech b/App/Resource/MachineTool/Table-B1.default/Table-B1.GeneralMechanism similarity index 100% rename from App/Resource/MachineTool/Table-B1.default/Table-B1.general-mech rename to App/Resource/MachineTool/Table-B1.default/Table-B1.GeneralMechanism diff --git a/App/Resource/MachineTool/Table-B1.default/Table-B1.mt b/App/Resource/MachineTool/Table-B1.default/Table-B1.mt index 4b94c7d6..5b6b0e94 100644 --- a/App/Resource/MachineTool/Table-B1.default/Table-B1.mt +++ b/App/Resource/MachineTool/Table-B1.default/Table-B1.mt @@ -3,7 +3,7 @@ - Table-B1.general-mech + Table-B1.GeneralMechanism diff --git a/App/StepPresentCatalog/catalog.en.json b/App/StepPresentCatalog/catalog.en.json index c663dd51..a2467dc6 100644 --- a/App/StepPresentCatalog/catalog.en.json +++ b/App/StepPresentCatalog/catalog.en.json @@ -1,6 +1,6 @@ { "schemaVersion": 1, - "engineVersion": "3.2.26.0", + "engineVersion": "3.2.27.0", "recordCount": 98, "records": [ { diff --git a/App/core.dll b/App/core.dll index 3fe1d215..20cf8dbe 100644 Binary files a/App/core.dll and b/App/core.dll differ diff --git a/App/en/HiGeom.resources.dll b/App/en/HiGeom.resources.dll index 3a66e97d..c35c74ff 100644 Binary files a/App/en/HiGeom.resources.dll and b/App/en/HiGeom.resources.dll differ diff --git a/App/en/HiMech.resources.dll b/App/en/HiMech.resources.dll index c351c7f4..bd8330ed 100644 Binary files a/App/en/HiMech.resources.dll and b/App/en/HiMech.resources.dll differ diff --git a/App/wwwroot/HiAPI-docsite/anatomy/by-source/index.html b/App/wwwroot/HiAPI-docsite/anatomy/by-source/index.html index f3cc4ceb..214ccd39 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/by-source/index.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/by-source/index.html @@ -112,9 +112,6 @@ hold across it, and the traps that survive a careful reading of any single file. where a shipped surface depends on it, but the engine's own structure is covered by the generated API Reference, which stays correct in a way a hand-written index could not.

-

Neither is the outgoing Windows desktop client. It takes no new feature work, so a hand-written -index of its tree drifts with every flagship change and is read by nobody; the same reasoning -retired the page-by-page map of its files.

See Also

Controller and Demo

-

Controller/ is the single-file surface behind the legacy controller page. It has a successor in -Mech/SoftNcRunnerController.cs, whose own doc comment says so, but both are live — the legacy -page has not been removed. Documented in Legacy Controller.

+

Controller/ is the single-file surface over the legacy HardNcEnv model, MachiningProject.NcEnv. +The Legacy Controller page that drove it was removed on 2026-09-11, but the controller is still +mounted: its routes edit the legacy tables, a different store from the runner tables that +Mech/SoftNcRunnerController.cs — its successor, as that file's own doc comment says — edits. The +successor covers the brand, the axis limits and rapid feedrates, the tooling time, the work +coordinates, the datum tables and the tool offsets, but not every route — among them the work-coordinate Align +P0 pair, the shortest-rotary toggle, the per-axis max rotary speed and the Heidenhain master-axis +character have no soft-runner endpoint. Only GET cnc-brand still has a client — the Execution +tool bar's Heidenhain Coordinate gate. Documented in Legacy Controller Model (HardNcEnv).

Demo/ is customer-facing sample code — a custom colour guide and a per-step optimization sweep — compiled into the assembly with no call site in the running application. Read it as an example of how to extend the engine, not as part of the shipped behaviour.

diff --git a/App/wwwroot/HiAPI-docsite/anatomy/by-source/webservice-spa.html b/App/wwwroot/HiAPI-docsite/anatomy/by-source/webservice-spa.html index 459891df..a0f3cb72 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/by-source/webservice-spa.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/by-source/webservice-spa.html @@ -95,8 +95,8 @@ out where they occur.

The One Thing to Know First

components/ is grouped both ways at the same level, and that is deliberate rather than untidy:

diff --git a/App/wwwroot/HiAPI-docsite/anatomy/conventions/rendering-canvas-web-service.html b/App/wwwroot/HiAPI-docsite/anatomy/conventions/rendering-canvas-web-service.html index 1875f884..a91eb374 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/conventions/rendering-canvas-web-service.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/conventions/rendering-canvas-web-service.html @@ -153,9 +153,11 @@ can put its own content on a canvas without touching the transport.

Execution displayee to it

Six further controllers bind content the same way — the STL preview, the Tool House, the General -Setup equipment, the machine tool, the Mech Builder general mechanism and the Controller page — -each with its own route and its own displayee, all reaching the engine through the same connection -ID.

+Setup equipment, the machine tool, the Mech Builder general mechanism and the legacy HardNcEnv +controller — each with its own route, all reaching the engine through the same connection ID. The +first five bind a displayee of their own; the last binds the shared Execution displayee, and it has +had no caller since the Legacy Controller page was removed on 2026-09-11 — the route is still +mounted, but no canvas in the SPA initializes against it.

Key Points

Web Page Application Source Code Path

-

The ClStrip flag is not offered here; the Tool Path button owns it. Heidenhain Coordinate appears only when MachiningProject.NcEnv.CncBrand is Heidenhain. The menu is a shared component because other screens use it too — see the Legacy Controller Page.

+

The ClStrip flag is not offered here; the Tool Path button owns it. Heidenhain Coordinate appears only when MachiningProject.NcEnv.CncBrand is Heidenhain — the tool bar reads that value through GET /api/Controller/cnc-brand, and the Execution displayee applies the same test before it draws the Heidenhain coordinate, so the row is offered exactly when the scene can show it. Mind which brand that is: the legacy HardNcEnv model's, loaded with the project, not the runner brand chosen on the General Setup page's Controller branch — switching the runner to Heidenhain does not reveal the row. Since the Legacy Controller page was removed on 2026-09-11 no screen writes the value: it comes from the project's NcEnv element, or from the still-mounted REST face — the PUT half of the same route, or a whole-model swap through POST /api/Controller/update. The menu is a shared component because other canvases use it too — see the RenderingCanvas Tool Bar.

  • Meshed Geom ▾ — the workpiece's rendering cache and geometry-diff settings: the Graphic-Cache SubMenu and Diff Visual Radius, with a Diff badge when a difference is present.

  • diff --git a/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/editing-contract.html b/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/editing-contract.html index 91dd3a16..ebf4f001 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/editing-contract.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/editing-contract.html @@ -237,9 +237,9 @@ but with one panel mounted at a time, the change that matters in practice is a p

    The Table Primitive

    Where a leaf renders a table it is Quasar's markup table — dense, flat, bordered — with a hand-written header and body and a repeat over the rows. No panel in the branch uses the data-table -component, and the four data tables left in the application are the legacy controller tabs this -branch supersedes. The practical difference is that these tables have no built-in sort, no pagination -and no column menu: what the header says is what the column is.

    +component, and since the legacy controller tabs were removed nothing else in the application does +either. The practical difference is that these tables have no built-in sort, no pagination and no +column menu: what the header says is what the column is.

    Key columns are rendered as plain text and cannot be edited: the tool and edge numbers of a $TC_DP row, a tool name, an R number, a # variable number, a datum row index, a native parameter id, and the axis names of every per-axis table, which follow the machining chain rather than the panel. The diff --git a/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/index.html b/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/index.html index 9ea12dad..a11b674e 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/index.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/index.html @@ -90,8 +90,9 @@

    The Controller branch is the SoftNcRunner-native settings face: the controller the project actually parses NC with, edited one tree node at a time. It lives on the General Setup page at /general-setup under the Control-Tree id equipment/controller, and grows two plane stems beneath -it — equipment/controller/machine and equipment/controller/program-data. The superseded -HardNcEnv surface still ships as a route of its own at /controller, and edits a different model.

    +it — equipment/controller/machine and equipment/controller/program-data. A bookmark to the +retired /controller address, where the Legacy Controller page used to edit the deprecating HardNcEnv +model instead of the runner, redirects to this branch root.

    Important

    Anatomy makes no claim that these ids are stable across versions. See @@ -230,12 +231,6 @@ switch. No panel refreshes it, so an edit that empties a table changes neither t branch until one of those happens.

    Both structural writes are refused while an NC program is playing: installing a runner and switching brand each answer a conflict rather than swapping the parser under a running session.

    -

    The Superseded Route

    -

    The legacy controller page still ships at /controller/:tab? and is reached from the app menu bar's -Page → Legacy-Controller entry. It edits HardNcEnv through its own REST -surface, which is a different model from the runner this branch edits — the two are not two views of -one object, and an edit on one is invisible to the other. Its anatomy is -Legacy Controller Page.

    Layout

    diff --git a/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/program-data/datum-tables.html b/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/program-data/datum-tables.html index 5847d786..5f8f0776 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/program-data/datum-tables.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/general-setup/controller/program-data/datum-tables.html @@ -308,9 +308,6 @@ row as seeded. The legacy work-coordinate table is replayed first, through the s aliases onto preset rows 1 through 6, so where the two overlap the explicit datum copy is what stands. -

    The superseded /controller route also carries datum preset and datum shift surfaces, over the -separate environment model rather than over the runner — an edit made there does not reach the table -on this page. That route's own anatomy is Legacy Controller Page.

    Layout

    -

    The superseded Legacy Controller screen at its own route is a separate -surface, editing a different model from the branch above.

    +

    A bookmark to the retired /controller address — the Legacy Controller page, which edited the +deprecating HardNcEnv model rather than the runner — now redirects here and lands on the Controller +branch.

    See Also

    diff --git a/App/wwwroot/HiAPI-docsite/anatomy/index.html b/App/wwwroot/HiAPI-docsite/anatomy/index.html index e8c03f94..e184fa89 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/index.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/index.html @@ -131,10 +131,6 @@ regroup adds a migration hop. The ids themselves have moved repeatedly.

    Tool House Page -/controller/:tab? -Legacy Controller - - /util/file-explorer, /util/mech-builder Utility Pages @@ -174,23 +170,16 @@ regroup adds a migration hop. The ids themselves have moved repeatedly.

  • Execution Page — The run cockpit: its tool bars, the step column, the charts, and the Mission branch it hosts
  • General Setup Page — The equipment Control Tree: the machine, the spindle envelope, the scene, the fixture, the workpiece and the controller branch
  • Tool House Page — The tool library and the per-tool editor tabs, cutter and holder
  • -
  • Legacy Controller — The superseded HardNcEnv controller surface and its REST implementation
  • -
  • Legacy Controller Settings — The HardNcEnv model that surface edits: the three settings it owns alone, what it shares with the Controller branch, and the engine files behind both
  • +
  • Legacy Controller Model (HardNcEnv) — The deprecating HardNc controller model the project still carries beside the runner: what the live pipeline still reads from it, the three settings that retire with it and the Align P0 action the runner path does not offer, what the Controller branch edits a runner-side copy of, and the engine files behind both
  • Utility Pages — The two /util/ routes: the File Explorer and the Mechanism Builder
  • By Source Directory — The same knowledge keyed on the source tree instead of the screen: one directory index per half of the flagship
  • -

    The Two Codebases

    -

    A page's Source Code Path section lists the files that implement it in the flagship web service. -The desktop client's counterparts are not listed at all: it takes no new feature work, and a -hand-maintained map of its files went stale faster than anyone read it. The two codebases are not -peers.

    +

    The Codebase

    +

    A page's Source Code Path section lists the files that implement it in the flagship web service, +which is the only application codebase Anatomy documents.

    HiNC-2025-webservice is the flagship — a Quasar SPA (Vue 3 + TypeScript + Pinia) served by ASP.NET Core, and the only target for new feature work. Repository: HiNC-2025-webservice.git

    -

    HiNC-2025-win-desktop is the outgoing WPF client, kept here only so a reader familiar with the -desktop UI can find the equivalent web-service component. Do not start new work against it. -Repository: -HiNC-2025-win-desktop.git

    Tip

    The host process, its configuration and the address it listens on are documented in @@ -204,8 +193,7 @@ Control Tree, its ?tree= id. Make no claim that the id is stable.Key Model — the backing HiAPI types, as <xref:> so the API reference is one click away.

  • Source Code Path — the implementing files in the web service. Backtick every path, with its extension: tools/check-source-paths.ps1 resolves a full path against the source tree and a -bare file name by its base name, and refuses an entry carrying no backticks at all. Do not add -desktop-client files.
  • +bare file name by its base name, and refuses an entry carrying no backticks at all.
  • ## See Also — mandatory, and audited for reciprocity. An entry is not landed until the target links back. Anatomy is authoritative on component and source facts: when Manual and Anatomy disagree, diff --git a/App/wwwroot/HiAPI-docsite/anatomy/legacy-controller-settings.html b/App/wwwroot/HiAPI-docsite/anatomy/legacy-controller-settings.html index c7f13948..94f4bdcb 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/legacy-controller-settings.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/legacy-controller-settings.html @@ -2,9 +2,9 @@ - Legacy Controller Settings | HiAPI-C# 2025 + Legacy Controller Model (HardNcEnv) | HiAPI-C# 2025 - + @@ -85,15 +85,23 @@
  • -

    Legacy Controller Settings

    +

    Legacy Controller Model (HardNcEnv)

    -

    HardNcEnv is the model the Legacy Controller page at /controller/:tab? edits, -and this page is what that model holds: how it stands to the runner the rest of the application -configures, the three settings this screen owns alone, the ones it shares with the Controller Branch -on General Setup, and the one marker class both faces draw a work coordinate with. The screen itself -— its seven tabs, how an edit commits, its object-management chain, its viewer and its layout — is -Legacy Controller Page.

    -

    The Model It Edits, and the One It Does Not

    +

    HardNcEnv is the HardNc controller model: the one the project still carries as +MachiningProject.NcEnv and serializes as its NcEnv element, and the one the deprecating HardNc +pipeline plays. It is a model with no screen. The Legacy-Controller page at /controller/:tab? that +edited it was removed on 2026-09-11 — /controller/… now redirects to +/general-setup?tree=equipment/controller, following the route file's convention for retired +pages — and controller settings are edited on the General Setup page's +Controller Branch, the settings face of the SoftNc runner, which is the +live pipeline. What survives of the legacy face is its REST implementation, +Controller/ControllerController.cs, still mounted under /api/Controller/*, and its typed client +wwwroot-src/src/api/controller.ts, kept as those endpoints' only client; one wrapper in it, +getCncBrand, is still called from a live component. This page is what the model holds: how it +stands to the runner, what the live pipeline still reads from it, the settings that retire with it, +the ones the branch edits a runner-side copy of, and the one marker class both stores draw a work +coordinate with.

    +

    The Model, and the Runner Beside It

    The project carries both models side by side and serializes both. HardNcEnv is loaded from the project's own NcEnv element unconditionally; NcRunnerSuit — the runner plus the project's per-case dependency list — is read from its own nested element. The legacy @@ -101,121 +109,149 @@ element is a fallback source for the suit rather than a shared store: a no runner element derives one from the legacy element at load time, and from then on the two drift apart, because every later edit lands on one of them alone.

    The legacy model is still read at play time. The legacy NC runner is constructed over a delegate -onto the project's NcEnv, so installing a replacement through the screen's ⋮ menu propagates +onto the project's NcEnv, so a replacement installed through the update endpoint — the removed +page's object-management chain was its caller, and nothing in the SPA calls it now — propagates without rewiring, and a project-level switch selects which of the two pipelines plays. That switch defaults to the SoftNc pipeline and no screen in the web application changes it; it is a scripting property, EnableSoftNcRunner(API). The legacy NC optimisation route is the other live reader: it is taken whenever the switch is off or the session holds no played SoftNc layers, and it is handed MachiningProject.NcEnv directly.

    -

    What Only This Screen Edits

    -

    Three settings on this screen have no editor anywhere else in the web application — neither on the -branch, nor on any other page.

    -

    Align P0, and its undo history

    -

    The Coordinate Table tab — that is the tab button's label; ISO Coordinate Table is the heading -over the panel it opens — carries a third row action beside P0 and M0: Align P0, titled -"Move workpiece+fixture so ProgramZero coincides with this ISO entry (mutates -Fixture.GeomToTableTransformer)". It does not write the coordinate — it writes the fixture's -geometry-to-table transformer, moving the workpiece and fixture so that program zero lands on the -offset the row holds. The write goes to the authored setup equipment and reports the edit, so the -runtime face follows at the next rebuild. The branch's Work Coordinates leaf carries P0 and M0 and -no alignment.

    -

    The endpoint keeps no undo slot. It answers with the assigned translation plus the transformer as it -stood before and after the write, both serialized as XML, and the tab holds the history -itself: Undo Align and Redo Align buttons over two component-local stacks, the undo stack -capped at 32 entries and the oldest dropped past it. A third button sits beside them, Show on -Display, which belongs to the viewer rather than to the history: it is a bound toggle over the -IsoCoordinate rendering flag, carrying a visibility / visibility_off icon and writing through -the same flag endpoint the Scene dropdown writes. The two datum tabs carry the same button over -HeidenhainCoordinate. Each step posts a stashed snapshot back to a stateless revert endpoint, -which parses it and assigns the result as the fixture's transformer. Both stacks are cleared -whenever the tab's has-a-project prop changes, and the snapshot the component believes is current is -only what it last saw — a transformer changed from another surface is overwritten wholesale by the -next undo or redo rather than merged.

    -

    The engine exposes the same operation as a script call, -AlignWorkpieceProgramZeroToIso(API); the -history is the screen's own.

    +

    What the Live Pipeline Still Reads From It

    +

    Selecting the SoftNc pipeline does not silence the legacy model. Four reads still land on it with +the switch on, so a value that only the legacy endpoints or the project XML can change still shows +up on a runner play.

    + +

    The kinematics solver the service builds is mirrored onto NcEnv.XyzabcSolver as well, but that +slot is wiring the service maintains rather than a setting, and it is never serialized.

    +

    Settings That Retire With the Model

    +

    Four controls had no editor anywhere in the web application but the removed screen. None of them +gained one on the branch: three are legacy-only settings and retire with the model, and the fourth is an +action the runner path does not offer. Every one keeps its endpoint under /api/Controller/*, so +the value can still be read and written over REST or in the project XML — there is just no UI for +it.

    +

    Align P0 — not offered on the runner path

    +

    The removed Coordinate Table tab carried a third row action beside P0 and M0: Align P0, +which moves the part so that program zero lands on the offset the row holds — the reproducing +direction, program zero onto the work offset in the manual's terms. It did not write the +coordinate; it wrote the fixture's geometry-to-table transformer, so the workpiece and fixture +moved together and the runtime face followed at the next rebuild. The branch's Work Coordinates +leaf carries P0 and M0 only, which write the row from the machine position — the opposite +direction — and no alignment. The operation is not offered on the runner path.

    +

    The tab's undo history — Undo Align and Redo Align over two component-local stacks, the +undo stack capped at 32 entries — was the component's own and went with it; the endpoint never kept +an undo slot. It still answers with the assigned translation plus the transformer as it stood +before and after the write, both serialized as XML, and the stateless revert endpoint still +parses such a snapshot and assigns it as the fixture's transformer; nothing in the SPA posts to +either now. The engine exposes the same operation as a script call, +AlignWorkpieceProgramZeroToIso(API), which +looks the row up in the legacy model's ISO coordinate table — an API for a script, not a +replacement for the removed control.

    Enable Shortest Rotary Path

    -

    The Config tab's single toggle writes EnableShortestRotary, which -constructs true. Its banner reads "Shortest Rotary Path: optimises rotary axis motion to use -the shortest angular distance between positions." On the legacy pipeline the flag gates one step: -each rotary axis of a block is cycled into the ±180° window around the previous block's value. The -toggle is narrower than it reads, because that same cycle is applied unconditionally on +

    EnableShortestRotary constructs true, and its only editor was the +removed Config tab's single toggle. On the legacy pipeline the flag gates one step: each rotary +axis of a block is cycled into the ±180° window around the previous block's value. The flag is +narrower than its name, because that same cycle is applied unconditionally on Heidenhain — the brand branch runs it before the flag is consulted, so -clearing the box changes nothing there.

    +clearing it changes nothing there.

    The runner's dependency layer declares no counterpart: no brand parameter table, no generic config -and no branch leaf carries a shortest-rotary switch. The nearest thing the runner pipeline has is the -Heidenhain M126 / M127 pair, which is read from the program text rather than from any setting.

    +and no branch leaf carries a shortest-rotary switch. What the runner pipeline has instead is the +Heidenhain M126 / M127 pair, modal codes read from the program text rather than from any +setting.

    +

    Max rotary speed per axis

    +

    MaxRotarySpeedABC_radds is the per-axis rotary speed ceiling the +HardNc pipeline clamps feed and cycle time against; its editor was the removed Machine tab's +Max Speed (rpm) column. On the runner pipeline the ceiling is not a setting of its own: the +polar feed clamp reads it from the per-axis rapid-feedrate bucket, +IRapidFeedrateConfig, and the legacy import funnels this field into +that bucket at rpm × 360 deg/min, so the branch's Rapid Feedrates leaf edits the runner-side +number. The legacy field itself retires with the model.

    Heidenhain master-axis character

    -

    The Brand tab grows a second card while the brand is Heidenhain, holding one select over A, -B, C labelled Master-axis character. It writes -HeidenhainMasterAxisChar, a character face over the integer axis -direction the PLANE … SEQ solution family is resolved against. Reads are normalised: anything that -is not B or C after trimming and upper-casing becomes A. On the runner pipeline the master +

    HeidenhainMasterAxisChar is a character face over the integer axis +direction the PLANE … SEQ solution family is resolved against; its editor was a second card the +removed Brand tab grew while the brand was Heidenhain, one select over A, B, C. The setter +takes only A, B or C and throws on anything else; the PUT endpoint upper-cases the first +character it is sent and answers 400 to anything but those three. On the runner pipeline the master rotary is derived rather than configured — it is the first declared rotary axis — so the branch has nothing to expose and no leaf for it.

    -

    What It Shares With the Branch

    -

    Naming what is not exclusive matters as much. The CNC brand, the stroke limits, the rapid feed, +

    What the Branch Edits a Runner-Side Copy Of

    +

    Naming what is not legacy-only matters as much. The CNC brand, the stroke limits, the rapid feed, the tool-change time, the tool offset table with its tool-house dependence, the work coordinates with their P0 and M0 actions, and the Heidenhain datum preset and datum shift tables all have -editors on the branch — see -Brand Matrix for which of those leaves each brand grows. The -Max Speed (rpm) column has a counterpart too: on the runner pipeline the rotary speed ceiling is -read from the rapid-feedrate config, and the legacy import funnels this field into it at rpm × 360 -deg/min, so the branch's Rapid Feedrates leaf edits the runner-side number.

    -

    One control on this screen writes a value the branch also writes. Set ideal offset dependent on -tool house is a project-level configuration flag rather than a member of either NC model, and both -the Offset Table tab and the branch's Tool Offsets leaf read and write that one flag. The two -tables stay separate: this tab's Refresh from Tool House recomputes -MillingToolOffsetTable from MachiningToolHouse, -while the branch's refresh recomputes the runner's own tool-offset table.

    +editors on the branch — see Brand Matrix for which of those +leaves each brand grows. The branch edits the runner's copy of each; the legacy copy in +HardNcEnv is reachable only through its endpoint and the project XML, and the +two are not kept in step.

    +

    One flag sits outside both models. Set ideal offset dependent on tool house is a project-level +configuration flag, and the branch's Tool Offsets leaf and the legacy ideal-offset-dependent +endpoint read and write that one flag. The two tables stay separate: the legacy +set-ideal-offset-from-toolhouse endpoint — the removed Offset Table tab's Refresh from Tool +House — recomputes MillingToolOffsetTable from +MachiningToolHouse, while the branch's refresh recomputes the runner's own +tool-offset table.

    Two Faces of a Work Coordinate

    -

    The work-coordinate marker is one displayee class serving two providers. The screen's viewer draws +

    The work-coordinate marker is one displayee class serving two providers. The Execution canvas draws it from IsoCoordinateTable — a IsoCoordinateTable instance owned by the legacy model, which -constructs with G54G59 and G59.1G59.9 all at zero. The General Setup canvas builds the -same displayee over the active runner's effective -IIsoCoordinateConfig instead, which on most brands is the brand -parameter table. Same marker, same code, two stores.

    -

    Selecting a row on the ISO Coordinate Table tab writes the marker's id onto the shared Execution -displayee, so it decides which offset the marker draws at. It decides that whether or not the marker -is drawn: all three coordinate flags are off in the shipped rendering-flag set — as are the machine -tool and the cutter, leaving the workpiece, the fixture, the dimension bar and the cutter-location -strip as the four that arrive on — so on an untouched project the selection column moves something -invisible until Show on Display is pressed. The datum tabs also carry a single-selection column, -but nothing is sent when it changes — there the selection is a highlight and nothing more.

    +constructs with G54G59 and G59.1G59.9 all at zero — and draws its Heidenhain datum +marker from the legacy datum tables the same way. The General Setup canvas builds the same +displayee over the active runner's effective IIsoCoordinateConfig +instead, which on most brands is the brand parameter table. Same marker, same code, two stores.

    +

    Which row the Execution marker draws is the displayee's own id, constructed as G54. Its only +writer is the legacy iso-coordinate-selection endpoint, which the removed tab's row selection +posted to and nothing in the SPA posts to now, so the Execution marker stays on G54. Whether it +is drawn is the IsoCoordinate rendering flag, toggled from the Execution page's Scene dropdown; +all three coordinate flags are off in the shipped rendering-flag set — as are the machine tool and +the cutter, leaving the workpiece, the fixture, the dimension bar and the cutter-location strip as +the four that arrive on. The General Setup marker's row is a user-config value of its own, with an +endpoint on the equipment-setup display controller.

    Source Code Path

    See HiNC App Anatomy for git repository links.

    Web Application

    HiNC-2025-webservice (Quasar CLI SPA):

    HiAPI Engine

    See Also

    diff --git a/App/wwwroot/HiAPI-docsite/anatomy/legacy-controller.html b/App/wwwroot/HiAPI-docsite/anatomy/legacy-controller.html deleted file mode 100644 index fb57e5dc..00000000 --- a/App/wwwroot/HiAPI-docsite/anatomy/legacy-controller.html +++ /dev/null @@ -1,472 +0,0 @@ - - - - - Legacy Controller Page | HiAPI-C# 2025 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - -
    - -
    -
    -
    -
    -
    Table of Contents
    - -
    -
    - -
    -
    -
    - -
    -
    - - - -
    - -
    -

    Legacy Controller Page

    - -

    The Legacy Controller page is the superseded controller face: the screen that edits -HardNcEnv, kept reachable while it still carries settings nothing else in the -application edits. It ships at the route /controller/:tab?, is reached from the app menu bar's -Page → Legacy-Controller entry, and owns no Control-Tree id of its own. Controller settings for -a project are edited on the General Setup page at /general-setup under the Control-Tree id -equipment/controllerController Branch — and the two surfaces edit -different models, so an edit on one is invisible to the other.

    -
    -
    Important
    -

    The equipment/controller id named above belongs to the Controller Branch rather than to this -page, and Anatomy makes no claim that it is stable across versions. The migration hop that keeps -an older value resolving is described in Tree Ids and Routes.

    -
    -

    The model this screen edits — what HardNcEnv holds, the three settings it -owns alone, what it shares with the branch, and the engine files behind all of it — is -Legacy Controller Settings.

    -

    The Tabs

    -

    The left pane is a tab strip over seven panels, addressable as the route's optional segment: -coordinate-table, datum-preset, datum-shift, offset-table, machine, brand, config. A -bare /controller canonicalises to coordinate-table. Two tab buttons are conditional — Datum -Preset and Datum Shift render only while the brand reads Heidenhain — but their panels are always -present in the template, so both segments stay valid URL targets under any brand. Switching the brand -away from Heidenhain while one of those two is active moves the selection back to Coordinate Table.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    TabEdits
    Coordinate TableIsoCoordinateTable, plus the P0 / M0 / Align P0 row actions
    Datum PresetHeidenhainDatumPresetTable, keyed Q339
    Datum ShiftHeidenhainDatumShiftTable, keyed D
    Offset TableMillingToolOffsetTable with row-level add, delete and key rename
    MachineRapidFeedrate_mmdmin, ToolingTime, StrokeLimitXyz_mm, StrokeLimitAbc_rad, MaxRotarySpeedABC_radds
    BrandCncBrand, and the master-axis character on Heidenhain
    ConfigEnableShortestRotary
    -

    The brand select offers all five declared brands — Fanuc, -Heidenhain, Mazak, -Siemens and Syntec — labelled with the -brand names verbatim rather than through the locale bundle, and warns above the select that -"Brand-specific settings may be lost when the brand changes."

    -

    The Machine tab's axis rows are fixed, not chain-driven. It renders exactly X, Y, Z under -Linear Axis Stroke (mm) and exactly A, B, C under Rotary Axis Stroke (deg) & Max Speed -(rpm), because both row sets are literal in the template. Every write there sends the whole vector -— all six linear bounds, all six rotary bounds converted to radians, or all three speeds converted to -rad/s — rather than the one cell that changed. The branch's per-axis leaves take the opposite shape: -one row per machine-chain axis, one axis per write, described in -Per-Axis Tables.

    -

    Both stroke limits construct as an infinite box, and the service serializes named floating-point -literals, so those bounds reach the browser as the tokens Infinity and -Infinity rather than as -numbers. The shared numeric field prints what it is handed and parses both words back, so an -unconfigured Machine tab opens showing those words rather than a blank and takes them typed in; the -rotary rows carry them through unconverted, because the degree conversion guards on a finite value.

    -

    A stroke write does not survive its own re-read. The read and the write agree on the wire order: -the read emits the six bounds interleaved per axis, [minX, maxX, minY, maxY, minZ, maxZ], and the -tab posts the same six back. The write then hands that vector to the box constructor, which reads its -arguments grouped — the whole minimum corner first, the whole maximum corner second. The vector is -de-interleaved on the way in, so only the first and the last number land where they were sent and the -four between them move to other rows; from the infinite default above, that is enough to leave the -middle axis reading a Max below its Min after any single edit. The rotary stroke endpoints share -the constructor and the behaviour; the three Max Speed values travel as a plain triple and are -unaffected. The regrouped box is not inert — with the stroke check on and no runner-side stroke -config resolving, the legacy play path validates every step against -StrokeLimitXyz_mm and StrokeLimitAbc_rad -as stored. The branch's per-axis leaves, writing one axis at a time, carry none of it.

    -

    How an Edit Commits

    -

    The tabs reuse the same numeric field the rest of the application uses, so the timing is that -widget's: commit on blur or on Enter, never per keystroke, with the bounds and parse behaviour set -out in Numeric Input. Clearing a cell parses to null and every legacy -handler returns on null, so an emptied cell is not an edit — the one exception is the Offset Table's -tool-number cell, which forbids an empty value and shows a parse error in place instead. Selects, -toggles and row buttons commit on the click.

    -

    The optimistic write is the same capture-assign-await-restore shape the branch's panels use, and -Editing Contract is where that shape, its row-scoped -payloads and its rollback semantics are set out once. Four differences are this screen's own:

    -
      -
    • Three fields commit without a rollback. The Machine tab's Rapid Feedrate and Tooling -Time handlers assign the new value and await the write without capturing the old one, so a -refused write raises the toast and leaves the field showing the number the server rejected. The -Brand tab's Master-axis character select is the third and the least recoverable: its handler -captures nothing and restores nothing, and its two-way binding has already put the pick into the -tab's own state before the handler runs, so a refused write leaves the rejected character on screen -looking accepted. Every other value handler — the stroke and speed vectors, the coordinate and -datum cells, the offset row and its key rename, the brand select itself, the shortest-rotary toggle -(two-way bound as well, but reconstructing its old value from the new one) — restores the old value -on failure. Row actions are outside the shape entirely: P0, M0, the datum reset, an add and -a delete all write first and touch the local rows only once the request resolves.
    • -
    • The REST surface answers with status codes, not a success envelope. A missing table, an -unknown index or an unexpected paste type is answered as not found, bad request or conflict. -Most of those answers are bare English sentences; four carry a code — no project loaded, no NcEnv -found, no NcEnv configuration and no fixture — which the client re-renders from the locale bundle -under any language but English. The branch's surface instead answers a missing dependency inside a -200 envelope; nothing here does.
    • -
    • A refused load is silent on six of the seven tabs. Every write wrapper in this page's API -module goes through the plain-JSON helper, which throws on any non-2xx and returns the parsed body -otherwise, so a refused write always reaches a toast. Eight read wrappers deliberately bypass it -and answer a benign default on any non-2xx: an empty list for the coordinate table, both datum -tables and the offset table, unknown for the brand, A for the master-axis character, and off -for the tool-house dependence and shortest-rotary flags. A refused load therefore renders as an -empty or default tab, indistinguishable from one whose table really is empty, with no toast and no -console line. Only the Machine tab's five reads throw, so it is the one tab on which a refused load -shows.
    • -
    • The tool-house dependence toggle writes before it flips. Turning it on awaits the flag write, -then flips the local toggle, then refreshes the offsets from the tool house and re-reads the table. -A failure in the refresh therefore leaves the flag committed on both sides rather than reverted.
    • -
    -

    Every tab composes its failure toast the same way: negative, 3.5 seconds, the tab's own localized -context followed by the thrown error's own text, with a console line naming the component. That text -is built by the shared helper as HTTP <status>: <server message>, so the status code reaches the -user in the toast — where the branch's envelope failures surface the server's sentence alone.

    -

    Each tab fetches once on mount and again when its has-a-project prop turns true; the tab panels are -kept alive, so moving between tabs does not refetch. That prop is the indexed key rather than the -project store's own flag: Initialize answers not found where the project carries no NcEnv, so a -project can be open while every tab still reads as having none. Nothing pushes changes at a mounted -tab, and no tab re-reads after a cell edit — the Offset Table's two tool-house actions are the one -exception, because the server recomputes the table under them.

    -

    The four tables that render as data tables — the coordinate table, the two datum tables and the -offset table — are the only places in the application that use that component. None of them declares -a sortable column, and all four run unpaginated with every row shown.

    -

    Object Management and the Install Chain

    -

    The left pane's head line carries the shared object-management ⋮ menu, the title Controller, and -a badge reading ready while a key is indexed and no project otherwise. The menu's entries are -Load, Save As, Copy, Paste and XML Mode; Load Resource is absent because the page passes no resource -directory. Load and Save As browse the server file system through the shared file-explorer dialog -filtered to *.NcEnv / *.xml, rooted at the project directory once a project is open; Save As -proposes the name NcEnv.xml; Paste is checked against the expected type -Hi.Numerical.HardNcEnv, HiUniNc.

    -

    Load, Paste and an XML apply swap only the indexed object, so the page then installs it: it posts the -indexed key to the install endpoint before re-running Initialize, because Initialize re-indexes -from the project and would otherwise resurrect the object that was replaced. A failed install stops -the chain with a toast. A successful one re-reads the brand, which is what re-gates the two Heidenhain -tabs, refreshes the rendering flags, and raises an informational toast naming the installed type. The -XML dialog's Apply raises the load event as well as its own, and the page listens only to the load -event, so the chain runs once rather than twice.

    -

    Initialize mints a fresh index key on every call, and the page registers each one for cleanup and -drops the key it replaced, so repeated installs do not accumulate entries.

    -

    The Viewer

    -

    The right pane is a rendering canvas with its own toolbar: the shared view toolbar, a Scene ▾ -dropdown, and a badge reading rendering or disconnected. The canvas binds the shared Execution -displayee rather than a viewer of its own, so what is toggled here is what the Execution page -shows.

    -

    The Scene dropdown groups its checkboxes as Solid — Machine, Tool, Workpiece, Fixture — -Coordinate — Program Zero, ISO Coordinate, Heidenhain Coordinate — and Display Aids — -Dimension Bar, Color Scale Bar. The Heidenhain Coordinate row is listed only while the brand reads -Heidenhain. Three tabs carry a Show on Display button of their own that flips the same shared -flags: the coordinate tab flips ISO Coordinate, and the two datum tabs both flip Heidenhain -Coordinate.

    -

    The Heidenhain marker is gated twice over, and the second gate is never satisfied. The displayee is -added to the scene only while its flag is set and the model's brand is Heidenhain; it then returns -without drawing until an active datum number or datum-shift argument has been assigned to it, and no -code path in the web service assigns either. So the marker stays absent whatever the flag reads. -Where it does draw, it resolves its offset through the legacy datum tables — the ones this page's two -datum tabs edit — and not through the runner's.

    -

    Layout

    -
      -
    • Legacy Controller Page — /controller/:tab?, a two-pane splitter, left pane 55 % and draggable -between 25 % and 75 % -
        -
      • Management Pane -
          -
        • Head Line - -
        • -
        • Tab Strip — Coordinate Table, Datum Preset, Datum Shift, Offset Table, -Machine, Brand, Config; the two datum buttons rendered only under Heidenhain
        • -
        • Tab Panels — kept alive; one shown at a time -
            -
          • ISO Coordinate Table Panel -
              -
            • Toolbar — Undo Align, Redo Align, Show on Display
            • -
            • Table — columns Index, X, Y, Z, Actions, with a single-selection column -
                -
              • Row Actions — P0, M0, Align P0
              • -
              -
            • -
            -
          • -
          • Datum Preset Table Panel — Show on Display; columns Q339, X, Y, Z, -Actions, the action being a reset-to-zero button
          • -
          • Datum Shift Table Panel — the same shape, keyed D
          • -
          • Tool Offset Table Panel -
              -
            • Toolbar — Set ideal offset dependent on tool house toggle, and Refresh from Tool -House while it is on
            • -
            • Table — columns Tool #, Ideal Radius, Radial Wear, Ideal Height, Axial -Wear, and a delete button; the tool number is editable and the delete button present only -while the dependence is off
            • -
            • Add Button — below the table, shown only while the dependence is off
            • -
            -
          • -
          • Machine Configuration Panel -
              -
            • General Card — Rapid Feedrate (mm/min) and Tooling Time (sec) numeric fields
            • -
            • Linear Axis Stroke (mm) Card — Axis / Min / Max over fixed rows X, Y, Z
            • -
            • Rotary Axis Stroke (deg) & Max Speed (rpm) Card — Axis / Min (deg) / -Max (deg) / Max Speed (rpm) over fixed rows A, B, C
            • -
            -
          • -
          • CNC Brand Panel -
              -
            • Selection Card — the brand select over the five brands, above the brand-change warning -banner
            • -
            • Heidenhain Settings Card — Master-axis character select over A / B / C; shown only -under Heidenhain
            • -
            -
          • -
          • Configuration Panel -
              -
            • Options Card — Enable Shortest Rotary Path toggle above its explanatory banner
            • -
            -
          • -
          -
        • -
        -
      • -
      • Viewer Pane -
          -
        • Viewer Toolbar -
            -
          • RenderingCanvas Tool Bar
          • -
          • Scene ▾ Dropdown — Solid, Coordinate and Display Aids groups
          • -
          • Connection Badge — rendering / disconnected
          • -
          -
        • -
        • Rendering Canvas — bound to the shared Execution displayee
        • -
        -
      • -
      -
    • -
    -

    Source Code Path

    -

    See HiNC App Anatomy for git repository links.

    -

    Web Application

    -

    HiNC-2025-webservice (Quasar CLI SPA):

    -
      -
    • wwwroot-src/src/pages/ControllerPage.vue — the page shell: the splitter, the seven tab panels and -the Heidenhain gate over two of the buttons, the install-then-initialize chain, the rendering-flag -snapshot the per-tab toggles read, and the tab reset on leaving Heidenhain.
    • -
    • wwwroot-src/src/components/controller/CoordinateTableTab.vue — the coordinate table: the per-cell -whole-row write, the row selection that names the marker, the P0 / M0 actions, and Align P0 with -its two client-side history stacks and their cap.
    • -
    • wwwroot-src/src/components/controller/DatumPresetTab.vue and -wwwroot-src/src/components/controller/DatumShiftTab.vue — the two Heidenhain tables: the Q339 -and D key columns, the reset-to-zero action, and the selection that is a highlight only.
    • -
    • wwwroot-src/src/components/controller/OffsetTableTab.vue — the offset editor: row add, delete and -key rename with its duplicate guard, and the two-step tool-house dependence toggle.
    • -
    • wwwroot-src/src/components/controller/MachineTab.vue — the fixed X/Y/Z and A/B/C row sets, the -whole-vector writes, the degree and rpm conversions with their infinity guards, and the two -handlers that commit without capturing a rollback value.
    • -
    • wwwroot-src/src/components/controller/BrandTab.vue — the five-brand select with its captured -rollback, the change warning, and the Heidenhain master-axis card: its read normalisation, its -two-way binding and its write with no rollback.
    • -
    • wwwroot-src/src/components/controller/ConfigTab.vue — the shortest-rotary toggle, its banner and -its reconstructed rollback.
    • -
    • wwwroot-src/src/components/controller/ControllerExtendedToolBar.vue — the Scene dropdown: the -three flag groups and the brand test that hides the Heidenhain row.
    • -
    • wwwroot-src/src/api/controller.ts — the typed wrappers over every endpoint above, the brand -constants and their literal labels, the align / revert payloads, the documented stroke-vector order, -and the eight read wrappers that answer a default instead of raising.
    • -
    • wwwroot-src/src/api/http.ts — the plain-JSON helper every write goes through, its coded-error -keys, and the success-envelope helper this module does not use.
    • -
    • wwwroot-src/src/api/renderingFlags.ts — the flag indices the Scene dropdown and the per-tab -toggles write.
    • -
    • wwwroot-src/src/components/widgets/NumericInput.vue — the numeric cell: commit on blur or Enter, -the empty-to-null parse the handlers reject, the generic text path that prints the infinity tokens, -and the parse branch that takes them back.
    • -
    • wwwroot-src/src/components/widgets/ObjectManagementMenuButton.vue — the ⋮ menu, its server file -browser and extension filter, the paste type check, and the load event an XML apply also raises.
    • -
    • wwwroot-src/src/components/RenderingCanvas.vue and -wwwroot-src/src/components/RenderingCanvasToolBar.vue — the viewer pane's canvas and its shared -view toolbar.
    • -
    • wwwroot-src/src/composables/useRouteTabs.ts — the tab-to-URL sync, the seven valid segments and -the default the bare route canonicalises to.
    • -
    • wwwroot-src/src/composables/useCleanupHub.ts — the registration that drops each superseded index -key.
    • -
    • wwwroot-src/src/router/routes.ts — the /controller/:tab? route beside /general-setup.
    • -
    • wwwroot-src/src/components/AppMenuBar.vue — the Page dropdown carrying the -Legacy-Controller entry.
    • -
    • wwwroot-src/src/stores/project.ts — the project flag the page watches in order to re-run -Initialize; the indexed key that call returns is what the seven tabs and the status badge read.
    • -
    • wwwroot-src/src/layouts/MainLayout.vue — the keep-alive that holds the page across navigation and -rebuilds it on a project epoch change.
    • -
    • wwwroot-src/src/i18n/en/controller.ts — every title, tab label, column header, banner and error -context quoted above.
    • -
    • wwwroot-src/src/i18n/en/menu.ts — the Page and Legacy-Controller menu strings.
    • -
    • wwwroot-src/src/i18n/en/common.ts — the shared column, action and status strings the tabs reuse.
    • -
    • Controller/ControllerController.cs — the page's whole REST surface: the index-and-install pair, -the per-property readers and writers, the interleaved stroke reads beside the grouped stroke -writes, the four coded error payloads, the row-level offset CRUD, the align endpoint that snapshots -the transformer either side of the write, the stateless revert, and the display binding that -attaches the shared Execution displayee.
    • -
    • Common/ApiError.cs — the four coded payloads named above.
    • -
    • Program.cs — the named-floating-point-literal serializer the infinite bounds travel under.
    • -
    • Widget/ObjectManagementController.cs — the server half of the ⋮ menu, including the paste that -rejects an object the expected-type string does not admit.
    • -
    • Disp/ExecutionDisplayee.cs — the displayee this page's canvas binds: the two coordinate flags, -the extra brand test on the Heidenhain one, and the legacy tables both markers are built over.
    • -
    • Disp/IsoCoordinateEntryDisplayee.cs — the one marker class serving both faces, over whichever -coordinate provider it is handed.
    • -
    • Disp/HeidenhainCoordinateEntryDisplayee.cs — the Heidenhain marker: the brand guard, the datum -number and shift argument it draws nothing without, and the legacy tables it resolves through.
    • -
    • Common/ProjectDisplayeeService.cs — where that single shared displayee is created.
    • -
    -

    HiAPI Engine

    -
      -
    • HiUniNc/Numerical/HardNcEnv.cs — the model behind the tab table above: the coordinate, datum and -offset tables, the two stroke boxes that construct infinite, and the rapid rate and tooling time -the Machine tab writes.
    • -
    • HiGeom/Geom/Box3d.cs — the box the two stroke limits are, its infinite construction, and the -six-argument constructor whose grouped argument order the interleaved stroke writes are handed to.
    • -
    • HiUniNc/Numerical/MillingToolOffsetTable.cs — the offset table the Offset Table tab edits: a -dictionary keyed on the offset id, which is the key a row rename moves an entry to.
    • -
    • HiNc/MachiningProcs/LocalProjectService.cs — the per-step stroke check that falls back to the -legacy boxes when no runner-side stroke config resolves, which is what makes a regrouped box -observable.
    • -
    -

    See Also

    -
      -
    • Legacy Controller Settings — the model this screen edits, the three settings it -owns alone, and the engine files behind them
    • -
    • Controller Branch — the SoftNcRunner-native controller branch that supersedes this screen, -and where controller settings for a project are edited
    • -
    • General Setup Page — the page that hosts the branch above, and the rest of the equipment -tree beside it
    • -
    • Legacy Controller (manual) — the end-user task: the settings this screen still -owns alone, and which face to edit for everything else
    • -
    - -
    - -
    -
    - - - -
    - -
    - -
    -
    - -
    - - - - diff --git a/App/wwwroot/HiAPI-docsite/anatomy/platform/i18n.html b/App/wwwroot/HiAPI-docsite/anatomy/platform/i18n.html index ee78b284..1af88ecc 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/platform/i18n.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/platform/i18n.html @@ -98,7 +98,7 @@ translations are held to under The Three Bundles

    Each locale is a folder under the i18n directory holding one file per namespace plus an index file that re-exports them as a single object. The three folders carry identical file lists — the same -twenty-three namespaces, from apiErrors and auth through tree and widgets — because a +twenty-two namespaces, from apiErrors and auth through tree and widgets — because a namespace's keys are added to all three locales in the same change. Keys are named namespace.area.element in lowerCamelCase and are split by the UI region they serve rather than by the source file that reads them.

    @@ -332,7 +332,7 @@ and the re-title registration.
  • wwwroot-src/src/i18n/schema.ts — the English bundle as MessageSchema.
  • wwwroot-src/src/i18n/schema.d.ts — the ambient augmentation that registers that shape as vue-i18n's global message schema.
  • -
  • wwwroot-src/src/i18n/en/index.ts — the English bundle: the twenty-three namespaces assembled into +
  • wwwroot-src/src/i18n/en/index.ts — the English bundle: the twenty-two namespaces assembled into one object.
  • wwwroot-src/src/i18n/zh-Hant/index.ts and wwwroot-src/src/i18n/zh-Hans/index.ts — the same assembly, each annotated with MessageSchema.
  • diff --git a/App/wwwroot/HiAPI-docsite/anatomy/platform/session-state.html b/App/wwwroot/HiAPI-docsite/anatomy/platform/session-state.html index 6c026e7d..374b9bea 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/platform/session-state.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/platform/session-state.html @@ -212,7 +212,7 @@ not per browser: two browsers pointed at the same service read and write the sam machining project is server-side in the same way — one project is loaded at a time and every connected browser sees it, which is why the status-hub broadcast is what keeps a second tab honest.

    The URL carries the rest: the route, the ?tree= selection on the two Control-Tree pages, the browsed -path on the File Explorer route, and the tab segments on the Tool House and Controller routes. Those +path on the File Explorer route, and the tab segments on the Tool House route. Those come back on a reload from the address bar, and when a Control-Tree page is opened with no ?tree= the host lands on the stored last selection for that page, falling back to the page's root when the stored id is not in the current project's tree.

    @@ -286,13 +286,13 @@ focus starts a fresh burst immediately.

    Because pages are cached, navigating away does not close one, and whether the backend engine stops drawing for it depends on the host. The Execution, General Setup and Tool House pages hand their activation flag to the canvas's active prop, which pauses the engine while the page sits off-screen; -the Controller, Machine Tool and Mech Builder canvases and the File Explorer's STL preview bind no +the Machine Tool and Mech Builder canvases and the File Explorer's STL preview bind no such prop, and the Execution page's CWE canvas pins it true, so all of those keep rendering until something unmounts them. Collapsing a panel does close one, unless that panel keeps its content mounted: the Execution page's 3D canvas panel does, so it survives a collapse, while the CWE panel beside it does not and its canvas connection goes with it. -
  • The cleanup hub is opened once per Control-Tree host and once each on the Controller and Tool House -pages. Its composable also holds the set of IndexService keys that owner registered; on unmount it +
  • The cleanup hub is opened once per Control-Tree host and once on the Tool House page. Its composable +also holds the set of IndexService keys that owner registered; on unmount it posts a removal for every one of them and then stops the connection, so a teardown releases the server-side objects the page had indexed even if the hub never connected.
  • @@ -364,9 +364,8 @@ guard on the ?tree= sync, the landing selection, and the cleanup re and the panel that keeps the 3D canvas mounted through a collapse.
  • wwwroot-src/src/pages/GeneralSetupPage.vue — the same lifecycle for the equipment host.
  • wwwroot-src/src/pages/ToolHousePage.vue — the page that reloads its singleton explicitly on mount.
  • -
  • wwwroot-src/src/pages/ControllerPage.vue, wwwroot-src/src/pages/MachineToolPage.vue, -wwwroot-src/src/pages/MechBuilderPage.vue and wwwroot-src/src/components/StlPreviewPane.vue — -the canvases mounted with no active binding.
  • +
  • wwwroot-src/src/pages/MachineToolPage.vue, wwwroot-src/src/pages/MechBuilderPage.vue and +wwwroot-src/src/components/StlPreviewPane.vue — the canvases mounted with no active binding.
  • wwwroot-src/src/components/execution/StepVolumePanel.vue — the CWE canvas that pins active true and is stopped only by its own unmount.
  • wwwroot-src/src/pages/FileExplorerPage.vue — the route-leave guard that settles the editor buffer.
  • diff --git a/App/wwwroot/HiAPI-docsite/anatomy/platform/tree-ids-and-routes.html b/App/wwwroot/HiAPI-docsite/anatomy/platform/tree-ids-and-routes.html index c130fae5..33e38ee7 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/platform/tree-ids-and-routes.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/platform/tree-ids-and-routes.html @@ -133,11 +133,6 @@ is one of its children, so each renders inside the Main Panel's frame and menu b The machining chain on a canvas of its own, beside a left column that shows either a read-only identity panel or the chain's XML source — two states of one column, chosen with a GUI/XML toggle. A load button installs a chain file into the project. Carries no Page-menu entry and is reached by URL. -/controller/:tab? -controller -The superseded HardNcEnv controller surface. The optional segment mirrors the active tab. - - /tool-house/:toolId(\d+)?/:tab?/:subtab? tool-house The tool library and the per-tool editor. The three optional segments carry the selected tool and the two nested tab levels. @@ -170,9 +165,9 @@ is one of its children, so each renders inside the Main Panel's frame and menu b

    The menu bar's Page dropdown holds every one of these that is menu-reachable, in setup order: Tool -House, General Setup and Execution, then File Explorer and Mechanism Builder below a separator, -then the legacy Controller below a second one. The Log Viewer has a button of its own rather than a -menu entry, and /machine-tool has neither — it is reached by URL.

    +House, General Setup and Execution, then File Explorer and Mechanism Builder below a separator. The +Log Viewer has a button of its own rather than a menu entry, and /machine-tool has neither — it is +reached by URL.

    The Tool House route's tool segment is constrained to digits, but all three of its segments are optional, so a non-numeric segment in the tool position is not rejected: the router skips the tool parameter and reads that segment as the tab, which is what makes /tool-house/cutter a working tab @@ -193,6 +188,10 @@ moved into a Control Tree still lands on the editor.

    +/controller/:rest(.*)* +/general-setup?tree=equipment/controller — any trailing path is discarded, the retired Controller page's /<tab> segment included, so every form lands on the branch root. + + /spindle-capability/:tab? /general-setup?tree=equipment/spindle, with /<tab> appended when the segment is one of thermal, gear-shift, dry-run, power, torque. An unrecognised segment is dropped and the branch root is selected. @@ -321,8 +320,9 @@ expansion set still unfolds the branches it names;
  • as the first step of routeForTreeId, so the id-to-page resolver never sees an unmigrated id.
  • Note what the first rule implies: a bare ?tree=controller selects the equipment/controller -branch — the current controller editor on the General Setup page — and has nothing to do with the -/controller route, which is the separate legacy HardNcEnv surface.

    +branch — the controller editor on the General Setup page — and the redirect-only /controller path +above lands on the same branch, so a bookmark from the retired Controller page's era resolves in +either form.

    Landing an Id on Its Page

    TREE_PAGE_ROOTS lists the first segments that name a page: execution, equipment and toolhouse. spindle is absent on purpose — migration folds it into equipment/… before any root @@ -356,18 +356,18 @@ it, whereas the tool step is tested on its own, so a second segment that is not can carry is discarded either way — an id pointing at a single flute contour under …/cutter/contours/fluting/… lands on the nearest tab the URL can express. The same three name lists are imported by the page itself, so the tab set and the translation cannot drift apart.

    -

    Once on the page, the tab segments are kept in step with the tabs by useRouteTabs, the composable -the Controller route uses as well. It gives each tab level one route param, a valid-name set and a +

    Once on the page, the tab segments are kept in step with the tabs by useRouteTabs, a composable +whose only consumer this page is. It gives each tab level one route param, a valid-name set and a default; a nested level may declare which parent values make it apply, and while its parent is something else the level is dormant — its segment is dropped from the URL while its reference quietly remembers the last value, so returning to that parent tab returns to the sub-tab it had. The Tool House sub-tab level applies under cutter and holder only, and both its valid set and its default depend on which of the two is showing. A segment the level does not recognise resolves to that default rather than failing. Canonicalisation runs on the first mount and on every -keep-alive re-entry, which is why a bare /controller becomes /controller/coordinate-table and a -bare /tool-house acquires its tab segments. The tool segment is not one of the composable's -levels: the page fills it in itself, adopting the URL's tool when the project holds it and the first -tool in the list otherwise, then replacing the URL with what it adopted. That resolver reacts to the +keep-alive re-entry, which is why a bare /tool-house acquires its tab segments. The tool segment +is not one of the composable's levels: the page fills it in itself, adopting the URL's tool when the +project holds it and the first tool in the list otherwise, then replacing the URL with what it +adopted. That resolver reacts to the toolId param and to the tool list rather than to page activation, so it also re-points the URL when the list changes underneath it.

    The Tool House page never reads or writes ?tree=. A toolhouse/… id reaches it only by way of @@ -452,8 +452,8 @@ and the retitle hook registered with the i18n module. rawTreePathOfRoute, treePathOfRoute, the two selection/URL watchers and the unguarded controller-checkbox watcher beside them, landingSelection, applyRouteSelection and syncUrlBack, plus the build-time reveal of a URL-named CSV or CL controller node. -

  • wwwroot-src/src/composables/useRouteTabs.ts — the tab-to-param sync used by the Tool House and -Controller routes, including dormant levels and the keep-alive re-entry canonicalisation.
  • +
  • wwwroot-src/src/composables/useRouteTabs.ts — the tab-to-param sync the Tool House route uses, +including dormant levels and the keep-alive re-entry canonicalisation.
  • wwwroot-src/src/pages/ToolHousePage.vue — consumes the shared tab lists, resolves the tool from its path param, and navigates by route name when the tool changes.
  • wwwroot-src/src/pages/FileExplorerPage.vue — mirrors the browsed location into the route's diff --git a/App/wwwroot/HiAPI-docsite/anatomy/shell/main-panel.html b/App/wwwroot/HiAPI-docsite/anatomy/shell/main-panel.html index 9c0ace5e..7f8b3ec3 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/shell/main-panel.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/shell/main-panel.html @@ -125,10 +125,8 @@ Open Execution Page
  • File Explorer MenuItem (below a separator). See Util Pages.
  • Mechanism Builder MenuItem Open Mechanism Builder Page
  • -
  • Legacy-Controller MenuItem (below a separator) -Open Legacy Controller Page
  • -

    The dropdown is not every route the application has. The Machine Tool page stays reachable by URL for its chain-only canvas preview, the Log Viewer is reached by the Show Log button, and the Fixture, Workpiece, Spindle Capability, Mission and Background / Coolant paths resolve as redirects into the two tree pages.

    +

    The dropdown is not every route the application has. The Machine Tool page stays reachable by URL for its chain-only canvas preview, the Log Viewer is reached by the Show Log button, and the Fixture, Workpiece, Spindle Capability, Mission, Background / Coolant and legacy Controller paths resolve as redirects into the two tree pages.

  • Preference Menu Dropdown

  • @@ -205,7 +203,7 @@ watching for project changes itself.

    Source Code Path

    See HiNC App Anatomy for git repository links.

    diff --git a/App/wwwroot/HiAPI-docsite/anatomy/toc.html b/App/wwwroot/HiAPI-docsite/anatomy/toc.html index 1a8b15be..53e35232 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/toc.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/toc.html @@ -43,10 +43,7 @@ Utility Pages
  • - Legacy Controller (HardNcEnv) -
  • -
  • - Legacy Controller Settings + Legacy Controller Model (HardNcEnv)
  • By Source Directory diff --git a/App/wwwroot/HiAPI-docsite/anatomy/toc.json b/App/wwwroot/HiAPI-docsite/anatomy/toc.json index b3a2419d..4d0d56dd 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/toc.json +++ b/App/wwwroot/HiAPI-docsite/anatomy/toc.json @@ -1,2 +1,2 @@ -{"items":[{"name":"Overview","href":"index.html","topicHref":"index.html"},{"name":"Conventions","href":"conventions/index.html","tocHref":"conventions/toc.html","topicHref":"conventions/index.html","homepage":"conventions/index.html"},{"name":"Platform","href":"platform/index.html","tocHref":"platform/toc.html","topicHref":"platform/index.html","homepage":"platform/index.html"},{"name":"App Shell","href":"shell/index.html","tocHref":"shell/toc.html","topicHref":"shell/index.html","homepage":"shell/index.html"},{"name":"Widgets","href":"widget/index.html","tocHref":"widget/toc.html","topicHref":"widget/index.html","homepage":"widget/index.html"},{"name":"Geometry Panels","href":"geom/index.html","tocHref":"geom/toc.html","topicHref":"geom/index.html","homepage":"geom/index.html"},{"name":"Execution Page","href":"execution/index.html","tocHref":"execution/toc.html","topicHref":"execution/index.html","homepage":"execution/index.html"},{"name":"General Setup Page","href":"general-setup/index.html","tocHref":"general-setup/toc.html","topicHref":"general-setup/index.html","homepage":"general-setup/index.html"},{"name":"Tool House Page","href":"tool-house/index.html","tocHref":"tool-house/toc.html","topicHref":"tool-house/index.html","homepage":"tool-house/index.html"},{"name":"Utility Pages","href":"util/index.html","tocHref":"util/toc.html","topicHref":"util/index.html","homepage":"util/index.html"},{"name":"Legacy Controller (HardNcEnv)","href":"legacy-controller.html","topicHref":"legacy-controller.html"},{"name":"Legacy Controller Settings","href":"legacy-controller-settings.html","topicHref":"legacy-controller-settings.html"},{"name":"By Source Directory","href":"by-source/index.html","tocHref":"by-source/toc.html","topicHref":"by-source/index.html","homepage":"by-source/index.html"}]} +{"items":[{"name":"Overview","href":"index.html","topicHref":"index.html"},{"name":"Conventions","href":"conventions/index.html","tocHref":"conventions/toc.html","topicHref":"conventions/index.html","homepage":"conventions/index.html"},{"name":"Platform","href":"platform/index.html","tocHref":"platform/toc.html","topicHref":"platform/index.html","homepage":"platform/index.html"},{"name":"App Shell","href":"shell/index.html","tocHref":"shell/toc.html","topicHref":"shell/index.html","homepage":"shell/index.html"},{"name":"Widgets","href":"widget/index.html","tocHref":"widget/toc.html","topicHref":"widget/index.html","homepage":"widget/index.html"},{"name":"Geometry Panels","href":"geom/index.html","tocHref":"geom/toc.html","topicHref":"geom/index.html","homepage":"geom/index.html"},{"name":"Execution Page","href":"execution/index.html","tocHref":"execution/toc.html","topicHref":"execution/index.html","homepage":"execution/index.html"},{"name":"General Setup Page","href":"general-setup/index.html","tocHref":"general-setup/toc.html","topicHref":"general-setup/index.html","homepage":"general-setup/index.html"},{"name":"Tool House Page","href":"tool-house/index.html","tocHref":"tool-house/toc.html","topicHref":"tool-house/index.html","homepage":"tool-house/index.html"},{"name":"Utility Pages","href":"util/index.html","tocHref":"util/toc.html","topicHref":"util/index.html","homepage":"util/index.html"},{"name":"Legacy Controller Model (HardNcEnv)","href":"legacy-controller-settings.html","topicHref":"legacy-controller-settings.html"},{"name":"By Source Directory","href":"by-source/index.html","tocHref":"by-source/toc.html","topicHref":"by-source/index.html","homepage":"by-source/index.html"}]} diff --git a/App/wwwroot/HiAPI-docsite/anatomy/tool-house/cutter/freeform-remover-panel.html b/App/wwwroot/HiAPI-docsite/anatomy/tool-house/cutter/freeform-remover-panel.html index e3f74bef..3161604d 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/tool-house/cutter/freeform-remover-panel.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/tool-house/cutter/freeform-remover-panel.html @@ -88,7 +88,7 @@

    Freeform Remover Panel

    The key model is FreeformRemover: a cutter whose removal volume comes from two referenced geometries — a non-cutting strut and a cutting shaper — anchored to the holder buckle.

    -

    This cutter is offered in the Cutter Type selector and nowhere else. There is no Freeform Remover editor here and no freeform-remover endpoint in the backend, so nothing on this surface can create or change one — the shipped caption says as much, naming the WPF client and HiNcRcl.

    +

    This cutter is offered in the Cutter Type selector and nowhere else. There is no Freeform Remover editor here and no freeform-remover endpoint in the backend, so nothing on this surface can create or change one — the shipped caption says as much, and names HiNcRcl as the place to edit one.

    Layout

    Web Layout

      diff --git a/App/wwwroot/HiAPI-docsite/anatomy/tool-house/index.html b/App/wwwroot/HiAPI-docsite/anatomy/tool-house/index.html index fd2b0a54..2375ffe2 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/tool-house/index.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/tool-house/index.html @@ -211,7 +211,7 @@ The model UserService is the server-side Environments/UserSer
      Note

      The fluting type is named loosely on the wire, and every spelling resolves. PUT /{id}/fluting accepts UniformFluting / uniform and FreeFluting / free, and equally UniformContourTray / FreeContourTray. A Control-Tree id whose cutter branch reads …/contours/tray… resolves to the …/contours/fluting… node.

  • -

    One cutter type has no editor here, and the app says so where the type is chosen: the FreeformRemover. Selecting it keeps the existing model intact and shows a note — FreeformRemover editor is not yet available in the web frontend. Use the WPF client or HiNcRcl for now.

    +

    One cutter type has no editor here, and the app says so where the type is chosen: the FreeformRemover. Selecting it keeps the existing model intact and shows a note — No FreeformRemover editor here. The existing model is kept unchanged; edit one in HiNcRcl.

    Three smaller surfaces are absent for the same reason: the InsertCutter and FluteInnerBeam physics groups, and the CustomSpinningProfile shaper-profile type — the profile tab offers the five APT types (General / Ball / Column / Cone / Taper).

    See Also

    Where Neighbouring Editors Live

    Three editors a reader might expect here are shipped surfaces of other pages:

    diff --git a/App/wwwroot/HiAPI-docsite/anatomy/util/mech-builder.html b/App/wwwroot/HiAPI-docsite/anatomy/util/mech-builder.html index 2aa18c7b..b327a9e3 100644 --- a/App/wwwroot/HiAPI-docsite/anatomy/util/mech-builder.html +++ b/App/wwwroot/HiAPI-docsite/anatomy/util/mech-builder.html @@ -108,7 +108,7 @@
  • File Menu