config.html

<!-- G-code & grblHAL Reference - configuration + reference browser.
     ncSender shows this file in two places:
       1. Settings > Plugins > configure  (inside an iframe; the
          __TOOL_MENU_LABEL__ token below is NOT replaced there)
       2. Tools menu > "G-code Explorer" (or "G-code Navigator")  (as a dialog; the server
          replaces the token)
     The full UI - Reference, G-code, Explorer, NC Manual and Settings tabs
     (terminal-lookup options + About/sources) - lives in the shared
     core below; this wrapper only picks the default tab per context. -->

<!-- G-code Reference UI core. {"gcodes":[{"code":"G0","aliases":["G00"],"name":"Rapid Positioning","category":"motion","modal":"Motion Mode","desc":"Moves at the machine's maximum travel rate to the target position. Non-cutting move used to reposition quickly between operations. The F word is ignored; speed comes from $110-$115 max rates.","syntax":"G0 <axes>","params":{"X":"Target X coordinate","Y":"Target Y coordinate","Z":"Target Z coordinate","A":"Target A (rotary) coordinate","B":"Target B coordinate","C":"Target C coordinate"},"example":"G90 G0 X100 Y50","tips":"Retract Z to a safe height before rapid XY moves. Modal: stays active until another motion command (G1/G2/G3...) is issued.","keywords":["rapid","move","travel","position","fast","jog"]},{"code":"G1","aliases":["G01"],"name":"Linear Interpolation (Feed Move)","category":"motion","modal":"Motion Mode","desc":"Straight-line move at the programmed feed rate. The primary command for cutting and engraving. All specified axes move in a coordinated straight line.","syntax":"G1 <axes> F<feed>","params":{"X":"Target X coordinate","Y":"Target Y coordinate","Z":"Target Z coordinate","A":"Target A coordinate","B":"Target B coordinate","C":"Target C coordinate","F":"Feed rate (units/min in G94)"},"example":"G1 X200 F500","tips":"F is modal — once set it applies to all following feed moves. A feed rate must be active or the move errors out.","keywords":["linear","cut","feed","straight","line","mill","engrave"]},{"code":"G2","aliases":["G02"],"name":"Arc — Clockwise","category":"motion","modal":"Motion Mode","desc":"Clockwise circular arc at the current feed rate on the active plane (G17/G18/G19). Adding the off-plane axis produces helical motion. Defined by center offsets (I/J/K) or radius (R).","syntax":"G2 X- Y- (I- J- | R-) F-","params":{"X":"Arc end X","Y":"Arc end Y","Z":"Arc end Z (helical if off-plane)","I":"X offset from start point to arc center","J":"Y offset from start point to arc center","K":"Z offset from start point to arc center","R":"Arc radius (alternative to IJK)","P":"Number of full circles","F":"Feed rate"},"example":"G17 G2 X10 Y10 I10 J0 F200","tips":"IJK center-offset form is preferred — it is unambiguous. In R form, positive R gives the shorter (<180°) arc, negative R the longer one.","keywords":["arc","circle","clockwise","cw","helix","helical","radius","curve"]},{"code":"G3","aliases":["G03"],"name":"Arc — Counter-Clockwise","category":"motion","modal":"Motion Mode","desc":"Counter-clockwise circular arc at the current feed rate on the active plane. Otherwise identical to G2, including IJK/R forms and helical motion.","syntax":"G3 X- Y- (I- J- | R-) F-","params":{"X":"Arc end X","Y":"Arc end Y","Z":"Arc end Z (helical if off-plane)","I":"X offset to arc center","J":"Y offset to arc center","K":"Z offset to arc center","R":"Arc radius (alternative to IJK)","P":"Number of full circles","F":"Feed rate"},"example":"G3 X20 Y0 R10 F200","tips":"Direction is judged looking at the active plane from the positive side of its normal axis (for G17, looking down at XY).","keywords":["arc","circle","counterclockwise","ccw","helix","curve"]},{"code":"G4","aliases":["G04"],"name":"Dwell (Pause)","category":"motion","modal":null,"desc":"Pauses motion for a set time. Spindle, coolant and other outputs keep their current state. Useful for letting a spindle spin up or clearing chips at hole bottom.","syntax":"G4 P<seconds>","params":{"P":"Dwell time in seconds (decimals allowed)"},"example":"M3 S18000\nG4 P2  ; wait 2s for spindle spin-up","tips":"Non-modal — only affects its own block. Any queued motion completes before the pause begins.","keywords":["dwell","pause","wait","delay","sleep","timer"]},{"code":"G5","aliases":["G5.1"],"name":"Spline Interpolation","category":"motion","modal":"Motion Mode","desc":"Moves along a quadratic (G5) or cubic (G5.1) spline defined by control points, producing smoother free-form curves than arcs. Nearly always generated by CAM rather than written by hand.","syntax":"G5 X- Y- I- J- P- | G5.1 X- Y- I- J- K- L-","params":{"X":"Spline end X","Y":"Spline end Y","Z":"Spline end Z","I":"Control point offset","J":"Control point offset","K":"Control point (cubic)","L":"Control point (cubic)","P":"Second control point (G5)","F":"Feed rate"},"example":"G5 X20 Y10 I10 J15 F100","tips":"Elliptical arcs cannot be produced by combining splines with G51 scaling.","keywords":["spline","curve","bezier","smooth","nurbs"]},{"code":"G7","aliases":[],"name":"Lathe Diameter Mode","category":"modes","modal":"Lathe Mode","desc":"Lathe only ($32=2): X-axis values are interpreted as workpiece diameters. G1 X50 moves the tool to produce a 50-unit diameter.","syntax":"G7","params":{},"example":"G7\nG0 X20 Z0","tips":"Most lathe CAM outputs diameter mode. Machine coordinates always display as radius.","keywords":["lathe","diameter","turning"]},{"code":"G8","aliases":[],"name":"Lathe Radius Mode","category":"modes","modal":"Lathe Mode","desc":"Lathe only ($32=2): X-axis values are interpreted as radii. G1 X25 produces a 50-unit diameter.","syntax":"G8","params":{},"example":"G8\nG0 X25 Z0","tips":"Set G7 or G8 explicitly at the top of every lathe program.","keywords":["lathe","radius","turning"]},{"code":"G10 L2","aliases":["G10"],"name":"Set WCS Origin (Absolute)","category":"coords","modal":null,"desc":"Programmatically sets a work coordinate system origin relative to the machine origin. P selects the WCS (P1=G54 ... P9=G59.3). Values persist across resets.","syntax":"G10 L2 P<1-9> <axes>","params":{"L":"Data mode: 2 = absolute from machine zero","P":"WCS number: 1=G54, 2=G55 ... 9=G59.3","X":"New origin X (machine coords)","Y":"New origin Y","Z":"New origin Z"},"example":"G10 L2 P2 X100 Y250.5 Z-20  ; set G55 origin","tips":"Omitted axes are left unchanged. Great for repeatable multi-fixture setups.","keywords":["work offset","wcs","zero","origin","coordinate","fixture","g54","set zero"]},{"code":"G10 L20","aliases":[],"name":"Set WCS Origin (From Current Position)","category":"coords","modal":null,"desc":"Sets a work coordinate system origin so the machine's current position becomes the given coordinate. \"Make here X0 Y0\" — this is what most senders send when you click Zero.","syntax":"G10 L20 P<1-9> <axes>","params":{"L":"Data mode: 20 = relative to current position","P":"WCS number: 1=G54 ... 9=G59.3","X":"Value current X should read","Y":"Value current Y should read","Z":"Value current Z should read"},"example":"G10 L20 P1 X0 Y0  ; current spot becomes G54 X0 Y0","tips":"Preferred over G92 for zeroing — the offset is stored in the WCS and survives resets.","keywords":["zero","touch off","work offset","wcs","origin","set zero","xyz zero"]},{"code":"G17","aliases":[],"name":"XY Plane Select","category":"modes","modal":"Plane Select","desc":"Selects the XY plane for arcs, cutter compensation and canned cycles. Default on startup. Arcs use I (X offset) and J (Y offset).","syntax":"G17","params":{},"example":"G17\nG2 X10 Y15 I5 J0 F300","tips":"Set the plane explicitly at program start; arcs on the wrong plane move in surprising directions.","keywords":["plane","xy","arc plane"]},{"code":"G18","aliases":[],"name":"XZ Plane Select","category":"modes","modal":"Plane Select","desc":"Selects the XZ plane (lathes, side profiling). Arcs use I (X offset) and K (Z offset).","syntax":"G18","params":{},"example":"G18\nG3 X20 Z-5 I10 K0 F250","tips":null,"keywords":["plane","xz","lathe plane"]},{"code":"G19","aliases":[],"name":"YZ Plane Select","category":"modes","modal":"Plane Select","desc":"Selects the YZ plane. Arcs use J (Y offset) and K (Z offset).","syntax":"G19","params":{},"example":"G19\nG2 Y10 Z-2 J5 K0 F250","tips":null,"keywords":["plane","yz"]},{"code":"G20","aliases":[],"name":"Inch Units","category":"modes","modal":"Units","desc":"All coordinates, offsets and feed rates are interpreted as inches (feeds in inches/min).","syntax":"G20","params":{},"example":"G20\nG1 X4 F20","tips":"Put G20 or G21 at the top of every file — a 10 mm move read as 10 inches is a crash. Display units are separate ($13).","keywords":["inch","inches","imperial","units"]},{"code":"G21","aliases":[],"name":"Millimeter Units","category":"modes","modal":"Units","desc":"All coordinates, offsets and feed rates are interpreted as millimeters (feeds in mm/min).","syntax":"G21","params":{},"example":"G21\nG1 X100 F500","tips":"Interpreter units only — does not change steps/mm calibration ($100-$102) or the report units ($13).","keywords":["mm","millimeter","metric","units"]},{"code":"G28","aliases":[],"name":"Go to Stored Position 1","category":"coords","modal":null,"desc":"Rapid move to the position stored by G28.1 (in machine coordinates). With axis words, first moves through that intermediate point, then to the stored position.","syntax":"G28 [<axes>]","params":{"X":"Intermediate X before final move","Y":"Intermediate Y","Z":"Intermediate Z"},"example":"G53 G0 Z0\nG28  ; retract, then go to park position","tips":"DANGER: only use on a homed machine — the stored position is in machine coordinates. G28 Z0 lifts Z (in the current WCS) before traveling.","keywords":["park","home position","stored position","safe position","predefined"]},{"code":"G28.1","aliases":[],"name":"Store Position 1","category":"coords","modal":null,"desc":"Saves the machine's current absolute position as the G28 target. Persists across resets and power cycles.","syntax":"G28.1","params":{},"example":"G53 G0 X-50 Y-50 Z-5\nG28.1","tips":"Move with G53 first so the stored spot is independent of work offsets. Takes no axis words.","keywords":["store","save position","park","set park"]},{"code":"G30","aliases":[],"name":"Go to Stored Position 2","category":"coords","modal":null,"desc":"Same as G28 but uses the second stored position (set by G30.1). Commonly used for a tool-change or probing location.","syntax":"G30 [<axes>]","params":{"X":"Intermediate X","Y":"Intermediate Y","Z":"Intermediate Z"},"example":"G30","tips":"Only use on a homed machine.","keywords":["park","second position","tool change position","stored position"]},{"code":"G30.1","aliases":[],"name":"Store Position 2","category":"coords","modal":null,"desc":"Saves the current absolute machine position as the G30 target.","syntax":"G30.1","params":{},"example":"G53 G0 X-200 Y-400 Z-10\nG30.1","tips":null,"keywords":["store","save position","set park"]},{"code":"G53","aliases":[],"name":"Move in Machine Coordinates","category":"coords","modal":null,"desc":"For one block only, moves in the absolute machine coordinate system, ignoring all work offsets, G92 and tool offsets. Must be combined with G0 or G1.","syntax":"G53 G0 <axes> | G53 G1 <axes> F-","params":{"X":"Machine X target","Y":"Machine Y target","Z":"Machine Z target","F":"Feed rate (with G1)"},"example":"G53 G0 Z0  ; retract Z fully, regardless of offsets","tips":"G53 G0 Z0 is one of the safest moves in G-code — but only on a homed machine. Reverts to the active WCS on the next line.","keywords":["machine coordinates","absolute","retract","safe move","ignore offsets"]},{"code":"G54","aliases":["G55","G56","G57","G58","G59","G59.1","G59.2","G59.3"],"name":"Work Coordinate Systems","category":"coords","modal":"WCS","desc":"Selects one of nine work coordinate systems (G54-G59.3), each with its own user-set origin. Separates the program zero from machine home. G54 is the default.","syntax":"G54 | G55 | ... | G59.3","params":{},"example":"G54\n(run part 1)\nG55\n(run same file on fixture 2)","tips":"Origins are set with G10 L2/L20 or the Zero buttons and are stored persistently. G59.3 doubles as the tool change position in tool change modes 2 & 3.","keywords":["wcs","work coordinate","offset","g55","g56","g57","g58","g59","fixture","datum"]},{"code":"G92","aliases":[],"name":"Temporary Coordinate Offset","category":"coords","modal":"G92 Offset","desc":"Applies a volatile offset so the current position reads as the given values (\"you are now X0 Y0\"). Applied on top of the active WCS. Cleared by G92.1.","syntax":"G92 <axes>","params":{"X":"Value current X should read","Y":"Value current Y should read","Z":"Value current Z should read","A":"Value current A should read"},"example":"G92 X0 Y0 Z0","tips":"Easy to forget and a common crash cause — prefer G10 L20 with a spare WCS. $384 controls whether the offset persists across resets.","keywords":["offset","temporary zero","shift","coordinate offset"]},{"code":"G92.1","aliases":["G92.2","G92.3"],"name":"Clear / Suspend / Restore G92","category":"coords","modal":"G92 Offset","desc":"G92.1 clears the G92 offset (and zeroes the stored values). G92.2 suspends it without erasing. G92.3 re-applies a suspended offset.","syntax":"G92.1 | G92.2 | G92.3","params":{},"example":"G92.1  ; back to the plain G54 system","tips":null,"keywords":["clear offset","cancel g92","reset offset"]},{"code":"G38.2","aliases":[],"name":"Probe Toward (Error on Miss)","category":"probing","modal":null,"desc":"Moves toward the target until the probe input triggers, then stops and records the trigger position. Raises an error if the target is reached without contact.","syntax":"G38.2 <axes> F<feed>","params":{"X":"Probe travel limit X","Y":"Probe travel limit Y","Z":"Probe travel limit Z","F":"Probing feed rate"},"example":"G91 G38.2 Z-20 F100  ; probe down max 20mm","tips":"Probe fast to find the surface, back off, then re-probe slowly for accuracy. The trigger position is reported and stored in probe parameters (see $# output, PRB).","keywords":["probe","touch","toolsetter","surface","zero probe","touch plate","probing"]},{"code":"G38.3","aliases":[],"name":"Probe Toward (No Error on Miss)","category":"probing","modal":null,"desc":"Like G38.2, but completing the move without contact is not an error. Useful for checking whether something is present.","syntax":"G38.3 <axes> F<feed>","params":{"X":"Probe travel limit X","Y":"Probe travel limit Y","Z":"Probe travel limit Z","F":"Probing feed rate"},"example":"G38.3 Z-10 F150","tips":"Check the probe result flag in the report to see whether contact happened.","keywords":["probe","optional","check","detect","probing"]},{"code":"G38.4","aliases":[],"name":"Probe Away (Error on Fail)","category":"probing","modal":null,"desc":"Moves away until the probe input releases (loses contact). Errors if the probe starts un-triggered or never releases within the move.","syntax":"G38.4 <axes> F<feed>","params":{"X":"Travel limit X","Y":"Travel limit Y","Z":"Travel limit Z","F":"Probing feed rate"},"example":"G91 G38.4 Z5 F100","tips":null,"keywords":["probe away","release","retract probe","probing"]},{"code":"G38.5","aliases":[],"name":"Probe Away (No Error on Fail)","category":"probing","modal":null,"desc":"Like G38.4 but does not error if the probe never releases within the move.","syntax":"G38.5 <axes> F<feed>","params":{"X":"Travel limit X","Y":"Travel limit Y","Z":"Travel limit Z","F":"Probing feed rate"},"example":"G38.5 G91 Z50 F200","tips":null,"keywords":["probe away","optional","probing"]},{"code":"G40","aliases":[],"name":"Cancel Cutter Compensation","category":"tool","modal":"Cutter Comp","desc":"Disables cutter radius compensation. This is the default state; full G41/G42 compensation is not in the grblHAL core (plugin territory), so G40 mainly guarantees a known state.","syntax":"G40","params":{},"example":"G40","tips":"Include in your safety preamble: G90 G21 G17 G40 G49 G80 G94.","keywords":["cutter compensation","comp","cancel","g41","g42"]},{"code":"G43.1","aliases":[],"name":"Dynamic Tool Length Offset","category":"tool","modal":"Tool Length Offset","desc":"Applies a tool length offset given directly in the command (usually Z). Typically issued after probing a new tool to shift the Z origin by the measured length difference.","syntax":"G43.1 Z<offset>","params":{"Z":"Offset to apply to Z","A":"Offset for A","B":"Offset for B"},"example":"G43.1 Z5.2  ; tool is 5.2mm longer than reference","tips":"Cancel with G49 before tool changes and at program end.","keywords":["tool length","tlo","offset","tool offset","length compensation"]},{"code":"G43","aliases":["G43.2"],"name":"Tool Length Offset from Tool Table","category":"tool","modal":"Tool Length Offset","desc":"With a tool table enabled, G43 H<n> applies the stored Z-length offset for tool n. G43.2 adds a second, stacked offset.","syntax":"G43 H<tool> | G43.2 <axes>","params":{"H":"Tool table entry whose offset to apply","Z":"Additional offset (G43.2)"},"example":"T1 M6\nG43 H1","tips":"H should normally match the active tool number.","keywords":["tool table","tool length","h word","offset"]},{"code":"G49","aliases":[],"name":"Cancel Tool Length Offset","category":"tool","modal":"Tool Length Offset","desc":"Removes any active tool length offset.","syntax":"G49","params":{},"example":"G49\nM6 T2","tips":"Issue before M6 and at program end.","keywords":["cancel","tool length","clear offset"]},{"code":"G50","aliases":[],"name":"Cancel Scaling","category":"modes","modal":"Scaling","desc":"Disables G51 coordinate scaling, restoring 1:1 motion. Default state.","syntax":"G50","params":{},"example":"G50","tips":"On lathes in G96 mode, G50 S<rpm> also sets the max spindle RPM cap (Mach3 style).","keywords":["scaling","cancel scale","unscale"]},{"code":"G51","aliases":[],"name":"Coordinate Scaling / Mirroring","category":"modes","modal":"Scaling","desc":"Scales subsequent motion per-axis. A factor of -1 mirrors that axis. Lets you resize or flip a program without editing it.","syntax":"G51 X<f> Y<f> Z<f>","params":{"X":"X scale factor (-1 mirrors)","Y":"Y scale factor","Z":"Z scale factor"},"example":"G51 X0.5 Y0.5 Z0.5\n(half-size part)\nG50","tips":"Unequal XY factors are not allowed with G2/G3 (no elliptical arcs). Always cancel with G50.","keywords":["scale","mirror","flip","resize"]},{"code":"G81","aliases":[],"name":"Drilling Cycle","category":"cycles","modal":"Motion Mode","desc":"Simple drill cycle: rapid to R plane, feed to Z depth, rapid retract. Once active, every new XY position drills a hole until G80 cancels.","syntax":"G81 Z<depth> R<retract> F<feed>","params":{"Z":"Final hole depth","R":"Retract plane (Z height to rapid to before feeding)","F":"Drilling feed rate","L":"Optional repeat count"},"example":"G99 G81 Z-10 R2 F150\nX10 Y10\nX20\nG80","tips":"Retract height between holes is controlled by G98 (initial Z) / G99 (R plane).","keywords":["drill","hole","canned cycle","drilling"]},{"code":"G82","aliases":[],"name":"Drilling Cycle with Dwell","category":"cycles","modal":"Motion Mode","desc":"Like G81 but dwells at the bottom of the hole for P seconds — improves hole-bottom finish (spot drilling, countersinking).","syntax":"G82 Z- R- P<sec> F-","params":{"Z":"Final depth","R":"Retract plane","P":"Dwell at bottom (seconds)","F":"Feed rate"},"example":"G82 Z-3 R2 P0.5 F100","tips":null,"keywords":["drill","dwell","spot","countersink","canned cycle"]},{"code":"G83","aliases":[],"name":"Peck Drilling (Full Retract)","category":"cycles","modal":"Motion Mode","desc":"Deep-hole peck drilling: after each peck of depth Q, the drill fully retracts out of the hole to clear chips, then returns.","syntax":"G83 Z- R- Q<peck> F-","params":{"Z":"Final depth","R":"Retract plane","Q":"Depth of each peck","F":"Feed rate"},"example":"G83 Z-25 R2 Q5 F120","tips":"Use for holes deeper than ~3x drill diameter.","keywords":["peck","deep hole","drill","chip clearing","canned cycle"]},{"code":"G73","aliases":[],"name":"Peck Drilling (Chip Break)","category":"cycles","modal":"Motion Mode","desc":"High-speed peck cycle: after each peck of depth Q, retracts a small fixed amount ($28) to snap the chip without leaving the hole.","syntax":"G73 Z- R- Q<peck> F-","params":{"Z":"Final depth","R":"Retract plane","Q":"Depth of each peck","F":"Feed rate"},"example":"G73 Z-15 R2 Q4 F150","tips":"Retract amount per peck comes from setting $28.","keywords":["peck","chip break","drill","canned cycle"]},{"code":"G85","aliases":[],"name":"Boring Cycle (Feed Out)","category":"cycles","modal":"Motion Mode","desc":"Feeds to depth and feeds back out — no rapid retract inside the hole, leaving a better surface finish (reaming/boring).","syntax":"G85 Z- R- F-","params":{"Z":"Final depth","R":"Retract plane","F":"Feed rate (both directions)"},"example":"G85 Z-12 R2 F80","tips":null,"keywords":["bore","ream","finish","canned cycle"]},{"code":"G86","aliases":[],"name":"Boring Cycle (Spindle Stop)","category":"cycles","modal":"Motion Mode","desc":"Feeds to depth, stops the spindle, then rapids out.","syntax":"G86 Z- R- F-","params":{"Z":"Final depth","R":"Retract plane","F":"Feed rate"},"example":"G86 Z-12 R2 F80","tips":null,"keywords":["bore","canned cycle"]},{"code":"G89","aliases":[],"name":"Boring Cycle with Dwell","category":"cycles","modal":"Motion Mode","desc":"Feeds to depth, dwells P seconds, feeds back out.","syntax":"G89 Z- R- P<sec> F-","params":{"Z":"Final depth","R":"Retract plane","P":"Dwell (seconds)","F":"Feed rate"},"example":"G89 Z-10 R2 P1 F80","tips":null,"keywords":["bore","dwell","canned cycle"]},{"code":"G76","aliases":[],"name":"Threading Cycle (Lathe)","category":"cycles","modal":"Motion Mode","desc":"Multi-pass lathe threading cycle. Requires a spindle encoder for spindle-synchronized motion; only a few grblHAL boards support the hardware.","syntax":"G76 Z- R- I- J- K- L- P- Q- F-","params":{"Z":"Thread end","P":"Thread pitch","I":"Thread peak offset","J":"Initial cut depth","K":"Full thread depth","Q":"Compound slide angle","L":"Taper mode","R":"Depth regression","F":"Feed"},"example":"(lathe threading — see grblHAL docs)","tips":"Related: G33 spindle-synchronized motion, also encoder-dependent.","keywords":["thread","threading","lathe","tap"]},{"code":"G80","aliases":[],"name":"Cancel Canned Cycle","category":"cycles","modal":"Motion Mode","desc":"Immediately ends any active canned cycle so later coordinates are not interpreted as more holes. Critical safety command after cycle blocks.","syntax":"G80","params":{},"example":"G81 Z-10 R2 F100\nX10\nX20\nG80","tips":"Any new motion command (G0/G1/G2/G3) also cancels an active cycle.","keywords":["cancel","canned cycle","end cycle"]},{"code":"G98","aliases":[],"name":"Cycle Retract to Initial Z","category":"cycles","modal":"Cycle Return","desc":"Between canned-cycle holes, retract all the way to the Z height held before the cycle started. Safest mode — clears clamps between holes.","syntax":"G98","params":{},"example":"G0 Z20\nG98 G81 Z-5 R2 F100","tips":null,"keywords":["retract","initial","canned cycle","return"]},{"code":"G99","aliases":[],"name":"Cycle Retract to R Plane","category":"cycles","modal":"Cycle Return","desc":"Between holes, retract only to the R plane. Faster on flat unobstructed surfaces.","syntax":"G99","params":{},"example":"G99 G81 Z-5 R2 F100","tips":null,"keywords":["retract","r plane","canned cycle","return"]},{"code":"G90","aliases":[],"name":"Absolute Distance Mode","category":"modes","modal":"Distance Mode","desc":"Coordinates are destinations measured from the active WCS origin. X10 means \"go to the X=10 line\". Default mode; what most CAM output uses.","syntax":"G90","params":{},"example":"G90\nG0 X10 Y20","tips":null,"keywords":["absolute","distance mode","positioning"]},{"code":"G91","aliases":[],"name":"Incremental Distance Mode","category":"modes","modal":"Distance Mode","desc":"Coordinates are distances from the current position. X10 means \"move +10 in X from here\". Ideal for macros and probing routines that must work anywhere.","syntax":"G91","params":{},"example":"G91\nG1 X50 F300\nG1 Y30","tips":"Forgetting to switch back to G90 is a classic crash. In G91, arc IJK offsets are still measured from the arc start point.","keywords":["incremental","relative","distance mode"]},{"code":"G93","aliases":[],"name":"Inverse Time Feed Mode","category":"modes","modal":"Feed Mode","desc":"F means 1/minutes: the move must complete in 1/F minutes. Used mainly for simultaneous multi-axis (4/5-axis) motion where tool-tip speed is complex.","syntax":"G93","params":{"F":"Move completes in 1/F minutes"},"example":"G93\nG1 X10 A90 F2  ; complete in 30 seconds","tips":"F must be given on every motion line in G93.","keywords":["inverse time","feed mode","5 axis","rotary feed"]},{"code":"G94","aliases":[],"name":"Units per Minute Feed Mode","category":"modes","modal":"Feed Mode","desc":"F is linear units (mm or inch) per minute. Standard for mills and routers; the default.","syntax":"G94","params":{"F":"Feed in units/min"},"example":"G94\nG1 X100 F500","tips":null,"keywords":["feed mode","units per minute","mm/min"]},{"code":"G95","aliases":[],"name":"Units per Revolution Feed Mode","category":"modes","modal":"Feed Mode","desc":"F is units per spindle revolution — the lathe standard, tying chip load directly to RPM. Needs spindle speed feedback.","syntax":"G95","params":{"F":"Feed in units/rev"},"example":"G95\nS1000 M3\nG1 Z-50 F0.2  ; effective 200mm/min","tips":null,"keywords":["feed per rev","lathe feed","units per revolution"]},{"code":"G96","aliases":[],"name":"Constant Surface Speed (Lathe)","category":"modes","modal":"Spindle Mode","desc":"S is a surface speed; the controller varies spindle RPM with the X diameter to hold it constant at the cutting edge. Lathe builds only.","syntax":"G96 S<surface speed> [D<max rpm>]","params":{"S":"Target surface speed (m/min or ft/min)","D":"Max RPM cap"},"example":"G50 S4000\nG96 S150 M3","tips":"Always cap RPM (G50 S / D word) — RPM rises sharply as diameter shrinks.","keywords":["css","surface speed","lathe","constant speed"]},{"code":"G97","aliases":[],"name":"Constant RPM Mode","category":"modes","modal":"Spindle Mode","desc":"S is plain revolutions per minute. Default; required for drilling, tapping and threading.","syntax":"G97 S<rpm>","params":{"S":"Spindle RPM"},"example":"G97 S800 M3","tips":null,"keywords":["rpm","spindle mode","constant rpm"]},{"code":"G61","aliases":["G61.1"],"name":"Exact Stop Path Mode","category":"modes","modal":"Path Control","desc":"Machine fully stops at the end of each move before starting the next — perfectly sharp corners at the cost of speed and smoothness.","syntax":"G61","params":{},"example":"G61\n(precise engraving moves)","tips":"Can leave witness marks/divots at corners due to the momentary stop. Continuous blending is the usual default.","keywords":["exact stop","path control","corners","sharp"]},{"code":"G65","aliases":[],"name":"Macro Call with Arguments","category":"program","modal":null,"desc":"Calls a macro (P<n>.macro on SD/LittleFS) and passes letter arguments as local variables. Requires NGC expressions enabled in the firmware. P1-P7 are reserved built-ins (settings read/write, tool offsets, machine state, probe select, spindle delay skip, Modbus messaging).","syntax":"G65 P<number> [L<repeat>] [A- B- C- ...]","params":{"P":"Macro number: P100+ user macros; P1-P7 built-ins","L":"Repeat count","A":"Argument (becomes #1)","B":"Argument (#2)","C":"Argument (#3)","Q":"Argument (built-ins: setting/tool/probe number)","R":"Argument (built-ins: register/axis)","S":"Argument (built-ins: value/slave address)","I":"Argument (P3: parameter number)","F":"Argument (P7: Modbus function code)"},"example":"G65 P100 A5.0 B200  ; call P100.macro with args\nG65 P1 Q110  ; built-in: read setting $110 into _value","tips":"Notable built-ins: P1 read/write settings, P4 machine state, P5 select probe input (0 probe, 1 toolsetter), P7 Modbus (talk to a VFD from G-code). Nesting G65 is not allowed.","keywords":["macro","subprogram","call","arguments","modbus","vfd","expression","p100"]},{"code":"G66","aliases":["G67"],"name":"Modal Macro Call / Cancel","category":"program","modal":"Modal Macro","desc":"G66 works like G65 but repeats the macro after every subsequent motion command until G67 cancels it — handy for custom drilling or probing cycles at many locations.","syntax":"G66 P<number> [args] ... G67","params":{"P":"Macro number","L":"Repeat count"},"example":"G66 P110 A2\nX10 Y10\nX20\nG67","tips":null,"keywords":["modal macro","repeat","custom cycle"]},{"code":"M0","aliases":["M00"],"name":"Program Stop","category":"program","modal":null,"desc":"Unconditionally pauses the program — motion, spindle and coolant stop. Cycle Start resumes from the next line. An optional (message) shows in the sender.","syntax":"M0 [(message)]","params":{},"example":"G0 Z20\nM0 (Clear chips, then press start)","tips":"Manual tool change setups often transform M6 into M0 with a message.","keywords":["stop","pause","hold","wait","operator"]},{"code":"M1","aliases":["M01"],"name":"Optional Stop","category":"program","modal":null,"desc":"Pauses like M0, but only when the Optional Stop switch is enabled in the sender/machine; ignored otherwise. Good for inspection points you don't need every run.","syntax":"M1 [(message)]","params":{},"example":"(finishing pass)\nM1","tips":null,"keywords":["optional stop","pause","inspection"]},{"code":"M2","aliases":["M02"],"name":"Program End","category":"program","modal":null,"desc":"Ends the program, resets the parser to defaults and leaves the machine idle.","syntax":"M2","params":{},"example":"M5\nM2","tips":null,"keywords":["end","program end","finish"]},{"code":"M30","aliases":[],"name":"Program End & Rewind","category":"program","modal":null,"desc":"The standard end-of-file: does everything M2 does and rewinds to the start, ready for the next part.","syntax":"M30","params":{},"example":"G0 Z20\nM5 M9\nM30","tips":"When running from SD card, $FR before start enables rewind-and-rerun on cycle start.","keywords":["end","rewind","program end","m30"]},{"code":"M3","aliases":["M03"],"name":"Spindle On — Clockwise","category":"spindle","modal":"Spindle","desc":"Starts the spindle clockwise at the last programmed S speed. In laser mode ($32=1), fires the laser at constant power while moving.","syntax":"M3 S<rpm>","params":{"S":"Spindle speed (RPM) or laser power"},"example":"S18000 M3","tips":"With spindle-at-speed enabled ($340 tolerance) the controller waits for the VFD to reach speed. For laser engraving prefer M4 dynamic power.","keywords":["spindle","on","clockwise","cw","start spindle","laser on"]},{"code":"M4","aliases":["M04"],"name":"Spindle On — CCW / Laser Dynamic","category":"spindle","modal":"Spindle","desc":"Starts the spindle counter-clockwise (left-hand tools). In laser mode ($32=1), enables dynamic power: output scales with actual velocity so accel/decel zones don't burn darker.","syntax":"M4 S<rpm>","params":{"S":"Spindle speed (RPM) or max laser power"},"example":"M4 S800  ; laser dynamic mode","tips":"This is the mode LightBurn's grbl profiles use for engraving.","keywords":["spindle","ccw","counterclockwise","laser","dynamic power","variable power"]},{"code":"M5","aliases":["M05"],"name":"Spindle / Laser Off","category":"spindle","modal":"Spindle","desc":"Stops spindle rotation (or laser output).","syntax":"M5","params":{},"example":"M5","tips":"$394 sets a spin-down delay so motion waits for the spindle to actually stop.","keywords":["spindle off","stop","laser off"]},{"code":"M6","aliases":["M06"],"name":"Tool Change","category":"tool","modal":null,"desc":"Executes a tool change to the tool selected by T. With an ATC, runs the tool change macro (tc.macro / P200.macro for RapidChange). Without one, behavior follows $341: pause like M0, move to a change position, and/or run the manual probe protocol ($TPW).","syntax":"T<n> M6 | M6 T<n>","params":{"T":"Tool number to load"},"example":"T2 M6\nG43 H2","tips":"T only selects; M6 performs the change. Apply the new length offset (G43/G43.1) afterward. See $341-$346 for tool change configuration.","keywords":["tool change","atc","change tool","m6","rapidchange","toolchange"]},{"code":"M7","aliases":["M07"],"name":"Mist Coolant On","category":"coolant","modal":"Coolant","desc":"Turns on the mist coolant output pin (air/oil mist). Often repurposed for an air blast or accessory relay.","syntax":"M7","params":{},"example":"M7","tips":null,"keywords":["mist","coolant","air","output"]},{"code":"M8","aliases":["M08"],"name":"Flood Coolant On","category":"coolant","modal":"Coolant","desc":"Turns on the flood coolant output pin — the primary coolant output. Commonly repurposed for dust collection or a dust boot.","syntax":"M8","params":{},"example":"M8\nG1 Z-5 F300","tips":null,"keywords":["flood","coolant","dust boot","dust collection","output"]},{"code":"M9","aliases":["M09"],"name":"All Coolant Off","category":"coolant","modal":"Coolant","desc":"Turns off both mist (M7) and flood (M8) outputs.","syntax":"M9","params":{},"example":"G0 Z20\nM9","tips":null,"keywords":["coolant off","mist off","flood off"]},{"code":"M48","aliases":[],"name":"Enable Overrides","category":"program","modal":"Override","desc":"Re-enables the real-time feed, rapid and spindle override controls (the default).","syntax":"M48","params":{},"example":"M48","tips":null,"keywords":["override","enable","feed override"]},{"code":"M49","aliases":[],"name":"Disable Overrides","category":"program","modal":"Override","desc":"Ignores all override controls; the program runs at exactly 100% of programmed feed, rapid and spindle values.","syntax":"M49","params":{},"example":"M49\nG1 X100 F150\nM48","tips":"Use sparingly — it removes the operator's ability to slow a bad cut.","keywords":["override","disable","lock feed"]},{"code":"M50","aliases":["M51","M53"],"name":"Selective Override Control","category":"program","modal":null,"desc":"Granular override disabling: M50 feed override off, M51 spindle override off, M53 rapid override off. M48 re-enables all.","syntax":"M50 | M51 | M53","params":{},"example":"M50 M51\n(critical finishing pass)\nM48","tips":null,"keywords":["override","feed","spindle","rapid","selective"]},{"code":"M56","aliases":[],"name":"Parking Motion Override","category":"program","modal":null,"desc":"Enables (P1) or disables (P0) automatic parking motion. Requires parking support plus this override option compiled into the firmware.","syntax":"M56 P<0|1>","params":{"P":"1 = enable parking motion, 0 = disable"},"example":"M56 P0\n(critical moves)\nM56 P1","tips":null,"keywords":["parking","park","override"]},{"code":"M61","aliases":[],"name":"Set Current Tool","category":"tool","modal":null,"desc":"Tells the controller which tool is currently loaded (Q word) without performing a change — used to sync state after manual swaps.","syntax":"M61 Q<tool>","params":{"Q":"Tool number now in the spindle"},"example":"M61 Q3","tips":null,"keywords":["set tool","current tool","sync tool"]},{"code":"M62","aliases":["M63"],"name":"Digital Output — Synced","category":"io","modal":null,"desc":"Queues a digital output change (M62 on, M63 off) to fire at the exact start of the next motion command. Ideal for laser gating, cameras, or anything that must align with motion.","syntax":"M62 P<port> | M63 P<port>","params":{"P":"Digital output port number"},"example":"M62 P1\nG1 X20 F500  ; output 1 goes high as this move starts\nM63 P1\nG0 X30","tips":"On the plasma/THC plugin these same codes toggle torch height control.","keywords":["digital output","synchronized","io","laser gate","output on","output off"]},{"code":"M64","aliases":["M65"],"name":"Digital Output — Immediate","category":"io","modal":null,"desc":"Sets a digital output high (M64) or low (M65) immediately when read, without waiting for motion.","syntax":"M64 P<port> | M65 P<port>","params":{"P":"Digital output port number"},"example":"M400\nM64 P1  ; trigger once fully stopped","tips":"Use $pins / $pinstate in the terminal to see which aux ports exist and their live state.","keywords":["digital output","immediate","io","relay","aux output"]},{"code":"M66","aliases":[],"name":"Wait for Input","category":"io","modal":null,"desc":"Pauses execution until a digital input reaches the requested state, or a timeout expires. Requires configured aux inputs.","syntax":"M66 P<port> L<0|1> [Q<timeout s>]","params":{"P":"Digital input port number","L":"State to wait for: 0 low, 1 high","Q":"Timeout in seconds (error if exceeded)"},"example":"M66 P2 L1 Q10  ; wait up to 10s for input 2 high","tips":null,"keywords":["wait","input","sensor","io","interlock"]},{"code":"M67","aliases":["M68"],"name":"Analog Output","category":"io","modal":null,"desc":"Sets an analog output value — M67 synchronized with the next motion, M68 immediately. Used for laser power ramps, flow control, etc.","syntax":"M67 P<port> Q<value> | M68 P<port> Q<value>","params":{"P":"Analog output port number","Q":"Target analog value (range depends on DAC/PWM resolution)","E":"Port (plasma plugin velocity-reduction variant)"},"example":"M67 P0 Q150\nG1 X20 F500","tips":null,"keywords":["analog output","pwm","dac","laser power","io"]},{"code":"M70","aliases":["M71","M72","M73"],"name":"Modal State Save/Restore","category":"program","modal":null,"desc":"Saves (M70) and restores (M72) the full modal state — active G modes, feed, spindle speed — so macros can change modes freely without disturbing the main program. M71 invalidates a saved state; M73 saves with auto-restore for subprograms.","syntax":"M70 ... M72","params":{},"example":"M70\nG91 G1 F100\n(probe moves)\nM72","tips":"Wrap any probing or tool change macro in M70/M72 — cheap insurance against leaving the machine in G91.","keywords":["save state","restore","modal","macro safety"]},{"code":"M98","aliases":[],"name":"Subroutine Call","category":"program","modal":null,"desc":"Calls a subroutine: with $700=1 it first looks for an O<n> sub label in the current file, otherwise (or if not found) runs external file P<n> from SD/LittleFS. L repeats the call.","syntax":"M98 P<number> [L<repeat>]","params":{"P":"Subroutine number or filename","L":"Repeat count"},"example":"M98 P100 L3\nM30\nO100 sub\nG91 G0 X10\nM99","tips":null,"keywords":["subroutine","call","subprogram","repeat"]},{"code":"M99","aliases":[],"name":"Return from Subroutine","category":"program","modal":null,"desc":"Ends a subroutine and returns to the line after the call. In a main program it acts as rewind-and-loop. Also terminates tool change macros.","syntax":"M99","params":{"P":"Optional return line (implementation-dependent)"},"example":"M99","tips":null,"keywords":["return","subroutine","end macro"]},{"code":"M42","aliases":[],"name":"Set Digital Output (OpenPNP)","category":"plugin","modal":null,"desc":"OpenPNP plugin: directly sets a digital I/O port state.","syntax":"M42 P<port> S<0|1>","params":{"P":"I/O port number","S":"0 = off, 1 = on"},"example":"M42 P1 S1","tips":null,"keywords":["digital output","openpnp","io","relay"]},{"code":"M104","aliases":[],"name":"Select Spindle","category":"plugin","modal":null,"desc":"Spindle plugin: selects which configured spindle (VFD, PWM, laser...) subsequent S/M3/M4 commands address. Essential on dual-spindle setups.","syntax":"M104 P<spindle>","params":{"P":"Spindle number (see $SPINDLES for the list)"},"example":"M104 P1  ; switch to spindle 1 (e.g. PWM laser)","tips":"Run $SPINDLES in the terminal to enumerate configured spindles and their numbers.","keywords":["spindle select","dual spindle","laser","vfd","switch spindle","multi spindle"]},{"code":"M106","aliases":["M107"],"name":"Fan Control","category":"plugin","modal":null,"desc":"Fan plugin: M106 turns a fan on with PWM speed 0-255; M107 turns it off.","syntax":"M106 P<fan> S<0-255> | M107 P<fan>","params":{"P":"Fan index","S":"PWM duty 0-255"},"example":"M106 P0 S255","tips":null,"keywords":["fan","cooling","pwm"]},{"code":"M114","aliases":[],"name":"Report Position (Encoder)","category":"plugin","modal":null,"desc":"Encoder plugin: reports current position, including spindle encoder data when available.","syntax":"M114","params":{},"example":"M114","tips":null,"keywords":["position","report","encoder"]},{"code":"M122","aliases":[],"name":"Trinamic Driver Report","category":"plugin","modal":null,"desc":"Motor plugin: dumps Trinamic stepper driver status/debug info for the given axes.","syntax":"M122 [axes]","params":{"X":"Report X driver","Y":"Report Y driver","Z":"Report Z driver"},"example":"M122","tips":"Related: M906 set RMS current, M569 StealthChop/SpreadCycle, M911/M912 prewarn flags, M913 hybrid threshold, M914 homing sensitivity.","keywords":["trinamic","stepper","driver","debug","tmc"]},{"code":"M150","aliases":[],"name":"RGB LED Control","category":"plugin","modal":null,"desc":"Misc plugin: sets color and brightness for an RGB/RGBW LED strip or a single LED by index. Used for status lighting on machines with LED rails/rings.","syntax":"M150 [R<0-255>] [U<0-255>] [B<0-255>] [W<0-255>] [P<0-255>] [I<index>] [S<strip>] [K]","params":{"R":"Red 0-255","U":"Green 0-255","B":"Blue 0-255","W":"White 0-255","P":"Brightness 0-255","I":"LED index for individual control","S":"Strip index (0 or 1)","K":"Keep unspecified components unchanged"},"example":"M150 R255 U0 B0 S1  ; strip 1 solid red\nM150 R0 U0 B0 S1    ; off","tips":"Note green is U, not G (G would parse as a G-code).","keywords":["led","rgb","light","strip","neopixel","status light"]},{"code":"M220","aliases":[],"name":"Set Feed Override %","category":"plugin","modal":null,"desc":"Sets the feed override percentage from G-code (Marlin heritage). B backs up the current value, R restores it, S sets a percentage.","syntax":"M220 [S<percent>] [B] [R]","params":{"S":"Feed override percent (100 = programmed feed)","B":"Backup current override","R":"Restore backed-up override"},"example":"M220 S50\n(difficult section)\nM220 S100","tips":null,"keywords":["feed override","percent","slow down","speed"]},{"code":"M280","aliases":[],"name":"Set Servo Position","category":"plugin","modal":null,"desc":"Servo plugin: moves a PWM servo to a position — typically 0-180 degrees. Used for probe deployers, dust shoes, clamps.","syntax":"M280 P<servo> S<position>","params":{"P":"Servo index","S":"Target position (deg or µs)"},"example":"M280 P0 S90  ; deploy\nM280 P0 S0   ; stow","tips":null,"keywords":["servo","deploy","position","pwm"]},{"code":"M400","aliases":[],"name":"Finish Moves","category":"plugin","modal":null,"desc":"Waits for the planner buffer to fully empty before the next command — the machine is completely stationary. Roughly a G4 P0.","syntax":"M400","params":{},"example":"G0 X50 Y50\nM400\nM64 P1","tips":null,"keywords":["wait","finish","buffer","sync"]},{"code":"M810","aliases":[],"name":"ATCi Keepout Zone Toggle (Sienci)","category":"plugin","modal":null,"desc":"Sienci ATCi plugin: runtime toggle for keepout-zone enforcement around the tool magazine. P1 enables protection, P0 disables it.","syntax":"M810 P<0|1>","params":{"P":"1 = enforce keepout zone, 0 = disable"},"example":"M810 P0","tips":null,"keywords":["sienci","atc","atci","keepout","magazine"]},{"code":"$TLS","aliases":[],"name":"Tool Length Set (ATC/MTC plugins)","category":"plugin","modal":null,"desc":"Runs the tool length setter probe cycle for the currently loaded tool: raises to safe Z, rapids to the configured TLS position, probes down (G38.2), applies the measured tool length offset, and retracts. Provided by the Rapid Change ATC, Manual Tool Changer, and Pneumatic ATC plugins - the exact motions come from that plugin's settings, including any Pre/Post TLS g-code hooks.","syntax":"$TLS","params":{},"example":"$TLS","tips":"Only works when one of the tool-changer plugins is installed and enabled. The macro expansion can be shown line by line by enabling \"show macro commands\" in the plugin settings.","keywords":["tool length","tls","tool setter","probe tool","rapidchange","atc","tool changer","offset"]},{"code":"$SLOT1","aliases":["$SLOT2","$SLOT<n>"],"name":"Go To Tool Slot n (Rapid Change ATC)","category":"plugin","modal":null,"desc":"Raises to safe Z, then rapids (G53 machine coordinates) to the XY position of magazine slot n as configured in the Rapid Change ATC plugin. $SLOT1, $slot2, $SLOT03 all work - leading zeros are tolerated. Slot numbers outside the configured pocket count are deliberately left alone (they fall through to the controller as unknown commands) so a typo cannot send the spindle to a nonexistent slot.","syntax":"$SLOT<n>","params":{},"example":"$SLOT3","tips":"Provided by the Rapid Change ATC plugin - only works when it is installed and enabled. Useful for aligning the magazine or verifying slot positions without a tool change.","keywords":["slot","pocket","magazine","rapidchange","atc","tool changer","position"]},{"code":"$POCKET1","aliases":[],"name":"Go To Pocket 1 (Manual Tool Changer)","category":"plugin","modal":null,"desc":"Raises to safe Z, then rapids (G53 machine coordinates) to the Pocket 1 XY position configured in the Manual Tool Changer plugin - the parking spot where manual tool swaps happen.","syntax":"$POCKET1","params":{},"example":"$POCKET1","tips":"Provided by the Manual Tool Changer plugin - only works when it is installed and enabled.","keywords":["pocket","manual tool change","tool changer","park","position"]},{"code":"$ADB_RETRACT","aliases":[],"name":"Retract Dust Boot (AutoDustboot)","category":"plugin","modal":null,"desc":"Retracts the pneumatic dust boot. The AutoDustboot plugin injects this automatically before tool changes (M6/M98) in a loaded job, but it can also be typed in the Console or embedded in your own macros.","syntax":"$ADB_RETRACT","params":{},"example":"$ADB_RETRACT","tips":"Provided by the AutoDustboot plugin - only works when it is installed and enabled.","keywords":["dust boot","dustboot","retract","pneumatic","adb"]},{"code":"$ADB_EXPAND","aliases":[],"name":"Expand Dust Boot (AutoDustboot)","category":"plugin","modal":null,"desc":"Expands (lowers) the pneumatic dust boot. The AutoDustboot plugin injects this automatically after the first rapid XY move following a tool change, and it can also be typed in the Console or embedded in macros.","syntax":"$ADB_EXPAND","params":{},"example":"$ADB_EXPAND","tips":"Provided by the AutoDustboot plugin - only works when it is installed and enabled.","keywords":["dust boot","dustboot","expand","deploy","pneumatic","adb"]}],"settings":[{"code":"$0","name":"Step pulse time","desc":"SLB-EXT default: 5 microseconds. Sets time length per step. Minimum 2 microseconds. This needs to be reduced from the default value of 10 when max. step rates exceed approximately 80 kHz.","keywords":["invert","pulse","signal","step","stepper","time"]},{"code":"$1","name":"Step idle delay","desc":"SLB-EXT default: 254 milliseconds. Sets a short hold delay when stopping to let dynamics settle before disabling steppers. Value 255 keeps motors enabled.","keywords":["delay","idle","invert","signal","step","stepper"]},{"code":"$2","name":"Step pulse invert","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Inverts the step signals (active low).","keywords":["invert","pulse","signal","step","stepper"]},{"code":"$3","name":"Step direction invert","desc":"SLB-EXT default: X: OFF Y: ON Z: ON A: OFF (6). Inverts the direction signals (active low).","keywords":["direction","invert","signal","step","stepper"]},{"code":"$4","name":"Invert stepper enable pin(s)","desc":"SLB-EXT default: X: ON Y: ON Z: ON A: ON (15). Inverts the stepper driver enable signals. Most drivers uses active low enable requiring inversion. NOTE: If the stepper drivers shares the same enable signal only X is used.","keywords":["enable","invert","pin","signal","stepper"]},{"code":"$5","name":"Invert limit pins","desc":"SLB-EXT default: X: ON Y: ON Z: ON A: ON (15). Inverts the axis limit input signals.","keywords":["invert","limit","pins","signal","stepper"]},{"code":"$6","name":"Invert probe pin","desc":"SLB-EXT default: Enabled (1). Inverts the probe input pin signal.","keywords":["invert","pin","probe","signal","stepper"]},{"code":"$7","name":"Deprecated","desc":"Deprecated","keywords":["deprecated"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$8","name":"Ganged axes direction invert","desc":"SLB-EXT default: Disabled (0). Inverts the direction signals for the second motor used for ganged axes. NOTE: This inversion will be applied in addition to the inversion from setting $3.","keywords":["axes","direction","ganged","invert","signal","stepper"]},{"code":"$9","name":"PWM Spindle","desc":"SLB-EXT default: Enable: ON RPM controls spindle en signal: OFF (1). Enable: Controls PWM output availability. RPM controls spindle enable signal: When M3 or M4 is active, S > 0 turns on spindle enable and S0 turns it off.","keywords":["invert","pwm","signal","spindle","stepper"]},{"code":"$10","name":"Status report options","desc":"SLB-EXT default: Position in machine coords: ON Buffer state: ON Line numbers: ON Feed & speed: ON Pin state: ON Work coord offset: ON Overrides: ON Probe coords: ON Buffer sync on WCO change: ON Parser state: OFF Alarm substatus: OFF Run substatus: OFF (511). Specifies optional data included in status reports. If Run substatus is enabled it may be used for simple probe protection. NOTE: Parser state will be sent separately after the status report and only on changes.","keywords":["options","report","status"]},{"code":"$11","name":"Junction deviation","desc":"SLB-EXT default: 0.010 mm. Sets how fast Grbl travels through consecutive motions. Lower value slows it down.","keywords":["deviation","junction"]},{"code":"$12","name":"Arc tolerance","desc":"SLB-EXT default: 0.002 mm. Sets the G2 and G3 arc tracing accuracy based on radial error. Beware: A very small value may effect performance.","keywords":["arc","tolerance"]},{"code":"$13","name":"Report in inches","desc":"SLB-EXT default: Disabled (0). Enables inch units when returning any position and rate value that is not a settings value.","keywords":["inches","report"]},{"code":"$14","name":"Invert control pins","desc":"SLB-EXT default: Reset: OFF Feed hold: ON Cycle start: ON Safety door: ON EStop: OFF (14). Inverts the control signals (active low). NOTE: Block delete, Optional stop, EStop and Probe connected are optional signals, availability is driver dependent.","keywords":["control","invert","pins"]},{"code":"$15","name":"Invert coolant pins","desc":"SLB-EXT default: Flood: OFF Mist: OFF (0). Inverts the coolant and mist signals (active low).","keywords":["coolant","invert","pins"]},{"code":"$16","name":"Invert spindle signals","desc":"SLB-EXT default: Spindle en: OFF Spindle dir: OFF PWM: OFF (0). Inverts the spindle on, counterclockwise and PWM signals (active low). NOTE: A hard reset of the controller is required after changing this setting.","keywords":["invert","signals","spindle"]},{"code":"$17","name":"Pullup disable control pins","desc":"SLB-EXT default: Reset: OFF Feed hold: OFF Cycle start: OFF Safety door: OFF EStop: OFF (0). Disable the control signals pullup resistors. Potentially enables pulldown resistor if available. NOTE: Block delete, Optional stop and EStop are optional signals, availability is driver dependent.","keywords":["control","disable","pins","pullup"]},{"code":"$18","name":"Pullup disable limit pins","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Disable the limit signals pullup resistors. Potentially enables pulldown resistor if available.","keywords":["disable","limit","pins","pullup"]},{"code":"$19","name":"Pullup disable probe pin","desc":"SLB-EXT default: Disabled (0). Disable the probe signal pullup resistor. Potentially enables pulldown resistor if available.","keywords":["disable","pin","probe","pullup"]},{"code":"$20","name":"Soft limits enable","desc":"SLB-EXT default: Disabled (0). Enables soft limits checks within machine travel and sets alarm when exceeded. Requires homing.","keywords":["enable","homing","limits","soft"]},{"code":"$21","name":"Hard limits enable","desc":"SLB-EXT default: Enable: OFF Strict mode: OFF (0). When enabled immediately halts motion and throws an alarm when a limit switch is triggered. In strict mode only homing is possible when a switch is engaged.","keywords":["enable","hard","homing","limits"]},{"code":"$22","name":"Homing cycle","desc":"SLB-EXT default: Enable: OFF Single axis commands: OFF Homing on startup: OFF Set machine origin: OFF Two switches share one input: OFF Allow manual: OFF Override locks: OFF Keep homed status on reset: OFF (0). Enables homing cycle. Requires limit switches on axes to be automatically homed. When `Enable single axis commands` is checked, single axis homing can be performed by $H<axis letter> commands. When `Allow manual` is checked, axes not homed automatically may be homed manually by $H or $H<axis letter> commands. `Override locks` is for allowing a soft reset to disable `Homing on startup required`.","keywords":["cycle","homing","limits"]},{"code":"$23","name":"Homing direction invert","desc":"SLB-EXT default: X: ON Y: ON Z: OFF A: ON (11). Homing searches for a switch in the positive direction. Set axis bit to search in negative direction.","keywords":["direction","homing","invert","limits"]},{"code":"$24","name":"Homing locate feed rate","desc":"SLB-EXT default: 150 mm/min. Feed rate to slowly engage limit switch to determine its location accurately.","keywords":["feed","homing","limits","locate","rate"]},{"code":"$25","name":"Homing search seek rate","desc":"SLB-EXT default: 4300 mm/min. Seek rate to quickly find the limit switch before the slower locating phase.","keywords":["homing","limits","rate","search","seek"]},{"code":"$26","name":"Homing switch debounce delay","desc":"SLB-EXT default: 25 milliseconds. Sets a short delay between phases of homing cycle to let a switch debounce.","keywords":["debounce","delay","homing","limits","switch"]},{"code":"$27","name":"Homing switch pull-off distance","desc":"SLB-EXT default: 1.5 mm. Retract distance after triggering switch to disengage it. Homing will fail if switch isn't cleared.","keywords":["distance","homing","limits","off","pull","switch"]},{"code":"$28","name":"G73 retract distance","desc":"SLB-EXT default: 0.1 mm. G73 retract distance (for chip breaking drilling).","keywords":["distance","retract"]},{"code":"$29","name":"Pulse delay","desc":"SLB-EXT default: 0 microseconds. Step pulse delay. Normally leave this at 0 as there is an implicit delay on direction changes when AMASS is active.","keywords":["delay","invert","pulse","signal","stepper"]},{"code":"$30","name":"Maximum spindle speed","desc":"SLB-EXT default: 24000 RPM. Maximum spindle speed, can be overridden by spindle plugins.","keywords":["maximum","speed","spindle"]},{"code":"$31","name":"Minimum spindle speed","desc":"SLB-EXT default: 7500 RPM. Minimum spindle speed, can be overridden by spindle plugins.","keywords":["minimum","speed","spindle"]},{"code":"$32","name":"Mode of operation","desc":"SLB-EXT default: Normal (0). Laser mode: consecutive G1/2/3 commands will not halt when spindle speed is changed. Lathe mode: allows use of G7, G8, G96 and G97.","keywords":["mode","operation","spindle"]},{"code":"$33","name":"Spindle PWM frequency","desc":"SLB-EXT default: 1000 Hz. Spindle PWM frequency.","keywords":["frequency","pwm","spindle"]},{"code":"$34","name":"Spindle PWM off value","desc":"SLB-EXT default: 0 percent. Spindle PWM off value in percent (duty cycle).","keywords":["off","pwm","spindle","value"]},{"code":"$35","name":"Spindle PWM min value","desc":"SLB-EXT default: 0 percent. Spindle PWM min value in percent (duty cycle).","keywords":["min","pwm","spindle","value"]},{"code":"$36","name":"Spindle PWM max value","desc":"SLB-EXT default: 100 percent. Spindle PWM max value in percent (duty cycle).","keywords":["max","pwm","spindle","value"]},{"code":"$37","name":"Steppers de-energize","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Specifies which steppers not to disable when stopped.","keywords":["energize","invert","signal","stepper","steppers"]},{"code":"$38","name":"Spindle pulses per revolution (PPR)","desc":"Spindle encoder pulses per revolution.","keywords":["spindle","pulses","per","revolution","ppr"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$39","name":"Enable legacy RT commands","desc":"SLB-EXT default: Enabled (1). Enables \"normal\" processing of ?, ! and ~ characters when part of $-setting or comment. If disabled then they are added to the input string instead.","keywords":["commands","enable","invert","legacy","signal","stepper"]},{"code":"$40","name":"Limit jog commands","desc":"SLB-EXT default: Enabled (1). Limit jog commands to machine limits for homed axes.","keywords":["commands","jog","limit"]},{"code":"$41","name":"Parking cycle","desc":"SLB-EXT default: Enable: ON Parking override control: OFF Deactivate upon init: OFF (1). Enables parking cycle, requires parking axis homed.","keywords":["cycle","parking"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$42","name":"Parking axis","desc":"SLB-EXT default: Z (2). Define which axis that performs the parking motion.","keywords":["axis","parking"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$43","name":"Homing passes","desc":"SLB-EXT default: 1. Number of homing passes. Minimum 1, maximum 128.","keywords":["homing","limits","passes"]},{"code":"$44","name":"Axes homing, first pass","desc":"SLB-EXT default: X: OFF Y: OFF Z: ON A: OFF (4). Axes to home in first pass.","keywords":["axes","first","homing","limits","pass"]},{"code":"$45","name":"Axes homing, second pass","desc":"SLB-EXT default: X: ON Y: ON Z: OFF A: OFF (3). Axes to home in second pass.","keywords":["axes","homing","limits","pass","second"]},{"code":"$46","name":"Axes homing, third pass","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Axes to home in third pass.","keywords":["axes","homing","limits","pass","third"]},{"code":"$47","name":"Axes homing, fourth pass","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Axes to home in fourth pass.","keywords":["axes","fourth","homing","limits","pass"]},{"code":"$48","name":"Axes homing, fifth phase","desc":"Axes to home in fifth phase.","keywords":["axes","homing","fifth","phase"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$49","name":"Axes homing, sixth phase","desc":"Axes to home in sixth phase.","keywords":["axes","homing","sixth","phase"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$56","name":"Parking pull-out distance","desc":"SLB-EXT default: 5 mm. Spindle pull-out and plunge distance in mm.Incremental distance.","keywords":["distance","out","parking","pull"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$57","name":"Parking pull-out rate","desc":"SLB-EXT default: 100 mm/min. Spindle pull-out/plunge slow feed rate in mm/min.","keywords":["out","parking","pull","rate"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$58","name":"Parking target","desc":"SLB-EXT default: -5 mm. Parking axis target. In mm, as machine coordinate [-max_travel, 0].","keywords":["parking","target"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$59","name":"Parking fast rate","desc":"SLB-EXT default: 500 mm/min. Parking fast rate to target after pull-out in mm/min.","keywords":["fast","parking","rate"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$60","name":"Restore overrides","desc":"SLB-EXT default: Enabled (1). Restore overrides to default values at program end.","keywords":["overrides","restore"]},{"code":"$61","name":"Safety door options","desc":"SLB-EXT default: Ignore when idle: ON Keep coolant state: ON (3). Enable this if it is desirable to open the safety door when in IDLE mode (eg. for jogging).","keywords":["door","options","safety"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$62","name":"Sleep enable","desc":"SLB-EXT default: Disabled (0). Enable sleep mode.","keywords":["enable","sleep"]},{"code":"$63","name":"Feed hold actions","desc":"SLB-EXT default: Disable laser: ON Restore spindle and coolant state: ON (3). Actions taken during feed hold and on resume from feed hold.","keywords":["actions","feed","hold"]},{"code":"$64","name":"Force init alarm","desc":"SLB-EXT default: Disabled (0). Starts Grbl in alarm mode after a cold reset.","keywords":["alarm","force","init"]},{"code":"$65","name":"Probing feed override","desc":"SLB-EXT default: Disabled (0). Allow feed override during probing.","keywords":["feed","override","probing"]},{"code":"$66","name":"Spindle linearisation, 1st point","desc":"Comma separated list of values: RPM_MIN, RPM_LINE_A1, RPM_LINE_B1, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$67","name":"Spindle linearisation, 2nd point","desc":"Comma separated list of values: RPM_POINT12, RPM_LINE_A2, RPM_LINE_B2, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$68","name":"Spindle linearisation, 3rd point","desc":"Comma separated list of values: RPM_POINT23, RPM_LINE_A3, RPM_LINE_B3, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$69","name":"Spindle linearisation, 4th point","desc":"Comma separated list of values: RPM_POINT34, RPM_LINE_A4, RPM_LINE_B4, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$70","name":"Network services","desc":"SLB-EXT default: Telnet: ON Websocket: ON FTP: ON (11). Network services/protocols to enable. NOTE: A hard reset of the controller is required after changing this setting.","keywords":["ethernet","ip","network","services"]},{"code":"$90","name":"Spindle sync P-gain","desc":"Spindle sync P-gain","keywords":["spindle","sync","gain"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$91","name":"Spindle sync I-gain","desc":"Spindle sync I-gain","keywords":["spindle","sync","gain"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$92","name":"Spindle sync D-gain","desc":"Spindle sync D-gain","keywords":["spindle","sync","gain"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$95","name":"Spindle sync PID max I error","desc":"Spindle sync PID max integrator error.","keywords":["spindle","sync","pid","max","error"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$100","name":"X-axis travel resolution","desc":"SLB-EXT default: 800 step/mm. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$101","name":"Y-axis travel resolution","desc":"SLB-EXT default: 800 step/mm. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$102","name":"Z-axis travel resolution","desc":"SLB-EXT default: 800 step/mm. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$103","name":"A-axis travel resolution","desc":"SLB-EXT default: 79.012345679 step/deg. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$110","name":"X-axis maximum rate","desc":"SLB-EXT default: 4000 mm/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$111","name":"Y-axis maximum rate","desc":"SLB-EXT default: 4000 mm/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$112","name":"Z-axis maximum rate","desc":"SLB-EXT default: 4000 mm/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$113","name":"A-axis maximum rate","desc":"SLB-EXT default: 8000 deg/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$120","name":"X-axis acceleration","desc":"SLB-EXT default: 750 mm/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$121","name":"Y-axis acceleration","desc":"SLB-EXT default: 750 mm/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$122","name":"Z-axis acceleration","desc":"SLB-EXT default: 750 mm/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$123","name":"A-axis acceleration","desc":"SLB-EXT default: 1000 deg/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$130","name":"X-axis maximum travel","desc":"SLB-EXT default: 810 mm. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$131","name":"Y-axis maximum travel","desc":"SLB-EXT default: 855 mm. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$132","name":"Z-axis maximum travel","desc":"SLB-EXT default: 120 mm. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$133","name":"A-axis maximum travel","desc":"SLB-EXT default: 0 deg. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$140","name":"X-axis motor current","desc":"SLB-EXT default: 2800 mA. Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"]},{"code":"$141","name":"Y-axis motor current","desc":"Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"]},{"code":"$142","name":"Z-axis motor current","desc":"Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"]},{"code":"$143","name":"A-axis motor current","desc":"SLB-EXT default: 0. Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$150","name":"X-axis microsteps","desc":"SLB-EXT default: 32 steps. Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"]},{"code":"$151","name":"Y-axis microsteps","desc":"Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"]},{"code":"$152","name":"Z-axis microsteps","desc":"Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"]},{"code":"$153","name":"A-axis microsteps","desc":"SLB-EXT default: 16. Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$180","name":"X-axis homing locate feed rate","desc":"SLB-EXT default: 150 mm/min. Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"]},{"code":"$181","name":"Y-axis homing locate feed rate","desc":"Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"]},{"code":"$182","name":"Z-axis homing locate feed rate","desc":"Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"]},{"code":"$183","name":"A-axis homing locate feed rate","desc":"Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$190","name":"X-axis homing search seek rate","desc":"SLB-EXT default: 4300 mm/min. Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"]},{"code":"$191","name":"Y-axis homing search seek rate","desc":"Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"]},{"code":"$192","name":"Z-axis homing search seek rate","desc":"Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"]},{"code":"$193","name":"A-axis homing search seek rate","desc":"Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$200","name":"X-axis StallGuard2 fast threshold","desc":"SLB-EXT default: 22. StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$201","name":"Y-axis StallGuard2 fast threshold","desc":"StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$202","name":"Z-axis StallGuard2 fast threshold","desc":"StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$203","name":"A-axis StallGuard2 fast threshold","desc":"StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$210","name":"X-axis hold current","desc":"SLB-EXT default: 35 %. Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"]},{"code":"$211","name":"Y-axis hold current","desc":"Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"]},{"code":"$212","name":"Z-axis hold current","desc":"Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"]},{"code":"$213","name":"A-axis hold current","desc":"SLB-EXT default: 50. Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$220","name":"X-axis stallGuard2 slow threshold","desc":"SLB-EXT default: 22. StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$221","name":"Y-axis stallGuard2 slow threshold","desc":"StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$222","name":"Z-axis stallGuard2 slow threshold","desc":"StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$223","name":"A-axis stallGuard2 slow threshold","desc":"StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$300","name":"Hostname","desc":"SLB-EXT default: grblHAL. Network hostname. ~Controller reset required for setting change to take effect~","keywords":["ethernet","hostname","ip","network"]},{"code":"$301","name":"IP mode","desc":"SLB-EXT default: Static (0). IP mode. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","mode","network"]},{"code":"$302","name":"IP address","desc":"SLB-EXT default: 192.168.5.1. Static IP address. ~Controller reset required for setting change to take effect~","keywords":["address","ethernet","ip","network"]},{"code":"$303","name":"Gateway","desc":"SLB-EXT default: 192.168.5.1. Static gateway address. ~Controller reset required for setting change to take effect~","keywords":["ethernet","gateway","ip","network"]},{"code":"$304","name":"Netmask","desc":"SLB-EXT default: 255.255.255.0. Static netmask. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","netmask","network"]},{"code":"$305","name":"Telnet port","desc":"SLB-EXT default: 23. (Raw) Telnet port number listening for incoming connections. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","network","port","telnet"]},{"code":"$307","name":"Websocket port","desc":"SLB-EXT default: 80. Websocket port number listening for incoming connections. NOTE: WebUI requires this to be HTTP port number + 1. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","network","port","websocket"]},{"code":"$308","name":"FTP port","desc":"SLB-EXT default: 21. FTP port number listening for incoming connections. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ftp","ip","network","port"]},{"code":"$338","name":"Trinamic driver","desc":"SLB-EXT default: X: ON Y: ON Z: ON A: OFF (7). Enable SPI or UART controlled Trinamic drivers for axes.","keywords":["driver","ethernet","ip","motor","network","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$339","name":"Sensorless homing","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Enable sensorless homing for axes. Requires SPI or UART controlled Trinamic drivers.","keywords":["driver","ethernet","homing","ip","motor","network","sensorless","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$340","name":"Spindle at speed tolerance","desc":"SLB-EXT default: 0 percent. Spindle at speed tolerance as percentage deviation from programmed speed, set to 0 to disable. If not within tolerance when checked after spindle on delay ($392) alarm 14 is raised.","keywords":["speed","spindle","tolerance"]},{"code":"$341","name":"Tool change mode","desc":"SLB-EXT default: Normal (0). Normal: allows jogging for manual touch off. Set new position manually. Manual touch off: retracts tool axis to home position for tool change, use jogging or $TPW for touch off. Manual touch off @ G59.3: retracts tool axis to home position then to G59.3 position for tool change, use jogging or $TPW for touch off. Automatic touch off @ G59.3: retracts tool axis to home position for tool change, then to G59.3 position for automatic touch off. All modes except \"Normal\" and \"Ignore M6\" returns the tool (controlled point) to original position after touch off.","keywords":["change","mode","probe","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$342","name":"Tool change probing distance","desc":"SLB-EXT default: 30 mm. Maximum probing distance for automatic or $TPW touch off.","keywords":["change","distance","probe","probing","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$343","name":"Tool change locate feed rate","desc":"SLB-EXT default: 25 mm/min. Feed rate to slowly engage tool change sensor to determine the tool offset accurately.","keywords":["change","feed","locate","probe","rate","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$344","name":"Tool change search seek rate","desc":"SLB-EXT default: 200 mm/min. Seek rate to quickly find the tool change sensor before the slower locating phase.","keywords":["change","probe","rate","search","seek","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$345","name":"Tool change probe pull-off rate","desc":"SLB-EXT default: 200 mm/min. Pull-off rate for the retract move before the slower locating phase.","keywords":["change","off","probe","pull","rate","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$346","name":"Restore position after M6","desc":"SLB-EXT default: Enabled (1). When set the spindle is moved so that the controlled point (tool tip) is the same as before the M6 command, if not the spindle is only moved to the Z home position.","keywords":["after","position","probe","restore","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$347","name":"Dual axis length fail","desc":"(percent) Dual axis length fail in percent of axis max travel.","keywords":["dual","axis","length","fail"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$348","name":"Dual axis length fail min","desc":"(mm) Dual axis length fail minimum distance.","keywords":["dual","axis","length","fail","min"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$349","name":"Dual axis length fail max","desc":"(mm) Dual axis length fail maximum distance.","keywords":["dual","axis","length","fail","max"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$370","name":"Invert I/O Port inputs","desc":"SLB-EXT default: (0). Invert IOPort inputs.","keywords":["inputs","invert","port"]},{"code":"$372","name":"Invert I/O Port outputs","desc":"SLB-EXT default: (0). Invert IOPort output.","keywords":["invert","outputs","port"]},{"code":"$374","name":"Modbus baud rate","desc":"SLB-EXT default: 19200 (3).","keywords":["baud","modbus","rate","rs485","vfd"]},{"code":"$375","name":"Modbus RX timeout","desc":"SLB-EXT default: 50 milliseconds.","keywords":["modbus","rs485","timeout","vfd"]},{"code":"$376","name":"Rotational axes","desc":"SLB-EXT default: A-Axis: ON (1).","keywords":["axes","rotational"]},{"code":"$384","name":"Disable G92 persistence","desc":"SLB-EXT default: Disabled (0). Disables save/restore of G92 offset to non-volatile storage (NVS).","keywords":["disable","persistence"]},{"code":"$392","name":"Spindle on delay","desc":"SLB-EXT default: 11 s. Delay to allow spindle to spin up after safety door is opened.","keywords":["delay","spindle"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$393","name":"Coolant on delay","desc":"SLB-EXT default: 1 s. Delay to allow coolant to restart after safety door is opened.","keywords":["coolant","delay"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$394","name":"Spindle off delay (s)","desc":"grblHAL: pause after M5 — spin-down time.","keywords":["spindle","delay","spindown","off delay"]},{"code":"$395","name":"Default spindle","desc":"SLB-EXT default: SLB_SPINDLE (0). Spindle selected on startup.","keywords":["default","laser","spindle"]},{"code":"$398","name":"Planner buffer blocks","desc":"SLB-EXT default: 128. Number of blocks in the planner buffer. ~Controller reset required for setting change to take effect~","keywords":["blocks","buffer","planner"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$399","name":"CAN bus baud rate","desc":"CAN bus baud rate","keywords":["can","bus","baud","rate"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$450","name":"Button 1 action","desc":"SLB-EXT default: Cycle start (1). Assign a real-time action to button 1, or run your own macro g-code.","keywords":["action","button","macro"]},{"code":"$451","name":"Button 2 action","desc":"SLB-EXT default: Pause (2). Assign a real-time action to button 2, or run your own macro g-code.","keywords":["action","button","macro"]},{"code":"$452","name":"Button 3 action","desc":"SLB-EXT default: Halt (4). Assign a real-time action to button 3, or run your own macro g-code.","keywords":["action","button","macro"]},{"code":"$453","name":"Button 1 macro","desc":"SLB-EXT default: G4P0. Macro content, limited to 127 characters. Separate lines with the vertical bar character |.","keywords":["action","button","macro"]},{"code":"$454","name":"Button 2 macro","desc":"SLB-EXT default: G4P0. Macro content, limited to 127 characters. Separate lines with the vertical bar character |.","keywords":["action","button","macro"]},{"code":"$455","name":"Button 3 macro","desc":"SLB-EXT default: G4P0. Macro content, limited to 127 characters. Separate lines with the vertical bar character |.","keywords":["action","button","macro"]},{"code":"$456","name":"Aux output 0 trigger","desc":"SLB-EXT default: Spindle/Laser enable (0). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$457","name":"Aux output 1 trigger","desc":"SLB-EXT default: Flood enable (2). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$458","name":"Aux output 2 trigger","desc":"SLB-EXT default: Spindle/Laser enable (0). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$459","name":"Aux output 3 trigger","desc":"SLB-EXT default: Flood enable (2). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$462","name":"Run/stop register","desc":"SLB-EXT default: 8192 decimal. MODVFD register for run/stop.","keywords":["modbus","register","rs485","run","stop","vfd"]},{"code":"$463","name":"Frequency set register","desc":"SLB-EXT default: 8193 decimal. MODVFD register to set frequency.","keywords":["frequency","modbus","register","rs485","set","vfd"]},{"code":"$464","name":"Frequency get register","desc":"SLB-EXT default: 8451 decimal. MODVFD register to get frequency.","keywords":["frequency","get","modbus","register","rs485","vfd"]},{"code":"$465","name":"Run CW command","desc":"SLB-EXT default: 18 decimal. MODVFD command word for CW.","keywords":["command","modbus","rs485","run","vfd"]},{"code":"$466","name":"Run CCW command","desc":"SLB-EXT default: 34 decimal. MODVFD command word for CCW.","keywords":["ccw","command","modbus","rs485","run","vfd"]},{"code":"$467","name":"Stop command","desc":"SLB-EXT default: 1 decimal. MODVFD command word for stop.","keywords":["command","modbus","rs485","stop","vfd"]},{"code":"$468","name":"RPM input multiplier","desc":"SLB-EXT default: 50. MODVFD RPM value multiplier for programming RPM.","keywords":["input","modbus","multiplier","rpm","rs485","vfd"]},{"code":"$469","name":"RPM input divider","desc":"SLB-EXT default: 60. MODVFD RPM value divider for programming RPM.","keywords":["divider","input","modbus","rpm","rs485","vfd"]},{"code":"$470","name":"RPM output multiplier","desc":"SLB-EXT default: 60. MODVFD RPM value multiplier for reading RPM.","keywords":["modbus","multiplier","output","rpm","rs485","vfd"]},{"code":"$471","name":"RPM output divider","desc":"SLB-EXT default: 100. MODVFD RPM value divider for reading RPM.","keywords":["divider","modbus","output","rpm","rs485","vfd"]},{"code":"$478","name":"Spindle 2 Modbus address","desc":"SLB-EXT default: 3. Spindle 2 Modbus address.","keywords":["address","modbus","rs485","spindle","vfd"]},{"code":"$479","name":"Spindle 3 Modbus address","desc":"SLB-EXT default: 4. Spindle 3 Modbus address.","keywords":["address","modbus","rs485","spindle","vfd"]},{"code":"$481","name":"Autoreport interval","desc":"SLB-EXT default: 0 ms. Interval the real time report will be sent, set to 0 to disable. ~Controller reset required for setting change to take effect~","keywords":["autoreport","interval"]},{"code":"$482","name":"Timezone offset","desc":"Offset in hours from UTC.","keywords":["timezone","offset"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$484","name":"Unlock required after E-stop","desc":"SLB-EXT default: Enabled (1). If set, unlock (by sending $X) is required after resetting a cleared E-Stop condition.","keywords":["after","required","stop","unlock"]},{"code":"$485","name":"Keep tool number over reboot","desc":"Keep tool number over reboot","keywords":["keep","tool","number","over","reboot"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$486","name":"Lock coordinate systems","desc":"SLB-EXT default: G59.1: OFF G59.2: OFF G59.3: OFF (0). Lock coordinate systems against accidental changes.","keywords":["coordinate","lock","systems"]},{"code":"$487","name":"PWM2 spindle on port","desc":"On/off aux port.","keywords":["pwm","spindle","port"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$488","name":"PWM2 spindle direction port","desc":"Direction aux port, set to -1 if not required.","keywords":["pwm","spindle","direction","port"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$489","name":"PWM2 spindle PWM port","desc":"Spindle analog aux port. Must be PWM capable!","keywords":["pwm","spindle","port"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$511","name":"Spindle 1","desc":"SLB-EXT default: SLB_LASER (7). Spindle to use as spindle 1. ~Controller reset required for setting change to take effect~","keywords":["laser","spindle"]},{"code":"$512","name":"Spindle 2","desc":"SLB-EXT default: MODVFD (5). Spindle to use as spindle 2. ~Controller reset required for setting change to take effect~","keywords":["laser","spindle"]},{"code":"$513","name":"Spindle 3","desc":"SLB-EXT default: Disabled (8). Spindle to use as spindle 3. ~Controller reset required for setting change to take effect~","keywords":["laser","spindle"]},{"code":"$519","name":"Encoder spindle","desc":"Specifies which spindle has the encoder attached.","keywords":["encoder","spindle"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$520","name":"Spindle 0 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 0 (default spindle). Normally leave this at 0.","keywords":["laser","number","spindle","start","tool"]},{"code":"$521","name":"Spindle 1 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 1.","keywords":["laser","number","spindle","start","tool"]},{"code":"$522","name":"Spindle 2 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 2.","keywords":["laser","number","spindle","start","tool"]},{"code":"$523","name":"Spindle 3 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 3.","keywords":["laser","number","spindle","start","tool"]},{"code":"$534","name":"Output NGC debug messages","desc":"Example: (debug, metric mode: #<_metric>, coord system: #5220)","keywords":["output","ngc","debug","messages"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$536","name":"LED strip 1 length","desc":"Number of LEDS in strip 1.","keywords":["led","strip","length"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$537","name":"LED strip 2 length","desc":"Number of LEDS in strip 2.","keywords":["led","strip","length"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$538","name":"Fast rotary go to G28","desc":"Fast rotary go to G28","keywords":["fast","rotary"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$539","name":"Spindle off delay","desc":"(s) Spindle off delay","keywords":["spindle","off","delay"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$650","name":"Chopper toff","desc":"SLB-EXT default: 1. Off time. Duration of slow decay phase as a multiple of system clock periods: NCLK= 24 + (32 x TOFF). This will limit the maximum chopper frequency (0-15). 0: MOSFETs shut off, driver disabled. 1: Use with TBL of minimum 24 clocks.","keywords":["chopper","toff"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$651","name":"Chopper tbl","desc":"SLB-EXT default: 1. Blanking time interval in system clock periods (0-3 = 16,24,36,54). Needs to cover the switching event and the duration of the ringing on the sense resistor.","keywords":["chopper","tbl"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$652","name":"Chopper chm","desc":"SLB-EXT default: 0. Chopper mode. Affects HDEC, HEND, and HSTRT parameters. 0: Standard mode (SpreadCycle). 1: Constant TOFF with fast decay time. Fast decay is after on time. Fast decay time is also terminated when the negative nominal current is reached.","keywords":["chm","chopper"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$653","name":"Chopper hstr","desc":"SLB-EXT default: 2. CHM=0: Hysteresis start, offset from HEND (0-7 = 1-8). To be effective, HEND+HSTRT must be ≤15. CHM=1: Fast decay time. Three least-significant bits of the duration of the fast decay phase. The MSB is HDEC0. Fast decay time is a multiple of system clock periods: NCLK= 32 x (HDEC0+HSTRT).","keywords":["chopper","hstr"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$654","name":"Chopper hend","desc":"SLB-EXT default: 8. Can be either negative, zero, or positive, 0-15 = -3 to 12. CHM=0: Hysteresis end (low). Sets the hysteresis end value after a number of decrements, used for the hysteresis chopper and controlled by HDEC. HSTRT+HEND must be less than 16. 1/512 adds to the current setting. CHM=1: Sine wave offset. A positive offset corrects for zero crossing error. 1/512 adds to the absolute value of each sine wave entry.","keywords":["chopper","hend"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$655","name":"Chopper hdec","desc":"SLB-EXT default: 0. CHM=0: Hysteresis decrement interval period in system clock periods. Determines the slope of the hysteresis during on time from fast to very slow (0-3 = 16,32,48,64). CHM=1: Fast decay mode.","keywords":["chopper","hdec"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$656","name":"Chopper rndtf","desc":"SLB-EXT default: 1. Change from fixed to randomized TOFF times, by dNCLK= -24 to +6 clocks. Only for CHM=1.","keywords":["chopper","rndtf"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$657","name":"THRESH","desc":"SLB-EXT default: 22. StallGuard threshold.","keywords":["thresh"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$658","name":"CoolStep semin","desc":"SLB-EXT default: 7. Lower CoolStep threshold. If the SG value falls below SEMIN x 32, the coil current scaling factor is increased (0-15). 0: CoolStep disabled.","keywords":["coolstep","semin"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$659","name":"CoolStep seup","desc":"SLB-EXT default: 3. Number of increments of the coil current each time SG is sampled below the lower threshold (0-3 = 1,2,4,8).","keywords":["coolstep","seup"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$660","name":"CoolStep semax","desc":"SLB-EXT default: 0. Upper CoolStep threshold offset from lower threshold. If SG is sampled above (SEMIN+SEMAX+1)x32 enough times, the coil current scaling factor is decremented (0-15).","keywords":["coolstep","semax"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$661","name":"CoolStep sedn","desc":"SLB-EXT default: 3. Number of times SG must be sampled above the upper threshold before the coil current is decremented (0-3 = 32,8,2,1).","keywords":["coolstep","sedn"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$662","name":"CoolStep seimin","desc":"SLB-EXT default: 0. Minimum CoolStep current as a factor of the set motor current. 0: 1/2, 1: 1/4","keywords":["coolstep","seimin"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$663","name":"drvconf_reg","desc":"SLB-EXT default: 41759. DRVCONF register defaults 0xA31F. All protections enabled.","keywords":["drvconf","reg"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$664","name":"Ring pixels","desc":"SLB-EXT default: 0. Number of individual pixels or LEDs connected. ~Controller reset required for setting change to take effect~","keywords":["led","lights","pixels","ring"]},{"code":"$665","name":"Rail pixels","desc":"SLB-EXT default: 1. Number of individual pixels or LEDs connected. Include the onboard LED. ~Controller reset required for setting change to take effect~","keywords":["led","lights","pixels","rail"]},{"code":"$666","name":"Using add-ons","desc":"SLB-EXT default: (0). Sienci specific capability flags.","keywords":["add","ons","using"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$668","name":"Invert TLS input","desc":"SLB-EXT default: Enabled (1). Invert the TLS input ahead of the OR function. ~Controller reset required for setting change to take effect~","keywords":["input","invert","tls"]},{"code":"$671","name":"Invert home inputs","desc":"Inverts the axis home input signals.","keywords":["invert","home","inputs"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$673","name":"Coolant on delay","desc":"(s) Delay to allow coolant to start. 0 or 0.5 - 20s.","keywords":["coolant","delay"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$676","name":"Reset actions","desc":"Controls actions taken on a soft reset.","keywords":["reset","actions"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$680","name":"Stepper enable delay","desc":"(ms) Delay from stepper enable to first step output. The driver typically adds ~2ms to this.","keywords":["stepper","enable","delay"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$681","name":"ModBus serial format","desc":"ModBus serial format","keywords":["modbus","serial","format"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$700","name":"Subroutine options","desc":"Enable prescan for internal M98 subroutines.","keywords":["subroutine","options"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$709","name":"PWM2 spindle options","desc":"Options for the secondary PWM spindle output (PWM2, the SLB-EXT laser channel).","keywords":["laser","options","pwm","pwm2","spindle"]},{"code":"$716","name":"PWM2 spindle signals invert","desc":"Inverts the PWM2 (laser) enable, counterclockwise and PWM signals (active low). Hard reset required after changing.","keywords":["invert","laser","pwm","pwm2","signals","spindle"],"tips":"On older SLB 5.0.x firmware this lived at $743 (Invert laser signals)."},{"code":"$730","name":"Maximum laser power","desc":"SLB-EXT default: 255. Maximum S word power for laser.","keywords":["laser","maximum","power","pwm"]},{"code":"$731","name":"Minimum laser power","desc":"SLB-EXT default: 0. Minimum S word power for laser.","keywords":["laser","minimum","power","pwm"]},{"code":"$733","name":"Laser PWM frequency","desc":"SLB-EXT default: 1000 Hz. Laser PWM frequency.","keywords":["frequency","laser","pwm"]},{"code":"$734","name":"Laser PWM off value","desc":"SLB-EXT default: 0 percent. Laser PWM off value in percent (duty cycle).","keywords":["laser","off","pwm","value"]},{"code":"$735","name":"Laser PWM min value","desc":"SLB-EXT default: 0 percent. Laser PWM min value in percent (duty cycle).","keywords":["laser","min","pwm","value"]},{"code":"$736","name":"Laser PWM max value","desc":"SLB-EXT default: 100 percent. Laser PWM max value in percent (duty cycle).","keywords":["laser","max","pwm","value"]},{"code":"$737","name":"PWM2 spindle linearisation, 1st point","desc":"Comma separated list of values: RPM_MIN, RPM_LINE_A1, RPM_LINE_B1, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$738","name":"PWM2 spindle linearisation, 2nd point","desc":"Comma separated list of values: RPM_POINT12, RPM_LINE_A2, RPM_LINE_B2, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$739","name":"PWM2 spindle linearisation, 3rd point","desc":"Comma separated list of values: RPM_POINT23, RPM_LINE_A3, RPM_LINE_B3, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$740","name":"PWM2 spindle linearisation, 4th point","desc":"Comma separated list of values: RPM_POINT34, RPM_LINE_A4, RPM_LINE_B4, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$742","name":"Motor warning inputs enable","desc":"Enables the external stepper driver warning inputs per motor (SLB-EXT external drivers report warnings before faulting).","keywords":["alarm","driver","enable","fault","inputs","motor","warning"],"tips":"Current Main_grblHAL numbering. On older SLB 5.0.x firmware $742 was the Laser Y offset - that is now $771."},{"code":"$743","name":"Invert motor warning inputs","desc":"Inverts the motor warning input signals (active low).","keywords":["alarm","driver","fault","inputs","invert","motor","warning"],"tips":"On older SLB 5.0.x firmware $743 was Invert laser signals - that is now $716."},{"code":"$744","name":"Motor fault inputs enable","desc":"Enables the external stepper driver fault/alarm inputs per motor. A fault triggers an alarm and halts the machine.","keywords":["alarm","driver","enable","fault","inputs","motor"]},{"code":"$745","name":"Invert motor fault inputs","desc":"Inverts the motor fault input signals (active low).","keywords":["alarm","driver","fault","inputs","invert","motor"]},{"code":"$750","name":"Macro 0 content","desc":"G-code for aux-input macro 0. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $760) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$751","name":"Macro 1 content","desc":"G-code for aux-input macro 1. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $761) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$752","name":"Macro 2 content","desc":"G-code for aux-input macro 2. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $762) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$753","name":"Macro 3 content","desc":"G-code for aux-input macro 3. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $763) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$754","name":"Macro 4 content","desc":"G-code for aux-input macro 4. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $764) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$755","name":"Macro 5 content","desc":"G-code for aux-input macro 5. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $765) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$756","name":"Macro 6 content","desc":"G-code for aux-input macro 6. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $766) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$757","name":"Macro 7 content","desc":"G-code for aux-input macro 7. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $767) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$758","name":"Macro 8 content","desc":"G-code for aux-input macro 8. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $768) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$759","name":"Macro 9 content","desc":"G-code for aux-input macro 9. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $769) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$760","name":"Macro 0 trigger port","desc":"Aux input port number that triggers macro 0 (content in $750). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$761","name":"Macro 1 trigger port","desc":"Aux input port number that triggers macro 1 (content in $751). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$762","name":"Macro 2 trigger port","desc":"Aux input port number that triggers macro 2 (content in $752). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$763","name":"Macro 3 trigger port","desc":"Aux input port number that triggers macro 3 (content in $753). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$764","name":"Macro 4 trigger port","desc":"Aux input port number that triggers macro 4 (content in $754). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$765","name":"Macro 5 trigger port","desc":"Aux input port number that triggers macro 5 (content in $755). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$766","name":"Macro 6 trigger port","desc":"Aux input port number that triggers macro 6 (content in $756). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$767","name":"Macro 7 trigger port","desc":"Aux input port number that triggers macro 7 (content in $757). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$768","name":"Macro 8 trigger port","desc":"Aux input port number that triggers macro 8 (content in $758). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$769","name":"Macro 9 trigger port","desc":"Aux input port number that triggers macro 9 (content in $759). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$770","name":"Laser X offset","desc":"Laser offset from the spindle on the X axis, applied when switching between spindle and laser so files stay aligned. Pairs with gSender Spindle/Laser offset settings.","keywords":["alignment","laser","offset","pwm"],"tips":"Moved here in Main_grblHAL firmware - older SLB 5.0.x used $741."},{"code":"$771","name":"Laser Y offset","desc":"Laser offset from the spindle on the Y axis.","keywords":["alignment","laser","offset","pwm"],"tips":"Moved here in Main_grblHAL firmware - older SLB 5.0.x used $742."},{"code":"$772","name":"Laser offset options","desc":"Options controlling how the laser/spindle XY offset ($770/$771) is applied.","keywords":["laser","offset","options","pwm"]}],"system":[{"code":"$$","name":"View settings","desc":"Prints every numbered setting and its current value.","keywords":["settings","list","view","dump"]},{"code":"$#","name":"View G-code parameters","desc":"Shows WCS offsets (G54-G59.3), G28/G30 positions, G92 offset, tool length offset and last probe result (PRB).","keywords":["parameters","offsets","probe result","wcs","prb"]},{"code":"$G","name":"View parser state","desc":"Shows the active modal G-codes (motion mode, WCS, plane, units, distance mode...), plus current T, F and S.","keywords":["parser","state","modal","active modes"]},{"code":"$I","name":"Build info","desc":"Prints the firmware build/version string and enabled options.","keywords":["build","version","info","firmware"]},{"code":"$N","name":"View startup blocks","desc":"Shows the G-code lines run automatically at startup ($N0=, $N1= to set).","keywords":["startup","blocks","boot"]},{"code":"$X","name":"Kill alarm lock","desc":"Unlocks the machine from an alarm state without homing. Position may be unknown afterward — use with caution.","keywords":["unlock","alarm","kill","reset alarm"]},{"code":"$H","name":"Run homing cycle","desc":"Homes all configured axes per $22/$44-$47. $HX / $HY / $HZ home a single axis (grblHAL). Note: with the Rapid Change ATC or Manual Tool Changer plugin installed and \"perform TLS after home\" enabled, the plugin expands $H so that after homing, if a tool is loaded but has no length offset yet, an automatic $TLS probe cycle runs.","keywords":["home","homing","cycle","tls after home"]},{"code":"$J=","name":"Jog","desc":"Executes a jog move, e.g. $J=G91 X10 F1000. Jogs don't alter the G-code parser state and can be cancelled instantly (0x85).","keywords":["jog","jogging","move","manual"]},{"code":"$SLP","name":"Sleep","desc":"Puts the controller to sleep (steppers and spindle off). Wake with a soft reset. Requires $62=1.","keywords":["sleep","power down"]},{"code":"$TLR","name":"Set tool length reference","desc":"Tool change protocol: records the current tool offset as the job's reference after probing the first tool.","keywords":["tool length","reference","toolsetter","tool change"]},{"code":"$TPW","name":"Tool probe workpiece","desc":"Tool change protocol: probes the new tool to compute its dynamic offset. Available in tool change modes 1 and 2.","keywords":["tool probe","toolsetter","tool change"]},{"code":"$EA","name":"Enumerate alarms","desc":"Lists every alarm code with its description — decode alarm numbers here.","keywords":["alarms","codes","enumerate","list"]},{"code":"$EE","name":"Enumerate errors","desc":"Lists every error code with its description — decode error:NN messages here.","keywords":["errors","codes","enumerate","list"]},{"code":"$ES","name":"Enumerate settings","desc":"Lists every setting the build supports with type, range, unit and description — the authoritative settings reference for YOUR controller.","keywords":["settings","enumerate","describe","list"]},{"code":"$EG","name":"Enumerate setting groups","desc":"Lists the hierarchy of setting groups.","keywords":["groups","settings","enumerate"]},{"code":"$pins","name":"Enumerate pins","desc":"Lists processor pin assignments — which MCU pin does what.","keywords":["pins","mapping","enumerate"]},{"code":"$pinstate","name":"Pin states","desc":"Shows the live state of auxiliary pins — great for debugging wiring.","keywords":["pins","state","debug","aux"]},{"code":"$SPINDLES","name":"Enumerate spindles","desc":"Lists configured spindles and their numbers (for M104 P selection on multi-spindle setups).","keywords":["spindles","enumerate","list","dual spindle"]},{"code":"$F","name":"List files","desc":"Lists G-code files in the current directory on SD/LittleFS. $F+ lists all files; $F=<file> runs one; $FD=<file> deletes; $FM/$FU mount/unmount; $CWD= changes directory; $PWD prints it.","keywords":["files","sd card","list","run file","littlefs"]},{"code":"$RST","name":"Restore defaults","desc":"$RST=$ restores settings to defaults, $RST=# clears WCS/G28/G30 offsets, $RST=* resets everything. Irreversible — note your settings first.","keywords":["reset","restore","defaults","factory"]},{"code":"$REBOOT","name":"Reboot controller","desc":"Hard-resets the controller. The connection drops.","keywords":["reboot","restart","reset"]},{"code":"$TTLOAD","name":"Reload tool table","desc":"Reloads the tool table from storage.","keywords":["tool table","reload"]}],"letters":{"X":"X-axis coordinate/value","Y":"Y-axis coordinate/value","Z":"Z-axis coordinate/value","A":"A-axis (rotary) value","B":"B-axis value","C":"C-axis value","U":"U-axis value","V":"V-axis value","F":"Feed rate (modal — persists until changed)","S":"Spindle speed / laser power (used by M3/M4)","T":"Tool select (pre-selects for M6)","I":"Arc center offset from start, X direction","J":"Arc center offset from start, Y direction","K":"Arc center offset from start, Z direction","R":"Radius, or retract plane in canned cycles","P":"Parameter: dwell seconds, WCS/port/macro number (command-dependent)","Q":"Parameter: peck depth, value, tool number (command-dependent)","L":"Parameter: repeat count or data mode (command-dependent)","H":"Tool table index for length offset (G43)","D":"Parameter: max RPM cap (G96) or tool radius index","N":"Line number (ignored by execution)","E":"Analog port (plugin M-codes)","O":"Program label / subroutine number","W":"W-axis value, or white channel (M150)"},"initialTab":"reference","initialQuery":"","initialExplain":"","maxResults":8,"showSettingsTab":true} is replaced with the JSON data
     bundle (database + initial state) either at plugin build time
     (config.html) or at dialog-open time (commands.js). -->
<style>
  .gref { font-family: system-ui, -apple-system, sans-serif;
          color: var(--color-text-primary, #e8eaed);
          display: flex; flex-direction: column;
          /* dynamic with the window, capped so the category chips settle
             into two rows maximum (top row wider than bottom). 960px is a
             fallback - at boot the script measures the first 8 rendered
             chips and pins max-width to exactly that row, so the cap
             tracks the host app's real button sizing. Narrower windows
             wrap chips onto more rows responsively. */
          width: 92vw; max-width: 960px;
          height: 75vh; min-height: 420px;
          overflow-x: hidden; }
  .gref * { box-sizing: border-box; }
  .gref code, .gref .mono { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }

  /* --- header: search --- */
  .gref-head { padding: 12px 16px; border-bottom: 1px solid var(--color-border, #333a45);
               display: flex; flex-direction: column; gap: 8px; }
  .gref-search { width: 100%; padding: 10px 12px; font-size: 0.95rem;
                 background: var(--color-surface-muted, #232a33); color: var(--color-text-primary, #e8eaed);
                 border: 1px solid var(--color-border, #333a45); border-radius: var(--radius-small, 6px); }
  .gref-search:focus { outline: none; border-color: var(--color-accent, #10b981); }
  .gref-chips { display: flex; flex-wrap: wrap; gap: 6px; }
  .gref-chip { padding: 3px 10px; font-size: 0.75rem; border-radius: 999px;
               border: 1px solid var(--color-border, #333a45); background: transparent;
               color: var(--color-text-secondary, #9aa4b2); cursor: pointer; }
  .gref-chip.active { background: var(--color-accent, #10b981); border-color: var(--color-accent, #10b981); color: #fff; }

  /* --- results --- */
  .gref-body { flex: 1; overflow-y: auto; padding: 16px; }
  .gref-count { font-size: 0.75rem; color: var(--color-text-secondary, #9aa4b2); margin-bottom: 8px; }
  .gref-card { border: 1px solid var(--color-border, #333a45); border-radius: var(--radius-small, 6px);
               margin-bottom: 8px; background: var(--color-surface-muted, #232a33); overflow: hidden; }
  .gref-card-head { display: flex; align-items: center; gap: 8px;
                    padding: 10px 12px; cursor: pointer; user-select: none; }
  .gref-card-head:hover { background: var(--color-surface, #1a2027); }
  .gref-codechip { font-family: ui-monospace, Menlo, Consolas, monospace; font-weight: 700;
                   font-size: 0.85rem; color: var(--color-accent, #10b981);
                   background: var(--color-surface, #1a2027); border: 1px solid var(--color-border, #333a45);
                   padding: 2px 8px; border-radius: var(--radius-small, 6px); white-space: nowrap; }
  .gref-name { flex: 1; font-size: 0.9rem; }
  .gref-badge { font-size: 0.65rem; text-transform: uppercase; letter-spacing: 0.05em;
                color: var(--color-text-secondary, #9aa4b2); border: 1px solid var(--color-border, #333a45);
                padding: 1px 7px; border-radius: 999px; white-space: nowrap; }
  .gref-caret { color: var(--color-text-secondary, #9aa4b2); font-size: 0.7rem; transition: transform 0.15s; }
  .gref-card.open .gref-caret { transform: rotate(90deg); }
  .gref-detail { display: none; padding: 0 12px 12px; font-size: 0.85rem; line-height: 1.5; }
  .gref-card.open .gref-detail { display: block; }
  .gref-detail p { margin: 8px 0; }
  .gref-label { font-size: 0.65rem; text-transform: uppercase; letter-spacing: 0.06em;
                color: var(--color-text-secondary, #9aa4b2); margin: 10px 0 4px; }
  .gref-pre { background: var(--color-surface, #1a2027); border: 1px solid var(--color-border, #333a45);
              border-radius: var(--radius-small, 6px); padding: 8px 10px; margin: 4px 0;
              font-family: ui-monospace, Menlo, Consolas, monospace; font-size: 0.8rem;
              white-space: pre-wrap; overflow-x: auto; }
  .gref-params { width: 100%; border-collapse: collapse; margin: 4px 0; font-size: 0.8rem; }
  .gref-params td { padding: 4px 8px; border-top: 1px solid var(--color-border, #333a45); vertical-align: top; }
  .gref-params td:first-child { font-family: ui-monospace, Menlo, Consolas, monospace;
                                font-weight: 700; color: var(--color-accent, #10b981); width: 3.5em; }
  .gref-tip { border-left: 3px solid var(--color-accent, #10b981); padding: 6px 10px; margin: 8px 0;
              background: var(--color-surface, #1a2027); border-radius: 0 var(--radius-small, 6px) var(--radius-small, 6px) 0;
              color: var(--color-text-secondary, #9aa4b2); font-size: 0.8rem; }
  .gref-empty { text-align: center; color: var(--color-text-secondary, #9aa4b2); padding: 40px 20px; font-size: 0.9rem; }

  .gref-settings { flex: 1; overflow-y: auto; padding: 12px 0; display: none; }
  .gcfg { font-family: system-ui, -apple-system, sans-serif;
          color: var(--color-text-primary, #e8eaed); }
  .gcfg-card { border: 1px solid var(--color-border, #333a45);
               border-radius: var(--radius-small, 6px);
               background: var(--color-surface-muted, #232a33);
               padding: 14px 16px; margin: 0 16px 12px; }
  .gcfg-title { font-weight: 600; font-size: 0.9rem; margin-bottom: 8px; }
  .gcfg-row { display: flex; align-items: center; gap: 10px; margin: 10px 0; font-size: 0.9rem; }
  .gcfg-hint { color: var(--color-text-secondary, #9aa4b2); font-size: 0.78rem; margin: 2px 0 0 26px; }
  .gcfg input[type="number"] { width: 90px !important; padding: 6px 8px; }
  .gcfg code { font-family: ui-monospace, Menlo, Consolas, monospace;
               background: var(--color-surface, #1a2027); border: 1px solid var(--color-border, #333a45);
               padding: 1px 5px; border-radius: 4px; font-size: 0.8em; }
  .gcfg-status { font-size: 0.75rem; color: var(--color-accent, #10b981); min-height: 1em; margin-left: 26px; }

  /* --- explain tab --- */
  .gref-exwrap { display: flex; flex-direction: column; gap: 8px; min-height: 100%; }
  .gref-exinput { width: 100%; resize: vertical; padding: 10px 12px;
                  font-family: ui-monospace, Menlo, Consolas, monospace; font-size: 0.85rem;
                  background: var(--color-surface-muted, #232a33); color: var(--color-text-primary, #e8eaed);
                  border: 1px solid var(--color-border, #333a45); border-radius: var(--radius-small, 6px); }
  .gref-btn { align-self: flex-start; padding: 8px 20px; border: none; cursor: pointer;
              background: var(--color-accent, #10b981); color: #fff; font-size: 0.85rem;
              border-radius: var(--radius-small, 6px); }
  .gref-exline { border: 1px solid var(--color-border, #333a45); border-radius: var(--radius-small, 6px);
                 background: var(--color-surface-muted, #232a33); margin-bottom: 8px; }
  .gref-exline-src { padding: 8px 12px; border-bottom: 1px solid var(--color-border, #333a45);
                     font-family: ui-monospace, Menlo, Consolas, monospace; font-size: 0.85rem;
                     color: var(--color-accent, #10b981);
                       white-space: pre-wrap; overflow-wrap: anywhere; }
  .gref-exline-words { padding: 4px 0; }
  .gref-word { display: flex; gap: 10px; padding: 5px 12px; font-size: 0.83rem; align-items: baseline; }
  .gref-word + .gref-word { border-top: 1px dashed var(--color-border, #333a45); }
  .gref-word-tok { font-family: ui-monospace, Menlo, Consolas, monospace; font-weight: 700;
                   min-width: 5.5em; color: var(--color-accent, #10b981); }
  .gref-word-desc { flex: 1; color: var(--color-text-primary, #e8eaed); }
  .gref-word-desc .sub { color: var(--color-text-secondary, #9aa4b2); }
  .gref-word.unknown .gref-word-tok { color: var(--color-text-secondary, #9aa4b2); }
  .gref-foot { padding: 8px 16px; border-top: 1px solid var(--color-border, #333a45);
               font-size: 0.72rem; color: var(--color-text-secondary, #9aa4b2); }
  .gref-foot code { background: var(--color-surface-muted, #232a33); padding: 1px 5px;
                    border-radius: 4px; border: 1px solid var(--color-border, #333a45); }
</style>

<div class="gref" id="gref-root">
  <div class="gref-tabsbar" style="display:flex;gap:6px;padding:0 16px;border-bottom:1px solid var(--color-border, #333a45)">
    <button class="gref-tab" id="gref-tab-reference" onclick="grefSwitchTab('reference')">
      <span class="gref-tab-ic" style="display:inline-flex"><svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z"/><path d="M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z"/></svg></span>
      <span>Reference</span>
    </button>
    <button class="gref-tab" id="gref-tab-explain" onclick="grefSwitchTab('explain')">
      <span class="gref-tab-ic" style="display:inline-flex"><svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg></span>
      <span>G-code</span>
    </button>
    <button class="gref-tab" id="gref-tab-navigator" onclick="grefSwitchTab('navigator')">
      <span class="gref-tab-ic" style="display:inline-flex"><svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="3 11 22 2 13 21 11 13 3 11"/></svg></span>
      <span>Explorer</span>
    </button>
    <button class="gref-tab" id="gref-tab-manual" onclick="grefSwitchTab('manual')">
      <span class="gref-tab-ic" style="display:inline-flex"><svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/></svg></span>
      <span>NC Manual</span>
    </button>
    <button class="gref-tab" id="gref-tab-settings" style="display:none" onclick="grefSwitchTab('settings')">
      <span class="gref-tab-ic" style="display:inline-flex"><svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 1 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 1 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 1 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 1 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg></span>
      <span>Settings</span>
    </button>
  </div>
  <div class="gref-head">
    <div id="gref-panel-search">
      <input class="gref-search" id="gref-search" type="text"
             placeholder="Search: G38.2, $110, dwell, tool change, laser..."
             autocomplete="off" spellcheck="false">
      <div class="gref-chips" id="gref-chips" style="margin-top:8px"></div>
    </div>
  </div>

  <div class="gref-settings" id="gref-settings">
    <div class="gcfg">
      <div class="gcfg-card">
        <div class="gcfg-title">Terminal lookup</div>
        <div class="gcfg-row">
          <input type="checkbox" id="gcfg-terminal-lookup" style="width:auto !important">
          <label for="gcfg-terminal-lookup" style="margin:0;font-weight:400">
            Enable <code>?keyword</code> / <code>??line</code> in the Console
          </label>
        </div>
        <div class="gcfg-hint">Typing <code>?dwell</code> or <code>??G1 X10 F500</code> opens documentation
          instead of sending the text to the controller; <code>??</code> alone opens this reference unfiltered.
          A bare <code>?</code> (status query) is never intercepted.
          The dialog pauses command streaming while open, so avoid lookups mid-job.</div>
        <div class="gcfg-status" id="gcfg-status"></div>
      </div>

      <div class="gcfg-card">
        <div class="gcfg-title">About this reference</div>
        <div style="font-size:0.83rem;line-height:1.55;color:var(--color-text-primary,#e8eaed)">
          <p style="margin:6px 0"><b>Sources.</b> The documentation in this plugin is compiled from:</p>
          <ul style="margin:4px 0 10px 18px;padding:0">
            <li><a href="https://resources.sienci.com/view/slb-firmware-flashing/" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">Sienci Labs SLB/SLB&#8209;EXT firmware documentation</a> &mdash; the official settings tables, including SLB&#8209;EXT factory defaults and Sienci&rsquo;s &ldquo;unused&rdquo;/&ldquo;advanced&rdquo; notes.</li>
            <li><a href="https://github.com/grblHAL/core" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">grblHAL core source</a> &mdash; the canonical setting registry and descriptions for mainline (Main_grblHAL) builds, including settings the Sienci tables don&rsquo;t cover and the current numbering (e.g. laser XY offset at $770/$771, formerly $741/$742 on SLB 5.0.x firmware).</li>
            <li><a href="https://petervanderwalt.github.io/grblhal_docs/" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">grblHAL community docs</a> &mdash; the complete G&#8209;code and M&#8209;code reference the command entries are based on.</li>
            <li><a href="https://github.com/siganberg/ncSender" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">ncSender</a> &mdash; the plugin API, and the <code>/api/firmware</code> endpoint (ncSender&rsquo;s cache of your controller&rsquo;s own <code>$ES</code>/<code>$$</code> enumeration) that powers the live &ldquo;on this controller&rdquo; check.</li>
            <li><a href="https://plugins.octoprint.org/plugins/marlingcodedocumentation/" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">OctoPrint Marlin G&#8209;code Documentation</a> &mdash; the plugin that inspired this one.</li>
            <li><a href="https://github.com/siganberg/ncsender-plugin-rapidchangeatc" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">Rapid Change ATC</a>, <a href="https://github.com/siganberg/ncsender-plugin-manualtoolchanger" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">Manual Tool Changer</a>, <a href="https://github.com/siganberg/ncsender-plugin-pneumaticatc" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">Pneumatic ATC</a> and <a href="https://github.com/siganberg/ncsender-plugin-autodustboot" target="_blank" rel="noopener" style="color:var(--color-accent,#10b981)">AutoDustboot</a> plugin repositories &mdash; the source for the console commands documented under <em>Plugin codes</em> (<code>$TLS</code>, <code>$SLOT&lt;n&gt;</code>, <code>$POCKET1</code>, <code>$ADB_RETRACT</code>/<code>$ADB_EXPAND</code>).</li>
          </ul>
          <p style="margin:6px 0"><b>Which controllers this applies to.</b> ncSender can drive both grblHAL and FluidNC machines; this reference is written for the grblHAL dialect:</p>
          <ul style="margin:4px 0 6px 18px;padding:0">
            <li><b>Sienci SLB / SLB&#8209;EXT (grblHAL)</b> &mdash; fully covered. Defaults are labeled &ldquo;SLB&#8209;EXT default&rdquo;, Sienci&#8209;specific settings (button macros $450s, ring/rail LEDs $664/$665, spindle slots $511+) are included, and entries note where Main_grblHAL renumbered older SLB 5.0.x settings.</li>
            <li><b>Other grblHAL boards</b> &mdash; core G/M&#8209;codes and settings apply as documented; Sienci&#8209;specific entries will simply be flagged &ldquo;not on this controller&rdquo; by the live check, since every grblHAL build only exposes the settings its features compile in.</li>
            <li><b>FluidNC</b> &mdash; the basic G&#8209;code entries (motion, coordinate systems, spindle/coolant M&#8209;codes) largely apply since FluidNC descends from Grbl, but the numbered <code>$</code> settings do <b>not</b>: FluidNC is configured through a YAML file and <code>$/</code> tree commands instead. grblHAL extensions (G65 macros, M62&#8211;M68 I/O, canned cycles, plugin M&#8209;codes, <code>$ES</code>) are unavailable there, and the live controller check will report &ldquo;controller settings unavailable&rdquo;.</li>
            <li><b>Classic Grbl 1.1</b> &mdash; the $0&#8211;$132 settings and core G/M&#8209;codes align; everything beyond that is grblHAL&#8209;only.</li>
          </ul>
          <p style="margin:6px 0;color:var(--color-text-secondary,#9aa4b2)">The live check reads ncSender&rsquo;s cached controller enumeration &mdash; after flashing new firmware, refresh ncSender&rsquo;s Firmware tab once so the cache re&#8209;queries, and this reference picks it up on next open.</p>
        </div>
      </div>
    </div>
  </div>

  <div class="gref-manual" id="gref-manual" style="display:none;flex:1;flex-direction:column;min-height:0">
    <div style="display:flex;align-items:center;gap:8px;padding:8px 16px;font-size:0.78rem;color:var(--color-text-secondary,#9aa4b2)">
      <span>Browsing the official ncSender manual</span>
      <span style="flex:1"></span>
      <a href="https://siganberg.github.io/ncSender.manual/" target="_blank" rel="noopener"
         style="color:var(--color-accent,#10b981);text-decoration:none">Open in new tab &#8599;</a>
    </div>
    <iframe id="gref-manual-frame" title="ncSender Manual"
            style="flex:1;width:100%;border:0;border-top:1px solid var(--color-border,#333a45);background:#fff"></iframe>
  </div>

  <div class="gref-body" id="gref-body"></div>
  <div id="gn-host" style="display:none;flex:1;min-height:0;min-width:0;overflow:hidden"></div>

  <div class="gref-foot" id="gref-foot">
    Terminal shortcuts: <code>?keyword</code> looks up docs (e.g. <code>?dwell</code>, <code>?$110</code>) &nbsp;&middot;&nbsp;
    <code>??G1 X10 F500</code> explains a line word by word &nbsp;&middot;&nbsp;
    <code>??</code> on its own opens this reference, unfiltered. Run <code>$ES</code> / <code>$EE</code> / <code>$EA</code> on the controller to enumerate everything your build supports.
  </div>
</div>

<script>
  (function () {
    var DATA = {"gcodes":[{"code":"G0","aliases":["G00"],"name":"Rapid Positioning","category":"motion","modal":"Motion Mode","desc":"Moves at the machine's maximum travel rate to the target position. Non-cutting move used to reposition quickly between operations. The F word is ignored; speed comes from $110-$115 max rates.","syntax":"G0 <axes>","params":{"X":"Target X coordinate","Y":"Target Y coordinate","Z":"Target Z coordinate","A":"Target A (rotary) coordinate","B":"Target B coordinate","C":"Target C coordinate"},"example":"G90 G0 X100 Y50","tips":"Retract Z to a safe height before rapid XY moves. Modal: stays active until another motion command (G1/G2/G3...) is issued.","keywords":["rapid","move","travel","position","fast","jog"]},{"code":"G1","aliases":["G01"],"name":"Linear Interpolation (Feed Move)","category":"motion","modal":"Motion Mode","desc":"Straight-line move at the programmed feed rate. The primary command for cutting and engraving. All specified axes move in a coordinated straight line.","syntax":"G1 <axes> F<feed>","params":{"X":"Target X coordinate","Y":"Target Y coordinate","Z":"Target Z coordinate","A":"Target A coordinate","B":"Target B coordinate","C":"Target C coordinate","F":"Feed rate (units/min in G94)"},"example":"G1 X200 F500","tips":"F is modal — once set it applies to all following feed moves. A feed rate must be active or the move errors out.","keywords":["linear","cut","feed","straight","line","mill","engrave"]},{"code":"G2","aliases":["G02"],"name":"Arc — Clockwise","category":"motion","modal":"Motion Mode","desc":"Clockwise circular arc at the current feed rate on the active plane (G17/G18/G19). Adding the off-plane axis produces helical motion. Defined by center offsets (I/J/K) or radius (R).","syntax":"G2 X- Y- (I- J- | R-) F-","params":{"X":"Arc end X","Y":"Arc end Y","Z":"Arc end Z (helical if off-plane)","I":"X offset from start point to arc center","J":"Y offset from start point to arc center","K":"Z offset from start point to arc center","R":"Arc radius (alternative to IJK)","P":"Number of full circles","F":"Feed rate"},"example":"G17 G2 X10 Y10 I10 J0 F200","tips":"IJK center-offset form is preferred — it is unambiguous. In R form, positive R gives the shorter (<180°) arc, negative R the longer one.","keywords":["arc","circle","clockwise","cw","helix","helical","radius","curve"]},{"code":"G3","aliases":["G03"],"name":"Arc — Counter-Clockwise","category":"motion","modal":"Motion Mode","desc":"Counter-clockwise circular arc at the current feed rate on the active plane. Otherwise identical to G2, including IJK/R forms and helical motion.","syntax":"G3 X- Y- (I- J- | R-) F-","params":{"X":"Arc end X","Y":"Arc end Y","Z":"Arc end Z (helical if off-plane)","I":"X offset to arc center","J":"Y offset to arc center","K":"Z offset to arc center","R":"Arc radius (alternative to IJK)","P":"Number of full circles","F":"Feed rate"},"example":"G3 X20 Y0 R10 F200","tips":"Direction is judged looking at the active plane from the positive side of its normal axis (for G17, looking down at XY).","keywords":["arc","circle","counterclockwise","ccw","helix","curve"]},{"code":"G4","aliases":["G04"],"name":"Dwell (Pause)","category":"motion","modal":null,"desc":"Pauses motion for a set time. Spindle, coolant and other outputs keep their current state. Useful for letting a spindle spin up or clearing chips at hole bottom.","syntax":"G4 P<seconds>","params":{"P":"Dwell time in seconds (decimals allowed)"},"example":"M3 S18000\nG4 P2  ; wait 2s for spindle spin-up","tips":"Non-modal — only affects its own block. Any queued motion completes before the pause begins.","keywords":["dwell","pause","wait","delay","sleep","timer"]},{"code":"G5","aliases":["G5.1"],"name":"Spline Interpolation","category":"motion","modal":"Motion Mode","desc":"Moves along a quadratic (G5) or cubic (G5.1) spline defined by control points, producing smoother free-form curves than arcs. Nearly always generated by CAM rather than written by hand.","syntax":"G5 X- Y- I- J- P- | G5.1 X- Y- I- J- K- L-","params":{"X":"Spline end X","Y":"Spline end Y","Z":"Spline end Z","I":"Control point offset","J":"Control point offset","K":"Control point (cubic)","L":"Control point (cubic)","P":"Second control point (G5)","F":"Feed rate"},"example":"G5 X20 Y10 I10 J15 F100","tips":"Elliptical arcs cannot be produced by combining splines with G51 scaling.","keywords":["spline","curve","bezier","smooth","nurbs"]},{"code":"G7","aliases":[],"name":"Lathe Diameter Mode","category":"modes","modal":"Lathe Mode","desc":"Lathe only ($32=2): X-axis values are interpreted as workpiece diameters. G1 X50 moves the tool to produce a 50-unit diameter.","syntax":"G7","params":{},"example":"G7\nG0 X20 Z0","tips":"Most lathe CAM outputs diameter mode. Machine coordinates always display as radius.","keywords":["lathe","diameter","turning"]},{"code":"G8","aliases":[],"name":"Lathe Radius Mode","category":"modes","modal":"Lathe Mode","desc":"Lathe only ($32=2): X-axis values are interpreted as radii. G1 X25 produces a 50-unit diameter.","syntax":"G8","params":{},"example":"G8\nG0 X25 Z0","tips":"Set G7 or G8 explicitly at the top of every lathe program.","keywords":["lathe","radius","turning"]},{"code":"G10 L2","aliases":["G10"],"name":"Set WCS Origin (Absolute)","category":"coords","modal":null,"desc":"Programmatically sets a work coordinate system origin relative to the machine origin. P selects the WCS (P1=G54 ... P9=G59.3). Values persist across resets.","syntax":"G10 L2 P<1-9> <axes>","params":{"L":"Data mode: 2 = absolute from machine zero","P":"WCS number: 1=G54, 2=G55 ... 9=G59.3","X":"New origin X (machine coords)","Y":"New origin Y","Z":"New origin Z"},"example":"G10 L2 P2 X100 Y250.5 Z-20  ; set G55 origin","tips":"Omitted axes are left unchanged. Great for repeatable multi-fixture setups.","keywords":["work offset","wcs","zero","origin","coordinate","fixture","g54","set zero"]},{"code":"G10 L20","aliases":[],"name":"Set WCS Origin (From Current Position)","category":"coords","modal":null,"desc":"Sets a work coordinate system origin so the machine's current position becomes the given coordinate. \"Make here X0 Y0\" — this is what most senders send when you click Zero.","syntax":"G10 L20 P<1-9> <axes>","params":{"L":"Data mode: 20 = relative to current position","P":"WCS number: 1=G54 ... 9=G59.3","X":"Value current X should read","Y":"Value current Y should read","Z":"Value current Z should read"},"example":"G10 L20 P1 X0 Y0  ; current spot becomes G54 X0 Y0","tips":"Preferred over G92 for zeroing — the offset is stored in the WCS and survives resets.","keywords":["zero","touch off","work offset","wcs","origin","set zero","xyz zero"]},{"code":"G17","aliases":[],"name":"XY Plane Select","category":"modes","modal":"Plane Select","desc":"Selects the XY plane for arcs, cutter compensation and canned cycles. Default on startup. Arcs use I (X offset) and J (Y offset).","syntax":"G17","params":{},"example":"G17\nG2 X10 Y15 I5 J0 F300","tips":"Set the plane explicitly at program start; arcs on the wrong plane move in surprising directions.","keywords":["plane","xy","arc plane"]},{"code":"G18","aliases":[],"name":"XZ Plane Select","category":"modes","modal":"Plane Select","desc":"Selects the XZ plane (lathes, side profiling). Arcs use I (X offset) and K (Z offset).","syntax":"G18","params":{},"example":"G18\nG3 X20 Z-5 I10 K0 F250","tips":null,"keywords":["plane","xz","lathe plane"]},{"code":"G19","aliases":[],"name":"YZ Plane Select","category":"modes","modal":"Plane Select","desc":"Selects the YZ plane. Arcs use J (Y offset) and K (Z offset).","syntax":"G19","params":{},"example":"G19\nG2 Y10 Z-2 J5 K0 F250","tips":null,"keywords":["plane","yz"]},{"code":"G20","aliases":[],"name":"Inch Units","category":"modes","modal":"Units","desc":"All coordinates, offsets and feed rates are interpreted as inches (feeds in inches/min).","syntax":"G20","params":{},"example":"G20\nG1 X4 F20","tips":"Put G20 or G21 at the top of every file — a 10 mm move read as 10 inches is a crash. Display units are separate ($13).","keywords":["inch","inches","imperial","units"]},{"code":"G21","aliases":[],"name":"Millimeter Units","category":"modes","modal":"Units","desc":"All coordinates, offsets and feed rates are interpreted as millimeters (feeds in mm/min).","syntax":"G21","params":{},"example":"G21\nG1 X100 F500","tips":"Interpreter units only — does not change steps/mm calibration ($100-$102) or the report units ($13).","keywords":["mm","millimeter","metric","units"]},{"code":"G28","aliases":[],"name":"Go to Stored Position 1","category":"coords","modal":null,"desc":"Rapid move to the position stored by G28.1 (in machine coordinates). With axis words, first moves through that intermediate point, then to the stored position.","syntax":"G28 [<axes>]","params":{"X":"Intermediate X before final move","Y":"Intermediate Y","Z":"Intermediate Z"},"example":"G53 G0 Z0\nG28  ; retract, then go to park position","tips":"DANGER: only use on a homed machine — the stored position is in machine coordinates. G28 Z0 lifts Z (in the current WCS) before traveling.","keywords":["park","home position","stored position","safe position","predefined"]},{"code":"G28.1","aliases":[],"name":"Store Position 1","category":"coords","modal":null,"desc":"Saves the machine's current absolute position as the G28 target. Persists across resets and power cycles.","syntax":"G28.1","params":{},"example":"G53 G0 X-50 Y-50 Z-5\nG28.1","tips":"Move with G53 first so the stored spot is independent of work offsets. Takes no axis words.","keywords":["store","save position","park","set park"]},{"code":"G30","aliases":[],"name":"Go to Stored Position 2","category":"coords","modal":null,"desc":"Same as G28 but uses the second stored position (set by G30.1). Commonly used for a tool-change or probing location.","syntax":"G30 [<axes>]","params":{"X":"Intermediate X","Y":"Intermediate Y","Z":"Intermediate Z"},"example":"G30","tips":"Only use on a homed machine.","keywords":["park","second position","tool change position","stored position"]},{"code":"G30.1","aliases":[],"name":"Store Position 2","category":"coords","modal":null,"desc":"Saves the current absolute machine position as the G30 target.","syntax":"G30.1","params":{},"example":"G53 G0 X-200 Y-400 Z-10\nG30.1","tips":null,"keywords":["store","save position","set park"]},{"code":"G53","aliases":[],"name":"Move in Machine Coordinates","category":"coords","modal":null,"desc":"For one block only, moves in the absolute machine coordinate system, ignoring all work offsets, G92 and tool offsets. Must be combined with G0 or G1.","syntax":"G53 G0 <axes> | G53 G1 <axes> F-","params":{"X":"Machine X target","Y":"Machine Y target","Z":"Machine Z target","F":"Feed rate (with G1)"},"example":"G53 G0 Z0  ; retract Z fully, regardless of offsets","tips":"G53 G0 Z0 is one of the safest moves in G-code — but only on a homed machine. Reverts to the active WCS on the next line.","keywords":["machine coordinates","absolute","retract","safe move","ignore offsets"]},{"code":"G54","aliases":["G55","G56","G57","G58","G59","G59.1","G59.2","G59.3"],"name":"Work Coordinate Systems","category":"coords","modal":"WCS","desc":"Selects one of nine work coordinate systems (G54-G59.3), each with its own user-set origin. Separates the program zero from machine home. G54 is the default.","syntax":"G54 | G55 | ... | G59.3","params":{},"example":"G54\n(run part 1)\nG55\n(run same file on fixture 2)","tips":"Origins are set with G10 L2/L20 or the Zero buttons and are stored persistently. G59.3 doubles as the tool change position in tool change modes 2 & 3.","keywords":["wcs","work coordinate","offset","g55","g56","g57","g58","g59","fixture","datum"]},{"code":"G92","aliases":[],"name":"Temporary Coordinate Offset","category":"coords","modal":"G92 Offset","desc":"Applies a volatile offset so the current position reads as the given values (\"you are now X0 Y0\"). Applied on top of the active WCS. Cleared by G92.1.","syntax":"G92 <axes>","params":{"X":"Value current X should read","Y":"Value current Y should read","Z":"Value current Z should read","A":"Value current A should read"},"example":"G92 X0 Y0 Z0","tips":"Easy to forget and a common crash cause — prefer G10 L20 with a spare WCS. $384 controls whether the offset persists across resets.","keywords":["offset","temporary zero","shift","coordinate offset"]},{"code":"G92.1","aliases":["G92.2","G92.3"],"name":"Clear / Suspend / Restore G92","category":"coords","modal":"G92 Offset","desc":"G92.1 clears the G92 offset (and zeroes the stored values). G92.2 suspends it without erasing. G92.3 re-applies a suspended offset.","syntax":"G92.1 | G92.2 | G92.3","params":{},"example":"G92.1  ; back to the plain G54 system","tips":null,"keywords":["clear offset","cancel g92","reset offset"]},{"code":"G38.2","aliases":[],"name":"Probe Toward (Error on Miss)","category":"probing","modal":null,"desc":"Moves toward the target until the probe input triggers, then stops and records the trigger position. Raises an error if the target is reached without contact.","syntax":"G38.2 <axes> F<feed>","params":{"X":"Probe travel limit X","Y":"Probe travel limit Y","Z":"Probe travel limit Z","F":"Probing feed rate"},"example":"G91 G38.2 Z-20 F100  ; probe down max 20mm","tips":"Probe fast to find the surface, back off, then re-probe slowly for accuracy. The trigger position is reported and stored in probe parameters (see $# output, PRB).","keywords":["probe","touch","toolsetter","surface","zero probe","touch plate","probing"]},{"code":"G38.3","aliases":[],"name":"Probe Toward (No Error on Miss)","category":"probing","modal":null,"desc":"Like G38.2, but completing the move without contact is not an error. Useful for checking whether something is present.","syntax":"G38.3 <axes> F<feed>","params":{"X":"Probe travel limit X","Y":"Probe travel limit Y","Z":"Probe travel limit Z","F":"Probing feed rate"},"example":"G38.3 Z-10 F150","tips":"Check the probe result flag in the report to see whether contact happened.","keywords":["probe","optional","check","detect","probing"]},{"code":"G38.4","aliases":[],"name":"Probe Away (Error on Fail)","category":"probing","modal":null,"desc":"Moves away until the probe input releases (loses contact). Errors if the probe starts un-triggered or never releases within the move.","syntax":"G38.4 <axes> F<feed>","params":{"X":"Travel limit X","Y":"Travel limit Y","Z":"Travel limit Z","F":"Probing feed rate"},"example":"G91 G38.4 Z5 F100","tips":null,"keywords":["probe away","release","retract probe","probing"]},{"code":"G38.5","aliases":[],"name":"Probe Away (No Error on Fail)","category":"probing","modal":null,"desc":"Like G38.4 but does not error if the probe never releases within the move.","syntax":"G38.5 <axes> F<feed>","params":{"X":"Travel limit X","Y":"Travel limit Y","Z":"Travel limit Z","F":"Probing feed rate"},"example":"G38.5 G91 Z50 F200","tips":null,"keywords":["probe away","optional","probing"]},{"code":"G40","aliases":[],"name":"Cancel Cutter Compensation","category":"tool","modal":"Cutter Comp","desc":"Disables cutter radius compensation. This is the default state; full G41/G42 compensation is not in the grblHAL core (plugin territory), so G40 mainly guarantees a known state.","syntax":"G40","params":{},"example":"G40","tips":"Include in your safety preamble: G90 G21 G17 G40 G49 G80 G94.","keywords":["cutter compensation","comp","cancel","g41","g42"]},{"code":"G43.1","aliases":[],"name":"Dynamic Tool Length Offset","category":"tool","modal":"Tool Length Offset","desc":"Applies a tool length offset given directly in the command (usually Z). Typically issued after probing a new tool to shift the Z origin by the measured length difference.","syntax":"G43.1 Z<offset>","params":{"Z":"Offset to apply to Z","A":"Offset for A","B":"Offset for B"},"example":"G43.1 Z5.2  ; tool is 5.2mm longer than reference","tips":"Cancel with G49 before tool changes and at program end.","keywords":["tool length","tlo","offset","tool offset","length compensation"]},{"code":"G43","aliases":["G43.2"],"name":"Tool Length Offset from Tool Table","category":"tool","modal":"Tool Length Offset","desc":"With a tool table enabled, G43 H<n> applies the stored Z-length offset for tool n. G43.2 adds a second, stacked offset.","syntax":"G43 H<tool> | G43.2 <axes>","params":{"H":"Tool table entry whose offset to apply","Z":"Additional offset (G43.2)"},"example":"T1 M6\nG43 H1","tips":"H should normally match the active tool number.","keywords":["tool table","tool length","h word","offset"]},{"code":"G49","aliases":[],"name":"Cancel Tool Length Offset","category":"tool","modal":"Tool Length Offset","desc":"Removes any active tool length offset.","syntax":"G49","params":{},"example":"G49\nM6 T2","tips":"Issue before M6 and at program end.","keywords":["cancel","tool length","clear offset"]},{"code":"G50","aliases":[],"name":"Cancel Scaling","category":"modes","modal":"Scaling","desc":"Disables G51 coordinate scaling, restoring 1:1 motion. Default state.","syntax":"G50","params":{},"example":"G50","tips":"On lathes in G96 mode, G50 S<rpm> also sets the max spindle RPM cap (Mach3 style).","keywords":["scaling","cancel scale","unscale"]},{"code":"G51","aliases":[],"name":"Coordinate Scaling / Mirroring","category":"modes","modal":"Scaling","desc":"Scales subsequent motion per-axis. A factor of -1 mirrors that axis. Lets you resize or flip a program without editing it.","syntax":"G51 X<f> Y<f> Z<f>","params":{"X":"X scale factor (-1 mirrors)","Y":"Y scale factor","Z":"Z scale factor"},"example":"G51 X0.5 Y0.5 Z0.5\n(half-size part)\nG50","tips":"Unequal XY factors are not allowed with G2/G3 (no elliptical arcs). Always cancel with G50.","keywords":["scale","mirror","flip","resize"]},{"code":"G81","aliases":[],"name":"Drilling Cycle","category":"cycles","modal":"Motion Mode","desc":"Simple drill cycle: rapid to R plane, feed to Z depth, rapid retract. Once active, every new XY position drills a hole until G80 cancels.","syntax":"G81 Z<depth> R<retract> F<feed>","params":{"Z":"Final hole depth","R":"Retract plane (Z height to rapid to before feeding)","F":"Drilling feed rate","L":"Optional repeat count"},"example":"G99 G81 Z-10 R2 F150\nX10 Y10\nX20\nG80","tips":"Retract height between holes is controlled by G98 (initial Z) / G99 (R plane).","keywords":["drill","hole","canned cycle","drilling"]},{"code":"G82","aliases":[],"name":"Drilling Cycle with Dwell","category":"cycles","modal":"Motion Mode","desc":"Like G81 but dwells at the bottom of the hole for P seconds — improves hole-bottom finish (spot drilling, countersinking).","syntax":"G82 Z- R- P<sec> F-","params":{"Z":"Final depth","R":"Retract plane","P":"Dwell at bottom (seconds)","F":"Feed rate"},"example":"G82 Z-3 R2 P0.5 F100","tips":null,"keywords":["drill","dwell","spot","countersink","canned cycle"]},{"code":"G83","aliases":[],"name":"Peck Drilling (Full Retract)","category":"cycles","modal":"Motion Mode","desc":"Deep-hole peck drilling: after each peck of depth Q, the drill fully retracts out of the hole to clear chips, then returns.","syntax":"G83 Z- R- Q<peck> F-","params":{"Z":"Final depth","R":"Retract plane","Q":"Depth of each peck","F":"Feed rate"},"example":"G83 Z-25 R2 Q5 F120","tips":"Use for holes deeper than ~3x drill diameter.","keywords":["peck","deep hole","drill","chip clearing","canned cycle"]},{"code":"G73","aliases":[],"name":"Peck Drilling (Chip Break)","category":"cycles","modal":"Motion Mode","desc":"High-speed peck cycle: after each peck of depth Q, retracts a small fixed amount ($28) to snap the chip without leaving the hole.","syntax":"G73 Z- R- Q<peck> F-","params":{"Z":"Final depth","R":"Retract plane","Q":"Depth of each peck","F":"Feed rate"},"example":"G73 Z-15 R2 Q4 F150","tips":"Retract amount per peck comes from setting $28.","keywords":["peck","chip break","drill","canned cycle"]},{"code":"G85","aliases":[],"name":"Boring Cycle (Feed Out)","category":"cycles","modal":"Motion Mode","desc":"Feeds to depth and feeds back out — no rapid retract inside the hole, leaving a better surface finish (reaming/boring).","syntax":"G85 Z- R- F-","params":{"Z":"Final depth","R":"Retract plane","F":"Feed rate (both directions)"},"example":"G85 Z-12 R2 F80","tips":null,"keywords":["bore","ream","finish","canned cycle"]},{"code":"G86","aliases":[],"name":"Boring Cycle (Spindle Stop)","category":"cycles","modal":"Motion Mode","desc":"Feeds to depth, stops the spindle, then rapids out.","syntax":"G86 Z- R- F-","params":{"Z":"Final depth","R":"Retract plane","F":"Feed rate"},"example":"G86 Z-12 R2 F80","tips":null,"keywords":["bore","canned cycle"]},{"code":"G89","aliases":[],"name":"Boring Cycle with Dwell","category":"cycles","modal":"Motion Mode","desc":"Feeds to depth, dwells P seconds, feeds back out.","syntax":"G89 Z- R- P<sec> F-","params":{"Z":"Final depth","R":"Retract plane","P":"Dwell (seconds)","F":"Feed rate"},"example":"G89 Z-10 R2 P1 F80","tips":null,"keywords":["bore","dwell","canned cycle"]},{"code":"G76","aliases":[],"name":"Threading Cycle (Lathe)","category":"cycles","modal":"Motion Mode","desc":"Multi-pass lathe threading cycle. Requires a spindle encoder for spindle-synchronized motion; only a few grblHAL boards support the hardware.","syntax":"G76 Z- R- I- J- K- L- P- Q- F-","params":{"Z":"Thread end","P":"Thread pitch","I":"Thread peak offset","J":"Initial cut depth","K":"Full thread depth","Q":"Compound slide angle","L":"Taper mode","R":"Depth regression","F":"Feed"},"example":"(lathe threading — see grblHAL docs)","tips":"Related: G33 spindle-synchronized motion, also encoder-dependent.","keywords":["thread","threading","lathe","tap"]},{"code":"G80","aliases":[],"name":"Cancel Canned Cycle","category":"cycles","modal":"Motion Mode","desc":"Immediately ends any active canned cycle so later coordinates are not interpreted as more holes. Critical safety command after cycle blocks.","syntax":"G80","params":{},"example":"G81 Z-10 R2 F100\nX10\nX20\nG80","tips":"Any new motion command (G0/G1/G2/G3) also cancels an active cycle.","keywords":["cancel","canned cycle","end cycle"]},{"code":"G98","aliases":[],"name":"Cycle Retract to Initial Z","category":"cycles","modal":"Cycle Return","desc":"Between canned-cycle holes, retract all the way to the Z height held before the cycle started. Safest mode — clears clamps between holes.","syntax":"G98","params":{},"example":"G0 Z20\nG98 G81 Z-5 R2 F100","tips":null,"keywords":["retract","initial","canned cycle","return"]},{"code":"G99","aliases":[],"name":"Cycle Retract to R Plane","category":"cycles","modal":"Cycle Return","desc":"Between holes, retract only to the R plane. Faster on flat unobstructed surfaces.","syntax":"G99","params":{},"example":"G99 G81 Z-5 R2 F100","tips":null,"keywords":["retract","r plane","canned cycle","return"]},{"code":"G90","aliases":[],"name":"Absolute Distance Mode","category":"modes","modal":"Distance Mode","desc":"Coordinates are destinations measured from the active WCS origin. X10 means \"go to the X=10 line\". Default mode; what most CAM output uses.","syntax":"G90","params":{},"example":"G90\nG0 X10 Y20","tips":null,"keywords":["absolute","distance mode","positioning"]},{"code":"G91","aliases":[],"name":"Incremental Distance Mode","category":"modes","modal":"Distance Mode","desc":"Coordinates are distances from the current position. X10 means \"move +10 in X from here\". Ideal for macros and probing routines that must work anywhere.","syntax":"G91","params":{},"example":"G91\nG1 X50 F300\nG1 Y30","tips":"Forgetting to switch back to G90 is a classic crash. In G91, arc IJK offsets are still measured from the arc start point.","keywords":["incremental","relative","distance mode"]},{"code":"G93","aliases":[],"name":"Inverse Time Feed Mode","category":"modes","modal":"Feed Mode","desc":"F means 1/minutes: the move must complete in 1/F minutes. Used mainly for simultaneous multi-axis (4/5-axis) motion where tool-tip speed is complex.","syntax":"G93","params":{"F":"Move completes in 1/F minutes"},"example":"G93\nG1 X10 A90 F2  ; complete in 30 seconds","tips":"F must be given on every motion line in G93.","keywords":["inverse time","feed mode","5 axis","rotary feed"]},{"code":"G94","aliases":[],"name":"Units per Minute Feed Mode","category":"modes","modal":"Feed Mode","desc":"F is linear units (mm or inch) per minute. Standard for mills and routers; the default.","syntax":"G94","params":{"F":"Feed in units/min"},"example":"G94\nG1 X100 F500","tips":null,"keywords":["feed mode","units per minute","mm/min"]},{"code":"G95","aliases":[],"name":"Units per Revolution Feed Mode","category":"modes","modal":"Feed Mode","desc":"F is units per spindle revolution — the lathe standard, tying chip load directly to RPM. Needs spindle speed feedback.","syntax":"G95","params":{"F":"Feed in units/rev"},"example":"G95\nS1000 M3\nG1 Z-50 F0.2  ; effective 200mm/min","tips":null,"keywords":["feed per rev","lathe feed","units per revolution"]},{"code":"G96","aliases":[],"name":"Constant Surface Speed (Lathe)","category":"modes","modal":"Spindle Mode","desc":"S is a surface speed; the controller varies spindle RPM with the X diameter to hold it constant at the cutting edge. Lathe builds only.","syntax":"G96 S<surface speed> [D<max rpm>]","params":{"S":"Target surface speed (m/min or ft/min)","D":"Max RPM cap"},"example":"G50 S4000\nG96 S150 M3","tips":"Always cap RPM (G50 S / D word) — RPM rises sharply as diameter shrinks.","keywords":["css","surface speed","lathe","constant speed"]},{"code":"G97","aliases":[],"name":"Constant RPM Mode","category":"modes","modal":"Spindle Mode","desc":"S is plain revolutions per minute. Default; required for drilling, tapping and threading.","syntax":"G97 S<rpm>","params":{"S":"Spindle RPM"},"example":"G97 S800 M3","tips":null,"keywords":["rpm","spindle mode","constant rpm"]},{"code":"G61","aliases":["G61.1"],"name":"Exact Stop Path Mode","category":"modes","modal":"Path Control","desc":"Machine fully stops at the end of each move before starting the next — perfectly sharp corners at the cost of speed and smoothness.","syntax":"G61","params":{},"example":"G61\n(precise engraving moves)","tips":"Can leave witness marks/divots at corners due to the momentary stop. Continuous blending is the usual default.","keywords":["exact stop","path control","corners","sharp"]},{"code":"G65","aliases":[],"name":"Macro Call with Arguments","category":"program","modal":null,"desc":"Calls a macro (P<n>.macro on SD/LittleFS) and passes letter arguments as local variables. Requires NGC expressions enabled in the firmware. P1-P7 are reserved built-ins (settings read/write, tool offsets, machine state, probe select, spindle delay skip, Modbus messaging).","syntax":"G65 P<number> [L<repeat>] [A- B- C- ...]","params":{"P":"Macro number: P100+ user macros; P1-P7 built-ins","L":"Repeat count","A":"Argument (becomes #1)","B":"Argument (#2)","C":"Argument (#3)","Q":"Argument (built-ins: setting/tool/probe number)","R":"Argument (built-ins: register/axis)","S":"Argument (built-ins: value/slave address)","I":"Argument (P3: parameter number)","F":"Argument (P7: Modbus function code)"},"example":"G65 P100 A5.0 B200  ; call P100.macro with args\nG65 P1 Q110  ; built-in: read setting $110 into _value","tips":"Notable built-ins: P1 read/write settings, P4 machine state, P5 select probe input (0 probe, 1 toolsetter), P7 Modbus (talk to a VFD from G-code). Nesting G65 is not allowed.","keywords":["macro","subprogram","call","arguments","modbus","vfd","expression","p100"]},{"code":"G66","aliases":["G67"],"name":"Modal Macro Call / Cancel","category":"program","modal":"Modal Macro","desc":"G66 works like G65 but repeats the macro after every subsequent motion command until G67 cancels it — handy for custom drilling or probing cycles at many locations.","syntax":"G66 P<number> [args] ... G67","params":{"P":"Macro number","L":"Repeat count"},"example":"G66 P110 A2\nX10 Y10\nX20\nG67","tips":null,"keywords":["modal macro","repeat","custom cycle"]},{"code":"M0","aliases":["M00"],"name":"Program Stop","category":"program","modal":null,"desc":"Unconditionally pauses the program — motion, spindle and coolant stop. Cycle Start resumes from the next line. An optional (message) shows in the sender.","syntax":"M0 [(message)]","params":{},"example":"G0 Z20\nM0 (Clear chips, then press start)","tips":"Manual tool change setups often transform M6 into M0 with a message.","keywords":["stop","pause","hold","wait","operator"]},{"code":"M1","aliases":["M01"],"name":"Optional Stop","category":"program","modal":null,"desc":"Pauses like M0, but only when the Optional Stop switch is enabled in the sender/machine; ignored otherwise. Good for inspection points you don't need every run.","syntax":"M1 [(message)]","params":{},"example":"(finishing pass)\nM1","tips":null,"keywords":["optional stop","pause","inspection"]},{"code":"M2","aliases":["M02"],"name":"Program End","category":"program","modal":null,"desc":"Ends the program, resets the parser to defaults and leaves the machine idle.","syntax":"M2","params":{},"example":"M5\nM2","tips":null,"keywords":["end","program end","finish"]},{"code":"M30","aliases":[],"name":"Program End & Rewind","category":"program","modal":null,"desc":"The standard end-of-file: does everything M2 does and rewinds to the start, ready for the next part.","syntax":"M30","params":{},"example":"G0 Z20\nM5 M9\nM30","tips":"When running from SD card, $FR before start enables rewind-and-rerun on cycle start.","keywords":["end","rewind","program end","m30"]},{"code":"M3","aliases":["M03"],"name":"Spindle On — Clockwise","category":"spindle","modal":"Spindle","desc":"Starts the spindle clockwise at the last programmed S speed. In laser mode ($32=1), fires the laser at constant power while moving.","syntax":"M3 S<rpm>","params":{"S":"Spindle speed (RPM) or laser power"},"example":"S18000 M3","tips":"With spindle-at-speed enabled ($340 tolerance) the controller waits for the VFD to reach speed. For laser engraving prefer M4 dynamic power.","keywords":["spindle","on","clockwise","cw","start spindle","laser on"]},{"code":"M4","aliases":["M04"],"name":"Spindle On — CCW / Laser Dynamic","category":"spindle","modal":"Spindle","desc":"Starts the spindle counter-clockwise (left-hand tools). In laser mode ($32=1), enables dynamic power: output scales with actual velocity so accel/decel zones don't burn darker.","syntax":"M4 S<rpm>","params":{"S":"Spindle speed (RPM) or max laser power"},"example":"M4 S800  ; laser dynamic mode","tips":"This is the mode LightBurn's grbl profiles use for engraving.","keywords":["spindle","ccw","counterclockwise","laser","dynamic power","variable power"]},{"code":"M5","aliases":["M05"],"name":"Spindle / Laser Off","category":"spindle","modal":"Spindle","desc":"Stops spindle rotation (or laser output).","syntax":"M5","params":{},"example":"M5","tips":"$394 sets a spin-down delay so motion waits for the spindle to actually stop.","keywords":["spindle off","stop","laser off"]},{"code":"M6","aliases":["M06"],"name":"Tool Change","category":"tool","modal":null,"desc":"Executes a tool change to the tool selected by T. With an ATC, runs the tool change macro (tc.macro / P200.macro for RapidChange). Without one, behavior follows $341: pause like M0, move to a change position, and/or run the manual probe protocol ($TPW).","syntax":"T<n> M6 | M6 T<n>","params":{"T":"Tool number to load"},"example":"T2 M6\nG43 H2","tips":"T only selects; M6 performs the change. Apply the new length offset (G43/G43.1) afterward. See $341-$346 for tool change configuration.","keywords":["tool change","atc","change tool","m6","rapidchange","toolchange"]},{"code":"M7","aliases":["M07"],"name":"Mist Coolant On","category":"coolant","modal":"Coolant","desc":"Turns on the mist coolant output pin (air/oil mist). Often repurposed for an air blast or accessory relay.","syntax":"M7","params":{},"example":"M7","tips":null,"keywords":["mist","coolant","air","output"]},{"code":"M8","aliases":["M08"],"name":"Flood Coolant On","category":"coolant","modal":"Coolant","desc":"Turns on the flood coolant output pin — the primary coolant output. Commonly repurposed for dust collection or a dust boot.","syntax":"M8","params":{},"example":"M8\nG1 Z-5 F300","tips":null,"keywords":["flood","coolant","dust boot","dust collection","output"]},{"code":"M9","aliases":["M09"],"name":"All Coolant Off","category":"coolant","modal":"Coolant","desc":"Turns off both mist (M7) and flood (M8) outputs.","syntax":"M9","params":{},"example":"G0 Z20\nM9","tips":null,"keywords":["coolant off","mist off","flood off"]},{"code":"M48","aliases":[],"name":"Enable Overrides","category":"program","modal":"Override","desc":"Re-enables the real-time feed, rapid and spindle override controls (the default).","syntax":"M48","params":{},"example":"M48","tips":null,"keywords":["override","enable","feed override"]},{"code":"M49","aliases":[],"name":"Disable Overrides","category":"program","modal":"Override","desc":"Ignores all override controls; the program runs at exactly 100% of programmed feed, rapid and spindle values.","syntax":"M49","params":{},"example":"M49\nG1 X100 F150\nM48","tips":"Use sparingly — it removes the operator's ability to slow a bad cut.","keywords":["override","disable","lock feed"]},{"code":"M50","aliases":["M51","M53"],"name":"Selective Override Control","category":"program","modal":null,"desc":"Granular override disabling: M50 feed override off, M51 spindle override off, M53 rapid override off. M48 re-enables all.","syntax":"M50 | M51 | M53","params":{},"example":"M50 M51\n(critical finishing pass)\nM48","tips":null,"keywords":["override","feed","spindle","rapid","selective"]},{"code":"M56","aliases":[],"name":"Parking Motion Override","category":"program","modal":null,"desc":"Enables (P1) or disables (P0) automatic parking motion. Requires parking support plus this override option compiled into the firmware.","syntax":"M56 P<0|1>","params":{"P":"1 = enable parking motion, 0 = disable"},"example":"M56 P0\n(critical moves)\nM56 P1","tips":null,"keywords":["parking","park","override"]},{"code":"M61","aliases":[],"name":"Set Current Tool","category":"tool","modal":null,"desc":"Tells the controller which tool is currently loaded (Q word) without performing a change — used to sync state after manual swaps.","syntax":"M61 Q<tool>","params":{"Q":"Tool number now in the spindle"},"example":"M61 Q3","tips":null,"keywords":["set tool","current tool","sync tool"]},{"code":"M62","aliases":["M63"],"name":"Digital Output — Synced","category":"io","modal":null,"desc":"Queues a digital output change (M62 on, M63 off) to fire at the exact start of the next motion command. Ideal for laser gating, cameras, or anything that must align with motion.","syntax":"M62 P<port> | M63 P<port>","params":{"P":"Digital output port number"},"example":"M62 P1\nG1 X20 F500  ; output 1 goes high as this move starts\nM63 P1\nG0 X30","tips":"On the plasma/THC plugin these same codes toggle torch height control.","keywords":["digital output","synchronized","io","laser gate","output on","output off"]},{"code":"M64","aliases":["M65"],"name":"Digital Output — Immediate","category":"io","modal":null,"desc":"Sets a digital output high (M64) or low (M65) immediately when read, without waiting for motion.","syntax":"M64 P<port> | M65 P<port>","params":{"P":"Digital output port number"},"example":"M400\nM64 P1  ; trigger once fully stopped","tips":"Use $pins / $pinstate in the terminal to see which aux ports exist and their live state.","keywords":["digital output","immediate","io","relay","aux output"]},{"code":"M66","aliases":[],"name":"Wait for Input","category":"io","modal":null,"desc":"Pauses execution until a digital input reaches the requested state, or a timeout expires. Requires configured aux inputs.","syntax":"M66 P<port> L<0|1> [Q<timeout s>]","params":{"P":"Digital input port number","L":"State to wait for: 0 low, 1 high","Q":"Timeout in seconds (error if exceeded)"},"example":"M66 P2 L1 Q10  ; wait up to 10s for input 2 high","tips":null,"keywords":["wait","input","sensor","io","interlock"]},{"code":"M67","aliases":["M68"],"name":"Analog Output","category":"io","modal":null,"desc":"Sets an analog output value — M67 synchronized with the next motion, M68 immediately. Used for laser power ramps, flow control, etc.","syntax":"M67 P<port> Q<value> | M68 P<port> Q<value>","params":{"P":"Analog output port number","Q":"Target analog value (range depends on DAC/PWM resolution)","E":"Port (plasma plugin velocity-reduction variant)"},"example":"M67 P0 Q150\nG1 X20 F500","tips":null,"keywords":["analog output","pwm","dac","laser power","io"]},{"code":"M70","aliases":["M71","M72","M73"],"name":"Modal State Save/Restore","category":"program","modal":null,"desc":"Saves (M70) and restores (M72) the full modal state — active G modes, feed, spindle speed — so macros can change modes freely without disturbing the main program. M71 invalidates a saved state; M73 saves with auto-restore for subprograms.","syntax":"M70 ... M72","params":{},"example":"M70\nG91 G1 F100\n(probe moves)\nM72","tips":"Wrap any probing or tool change macro in M70/M72 — cheap insurance against leaving the machine in G91.","keywords":["save state","restore","modal","macro safety"]},{"code":"M98","aliases":[],"name":"Subroutine Call","category":"program","modal":null,"desc":"Calls a subroutine: with $700=1 it first looks for an O<n> sub label in the current file, otherwise (or if not found) runs external file P<n> from SD/LittleFS. L repeats the call.","syntax":"M98 P<number> [L<repeat>]","params":{"P":"Subroutine number or filename","L":"Repeat count"},"example":"M98 P100 L3\nM30\nO100 sub\nG91 G0 X10\nM99","tips":null,"keywords":["subroutine","call","subprogram","repeat"]},{"code":"M99","aliases":[],"name":"Return from Subroutine","category":"program","modal":null,"desc":"Ends a subroutine and returns to the line after the call. In a main program it acts as rewind-and-loop. Also terminates tool change macros.","syntax":"M99","params":{"P":"Optional return line (implementation-dependent)"},"example":"M99","tips":null,"keywords":["return","subroutine","end macro"]},{"code":"M42","aliases":[],"name":"Set Digital Output (OpenPNP)","category":"plugin","modal":null,"desc":"OpenPNP plugin: directly sets a digital I/O port state.","syntax":"M42 P<port> S<0|1>","params":{"P":"I/O port number","S":"0 = off, 1 = on"},"example":"M42 P1 S1","tips":null,"keywords":["digital output","openpnp","io","relay"]},{"code":"M104","aliases":[],"name":"Select Spindle","category":"plugin","modal":null,"desc":"Spindle plugin: selects which configured spindle (VFD, PWM, laser...) subsequent S/M3/M4 commands address. Essential on dual-spindle setups.","syntax":"M104 P<spindle>","params":{"P":"Spindle number (see $SPINDLES for the list)"},"example":"M104 P1  ; switch to spindle 1 (e.g. PWM laser)","tips":"Run $SPINDLES in the terminal to enumerate configured spindles and their numbers.","keywords":["spindle select","dual spindle","laser","vfd","switch spindle","multi spindle"]},{"code":"M106","aliases":["M107"],"name":"Fan Control","category":"plugin","modal":null,"desc":"Fan plugin: M106 turns a fan on with PWM speed 0-255; M107 turns it off.","syntax":"M106 P<fan> S<0-255> | M107 P<fan>","params":{"P":"Fan index","S":"PWM duty 0-255"},"example":"M106 P0 S255","tips":null,"keywords":["fan","cooling","pwm"]},{"code":"M114","aliases":[],"name":"Report Position (Encoder)","category":"plugin","modal":null,"desc":"Encoder plugin: reports current position, including spindle encoder data when available.","syntax":"M114","params":{},"example":"M114","tips":null,"keywords":["position","report","encoder"]},{"code":"M122","aliases":[],"name":"Trinamic Driver Report","category":"plugin","modal":null,"desc":"Motor plugin: dumps Trinamic stepper driver status/debug info for the given axes.","syntax":"M122 [axes]","params":{"X":"Report X driver","Y":"Report Y driver","Z":"Report Z driver"},"example":"M122","tips":"Related: M906 set RMS current, M569 StealthChop/SpreadCycle, M911/M912 prewarn flags, M913 hybrid threshold, M914 homing sensitivity.","keywords":["trinamic","stepper","driver","debug","tmc"]},{"code":"M150","aliases":[],"name":"RGB LED Control","category":"plugin","modal":null,"desc":"Misc plugin: sets color and brightness for an RGB/RGBW LED strip or a single LED by index. Used for status lighting on machines with LED rails/rings.","syntax":"M150 [R<0-255>] [U<0-255>] [B<0-255>] [W<0-255>] [P<0-255>] [I<index>] [S<strip>] [K]","params":{"R":"Red 0-255","U":"Green 0-255","B":"Blue 0-255","W":"White 0-255","P":"Brightness 0-255","I":"LED index for individual control","S":"Strip index (0 or 1)","K":"Keep unspecified components unchanged"},"example":"M150 R255 U0 B0 S1  ; strip 1 solid red\nM150 R0 U0 B0 S1    ; off","tips":"Note green is U, not G (G would parse as a G-code).","keywords":["led","rgb","light","strip","neopixel","status light"]},{"code":"M220","aliases":[],"name":"Set Feed Override %","category":"plugin","modal":null,"desc":"Sets the feed override percentage from G-code (Marlin heritage). B backs up the current value, R restores it, S sets a percentage.","syntax":"M220 [S<percent>] [B] [R]","params":{"S":"Feed override percent (100 = programmed feed)","B":"Backup current override","R":"Restore backed-up override"},"example":"M220 S50\n(difficult section)\nM220 S100","tips":null,"keywords":["feed override","percent","slow down","speed"]},{"code":"M280","aliases":[],"name":"Set Servo Position","category":"plugin","modal":null,"desc":"Servo plugin: moves a PWM servo to a position — typically 0-180 degrees. Used for probe deployers, dust shoes, clamps.","syntax":"M280 P<servo> S<position>","params":{"P":"Servo index","S":"Target position (deg or µs)"},"example":"M280 P0 S90  ; deploy\nM280 P0 S0   ; stow","tips":null,"keywords":["servo","deploy","position","pwm"]},{"code":"M400","aliases":[],"name":"Finish Moves","category":"plugin","modal":null,"desc":"Waits for the planner buffer to fully empty before the next command — the machine is completely stationary. Roughly a G4 P0.","syntax":"M400","params":{},"example":"G0 X50 Y50\nM400\nM64 P1","tips":null,"keywords":["wait","finish","buffer","sync"]},{"code":"M810","aliases":[],"name":"ATCi Keepout Zone Toggle (Sienci)","category":"plugin","modal":null,"desc":"Sienci ATCi plugin: runtime toggle for keepout-zone enforcement around the tool magazine. P1 enables protection, P0 disables it.","syntax":"M810 P<0|1>","params":{"P":"1 = enforce keepout zone, 0 = disable"},"example":"M810 P0","tips":null,"keywords":["sienci","atc","atci","keepout","magazine"]},{"code":"$TLS","aliases":[],"name":"Tool Length Set (ATC/MTC plugins)","category":"plugin","modal":null,"desc":"Runs the tool length setter probe cycle for the currently loaded tool: raises to safe Z, rapids to the configured TLS position, probes down (G38.2), applies the measured tool length offset, and retracts. Provided by the Rapid Change ATC, Manual Tool Changer, and Pneumatic ATC plugins - the exact motions come from that plugin's settings, including any Pre/Post TLS g-code hooks.","syntax":"$TLS","params":{},"example":"$TLS","tips":"Only works when one of the tool-changer plugins is installed and enabled. The macro expansion can be shown line by line by enabling \"show macro commands\" in the plugin settings.","keywords":["tool length","tls","tool setter","probe tool","rapidchange","atc","tool changer","offset"]},{"code":"$SLOT1","aliases":["$SLOT2","$SLOT<n>"],"name":"Go To Tool Slot n (Rapid Change ATC)","category":"plugin","modal":null,"desc":"Raises to safe Z, then rapids (G53 machine coordinates) to the XY position of magazine slot n as configured in the Rapid Change ATC plugin. $SLOT1, $slot2, $SLOT03 all work - leading zeros are tolerated. Slot numbers outside the configured pocket count are deliberately left alone (they fall through to the controller as unknown commands) so a typo cannot send the spindle to a nonexistent slot.","syntax":"$SLOT<n>","params":{},"example":"$SLOT3","tips":"Provided by the Rapid Change ATC plugin - only works when it is installed and enabled. Useful for aligning the magazine or verifying slot positions without a tool change.","keywords":["slot","pocket","magazine","rapidchange","atc","tool changer","position"]},{"code":"$POCKET1","aliases":[],"name":"Go To Pocket 1 (Manual Tool Changer)","category":"plugin","modal":null,"desc":"Raises to safe Z, then rapids (G53 machine coordinates) to the Pocket 1 XY position configured in the Manual Tool Changer plugin - the parking spot where manual tool swaps happen.","syntax":"$POCKET1","params":{},"example":"$POCKET1","tips":"Provided by the Manual Tool Changer plugin - only works when it is installed and enabled.","keywords":["pocket","manual tool change","tool changer","park","position"]},{"code":"$ADB_RETRACT","aliases":[],"name":"Retract Dust Boot (AutoDustboot)","category":"plugin","modal":null,"desc":"Retracts the pneumatic dust boot. The AutoDustboot plugin injects this automatically before tool changes (M6/M98) in a loaded job, but it can also be typed in the Console or embedded in your own macros.","syntax":"$ADB_RETRACT","params":{},"example":"$ADB_RETRACT","tips":"Provided by the AutoDustboot plugin - only works when it is installed and enabled.","keywords":["dust boot","dustboot","retract","pneumatic","adb"]},{"code":"$ADB_EXPAND","aliases":[],"name":"Expand Dust Boot (AutoDustboot)","category":"plugin","modal":null,"desc":"Expands (lowers) the pneumatic dust boot. The AutoDustboot plugin injects this automatically after the first rapid XY move following a tool change, and it can also be typed in the Console or embedded in macros.","syntax":"$ADB_EXPAND","params":{},"example":"$ADB_EXPAND","tips":"Provided by the AutoDustboot plugin - only works when it is installed and enabled.","keywords":["dust boot","dustboot","expand","deploy","pneumatic","adb"]}],"settings":[{"code":"$0","name":"Step pulse time","desc":"SLB-EXT default: 5 microseconds. Sets time length per step. Minimum 2 microseconds. This needs to be reduced from the default value of 10 when max. step rates exceed approximately 80 kHz.","keywords":["invert","pulse","signal","step","stepper","time"]},{"code":"$1","name":"Step idle delay","desc":"SLB-EXT default: 254 milliseconds. Sets a short hold delay when stopping to let dynamics settle before disabling steppers. Value 255 keeps motors enabled.","keywords":["delay","idle","invert","signal","step","stepper"]},{"code":"$2","name":"Step pulse invert","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Inverts the step signals (active low).","keywords":["invert","pulse","signal","step","stepper"]},{"code":"$3","name":"Step direction invert","desc":"SLB-EXT default: X: OFF Y: ON Z: ON A: OFF (6). Inverts the direction signals (active low).","keywords":["direction","invert","signal","step","stepper"]},{"code":"$4","name":"Invert stepper enable pin(s)","desc":"SLB-EXT default: X: ON Y: ON Z: ON A: ON (15). Inverts the stepper driver enable signals. Most drivers uses active low enable requiring inversion. NOTE: If the stepper drivers shares the same enable signal only X is used.","keywords":["enable","invert","pin","signal","stepper"]},{"code":"$5","name":"Invert limit pins","desc":"SLB-EXT default: X: ON Y: ON Z: ON A: ON (15). Inverts the axis limit input signals.","keywords":["invert","limit","pins","signal","stepper"]},{"code":"$6","name":"Invert probe pin","desc":"SLB-EXT default: Enabled (1). Inverts the probe input pin signal.","keywords":["invert","pin","probe","signal","stepper"]},{"code":"$7","name":"Deprecated","desc":"Deprecated","keywords":["deprecated"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$8","name":"Ganged axes direction invert","desc":"SLB-EXT default: Disabled (0). Inverts the direction signals for the second motor used for ganged axes. NOTE: This inversion will be applied in addition to the inversion from setting $3.","keywords":["axes","direction","ganged","invert","signal","stepper"]},{"code":"$9","name":"PWM Spindle","desc":"SLB-EXT default: Enable: ON RPM controls spindle en signal: OFF (1). Enable: Controls PWM output availability. RPM controls spindle enable signal: When M3 or M4 is active, S > 0 turns on spindle enable and S0 turns it off.","keywords":["invert","pwm","signal","spindle","stepper"]},{"code":"$10","name":"Status report options","desc":"SLB-EXT default: Position in machine coords: ON Buffer state: ON Line numbers: ON Feed & speed: ON Pin state: ON Work coord offset: ON Overrides: ON Probe coords: ON Buffer sync on WCO change: ON Parser state: OFF Alarm substatus: OFF Run substatus: OFF (511). Specifies optional data included in status reports. If Run substatus is enabled it may be used for simple probe protection. NOTE: Parser state will be sent separately after the status report and only on changes.","keywords":["options","report","status"]},{"code":"$11","name":"Junction deviation","desc":"SLB-EXT default: 0.010 mm. Sets how fast Grbl travels through consecutive motions. Lower value slows it down.","keywords":["deviation","junction"]},{"code":"$12","name":"Arc tolerance","desc":"SLB-EXT default: 0.002 mm. Sets the G2 and G3 arc tracing accuracy based on radial error. Beware: A very small value may effect performance.","keywords":["arc","tolerance"]},{"code":"$13","name":"Report in inches","desc":"SLB-EXT default: Disabled (0). Enables inch units when returning any position and rate value that is not a settings value.","keywords":["inches","report"]},{"code":"$14","name":"Invert control pins","desc":"SLB-EXT default: Reset: OFF Feed hold: ON Cycle start: ON Safety door: ON EStop: OFF (14). Inverts the control signals (active low). NOTE: Block delete, Optional stop, EStop and Probe connected are optional signals, availability is driver dependent.","keywords":["control","invert","pins"]},{"code":"$15","name":"Invert coolant pins","desc":"SLB-EXT default: Flood: OFF Mist: OFF (0). Inverts the coolant and mist signals (active low).","keywords":["coolant","invert","pins"]},{"code":"$16","name":"Invert spindle signals","desc":"SLB-EXT default: Spindle en: OFF Spindle dir: OFF PWM: OFF (0). Inverts the spindle on, counterclockwise and PWM signals (active low). NOTE: A hard reset of the controller is required after changing this setting.","keywords":["invert","signals","spindle"]},{"code":"$17","name":"Pullup disable control pins","desc":"SLB-EXT default: Reset: OFF Feed hold: OFF Cycle start: OFF Safety door: OFF EStop: OFF (0). Disable the control signals pullup resistors. Potentially enables pulldown resistor if available. NOTE: Block delete, Optional stop and EStop are optional signals, availability is driver dependent.","keywords":["control","disable","pins","pullup"]},{"code":"$18","name":"Pullup disable limit pins","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Disable the limit signals pullup resistors. Potentially enables pulldown resistor if available.","keywords":["disable","limit","pins","pullup"]},{"code":"$19","name":"Pullup disable probe pin","desc":"SLB-EXT default: Disabled (0). Disable the probe signal pullup resistor. Potentially enables pulldown resistor if available.","keywords":["disable","pin","probe","pullup"]},{"code":"$20","name":"Soft limits enable","desc":"SLB-EXT default: Disabled (0). Enables soft limits checks within machine travel and sets alarm when exceeded. Requires homing.","keywords":["enable","homing","limits","soft"]},{"code":"$21","name":"Hard limits enable","desc":"SLB-EXT default: Enable: OFF Strict mode: OFF (0). When enabled immediately halts motion and throws an alarm when a limit switch is triggered. In strict mode only homing is possible when a switch is engaged.","keywords":["enable","hard","homing","limits"]},{"code":"$22","name":"Homing cycle","desc":"SLB-EXT default: Enable: OFF Single axis commands: OFF Homing on startup: OFF Set machine origin: OFF Two switches share one input: OFF Allow manual: OFF Override locks: OFF Keep homed status on reset: OFF (0). Enables homing cycle. Requires limit switches on axes to be automatically homed. When `Enable single axis commands` is checked, single axis homing can be performed by $H<axis letter> commands. When `Allow manual` is checked, axes not homed automatically may be homed manually by $H or $H<axis letter> commands. `Override locks` is for allowing a soft reset to disable `Homing on startup required`.","keywords":["cycle","homing","limits"]},{"code":"$23","name":"Homing direction invert","desc":"SLB-EXT default: X: ON Y: ON Z: OFF A: ON (11). Homing searches for a switch in the positive direction. Set axis bit to search in negative direction.","keywords":["direction","homing","invert","limits"]},{"code":"$24","name":"Homing locate feed rate","desc":"SLB-EXT default: 150 mm/min. Feed rate to slowly engage limit switch to determine its location accurately.","keywords":["feed","homing","limits","locate","rate"]},{"code":"$25","name":"Homing search seek rate","desc":"SLB-EXT default: 4300 mm/min. Seek rate to quickly find the limit switch before the slower locating phase.","keywords":["homing","limits","rate","search","seek"]},{"code":"$26","name":"Homing switch debounce delay","desc":"SLB-EXT default: 25 milliseconds. Sets a short delay between phases of homing cycle to let a switch debounce.","keywords":["debounce","delay","homing","limits","switch"]},{"code":"$27","name":"Homing switch pull-off distance","desc":"SLB-EXT default: 1.5 mm. Retract distance after triggering switch to disengage it. Homing will fail if switch isn't cleared.","keywords":["distance","homing","limits","off","pull","switch"]},{"code":"$28","name":"G73 retract distance","desc":"SLB-EXT default: 0.1 mm. G73 retract distance (for chip breaking drilling).","keywords":["distance","retract"]},{"code":"$29","name":"Pulse delay","desc":"SLB-EXT default: 0 microseconds. Step pulse delay. Normally leave this at 0 as there is an implicit delay on direction changes when AMASS is active.","keywords":["delay","invert","pulse","signal","stepper"]},{"code":"$30","name":"Maximum spindle speed","desc":"SLB-EXT default: 24000 RPM. Maximum spindle speed, can be overridden by spindle plugins.","keywords":["maximum","speed","spindle"]},{"code":"$31","name":"Minimum spindle speed","desc":"SLB-EXT default: 7500 RPM. Minimum spindle speed, can be overridden by spindle plugins.","keywords":["minimum","speed","spindle"]},{"code":"$32","name":"Mode of operation","desc":"SLB-EXT default: Normal (0). Laser mode: consecutive G1/2/3 commands will not halt when spindle speed is changed. Lathe mode: allows use of G7, G8, G96 and G97.","keywords":["mode","operation","spindle"]},{"code":"$33","name":"Spindle PWM frequency","desc":"SLB-EXT default: 1000 Hz. Spindle PWM frequency.","keywords":["frequency","pwm","spindle"]},{"code":"$34","name":"Spindle PWM off value","desc":"SLB-EXT default: 0 percent. Spindle PWM off value in percent (duty cycle).","keywords":["off","pwm","spindle","value"]},{"code":"$35","name":"Spindle PWM min value","desc":"SLB-EXT default: 0 percent. Spindle PWM min value in percent (duty cycle).","keywords":["min","pwm","spindle","value"]},{"code":"$36","name":"Spindle PWM max value","desc":"SLB-EXT default: 100 percent. Spindle PWM max value in percent (duty cycle).","keywords":["max","pwm","spindle","value"]},{"code":"$37","name":"Steppers de-energize","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Specifies which steppers not to disable when stopped.","keywords":["energize","invert","signal","stepper","steppers"]},{"code":"$38","name":"Spindle pulses per revolution (PPR)","desc":"Spindle encoder pulses per revolution.","keywords":["spindle","pulses","per","revolution","ppr"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$39","name":"Enable legacy RT commands","desc":"SLB-EXT default: Enabled (1). Enables \"normal\" processing of ?, ! and ~ characters when part of $-setting or comment. If disabled then they are added to the input string instead.","keywords":["commands","enable","invert","legacy","signal","stepper"]},{"code":"$40","name":"Limit jog commands","desc":"SLB-EXT default: Enabled (1). Limit jog commands to machine limits for homed axes.","keywords":["commands","jog","limit"]},{"code":"$41","name":"Parking cycle","desc":"SLB-EXT default: Enable: ON Parking override control: OFF Deactivate upon init: OFF (1). Enables parking cycle, requires parking axis homed.","keywords":["cycle","parking"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$42","name":"Parking axis","desc":"SLB-EXT default: Z (2). Define which axis that performs the parking motion.","keywords":["axis","parking"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$43","name":"Homing passes","desc":"SLB-EXT default: 1. Number of homing passes. Minimum 1, maximum 128.","keywords":["homing","limits","passes"]},{"code":"$44","name":"Axes homing, first pass","desc":"SLB-EXT default: X: OFF Y: OFF Z: ON A: OFF (4). Axes to home in first pass.","keywords":["axes","first","homing","limits","pass"]},{"code":"$45","name":"Axes homing, second pass","desc":"SLB-EXT default: X: ON Y: ON Z: OFF A: OFF (3). Axes to home in second pass.","keywords":["axes","homing","limits","pass","second"]},{"code":"$46","name":"Axes homing, third pass","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Axes to home in third pass.","keywords":["axes","homing","limits","pass","third"]},{"code":"$47","name":"Axes homing, fourth pass","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Axes to home in fourth pass.","keywords":["axes","fourth","homing","limits","pass"]},{"code":"$48","name":"Axes homing, fifth phase","desc":"Axes to home in fifth phase.","keywords":["axes","homing","fifth","phase"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$49","name":"Axes homing, sixth phase","desc":"Axes to home in sixth phase.","keywords":["axes","homing","sixth","phase"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$56","name":"Parking pull-out distance","desc":"SLB-EXT default: 5 mm. Spindle pull-out and plunge distance in mm.Incremental distance.","keywords":["distance","out","parking","pull"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$57","name":"Parking pull-out rate","desc":"SLB-EXT default: 100 mm/min. Spindle pull-out/plunge slow feed rate in mm/min.","keywords":["out","parking","pull","rate"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$58","name":"Parking target","desc":"SLB-EXT default: -5 mm. Parking axis target. In mm, as machine coordinate [-max_travel, 0].","keywords":["parking","target"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$59","name":"Parking fast rate","desc":"SLB-EXT default: 500 mm/min. Parking fast rate to target after pull-out in mm/min.","keywords":["fast","parking","rate"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$60","name":"Restore overrides","desc":"SLB-EXT default: Enabled (1). Restore overrides to default values at program end.","keywords":["overrides","restore"]},{"code":"$61","name":"Safety door options","desc":"SLB-EXT default: Ignore when idle: ON Keep coolant state: ON (3). Enable this if it is desirable to open the safety door when in IDLE mode (eg. for jogging).","keywords":["door","options","safety"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$62","name":"Sleep enable","desc":"SLB-EXT default: Disabled (0). Enable sleep mode.","keywords":["enable","sleep"]},{"code":"$63","name":"Feed hold actions","desc":"SLB-EXT default: Disable laser: ON Restore spindle and coolant state: ON (3). Actions taken during feed hold and on resume from feed hold.","keywords":["actions","feed","hold"]},{"code":"$64","name":"Force init alarm","desc":"SLB-EXT default: Disabled (0). Starts Grbl in alarm mode after a cold reset.","keywords":["alarm","force","init"]},{"code":"$65","name":"Probing feed override","desc":"SLB-EXT default: Disabled (0). Allow feed override during probing.","keywords":["feed","override","probing"]},{"code":"$66","name":"Spindle linearisation, 1st point","desc":"Comma separated list of values: RPM_MIN, RPM_LINE_A1, RPM_LINE_B1, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$67","name":"Spindle linearisation, 2nd point","desc":"Comma separated list of values: RPM_POINT12, RPM_LINE_A2, RPM_LINE_B2, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$68","name":"Spindle linearisation, 3rd point","desc":"Comma separated list of values: RPM_POINT23, RPM_LINE_A3, RPM_LINE_B3, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$69","name":"Spindle linearisation, 4th point","desc":"Comma separated list of values: RPM_POINT34, RPM_LINE_A4, RPM_LINE_B4, set to blank to disable.","keywords":["spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$70","name":"Network services","desc":"SLB-EXT default: Telnet: ON Websocket: ON FTP: ON (11). Network services/protocols to enable. NOTE: A hard reset of the controller is required after changing this setting.","keywords":["ethernet","ip","network","services"]},{"code":"$90","name":"Spindle sync P-gain","desc":"Spindle sync P-gain","keywords":["spindle","sync","gain"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$91","name":"Spindle sync I-gain","desc":"Spindle sync I-gain","keywords":["spindle","sync","gain"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$92","name":"Spindle sync D-gain","desc":"Spindle sync D-gain","keywords":["spindle","sync","gain"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$95","name":"Spindle sync PID max I error","desc":"Spindle sync PID max integrator error.","keywords":["spindle","sync","pid","max","error"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$100","name":"X-axis travel resolution","desc":"SLB-EXT default: 800 step/mm. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$101","name":"Y-axis travel resolution","desc":"SLB-EXT default: 800 step/mm. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$102","name":"Z-axis travel resolution","desc":"SLB-EXT default: 800 step/mm. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$103","name":"A-axis travel resolution","desc":"SLB-EXT default: 79.012345679 step/deg. Travel resolution in steps per millimeter.","keywords":["axis","calibration","motion","resolution","steps","travel"]},{"code":"$110","name":"X-axis maximum rate","desc":"SLB-EXT default: 4000 mm/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$111","name":"Y-axis maximum rate","desc":"SLB-EXT default: 4000 mm/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$112","name":"Z-axis maximum rate","desc":"SLB-EXT default: 4000 mm/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$113","name":"A-axis maximum rate","desc":"SLB-EXT default: 8000 deg/min. Maximum rate. Used as G0 rapid rate.","keywords":["axis","calibration","maximum","motion","rate","steps"]},{"code":"$120","name":"X-axis acceleration","desc":"SLB-EXT default: 750 mm/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$121","name":"Y-axis acceleration","desc":"SLB-EXT default: 750 mm/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$122","name":"Z-axis acceleration","desc":"SLB-EXT default: 750 mm/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$123","name":"A-axis acceleration","desc":"SLB-EXT default: 1000 deg/sec^2. Acceleration. Used for motion planning to not exceed motor torque and lose steps.","keywords":["acceleration","axis","calibration","motion","steps"]},{"code":"$130","name":"X-axis maximum travel","desc":"SLB-EXT default: 810 mm. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$131","name":"Y-axis maximum travel","desc":"SLB-EXT default: 855 mm. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$132","name":"Z-axis maximum travel","desc":"SLB-EXT default: 120 mm. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$133","name":"A-axis maximum travel","desc":"SLB-EXT default: 0 deg. Maximum axis travel distance from homing switch. Determines valid machine space for soft-limits and homing search distances.","keywords":["axis","calibration","maximum","motion","steps","travel"]},{"code":"$140","name":"X-axis motor current","desc":"SLB-EXT default: 2800 mA. Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"]},{"code":"$141","name":"Y-axis motor current","desc":"Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"]},{"code":"$142","name":"Z-axis motor current","desc":"Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"]},{"code":"$143","name":"A-axis motor current","desc":"SLB-EXT default: 0. Motor current in mA (RMS). NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","motor","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$150","name":"X-axis microsteps","desc":"SLB-EXT default: 32 steps. Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"]},{"code":"$151","name":"Y-axis microsteps","desc":"Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"]},{"code":"$152","name":"Z-axis microsteps","desc":"Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"]},{"code":"$153","name":"A-axis microsteps","desc":"SLB-EXT default: 16. Microsteps per fullstep. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","microsteps","motor","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$180","name":"X-axis homing locate feed rate","desc":"SLB-EXT default: 150 mm/min. Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"]},{"code":"$181","name":"Y-axis homing locate feed rate","desc":"Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"]},{"code":"$182","name":"Z-axis homing locate feed rate","desc":"Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"]},{"code":"$183","name":"A-axis homing locate feed rate","desc":"Feed rate to slowly engage limit switch to determine its location accurately. NOTE: Defaults to $24 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","feed","homing","limits","locate","rate"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$190","name":"X-axis homing search seek rate","desc":"SLB-EXT default: 4300 mm/min. Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"]},{"code":"$191","name":"Y-axis homing search seek rate","desc":"Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"]},{"code":"$192","name":"Z-axis homing search seek rate","desc":"Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"]},{"code":"$193","name":"A-axis homing search seek rate","desc":"Seek rate to quickly find the limit switch before the slower locating phase. NOTE: Defaults to $25 setting if axis isn't controlled by a Trinamic driver.","keywords":["axis","homing","limits","rate","search","seek"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$200","name":"X-axis StallGuard2 fast threshold","desc":"SLB-EXT default: 22. StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$201","name":"Y-axis StallGuard2 fast threshold","desc":"StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$202","name":"Z-axis StallGuard2 fast threshold","desc":"StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$203","name":"A-axis StallGuard2 fast threshold","desc":"StallGuard threshold for fast (seek) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","fast","motor","stallguard","threshold","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$210","name":"X-axis hold current","desc":"SLB-EXT default: 35 %. Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"]},{"code":"$211","name":"Y-axis hold current","desc":"Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"]},{"code":"$212","name":"Z-axis hold current","desc":"Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"]},{"code":"$213","name":"A-axis hold current","desc":"SLB-EXT default: 50. Motor current at standstill as a percentage of full current. NOTE: If grblHAL is configured to disable motors on standstill this setting has no use. Only used for axes controlled by a Trinamic driver.","keywords":["axis","current","driver","hold","motor","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$220","name":"X-axis stallGuard2 slow threshold","desc":"SLB-EXT default: 22. StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$221","name":"Y-axis stallGuard2 slow threshold","desc":"StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$222","name":"Z-axis stallGuard2 slow threshold","desc":"StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$223","name":"A-axis stallGuard2 slow threshold","desc":"StallGuard threshold for slow (feed) homing phase. NOTE: Only used for axes controlled by a Trinamic driver.","keywords":["axis","driver","motor","slow","stallguard","threshold","trinamic"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$300","name":"Hostname","desc":"SLB-EXT default: grblHAL. Network hostname. ~Controller reset required for setting change to take effect~","keywords":["ethernet","hostname","ip","network"]},{"code":"$301","name":"IP mode","desc":"SLB-EXT default: Static (0). IP mode. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","mode","network"]},{"code":"$302","name":"IP address","desc":"SLB-EXT default: 192.168.5.1. Static IP address. ~Controller reset required for setting change to take effect~","keywords":["address","ethernet","ip","network"]},{"code":"$303","name":"Gateway","desc":"SLB-EXT default: 192.168.5.1. Static gateway address. ~Controller reset required for setting change to take effect~","keywords":["ethernet","gateway","ip","network"]},{"code":"$304","name":"Netmask","desc":"SLB-EXT default: 255.255.255.0. Static netmask. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","netmask","network"]},{"code":"$305","name":"Telnet port","desc":"SLB-EXT default: 23. (Raw) Telnet port number listening for incoming connections. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","network","port","telnet"]},{"code":"$307","name":"Websocket port","desc":"SLB-EXT default: 80. Websocket port number listening for incoming connections. NOTE: WebUI requires this to be HTTP port number + 1. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ip","network","port","websocket"]},{"code":"$308","name":"FTP port","desc":"SLB-EXT default: 21. FTP port number listening for incoming connections. ~Controller reset required for setting change to take effect~","keywords":["ethernet","ftp","ip","network","port"]},{"code":"$338","name":"Trinamic driver","desc":"SLB-EXT default: X: ON Y: ON Z: ON A: OFF (7). Enable SPI or UART controlled Trinamic drivers for axes.","keywords":["driver","ethernet","ip","motor","network","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$339","name":"Sensorless homing","desc":"SLB-EXT default: X: OFF Y: OFF Z: OFF A: OFF (0). Enable sensorless homing for axes. Requires SPI or UART controlled Trinamic drivers.","keywords":["driver","ethernet","homing","ip","motor","network","sensorless","trinamic"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$340","name":"Spindle at speed tolerance","desc":"SLB-EXT default: 0 percent. Spindle at speed tolerance as percentage deviation from programmed speed, set to 0 to disable. If not within tolerance when checked after spindle on delay ($392) alarm 14 is raised.","keywords":["speed","spindle","tolerance"]},{"code":"$341","name":"Tool change mode","desc":"SLB-EXT default: Normal (0). Normal: allows jogging for manual touch off. Set new position manually. Manual touch off: retracts tool axis to home position for tool change, use jogging or $TPW for touch off. Manual touch off @ G59.3: retracts tool axis to home position then to G59.3 position for tool change, use jogging or $TPW for touch off. Automatic touch off @ G59.3: retracts tool axis to home position for tool change, then to G59.3 position for automatic touch off. All modes except \"Normal\" and \"Ignore M6\" returns the tool (controlled point) to original position after touch off.","keywords":["change","mode","probe","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$342","name":"Tool change probing distance","desc":"SLB-EXT default: 30 mm. Maximum probing distance for automatic or $TPW touch off.","keywords":["change","distance","probe","probing","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$343","name":"Tool change locate feed rate","desc":"SLB-EXT default: 25 mm/min. Feed rate to slowly engage tool change sensor to determine the tool offset accurately.","keywords":["change","feed","locate","probe","rate","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$344","name":"Tool change search seek rate","desc":"SLB-EXT default: 200 mm/min. Seek rate to quickly find the tool change sensor before the slower locating phase.","keywords":["change","probe","rate","search","seek","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$345","name":"Tool change probe pull-off rate","desc":"SLB-EXT default: 200 mm/min. Pull-off rate for the retract move before the slower locating phase.","keywords":["change","off","probe","pull","rate","tool","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$346","name":"Restore position after M6","desc":"SLB-EXT default: Enabled (1). When set the spindle is moved so that the controlled point (tool tip) is the same as before the M6 command, if not the spindle is only moved to the Z home position.","keywords":["after","position","probe","restore","tool change","toolchange","touch off"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$347","name":"Dual axis length fail","desc":"(percent) Dual axis length fail in percent of axis max travel.","keywords":["dual","axis","length","fail"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$348","name":"Dual axis length fail min","desc":"(mm) Dual axis length fail minimum distance.","keywords":["dual","axis","length","fail","min"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$349","name":"Dual axis length fail max","desc":"(mm) Dual axis length fail maximum distance.","keywords":["dual","axis","length","fail","max"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$370","name":"Invert I/O Port inputs","desc":"SLB-EXT default: (0). Invert IOPort inputs.","keywords":["inputs","invert","port"]},{"code":"$372","name":"Invert I/O Port outputs","desc":"SLB-EXT default: (0). Invert IOPort output.","keywords":["invert","outputs","port"]},{"code":"$374","name":"Modbus baud rate","desc":"SLB-EXT default: 19200 (3).","keywords":["baud","modbus","rate","rs485","vfd"]},{"code":"$375","name":"Modbus RX timeout","desc":"SLB-EXT default: 50 milliseconds.","keywords":["modbus","rs485","timeout","vfd"]},{"code":"$376","name":"Rotational axes","desc":"SLB-EXT default: A-Axis: ON (1).","keywords":["axes","rotational"]},{"code":"$384","name":"Disable G92 persistence","desc":"SLB-EXT default: Disabled (0). Disables save/restore of G92 offset to non-volatile storage (NVS).","keywords":["disable","persistence"]},{"code":"$392","name":"Spindle on delay","desc":"SLB-EXT default: 11 s. Delay to allow spindle to spin up after safety door is opened.","keywords":["delay","spindle"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$393","name":"Coolant on delay","desc":"SLB-EXT default: 1 s. Delay to allow coolant to restart after safety door is opened.","keywords":["coolant","delay"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$394","name":"Spindle off delay (s)","desc":"grblHAL: pause after M5 — spin-down time.","keywords":["spindle","delay","spindown","off delay"]},{"code":"$395","name":"Default spindle","desc":"SLB-EXT default: SLB_SPINDLE (0). Spindle selected on startup.","keywords":["default","laser","spindle"]},{"code":"$398","name":"Planner buffer blocks","desc":"SLB-EXT default: 128. Number of blocks in the planner buffer. ~Controller reset required for setting change to take effect~","keywords":["blocks","buffer","planner"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$399","name":"CAN bus baud rate","desc":"CAN bus baud rate","keywords":["can","bus","baud","rate"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$450","name":"Button 1 action","desc":"SLB-EXT default: Cycle start (1). Assign a real-time action to button 1, or run your own macro g-code.","keywords":["action","button","macro"]},{"code":"$451","name":"Button 2 action","desc":"SLB-EXT default: Pause (2). Assign a real-time action to button 2, or run your own macro g-code.","keywords":["action","button","macro"]},{"code":"$452","name":"Button 3 action","desc":"SLB-EXT default: Halt (4). Assign a real-time action to button 3, or run your own macro g-code.","keywords":["action","button","macro"]},{"code":"$453","name":"Button 1 macro","desc":"SLB-EXT default: G4P0. Macro content, limited to 127 characters. Separate lines with the vertical bar character |.","keywords":["action","button","macro"]},{"code":"$454","name":"Button 2 macro","desc":"SLB-EXT default: G4P0. Macro content, limited to 127 characters. Separate lines with the vertical bar character |.","keywords":["action","button","macro"]},{"code":"$455","name":"Button 3 macro","desc":"SLB-EXT default: G4P0. Macro content, limited to 127 characters. Separate lines with the vertical bar character |.","keywords":["action","button","macro"]},{"code":"$456","name":"Aux output 0 trigger","desc":"SLB-EXT default: Spindle/Laser enable (0). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$457","name":"Aux output 1 trigger","desc":"SLB-EXT default: Flood enable (2). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$458","name":"Aux output 2 trigger","desc":"SLB-EXT default: Spindle/Laser enable (0). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$459","name":"Aux output 3 trigger","desc":"SLB-EXT default: Flood enable (2). A second, more common action can be assigned to trigger this output. M62/63 P# is always available as a buffered on/off or M64/65 P# as an immediate on/off.","keywords":["action","aux","button","macro","output","trigger"]},{"code":"$462","name":"Run/stop register","desc":"SLB-EXT default: 8192 decimal. MODVFD register for run/stop.","keywords":["modbus","register","rs485","run","stop","vfd"]},{"code":"$463","name":"Frequency set register","desc":"SLB-EXT default: 8193 decimal. MODVFD register to set frequency.","keywords":["frequency","modbus","register","rs485","set","vfd"]},{"code":"$464","name":"Frequency get register","desc":"SLB-EXT default: 8451 decimal. MODVFD register to get frequency.","keywords":["frequency","get","modbus","register","rs485","vfd"]},{"code":"$465","name":"Run CW command","desc":"SLB-EXT default: 18 decimal. MODVFD command word for CW.","keywords":["command","modbus","rs485","run","vfd"]},{"code":"$466","name":"Run CCW command","desc":"SLB-EXT default: 34 decimal. MODVFD command word for CCW.","keywords":["ccw","command","modbus","rs485","run","vfd"]},{"code":"$467","name":"Stop command","desc":"SLB-EXT default: 1 decimal. MODVFD command word for stop.","keywords":["command","modbus","rs485","stop","vfd"]},{"code":"$468","name":"RPM input multiplier","desc":"SLB-EXT default: 50. MODVFD RPM value multiplier for programming RPM.","keywords":["input","modbus","multiplier","rpm","rs485","vfd"]},{"code":"$469","name":"RPM input divider","desc":"SLB-EXT default: 60. MODVFD RPM value divider for programming RPM.","keywords":["divider","input","modbus","rpm","rs485","vfd"]},{"code":"$470","name":"RPM output multiplier","desc":"SLB-EXT default: 60. MODVFD RPM value multiplier for reading RPM.","keywords":["modbus","multiplier","output","rpm","rs485","vfd"]},{"code":"$471","name":"RPM output divider","desc":"SLB-EXT default: 100. MODVFD RPM value divider for reading RPM.","keywords":["divider","modbus","output","rpm","rs485","vfd"]},{"code":"$478","name":"Spindle 2 Modbus address","desc":"SLB-EXT default: 3. Spindle 2 Modbus address.","keywords":["address","modbus","rs485","spindle","vfd"]},{"code":"$479","name":"Spindle 3 Modbus address","desc":"SLB-EXT default: 4. Spindle 3 Modbus address.","keywords":["address","modbus","rs485","spindle","vfd"]},{"code":"$481","name":"Autoreport interval","desc":"SLB-EXT default: 0 ms. Interval the real time report will be sent, set to 0 to disable. ~Controller reset required for setting change to take effect~","keywords":["autoreport","interval"]},{"code":"$482","name":"Timezone offset","desc":"Offset in hours from UTC.","keywords":["timezone","offset"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$484","name":"Unlock required after E-stop","desc":"SLB-EXT default: Enabled (1). If set, unlock (by sending $X) is required after resetting a cleared E-Stop condition.","keywords":["after","required","stop","unlock"]},{"code":"$485","name":"Keep tool number over reboot","desc":"Keep tool number over reboot","keywords":["keep","tool","number","over","reboot"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$486","name":"Lock coordinate systems","desc":"SLB-EXT default: G59.1: OFF G59.2: OFF G59.3: OFF (0). Lock coordinate systems against accidental changes.","keywords":["coordinate","lock","systems"]},{"code":"$487","name":"PWM2 spindle on port","desc":"On/off aux port.","keywords":["pwm","spindle","port"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$488","name":"PWM2 spindle direction port","desc":"Direction aux port, set to -1 if not required.","keywords":["pwm","spindle","direction","port"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$489","name":"PWM2 spindle PWM port","desc":"Spindle analog aux port. Must be PWM capable!","keywords":["pwm","spindle","port"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$511","name":"Spindle 1","desc":"SLB-EXT default: SLB_LASER (7). Spindle to use as spindle 1. ~Controller reset required for setting change to take effect~","keywords":["laser","spindle"]},{"code":"$512","name":"Spindle 2","desc":"SLB-EXT default: MODVFD (5). Spindle to use as spindle 2. ~Controller reset required for setting change to take effect~","keywords":["laser","spindle"]},{"code":"$513","name":"Spindle 3","desc":"SLB-EXT default: Disabled (8). Spindle to use as spindle 3. ~Controller reset required for setting change to take effect~","keywords":["laser","spindle"]},{"code":"$519","name":"Encoder spindle","desc":"Specifies which spindle has the encoder attached.","keywords":["encoder","spindle"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$520","name":"Spindle 0 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 0 (default spindle). Normally leave this at 0.","keywords":["laser","number","spindle","start","tool"]},{"code":"$521","name":"Spindle 1 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 1.","keywords":["laser","number","spindle","start","tool"]},{"code":"$522","name":"Spindle 2 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 2.","keywords":["laser","number","spindle","start","tool"]},{"code":"$523","name":"Spindle 3 tool number start","desc":"SLB-EXT default: 0. Start of tool numbers for selecting spindle 3.","keywords":["laser","number","spindle","start","tool"]},{"code":"$534","name":"Output NGC debug messages","desc":"Example: (debug, metric mode: #<_metric>, coord system: #5220)","keywords":["output","ngc","debug","messages"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$536","name":"LED strip 1 length","desc":"Number of LEDS in strip 1.","keywords":["led","strip","length"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$537","name":"LED strip 2 length","desc":"Number of LEDS in strip 2.","keywords":["led","strip","length"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$538","name":"Fast rotary go to G28","desc":"Fast rotary go to G28","keywords":["fast","rotary"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$539","name":"Spindle off delay","desc":"(s) Spindle off delay","keywords":["spindle","off","delay"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$650","name":"Chopper toff","desc":"SLB-EXT default: 1. Off time. Duration of slow decay phase as a multiple of system clock periods: NCLK= 24 + (32 x TOFF). This will limit the maximum chopper frequency (0-15). 0: MOSFETs shut off, driver disabled. 1: Use with TBL of minimum 24 clocks.","keywords":["chopper","toff"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$651","name":"Chopper tbl","desc":"SLB-EXT default: 1. Blanking time interval in system clock periods (0-3 = 16,24,36,54). Needs to cover the switching event and the duration of the ringing on the sense resistor.","keywords":["chopper","tbl"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$652","name":"Chopper chm","desc":"SLB-EXT default: 0. Chopper mode. Affects HDEC, HEND, and HSTRT parameters. 0: Standard mode (SpreadCycle). 1: Constant TOFF with fast decay time. Fast decay is after on time. Fast decay time is also terminated when the negative nominal current is reached.","keywords":["chm","chopper"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$653","name":"Chopper hstr","desc":"SLB-EXT default: 2. CHM=0: Hysteresis start, offset from HEND (0-7 = 1-8). To be effective, HEND+HSTRT must be ≤15. CHM=1: Fast decay time. Three least-significant bits of the duration of the fast decay phase. The MSB is HDEC0. Fast decay time is a multiple of system clock periods: NCLK= 32 x (HDEC0+HSTRT).","keywords":["chopper","hstr"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$654","name":"Chopper hend","desc":"SLB-EXT default: 8. Can be either negative, zero, or positive, 0-15 = -3 to 12. CHM=0: Hysteresis end (low). Sets the hysteresis end value after a number of decrements, used for the hysteresis chopper and controlled by HDEC. HSTRT+HEND must be less than 16. 1/512 adds to the current setting. CHM=1: Sine wave offset. A positive offset corrects for zero crossing error. 1/512 adds to the absolute value of each sine wave entry.","keywords":["chopper","hend"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$655","name":"Chopper hdec","desc":"SLB-EXT default: 0. CHM=0: Hysteresis decrement interval period in system clock periods. Determines the slope of the hysteresis during on time from fast to very slow (0-3 = 16,32,48,64). CHM=1: Fast decay mode.","keywords":["chopper","hdec"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$656","name":"Chopper rndtf","desc":"SLB-EXT default: 1. Change from fixed to randomized TOFF times, by dNCLK= -24 to +6 clocks. Only for CHM=1.","keywords":["chopper","rndtf"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$657","name":"THRESH","desc":"SLB-EXT default: 22. StallGuard threshold.","keywords":["thresh"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$658","name":"CoolStep semin","desc":"SLB-EXT default: 7. Lower CoolStep threshold. If the SG value falls below SEMIN x 32, the coil current scaling factor is increased (0-15). 0: CoolStep disabled.","keywords":["coolstep","semin"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$659","name":"CoolStep seup","desc":"SLB-EXT default: 3. Number of increments of the coil current each time SG is sampled below the lower threshold (0-3 = 1,2,4,8).","keywords":["coolstep","seup"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$660","name":"CoolStep semax","desc":"SLB-EXT default: 0. Upper CoolStep threshold offset from lower threshold. If SG is sampled above (SEMIN+SEMAX+1)x32 enough times, the coil current scaling factor is decremented (0-15).","keywords":["coolstep","semax"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$661","name":"CoolStep sedn","desc":"SLB-EXT default: 3. Number of times SG must be sampled above the upper threshold before the coil current is decremented (0-3 = 32,8,2,1).","keywords":["coolstep","sedn"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$662","name":"CoolStep seimin","desc":"SLB-EXT default: 0. Minimum CoolStep current as a factor of the set motor current. 0: 1/2, 1: 1/4","keywords":["coolstep","seimin"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$663","name":"drvconf_reg","desc":"SLB-EXT default: 41759. DRVCONF register defaults 0xA31F. All protections enabled.","keywords":["drvconf","reg"],"tips":"Sienci marks this as advanced - supported, but change with care."},{"code":"$664","name":"Ring pixels","desc":"SLB-EXT default: 0. Number of individual pixels or LEDs connected. ~Controller reset required for setting change to take effect~","keywords":["led","lights","pixels","ring"]},{"code":"$665","name":"Rail pixels","desc":"SLB-EXT default: 1. Number of individual pixels or LEDs connected. Include the onboard LED. ~Controller reset required for setting change to take effect~","keywords":["led","lights","pixels","rail"]},{"code":"$666","name":"Using add-ons","desc":"SLB-EXT default: (0). Sienci specific capability flags.","keywords":["add","ons","using"],"tips":"Sienci marks this as currently unused on the SLB - it may still apply on the SLB-EXT; run $ES to check your build."},{"code":"$668","name":"Invert TLS input","desc":"SLB-EXT default: Enabled (1). Invert the TLS input ahead of the OR function. ~Controller reset required for setting change to take effect~","keywords":["input","invert","tls"]},{"code":"$671","name":"Invert home inputs","desc":"Inverts the axis home input signals.","keywords":["invert","home","inputs"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$673","name":"Coolant on delay","desc":"(s) Delay to allow coolant to start. 0 or 0.5 - 20s.","keywords":["coolant","delay"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$676","name":"Reset actions","desc":"Controls actions taken on a soft reset.","keywords":["reset","actions"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$680","name":"Stepper enable delay","desc":"(ms) Delay from stepper enable to first step output. The driver typically adds ~2ms to this.","keywords":["stepper","enable","delay"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$681","name":"ModBus serial format","desc":"ModBus serial format","keywords":["modbus","serial","format"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$700","name":"Subroutine options","desc":"Enable prescan for internal M98 subroutines.","keywords":["subroutine","options"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$709","name":"PWM2 spindle options","desc":"Options for the secondary PWM spindle output (PWM2, the SLB-EXT laser channel).","keywords":["laser","options","pwm","pwm2","spindle"]},{"code":"$716","name":"PWM2 spindle signals invert","desc":"Inverts the PWM2 (laser) enable, counterclockwise and PWM signals (active low). Hard reset required after changing.","keywords":["invert","laser","pwm","pwm2","signals","spindle"],"tips":"On older SLB 5.0.x firmware this lived at $743 (Invert laser signals)."},{"code":"$730","name":"Maximum laser power","desc":"SLB-EXT default: 255. Maximum S word power for laser.","keywords":["laser","maximum","power","pwm"]},{"code":"$731","name":"Minimum laser power","desc":"SLB-EXT default: 0. Minimum S word power for laser.","keywords":["laser","minimum","power","pwm"]},{"code":"$733","name":"Laser PWM frequency","desc":"SLB-EXT default: 1000 Hz. Laser PWM frequency.","keywords":["frequency","laser","pwm"]},{"code":"$734","name":"Laser PWM off value","desc":"SLB-EXT default: 0 percent. Laser PWM off value in percent (duty cycle).","keywords":["laser","off","pwm","value"]},{"code":"$735","name":"Laser PWM min value","desc":"SLB-EXT default: 0 percent. Laser PWM min value in percent (duty cycle).","keywords":["laser","min","pwm","value"]},{"code":"$736","name":"Laser PWM max value","desc":"SLB-EXT default: 100 percent. Laser PWM max value in percent (duty cycle).","keywords":["laser","max","pwm","value"]},{"code":"$737","name":"PWM2 spindle linearisation, 1st point","desc":"Comma separated list of values: RPM_MIN, RPM_LINE_A1, RPM_LINE_B1, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$738","name":"PWM2 spindle linearisation, 2nd point","desc":"Comma separated list of values: RPM_POINT12, RPM_LINE_A2, RPM_LINE_B2, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$739","name":"PWM2 spindle linearisation, 3rd point","desc":"Comma separated list of values: RPM_POINT23, RPM_LINE_A3, RPM_LINE_B3, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$740","name":"PWM2 spindle linearisation, 4th point","desc":"Comma separated list of values: RPM_POINT34, RPM_LINE_A4, RPM_LINE_B4, set to blank to disable.","keywords":["pwm","spindle","linearisation","point"],"tips":"Core grblHAL setting - only present if your firmware build includes the feature. The reference flags whether your controller has it."},{"code":"$742","name":"Motor warning inputs enable","desc":"Enables the external stepper driver warning inputs per motor (SLB-EXT external drivers report warnings before faulting).","keywords":["alarm","driver","enable","fault","inputs","motor","warning"],"tips":"Current Main_grblHAL numbering. On older SLB 5.0.x firmware $742 was the Laser Y offset - that is now $771."},{"code":"$743","name":"Invert motor warning inputs","desc":"Inverts the motor warning input signals (active low).","keywords":["alarm","driver","fault","inputs","invert","motor","warning"],"tips":"On older SLB 5.0.x firmware $743 was Invert laser signals - that is now $716."},{"code":"$744","name":"Motor fault inputs enable","desc":"Enables the external stepper driver fault/alarm inputs per motor. A fault triggers an alarm and halts the machine.","keywords":["alarm","driver","enable","fault","inputs","motor"]},{"code":"$745","name":"Invert motor fault inputs","desc":"Inverts the motor fault input signals (active low).","keywords":["alarm","driver","fault","inputs","invert","motor"]},{"code":"$750","name":"Macro 0 content","desc":"G-code for aux-input macro 0. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $760) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$751","name":"Macro 1 content","desc":"G-code for aux-input macro 1. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $761) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$752","name":"Macro 2 content","desc":"G-code for aux-input macro 2. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $762) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$753","name":"Macro 3 content","desc":"G-code for aux-input macro 3. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $763) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$754","name":"Macro 4 content","desc":"G-code for aux-input macro 4. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $764) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$755","name":"Macro 5 content","desc":"G-code for aux-input macro 5. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $765) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$756","name":"Macro 6 content","desc":"G-code for aux-input macro 6. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $766) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$757","name":"Macro 7 content","desc":"G-code for aux-input macro 7. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $767) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$758","name":"Macro 8 content","desc":"G-code for aux-input macro 8. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $768) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$759","name":"Macro 9 content","desc":"G-code for aux-input macro 9. Separate lines with the vertical bar character |. Runs when the assigned aux input (set by $769) triggers; controller must be Idle.","keywords":["action","aux input","content","macro"]},{"code":"$760","name":"Macro 0 trigger port","desc":"Aux input port number that triggers macro 0 (content in $750). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$761","name":"Macro 1 trigger port","desc":"Aux input port number that triggers macro 1 (content in $751). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$762","name":"Macro 2 trigger port","desc":"Aux input port number that triggers macro 2 (content in $752). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$763","name":"Macro 3 trigger port","desc":"Aux input port number that triggers macro 3 (content in $753). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$764","name":"Macro 4 trigger port","desc":"Aux input port number that triggers macro 4 (content in $754). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$765","name":"Macro 5 trigger port","desc":"Aux input port number that triggers macro 5 (content in $755). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$766","name":"Macro 6 trigger port","desc":"Aux input port number that triggers macro 6 (content in $756). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$767","name":"Macro 7 trigger port","desc":"Aux input port number that triggers macro 7 (content in $757). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$768","name":"Macro 8 trigger port","desc":"Aux input port number that triggers macro 8 (content in $758). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$769","name":"Macro 9 trigger port","desc":"Aux input port number that triggers macro 9 (content in $759). Set to -1 to disable. The pin must be interrupt-capable.","keywords":["action","aux input","macro","port","trigger"]},{"code":"$770","name":"Laser X offset","desc":"Laser offset from the spindle on the X axis, applied when switching between spindle and laser so files stay aligned. Pairs with gSender Spindle/Laser offset settings.","keywords":["alignment","laser","offset","pwm"],"tips":"Moved here in Main_grblHAL firmware - older SLB 5.0.x used $741."},{"code":"$771","name":"Laser Y offset","desc":"Laser offset from the spindle on the Y axis.","keywords":["alignment","laser","offset","pwm"],"tips":"Moved here in Main_grblHAL firmware - older SLB 5.0.x used $742."},{"code":"$772","name":"Laser offset options","desc":"Options controlling how the laser/spindle XY offset ($770/$771) is applied.","keywords":["laser","offset","options","pwm"]}],"system":[{"code":"$$","name":"View settings","desc":"Prints every numbered setting and its current value.","keywords":["settings","list","view","dump"]},{"code":"$#","name":"View G-code parameters","desc":"Shows WCS offsets (G54-G59.3), G28/G30 positions, G92 offset, tool length offset and last probe result (PRB).","keywords":["parameters","offsets","probe result","wcs","prb"]},{"code":"$G","name":"View parser state","desc":"Shows the active modal G-codes (motion mode, WCS, plane, units, distance mode...), plus current T, F and S.","keywords":["parser","state","modal","active modes"]},{"code":"$I","name":"Build info","desc":"Prints the firmware build/version string and enabled options.","keywords":["build","version","info","firmware"]},{"code":"$N","name":"View startup blocks","desc":"Shows the G-code lines run automatically at startup ($N0=, $N1= to set).","keywords":["startup","blocks","boot"]},{"code":"$X","name":"Kill alarm lock","desc":"Unlocks the machine from an alarm state without homing. Position may be unknown afterward — use with caution.","keywords":["unlock","alarm","kill","reset alarm"]},{"code":"$H","name":"Run homing cycle","desc":"Homes all configured axes per $22/$44-$47. $HX / $HY / $HZ home a single axis (grblHAL). Note: with the Rapid Change ATC or Manual Tool Changer plugin installed and \"perform TLS after home\" enabled, the plugin expands $H so that after homing, if a tool is loaded but has no length offset yet, an automatic $TLS probe cycle runs.","keywords":["home","homing","cycle","tls after home"]},{"code":"$J=","name":"Jog","desc":"Executes a jog move, e.g. $J=G91 X10 F1000. Jogs don't alter the G-code parser state and can be cancelled instantly (0x85).","keywords":["jog","jogging","move","manual"]},{"code":"$SLP","name":"Sleep","desc":"Puts the controller to sleep (steppers and spindle off). Wake with a soft reset. Requires $62=1.","keywords":["sleep","power down"]},{"code":"$TLR","name":"Set tool length reference","desc":"Tool change protocol: records the current tool offset as the job's reference after probing the first tool.","keywords":["tool length","reference","toolsetter","tool change"]},{"code":"$TPW","name":"Tool probe workpiece","desc":"Tool change protocol: probes the new tool to compute its dynamic offset. Available in tool change modes 1 and 2.","keywords":["tool probe","toolsetter","tool change"]},{"code":"$EA","name":"Enumerate alarms","desc":"Lists every alarm code with its description — decode alarm numbers here.","keywords":["alarms","codes","enumerate","list"]},{"code":"$EE","name":"Enumerate errors","desc":"Lists every error code with its description — decode error:NN messages here.","keywords":["errors","codes","enumerate","list"]},{"code":"$ES","name":"Enumerate settings","desc":"Lists every setting the build supports with type, range, unit and description — the authoritative settings reference for YOUR controller.","keywords":["settings","enumerate","describe","list"]},{"code":"$EG","name":"Enumerate setting groups","desc":"Lists the hierarchy of setting groups.","keywords":["groups","settings","enumerate"]},{"code":"$pins","name":"Enumerate pins","desc":"Lists processor pin assignments — which MCU pin does what.","keywords":["pins","mapping","enumerate"]},{"code":"$pinstate","name":"Pin states","desc":"Shows the live state of auxiliary pins — great for debugging wiring.","keywords":["pins","state","debug","aux"]},{"code":"$SPINDLES","name":"Enumerate spindles","desc":"Lists configured spindles and their numbers (for M104 P selection on multi-spindle setups).","keywords":["spindles","enumerate","list","dual spindle"]},{"code":"$F","name":"List files","desc":"Lists G-code files in the current directory on SD/LittleFS. $F+ lists all files; $F=<file> runs one; $FD=<file> deletes; $FM/$FU mount/unmount; $CWD= changes directory; $PWD prints it.","keywords":["files","sd card","list","run file","littlefs"]},{"code":"$RST","name":"Restore defaults","desc":"$RST=$ restores settings to defaults, $RST=# clears WCS/G28/G30 offsets, $RST=* resets everything. Irreversible — note your settings first.","keywords":["reset","restore","defaults","factory"]},{"code":"$REBOOT","name":"Reboot controller","desc":"Hard-resets the controller. The connection drops.","keywords":["reboot","restart","reset"]},{"code":"$TTLOAD","name":"Reload tool table","desc":"Reloads the tool table from storage.","keywords":["tool table","reload"]}],"letters":{"X":"X-axis coordinate/value","Y":"Y-axis coordinate/value","Z":"Z-axis coordinate/value","A":"A-axis (rotary) value","B":"B-axis value","C":"C-axis value","U":"U-axis value","V":"V-axis value","F":"Feed rate (modal — persists until changed)","S":"Spindle speed / laser power (used by M3/M4)","T":"Tool select (pre-selects for M6)","I":"Arc center offset from start, X direction","J":"Arc center offset from start, Y direction","K":"Arc center offset from start, Z direction","R":"Radius, or retract plane in canned cycles","P":"Parameter: dwell seconds, WCS/port/macro number (command-dependent)","Q":"Parameter: peck depth, value, tool number (command-dependent)","L":"Parameter: repeat count or data mode (command-dependent)","H":"Tool table index for length offset (G43)","D":"Parameter: max RPM cap (G96) or tool radius index","N":"Line number (ignored by execution)","E":"Analog port (plugin M-codes)","O":"Program label / subroutine number","W":"W-axis value, or white channel (M150)"},"initialTab":"reference","initialQuery":"","initialExplain":"","maxResults":8,"showSettingsTab":true};

    /* Per-category color keys with dark- and light-theme variants.
       The dialog renders in ncSender's main document, so we detect the
       active theme from the computed text color (dark text = light theme)
       and pick the palette with proper contrast. Chips, entry code chips,
       and badges all share these colors. */
    var CATEGORIES = [
      { id: 'all',      label: 'All',            dark: '#10b981', light: '#047857', accent: true },
      { id: 'motion',   label: 'Motion',         dark: '#4da3ff', light: '#1565c0' },
      { id: 'coords',   label: 'Coordinates',    dark: '#b48cff', light: '#6a3ab2' },
      { id: 'probing',  label: 'Probing',        dark: '#ff9f43', light: '#c65a00' },
      { id: 'spindle',  label: 'Spindle/Laser',  dark: '#ff6b81', light: '#c62839' },
      { id: 'coolant',  label: 'Coolant',        dark: '#3ec1d3', light: '#00838f' },
      { id: 'tool',     label: 'Tooling',        dark: '#ffd166', light: '#8d6e00' },
      { id: 'cycles',   label: 'Canned Cycles',  dark: '#f78fb3', light: '#ad3b66' },
      { id: 'modes',    label: 'Modes',          dark: '#7bed9f', light: '#2e7d32' },
      { id: 'program',  label: 'Program Flow',   dark: '#c8d6e5', light: '#455a64' },
      { id: 'io',       label: 'I/O',            dark: '#70a1ff', light: '#3949ab' },
      { id: 'plugin',   label: 'Plugin codes', dark: '#e77f67', light: '#bf360c' },
      { id: 'setting',  label: '$ Settings',     dark: '#2dd4bf', light: '#0f766e' },
      { id: 'system',   label: '$ Commands',     dark: '#48dbfb', light: '#0277bd' }
    ];

    var IS_LIGHT = (function () {
      try {
        var el = document.getElementById('gref-root');
        var c = (window.getComputedStyle ? window.getComputedStyle(el).color : '') || '';
        var m = c.match(/(\d+)\D+(\d+)\D+(\d+)/);
        if (!m) return false;
        // dark text means light theme
        return (0.2126 * m[1] + 0.7152 * m[2] + 0.0722 * m[3]) < 128;
      } catch (e) { return false; }
    })();

    var CAT_COLOR = {};
    CATEGORIES.forEach(function (c) { CAT_COLOR[c.id] = IS_LIGHT ? c.light : c.dark; });
    function catColor(id) { return CAT_COLOR[id] || (IS_LIGHT ? '#455a64' : '#9aa4b2'); }

    /* Build one unified entry list with a type tag. */
    var ALL = [];
    DATA.gcodes.forEach(function (e) { e._type = 'gcode'; ALL.push(e); });
    DATA.settings.forEach(function (e) {
      ALL.push({ _type: 'setting', code: e.code, aliases: [], name: e.name,
                 category: 'setting', modal: null, desc: e.desc, syntax: e.code + '=<value>',
                 params: {}, example: e.code + '=1', tips: null, keywords: e.keywords });
    });
    DATA.system.forEach(function (e) {
      ALL.push({ _type: 'system', code: e.code, aliases: [], name: e.name,
                 category: 'system', modal: null, desc: e.desc, syntax: e.code,
                 params: {}, example: e.code, tips: null, keywords: e.keywords });
    });

    /* code -> entry lookup map (canonical codes + aliases, uppercased). */
    var CODEMAP = {};
    ALL.forEach(function (e) {
      CODEMAP[e.code.toUpperCase()] = e;
      (e.aliases || []).forEach(function (a) { CODEMAP[a.toUpperCase()] = e; });
    });

    var state = { tab: DATA.initialTab || 'reference', query: DATA.initialQuery || '',
                  category: 'all', explainText: DATA.initialExplain || '', open: {},
                  gfile: { status: 'idle', name: '', lines: [] },
                  gsel: { anchor: -1, from: -1, to: -1 }, gfocus: -1,
                  fsearch: { q: '', matches: [], cur: -1 },
                  src: 'file', paste: { text: '', lines: [] }, rendered: 0, splitPct: 42 };
    // terminal ??<line> payloads open as pasted code so line numbers,
    // click-to-locate and find all work on them
    if (DATA.initialExplain) {
      state.src = 'paste';
      state.paste.text = DATA.initialExplain;
      state.paste.lines = DATA.initialExplain.split(/\r?\n/);
      state.gsel = { anchor: 0, from: 0, to: state.paste.lines.length - 1 };
    }

    /* ---------------- controller cross-check ----------------
       ncSender caches the controller's own $ES/$$ enumeration and serves
       it at /api/firmware. We use it to flag database settings that do
       not exist on THIS machine's firmware build, and to show the live
       value of the ones that do. Fails soft: no data, no flags. */
    var MACHINE = { state: 'loading', has: {}, values: {}, fw: '' };

    function apiBase() {
      try {
        if (window.ncSender && typeof window.ncSender.getApiBaseUrl === 'function')
          return window.ncSender.getApiBaseUrl(null);
      } catch (e) {}
      try {
        if (window.parent && window.parent.ncSender && typeof window.parent.ncSender.getApiBaseUrl === 'function')
          return window.parent.ncSender.getApiBaseUrl(null);
      } catch (e) {}
      return '';
    }

    (function loadMachineSettings() {
      if (typeof fetch === 'undefined') { MACHINE.state = 'unavailable'; return; }
      try {
        fetch(apiBase() + '/api/firmware')
          .then(function (r) { return r && r.ok ? r.json() : null; })
          .then(function (data) {
            var settings = data && (data.settings || data.Settings);
            if (settings && Object.keys(settings).length > 0) {
              Object.keys(settings).forEach(function (k) {
                if (!/^\d+$/.test(k)) return;
                MACHINE.has[k] = true;
                var v = settings[k] || {};
                var val = (v.value !== undefined && v.value !== null) ? v.value
                        : (v.Value !== undefined && v.Value !== null) ? v.Value : null;
                if (val !== null) MACHINE.values[k] = String(val);
              });
              MACHINE.fw = String(data.firmwareVersion || data.FirmwareVersion || '');
              MACHINE.state = 'ready';
            } else {
              MACHINE.state = 'unavailable';
            }
            if (state.tab === 'reference') renderReference();
          })
          .catch(function () {
            MACHINE.state = 'unavailable';
            if (state.tab === 'reference') renderReference();
          });
      } catch (e) { MACHINE.state = 'unavailable'; }
    })();

    /* ---------------- search ---------------- */
    function normalizeCode(letter, num) {
      // G01 -> G1, M06 -> M6, G38.2 stays G38.2
      var n = parseFloat(num);
      if (isNaN(n)) return letter.toUpperCase();
      return letter.toUpperCase() + (n % 1 === 0 ? String(Math.round(n)) : String(n));
    }

    function search(query, category) {
      var q = (query || '').trim().toLowerCase();
      var results = [];
      ALL.forEach(function (e) {
        if (category !== 'all' && e.category !== category) return;
        if (!q) { results.push({ e: e, score: 1 }); return; }
        var score = 0;
        var codeU = e.code.toLowerCase();
        var aliasHit = (e.aliases || []).some(function (a) { return a.toLowerCase() === q; });
        // exact / prefix code match (also try normalized: "g01" -> "g1")
        var m = q.match(/^([a-z])0*(\d+(?:\.\d+)?)$/);
        var qNorm = m ? (m[1] + parseFloat(m[2])) : q;
        if (codeU === q || codeU === qNorm || aliasHit) score = 100;
        else if (codeU.indexOf(qNorm) === 0 || codeU.indexOf(q) === 0) score = 60;
        else if ((e.keywords || []).some(function (k) { return k === q; })) score = 50;
        else if ((e.keywords || []).some(function (k) { return k.indexOf(q) !== -1; })) score = 30;
        else if (e.name.toLowerCase().indexOf(q) !== -1) score = 25;
        else if ((e.desc || '').toLowerCase().indexOf(q) !== -1) score = 10;
        if (score > 0) results.push({ e: e, score: score });
      });
      results.sort(function (a, b) { return b.score - a.score; });
      return results.map(function (r) { return r.e; });
    }

    /* ---------------- explain ---------------- */
    function explainLine(line) {
      var words = [];
      var work = line;

      // pull out comments first - they are annotations, not commands
      work = work.replace(/\(([^)]*)\)/g, function (mm, inner) {
        words.push({ tok: '(' + inner + ')', desc: 'Comment - ignored by the controller', kind: 'comment' });
        return ' ';
      });
      var semi = work.indexOf(';');
      if (semi !== -1) {
        words.push({ tok: work.slice(semi), desc: 'Comment - everything after ; is ignored', kind: 'comment' });
        work = work.slice(0, semi);
      }

      // whole-line $ system commands ($H, $J=..., $110=500, $$, $SLOT3, $ADB_RETRACT ...)
      var sysMatch = work.trim().match(/^(\$\d+=?|\$[A-Za-z][A-Za-z0-9_]*=?|\$[#$+]*=?)(.*)$/);
      if (sysMatch && work.trim().charAt(0) === '$') {
        var head = sysMatch[1].replace(/=$/, '');
        var rest = (sysMatch[2] || '').trim();
        var numSetting = head.match(/^\$(\d+)$/);
        var entry = CODEMAP[head.toUpperCase()] || CODEMAP[head.toUpperCase() + '='] || null;
        if (numSetting && !entry) entry = CODEMAP['$' + numSetting[1]];
        if (!entry && /^\$H[XYZABC]$/i.test(head)) entry = CODEMAP['$H'];
        if (!entry && /^\$SLOT0*\d+$/i.test(head)) entry = CODEMAP['$SLOT1']; // Rapid Change ATC slots
        if (entry) {
          words.push({ tok: head, desc: entry.name + ' - ' + entry.desc, kind: 'command' });
        } else {
          words.push({ tok: head, desc: 'grblHAL system command/setting (not in local DB - run $ES on the controller for details)', kind: 'unknown' });
        }
        if (head.toUpperCase() === '$J') {
          // explain the jog body as G-code
          var sub = explainLine(rest);
          sub.forEach(function (w) { words.push(w); });
          return words;
        }
        if (rest) {
          words.push({ tok: rest, desc: numSetting ? 'New value for this setting' : 'Argument', kind: 'value' });
        }
        return words;
      }

      // tokenize letter+number words, tracking what each match consumes so
      // anything left over can be flagged as not-G-code
      var consumed = [];
      function markSpan(from, len) { consumed.push([from, from + len]); }

      // grblHAL macro / flow-control syntax is valid even though it isn't
      // letter+number words: o-words, #<vars>, [expressions], keywords
      var FLOW_RE = /(^[oO]\d+)|(#<[^>]*>)|(#\d+)|(\[[^\]]*\])|\b(IF|THEN|ELSE|ELSEIF|ENDIF|WHILE|ENDWHILE|DO|REPEAT|ENDREPEAT|SUB|ENDSUB|CALL|RETURN|EQ|NE|GT|GE|LT|LE|AND|OR|XOR|MOD)\b/g;
      var fm;
      while ((fm = FLOW_RE.exec(work)) !== null) {
        markSpan(fm.index, fm[0].length);
        words.push({ tok: fm[0], desc: 'grblHAL macro / expression syntax', kind: 'value' });
      }

      var re = /([A-Za-z])\s*([+-]?(?:\d+\.?\d*|\.\d+))/g;
      var tokens = [];
      var mtk;
      while ((mtk = re.exec(work)) !== null) {
        // skip letter+number pairs inside spans already claimed by flow syntax
        var inFlow = false;
        for (var fi = 0; fi < consumed.length; fi++) {
          if (mtk.index >= consumed[fi][0] && mtk.index < consumed[fi][1]) { inFlow = true; break; }
        }
        if (inFlow) continue;
        markSpan(mtk.index, mtk[0].length);
        tokens.push({ letter: mtk[1].toUpperCase(), value: mtk[2] });
      }

      // first pass: identify command words (G/M with a DB entry),
      // including two-word forms like "G10 L2" / "G10 L20"
      var cmdEntries = [];
      tokens.forEach(function (t) {
        t.code = normalizeCode(t.letter, t.value);
        if (t.letter === 'G' || t.letter === 'M') {
          var entry = CODEMAP[t.code];
          // special-case G10: combine with its L word for the right doc
          if (t.code === 'G10') {
            var lTok = null;
            for (var li = 0; li < tokens.length; li++) {
              if (tokens[li].letter === 'L') { lTok = tokens[li]; break; }
            }
            if (lTok) {
              var combo = CODEMAP['G10 L' + parseFloat(lTok.value)];
              if (combo) { entry = combo; lTok.consumedByG10 = true; }
            }
          }
          if (entry) { t.entry = entry; cmdEntries.push(entry); }
        }
        if (t.letter === 'T') { t.entry = null; t.isT = true; }
      });

      // second pass: build word annotations
      tokens.forEach(function (t) {
        if (t.entry) {
          words.push({ tok: t.letter + t.value,
                       desc: t.entry.name + (t.entry.modal ? ' [' + t.entry.modal + ']' : ''),
                       sub: t.entry.desc, kind: 'command' });
          return;
        }
        if (t.letter === 'N') {
          words.push({ tok: t.letter + t.value, desc: 'Line number ' + t.value + ' - ignored by execution', kind: 'value' });
          return;
        }
        if (t.isT) {
          words.push({ tok: 'T' + t.value, desc: 'Tool select - pre-selects tool ' + parseFloat(t.value) + ' for M6', kind: 'value' });
          return;
        }
        if (t.consumedByG10) {
          words.push({ tok: 'L' + t.value, desc: 'Data mode for G10 (' + parseFloat(t.value) + ')', kind: 'value' });
          return;
        }
        // parameter: find the first command on the line documenting this letter
        var meaning = null;
        for (var ci = 0; ci < cmdEntries.length; ci++) {
          if (cmdEntries[ci].params && cmdEntries[ci].params[t.letter]) {
            meaning = cmdEntries[ci].params[t.letter] + '  (for ' + cmdEntries[ci].code + ')';
            break;
          }
        }
        if (!meaning) meaning = DATA.letters[t.letter] || 'Unrecognized word';
        words.push({ tok: t.letter + t.value, desc: meaning + ' = ' + t.value,
                     kind: meaning === 'Unrecognized word' ? 'unknown' : 'value' });
      });

      // anything not consumed by comments, flow syntax, or recognized
      // letter+number words is residue - flag it as not valid G-code
      var mask = new Array(work.length);
      consumed.forEach(function (span) {
        for (var mi = span[0]; mi < span[1] && mi < work.length; mi++) mask[mi] = true;
      });
      var frag = '';
      var frags = [];
      for (var wi = 0; wi <= work.length; wi++) {
        var chr = wi < work.length ? work.charAt(wi) : ' ';
        if (wi < work.length && !mask[wi] && !/\s/.test(chr)) {
          frag += chr;
        } else if (frag) {
          frags.push(frag); frag = '';
        }
      }
      frags.slice(0, 6).forEach(function (f) {
        words.push({ tok: f.length > 40 ? f.slice(0, 40) + '\u2026' : f,
                     desc: 'Not recognized as G-code', kind: 'invalid' });
      });

      if (words.length === 0) {
        words.push({ tok: line.trim() || '(empty)', desc: 'Nothing recognizable on this line', kind: 'unknown' });
      }
      return words;
    }

    /* ---------------- rendering ---------------- */
    function esc(s) {
      return String(s == null ? '' : s)
        .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
    }

    function badgeFor(e) {
      var cat = null;
      for (var i = 0; i < CATEGORIES.length; i++) {
        if (CATEGORIES[i].id === e.category) { cat = CATEGORIES[i]; break; }
      }
      return cat ? cat.label : e.category;
    }

    function renderCard(e) {
      var cc = catColor(e.category);
      var absentColor = IS_LIGHT ? '#c62839' : '#ff6b81';
      var open = state.open[e.code] ? ' open' : '';
      // controller cross-check applies to numeric $ settings only
      var mnum = e.code.match(/^\$(\d+)$/);
      var onMachine = null, liveVal;
      if (mnum && MACHINE.state === 'ready') {
        onMachine = !!MACHINE.has[mnum[1]];
        liveVal = MACHINE.values[mnum[1]];
      }
      var html = '<div class="gref-card' + open + '" data-code="' + esc(e.code) + '">';
      html += '<div class="gref-card-head" onclick="grefToggle(this)"' + (onMachine === false ? ' style="opacity:0.55"' : '') + '>';
      html += '<span class="gref-caret">&#9654;</span>';
      // code text matches its category filter color (association at a glance)
      html += '<span class="gref-codechip" style="color:' + cc + ';border:1px solid ' + cc + '55;background:var(--color-surface,#1a2027)">' + esc(e.code) + '</span>';
      html += '<span class="gref-name">' + esc(e.name) + '</span>';
      if (onMachine === true && liveVal !== undefined) {
        html += '<span class="gref-codechip" title="Current value on this controller" style="color:var(--color-accent,#10b981);border:1px solid var(--color-border,#333a45);background:var(--color-surface,#1a2027);font-weight:600">= ' + esc(liveVal) + '</span>';
      }
      if (onMachine === false) {
        html += '<span class="gref-badge" style="color:' + absentColor + ';border:1px solid ' + absentColor + '55;opacity:0.9">not on this controller</span>';
      }
      html += '<span class="gref-badge" style="color:' + cc + ';border:1px solid ' + cc + '55;opacity:0.85">' + esc(badgeFor(e)) + '</span>';
      html += '</div><div class="gref-detail">';
      if (onMachine === true && liveVal !== undefined) {
        html += '<div class="gref-label">Current value on this controller</div><div class="gref-pre">' + esc(e.code) + '=' + esc(liveVal) + '</div>';
      }
      if (onMachine === false) {
        html += '<div class="gref-tip" style="border-left-color:' + absentColor + '">Your controller&rsquo;s $ES enumeration does not include this setting &mdash; this firmware build does not have the feature compiled in, or its plugin is disabled.</div>';
      }
      html += '<p>' + esc(e.desc) + '</p>';
      if (e.modal) html += '<p class="sub" style="color:var(--color-text-secondary,#9aa4b2);font-size:0.78rem">Modal group: ' + esc(e.modal) + '</p>';
      if (e.syntax) { html += '<div class="gref-label">Syntax</div><div class="gref-pre">' + esc(e.syntax) + '</div>'; }
      var pkeys = Object.keys(e.params || {});
      if (pkeys.length) {
        html += '<div class="gref-label">Parameters</div><table class="gref-params">';
        pkeys.forEach(function (k) { html += '<tr><td>' + esc(k) + '</td><td>' + esc(e.params[k]) + '</td></tr>'; });
        html += '</table>';
      }
      if (e.example) { html += '<div class="gref-label">Example</div><div class="gref-pre">' + esc(e.example) + '</div>'; }
      if (e.tips) { html += '<div class="gref-tip">' + esc(e.tips) + '</div>'; }
      html += '</div></div>';
      return html;
    }

    function renderReference() {
      var body = document.getElementById('gref-body');
      var results = search(state.query, state.category);
      var shown = results;
      var html = '';
      if (results.length === 0) {
        html = '<div class="gref-empty">No matches for &ldquo;' + esc(state.query) + '&rdquo;.<br>' +
               'Try a code (G38.2, $110, M6) or a keyword (dwell, probe, laser, tool change).</div>';
      } else {
        var status = '';
        if (MACHINE.state === 'ready') {
          status = ' &middot; checked against your controller' + (MACHINE.fw ? ' (' + esc(MACHINE.fw) + ')' : '');
        } else if (MACHINE.state === 'unavailable') {
          status = ' &middot; controller settings unavailable &mdash; cannot flag which exist on your machine';
        }
        html += '<div class="gref-count">' + shown.length +
                (shown.length < results.length ? ' of ' + results.length : '') +
                ' entr' + (shown.length === 1 ? 'y' : 'ies') + status + '</div>';
        // auto-expand the top hit of a terminal lookup
        if (state.query && shown.length > 0) state.open[shown[0].code] = true;
        shown.forEach(function (e) { html += renderCard(e); });
      }
      body.innerHTML = html;
    }

    var CHUNK_ROWS = 4000; // rows rendered per batch; scrolling/jumping loads more
    var SEL_BG = 'rgba(16,185,129,0.18)';

    /* ---- G-code syntax coloring ----
       Replicates ncSender's G-Code Preview highlighter (highlightGcode in
       ConsolePanel.vue): same rules, same gc-* palette. The preview's
       sequential replacements effectively let chained words match (X0.5Y0.2
       colors BOTH words, since wrapping X0.5 creates a boundary before Y),
       so a word rule here only requires that the previous character is not
       a letter. Unmatched bare numbers stay the default text color, exactly
       like the preview. */
    var GCODE_COLORS = IS_LIGHT ? {
      comment: { c: '008000', i: 1 }, number: { c: '098658' },
      rapid: { c: 'E67E22', b: 1 }, cutting: { c: '2E86C1', b: 1 },
      g: { c: 'AF00DB' }, m: { c: '795E26' }, tool: { c: '267F99' },
      spindle: { c: 'A31515' }, feed: { c: '098658' },
      x: { c: 'C72828' }, y: { c: '267F99' }, z: { c: '2E86C1' },
      other: { c: '0070C1' }, nline: { c: '999999' }
    } : {
      comment: { c: '6A9955', i: 1 }, number: { c: 'B5CEA8' },
      rapid: { c: 'FF8C00', b: 1 }, cutting: { c: '569CD6', b: 1 },
      g: { c: 'C586C0' }, m: { c: 'DCDCAA' }, tool: { c: '4EC9B0' },
      spindle: { c: 'CE9178' }, feed: { c: 'B5CEA8' },
      x: { c: 'F14C4C' }, y: { c: '4EC9B0' }, z: { c: '569CD6' },
      other: { c: '9CDCFE' }, nline: { c: '858585' }
    };

    function gtok(kind, text) {
      var s = GCODE_COLORS[kind];
      return '<span style="color:#' + s.c + (s.b ? ';font-weight:600' : '') +
             (s.i ? ';font-style:italic' : '') + '">' + esc(text) + '</span>';
    }

    var GCODE_WORD_RULES = [
      // [first-char matcher, sticky pattern, token] in Monarch rule order
      [/[Gg]/, /^[Gg]0*(?=[\sA-Za-z]|$)/, 'rapid'],
      [/[Gg]/, /^[Gg][1-3](?![A-Za-z0-9_])/, 'cutting'],
      [/[Gg]/, /^[Gg]\d+\.?\d*/, 'g'],
      [/[Mm]/, /^[Mm]\d+/, 'm'],
      [/[Tt]/, /^[Tt]\d+/, 'tool'],
      [/[Ss]/, /^[Ss]\d+\.?\d*/, 'spindle'],
      [/[Ff]/, /^[Ff]\d+\.?\d*/, 'feed'],
      [/[Xx]/, /^[Xx]-?\d+\.?\d*/, 'x'],
      [/[Yy]/, /^[Yy]-?\d+\.?\d*/, 'y'],
      [/[Zz]/, /^[Zz]-?\d+\.?\d*/, 'z'],
      [/[AaBbCcIiJjKk]/, /^[AaBbCcIiJjKk]-?\d+\.?\d*/, 'other'],
      [/[Nn]/, /^[Nn]\d+/, 'nline']
    ];

    function hlGcode(line) {
      var out = '', i = 0, n = line.length;
      while (i < n) {
        var ch = line.charAt(i);
        var rest = line.slice(i);
        var m;
        if (ch === ';') { out += gtok('comment', rest); break; }
        if (ch === '(') {
          m = rest.match(/^\(.*?\)/);
          if (m) { out += gtok('comment', m[0]); i += m[0].length; continue; }
        }
        // preview semantics: a word matches unless glued to a preceding letter
        var prevLetter = i > 0 && /[A-Za-z]/.test(line.charAt(i - 1));
        if (!prevLetter && /[A-Za-z]/.test(ch)) {
          var matched = false;
          for (var r = 0; r < GCODE_WORD_RULES.length; r++) {
            if (!GCODE_WORD_RULES[r][0].test(ch)) continue;
            m = rest.match(GCODE_WORD_RULES[r][1]);
            if (m) { out += gtok(GCODE_WORD_RULES[r][2], m[0]); i += m[0].length; matched = true; break; }
          }
          if (matched) continue;
        }
        out += esc(ch); i++;
      }
      return out;
    }

    // classify a single already-split token (for the explanation tables)
    function gcodeTokenKind(tok) {
      if (/^[;(]/.test(tok)) return 'comment';
      if (!/^[A-Za-z$]/.test(tok)) return null;
      for (var r = 0; r < GCODE_WORD_RULES.length; r++) {
        var m = tok.match(GCODE_WORD_RULES[r][1]);
        if (m && m[0].length === tok.length) return GCODE_WORD_RULES[r][2];
      }
      return null;
    }

    function loadGcodeFile() {
      state.gfile.status = 'loading';
      if (typeof fetch === 'undefined') {
        state.gfile = { status: 'none', name: '', lines: [] };
        return;
      }
      try {
        // the loaded program itself
        fetch(apiBase() + '/api/gcode-files/current/download')
          .then(function (r) { return r && r.ok ? r.text() : null; })
          .then(function (text) {
            if (text === null || text === undefined) {
              state.gfile = { status: 'none', name: '', lines: [] };
            } else {
              state.gfile = { status: 'ready', name: '', lines: text.split(/\r?\n/) };
            }
            if (state.tab === 'explain') renderExplain();
          })
          .catch(function () {
            state.gfile = { status: 'none', name: '', lines: [] };
            if (state.tab === 'explain') renderExplain();
          });
        // the loaded file's name (best effort - shown in the header)
        fetch(apiBase() + '/api/gcode-job/status')
          .then(function (r) { return r && r.ok ? r.json() : null; })
          .then(function (s) {
            if (!s) return;
            var name = s.currentFile || s.CurrentFile || s.fileName || s.FileName ||
                       s.currentGcodeFile || s.CurrentGcodeFile || '';
            if (name && state.gfile.status === 'ready') {
              state.gfile.name = String(name).split(/[\\/]/).pop();
              var head = document.getElementById('gref-filename');
              if (head) head.innerHTML = esc(state.gfile.name);
            }
          })
          .catch(function () {});
      } catch (e) {
        state.gfile = { status: 'none', name: '', lines: [] };
      }
    }

    function activeSrc() {
      if (state.src === 'paste') {
        return { ready: state.paste.lines.length > 0, lines: state.paste.lines };
      }
      return { ready: state.gfile.status === 'ready', lines: state.gfile.lines };
    }

    function exStartLine() {
      return (activeSrc().ready && state.gsel.from >= 0) ? state.gsel.from : null;
    }

    function updateJumpInput() {
      var inp = document.getElementById('gref-jump');
      if (!inp) return;
      var s = state.gsel;
      inp.value = s.from < 0 ? '' :
        (s.from === s.to ? String(s.from + 1) : (s.from + 1) + '-' + (s.to + 1));
    }

    function updateExout() {
      var el = document.getElementById('gref-exout');
      if (el) el.innerHTML = renderExplainOutput(state.explainText, exStartLine());
      updateJumpInput();
    }

    var SEL_FOCUS = 'rgba(16,185,129,0.38)';

    function applySelectionHighlights() {
      try {
        var s = state.gsel;
        var list = document.getElementById('gref-filelist');
        var kids = list && list.children;
        if (!kids) return;
        for (var k = 0; k < kids.length; k++) {
          var attr = kids[k].getAttribute && kids[k].getAttribute('data-i');
          if (attr === null || attr === undefined) continue;
          var idx = parseInt(attr, 10);
          kids[k].style.background = idx === state.gfocus ? SEL_FOCUS
            : (idx >= s.from && idx <= s.to) ? SEL_BG : 'transparent';
        }
      } catch (e) {}
    }

    window.grefOpenInNavigator = function (idx) {
      state.tab = 'navigator';
      render();
      // give first-time activation a beat, then drive the navigator's own
      // line input; its input/change listeners select the line on the map
      setTimeout(function () {
        try {
          var inp = document.getElementById('gn-line-input');
          if (!inp) return;
          inp.value = String(idx + 1);
          if (typeof Event === 'function' && inp.dispatchEvent) {
            inp.dispatchEvent(new Event('input'));
            inp.dispatchEvent(new Event('change'));
          }
        } catch (e) {}
      }, 80);
    };

    window.grefExplainLineNum = function (v) {
      var n = parseInt(v, 10);
      if (isNaN(n) || n < 1) return;
      state.tab = 'explain';
      state.src = 'file';
      state.pendingJump = n;
      render();
      // if the file is already loaded, jump immediately; otherwise
      // renderExplain consumes pendingJump once the load lands
      if (state.gfile.status === 'ready') {
        state.pendingJump = null;
        window.grefJump(String(n));
      }
    };

    window.grefExFocus = function (idx, el) {
      state.gfocus = idx;
      applySelectionHighlights();
      scrollToLine(idx);
      // second-level highlight on the clicked explanation block too
      try {
        var sib = el && el.parentElement && el.parentElement.children;
        if (sib) for (var k = 0; k < sib.length; k++) sib[k].style.boxShadow = '';
        if (el) el.style.boxShadow = 'inset 0 0 0 1px var(--color-accent, #10b981)';
      } catch (e) {}
    };

    function fileRowStyle(selected) {
      return 'display:flex;gap:10px;padding:1px 8px;cursor:pointer;' +
             'background:' + (selected ? SEL_BG : 'transparent') + ';';
    }

    function buildRows(lines, from, to, numW) {
      var html = '';
      for (var i = from; i < to; i++) {
        var selected = i >= state.gsel.from && i <= state.gsel.to;
        html += '<div data-i="' + i + '" onclick="grefLineClick(event,' + i + ')" style="' + fileRowStyle(selected) + '">' +
                '<span style="color:var(--color-text-secondary,#9aa4b2);min-width:' + numW + 'ch;text-align:right;user-select:none">' + (i + 1) + '</span>' +
                '<span style="flex:1;min-width:0;white-space:pre;overflow:hidden;text-overflow:ellipsis">' + (lines[i] ? hlGcode(lines[i]) : '&nbsp;') + '</span></div>';
      }
      return html;
    }

    function updateRenderNote() {
      var el = document.getElementById('gref-rendernote');
      if (!el) return;
      var a = activeSrc();
      if (a.ready && state.rendered < a.lines.length) {
        el.style.display = '';
        el.innerHTML = 'Rendered ' + state.rendered + ' of ' + a.lines.length +
                       ' lines &mdash; scroll on, or jump/search/"end" to load the rest instantly';
      } else {
        el.style.display = 'none';
      }
    }

    function appendChunk() {
      var a = activeSrc();
      if (!a.ready) return;
      var list = document.getElementById('gref-filelist');
      if (!list) return;
      var n = a.lines.length;
      if (state.rendered >= n) return;
      var to = Math.min(n, state.rendered + CHUNK_ROWS);
      var html = buildRows(a.lines, state.rendered, to, String(n).length);
      if (typeof list.insertAdjacentHTML === 'function') list.insertAdjacentHTML('beforeend', html);
      else list.innerHTML += html;
      state.rendered = to;
      updateRenderNote();
    }

    function ensureRendered(idx) {
      var a = activeSrc();
      if (!a.ready) return;
      var guard = 0;
      while (state.rendered <= idx && state.rendered < a.lines.length && guard++ < 2000) appendChunk();
    }

    window.grefListScroll = function (el) {
      try {
        if (el.scrollTop + el.clientHeight >= el.scrollHeight - 600) appendChunk();
      } catch (e) {}
    };

    function renderExplain() {
      var body = document.getElementById('gref-body');
      var a = activeSrc();
      state.rendered = 0;
      var html = '<div class="gref-exwrap" id="gref-exwrap" style="display:flex;flex-direction:row;flex:1;min-height:0;min-width:0;max-width:100%">';

      /* ---- left: source pane (loaded file OR pasted code) ---- */
      html += '<div id="gref-leftpane" style="flex:0 0 ' + state.splitPct + '%;display:flex;flex-direction:column;min-width:0;min-height:0;' +
              'border:1px solid var(--color-border,#333a45);border-radius:var(--radius-small,6px);overflow:hidden">';

      // source toggle
      function seg(src, label, active) {
        return '<button onclick="grefSetSrc(&quot;' + src + '&quot;)" style="flex:1;padding:6px 0;font-size:0.75rem;' +
               'cursor:pointer;border:none;border-radius:0;text-align:center;' +
               (active ? 'background:var(--color-accent,#10b981);color:#fff;font-weight:600;'
                       : 'background:transparent;color:var(--color-text-secondary,#9aa4b2);') + '">' + label + '</button>';
      }
      html += '<div style="display:flex;border-bottom:1px solid var(--color-border,#333a45)">' +
              seg('file', 'Loaded file', state.src === 'file') +
              seg('paste', 'Paste code', state.src === 'paste') + '</div>';

      var isPaste = state.src === 'paste';
      var g = state.gfile;

      if (!isPaste && (g.status === 'loading' || g.status === 'idle')) {
        html += '<div class="gref-empty" style="padding:20px">Loading the current G-code file&hellip;</div>';
      } else if (!isPaste && g.status === 'none') {
        html += '<div class="gref-empty" style="padding:20px">No G-code file is loaded in ncSender ' +
                '(<a href="#" onclick="grefReloadFile();return false" style="color:var(--color-accent,#10b981);text-decoration:none">check again</a>).' +
                '<br><br>Switch to <b>Paste code</b> above to explain arbitrary G-code.</div>';
      } else {
        var n = a.lines.length;
        var jv = state.gsel.from < 0 ? '' :
                 (state.gsel.from === state.gsel.to ? String(state.gsel.from + 1)
                  : (state.gsel.from + 1) + '-' + (state.gsel.to + 1));
        // header: title | jump | of N lines | end | reload/clear
        html += '<div style="padding:6px 10px;font-size:0.75rem;color:var(--color-text-secondary,#9aa4b2);' +
                'border-bottom:1px solid var(--color-border,#333a45);display:flex;gap:8px;align-items:center">' +
                '<span id="gref-filename" style="color:var(--color-text-primary,#e8eaed);font-weight:600">' +
                (isPaste ? 'Pasted code' : (g.name ? esc(g.name) : 'Loaded file')) + '</span>' +
                '<input id="gref-jump" value="' + esc(jv) + '" placeholder="line #" ' +
                'title="Type a line number (or a range like 120-135) and press Enter to jump" ' +
                'onkeydown="if(event.key===&quot;Enter&quot;){grefJump(this.value);}" onchange="grefJump(this.value)" ' +
                'style="width:84px;padding:2px 6px;font-family:ui-monospace,Menlo,Consolas,monospace;font-size:0.74rem;' +
                'background:var(--color-surface,#1a2027);color:var(--color-text-primary,#e8eaed);' +
                'border:1px solid var(--color-border,#333a45);border-radius:4px;text-align:center">' +
                '<span>of <span id="gref-linecount">' + n + '</span> lines</span>' +
                '<a href="#" onclick="grefJumpEnd();return false" title="Jump to the last line" ' +
                'style="color:var(--color-accent,#10b981);text-decoration:none">end &#8595;</a>' +
                '<span style="flex:1"></span>' +
                (isPaste
                  ? '<a href="#" onclick="grefPasteClear();return false" style="color:var(--color-accent,#10b981);text-decoration:none">clear</a>'
                  : '<a href="#" onclick="grefReloadFile();return false" style="color:var(--color-accent,#10b981);text-decoration:none">reload</a>') +
                '</div>';
        // paste editor
        if (isPaste) {
          html += '<textarea id="gref-paste" spellcheck="false" oninput="grefPasteInput(this.value)" ' +
                  'placeholder="Paste one or more lines of G-code, e.g.&#10;G90 G21 G17&#10;G1 X10 Y5 F500&#10;M4 S800" ' +
                  'style="flex:0 0 auto;height:92px;margin:8px 8px 0;padding:6px 8px;resize:vertical;' +
                  'font-family:ui-monospace,Menlo,Consolas,monospace;font-size:0.76rem;' +
                  'background:var(--color-surface,#1a2027);color:var(--color-text-primary,#e8eaed);' +
                  'border:1px solid var(--color-border,#333a45);border-radius:4px">' + esc(state.paste.text) + '</textarea>';
        }
        // search row
        var fbtn = 'background:transparent;border:1px solid var(--color-border,#333a45);' +
                   'color:var(--color-text-secondary,#9aa4b2);border-radius:4px;padding:2px 8px;cursor:pointer;font-size:0.72rem;';
        html += '<div style="display:flex;gap:6px;align-items:center;padding:6px 8px;' +
                'border-bottom:1px solid var(--color-border,#333a45)">' +
                '<input id="gref-fsearch" placeholder="Find&hellip;" value="' + esc(state.fsearch.q) + '" ' +
                'oninput="grefFileSearch(this.value)" ' +
                'onkeydown="if(event.key===&quot;Enter&quot;){grefFileFind(event.shiftKey?-1:1);}" ' +
                'style="flex:1;min-width:0;padding:3px 8px;font-family:ui-monospace,Menlo,Consolas,monospace;font-size:0.76rem;' +
                'background:var(--color-surface,#1a2027);color:var(--color-text-primary,#e8eaed);' +
                'border:1px solid var(--color-border,#333a45);border-radius:4px">' +
                '<span id="gref-fsearch-count" style="min-width:70px;text-align:right;font-size:0.7rem;' +
                'color:var(--color-text-secondary,#9aa4b2)"></span>' +
                '<button title="Previous match (Shift+Enter)" onclick="grefFileFind(-1)" style="' + fbtn + '">&#9650;</button>' +
                '<button title="Next match (Enter)" onclick="grefFileFind(1)" style="' + fbtn + '">&#9660;</button>' +
                '<button title="Clear search" onclick="grefFileSearchClear()" style="' + fbtn + '">&#10005;</button>' +
                '</div>';
        html += '<div style="padding:5px 10px;font-size:0.72rem;color:var(--color-text-secondary,#9aa4b2);' +
                'border-bottom:1px solid var(--color-border,#333a45)">Click a line to explain it &middot; Shift+click to explain a range</div>';
        // the list itself: first chunk now, more on scroll / jump / search
        html += '<div id="gref-filelist" onscroll="grefListScroll(this)" ' +
                'style="flex:1;overflow-y:auto;font-family:ui-monospace,Menlo,Consolas,monospace;font-size:0.78rem;line-height:1.45">';
        if (n === 0) {
          html += '<div class="gref-empty" style="padding:16px">Paste G-code above to browse and explain it.</div>';
        } else {
          var first = Math.min(n, CHUNK_ROWS);
          html += buildRows(a.lines, 0, first, String(n).length);
        }
        html += '</div>';
        html += '<div id="gref-rendernote" style="display:none;padding:4px 10px;font-size:0.7rem;' +
                'color:var(--color-text-secondary,#9aa4b2);border-top:1px solid var(--color-border,#333a45)"></div>';
        if (n > 0) state.rendered = Math.min(n, CHUNK_ROWS);
      }
      html += '</div>';

      /* ---- draggable divider ---- */
      html += '<div onmousedown="grefSplitStart(event)" title="Drag to resize the panes" ' +
              'style="flex:0 0 6px;cursor:col-resize;align-self:stretch;margin:0 3px;border-radius:3px;' +
              'background:var(--color-border,#333a45)"></div>';

      /* ---- right: the word-by-word breakdown ---- */
      html += '<div style="flex:1;display:flex;flex-direction:column;min-width:0;min-height:0;' +
              'border:1px solid var(--color-border,#333a45);border-radius:var(--radius-small,6px);overflow:hidden">';
      html += '<div style="padding:6px 10px;font-size:0.75rem;' +
              'border-bottom:1px solid var(--color-border,#333a45);display:flex;align-items:center;min-height:29px">' +
              '<span style="color:var(--color-text-primary,#e8eaed);font-weight:600">G-Code Definitions</span></div>';
      html += '<div id="gref-exout" style="flex:1;overflow-y:auto;min-width:0;padding:8px">';
      html += state.explainText.trim()
        ? renderExplainOutput(state.explainText, exStartLine())
        : '<div class="gref-empty">' + (a.ready
            ? 'Select a line on the left to see it explained word by word.'
            : 'Explanations appear here.') + '</div>';
      html += '</div></div></div>';
      body.innerHTML = html;
      updateRenderNote();
      if (state.src === 'file' && state.gfile.status === 'idle') loadGcodeFile();
      if (state.pendingJump && state.src === 'file' && state.gfile.status === 'ready') {
        var pj = state.pendingJump;
        state.pendingJump = null;
        setTimeout(function () { try { window.grefJump(String(pj)); } catch (e) {} }, 0);
      }
    }

    function renderExplainOutput(text, startLine) {
      var out = '';
      var all = text.split(/\r?\n/);
      var MAX_EXPLAIN = 300;
      var lines = all.length > MAX_EXPLAIN ? all.slice(0, MAX_EXPLAIN) : all;
      lines.forEach(function (line, li) {
        if (!line.trim()) return;
        var wordsArr = explainLine(line);
        var invalidCount = 0, commandCount = 0;
        wordsArr.forEach(function (w) {
          if (w.kind === 'invalid') invalidCount++;
          if (w.kind === 'command') commandCount++;
        });
        var fileIdx = startLine === null || startLine === undefined ? null : startLine + li;
        var numHtml = fileIdx === null ? '' :
          '<span style="color:var(--color-text-secondary,#9aa4b2);font-weight:400;margin-right:10px;user-select:none">' + (fileIdx + 1) + '</span>';
        var mapBtn = (fileIdx === null || state.src !== 'file') ? '' :
          '<button onclick="event.stopPropagation();grefOpenInNavigator(' + fileIdx + ')" ' +
          'title="Show this line on the Explorer map" ' +
          'style="float:right;background:transparent;border:1px solid var(--color-border,#333a45);' +
          'color:var(--color-accent,#10b981);border-radius:4px;padding:1px 8px;cursor:pointer;font-size:0.7rem;margin-left:8px">' +
          '&#8982; Explorer</button>';
        var attrs = fileIdx === null ? '' :
          ' data-line="' + fileIdx + '" onclick="grefExFocus(' + fileIdx + ', this)" style="cursor:pointer"' +
          ' title="Click to locate line ' + (fileIdx + 1) + ' in the file"';
        out += '<div class="gref-exline"' + attrs + '><div class="gref-exline-src">' + mapBtn + numHtml + hlGcode(line.trim()) + '</div>';
        if (invalidCount > 0) {
          var warnColor = IS_LIGHT ? '#9a6700' : '#e3b341';
          out += '<div style="display:flex;gap:8px;align-items:center;padding:5px 10px;font-size:0.76rem;' +
                 'color:' + warnColor + ';border-left:3px solid ' + warnColor + ';margin:4px 0;' +
                 'background:rgba(227,179,65,0.08)">&#9888; ' +
                 (commandCount === 0
                   ? 'This line does not appear to be G-code'
                   : 'Parts of this line are not valid G-code') +
                 ' &mdash; unrecognized text is marked in red below.</div>';
        }
        out += '<div class="gref-exline-words">';
        wordsArr.forEach(function (w) {
          out += '<div class="gref-word ' + esc(w.kind) + '">';
          var tk = gcodeTokenKind(w.tok);
          var tokStyle = tk ? ' style="color:#' + GCODE_COLORS[tk].c + (GCODE_COLORS[tk].b ? ';font-weight:600' : '') + '"' : '';
          if (w.kind === 'invalid') tokStyle = ' style="color:' + (IS_LIGHT ? '#c62839' : '#ff6b81') + '"';
          out += '<span class="gref-word-tok"' + tokStyle + '>' + esc(w.tok) + '</span>';
          out += '<span class="gref-word-desc">' + esc(w.desc);
          if (w.sub) out += '<br><span class="sub">' + esc(w.sub) + '</span>';
          out += '</span></div>';
        });
        out += '</div></div>';
      });
      if (all.length > MAX_EXPLAIN) {
        out += '<div class="gref-empty">Explained the first ' + MAX_EXPLAIN + ' of ' + all.length + ' selected lines.</div>';
      }
      return out || '<div class="gref-empty">Nothing to explain yet.</div>';
    }

    function renderChips() {
      var el = document.getElementById('gref-chips');
      // Inline styles throughout: the dialog lives in ncSender's main
      // document, whose global button styling otherwise overrides our
      // classes. Inline always wins.
      el.innerHTML = CATEGORIES.map(function (c) {
        var active = state.category === c.id;
        var col = IS_LIGHT ? c.light : c.dark;
        // "All" matches the Reference/Explain buttons' accent highlight
        var fill = c.accent ? 'var(--color-accent, ' + col + ')' : col;
        var activeText = (c.accent || IS_LIGHT) ? '#fff' : '#10151c';
        var style;
        if (active) {
          style = 'background:' + fill + ';border:1px solid ' + fill +
                  ';color:' + activeText + ';font-weight:600;opacity:1;';
        } else {
          style = 'background:transparent;border:1px solid ' + col +
                  ';color:' + col + ';font-weight:400;opacity:0.55;';
        }
        return '<button class="gref-chip" style="' + style + '" ' +
               'onmouseover="this.style.opacity=1" ' +
               'onmouseout="this.style.opacity=' + (active ? 1 : 0.55) + '" ' +
               'onclick="grefSetCategory(&quot;' + c.id + '&quot;)">' + esc(c.label) + '</button>';
      }).join('');
    }

    function styleTab(el, active, visible) {
      // native ncSender tab look: transparent, icon + label, accent
      // underline on the active tab (inline styles beat host button CSS)
      el.style.display = visible === false ? 'none' : 'inline-flex';
      el.style.alignItems = 'center';
      el.style.gap = '7px';
      el.style.padding = '11px 14px';
      el.style.background = 'transparent';
      el.style.border = 'none';
      el.style.borderRadius = '0';
      el.style.cursor = 'pointer';
      el.style.fontSize = '0.9rem';
      el.style.marginBottom = '-1px'; // underline sits on the bar's border
      el.style.borderBottom = active
        ? '2px solid var(--color-accent, #10b981)'
        : '2px solid transparent';
      el.style.color = active
        ? 'var(--color-text-primary, #e8eaed)'
        : 'var(--color-text-secondary, #9aa4b2)';
      el.style.fontWeight = active ? '600' : '400';
      el.style.opacity = '1';
      try {
        var ic = el.querySelector ? el.querySelector('.gref-tab-ic') : null;
        if (ic) ic.style.color = active ? 'var(--color-accent, #10b981)' : 'inherit';
      } catch (e) {}
    }

    var MANUAL_URL = 'https://siganberg.github.io/ncSender.manual/';

    // ---- G-code Navigator pane (merged plugin) ----
    // NAV_MARKUP / NAV_SCRIPT are injected by the build from
    // build/navigator-panel.html. The navigator renders ONCE into #gn-host
    // on first tab activation and persists (hidden) across tab switches so
    // traced contours / analysis state survive. Its script is one strict
    // IIFE with gn-prefixed ids and --gn-* CSS vars, so it coexists with
    // the reference dialog without collisions.
    var NAV_MARKUP = "<style>\n  :root {\n    --gn-bg: #1e1e1e;\n    --gn-panel: #252526;\n    --gn-border: #3c3c3c;\n    --gn-text: #d4d4d4;\n    --gn-accent: #569cd6;\n    --gn-rapid: #ff8c00;\n    --gn-feed: #4ec9b0;\n    --gn-hull: #c586c0;\n    --gn-danger: #f14c4c;\n    --gn-jobstart: #43a047;\n    /* gSender-style \"already executed\" gray for traced G-code */\n    --gn-traced: #8c8c8c;\n  }\n  body.theme-light {\n    --gn-bg: #f8f8f8;\n    --gn-panel: #ffffff;\n    --gn-border: #d0d0d0;\n    --gn-text: #1e1e1e;\n  }\n  /* The host plugin dialog (.plugin-dialog-container in PluginDialog.vue)\n     is width:auto — it sizes to its content, and the showDialog 'size'\n     option is not applied to plugin dialogs at all. So the plugin content\n     itself must declare the window size. 75vw wide; map height budgeted so\n     header + tabs + status + legend fit inside the host's 85vh max-height\n     without forcing the content scrollbar. */\n  #gn-root { font-family: -apple-system, Segoe UI, sans-serif; color: var(--gn-text); font-size: 13px;\n    /* hosted as a tab: fill the host pane; the map flexes to the space */\n    width: 100%; max-width: none; flex: 1 1 auto; min-height: 0;\n    display: flex; flex-direction: column; padding: 0 12px 10px; }\n  #gn-header-strip { display: flex; align-items: center; gap: 10px; min-height: 22px; margin: 2px 0 5px; flex: 0 0 auto; }\n  #gn-root * { box-sizing: border-box; }\n  /* High-contrast selection color used for the selected vertex + list row */\n  :root { --gn-select: #ffd400; }\n  .gn-layout { position: relative; flex: 1 1 auto; min-height: 0; display: flex; gap: 14px; }\n  .gn-map-col { min-width: 0; display: flex; flex-direction: column; flex: 1 1 auto; min-height: 0; }\n  /* The map column is the sole height authority. The controls column is\n     ABSOLUTELY positioned against the layout box (whose height comes only\n     from the in-flow map column), pinned top:0/bottom:0 — its edges track\n     the map exactly without contributing to layout height. (The previous\n     height:0 + stretch attempt failed: an explicit height disables\n     stretch, collapsing the column.) The map column reserves the width. */\n  .gn-controls-col {\n    /* flex sibling of the map column: top and bottom edges align with the\n       rendering window (map + legend) automatically */\n    flex: 0 0 296px; width: 296px;\n    display: flex; flex-direction: column; min-height: 0;\n  }\n  /* Upper controls scroll; the JOG & ZERO box stays pinned and always\n     visible at the bottom of the column. */\n  .gn-controls-scroll { flex: 1 1 auto; min-height: 0; overflow-y: auto; overscroll-behavior: contain; padding-right: 2px; scrollbar-width: thin; }\n  .gn-controls-col > #gn-jog-box { flex: 0 0 auto; margin-top: 7px; margin-bottom: 0; }\n  .gn-map-wrap {\n    border: 1px solid var(--gn-border); border-radius: 4px; background: var(--gn-panel);\n    overflow: hidden; position: relative; flex: 1 1 auto;\n    /* hosted: the map takes whatever the tab gives it */\n    height: auto; min-height: 260px;\n  }\n  .gn-map-wrap svg {\n    display: block; width: 100%; height: 100%; cursor: crosshair;\n    user-select: none; -webkit-user-select: none; touch-action: none;\n    /* Promote to its own compositing layer: fixes iPad Safari failing to\n       repaint the SVG during zoom/pan transform updates. */\n    transform: translateZ(0); will-change: transform;\n  }\n  .gn-fit-btn {\n    position: absolute; top: 8px; right: 8px; z-index: 2;\n    padding: 4px 10px; font-size: 11px; border-radius: 3px; cursor: pointer;\n    background: var(--gn-bg); color: var(--gn-text); border: 1px solid var(--gn-border); opacity: 0.85;\n  }\n  .gn-fit-btn:hover { border-color: var(--gn-accent); opacity: 1; }\n  .gn-zoom-hint {\n    position: absolute; bottom: 6px; left: 8px; z-index: 2; font-size: 10px; opacity: 0.55; pointer-events: none;\n  }\n  .gn-field { margin-bottom: 6px; }\n  .gn-field label { display: block; margin-bottom: 3px; opacity: 0.8; font-size: 12px; }\n  .gn-field input[type=number], .gn-field input[type=text] {\n    width: 100%; padding: 5px 7px; background: var(--gn-bg); color: var(--gn-text);\n    border: 1px solid var(--gn-border); border-radius: 3px;\n  }\n  .gn-row { display: flex; gap: 8px; }\n  .gn-row > * { flex: 1; }\n  .gn-btn {\n    padding: 6px 12px; border-radius: 3px; border: 1px solid var(--gn-border); cursor: pointer;\n    background: var(--gn-panel); color: var(--gn-text); font-size: 12px; width: 100%; margin-bottom: 5px;\n  }\n  .gn-btn:hover { border-color: var(--gn-accent); }\n  .gn-actions-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 6px; margin-bottom: 8px; }\n  .gn-actions-grid .gn-btn { margin: 0; padding: 8px 6px; font-size: 12px; white-space: normal; line-height: 1.25; }\n  .gn-btn.primary { background: var(--gn-accent); color: #fff; border-color: var(--gn-accent); }\n  .gn-btn.danger { background: transparent; border-color: var(--gn-danger); color: var(--gn-danger); }\n  /* !important: the host plugin dialog applies its own teal styling to\n     button elements inside plugin content (same issue as the old tabs). */\n  .gn-btn.yellow { background: var(--gn-select) !important; border-color: var(--gn-select) !important; color: #1e1e1e !important; font-weight: 600; }\n  .gn-btn.pink { background: var(--gn-hull) !important; border-color: var(--gn-hull) !important; color: #1e1e1e !important; font-weight: 600; }\n  .gn-analysis-row {\n    font-size: 12px; font-family: Consolas, monospace; padding: 2px 0;\n    user-select: text !important; -webkit-user-select: text !important;\n  }\n  /* Click-to-copy chips: hover makes the affordance obvious, click copies. */\n  .gn-copy {\n    cursor: copy; padding: 1px 4px; border-radius: 4px;\n    border-bottom: 1px dashed rgba(255,255,255,0.35);\n    transition: background 0.12s, border-color 0.12s;\n  }\n  .gn-copy:hover { background: rgba(86,156,214,0.28); border-bottom-color: var(--gn-accent); }\n  .gn-copy.copied { background: rgba(53,196,143,0.4); border-bottom-color: #35c48f; }\n  .gn-btn:disabled { opacity: 0.4; cursor: not-allowed; }\n  .gn-panel-box {\n    border: 1px solid var(--gn-border); border-radius: 4px; padding: 8px; margin-bottom: 7px; background: var(--gn-panel);\n  }\n  .gn-mono { font-family: Consolas, monospace; font-size: 11px; white-space: pre-wrap; word-break: break-all; max-height: 120px; overflow-y: auto; }\n  .gn-note { font-size: 11px; opacity: 0.75; margin-top: 4px; }\n  .gn-warn { color: #dcbf3c; font-size: 11px; margin-top: 4px; }\n  .gn-error { color: var(--gn-danger); font-size: 12px; margin-top: 6px; }\n  .gn-legend { display: flex; gap: 14px; font-size: 11px; margin-top: 6px; opacity: 0.85; flex: 0 0 auto; }\n  .gn-legend span { display: inline-flex; align-items: center; gap: 4px; }\n  .gn-legend-item { cursor: pointer; user-select: none; -webkit-user-select: none; border-radius: 4px; padding: 1px 4px; }\n  .gn-legend-item:hover { background: rgba(255,255,255,0.08); }\n  .gn-legend-item.gn-layer-off { opacity: 0.32; text-decoration: line-through; }\n  .gn-progress { height: 6px; background: rgba(255,255,255,0.12); border-radius: 3px; overflow: hidden; }\n  .gn-progress-fill { height: 100%; width: 0%; background: var(--gn-hull); border-radius: 3px; transition: width 0.25s ease; }\n  /* Jog cluster styled after ncSender's own jog widget: dark gray rounded\n     buttons on black, red stop square, teal only on the ACTIVE step pill\n     and the \"Hold\" sublabels. Every colour is !important because the host\n     plugin dialog applies its own teal styling to button elements inside\n     plugin content (same bleed as .gn-btn.yellow/.pink). Layout: one\n     shared 4-column rhythm so pills, pad, Z column, and zero buttons all\n     share widths and margins. */\n  .gn-view-tab {\n    border: none !important; background: #262b36 !important; color: #aeb4bf !important;\n    border-radius: 8px 8px 0 0 !important; padding: 6px 14px !important; cursor: pointer;\n    font-size: 12px; box-shadow: none !important;\n  }\n  .gn-view-tab:hover { background: #2f3542 !important; }\n  .gn-view-tab.gn-tab-active { background: #2fc49b !important; color: #0d2a23 !important; font-weight: 700; }\n  .gn-jog-cluster { width: fit-content; margin: 0 auto; display: flex; flex-direction: column; gap: 5px; }\n  .gn-jog-row { display: grid; grid-template-columns: repeat(4, 1fr); gap: 5px; }\n  .gn-jog-btn {\n    height: 40px;\n    border: none !important; background: #262b36 !important; color: #dfe3ea !important;\n    border-radius: 10px !important; cursor: pointer; font-size: 13px; font-weight: 600;\n    padding: 0 !important; touch-action: none; user-select: none; -webkit-user-select: none;\n    box-shadow: none !important;\n  }\n  .gn-jog-btn:hover { background: #2f3542 !important; }\n  .gn-jog-btn:active, .gn-jog-btn.gn-jogging { background: #3a4252 !important; }\n  .gn-jog-stop { background: #d84b4b !important; color: #fff !important; font-size: 15px; }\n  .gn-jog-stop:hover { background: #e35c5c !important; }\n  .gn-step-pill {\n    height: 28px; border: none !important; background: #262b36 !important; color: #aeb4bf !important;\n    border-radius: 999px !important; cursor: pointer; font-size: 12px; padding: 0 !important;\n    touch-action: none; user-select: none; -webkit-user-select: none; box-shadow: none !important;\n  }\n  .gn-step-pill:hover { background: #2f3542 !important; }\n  .gn-step-pill.gn-step-active { background: #2fc49b !important; color: #0d2a23 !important; font-weight: 700; }\n  .gn-feed-select {\n    background: #262b36 !important; color: #dfe3ea !important; border: 1px solid #3a4252 !important;\n    border-radius: 8px !important; padding: 4px 6px; font-size: 12px;\n  }\n  .gn-zero-row .gn-hold-zero { grid-column: span 2; }\n  .gn-hold-zero {\n    border: none !important; background: #262b36 !important; color: #dfe3ea !important;\n    border-radius: 10px !important; cursor: pointer; padding: 5px 0 4px !important;\n    position: relative; overflow: hidden;\n    display: flex; flex-direction: column; align-items: center; gap: 1px;\n    touch-action: none; user-select: none; -webkit-user-select: none; box-shadow: none !important;\n  }\n  .gn-hold-zero:hover { background: #2f3542 !important; }\n  .gn-zero-label { font-size: 13px; font-weight: 700; position: relative; z-index: 1; }\n  .gn-zero-sub { font-size: 10px; color: #2fc49b; font-weight: 600; position: relative; z-index: 1; }\n  .gn-hold-zero::before {\n    content: ''; position: absolute; inset: 0; background: rgba(47,196,155,0.35);\n    transform: scaleX(0); transform-origin: left; z-index: 0;\n  }\n  .gn-hold-zero.gn-holding::before { transform: scaleX(1); transition: transform 0.7s linear; }\n  .gn-hold-zero.gn-zeroed { background: #2fc49b !important; }\n  .gn-hold-zero.gn-zeroed .gn-zero-label, .gn-hold-zero.gn-zeroed .gn-zero-sub { color: #0d2a23; }\n  .gn-swatch { width: 10px; height: 10px; border-radius: 2px; display: inline-block; }\n  .gn-checkbox-row { display: flex; align-items: center; gap: 6px; margin-bottom: 6px; }\n  /* Custom context menu (native menus are suppressed app-wide by ncSender,\n     matching its own TransformContextMenu pattern) */\n  #gn-ctx-menu {\n    position: fixed; z-index: 99999; display: none; min-width: 190px;\n    background: var(--gn-panel); border: 1px solid var(--gn-border);\n    border-radius: 8px; padding: 4px; box-shadow: 0 10px 30px rgba(0,0,0,0.45);\n  }\n  #gn-ctx-menu .gn-ctx-item {\n    padding: 8px 12px; border-radius: 5px; cursor: pointer; font-size: 12.5px;\n    color: var(--gn-text); white-space: nowrap;\n  }\n  #gn-ctx-menu .gn-ctx-item:hover { background: rgba(86,156,214,0.18); }\n  /* Styled confirmation card, matching ncSender's own Trace Outline dialog\n     (dark rounded card, orange primary action) instead of window.confirm. */\n  #gn-confirm-overlay {\n    position: fixed; inset: 0; z-index: 100000; display: none;\n    background: rgba(0,0,0,0.45); align-items: center; justify-content: center;\n  }\n  #gn-confirm-card {\n    background: var(--gn-panel); border: 1px solid var(--gn-border);\n    border-radius: 14px; padding: 20px 22px; max-width: 440px; width: 90%;\n    box-shadow: 0 18px 60px rgba(0,0,0,0.55);\n  }\n  #gn-confirm-title { font-size: 16px; font-weight: 700; margin-bottom: 12px; }\n  #gn-confirm-body { font-size: 13px; line-height: 1.5; }\n  #gn-confirm-body .gn-note { margin-top: 10px; }\n  .gn-confirm-btns { display: flex; gap: 10px; justify-content: flex-end; margin-top: 18px; }\n  .gn-confirm-btns .gn-btn { width: auto; margin: 0; padding: 9px 22px; border-radius: 8px; }\n  .gn-btn.orange { background: #f0a030 !important; border-color: #f0a030 !important; color: #1e1e1e !important; font-weight: 700; }\n  #gn-ctx-menu .gn-ctx-coords {\n    padding: 6px 12px 4px; font-size: 11px; opacity: 0.6;\n    border-bottom: 1px solid var(--gn-border); margin-bottom: 3px;\n    font-family: Consolas, monospace;\n  }\n<\/style>\n\n<div id=\"gn-root\">\n  <div id=\"gn-header-strip\">\n    <span id=\"gn-status\" class=\"gn-note\" style=\"margin:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; flex:1 1 auto; min-width:0;\"><\/span>\n    <span id=\"gn-view-tabs\" style=\"display:none; align-items:center; gap:6px; flex:0 0 auto;\">\n      <span id=\"gn-rotary-badge\" style=\"font-size:12px; font-weight:700; color:#2fc49b;\" title=\"A-axis motion detected in this file &mdash; rendering as unwrapped X&ndash;A instead of flat XY\">&#8635; Rotary (A-axis)<\/span>\n      <span id=\"gn-rotary-dia-wrap\" style=\"display:inline-flex; align-items:center; gap:4px; margin-left:6px;\">\n        <span style=\"font-size:12px; opacity:0.85;\" title=\"Stock diameter: scales A degrees to true surface distance so the unwrapped view has real proportions. Leave 0 to plot raw degrees.\">&Oslash; stock (mm)<\/span>\n        <input type=\"number\" id=\"gn-rotary-dia\" min=\"0\" step=\"1\" value=\"0\" style=\"width:60px;\" />\n      <\/span>\n    <\/span>\n  <\/div>\n\n  <div class=\"gn-layout\">\n    <div class=\"gn-map-col\">\n      <div class=\"gn-map-wrap\">\n        <button class=\"gn-fit-btn\" id=\"gn-line-fit\">&#8689; Fit<\/button>\n        <div class=\"gn-zoom-hint\">scroll / pinch = zoom &middot; drag = pan &middot; drag marker = creep &middot; click = select &middot; hold-click / right-click = set point &middot; touch long-press = menu<\/div>\n        <svg id=\"gn-line-svg\"><\/svg>\n      <\/div>\n      <div class=\"gn-legend\" id=\"gn-legend\">\n        <span class=\"gn-legend-item\" data-layer=\"rapid\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:var(--gn-rapid)\"><\/i>Rapid (G0)<\/span>\n        <span class=\"gn-legend-item\" data-layer=\"feed\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:var(--gn-feed)\"><\/i>Feed (G1/2/3)<\/span>\n        <span class=\"gn-legend-item\" data-layer=\"selline\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:var(--gn-accent)\"><\/i>Selected line<\/span>\n        <span class=\"gn-legend-item\" data-layer=\"contour\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:var(--gn-hull)\"><\/i>Outer contour<\/span>\n        <span class=\"gn-legend-item\" data-layer=\"jobstart\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:var(--gn-jobstart)\"><\/i>Job start<\/span>\n        <span class=\"gn-legend-item\" data-layer=\"jobend\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:var(--gn-danger)\"><\/i>Job end<\/span>\n        <span class=\"gn-legend-item\" data-layer=\"selpoint\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:var(--gn-select)\"><\/i>Selected point<\/span>\n        <span class=\"gn-legend-item\" data-layer=\"spindle\" title=\"Click to hide/show this layer\"><i class=\"gn-swatch\" style=\"background:rgba(255,255,255,0.75)\"><\/i>Spindle<\/span>\n        <span style=\"flex:1\"><\/span><span id=\"gn-zfilter-wrap\" style=\"display:none; align-items:center; gap:6px;\" title=\"Hide moves that stay above this Z. Filters the display only (some CAM never emits rapids but still lifts Z between cuts) - the traced contour is unaffected.\"><span style=\"white-space:nowrap;\">Z &#8804; <b id=\"gn-zfilter-val\">off<\/b><\/span><input type=\"range\" id=\"gn-zfilter\" style=\"width:130px;\" /><\/span>\n        <span class=\"gn-legend-item\" data-layer=\"moves\" id=\"gn-moves-item\" style=\"display:none;\" title=\"Hairline overlay of every move on top of the power shading, so lines stay visible and clickable\"><i class=\"gn-swatch\" style=\"background:#c8d2dc\"><\/i>Moves<\/span>\n        <span id=\"gn-power-note\" style=\"display:none; font-size:11px; opacity:0.75; margin-left:4px;\" title=\"Feed lines are shaded by commanded S: faint/invisible = laser off or low power, solid = full power\">&#9673;&nbsp;shaded by power (S)<\/span>\n        <span id=\"gn-depth-note\" style=\"display:none; font-size:11px; opacity:0.75; margin-left:4px;\" title=\"Feed lines are tinted by Z depth: lighter = shallower pass, darker = deeper pass\">&#9673;&nbsp;tinted by depth (Z)<\/span>\n      <\/div>\n    <\/div>\n    <div class=\"gn-controls-col\">\n      <div class=\"gn-controls-scroll\">\n      <div class=\"gn-panel-box\">\n        <div class=\"gn-field\">\n          <label style=\"display:flex;align-items:center;justify-content:space-between;\"><span>Line to check (selects it on the map)<\/span><a href=\"#\" style=\"color:var(--gn-accent);font-size:11px;text-decoration:none;\" title=\"Explain this line word by word in the G-code tab\" onclick=\"window.grefExplainLineNum&amp;&amp;window.grefExplainLineNum(document.getElementById(&quot;gn-line-input&quot;).value);return false;\">G-code &#8599;<\/a><\/label>\n          <input type=\"number\" id=\"gn-line-input\" min=\"1\" value=\"1\" />\n        <\/div>\n        <div id=\"gn-analysis-box\" style=\"display:none; margin-top:8px;\">\n          <div class=\"gn-note\" style=\"margin-bottom:4px;\">LINE ANALYSIS:<\/div>\n          <div class=\"gn-analysis-row\" id=\"gn-an-gcode\"><\/div>\n          <div class=\"gn-analysis-row\" id=\"gn-an-start\"><\/div>\n          <div class=\"gn-analysis-row\" id=\"gn-an-point\"><\/div>\n          <div class=\"gn-analysis-row\" id=\"gn-an-end\"><\/div>\n        <\/div>\n        <div class=\"gn-actions-grid\" style=\"margin:8px 0 0;\">\n        <button class=\"gn-btn\" id=\"gn-sfl-btn\" style=\"background:#7a5a1e; border-color:#8a6a2e;\" title=\"Start the loaded job from the selected line using ncSender's resume engine: safe-Z retract, tool check, XY pre-position, spindle spin-up, approach + controlled plunge. You review the sequence before anything moves.\">Start From Line&hellip;<\/button>\n        <button class=\"gn-btn\" id=\"gn-retract-btn\" title=\"Raises Z to the safe height (app setting or custom below). Also applied before Trace Contour Outline and Rapid to Point when the checkbox is on.\">Retract to Safe Z<\/button>\n        <\/div>\n        <div class=\"gn-checkbox-row\" style=\"margin-top:8px;\">\n          <input type=\"checkbox\" id=\"gn-raisez\" checked />\n          <label for=\"gn-raisez\" style=\"margin:0;\" title=\"Applies to both Trace Contour Outline and Rapid to Point, including map-menu rapids.\">Raise Z to safe height first<\/label>\n        <\/div>\n        <div class=\"gn-checkbox-row\" style=\"margin-bottom:0;\">\n          <input type=\"checkbox\" id=\"gn-preset-z-toggle\" />\n          <label for=\"gn-preset-z-toggle\" style=\"margin:0;\" title=\"Used instead of the app's Safe Z Retract Height setting everywhere in this panel.\">Custom safe height (mm, machine coords)<\/label>\n        <\/div>\n        <div class=\"gn-field\" id=\"gn-preset-z-field\" style=\"display:none; margin:6px 0 0;\">\n          <input type=\"number\" id=\"gn-preset-z-input\" step=\"0.5\" value=\"10\" />\n        <\/div>\n                <div id=\"gn-sfl-panel\" style=\"display:none; margin-top:8px; border-top:1px solid var(--gn-border); padding-top:8px;\">\n          <div class=\"gn-note\" id=\"gn-sfl-title\" style=\"margin-bottom:4px;\">RESUME FROM LINE<\/div>\n          <div id=\"gn-sfl-warnings\" style=\"font-size:11.5px; color:#e9c46a; margin-bottom:6px;\"><\/div>\n          <div id=\"gn-sfl-toolwarn\" style=\"display:none; font-size:11.5px; color:#e9a1a1; margin-bottom:6px;\"><\/div>\n          <div class=\"gn-note\" style=\"margin:0 0 2px;\">Resume sequence the machine will run:<\/div>\n          <pre id=\"gn-sfl-seq\" style=\"font-size:10.5px; line-height:1.35; background:#16181d; border:1px solid var(--gn-border); border-radius:4px; padding:6px; max-height:130px; overflow-y:auto; margin:0 0 8px; white-space:pre-wrap;\"><\/pre>\n          <div style=\"display:flex; gap:6px; margin-bottom:8px; align-items:flex-end;\">\n            <div class=\"gn-field\" style=\"flex:1; margin:0;\" title=\"Dwell after spindle start before moving (seconds)\">\n              <label>Spindle delay (s)<\/label>\n              <input type=\"number\" id=\"gn-sfl-delay\" min=\"0\" step=\"0.5\" value=\"2\" />\n            <\/div>\n            <div class=\"gn-field\" style=\"flex:1; margin:0;\" title=\"Rapid to this height above the target Z, then plunge at the controlled feed\">\n              <label>Approach (mm)<\/label>\n              <input type=\"number\" id=\"gn-sfl-approach\" min=\"0\" step=\"1\" value=\"5\" />\n            <\/div>\n            <div class=\"gn-field\" style=\"flex:1; margin:0;\" title=\"Feed rate for the final plunge to depth (mm/min)\">\n              <label>Plunge F<\/label>\n              <input type=\"number\" id=\"gn-sfl-plunge\" min=\"10\" step=\"50\" value=\"500\" />\n            <\/div>\n          <\/div>\n          <div style=\"display:flex; gap:6px;\">\n            <button class=\"gn-btn\" id=\"gn-sfl-go\" style=\"flex:1; background:#1e6b3a; border-color:#2e7b4a; margin:0;\">Confirm &amp; Start<\/button>\n            <button class=\"gn-btn\" id=\"gn-sfl-cancel\" style=\"flex:1; margin:0;\">Cancel<\/button>\n          <\/div>\n          <div class=\"gn-error\" id=\"gn-sfl-error\"><\/div>\n        <\/div>\n      <\/div>\n\n            <div class=\"gn-panel-box\">\n        <div class=\"gn-field\">\n          <label>Creep along selected line (0% = start, 100% = end)<\/label>\n          <input type=\"range\" id=\"gn-creep-slider\" min=\"0\" max=\"100\" value=\"0\" style=\"width:100%;\" />\n        <\/div>\n        <div class=\"gn-actions-grid\" style=\"margin:0;\">\n        <button class=\"gn-btn yellow\" id=\"gn-rapid-point-btn\" title=\"Moves to the yellow marker: the creep position, a contour vertex, or a snapped point from the map menu. Use it to eyeball clearance over your stock before starting a job.\">Rapid to Point<\/button>\n        <button class=\"gn-btn pink\" id=\"gn-trace-contour-btn\" title=\"Runs the spindle around the purple outline with rapids and returns to the first vertex — like ncSender's built-in Trace Outline, but following the true silhouette instead of a bounding box.\">Trace Contour Outline&hellip;<\/button>\n        <\/div>\n        <div class=\"gn-error\" id=\"gn-line-error\"><\/div>\n\n      <div id=\"gn-contour-box\" style=\"margin-top:6px;\">\n        <div id=\"gn-contour-pending\" style=\"display:none; margin:6px 0;\">\n          <div class=\"gn-note\" style=\"margin-bottom:4px;\">Contour skipped on this large file to keep loading fast.<\/div>\n          <button class=\"gn-btn\" id=\"gn-contour-compute-btn\" style=\"background:#3a3d41;\">Compute Contour Outline<\/button>\n        <\/div>\n        <div id=\"gn-contour-working\" style=\"display:none; margin:6px 0;\">\n          <div class=\"gn-progress\"><div class=\"gn-progress-fill\" id=\"gn-contour-bar\"><\/div><\/div>\n          <div style=\"display:flex; justify-content:space-between; align-items:center; margin-top:4px;\">\n            <span class=\"gn-note\" id=\"gn-contour-stage\" style=\"margin:0;\">Working&hellip;<\/span>\n            <button id=\"gn-contour-cancel-btn\" style=\"background:none; border:1px solid #666; color:inherit; border-radius:4px; padding:2px 10px; cursor:pointer; font-size:11px;\">Cancel<\/button>\n          <\/div>\n        <\/div>\n        <div class=\"gn-field\" style=\"margin-bottom:2px;\">\n          <label title=\"Bounding box, convex hull, merged single shape, or shrink-wrapped to every part — with gradients between.\">Outline style: box &#8594; convex &#8594; merged &#8594; shrink-wrapped<\/label>\n          <input type=\"range\" id=\"gn-tightness\" min=\"0\" max=\"12\" value=\"12\" step=\"1\" list=\"gn-tightness-ticks\" style=\"width:100%;\" />\n          <datalist id=\"gn-tightness-ticks\">\n            <option value=\"0\"><\/option><option value=\"4\"><\/option><option value=\"8\"><\/option><option value=\"12\"><\/option>\n          <\/datalist>\n        <\/div>\n        <div class=\"gn-checkbox-row\" style=\"margin-bottom:0;\">\n          <input type=\"checkbox\" id=\"gn-include-rapids\" />\n          <label for=\"gn-include-rapids\" style=\"margin:0;\">Include rapid (G0) moves in contour<\/label>\n        <\/div>\n        <div class=\"gn-error\" id=\"gn-trace-error\"><\/div>\n      <\/div>\n\n      <\/div>\n      <div class=\"gn-panel-box\" id=\"gn-jog-box\">\n        <div style=\"display:flex; justify-content:space-between; align-items:center; margin-bottom:6px;\">\n          <span class=\"gn-note\" style=\"margin:0;\">JOG &amp; ZERO<\/span>\n          <span style=\"display:flex; align-items:center; gap:5px;\">\n            <span style=\"font-size:12px; opacity:0.85;\">Feed<\/span>\n            <select id=\"gn-jog-feed\" class=\"gn-feed-select\" title=\"XY jog feed (mm/min); Z is capped at 1200\">\n              <option value=\"500\">500<\/option>\n              <option value=\"1000\">1000<\/option>\n              <option value=\"2000\" selected>2000<\/option>\n              <option value=\"4000\">4000<\/option>\n            <\/select>\n          <\/span>\n        <\/div>\n        <div class=\"gn-jog-cluster\">\n          <div class=\"gn-note\" style=\"margin:0 0 2px; grid-column: 1 / -1;\">Step (mm) &middot; tap = step &middot; hold = continuous<\/div>\n          <div class=\"gn-jog-row\" id=\"gn-jog-steps\" title=\"Jog step in mm (tap = one step, hold = continuous)\">\n            <button class=\"gn-step-pill\" data-step=\"0.1\">0.1<\/button>\n            <button class=\"gn-step-pill gn-step-active\" data-step=\"1\">1<\/button>\n            <button class=\"gn-step-pill\" data-step=\"10\">10<\/button>\n            <span><\/span>\n          <\/div>\n          <div class=\"gn-jog-row\">\n            <button class=\"gn-jog-btn\" data-jog=\"-1,1\">&#8598;<\/button>\n            <button class=\"gn-jog-btn\" data-jog=\"0,1\">Y+<\/button>\n            <button class=\"gn-jog-btn\" data-jog=\"1,1\">&#8599;<\/button>\n            <button class=\"gn-jog-btn gn-jog-z\" data-jogz=\"1\">Z+<\/button>\n          <\/div>\n          <div class=\"gn-jog-row\">\n            <button class=\"gn-jog-btn\" data-jog=\"-1,0\">X&minus;<\/button>\n            <button class=\"gn-jog-btn gn-jog-stop\" id=\"gn-jog-cancel\" title=\"Jog cancel (0x85)\">&#9632;<\/button>\n            <button class=\"gn-jog-btn\" data-jog=\"1,0\">X+<\/button>\n            <button class=\"gn-jog-btn gn-jog-z\" data-jogz=\"-1\">Z&minus;<\/button>\n          <\/div>\n          <div class=\"gn-jog-row\">\n            <button class=\"gn-jog-btn\" data-jog=\"-1,-1\">&#8601;<\/button>\n            <button class=\"gn-jog-btn\" data-jog=\"0,-1\">Y&minus;<\/button>\n            <button class=\"gn-jog-btn\" data-jog=\"1,-1\">&#8600;<\/button>\n            <span><\/span>\n          <\/div>\n          <div class=\"gn-jog-row gn-zero-row\">\n            <button class=\"gn-hold-zero\" data-zero=\"X0 Y0\"><span class=\"gn-zero-label\">XY0<\/span><span class=\"gn-zero-sub\">Hold<\/span><\/button>\n            <button class=\"gn-hold-zero\" data-zero=\"Z0\"><span class=\"gn-zero-label\">Z0<\/span><span class=\"gn-zero-sub\">Hold<\/span><\/button>\n          <\/div>\n        <\/div>\n        <div class=\"gn-note\" id=\"gn-jog-msg\" style=\"margin:4px 0 0; color:#e9a1a1; display:none;\"><\/div>\n      <\/div>\n    <\/div>\n  <\/div>\n<\/div>\n\n<div id=\"gn-ctx-menu\"><\/div>\n\n<div id=\"gn-confirm-overlay\">\n  <div id=\"gn-confirm-card\">\n    <div id=\"gn-confirm-title\"><\/div>\n    <div id=\"gn-confirm-body\"><\/div>\n    <div class=\"gn-confirm-btns\">\n      <button class=\"gn-btn\" id=\"gn-confirm-abort\">Abort<\/button>\n      <button class=\"gn-btn orange\" id=\"gn-confirm-ok\">Confirm<\/button>\n    <\/div>\n  <\/div>\n<\/div>\n\n";
    var NAV_SCRIPT = "\n(function () {\n  'use strict';\n\n  // ============================================================\n  // Host API bridge — same convention as ncSender's own plugin\n  // config UIs: window.ncSender.getApiBaseUrl() is injected by\n  // the dialog host.\n  // ============================================================\n  var FALLBACK_PORT = 8090;\n  var resolveApiBaseUrl = function () {\n    if (window.ncSender && typeof window.ncSender.getApiBaseUrl === 'function') {\n      return window.ncSender.getApiBaseUrl(FALLBACK_PORT);\n    }\n    return '';\n  };\n  var BASE_URL = resolveApiBaseUrl();\n\n  function api(path, options) {\n    return fetch(BASE_URL + path, options).then(function (res) {\n      return res.json().catch(function () { return {}; }).then(function (body) {\n        if (!res.ok) {\n          var err = new Error((body && (body.error || body.message)) || ('Request failed: ' + path));\n          err.body = body;\n          throw err;\n        }\n        return body;\n      });\n    });\n  }\n\n  function getSettings() { return api('/api/settings'); }\n  function getCurrentGcodeText() {\n    return fetch(BASE_URL + '/api/gcode-files/current/download').then(function (res) {\n      if (!res.ok) throw new Error('No G-code file is currently loaded in ncSender.');\n      return res.text();\n    });\n  }\n  function sendCommand(command, displayCommand) {\n    return api('/api/send-command', {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ command: command, displayCommand: displayCommand || command })\n    });\n  }\n\n  function setStatus(msg, isError) {\n    var el = document.getElementById('gn-status');\n    el.textContent = msg || '';\n    el.style.color = isError ? 'var(--gn-danger)' : '';\n  }\n\n  // ============================================================\n  // G-code parsing (unchanged from v0.1)\n  // ============================================================\n  function stripComments(line) {\n    var result = line;\n    while (true) {\n      var start = result.indexOf('(');\n      if (start < 0) break;\n      var end = result.indexOf(')', start);\n      if (end < 0) break;\n      result = result.slice(0, start) + result.slice(end + 1);\n    }\n    var semi = result.indexOf(';');\n    if (semi >= 0) result = result.slice(0, semi);\n    return result.trim();\n  }\n\n  function parseWords(line) {\n    if (line.length > 1 && /[Nn]/.test(line[0]) && /\\d/.test(line[1])) {\n      var spaceIdx = line.indexOf(' ');\n      if (spaceIdx > 0) line = line.slice(spaceIdx + 1);\n    }\n    var words = [];\n    var i = 0;\n    while (i < line.length) {\n      var c = line[i];\n      if (/\\s/.test(c)) { i++; continue; }\n      if (!/[A-Za-z]/.test(c)) { i++; continue; }\n      var letter = c.toUpperCase();\n      i++;\n      var start = i;\n      while (i < line.length && /[0-9.\\-+]/.test(line[i])) i++;\n      var numStr = line.slice(start, i);\n      var value = parseFloat(numStr);\n      if (start < i && !isNaN(value)) {\n        words.push({ letter: letter, value: value });\n      }\n    }\n    return words;\n  }\n\n  function tessellateArc(x0, y0, x1, y1, i, j, clockwise, steps) {\n    var cx = x0 + i, cy = y0 + j;\n    var r = Math.hypot(i, j);\n    var a0 = Math.atan2(y0 - cy, x0 - cx);\n    var a1 = Math.atan2(y1 - cy, x1 - cx);\n    var span;\n    if (clockwise) {\n      span = a0 - a1;\n      if (span <= 0) span += 2 * Math.PI;\n      span = -span;\n    } else {\n      span = a1 - a0;\n      if (span <= 0) span += 2 * Math.PI;\n    }\n    var n = Math.max(6, steps || Math.ceil(Math.abs(span) / (Math.PI / 24)));\n    var pts = [];\n    for (var k = 1; k <= n; k++) {\n      var t = a0 + (span * k) / n;\n      pts.push({ x: cx + r * Math.cos(t), y: cy + r * Math.sin(t) });\n    }\n    return pts;\n  }\n\n  // Parser core: split into init / processRange / finish so huge files can\n  // be parsed in chunks off the event loop (parseGcodeAsync) while small\n  // files and the test harness keep the synchronous parseGcode.\n  function createGcodeParser(text) {\n    var lines = text.split('\\n');\n    var state = { x: 0, y: 0, z: 0, a: 0, s: 0, motion: null, positioning: 'G90', unitsMode: null, tool: null };\n    var sawRotary = false;\n    var segments = [];\n    var tools = [];\n    // S (spindle/laser power) and Z (pass depth) tracking, used to shade\n    // feed segments so laser-power-modulated raster jobs render as the\n    // actual burned image instead of a solid block, and multi-pass carves\n    // show which lines belong to which depth.\n    var maxS = 0;\n    var zLevelSet = {};\n    var minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;\n\n    function extend(x, y) {\n      if (x < minX) minX = x; if (x > maxX) maxX = x;\n      if (y < minY) minY = y; if (y > maxY) maxY = y;\n    }\n\n    function processRange(fromIdx, toIdx) {\n    for (var idx = fromIdx; idx < toIdx; idx++) {\n      var lineNo = idx + 1;\n      var clean = stripComments(lines[idx].trim());\n      if (!clean) continue;\n      var words = parseWords(clean);\n      if (!words.length) continue;\n\n      var iVal = 0, jVal = 0, hasI = false, hasJ = false;\n      var xVal = null, yVal = null, zVal = null, aVal = null;\n\n      for (var w = 0; w < words.length; w++) {\n        var wd = words[w];\n        switch (wd.letter) {\n          case 'G':\n            if (wd.value === 0 || wd.value === 1 || wd.value === 2 || wd.value === 3) {\n              state.motion = 'G' + wd.value;\n            } else if (wd.value === 90 || wd.value === 91) {\n              state.positioning = 'G' + wd.value;\n            } else if (wd.value === 20 || wd.value === 21) {\n              state.unitsMode = 'G' + wd.value;\n            }\n            break;\n          case 'X': xVal = wd.value; break;\n          case 'Y': yVal = wd.value; break;\n          case 'Z': zVal = wd.value; break;\n          case 'A': aVal = wd.value; break;\n          case 'I': iVal = wd.value; hasI = true; break;\n          case 'J': jVal = wd.value; hasJ = true; break;\n          case 'S':\n            state.s = wd.value;\n            if (state.s > maxS) maxS = state.s;\n            break;\n          case 'M':\n            // M5 = spindle/laser stop. Many laser posts leave the last S\n            // word in place and rely on M5 alone to mean \"off\" — without\n            // this the segments after a mid-file M5 would keep shading at\n            // the old power level.\n            if (wd.value === 5) state.s = 0;\n            break;\n          case 'T':\n            state.tool = wd.value;\n            if (tools.indexOf(wd.value) < 0) tools.push(wd.value);\n            break;\n        }\n      }\n\n      var hasMotionWord = xVal !== null || yVal !== null || zVal !== null || aVal !== null || hasI || hasJ;\n      if (!hasMotionWord || !state.motion) continue;\n\n      var x0 = state.x, y0 = state.y, z0 = state.z, a0 = state.a;\n      var x1 = x0, y1 = y0, z1 = z0, a1 = a0;\n      if (state.positioning === 'G90') {\n        if (xVal !== null) x1 = xVal;\n        if (yVal !== null) y1 = yVal;\n        if (zVal !== null) z1 = zVal;\n        if (aVal !== null) a1 = aVal;\n      } else {\n        if (xVal !== null) x1 = x0 + xVal;\n        if (yVal !== null) y1 = y0 + yVal;\n        if (zVal !== null) z1 = z0 + zVal;\n        if (aVal !== null) a1 = a0 + aVal;\n      }\n      if (a1 !== a0) sawRotary = true;\n\n      var seg = { line: lineNo, type: state.motion, tool: state.tool, x0: x0, y0: y0, z0: z0, x1: x1, y1: y1, z1: z1, a0: a0, a1: a1, s: state.s, points: null };\n      if (state.motion === 'G2' || state.motion === 'G3') {\n        seg.points = tessellateArc(x0, y0, x1, y1, iVal, jVal, state.motion === 'G2');\n      }\n      if (state.motion !== 'G0') zLevelSet[z1.toFixed(3)] = true;\n\n      segments.push(seg);\n      extend(x0, y0); extend(x1, y1);\n      if (seg.points) seg.points.forEach(function (p) { extend(p.x, p.y); });\n\n      state.x = x1; state.y = y1; state.z = z1; state.a = a1;\n    }\n    }\n\n    function finish() {\n      if (!isFinite(minX)) { minX = minY = 0; maxX = maxY = 1; }\n      var zLevels = Object.keys(zLevelSet).map(Number).sort(function (a, b) { return a - b; });\n      return {\n        segments: segments, hasRotary: sawRotary, totalLines: lines.length, tools: tools,\n        bounds: { minX: minX, minY: minY, maxX: maxX, maxY: maxY }, units: state.unitsMode,\n        maxS: maxS, zLevels: zLevels\n      };\n    }\n\n    return { lineCount: lines.length, processRange: processRange, finish: finish };\n  }\n\n  function parseGcode(text) {\n    var p = createGcodeParser(text);\n    p.processRange(0, p.lineCount);\n    return p.finish();\n  }\n\n  // Chunked parse: yields to the event loop every CHUNK lines so the\n  // dialog stays responsive and can show progress on multi-hundred-\n  // thousand-line files instead of freezing.\n  function parseGcodeAsync(text, onProgress) {\n    return new Promise(function (resolve) {\n      var p = createGcodeParser(text);\n      var CHUNK = 80000;\n      var idx = 0;\n      function step() {\n        var end = Math.min(idx + CHUNK, p.lineCount);\n        p.processRange(idx, end);\n        idx = end;\n        if (onProgress) onProgress(idx, p.lineCount);\n        if (idx < p.lineCount) setTimeout(step, 0);\n        else resolve(p.finish());\n      }\n      step();\n    });\n  }\n\n  function findSegmentForLine(parsed, lineNumber) {\n    var best = null;\n    for (var i = 0; i < parsed.segments.length; i++) {\n      var s = parsed.segments[i];\n      if (s.line === lineNumber) return s;\n      if (s.line < lineNumber) best = s;\n      if (s.line > lineNumber) break;\n    }\n    return best;\n  }\n\n  // Distance from point to a line segment (world units) — used for hit\n  // testing so a click lands on the *nearest drawn path*, not just the\n  // nearest endpoint like v0.1 did.\n  function pointSegDist(px, py, ax, ay, bx, by) {\n    var dx = bx - ax, dy = by - ay;\n    var len2 = dx * dx + dy * dy;\n    if (len2 === 0) return Math.hypot(px - ax, py - ay);\n    var t = ((px - ax) * dx + (py - ay) * dy) / len2;\n    t = Math.max(0, Math.min(1, t));\n    return Math.hypot(px - (ax + t * dx), py - (ay + t * dy));\n  }\n\n  // Tiered snap for context-menu targeting: prefer a true vertex when the\n  // point is within vTol of one, else the perpendicular projection onto the\n  // nearest edge when within eTol, else the raw free-space point. Returns\n  // {x, y, kind: 'vertex'|'edge'|'free', vIndex, polyIndex}.\n  function snapToPolylines(world, polylines, vTol, eTol) {\n    var bestV = null, bestVD = Infinity, bestVI = -1, bestVP = -1;\n    var bestE = null, bestED = Infinity;\n    for (var pi = 0; pi < polylines.length; pi++) {\n      var poly = polylines[pi];\n      for (var vi = 0; vi < poly.length; vi++) {\n        var dv = Math.hypot(poly[vi].x - world.x, poly[vi].y - world.y);\n        if (dv < bestVD) { bestVD = dv; bestV = poly[vi]; bestVI = vi; bestVP = pi; }\n        if (vi < poly.length - 1) {\n          var ax = poly[vi].x, ay = poly[vi].y, bx = poly[vi + 1].x, by = poly[vi + 1].y;\n          var dx = bx - ax, dy = by - ay;\n          var len2 = dx * dx + dy * dy;\n          var t = len2 === 0 ? 0 : ((world.x - ax) * dx + (world.y - ay) * dy) / len2;\n          t = Math.max(0, Math.min(1, t));\n          var qx = ax + t * dx, qy = ay + t * dy;\n          var de = Math.hypot(world.x - qx, world.y - qy);\n          if (de < bestED) { bestED = de; bestE = { x: qx, y: qy }; }\n        }\n      }\n    }\n    if (bestV && bestVD <= vTol) {\n      return { x: bestV.x, y: bestV.y, kind: 'vertex', vIndex: bestVI, polyIndex: bestVP };\n    }\n    if (bestE && bestED <= eTol) {\n      return { x: bestE.x, y: bestE.y, kind: 'edge', vIndex: -1, polyIndex: -1 };\n    }\n    return { x: world.x, y: world.y, kind: 'free', vIndex: -1, polyIndex: -1 };\n  }\n\n  function findNearestSegment(parsed, x, y, segFilter) {\n    var best = null, bestDist = Infinity;\n    parsed.segments.forEach(function (s) {\n      if (segFilter && !segFilter(s)) return;\n      var pts = s.points ? [{ x: s.x0, y: s.y0 }].concat(s.points) : [{ x: s.x0, y: s.y0 }, { x: s.x1, y: s.y1 }];\n      for (var i = 0; i < pts.length - 1; i++) {\n        var d = pointSegDist(x, y, pts[i].x, pts[i].y, pts[i + 1].x, pts[i + 1].y);\n        if (d < bestDist) { bestDist = d; best = s; }\n      }\n    });\n    return { segment: best, dist: bestDist };\n  }\n\n  // ============================================================\n  // Concave hull\n  //\n  // v0.5 fix: the hull previously ran on segment ENDPOINTS only. Long\n  // straight outer edges contribute just two points, far apart, while\n  // interior passes (pocket spirals etc.) are dense — so the k-nearest\n  // neighbours of an outer corner were interior points and the hull cut\n  // across concave features regardless of the concavity setting. The fix\n  // is to densify: resample every segment at a regular step so boundary\n  // edges are as dense as everything else, run the hull, then simplify\n  // the result back down to true corners (collinear-point removal) so the\n  // vertex list stays short and meaningful.\n  // ============================================================\n  function densifySegments(segments, includeRapids, bounds, units) {\n    var bw = Math.max(bounds.maxX - bounds.minX, 0.001);\n    var bh = Math.max(bounds.maxY - bounds.minY, 0.001);\n    var step = Math.max(bw, bh) / 1000;\n    var pts = [];\n    var polys = []; // exact polylines (segment endpoints + arc tessellation) for snapping\n    function addLine(x0, y0, x1, y1) {\n      var len = Math.hypot(x1 - x0, y1 - y0);\n      var n = Math.max(1, Math.ceil(len / step));\n      for (var i = 0; i <= n; i++) {\n        pts.push({ x: x0 + (x1 - x0) * i / n, y: y0 + (y1 - y0) * i / n });\n      }\n    }\n    segments.forEach(function (s) {\n      if (s.type === 'G0' && !includeRapids) return;\n      var poly = s.points\n        ? [{ x: s.x0, y: s.y0 }].concat(s.points)\n        : [{ x: s.x0, y: s.y0 }, { x: s.x1, y: s.y1 }];\n      polys.push(poly);\n      for (var i = 0; i < poly.length - 1; i++) {\n        addLine(poly[i].x, poly[i].y, poly[i + 1].x, poly[i + 1].y);\n      }\n    });\n    // Cap the point LIST only (it is used just for the convex-hull\n    // fallback); the occupancy grid is rasterized from the exact polylines\n    // in traceOuterContour, so the cap no longer coarsens the grid step.\n    // (Previously step *= stride here silently degraded the grid to a few\n    // hundred cells on long engraving files — the real cause of the\n    // corner-cutting the resolution bumps never fixed.)\n    var MAX_POINTS = 40000;\n    if (pts.length > MAX_POINTS) {\n      var stride = Math.ceil(pts.length / MAX_POINTS);\n      pts = pts.filter(function (_, i) { return i % stride === 0; });\n    }\n    return { points: pts, step: step, polys: polys, mmScale: units === 'G20' ? 25.4 : 1 };\n  }\n\n  // Remove hull vertices that are (nearly) collinear with their neighbours,\n  // so densified boundary runs collapse back to their true corner points.\n  // Linear-time collinear reduction for huge raster contours (a comb-like\n  // boundary can be hundreds of thousands of cells; the iterative\n  // splice-removal simplifier is O(n^2) on that). A few one-directional\n  // passes cut it to a few thousand vertices before the precise simplifier\n  // runs.\n  // Lossless direction-run compression for raster boundaries: keep a point\n  // only where the step direction changes, so straight runs collapse to\n  // their endpoints EXACTLY. (The previous epsilon-based reducer compared\n  // each point against the chord from the last KEPT point to the next RAW\n  // point; on smooth arcs that chord always hugs the curve, so the anchor\n  // receded point by point and whole arcs were silently eaten — rectangles\n  // and combs masked it because corners always survive.)\n  function fastCollinearReduce(pts) {\n    var n = pts.length;\n    if (n <= 3) return pts;\n    var out = [];\n    for (var i = 0; i < n; i++) {\n      var a = pts[(i - 1 + n) % n], b = pts[i], c = pts[(i + 1) % n];\n      var d1x = Math.sign(b.x - a.x), d1y = Math.sign(b.y - a.y);\n      var d2x = Math.sign(c.x - b.x), d2y = Math.sign(c.y - b.y);\n      if (d1x !== d2x || d1y !== d2y) out.push(b);\n    }\n    return out.length >= 3 ? out : pts;\n  }\n\n  function simplifyHull(hullPts, eps) {\n    if (!hullPts || hullPts.length <= 3) return hullPts;\n    var out = hullPts.slice();\n    var changed = true;\n    while (changed && out.length > 3) {\n      changed = false;\n      for (var i = 0; i < out.length; i++) {\n        var prev = out[(i - 1 + out.length) % out.length];\n        var cur = out[i];\n        var next = out[(i + 1) % out.length];\n        if (pointSegDist(cur.x, cur.y, prev.x, prev.y, next.x, next.y) < eps) {\n          out.splice(i, 1);\n          changed = true;\n          i--;\n        }\n      }\n    }\n    return out;\n  }\n\n  function pointInPolygon(pt, poly) {\n    var inside = false;\n    for (var i = 0, j = poly.length - 1; i < poly.length; j = i++) {\n      var xi = poly[i].x, yi = poly[i].y, xj = poly[j].x, yj = poly[j].y;\n      var intersect = ((yi > pt.y) !== (yj > pt.y)) &&\n        (pt.x < (xj - xi) * (pt.y - yi) / (yj - yi) + xi);\n      if (intersect) inside = !inside;\n    }\n    return inside;\n  }\n\n  // The bridging dial was removed from the UI (v0.7): tracing at the\n  // tightest setting is always correct for connected geometry, and the only\n  // real use for bridging was disconnected geometry (multiple parts on a\n  // sheet), where the tracer would otherwise outline only the region\n  // containing the lowest point. That is now handled automatically: trace\n  // tight, measure how many toolpath points the result actually encloses,\n  // and only escalate dilation if geometry turns out to be disconnected.\n  // If parts are too far apart to bridge sensibly, fall back to the convex\n  // hull, which is guaranteed to enclose everything.\n  function autoTraceContour(dens, closeRadius, onProgress) {\n    // Single pass: MST corridor bridging inside traceOuterContour connects\n    // all components at their closest points, so there is no escalation\n    // ladder any more. Coverage (traced component + enclosed cells) is kept\n    // as a sanity check with a convex-hull fallback.\n    var hullPts = traceOuterContour(dens, closeRadius, onProgress);\n    if (hullPts && hullPts.length >= 3 && hullPts.coverage >= 0.995) {\n      return { hull: hullPts, bridges: hullPts.bridgeCount, parts: hullPts.componentCount, fallback: false };\n    }\n    return { hull: convexHull(dens.points), bridges: 0, parts: hullPts ? hullPts.componentCount : 0, fallback: true };\n  }\n\n  function convexHull(points) {\n    var pts = points.slice().sort(function (a, b) { return a.x - b.x || a.y - b.y; });\n    function cross(o, a, b) { return (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x); }\n    var lower = [];\n    for (var i = 0; i < pts.length; i++) {\n      while (lower.length >= 2 && cross(lower[lower.length - 2], lower[lower.length - 1], pts[i]) <= 0) lower.pop();\n      lower.push(pts[i]);\n    }\n    var upper = [];\n    for (var j = pts.length - 1; j >= 0; j--) {\n      while (upper.length >= 2 && cross(upper[upper.length - 2], upper[upper.length - 1], pts[j]) <= 0) upper.pop();\n      upper.push(pts[j]);\n    }\n    lower.pop(); upper.pop();\n    return lower.concat(upper);\n  }\n\n  // ============================================================\n  // Outer contour via occupancy-grid boundary tracing (v0.5).\n  //\n  // v0.4 and earlier used a k-nearest-neighbours concave hull. That\n  // algorithm is designed for scattered point clouds; on densely sampled\n  // *boundary* points its \"sharpest right turn\" step prefers hairpin\n  // reversals along the same collinear edge (and a ccw-based intersection\n  // test cannot reject collinear overlaps), so it failed on real toolpaths\n  // and silently fell back to the convex hull — which is exactly the\n  // corner-bridging seen on the spiral pocket test file.\n  //\n  // The replacement is the standard image-outlining approach:\n  //   1. rasterize the densified toolpath points into an occupancy grid\n  //      (cell size == densify step, so consecutive samples always land in\n  //      the same or an 8-adjacent cell — the path is grid-connected);\n  //   2. optionally dilate by the \"bridging\" radius (the old concavity\n  //      slider, now with a physical meaning: how large a gap or notch\n  //      gets smoothed over);\n  //   3. trace the outer boundary with Moore neighbour tracing;\n  //   4. map boundary cells back to world coordinates, snap each vertex to\n  //      the nearest actual toolpath point, and collapse collinear runs.\n  // This cannot self-intersect, follows concave features by construction,\n  // and is O(grid) fast.\n  // ============================================================\n  function traceOuterContour(densified, closeRadius, onProgress) {\n    if (onProgress) onProgress('raster');\n    var pts = densified.points;\n    var step = densified.step;\n    if (!pts.length) return [];\n\n    // Fixed dilation of 1: Moore tracing on a 1-cell-wide curve can double\n    // back on itself and terminate early (classic thin-line failure of the\n    // simple stop criterion). One cell of dilation makes the region at\n    // least 3 cells wide so the outer boundary is well-defined, and vertex\n    // snapping (below) pulls the result back onto exact toolpath points, so\n    // no tightness is lost. Cross-part bridging is handled separately by\n    // the MST corridors below, not by dilation.\n    var dil = 1;\n\n    var minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;\n    (densified.polys || []).forEach(function (poly) {\n      poly.forEach(function (p) {\n        if (p.x < minX) minX = p.x; if (p.x > maxX) maxX = p.x;\n        if (p.y < minY) minY = p.y; if (p.y > maxY) maxY = p.y;\n      });\n    });\n    if (!isFinite(minX)) return [];\n\n    var margin = (dil + 2) * step;\n    minX -= margin; minY -= margin; maxX += margin; maxY += margin;\n    var W = Math.max(4, Math.ceil((maxX - minX) / step) + 1);\n    var H = Math.max(4, Math.ceil((maxY - minY) / step) + 1);\n    var occ = new Uint8Array(W * H);\n\n    // Rasterize directly from the exact segment polylines (NOT the capped\n    // point list): full grid resolution regardless of how long the file is.\n    function markCell(px, py) {\n      var cx = Math.floor((px - minX) / step);\n      var cy = Math.floor((py - minY) / step);\n      if (cx >= 0 && cy >= 0 && cx < W && cy < H) occ[cy * W + cx] = 1;\n    }\n    var polysR = densified.polys || [];\n    for (var pr = 0; pr < polysR.length; pr++) {\n      var poly = polysR[pr];\n      for (var sv = 0; sv < poly.length - 1; sv++) {\n        var ax = poly[sv].x, ay = poly[sv].y, bx = poly[sv + 1].x, by = poly[sv + 1].y;\n        var segLen = Math.hypot(bx - ax, by - ay);\n        var nSteps = Math.max(1, Math.ceil(segLen / (step * 0.5)));\n        for (var ss = 0; ss <= nSteps; ss++) {\n          markCell(ax + (bx - ax) * ss / nSteps, ay + (by - ay) * ss / nSteps);\n        }\n      }\n    }\n\n    // MST corridor bridging (v0.17). Uniform closing had to dilate until\n    // the LARGEST gap anywhere merged — on text-engraving sheets (thousands\n    // of disconnected strokes) that meant heavy dilation, which rounds and\n    // cuts corners regardless of grid resolution. Instead: label the\n    // connected components, run one multi-source Chebyshev BFS to find each\n    // pair's closest approach, take the minimum spanning tree, and carve a\n    // thin corridor between each MST pair at exactly their nearest points.\n    // Everywhere else the region is the true geometry dilated by just 1\n    // cell (Moore-trace thin-line safety) — the outline hugs the real shape\n    // within ~1 cell and cannot cut corners, and there is no escalation\n    // loop: one pass regardless of how many parts the sheet has.\n\n    // -- dilate by 1 FIRST (before labeling): heals the 1-cell gaps that\n    //    floating-point cell assignment can leave in the raw raster (e.g.\n    //    0.3/0.1 floors to 2 while 0.4/0.1 floors to 4), and provides the\n    //    Moore-trace thin-line safety. Labeling the raw raster instead\n    //    fragmented a single rectangle into hundreds of components. --\n    var grown = new Uint8Array(W * H);\n    for (var dyy = 0; dyy < H; dyy++) {\n      for (var dxx = 0; dxx < W; dxx++) {\n        if (!occ[dyy * W + dxx]) continue;\n        for (var oy = -1; oy <= 1; oy++) {\n          for (var ox = -1; ox <= 1; ox++) {\n            var zx = dxx + ox, zy = dyy + oy;\n            if (zx >= 0 && zy >= 0 && zx < W && zy < H) grown[zy * W + zx] = 1;\n          }\n        }\n      }\n    }\n    occ = grown;\n    if (onProgress) onProgress('bridge');\n\n    // -- label components (8-conn) and bridge them with thin MST corridors\n    //    at their nearest points (the fully-cinched baseline outline) --\n    function labelComponents() {\n      var labels = new Int32Array(W * H);\n      var ncomp = 0;\n      var fstack = [];\n      for (var si = 0; si < W * H; si++) {\n        if (!occ[si] || labels[si]) continue;\n        ncomp++;\n        labels[si] = ncomp;\n        fstack.push(si);\n        while (fstack.length) {\n          var fc = fstack.pop();\n          var fy = (fc / W) | 0, fx = fc % W;\n          for (var qy = -1; qy <= 1; qy++) {\n            for (var qx = -1; qx <= 1; qx++) {\n              var gx = fx + qx, gy = fy + qy;\n              if (gx < 0 || gy < 0 || gx >= W || gy >= H) continue;\n              var gi = gy * W + gx;\n              if (occ[gi] && !labels[gi]) { labels[gi] = ncomp; fstack.push(gi); }\n            }\n          }\n        }\n      }\n      return { labels: labels, ncomp: ncomp };\n    }\n\n    function bridgeComponents(lab, ncomp, carve) {\n      var INF = 1 << 29;\n      var dist = new Int32Array(W * H).fill(INF);\n      var near = new Int32Array(W * H);\n      var frontier = [];\n      for (var bi = 0; bi < W * H; bi++) {\n        if (lab[bi]) { dist[bi] = 0; near[bi] = lab[bi]; frontier.push(bi); }\n      }\n      var edgeBest = {};\n      while (frontier.length) {\n        var nextFrontier = [];\n        for (var qf = 0; qf < frontier.length; qf++) {\n          var cc = frontier[qf];\n          var cyq = (cc / W) | 0, cxq = cc % W;\n          for (var ey = -1; ey <= 1; ey++) {\n            for (var ex = -1; ex <= 1; ex++) {\n              if (!ex && !ey) continue;\n              var hx = cxq + ex, hy = cyq + ey;\n              if (hx < 0 || hy < 0 || hx >= W || hy >= H) continue;\n              var hi = hy * W + hx;\n              if (dist[hi] === INF) {\n                dist[hi] = dist[cc] + 1;\n                near[hi] = near[cc];\n                nextFrontier.push(hi);\n              } else if (near[hi] !== near[cc]) {\n                var a = Math.min(near[hi], near[cc]), b = Math.max(near[hi], near[cc]);\n                var key = a + ':' + b;\n                var gap = dist[hi] + dist[cc];\n                if (!edgeBest[key] || gap < edgeBest[key].gap) {\n                  edgeBest[key] = { gap: gap, c1: cc, c2: hi, a: a, b: b };\n                }\n              }\n            }\n          }\n        }\n        frontier = nextFrontier;\n      }\n      var edges = Object.keys(edgeBest).map(function (k) { return edgeBest[k]; });\n      edges.sort(function (u, v) { return u.gap - v.gap; });\n      var parent = new Int32Array(ncomp + 1);\n      for (var pi = 0; pi <= ncomp; pi++) parent[pi] = pi;\n      function find(x) { while (parent[x] !== x) { parent[x] = parent[parent[x]]; x = parent[x]; } return x; }\n      function mark(cell) {\n        var my = (cell / W) | 0, mx = cell % W;\n        for (var ky = -1; ky <= 1; ky++) {\n          for (var kx = -1; kx <= 1; kx++) {\n            var px3 = mx + kx, py3 = my + ky;\n            if (px3 >= 0 && py3 >= 0 && px3 < W && py3 < H) occ[py3 * W + px3] = 1;\n          }\n        }\n      }\n      function descend(cell) {\n        var cur = cell;\n        var guard = 0;\n        while (dist[cur] > 0 && guard++ < W * H) {\n          mark(cur);\n          var by3 = (cur / W) | 0, bx3 = cur % W;\n          var bestN = cur;\n          for (var wy = -1; wy <= 1; wy++) {\n            for (var wx = -1; wx <= 1; wx++) {\n              var vx = bx3 + wx, vy = by3 + wy;\n              if (vx < 0 || vy < 0 || vx >= W || vy >= H) continue;\n              var vi = vy * W + vx;\n              if (dist[vi] < dist[bestN]) bestN = vi;\n            }\n          }\n          if (bestN === cur) break;\n          cur = bestN;\n        }\n        mark(cur);\n      }\n      var used = 0, maxGap = 0;\n      for (var eix = 0; eix < edges.length; eix++) {\n        var ed = edges[eix];\n        var ra = find(ed.a), rb = find(ed.b);\n        if (ra === rb) continue;\n        parent[ra] = rb;\n        used++;\n        if (ed.gap > maxGap) maxGap = ed.gap;\n        if (carve) { descend(ed.c1); descend(ed.c2); }\n      }\n      return { bridges: used, maxGap: maxGap };\n    }\n\n    // ==== Four-state outline model (v0.25) ====\n    // Slider t in 0..12 with semantic anchors, spacing-independent because\n    // the merge radius derives from the MEASURED largest inter-part gap:\n    //   t = 12  shrink-wrapped: every shape hugged, thin traversal necks\n    //   t = 8   merged single shape: interstitial gaps filled (closing at\n    //           the radius that unifies all parts), still following bumps\n    //   t = 4   convex hull: one loop catching the extreme x/y features\n    //   t = 0   bounding box\n    //   8..12 interpolates merge radius; 4..8 interpolates pocket depth on\n    //   the merged shape; 0..4 morphs convex hull toward the box.\n    var t12 = (closeRadius === undefined || closeRadius === null) ? 12 : Math.max(0, Math.min(12, closeRadius));\n\n    var lab1 = labelComponents();\n    var ncomp = lab1.ncomp;\n    var bridgeCount = ncomp > 1 ? bridgeComponents(lab1.labels, ncomp, true).bridges : 0;\n    if (onProgress) onProgress('trace');\n\n        function at(x, y) { return x >= 0 && y >= 0 && x < W && y < H && occ[y * W + x] === 1; }\n\n    // Start cell: first occupied scanning rows from min Y up, then min X —\n    // guaranteed to be on the outer boundary, with its W neighbour empty.\n    var start = null;\n    for (var sy = 0; sy < H && !start; sy++) {\n      for (var sx = 0; sx < W; sx++) {\n        if (at(sx, sy)) { start = [sx, sy]; break; }\n      }\n    }\n    if (!start) return [];\n\n    // Coverage: an occupied cell counts as covered if it belongs to the\n    // traced component OR is enclosed by it (not exposed to the exterior).\n    // The enclosure part matters: pocket/spiral interior passes are\n    // separate components geometrically but sit inside the outline and\n    // need no bridging. Unlike point-in-polygon on the snapped hull, this\n    // grid test cannot be fooled by snapping-induced self-intersections.\n    var totalOcc = 0;\n    for (var ti = 0; ti < W * H; ti++) if (occ[ti]) totalOcc++;\n\n    // (a) cells connected to the traced start component (8-conn)\n    var visited = new Uint8Array(W * H);\n    var stack = [start[1] * W + start[0]];\n    visited[stack[0]] = 1;\n    while (stack.length) {\n      var cell = stack.pop();\n      var cy0 = (cell / W) | 0, cx0 = cell % W;\n      for (var ddy = -1; ddy <= 1; ddy++) {\n        for (var ddx = -1; ddx <= 1; ddx++) {\n          var nx0 = cx0 + ddx, ny0 = cy0 + ddy;\n          if (nx0 < 0 || ny0 < 0 || nx0 >= W || ny0 >= H) continue;\n          var ni = ny0 * W + nx0;\n          if (occ[ni] && !visited[ni]) { visited[ni] = 1; stack.push(ni); }\n        }\n      }\n    }\n\n    // (b) exterior empty space: flood the empty cells from the grid border\n    // (4-conn so it can't leak diagonally through an 8-connected wall)\n    var outside = new Uint8Array(W * H);\n    var ostack = [];\n    for (var bx = 0; bx < W; bx++) {\n      if (!occ[bx]) { outside[bx] = 1; ostack.push(bx); }\n      var bi = (H - 1) * W + bx;\n      if (!occ[bi] && !outside[bi]) { outside[bi] = 1; ostack.push(bi); }\n    }\n    for (var by = 0; by < H; by++) {\n      var li = by * W;\n      if (!occ[li] && !outside[li]) { outside[li] = 1; ostack.push(li); }\n      var ri = by * W + (W - 1);\n      if (!occ[ri] && !outside[ri]) { outside[ri] = 1; ostack.push(ri); }\n    }\n    while (ostack.length) {\n      var oc = ostack.pop();\n      var oy = (oc / W) | 0, ox = oc % W;\n      var nbs = [[ox - 1, oy], [ox + 1, oy], [ox, oy - 1], [ox, oy + 1]];\n      for (var nb = 0; nb < 4; nb++) {\n        var qx = nbs[nb][0], qy = nbs[nb][1];\n        if (qx < 0 || qy < 0 || qx >= W || qy >= H) continue;\n        var qi = qy * W + qx;\n        if (!occ[qi] && !outside[qi]) { outside[qi] = 1; ostack.push(qi); }\n      }\n    }\n\n    var covered = 0;\n    for (var cy2 = 0; cy2 < H; cy2++) {\n      for (var cx2 = 0; cx2 < W; cx2++) {\n        var ii = cy2 * W + cx2;\n        if (!occ[ii]) continue;\n        if (visited[ii]) { covered++; continue; }\n        // Enclosed if no 8-neighbour is exterior empty space\n        var exposed = false;\n        for (var ey = -1; ey <= 1 && !exposed; ey++) {\n          for (var ex = -1; ex <= 1 && !exposed; ex++) {\n            var px2 = cx2 + ex, py2 = cy2 + ey;\n            if (px2 < 0 || py2 < 0 || px2 >= W || py2 >= H) { exposed = true; break; }\n            if (outside[py2 * W + px2]) exposed = true;\n          }\n        }\n        if (!exposed) covered++;\n      }\n    }\n    var coverage = totalOcc > 0 ? covered / totalOcc : 0;\n\n    // Moore neighbour tracing, 8 directions clockwise starting at W.\n    var NB = [[-1, 0], [-1, 1], [0, 1], [1, 1], [1, 0], [1, -1], [0, -1], [-1, -1]];\n    function dirIndex(dx, dy) {\n      for (var i = 0; i < 8; i++) { if (NB[i][0] === dx && NB[i][1] === dy) return i; }\n      return 0;\n    }\n\n    var cells = [start.slice()];\n    var p = start.slice();\n    var backtrack = 0; // W of start is empty by construction of the scan\n    var firstFound = -1;\n    var startVisits = 0;\n    var maxSteps = W * H * 4;\n    for (var s = 0; s < maxSteps; s++) {\n      var found = -1;\n      for (var i = 1; i <= 8; i++) {\n        var d = (backtrack + i) % 8;\n        if (at(p[0] + NB[d][0], p[1] + NB[d][1])) { found = d; break; }\n      }\n      if (found < 0) break; // isolated single cell\n      if (s === 0) {\n        firstFound = found;\n      } else if (p[0] === start[0] && p[1] === start[1]) {\n        // Jacob's stopping criterion, exit-direction form: we are back at\n        // the start cell and about to move again. If the move we would\n        // make equals the very first move, the boundary walk has closed —\n        // stop BEFORE re-walking it (a same-cell-revisit stop terminates\n        // too early on spurs/necks where the boundary legitimately passes\n        // the start cell twice; a lenient visit-count stop walks the whole\n        // boundary twice, doubling the polygon and breaking everything\n        // downstream). Visit cap kept as a pure safety net.\n        if (found === firstFound) break;\n        if (++startVisits >= 3) break;\n      }\n      var prevD = (found + 7) % 8; // last empty neighbour before the hit\n      var ex = p[0] + NB[prevD][0], ey = p[1] + NB[prevD][1];\n      p = [p[0] + NB[found][0], p[1] + NB[found][1]];\n      backtrack = dirIndex(ex - p[0], ey - p[1]);\n      if (!(p[0] === start[0] && p[1] === start[1])) cells.push(p.slice());\n    }\n\n        if (onProgress) onProgress('snap');\n    // Cells -> world coordinates (cell centers).\n    var contour = cells.map(function (c) {\n      return { x: minX + (c[0] + 0.5) * step, y: minY + (c[1] + 0.5) * step };\n    });\n\n    // Coarse pre-simplify on the raster contour, then snap to exact\n    // toolpath geometry, then final collinear cleanup. The fast linear\n    // reduction first makes this tractable on huge boundaries.\n    contour = fastCollinearReduce(contour);\n    contour = simplifyHull(contour, step * 0.75);\n\n    // Geometry-exact snapping (v0.6). Nearest-SAMPLE snapping left vertices\n    // up to a grid cell off (≈5.5 mm on a 48\" part). Instead:\n    //  - a contour vertex whose neighbours turn sharply is a CORNER: snap it\n    //    to the nearest true toolpath vertex (segment endpoint / arc\n    //    tessellation point), giving exact corner coordinates;\n    //  - a straight-run vertex snaps by perpendicular projection onto the\n    //    nearest toolpath segment, so it lies exactly ON the path.\n    // Accuracy is now independent of grid resolution.\n    var polys = densified.polys || [];\n    var snapR = (dil + 2.5) * step;\n\n    function nearestPolyVertex(v) {\n      var best = null, bestD = Infinity;\n      for (var pi = 0; pi < polys.length; pi++) {\n        var poly = polys[pi];\n        for (var vi = 0; vi < poly.length; vi++) {\n          var d = Math.hypot(poly[vi].x - v.x, poly[vi].y - v.y);\n          if (d < bestD) { bestD = d; best = poly[vi]; }\n        }\n      }\n      return { p: best, d: bestD };\n    }\n\n    function nearestPolyProjection(v) {\n      var best = null, bestD = Infinity;\n      for (var pi = 0; pi < polys.length; pi++) {\n        var poly = polys[pi];\n        for (var vi = 0; vi < poly.length - 1; vi++) {\n          var ax = poly[vi].x, ay = poly[vi].y, bx = poly[vi + 1].x, by = poly[vi + 1].y;\n          var dx = bx - ax, dy = by - ay;\n          var len2 = dx * dx + dy * dy;\n          var t = len2 === 0 ? 0 : ((v.x - ax) * dx + (v.y - ay) * dy) / len2;\n          t = Math.max(0, Math.min(1, t));\n          var qx = ax + t * dx, qy = ay + t * dy;\n          var d = Math.hypot(v.x - qx, v.y - qy);\n          if (d < bestD) { bestD = d; best = { x: qx, y: qy }; }\n        }\n      }\n      return { p: best, d: bestD };\n    }\n\n    function turnAngleDeg(prev, cur, next) {\n      var a1 = Math.atan2(cur.y - prev.y, cur.x - prev.x);\n      var a2 = Math.atan2(next.y - cur.y, next.x - cur.x);\n      var d = Math.abs(a2 - a1);\n      if (d > Math.PI) d = 2 * Math.PI - d;\n      return d * 180 / Math.PI;\n    }\n\n    var snapped = contour.map(function (v, i) {\n      var prev = contour[(i - 1 + contour.length) % contour.length];\n      var next = contour[(i + 1) % contour.length];\n      var isCorner = turnAngleDeg(prev, v, next) > 25;\n      if (isCorner) {\n        var nv = nearestPolyVertex(v);\n        if (nv.p && nv.d <= snapR) return { x: nv.p.x, y: nv.p.y };\n      }\n      var np = nearestPolyProjection(v);\n      if (np.p && np.d <= snapR) return np.p;\n      var nv2 = nearestPolyVertex(v);\n      return (nv2.p && nv2.d <= snapR) ? { x: nv2.p.x, y: nv2.p.y } : v;\n    });\n\n    // Drop consecutive duplicates introduced by snapping.\n    var cleaned = [];\n    snapped.forEach(function (v) {\n      var last = cleaned[cleaned.length - 1];\n      if (!last || Math.hypot(last.x - v.x, last.y - v.y) > step * 0.4) cleaned.push(v);\n    });\n    if (cleaned.length > 2) {\n      var first = cleaned[0], lastV = cleaned[cleaned.length - 1];\n      if (Math.hypot(first.x - lastV.x, first.y - lastV.y) <= step * 0.4) cleaned.pop();\n    }\n\n    var finalHull = simplifyHull(cleaned, step * 0.6);\n\n    // Rubber-band tension (the \"Outline tightness\" slider). The tight hull\n    // above is the fully-cinched band. Lower tension lets the band pull\n    // taut across concave POCKETS: compute the convex hull of the outline\n    // vertices, walk the outline pocket by pocket (runs between\n    // consecutive convex-hull vertices), and drop any pocket whose depth\n    // exceeds what the tension allows. tension 8 keeps every pocket\n    // (tight, necks included); tension 0 keeps none (pure convex belt —\n    // tangent wrap, like a band around pulleys); in between, the deepest\n    // dips (inter-part necks) are the first to be pulled straight —\n    // matching how a physical band relaxes. Closing could not do this:\n    // dilate-erode cannot bridge between convexly curving parts at any\n    // radius, because the dilated waist is thinner than the radius and\n    // erodes away.\n    if (onProgress) onProgress('finish');\n    // ==== Four-state outline model (v0.25) ====\n    // Slider t in 0..12, spacing-independent (thresholds derive from the\n    // measured pocket depths of THIS file's outline):\n    //   t = 12  shrink-wrapped: every shape hugged, thin traversal necks\n    //   t = 8   merged: the band lifts off the deep inter-shape necks and\n    //           crosses gaps as straight chords — one ring, still visiting\n    //           and hugging every shape (allowed dip = maxDepth/4)\n    //   t = 4   convex hull (allowed dip = 0)\n    //   t = 0   bounding box\n    //   4..12 is the continuous rubber-band allowance maxDepth*((t-4)/8)^2;\n    //   0..4 morphs the convex hull toward the box.\n    var t12 = (closeRadius === undefined || closeRadius === null) ? 12 : Math.max(0, Math.min(12, closeRadius));\n    if (t12 <= 4 && finalHull.length > 3) {\n      // Convex end of the range: the true convex hull, computed directly —\n      // always simple, always contains every part.\n      finalHull = convexHull(finalHull);\n      if (t12 < 4 && finalHull.length >= 3) {\n        // Support-function interpolation between the convex hull and its\n        // bounding box: h_f(theta) = f*h_CH + (1-f)*h_Box. Since the box\n        // contains the hull, h_Box >= h_CH everywhere, so h_f >= h_CH — the\n        // morph shape PROVABLY contains the convex hull at every slider\n        // position (the previous pointwise vertex lerp could cut corners\n        // of the geometry when sample correspondences misaligned).\n        var f2 = Math.max(0, Math.min(1, t12 / 4));\n        var mnX2 = Infinity, mnY2 = Infinity, mxX2 = -Infinity, mxY2 = -Infinity;\n        for (var b2 = 0; b2 < finalHull.length; b2++) {\n          var bv2 = finalHull[b2];\n          if (bv2.x < mnX2) mnX2 = bv2.x; if (bv2.x > mxX2) mxX2 = bv2.x;\n          if (bv2.y < mnY2) mnY2 = bv2.y; if (bv2.y > mxY2) mxY2 = bv2.y;\n        }\n        var KD = 72;\n        var hs = new Array(KD);\n        for (var kd = 0; kd < KD; kd++) {\n          var th = 2 * Math.PI * kd / KD;\n          var cth = Math.cos(th), sth = Math.sin(th);\n          var hCH = -Infinity;\n          for (var hv = 0; hv < finalHull.length; hv++) {\n            var dth = finalHull[hv].x * cth + finalHull[hv].y * sth;\n            if (dth > hCH) hCH = dth;\n          }\n          var hBox = Math.max(mnX2 * cth, mxX2 * cth) + Math.max(mnY2 * sth, mxY2 * sth);\n          hs[kd] = f2 * hCH + (1 - f2) * hBox;\n        }\n        // polygon from support lines: intersect consecutive lines, then\n        // convex-hull the candidates to prune redundant-line artifacts\n        var cand = [];\n        for (var kc = 0; kc < KD; kc++) {\n          var t1 = 2 * Math.PI * kc / KD, t2 = 2 * Math.PI * ((kc + 1) % KD) / KD;\n          var c1 = Math.cos(t1), s1 = Math.sin(t1), c2 = Math.cos(t2), s2 = Math.sin(t2);\n          var det = c1 * s2 - c2 * s1;\n          if (Math.abs(det) < 1e-12) continue;\n          cand.push({ x: (hs[kc] * s2 - hs[(kc + 1) % KD] * s1) / det, y: (c1 * hs[(kc + 1) % KD] - c2 * hs[kc]) / det });\n        }\n        var morphedH = convexHull(cand);\n        if (morphedH && morphedH.length >= 3) {\n          var simp2 = simplifyHull(morphedH, step * 0.3);\n          finalHull = (simp2 && simp2.length >= 3) ? simp2 : morphedH;\n        }\n      }\n    } else if (t12 < 12 && finalHull.length > 3) {\n      // 4 < t < 12: top-down recursive band refinement. Anchors start at\n      // the convex-hull vertices; each unanchored run between anchors is\n      // decided as a whole:\n      //   conform  — its max depth fits the allowance (ratio of its own\n      //              mouth width + an absolute term ramping over 8..12)\n      //   drop     — replaced by the straight chord between its anchors\n      //   split    — if the chord would TRAP geometry (a band cannot pass\n      //              through material), pin the deepest point and recurse\n      //              on both sides\n      // Decisions are per-run and top-down, so anchoring cannot creep\n      // point-by-point down smooth corridors (the failure of iterative\n      // propagation), and trapped-geometry splits make tour-order chords\n      // slicing across other parts impossible by construction.\n      var chT = convexHull(finalHull);\n      var chSetT = new Set(chT);\n      var startIdxT = -1;\n      for (var siT = 0; siT < finalHull.length; siT++) { if (chSetT.has(finalHull[siT])) { startIdxT = siT; break; } }\n      if (startIdxT >= 0) {\n        var rot = finalHull.slice(startIdxT).concat(finalHull.slice(0, startIdxT));\n        var N = rot.length;\n        var anchor = new Uint8Array(N + 1);\n        for (var aiT = 0; aiT < N; aiT++) if (chSetT.has(rot[aiT])) anchor[aiT] = 1;\n        anchor[N] = 1; // cyclic sentinel (same point as index 0)\n        var kRatio, absAllow, maxDepthT = 0;\n        // measure max pocket depth for the absolute ramp scale\n        {\n          var mA = 0;\n          for (var mi2 = 1; mi2 <= N; mi2++) {\n            if (anchor[mi2]) {\n              if (mi2 - mA > 1) {\n                var ma2 = rot[mA], mb2 = rot[mi2 % N];\n                for (var mq = mA + 1; mq < mi2; mq++) {\n                  var mdp = pointSegDist(rot[mq].x, rot[mq].y, ma2.x, ma2.y, mb2.x, mb2.y);\n                  if (mdp > maxDepthT) maxDepthT = mdp;\n                }\n              }\n              mA = mi2;\n            }\n          }\n        }\n        if (t12 >= 8) {\n          kRatio = 0.15;\n          absAllow = maxDepthT * Math.pow((t12 - 8) / 4, 2);\n        } else {\n          kRatio = 0.15 * Math.pow((t12 - 4) / 4, 2);\n          absAllow = 0;\n        }\n        var gpts = densified.points || [];\n        var trapStride = Math.max(1, Math.floor(gpts.length / 4000));\n        function runTrapsGeometry(from, to) {\n          var poly = [];\n          for (var rp = from; rp <= to; rp++) poly.push(rot[rp % N]);\n          if (poly.length < 3) return false;\n          var mnPX = Infinity, mnPY = Infinity, mxPX = -Infinity, mxPY = -Infinity;\n          for (var rb = 0; rb < poly.length; rb++) {\n            var rv = poly[rb];\n            if (rv.x < mnPX) mnPX = rv.x; if (rv.x > mxPX) mxPX = rv.x;\n            if (rv.y < mnPY) mnPY = rv.y; if (rv.y > mxPY) mxPY = rv.y;\n          }\n          for (var gp = 0; gp < gpts.length; gp += trapStride) {\n            var q = gpts[gp];\n            if (q.x < mnPX || q.x > mxPX || q.y < mnPY || q.y > mxPY) continue;\n            var inside = false;\n            for (var pi2 = 0, pj2 = poly.length - 1; pi2 < poly.length; pj2 = pi2++) {\n              var qi = poly[pi2], qj = poly[pj2];\n              if ((qi.y > q.y) !== (qj.y > q.y) && q.x < (qj.x - qi.x) * (q.y - qi.y) / (qj.y - qi.y) + qi.x) inside = !inside;\n            }\n            if (inside) {\n              // boundary points of the run itself register as epsilon-inside;\n              // trapped MATERIAL is well inside — require a clear margin\n              var margin = step * 2.5;\n              var clear = true;\n              for (var me = 0; me < poly.length; me++) {\n                var ea2 = poly[me], eb2 = poly[(me + 1) % poly.length];\n                if (pointSegDist(q.x, q.y, ea2.x, ea2.y, eb2.x, eb2.y) < margin) { clear = false; break; }\n              }\n              if (clear) return true;\n            }\n          }\n          return false;\n        }\n        // polygon orientation: interior is LEFT of travel for CCW\n        var shoel = 0;\n        for (var so = 0; so < N; so++) {\n          var sp1 = rot[so], sp2 = rot[(so + 1) % N];\n          shoel += sp1.x * sp2.y - sp2.x * sp1.y;\n        }\n        var ccwS = shoel >= 0 ? 1 : -1;\n        var refineStack = [];\n        var rA = 0;\n        for (var w4 = 1; w4 <= N; w4++) {\n          if (anchor[w4]) { if (w4 - rA > 1) refineStack.push([rA, w4]); rA = w4; }\n        }\n        var guard = 0;\n        while (refineStack.length && guard++ < N * 4) {\n          var seg2 = refineStack.pop();\n          var sa = seg2[0], sb = seg2[1];\n          if (sb - sa <= 1) continue;\n          var pa3 = rot[sa], pb3 = rot[sb % N];\n          var mouth = Math.hypot(pb3.x - pa3.x, pb3.y - pa3.y);\n          var runAllowed = kRatio * mouth + absAllow;\n          var maxD2 = -1, maxI2 = -1, maxOut = -1, maxOutI = -1;\n          var ex2 = pb3.x - pa3.x, ey2 = pb3.y - pa3.y;\n          var elen2 = Math.hypot(ex2, ey2) || 1e-9;\n          for (var q3 = sa + 1; q3 < sb; q3++) {\n            var d3 = pointSegDist(rot[q3].x, rot[q3].y, pa3.x, pa3.y, pb3.x, pb3.y);\n            if (d3 > maxD2) { maxD2 = d3; maxI2 = q3; }\n            // signed side: negative cross*ccw = OUTWARD of the chord\n            var crs = ((ex2) * (rot[q3].y - pa3.y) - (ey2) * (rot[q3].x - pa3.x)) * ccwS;\n            var outD = -crs / elen2;\n            if (outD > maxOut) { maxOut = outD; maxOutI = q3; }\n          }\n          if (maxOut > step) {\n            // The run bulges OUTWARD past its chord (sub-chords after\n            // splits aren't convex-hull edges). Dropping would slice the\n            // bulge off the outline — pin the most outward point instead\n            // and refine both sides.\n            anchor[maxOutI] = 1;\n            refineStack.push([sa, maxOutI]);\n            refineStack.push([maxOutI, sb]);\n          } else if (maxD2 <= runAllowed) {\n            for (var q4 = sa + 1; q4 < sb; q4++) anchor[q4] = 1; // conform\n          } else if (runTrapsGeometry(sa, sb)) {\n            anchor[maxI2] = 1; // pin on the trapped material, refine both sides\n            refineStack.push([sa, maxI2]);\n            refineStack.push([maxI2, sb]);\n          }\n          // else: whole run stays dropped (straight chord)\n        }\n        var banded = [];\n        for (var bi2 = 0; bi2 < N; bi2++) if (anchor[bi2]) banded.push(rot[bi2]);\n        if (banded.length >= 3) finalHull = banded;\n      }\n    }\n\n    // Outward clearance offset (all slider positions): hull vertices sit ON\n    // the toolpath, so chords between them cut inside smooth arcs by the\n    // sagitta (measured up to ~0.7 mm). The outline's contract is \"always\n    // OUTSIDE the cut\", so push every vertex out along its angle-bisector\n    // normal by a small clearance. Thin neck out-and-backs offset away from\n    // each other (outward normals oppose), so no self-crossing at this\n    // scale.\n    var clearance = Math.max(step * 2, 1.0 / (densified.mmScale || 1)); // >= 1 mm in real units\n    if (finalHull.length >= 3) {\n      var sgn = 0;\n      for (var oa = 0; oa < finalHull.length; oa++) {\n        var ov1 = finalHull[oa], ov2 = finalHull[(oa + 1) % finalHull.length];\n        sgn += ov1.x * ov2.y - ov2.x * ov1.y;\n      }\n      var ccw = sgn >= 0 ? 1 : -1;\n      var offset = [];\n      for (var ob = 0; ob < finalHull.length; ob++) {\n        var pv = finalHull[(ob - 1 + finalHull.length) % finalHull.length];\n        var cv = finalHull[ob];\n        var nv = finalHull[(ob + 1) % finalHull.length];\n        var e1x = cv.x - pv.x, e1y = cv.y - pv.y;\n        var e2x = nv.x - cv.x, e2y = nv.y - cv.y;\n        var l1 = Math.hypot(e1x, e1y) || 1e-9, l2 = Math.hypot(e2x, e2y) || 1e-9;\n        // outward normals for CCW polygons point right of travel: (dy, -dx)\n        var n1x = ccw * e1y / l1, n1y = -ccw * e1x / l1;\n        var n2x = ccw * e2y / l2, n2y = -ccw * e2x / l2;\n        var bx = n1x + n2x, by = n1y + n2y;\n        var bl = Math.hypot(bx, by);\n        if (bl < 1e-9) { bx = n1x; by = n1y; bl = 1; }\n        bx /= bl; by /= bl;\n        var cosHalf = Math.max(0.34, (1 + (n1x * n2x + n1y * n2y)) / 2 > 0 ? Math.sqrt((1 + (n1x * n2x + n1y * n2y)) / 2) : 0.34);\n        var d = Math.min(clearance / cosHalf, clearance * 3);\n        offset.push({ x: cv.x + bx * d, y: cv.y + by * d });\n      }\n      finalHull = offset;\n    }\n\n    finalHull.coverage = coverage;\n    finalHull.componentCount = ncomp;\n    finalHull.bridgeCount = bridgeCount;\n    return finalHull;\n  }\n\n  // ============================================================\n  // Viewer — rewritten for v0.2.\n  //\n  // v0.1 bug: the SVG had a viewBox captured from clientWidth/Height at\n  // render time (often before the dialog finished layout), and click math\n  // assumed the drawing filled the element. SVG's default\n  // preserveAspectRatio letterboxes instead, so the effective scale\n  // differed per-axis: clicks were accurate at center and drifted outward\n  // with quadrant-dependent sign — exactly the symptom reported.\n  //\n  // v0.2 removes viewBox entirely (so 1 SVG user unit == 1 CSS pixel,\n  // always exact), renders geometry in raw world (mm) coordinates inside a\n  // single <g>, and maps world<->screen through one explicit affine\n  // transform we fully control:\n  //     screenX = tx + scale * worldX\n  //     screenY = ty - scale * worldY   (Y-up flip)\n  // Zoom (wheel, anchored at the cursor), pan (drag), fit, and click\n  // hit-testing all share this same transform, so they can't disagree.\n  // Stroke widths use vector-effect=\"non-scaling-stroke\"; dash patterns\n  // and marker radii are divided by scale on every transform change so\n  // they stay screen-sized at any zoom.\n  // ============================================================\n  var FIT_PAD = 26;\n\n  function Viewer(svgEl, onSelect) {\n    var self = this;\n    this.svg = svgEl;\n    this.onSelect = onSelect;\n    this.scale = 1;\n    this.tx = 0;\n    this.ty = 0;\n    this.minScale = 1;\n    this.parsed = null;\n    this.overlay = {};\n    this.userTransformed = false;\n\n    svgEl.addEventListener('wheel', function (e) {\n      if (!self.parsed) return;\n      e.preventDefault();\n      var rect = svgEl.getBoundingClientRect();\n      var sx = e.clientX - rect.left, sy = e.clientY - rect.top;\n      var w = self.screenToWorld(sx, sy);\n      var factor = e.deltaY < 0 ? 1.25 : 0.8;\n      var ns = self.scale * factor;\n      ns = Math.max(self.minScale * 0.2, Math.min(self.minScale * 500, ns));\n      self.scale = ns;\n      // keep the world point under the cursor fixed while zooming\n      self.tx = sx - ns * w.x;\n      self.ty = sy + ns * w.y;\n      self.userTransformed = true;\n      self.applyTransform();\n      self.scheduleCullRender();\n    }, { passive: false });\n\n    var drag = null;\n    var mouseLongTimer = null;\n    function worldAtClient(cx, cy) {\n      var rect = svgEl.getBoundingClientRect();\n      return self.screenToWorld(cx - rect.left, cy - rect.top);\n    }\n    svgEl.addEventListener('mousedown', function (e) {\n      if (e.button !== 0) return;\n      var w = worldAtClient(e.clientX, e.clientY);\n      // Grabbing the target marker enters creep-drag mode instead of pan.\n      var mode = (self.hitTarget && self.hitTarget(w)) ? 'target' : 'pan';\n      drag = { x: e.clientX, y: e.clientY, tx: self.tx, ty: self.ty, moved: false, target: e.target, mode: mode, longFired: false };\n      // Hold-left-click (600 ms, no movement) sets the target point —\n      // mouse equivalent of a touch long-press, but with no context menu.\n      if (mode === 'pan' && self.onLongPress) {\n        mouseLongTimer = setTimeout(function () {\n          mouseLongTimer = null;\n          if (drag && !drag.moved) {\n            drag.longFired = true;\n            self.onLongPress(worldAtClient(drag.x, drag.y));\n          }\n        }, 600);\n      }\n      e.preventDefault();\n    });\n    window.addEventListener('mousemove', function (e) {\n      if (!drag) return;\n      var dx = e.clientX - drag.x, dy = e.clientY - drag.y;\n      if (!drag.moved && Math.hypot(dx, dy) < 4) return;\n      drag.moved = true;\n      if (mouseLongTimer) { clearTimeout(mouseLongTimer); mouseLongTimer = null; }\n      if (drag.mode === 'target') {\n        if (self.onTargetDrag) self.onTargetDrag(worldAtClient(e.clientX, e.clientY));\n        svgEl.style.cursor = 'move';\n        return;\n      }\n      self.userTransformed = true;\n      self.tx = drag.tx + dx;\n      self.ty = drag.ty + dy;\n      self.applyTransform();\n      self.scheduleCullRender();\n      svgEl.style.cursor = 'grabbing';\n    });\n    window.addEventListener('mouseup', function (e) {\n      if (mouseLongTimer) { clearTimeout(mouseLongTimer); mouseLongTimer = null; }\n      if (!drag) return;\n      var d = drag;\n      drag = null;\n      svgEl.style.cursor = 'crosshair';\n      if (d.mode === 'target' || d.moved || d.longFired || !self.parsed || !self.onSelect) return;\n      var rect = svgEl.getBoundingClientRect();\n      if (e.clientX < rect.left || e.clientX > rect.right || e.clientY < rect.top || e.clientY > rect.bottom) return;\n      var w = self.screenToWorld(e.clientX - rect.left, e.clientY - rect.top);\n      self.onSelect(w, d.target);\n    });\n\n    // Right-click context menu. ncSender suppresses the NATIVE menu\n    // globally (document-level preventDefault in main.ts) but the event\n    // itself still fires here first, so a custom-rendered menu — the same\n    // pattern as the host's own TransformContextMenu — works fine.\n    svgEl.addEventListener('contextmenu', function (e) {\n      e.preventDefault();\n      e.stopPropagation();\n      if (!self.parsed || !self.onContext) return;\n      var rect = svgEl.getBoundingClientRect();\n      var w = self.screenToWorld(e.clientX - rect.left, e.clientY - rect.top);\n      self.onContext(w, e.clientX, e.clientY);\n    });\n\n    // Touch: single-finger drag pans, tap selects, long-press (600 ms,\n    // cancelled by >8 px movement) opens the context menu — mirroring the\n    // host visualizer's own long-press implementation, since suppressing\n    // the native menu also suppresses the OS long-press menu.\n    // Two fingers: pinch to zoom, anchored at the finger midpoint. Because\n    // the anchor world point is recomputed from the pre-update transform at\n    // the CURRENT midpoint each frame, moving both fingers together also\n    // pans — one gesture handles zoom + pan combined.\n    var touch = null;\n    var pinch = null;\n    var LONG_PRESS_MS = 600;\n\n    function touchDist(t1, t2) { return Math.hypot(t1.clientX - t2.clientX, t1.clientY - t2.clientY); }\n\n    svgEl.addEventListener('touchstart', function (e) {\n      if (e.touches.length === 2) {\n        e.preventDefault();\n        clearTouch(); // cancel single-finger state + long-press timer\n        var rect0 = svgEl.getBoundingClientRect();\n        pinch = {\n          prevD: touchDist(e.touches[0], e.touches[1]),\n          prevMx: (e.touches[0].clientX + e.touches[1].clientX) / 2 - rect0.left,\n          prevMy: (e.touches[0].clientY + e.touches[1].clientY) / 2 - rect0.top\n        };\n        return;\n      }\n      if (e.touches.length !== 1 || pinch) { clearTouch(); return; }\n      e.preventDefault();\n      var t = e.touches[0];\n      var tw = worldAtClient(t.clientX, t.clientY);\n      touch = {\n        x: t.clientX, y: t.clientY, tx: self.tx, ty: self.ty,\n        mode: (self.hitTarget && self.hitTarget(tw)) ? 'target' : 'pan',\n        moved: false, menuFired: false,\n        timer: window.setTimeout(function () {\n          if (!touch || touch.moved) return;\n          touch.menuFired = true;\n          if (self.parsed && self.onContext) {\n            var rect = svgEl.getBoundingClientRect();\n            var w = self.screenToWorld(touch.x - rect.left, touch.y - rect.top);\n            self.onContext(w, touch.x, touch.y);\n          }\n        }, LONG_PRESS_MS)\n      };\n    }, { passive: false });\n    svgEl.addEventListener('touchmove', function (e) {\n      if (pinch && e.touches.length === 2) {\n        e.preventDefault();\n        var t1 = e.touches[0], t2 = e.touches[1];\n        var d = touchDist(t1, t2);\n        if (d < 1 || pinch.prevD < 1) { pinch.prevD = d; return; }\n        var rect = svgEl.getBoundingClientRect();\n        var mx = (t1.clientX + t2.clientX) / 2 - rect.left;\n        var my = (t1.clientY + t2.clientY) / 2 - rect.top;\n        // Anchor: the world point that was under the PREVIOUS midpoint must\n        // land under the NEW midpoint. This makes pure finger-spread zoom\n        // about the gesture center, and moving both fingers together pan —\n        // and any combination of the two behaves correctly.\n        var w = self.screenToWorld(pinch.prevMx, pinch.prevMy);\n        var ns = self.scale * (d / pinch.prevD);\n        ns = Math.max(self.minScale * 0.2, Math.min(self.minScale * 500, ns));\n        self.scale = ns;\n        self.tx = mx - ns * w.x;\n        self.ty = my + ns * w.y;\n        self.userTransformed = true;\n        self.applyTransform();\n        self.scheduleCullRender();\n        pinch.prevD = d;\n        pinch.prevMx = mx;\n        pinch.prevMy = my;\n        return;\n      }\n      if (!touch || e.touches.length !== 1) return;\n      e.preventDefault();\n      var t = e.touches[0];\n      var dx = t.clientX - touch.x, dy = t.clientY - touch.y;\n      if (!touch.moved && Math.hypot(dx, dy) < 8) return;\n      touch.moved = true;\n      if (touch.timer) { clearTimeout(touch.timer); touch.timer = null; }\n      if (touch.mode === 'target') {\n        if (self.onTargetDrag) self.onTargetDrag(worldAtClient(t.clientX, t.clientY));\n        return;\n      }\n      self.userTransformed = true;\n      self.tx = touch.tx + dx;\n      self.ty = touch.ty + dy;\n      self.applyTransform();\n      self.scheduleCullRender();\n    }, { passive: false });\n    svgEl.addEventListener('touchend', function (e) {\n      if (pinch) {\n        // Pinch ends when fewer than 2 fingers remain; require a clean\n        // lift before tap/drag resumes so the trailing finger can't select.\n        if (e.touches.length < 2) pinch = null;\n        return;\n      }\n      if (!touch) return;\n      var wasTap = !touch.moved && !touch.menuFired;\n      var tapX = touch.x, tapY = touch.y;\n      clearTouch();\n      if (wasTap && self.parsed && self.onSelect) {\n        var rect = svgEl.getBoundingClientRect();\n        var w = self.screenToWorld(tapX - rect.left, tapY - rect.top);\n        var target = document.elementFromPoint(tapX, tapY);\n        self.onSelect(w, target);\n      }\n    });\n    svgEl.addEventListener('touchcancel', function () { pinch = null; clearTouch(); });\n    function clearTouch() {\n      if (touch && touch.timer) clearTimeout(touch.timer);\n      touch = null;\n    }\n\n    // Refit whenever the map area changes size (dialog opening animation,\n    // window resize, tab becoming visible) — unless the user has already\n    // zoomed/panned, in which case leave their view alone.\n    if (typeof ResizeObserver !== 'undefined') {\n      this._ro = new ResizeObserver(function () {\n        if (self.parsed && !self.userTransformed) self.fit();\n      });\n      this._ro.observe(svgEl.parentElement);\n    }\n  }\n\n  Viewer.prototype.screenToWorld = function (sx, sy) {\n    return { x: (sx - this.tx) / this.scale, y: (this.ty - sy) / this.scale };\n  };\n\n  Viewer.prototype.pxToWorld = function (px) {\n    return px / this.scale;\n  };\n\n  Viewer.prototype.fit = function () {\n    if (!this.parsed) return;\n    var rect = this.svg.getBoundingClientRect();\n    var w = rect.width || 800, h = rect.height || 500;\n    var b = this.parsed.bounds;\n    var bw = Math.max(b.maxX - b.minX, 0.001);\n    var bh = Math.max(b.maxY - b.minY, 0.001);\n    var s = Math.min((w - 2 * FIT_PAD) / bw, (h - 2 * FIT_PAD) / bh);\n    this.minScale = s;\n    this.scale = s;\n    this.tx = (w - s * bw) / 2 - s * b.minX;\n    this.ty = (h - s * bh) / 2 + s * b.maxY;\n    this.userTransformed = false;\n    this._fitted = true;\n    this.applyTransform();\n    this.scheduleCullRender();\n  };\n\n  Viewer.prototype.worldViewport = function (marginFactor) {\n    var w = this.svg.clientWidth || 1, h = this.svg.clientHeight || 1;\n    var a = this.screenToWorld(0, 0), b = this.screenToWorld(w, h);\n    var minX = Math.min(a.x, b.x), maxX = Math.max(a.x, b.x);\n    var minY = Math.min(a.y, b.y), maxY = Math.max(a.y, b.y);\n    var mx = (maxX - minX) * (marginFactor - 1) / 2;\n    var my = (maxY - minY) * (marginFactor - 1) / 2;\n    return { minX: minX - mx, maxX: maxX + mx, minY: minY - my, maxY: maxY + my };\n  };\n\n  // Debounced viewport-culled re-render after zoom/pan settles. Only big\n  // files bother: the 60%-margin rect means gentle panning stays covered\n  // until the next settle, and zooming out briefly shows the culled\n  // window before the rebuild fills it back in (140 ms).\n  Viewer.prototype.scheduleCullRender = function () {\n    var self = this;\n    if (this._cullTimer) clearTimeout(this._cullTimer);\n    this._cullTimer = setTimeout(function () {\n      self._cullTimer = null;\n      if (!self.parsed || !self.parsed.segments) return;\n      if (self.parsed.segments.length < 1500) return; // small files never need culling\n      var o = self.overlay || {};\n      o.cullRect = self.worldViewport(1.6);\n      self.render(self.parsed, o);\n    }, 140);\n  };\n\n  Viewer.prototype.applyTransform = function () {\n    // Batch DOM writes into one animation frame: coalesces rapid wheel /\n    // pinch events, and gives iPad Safari a clean paint boundary — without\n    // this (plus the translateZ(0) layer promotion in CSS) iOS would\n    // sometimes skip repainting the SVG during zoom/pan.\n    var self = this;\n    if (this._raf) return;\n    this._raf = requestAnimationFrame(function () {\n      self._raf = null;\n      var g = self.svg.querySelector('g.gn-world');\n      if (!g) return;\n      g.setAttribute('transform',\n        'matrix(' + self.scale + ',0,0,' + (-self.scale) + ',' + self.tx + ',' + self.ty + ')');\n      var s = self.scale;\n      // Keep dashes and markers screen-sized regardless of zoom — but only\n      // rewrite the attributes when the SCALE changed (or after a rebuild):\n      // touching stroke-dasharray on the batched multi-MB rapid path forces\n      // the browser to re-rasterise it, which made pure pans expensive.\n      if (self._lastAttrScale !== s || self._attrsDirty) {\n        self._lastAttrScale = s;\n        self._attrsDirty = false;\n        self.svg.querySelectorAll('[data-dash]').forEach(function (el) {\n          var d = 4 / s;\n          el.setAttribute('stroke-dasharray', d + ',' + d);\n        });\n        self.svg.querySelectorAll('circle[data-r]').forEach(function (el) {\n          el.setAttribute('r', String(parseFloat(el.getAttribute('data-r')) / s));\n        });\n        var crossLen = 14 / s;\n        self.svg.querySelectorAll('line[data-crossline]').forEach(function (el) {\n          if (el.getAttribute('data-crossline') === 'x') {\n            el.setAttribute('x1', -crossLen); el.setAttribute('x2', crossLen);\n            el.setAttribute('y1', 0); el.setAttribute('y2', 0);\n          } else {\n            el.setAttribute('x1', 0); el.setAttribute('x2', 0);\n            el.setAttribute('y1', -crossLen); el.setAttribute('y2', crossLen);\n          }\n        });\n      }\n      // Nudge WebKit into compositing the new frame.\n      void self.svg.getBoundingClientRect();\n    });\n  };\n\n  // Surgical target-marker update: repositions the existing ring/dot\n  // instead of rebuilding the whole SVG. Rebuilding on every creep-slider\n  // tick caused visible strobing/flashing on Windows Chrome.\n  // Live spindle crosshair: a <g> translated to the work position with two\n  // screen-sized cross lines and a ring. Created/moved surgically (no scene\n  // rebuild); re-created after any innerHTML rebuild by the next poll tick.\n  Viewer.prototype.updateSpindle = function (pt) {\n    var world = this.svg.querySelector('.gn-world');\n    if (!world) return;\n    var g = world.querySelector('[data-spindle]');\n    if (!pt) {\n      if (g) g.remove();\n      return;\n    }\n    if (!g) {\n      g = document.createElementNS('http://www.w3.org/2000/svg', 'g');\n      g.setAttribute('data-spindle', '1');\n      var mk = function (tag, attrs) {\n        var el = document.createElementNS('http://www.w3.org/2000/svg', tag);\n        Object.keys(attrs).forEach(function (k) { el.setAttribute(k, attrs[k]); });\n        g.appendChild(el);\n        return el;\n      };\n      mk('line', { 'data-crossline': 'x', stroke: 'rgba(255,255,255,0.75)', 'stroke-width': '1.4', 'vector-effect': 'non-scaling-stroke' });\n      mk('line', { 'data-crossline': 'y', stroke: 'rgba(255,255,255,0.75)', 'stroke-width': '1.4', 'vector-effect': 'non-scaling-stroke' });\n      mk('circle', { 'data-r': '6', r: '1', fill: 'none', stroke: 'rgba(255,255,255,0.75)', 'stroke-width': '1.4', 'vector-effect': 'non-scaling-stroke' });\n      world.appendChild(g);\n      this._attrsDirty = true;\n      this.applyTransform();\n    }\n    g.setAttribute('transform', 'translate(' + pt.x.toFixed(4) + ',' + pt.y.toFixed(4) + ')');\n  };\n\n  Viewer.prototype.updateOverlayPoint = function (pt) {\n    this._attrsDirty = true;\n    // keep the cached overlay in sync: cull re-renders (zoom/pan on large\n    // files) rebuild the scene from this.overlay, and without this line the\n    // creep marker snapped back to its position at selection time\n    this.overlay = this.overlay || {};\n    this.overlay.selectedPoint = pt;\n    var g = this.svg.querySelector('g.gn-world');\n    if (!g) return;\n    var ring = g.querySelector('circle.gn-target-ring');\n    var dot = g.querySelector('circle.gn-target-dot');\n    if (!pt) {\n      if (ring) ring.remove();\n      if (dot) dot.remove();\n      return;\n    }\n    var NS = 'http://www.w3.org/2000/svg';\n    if (!ring) {\n      ring = document.createElementNS(NS, 'circle');\n      ring.setAttribute('class', 'gn-target-ring');\n      ring.setAttribute('data-r', '11');\n      ring.setAttribute('fill', 'none');\n      ring.setAttribute('stroke', 'var(--gn-select)');\n      ring.setAttribute('stroke-width', '2.5');\n      ring.setAttribute('vector-effect', 'non-scaling-stroke');\n      g.appendChild(ring);\n    }\n    if (!dot) {\n      dot = document.createElementNS(NS, 'circle');\n      dot.setAttribute('class', 'gn-target-dot');\n      dot.setAttribute('data-r', '4.5');\n      dot.setAttribute('fill', 'var(--gn-select)');\n      dot.setAttribute('stroke', '#000');\n      dot.setAttribute('stroke-width', '1');\n      dot.setAttribute('vector-effect', 'non-scaling-stroke');\n      g.appendChild(dot);\n    }\n    var s = this.scale || 1;\n    [ring, dot].forEach(function (el) {\n      el.setAttribute('cx', pt.x.toFixed(4));\n      el.setAttribute('cy', pt.y.toFixed(4));\n      el.setAttribute('r', String(parseFloat(el.getAttribute('data-r')) / s));\n    });\n  };\n\n  Viewer.prototype.render = function (parsed, overlay) {\n    var firstRender = this.parsed === null;\n    this.parsed = parsed;\n    this.overlay = overlay || {};\n    var o = this.overlay;\n    var parts = ['<g class=\"gn-world\">'];\n\n    var vis = o.layerVis || {};\n    function layerOn(k) { return vis[k] !== false; }\n\n    // Performance model (v0.23): batched paths (few DOM nodes regardless\n    // of file size) + a NUMERIC per-file cache (bboxes only, no strings) +\n    // scale-adaptive vertex decimation. At fit zoom on an 840k-segment\n    // relief carve most moves are sub-pixel, so consecutive same-style\n    // segments are chained into polylines and vertices closer than ~0.6\n    // screen px to the last emitted vertex are skipped; deep zooms rely on\n    // viewport culling instead (debounced rebuild after zoom/pan). Chain\n    // continuity uses exact float equality, which holds because the parser\n    // threads the same coordinate values from one segment to the next.\n    if (this._segCacheFor !== parsed) {\n      this._segCacheFor = parsed;\n      this._fitted = false;\n      // Flat typed array (minX,minY,maxX,maxY per segment): ~10x faster to\n      // build than 840k cache objects and a fraction of the memory.\n      var nSegs = parsed.segments.length;\n      var box = new Float64Array(nSegs * 4);\n      for (var ci0 = 0; ci0 < nSegs; ci0++) {\n        var s0 = parsed.segments[ci0];\n        var mnX = s0.x0 < s0.x1 ? s0.x0 : s0.x1, mxX = s0.x0 < s0.x1 ? s0.x1 : s0.x0;\n        var mnY = s0.y0 < s0.y1 ? s0.y0 : s0.y1, mxY = s0.y0 < s0.y1 ? s0.y1 : s0.y0;\n        if (s0.points) {\n          for (var pi0 = 0; pi0 < s0.points.length; pi0++) {\n            var pp = s0.points[pi0];\n            if (pp.x < mnX) mnX = pp.x; else if (pp.x > mxX) mxX = pp.x;\n            if (pp.y < mnY) mnY = pp.y; else if (pp.y > mxY) mxY = pp.y;\n          }\n        }\n        var bo = ci0 * 4;\n        box[bo] = mnX; box[bo + 1] = mnY; box[bo + 2] = mxX; box[bo + 3] = mxY;\n      }\n      this._segBox = box;\n    }\n\n    var effScale = this.scale;\n    if (!this.userTransformed && !this._fitted) {\n      // First paint happens before fit(); estimate the fit scale so the\n      // decimation tolerance is right from the start.\n      var rect0 = this.svg.getBoundingClientRect();\n      var ew = rect0.width || 1200, eh = rect0.height || 700;\n      var eb = parsed.bounds;\n      effScale = Math.min(ew / Math.max(eb.maxX - eb.minX, 0.001), eh / Math.max(eb.maxY - eb.minY, 0.001));\n    }\n    var tol = 0.6 / Math.max(effScale, 1e-9);\n    var tol2 = tol * tol;\n    // Coordinate precision scales with the decimation tolerance: no point\n    // writing 4 decimals when vertices closer than 0.1 are being skipped.\n    var DEC = tol >= 0.05 ? 2 : (tol >= 0.005 ? 3 : 4);\n    var cull = o.cullRect || null;\n    // Normalise a cull rect that covers the whole file to 'ALL' so panning\n    // at fit zoom doesn't count as a scene change.\n    var cullKey = 'ALL';\n    if (cull) {\n      var pb = parsed.bounds;\n      if (cull.minX > pb.minX || cull.minY > pb.minY || cull.maxX < pb.maxX || cull.maxY < pb.maxY) {\n        cullKey = cull.minX.toFixed(2) + ',' + cull.minY.toFixed(2) + ',' + cull.maxX.toFixed(2) + ',' + cull.maxY.toFixed(2);\n      }\n    }\n    // Scene signature: if nothing that affects the drawn content changed,\n    // skip the innerHTML rebuild entirely (a rebuild on a big file paints a\n    // blank frame while multi-MB paths re-rasterise) and just re-apply the\n    // transform.\n    var sig = [parsed.totalLines, parsed.segments.length, cullKey, DEC, Math.round(Math.log(Math.max(effScale, 1e-9)) * 6),\n      o.selectedLine, JSON.stringify(o.layerVis || {}), o.traced ? 1 : 0, o.tracedIncludeRapids ? 1 : 0,\n      o.hull ? o.hull.length : 0,\n      o.selectedPoint ? o.selectedPoint.x.toFixed(3) + ',' + o.selectedPoint.y.toFixed(3) : '-',\n      o.jobStart ? 1 : 0, o.jobEnd ? 1 : 0].join('|');\n    if (sig === this._sceneSig && !firstRender) {\n      this.overlay = o;\n      this.applyTransform();\n      return;\n    }\n    this._sceneSig = sig;\n    var multiTool = parsed.tools && parsed.tools.length > 0;\n    var toolColorFn = o.toolColor || function () { return 'var(--gn-feed)'; };\n\n    var groups = {};\n    var groupOrder = [];\n    function groupGet(key, color, dashed, opacity) {\n      var g = groups[key];\n      if (!g) {\n        g = groups[key] = { d: '', lx: NaN, ly: NaN, ex: NaN, ey: NaN, color: color, dashed: dashed, opacity: opacity };\n        groupOrder.push(key);\n      }\n      return g;\n    }\n    function emitPoint(g, x, y) {\n      g.ex = x; g.ey = y;\n      var dx = x - g.lx, dy = y - g.ly;\n      if (dx * dx + dy * dy >= tol2) {\n        g.d += 'L' + x.toFixed(DEC) + ',' + y.toFixed(DEC);\n        g.lx = x; g.ly = y;\n      }\n    }\n\n    var hlSeg = null;\n    var movesOverlay = parsed.maxS > 0 && layerOn('moves');\n    var segsAll = parsed.segments;\n    var boxArr = this._segBox;\n    for (var ci = 0; ci < segsAll.length; ci++) {\n      var seg = segsAll[ci];\n      var bo2 = ci * 4;\n      if (o.selectedLine === seg.line && layerOn('selline')) hlSeg = seg; // never culled\n      var typeOn;\n      if (seg.type === 'G0') typeOn = layerOn('rapid');\n      else if (multiTool) typeOn = layerOn('tool:' + (seg.tool === null || seg.tool === undefined ? '_' : seg.tool));\n      else typeOn = layerOn('feed');\n      if (!typeOn) continue;\n      if (cull && (boxArr[bo2 + 2] < cull.minX || boxArr[bo2] > cull.maxX || boxArr[bo2 + 3] < cull.minY || boxArr[bo2 + 1] > cull.maxY)) continue;\n      var traced = o.traced && (seg.type !== 'G0' || o.tracedIncludeRapids);\n      var g;\n      if (seg.type === 'G0') {\n        g = traced ? groupGet('r_t', 'var(--gn-traced)', true) : groupGet('r', 'var(--gn-rapid)', true);\n      } else if (traced) {\n        g = groupGet('f_t', 'var(--gn-traced)', false);\n      } else {\n        // Power (S) always quantizes into an opacity bucket. Depth (Z), when\n        // present, lightens/darkens each segment's OWN color (the tool hue\n        // in multi-tool files, teal otherwise) rather than substituting a\n        // separate hue — so which tool AND which pass are both visible at\n        // once instead of one overriding the other.\n        var sBucket = sOpacityBucket(parsed, seg.s || 0);\n        var opacity = sBucket / S_OPACITY_BUCKETS;\n        var tk = seg.tool === null || seg.tool === undefined ? '_' : seg.tool;\n        // toolHex is always a concrete, blend-able color (never the\n        // 'var(--gn-feed)' CSS reference) so depthShadedColor's arithmetic\n        // works the same regardless of tool count.\n        var toolHex = (multiTool && tk !== '_') ? toolColorFn(seg.tool) : '#4ec9b0';\n        var zOn = zShadeEnabled(parsed);\n        if (zOn) {\n          var zIdx = parsed.zLevels.indexOf(Number(seg.z1.toFixed(3)));\n          var key = 'f_' + (multiTool ? tk : 'x') + '_z' + zIdx + '_s' + sBucket;\n          g = groupGet(key, depthShadedColor(toolHex, parsed.zLevels, seg.z1), false, opacity);\n        } else if (multiTool) {\n          g = groupGet('f_' + tk + '_s' + sBucket, tk === '_' ? 'var(--gn-feed)' : toolHex, false, opacity);\n        } else {\n          g = groupGet('f_s' + sBucket, 'var(--gn-feed)', false, opacity);\n        }\n      }\n      // Moves overlay: with power shading active, low/zero-S moves render\n      // at near-zero opacity and the engraved areas fuse into an image —\n      // the individual toolpath lines vanish. This extra hairline pass\n      // draws EVERY visible move thin and faint ON TOP of the shading, so\n      // the graphic and the clickable moves coexist. Toggled by the\n      // \"Moves\" legend item; only built when the file has S words.\n      if (movesOverlay && seg.type !== 'G0') {\n        var mg = groupGet('mv', '#c8d2dc', false, 0.35);\n        if (mg.ex !== seg.x0 || mg.ey !== seg.y0) {\n          if (mg.d) mg.d += 'L' + mg.ex.toFixed(DEC) + ',' + mg.ey.toFixed(DEC);\n          mg.d += 'M' + seg.x0.toFixed(DEC) + ',' + seg.y0.toFixed(DEC);\n          mg.lx = seg.x0; mg.ly = seg.y0; mg.ex = seg.x0; mg.ey = seg.y0;\n        }\n        if (seg.points) {\n          for (var mp = 0; mp < seg.points.length; mp++) emitPoint(mg, seg.points[mp].x, seg.points[mp].y);\n        }\n        emitPoint(mg, seg.x1, seg.y1);\n      }\n      if (g.ex !== seg.x0 || g.ey !== seg.y0) {\n        // chain break: close the previous chain at its true endpoint, then move\n        if (g.d && (g.ex !== g.lx || g.ey !== g.ly)) g.d += 'L' + g.ex.toFixed(DEC) + ',' + g.ey.toFixed(DEC);\n        g.d += 'M' + seg.x0.toFixed(DEC) + ',' + seg.y0.toFixed(DEC);\n        g.lx = seg.x0; g.ly = seg.y0; g.ex = seg.x0; g.ey = seg.y0;\n      }\n      if (seg.points) {\n        for (var pi = 0; pi < seg.points.length; pi++) emitPoint(g, seg.points[pi].x, seg.points[pi].y);\n        emitPoint(g, seg.x1, seg.y1);\n      } else {\n        emitPoint(g, seg.x1, seg.y1);\n      }\n    }\n    // traced groups render first (underneath), then feeds, then rapids,\n    // then the moves hairline overlay on top of everything\n    groupOrder.sort(function (a, b) {\n      function rank(k) { return k === 'f_t' || k === 'r_t' ? 0 : (k === 'mv' ? 3 : (k.charAt(0) === 'f' ? 1 : 2)); }\n      return rank(a) - rank(b);\n    });\n    for (var gi = 0; gi < groupOrder.length; gi++) {\n      var gk = groups[groupOrder[gi]];\n      if (!gk.d) continue;\n      if (gk.ex !== gk.lx || gk.ey !== gk.ly) gk.d += 'L' + gk.ex.toFixed(DEC) + ',' + gk.ey.toFixed(DEC);\n      var opAttr = (gk.opacity !== undefined && gk.opacity < 1) ? ' stroke-opacity=\"' + gk.opacity.toFixed(3) + '\"' : '';\n      var swAttr = groupOrder[gi] === 'mv' ? '0.7' : '1.1';\n      parts.push('<path d=\"' + gk.d + '\" stroke=\"' + gk.color + '\" stroke-width=\"' + swAttr + '\" fill=\"none\" vector-effect=\"non-scaling-stroke\"' + (gk.dashed ? ' data-dash=\"1\"' : '') + opAttr + '/>');\n    }\n    if (hlSeg) {\n      // Selected segment on top, full detail: soft glow underlay + accent stroke.\n      var hpts = hlSeg.points ? [{ x: hlSeg.x0, y: hlSeg.y0 }].concat(hlSeg.points, [{ x: hlSeg.x1, y: hlSeg.y1 }]) : [{ x: hlSeg.x0, y: hlSeg.y0 }, { x: hlSeg.x1, y: hlSeg.y1 }];\n      var hlD = hpts.map(function (p, i2) { return (i2 === 0 ? 'M' : 'L') + p.x.toFixed(4) + ',' + p.y.toFixed(4); }).join('');\n      parts.push('<path d=\"' + hlD + '\" stroke=\"var(--gn-accent)\" stroke-width=\"8\" opacity=\"0.30\" fill=\"none\" vector-effect=\"non-scaling-stroke\"/>');\n      parts.push('<path d=\"' + hlD + '\" stroke=\"var(--gn-accent)\" stroke-width=\"2.5\" fill=\"none\" vector-effect=\"non-scaling-stroke\"/>');\n    }\n\n    if (o.hull && layerOn('contour')) {\n      var hd = o.hull.map(function (p, i) {\n        return (i === 0 ? 'M' : 'L') + p.x.toFixed(4) + ',' + p.y.toFixed(4);\n      }).join(' ') + ' Z';\n      // Bold stroke, no per-vertex dots: the outline reads as one clear\n      // shape distinct from toolpath lines. Vertex SNAPPING still works\n      // (right-click / long-press near the outline) — only the visual\n      // bullets are gone.\n      parts.push('<path d=\"' + hd + '\" stroke=\"var(--gn-hull)\" stroke-width=\"3.5\" fill=\"rgba(197,134,192,0.08)\" vector-effect=\"non-scaling-stroke\"/>');\n    }\n\n    if (o.jobStart && layerOn('jobstart')) {\n      parts.push('<circle cx=\"' + o.jobStart.x.toFixed(4) + '\" cy=\"' + o.jobStart.y.toFixed(4) +\n        '\" data-r=\"4.5\" r=\"1\" fill=\"var(--gn-jobstart)\" stroke=\"#fff\" stroke-width=\"1\" vector-effect=\"non-scaling-stroke\"/>');\n    }\n    if (o.jobEnd && layerOn('jobend')) {\n      parts.push('<circle cx=\"' + o.jobEnd.x.toFixed(4) + '\" cy=\"' + o.jobEnd.y.toFixed(4) +\n        '\" data-r=\"4.5\" r=\"1\" fill=\"var(--gn-danger)\" stroke=\"#fff\" stroke-width=\"1\" vector-effect=\"non-scaling-stroke\"/>');\n    }\n\n    if (o.selectedPoint && layerOn('selpoint')) {\n      // Bright ring + solid dot; classed so updateOverlayPoint can move\n      // them without a full re-render (the strobing fix).\n      parts.push('<circle class=\"gn-target-ring\" cx=\"' + o.selectedPoint.x.toFixed(4) + '\" cy=\"' + o.selectedPoint.y.toFixed(4) +\n        '\" data-r=\"11\" r=\"1\" fill=\"none\" stroke=\"var(--gn-select)\" stroke-width=\"2.5\" vector-effect=\"non-scaling-stroke\"/>');\n      parts.push('<circle class=\"gn-target-dot\" cx=\"' + o.selectedPoint.x.toFixed(4) + '\" cy=\"' + o.selectedPoint.y.toFixed(4) +\n        '\" data-r=\"4.5\" r=\"1\" fill=\"var(--gn-select)\" stroke=\"#000\" stroke-width=\"1\" vector-effect=\"non-scaling-stroke\"/>');\n    }\n\n    parts.push('<\/g>');\n    this.svg.innerHTML = parts.join('');\n    this._attrsDirty = true;\n\n    if (firstRender || (!this.userTransformed && !this._fitted)) {\n      // Defer one frame so the dialog's layout has settled and\n      // getBoundingClientRect reports the real size. _fitted guards the\n      // cull-refine render from re-fitting: fit -> scheduleCullRender ->\n      // render -> fit was an infinite rebuild loop that strobed the whole\n      // map on large files (each cycle rebuilt a multi-MB SVG, painting a\n      // blank frame while the new paths rasterized).\n      var self = this;\n      requestAnimationFrame(function () { self.fit(); });\n    } else {\n      this.applyTransform();\n    }\n  };\n\n  // ============================================================\n  // App state + wiring (single unified view as of v0.12)\n  // ============================================================\n  var gcodeText = null;\n  var parsed = null;\n  var selectedSegment = null;\n  var hull = null;\n  var appSettings = null;\n  var loadStatus = '';\n  // The yellow target marker always shows the CURRENT target: the creep\n  // position on the selected line, a contour vertex, or a snapped point\n  // from the context menu. \"Rapid to Point\" goes wherever it is.\n  var targetOverride = null;\n\n  // ---- Styled confirmation (ncSender-dialog look) ----\n  var confirmResolve = null;\n  function showConfirm(title, bodyHtml, okLabel) {\n    return new Promise(function (resolve) {\n      confirmResolve = resolve;\n      document.getElementById('gn-confirm-title').textContent = title;\n      document.getElementById('gn-confirm-body').innerHTML = bodyHtml;\n      document.getElementById('gn-confirm-ok').textContent = okLabel || 'Confirm';\n      document.getElementById('gn-confirm-overlay').style.display = 'flex';\n    });\n  }\n  function closeConfirm(result) {\n    document.getElementById('gn-confirm-overlay').style.display = 'none';\n    if (confirmResolve) { confirmResolve(result); confirmResolve = null; }\n  }\n  document.getElementById('gn-confirm-ok').addEventListener('click', function () { closeConfirm(true); });\n  document.getElementById('gn-confirm-abort').addEventListener('click', function () { closeConfirm(false); });\n  document.getElementById('gn-confirm-overlay').addEventListener('click', function (e) {\n    if (e.target === this) closeConfirm(false);\n  });\n\n  // First-motion gate: the confirmation card appears only before the FIRST\n  // motion command of the session (trace, rapid to point, retract);\n  // afterwards buttons act immediately.\n  var motionWarned = false;\n  function confirmMotion(title, bodyHtml, okLabel) {\n    if (motionWarned) return Promise.resolve(true);\n    var note = '<div class=\"gn-note\">This confirmation appears only before your first motion command \\u2014 after this, these buttons act immediately.<\/div>';\n    return showConfirm(title, bodyHtml + note, okLabel).then(function (ok) {\n      if (ok) motionWarned = true;\n      return ok;\n    });\n  }\n\n  // ---- Context menu ----\n  var ctxMenuEl = document.getElementById('gn-ctx-menu');\n\n  function hideCtxMenu() { ctxMenuEl.style.display = 'none'; }\n  document.addEventListener('mousedown', function (e) {\n    if (!ctxMenuEl.contains(e.target)) hideCtxMenu();\n  }, true);\n  document.addEventListener('touchstart', function (e) {\n    if (!ctxMenuEl.contains(e.target)) hideCtxMenu();\n  }, true);\n  document.addEventListener('keydown', function (e) { if (e.key === 'Escape') hideCtxMenu(); });\n  window.addEventListener('wheel', hideCtxMenu, true);\n\n  function showCtxMenu(clientX, clientY, world, items) {\n    ctxMenuEl.innerHTML = '';\n    var coords = document.createElement('div');\n    coords.className = 'gn-ctx-coords';\n    coords.textContent = 'X' + world.x.toFixed(3) + '  Y' + world.y.toFixed(3);\n    ctxMenuEl.appendChild(coords);\n    items.forEach(function (item) {\n      var el = document.createElement('div');\n      el.className = 'gn-ctx-item';\n      el.textContent = item.label;\n      el.addEventListener('click', function () {\n        hideCtxMenu();\n        item.action();\n      });\n      ctxMenuEl.appendChild(el);\n    });\n    ctxMenuEl.style.display = 'block';\n    var mw = ctxMenuEl.offsetWidth, mh = ctxMenuEl.offsetHeight;\n    var x = Math.min(clientX, window.innerWidth - mw - 8);\n    var y = Math.min(clientY, window.innerHeight - mh - 8);\n    ctxMenuEl.style.left = x + 'px';\n    ctxMenuEl.style.top = y + 'px';\n  }\n\n  // ---- Viewer ----\n  var viewer = new Viewer(document.getElementById('gn-line-svg'), function (world, target) {\n    if (!parsed) return;\n    // (Vertex dots removed in v0.21 — vertex targeting now goes through the\n    // right-click / long-press snap, which still snaps to hull vertices.)\n    var hit = findNearestSegment(viewParsed(), world.x, world.y, visibleSegFilter);\n    if (!hit.segment) return;\n    if (hit.dist > viewer.pxToWorld(14)) return;\n    selectLine(hit.segment);\n  });\n\n  document.getElementById('gn-line-fit').addEventListener('click', function () { viewer.fit(); });\n\n  function renderMain() {\n    if (!parsed) return;\n    var vp = viewParsed();\n    var selPoint = targetOverride ||\n      (selectedSegment ? creepPoint(selectedSegment, creepFraction()) : null);\n    var first = vp.segments[0] || null;\n    var last = vp.segments[vp.segments.length - 1] || null;\n    viewer.render(vp, {\n      selectedLine: selectedSegment ? selectedSegment.line : null,\n      selectedPoint: selPoint,\n      hull: viewMode === 'rotary' ? null : hull,\n      jobStart: first ? { x: first.x0, y: first.y0 } : null,\n      jobEnd: last ? { x: last.x1, y: last.y1 } : null,\n      layerVis: layerVis,\n      toolColor: toolColor\n    });\n    if (typeof syncSpindleMarker === 'function') syncSpindleMarker();\n    updateLineAnalysis();\n  }\n\n  function selectLine(segment) {\n    selectedSegment = segment;\n    document.getElementById('gn-line-input').value = segment.line;\n    document.getElementById('gn-creep-slider').value = 0;\n    targetOverride = null;\n    renderMain();\n  }\n\n  function creepFraction() {\n    return parseFloat(document.getElementById('gn-creep-slider').value) / 100;\n  }\n\n  function creepPoint(seg, t) {\n    if (seg.points) {\n      var pts = [{ x: seg.x0, y: seg.y0 }].concat(seg.points);\n      var idx = Math.min(pts.length - 1, Math.round(t * (pts.length - 1)));\n      return pts[idx];\n    }\n    return { x: seg.x0 + (seg.x1 - seg.x0) * t, y: seg.y0 + (seg.y1 - seg.y0) * t };\n  }\n\n  // Fraction (0..1) along a segment's polyline nearest to a world point —\n  // by arc length, so arcs behave the same as straight lines.\n  function fractionAlongSegment(seg, pt) {\n    var pts = seg.points\n      ? [{ x: seg.x0, y: seg.y0 }].concat(seg.points)\n      : [{ x: seg.x0, y: seg.y0 }, { x: seg.x1, y: seg.y1 }];\n    var total = 0, lens = [];\n    for (var i = 0; i < pts.length - 1; i++) {\n      var L = Math.hypot(pts[i + 1].x - pts[i].x, pts[i + 1].y - pts[i].y);\n      lens.push(L);\n      total += L;\n    }\n    if (total === 0) return 0;\n    var bestD = Infinity, bestLen = 0, acc = 0;\n    for (var j = 0; j < pts.length - 1; j++) {\n      var ax = pts[j].x, ay = pts[j].y, bx = pts[j + 1].x, by = pts[j + 1].y;\n      var dx = bx - ax, dy = by - ay;\n      var len2 = dx * dx + dy * dy;\n      var t = len2 === 0 ? 0 : ((pt.x - ax) * dx + (pt.y - ay) * dy) / len2;\n      t = Math.max(0, Math.min(1, t));\n      var d = Math.hypot(pt.x - (ax + t * dx), pt.y - (ay + t * dy));\n      if (d < bestD) { bestD = d; bestLen = acc + t * lens[j]; }\n      acc += lens[j];\n    }\n    return bestLen / total;\n  }\n\n  // ---- Point targeting (right-click, hold-left-click, touch long-press) ----\n  // Snap the point (hull vertices first, then toolpath), then: if it lies on\n  // a motion segment, SELECT that segment and sync the creep slider to the\n  // point's fraction along it — so sliding afterwards continues from the\n  // point instead of jumping back to the line start. Free-space points\n  // stay as a plain target override.\n  function visibleSegFilter(s) {\n    if (s.type === 'G0') return layerVis.rapid;\n    if (parsed && parsed.tools && parsed.tools.length > 0) {\n      var key = 'tool:' + (s.tool === null || s.tool === undefined ? '_' : s.tool);\n      return layerVis[key] !== false;\n    }\n    return layerVis.feed;\n  }\n\n  function setPointTarget(world) {\n    var polys = [];\n    var hullPolyIndex = -1;\n    if (hull && hull.length >= 3 && layerVis.contour) {\n      hullPolyIndex = 0;\n      polys.push(hull.concat([hull[0]]));\n    }\n    parsed.segments.forEach(function (s) {\n      if (!visibleSegFilter(s)) return;\n      polys.push(s.points ? [{ x: s.x0, y: s.y0 }].concat(s.points) : [{ x: s.x0, y: s.y0 }, { x: s.x1, y: s.y1 }]);\n    });\n    var snap = snapToPolylines(world, polys, viewer.pxToWorld(14), viewer.pxToWorld(20));\n    var snapVertexNo = -1;\n    if (snap.kind === 'vertex' && snap.polyIndex === hullPolyIndex && hull) {\n      snapVertexNo = snap.vIndex === hull.length ? 0 : snap.vIndex;\n    }\n\n    var pt = { x: snap.x, y: snap.y };\n    var hit = findNearestSegment(viewParsed(), pt.x, pt.y, visibleSegFilter);\n    if (hit.segment && hit.dist <= viewer.pxToWorld(3)) {\n      // Point is on the toolpath: select its segment and sync the slider.\n      selectedSegment = hit.segment;\n      document.getElementById('gn-line-input').value = hit.segment.line;\n      var f = fractionAlongSegment(hit.segment, pt);\n      document.getElementById('gn-creep-slider').value = Math.round(f * 100);\n    }\n    targetOverride = pt; // exact snapped point (slider is the rounded echo)\n    renderMain();\n    snap.vertexNo = snapVertexNo;\n    return snap;\n  }\n\n  viewer.onContext = function (world, cx, cy) {\n    var snap = setPointTarget(world);\n    var items = [];\n    var rapidLabel = snap.vertexNo >= 0 ? 'Rapid to vertex #' + (snap.vertexNo + 1)\n      : snap.kind === 'vertex' ? 'Rapid to vertex (snapped)'\n      : snap.kind === 'edge' ? 'Rapid to edge point (snapped)'\n      : 'Rapid to this point';\n    items.push({ label: rapidLabel, action: function () {\n      confirmMotion('Rapid to Point',\n        'The machine will move to <b>X' + snap.x.toFixed(3) + ' Y' + snap.y.toFixed(3) + '<\/b>' +\n        (document.getElementById('gn-raisez').checked ? ', raising Z to safe height first.' : ' <b>without raising Z first<\/b>.'),\n        'Move')\n        .then(function (ok) {\n          if (!ok) return;\n          return sendCommand(rapidToPointCmd({ x: snap.x, y: snap.y }), rapidLabel + ' X' + snap.x.toFixed(3) + ' Y' + snap.y.toFixed(3) + ' (G-code Navigator)');\n        })\n        .catch(function (err) { document.getElementById('gn-line-error').textContent = err.message; });\n    }});\n    if (selectedSegment) {\n      items.push({ label: 'Start from line ' + selectedSegment.line + '\\u2026', action: function () {\n        sflOpen();\n      }});\n    }\n    items.push({ label: 'Fit view', action: function () { viewer.fit(); } });\n    showCtxMenu(cx, cy, { x: snap.x, y: snap.y }, items);\n  };\n\n  // Hold-left-click: set the point, no menu (mouse twin of touch long-press).\n  viewer.onLongPress = function (world) {\n    setPointTarget(world);\n  };\n\n  // Dragging the target marker creeps along the selected segment — same as\n  // the slider, mouse or touch. Uses the surgical marker update, not a full\n  // re-render, so there is no flashing.\n  viewer.hitTarget = function (world) {\n    if (!layerVis.selpoint) return false;\n    if (!parsed || !selectedSegment) return false;\n    var pt = targetOverride || creepPoint(selectedSegment, creepFraction());\n    if (!pt) return false;\n    return Math.hypot(world.x - pt.x, world.y - pt.y) <= viewer.pxToWorld(16);\n  };\n  viewer.onTargetDrag = function (world) {\n    if (!selectedSegment) return;\n    var f = fractionAlongSegment(selectedSegment, world);\n    document.getElementById('gn-creep-slider').value = Math.round(f * 100);\n    var pt = creepPoint(selectedSegment, f);\n    targetOverride = pt;\n    viewer.updateOverlayPoint(layerVis.selpoint ? pt : null);\n    updateLineAnalysis();\n  };\n\n  // ---- Load ----\n  var AUTO_CONTOUR_MAX_SEGMENTS = 20000;\n  var contourDeferred = false;\n\n  function loadGcodeAndSettings() {\n    setStatus('Loading current G-code file and settings\\u2026');\n    return Promise.all([getCurrentGcodeText(), getSettings().catch(function () { return {}; })])\n      .then(function (results) {\n        gcodeText = results[0];\n        appSettings = results[1] || {};\n        return parseGcodeAsync(gcodeText, function (done, total) {\n          if (total > 200000) {\n            setStatus('Parsing ' + done.toLocaleString() + ' / ' + total.toLocaleString() + ' lines (' + Math.round(done / total * 100) + '%)\\u2026');\n          }\n        });\n      })\n      .then(function (result) {\n        parsed = result;\n        fileUnitsScale = parsed.units === 'G20' ? 25.4 : 1;\n        rotaryParsedCache = null;\n        var tabsEl = document.getElementById('gn-view-tabs');\n        tabsEl.style.display = parsed.hasRotary ? 'flex' : 'none';\n        if (parsed.hasRotary && viewMode !== 'rotary') {\n          // rotary files render as a flat line in XY — open unwrapped\n          setTimeout(function () { setViewMode('rotary'); }, 0);\n        } else if (!parsed.hasRotary && viewMode === 'rotary') {\n          setViewMode('xy');\n        }\n        loadStatus = 'Loaded ' + parsed.totalLines + ' lines, ' + parsed.segments.length + ' motion segments. Safe Z Retract Height: ' +\n          (appSettings.safeZHeight !== undefined ? appSettings.safeZHeight : -5) + ' mm (app setting).';\n        rebuildLegend();\n        initZFilter();\n        // Select the first motion segment so the map highlight and LINE\n        // ANALYSIS panel are populated immediately at open.\n        if (parsed.segments.length) {\n          selectLine(parsed.segments[0]);\n        } else {\n          renderMain();\n        }\n        // On big files the contour is NOT computed automatically: a\n        // \"Compute Contour Outline\" affordance appears in the contour box\n        // instead, and computation runs as a cancellable background job\n        // with a progress bar. Small files start the job automatically —\n        // same non-blocking path, so the map never flashes mid-compute.\n        hull = null;\n        if (parsed.segments.length > AUTO_CONTOUR_MAX_SEGMENTS) {\n          contourDeferred = true;\n          setContourUI('pending');\n          setStatus(loadStatus);\n        } else if (parsed.hasRotary) {\n          // rotary files collapse to a line in XY — a contour is meaningless\n          // and the machinery is hidden in this view; don't compute one\n          contourDeferred = false;\n          setStatus(loadStatus);\n        } else {\n          contourDeferred = false;\n          setStatus(loadStatus);\n          startContourJob();\n        }\n      })\n      .catch(function (err) {\n        setStatus(err.message || String(err), true);\n      });\n  }\n\n  function ensureContour(cb) {\n    if (hull || !parsed) { if (cb) cb(); return; }\n    startContourJob(cb);\n  }\n\n  // ---- Target line: auto-analyze ----\n  document.getElementById('gn-preset-z-toggle').addEventListener('change', function () {\n    document.getElementById('gn-preset-z-field').style.display = this.checked ? '' : 'none';\n  });\n\n  function currentPresetZ() {\n    var enabled = document.getElementById('gn-preset-z-toggle').checked;\n    if (!enabled) return null;\n    var v = parseFloat(document.getElementById('gn-preset-z-input').value);\n    return isNaN(v) ? null : v;\n  }\n\n  function safeZValue() {\n    var preset = currentPresetZ();\n    if (preset !== null) return preset;\n    return (appSettings && appSettings.safeZHeight !== undefined) ? appSettings.safeZHeight : -5;\n  }\n\n  // Coordinates we send come straight from the loaded file, so motion\n  // commands carry the file's own units mode (G20/G21, when declared) plus\n  // G90 absolute. Safe-Z retracts use G21 explicitly because ncSender's\n  // safeZHeight app setting is always mm.\n  function motionPrefix() {\n    var u = (parsed && parsed.units) ? parsed.units + ' ' : '';\n    return u + 'G90 ';\n  }\n\n  // LINE ANALYSIS (client-side, per the mockup): raw G-code of the selected\n  // line, start XY, the currently targeted point XY (live — follows the\n  // creep slider, a targeted vertex, or a snapped map-menu point), end XY.\n  function escHtml(s) {\n    return String(s).replace(/&/g, '&amp;').replace(/<\/g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;');\n  }\n\n  function copyChip(text) {\n    return '<span class=\"gn-copy\" data-copy=\"' + escHtml(text) + '\">' + escHtml(text) + '<\/span>';\n  }\n\n  function updateLineAnalysis() {\n    var box = document.getElementById('gn-analysis-box');\n    if (!selectedSegment || !gcodeText) { box.style.display = 'none'; return; }\n    box.style.display = '';\n    var raw = (gcodeText.split('\\n')[selectedSegment.line - 1] || '').trim();\n    var pt = targetOverride || creepPoint(selectedSegment, creepFraction());\n    document.getElementById('gn-an-gcode').innerHTML = 'G-code: ' + (raw ? copyChip(raw) : '(line ' + selectedSegment.line + ')');\n    var sSeg = selectedSegment;\n    // Z on every row; flag it when this line never wrote Z (modal carry\n    // from an earlier line - some CAM lifts Z on its own line, then moves XY)\n    var zExplicit = /(^|[^A-Za-z])[Zz][+\\-.0-9]/.test(raw);\n    var zNote = zExplicit ? '' :\n      ' <span style=\"opacity:0.6;font-size:10.5px;\" title=\"This line does not set Z - the value is carried from an earlier line\">(Z inferred)<\/span>';\n    var t = targetOverride ? null : creepFraction();\n    var ptZ = t === null ? sSeg.z1 : sSeg.z0 + (sSeg.z1 - sSeg.z0) * t;\n    if (sSeg.aSrc) {\n      document.getElementById('gn-an-start').innerHTML = 'Start: ' + copyChip('X' + sSeg.aSrc.x0.toFixed(3) + ' A' + sSeg.aSrc.a0.toFixed(3) + ' Z' + sSeg.aSrc.z0.toFixed(3));\n      document.getElementById('gn-an-point').innerHTML = 'Point: ' + copyChip('X' + pt.x.toFixed(3) + ' A' + (pt.y / (rotaryK || 1)).toFixed(3) + ' Z' + ptZ.toFixed(3));\n      document.getElementById('gn-an-end').innerHTML = 'End: ' + copyChip('X' + sSeg.aSrc.x1.toFixed(3) + ' A' + sSeg.aSrc.a1.toFixed(3) + ' Z' + sSeg.aSrc.z1.toFixed(3)) + zNote;\n    } else {\n      document.getElementById('gn-an-start').innerHTML = 'Start: ' + copyChip('X' + sSeg.x0.toFixed(3) + ' Y' + sSeg.y0.toFixed(3) + ' Z' + sSeg.z0.toFixed(3));\n      document.getElementById('gn-an-point').innerHTML = 'Point: ' + copyChip('X' + pt.x.toFixed(3) + ' Y' + pt.y.toFixed(3) + ' Z' + ptZ.toFixed(3));\n      document.getElementById('gn-an-end').innerHTML = 'End: ' + copyChip('X' + sSeg.x1.toFixed(3) + ' Y' + sSeg.y1.toFixed(3) + ' Z' + sSeg.z1.toFixed(3)) + zNote;\n    }\n  }\n\n  // Copy helper that also works on insecure origins (http://ncsender:8090),\n  // where navigator.clipboard is unavailable.\n  function copyText(text) {\n    if (navigator.clipboard && window.isSecureContext) {\n      return navigator.clipboard.writeText(text);\n    }\n    return new Promise(function (resolve, reject) {\n      var ta = document.createElement('textarea');\n      ta.value = text;\n      ta.style.position = 'fixed';\n      ta.style.opacity = '0';\n      document.body.appendChild(ta);\n      ta.select();\n      try {\n        document.execCommand('copy') ? resolve() : reject(new Error('copy failed'));\n      } catch (e) { reject(e); }\n      document.body.removeChild(ta);\n    });\n  }\n\n  document.getElementById('gn-analysis-box').addEventListener('click', function (e) {\n    var chip = e.target.closest ? e.target.closest('.gn-copy') : null;\n    if (!chip) return;\n    var text = chip.getAttribute('data-copy');\n    copyText(text).then(function () {\n      chip.classList.add('copied');\n      var prev = chip.textContent;\n      chip.textContent = 'Copied!';\n      setTimeout(function () {\n        chip.classList.remove('copied');\n        // Point row may have been re-rendered meanwhile; only restore if\n        // this chip is still in the document with our placeholder text.\n        if (chip.isConnected && chip.textContent === 'Copied!') chip.textContent = prev;\n      }, 900);\n    }).catch(function () { /* leave silently; selection still possible */ });\n  });\n\n  // Selecting by line number: find the motion segment at (or nearest\n  // before) that line and select it on the map.\n  function selectByLineNumber() {\n    var lineErr = document.getElementById('gn-line-error');\n    lineErr.textContent = '';\n    var lineNo = parseInt(document.getElementById('gn-line-input').value, 10);\n    if (!lineNo || lineNo < 1 || !parsed) return;\n    var seg = findSegmentForLine(viewParsed(), lineNo);\n    if (!seg) {\n      lineErr.textContent = 'No motion segment at or before line ' + lineNo + '.';\n      return;\n    }\n    selectedSegment = seg;\n    document.getElementById('gn-creep-slider').value = 0;\n    targetOverride = null;\n    renderMain();\n  }\n\n  // ==== Start From Line (ncSender's native resume engine) ====\n  // Two-step for safety: analyze-line first (reconstructs modal state at\n  // the line, adjusts mid-arc picks to the arc start, flags tool\n  // mismatches, and returns the exact resume sequence), shown for review;\n  // start-from-line runs only on explicit confirm. Server requires Idle.\n  var sflAnalysis = null;\n\n  function sflHide() {\n    sflAnalysis = null;\n    document.getElementById('gn-sfl-panel').style.display = 'none';\n  }\n\n  function sflOpen() {\n    var errEl = document.getElementById('gn-sfl-error');\n    errEl.textContent = '';\n    if (!selectedSegment) { errEl.textContent = 'Select a line first (click the map or type a line number).'; return; }\n    var lineNo = selectedSegment.line;\n    api('/api/gcode-job/analyze-line', {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ lineNumber: lineNo })\n    }).then(function (res) {\n      sflAnalysis = res;\n      var panel = document.getElementById('gn-sfl-panel');\n      document.getElementById('gn-sfl-title').textContent =\n        'RESUME FROM LINE ' + res.lineNumber + (res.lineAdjusted ? ' (adjusted from ' + lineNo + ' \\u2014 arc start)' : '');\n      var warns = [];\n      (res.warnings || []).forEach(function (w) { warns.push(String(w).replace(/<[^>]+>/g, '')); });\n      if (parsed && parsed.hasRotary) {\n        warns.push('Rotary file: the resume sequence pre-positions X/Y but NOT the A axis \\u2014 A will rotate into position on the first resumed move.');\n      }\n      document.getElementById('gn-sfl-warnings').textContent = warns.join(' ');\n      var toolWarn = document.getElementById('gn-sfl-toolwarn');\n      if (res.toolMismatch) {\n        toolWarn.style.display = '';\n        toolWarn.textContent = 'Tool mismatch: line needs T' + res.targetTool + ' but T' + res.currentTool +\n          ' is loaded. The resume sequence includes the M6 tool change.';\n      } else {\n        toolWarn.style.display = 'none';\n      }\n      document.getElementById('gn-sfl-seq').textContent = (res.resumeSequence || []).join('\\n');\n      panel.style.display = '';\n      // opened from the map context menu, the panel may be scrolled away\n      panel.scrollIntoView({ block: 'nearest', behavior: 'smooth' });\n    }).catch(function (e) {\n      errEl.textContent = e.message || String(e);\n    });\n  }\n  document.getElementById('gn-sfl-btn').addEventListener('click', sflOpen);\n\n  document.getElementById('gn-sfl-cancel').addEventListener('click', sflHide);\n\n  document.getElementById('gn-sfl-go').addEventListener('click', function () {\n    var errEl = document.getElementById('gn-sfl-error');\n    errEl.textContent = '';\n    if (!sflAnalysis) { sflHide(); return; }\n    var goBtn = document.getElementById('gn-sfl-go');\n    goBtn.disabled = true;\n    goBtn.textContent = 'Starting\\u2026';\n    api('/api/gcode-job/start-from-line', {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        startLine: sflAnalysis.lineNumber,\n        skipToolCheck: false,\n        spindleDelaySec: parseFloat(document.getElementById('gn-sfl-delay').value) || 0,\n        approachHeight: parseFloat(document.getElementById('gn-sfl-approach').value) || 5,\n        plungeFeedRate: parseFloat(document.getElementById('gn-sfl-plunge').value) || 500\n      })\n    }).then(function (res) {\n      goBtn.disabled = false;\n      goBtn.textContent = 'Confirm & Start';\n      if (res && res.success === false) throw new Error(res.error || 'Start from line failed');\n      sflHide();\n      var lineErr = document.getElementById('gn-line-error');\n      lineErr.style.color = '#7ec98f';\n      lineErr.textContent = (res && res.message) || 'Job started from line.';\n      setTimeout(function () { lineErr.textContent = ''; lineErr.style.color = ''; }, 5000);\n    }).catch(function (e) {\n      goBtn.disabled = false;\n      goBtn.textContent = 'Confirm & Start';\n      errEl.textContent = e.message || String(e);\n    });\n  });\n\n  var selectDebounce = null;\n  document.getElementById('gn-line-input').addEventListener('input', function () {\n    if (selectDebounce) clearTimeout(selectDebounce);\n    selectDebounce = setTimeout(selectByLineNumber, 450);\n  });\n  document.getElementById('gn-line-input').addEventListener('change', function () {\n    if (selectDebounce) { clearTimeout(selectDebounce); selectDebounce = null; }\n    selectByLineNumber();\n  });\n\n  document.getElementById('gn-creep-slider').addEventListener('input', function () {\n    if (!selectedSegment) return;\n    targetOverride = null;\n    var pt = creepPoint(selectedSegment, creepFraction());\n    viewer.updateOverlayPoint(pt);\n    updateLineAnalysis();\n  });\n\n  // ---- Motion buttons ----\n  document.getElementById('gn-retract-btn').addEventListener('click', function () {\n    var z = Number(safeZValue());\n    confirmMotion('Retract to Safe Z',\n      'The machine will raise Z to <b>' + z.toFixed(3) + ' mm<\/b> (machine coordinates).', 'Retract')\n      .then(function (ok) {\n        if (!ok) return;\n        return sendCommand('G21 G90 G53 G0 Z' + z.toFixed(3), 'Retract to Z' + z + ' (G-code Navigator)');\n      })\n      .catch(function (err) { document.getElementById('gn-line-error').textContent = err.message; });\n  });\n\n  // Builds the (optionally Z-raised) rapid command to a world point.\n  function rapidToPointCmd(pt) {\n    var cmds = [];\n    if (document.getElementById('gn-raisez').checked) {\n      cmds.push('G21 G90 G53 G0 Z' + Number(safeZValue()).toFixed(3));\n    }\n    if (viewMode === 'rotary') {\n      // unwrapped view: vertical axis is A (view-units = rotaryK per degree)\n      cmds.push(motionPrefix() + 'G0 X' + pt.x.toFixed(3) + ' A' + (pt.y / (rotaryK || 1)).toFixed(3));\n    } else {\n      cmds.push(motionPrefix() + 'G0 X' + pt.x.toFixed(3) + ' Y' + pt.y.toFixed(3));\n    }\n    return cmds.join('\\n');\n  }\n\n  document.getElementById('gn-rapid-point-btn').addEventListener('click', function () {\n    var lineErr = document.getElementById('gn-line-error');\n    lineErr.textContent = '';\n    var pt = targetOverride || (selectedSegment ? creepPoint(selectedSegment, creepFraction()) : null);\n    if (!pt) { lineErr.textContent = 'No target: select a line, move the creep slider, or pick a point from the map menu.'; return; }\n    confirmMotion('Rapid to Point',\n      'The machine will move to <b>X' + pt.x.toFixed(3) + ' Y' + pt.y.toFixed(3) + '<\/b>' +\n      (document.getElementById('gn-raisez').checked ? ', raising Z to safe height first.' : ' <b>without raising Z first<\/b>.'),\n      'Move')\n      .then(function (ok) {\n        if (!ok) return;\n        return sendCommand(rapidToPointCmd(pt), 'Rapid to point X' + pt.x.toFixed(3) + ' Y' + pt.y.toFixed(3) + ' (G-code Navigator)');\n      })\n      .catch(function (err) { lineErr.textContent = err.message; });\n  });\n\n  function fmt(v) { return (v === undefined || v === null) ? '?' : Number(v).toFixed(3); }\n\n  // ---- Contour ----\n  // ==== Contour computation as a cancellable background job ====\n  // The trace pipeline runs in a Web Worker assembled at runtime from the\n  // real function sources (no duplicated code), so the UI never blocks and\n  // never repaints mid-computation — the map redraws exactly once, when\n  // the hull arrives. Cancel = worker.terminate(), which is instantaneous\n  // and total. If the host CSP blocks blob workers, a synchronous fallback\n  // runs on the next tick with the same UI (minus mid-stage cancel).\n  var contourJob = null;\n  var contourWorkerURL = null;\n  var CONTOUR_STAGES = { raster: [15, 'Rasterizing toolpath\\u2026'], bridge: [40, 'Connecting parts\\u2026'], trace: [60, 'Tracing silhouette\\u2026'], snap: [80, 'Snapping to geometry\\u2026'], finish: [92, 'Finishing\\u2026'] };\n\n  function setContourUI(state, pct, label) {\n    var pending = document.getElementById('gn-contour-pending');\n    var working = document.getElementById('gn-contour-working');\n    pending.style.display = state === 'pending' ? '' : 'none';\n    working.style.display = state === 'working' ? '' : 'none';\n    if (state === 'working') {\n      document.getElementById('gn-contour-bar').style.width = (pct || 0) + '%';\n      document.getElementById('gn-contour-stage').textContent = label || 'Working\\u2026';\n    }\n  }\n\n  function buildContourWorkerURL() {\n    if (contourWorkerURL) return contourWorkerURL;\n    var fns = [pointSegDist, convexHull, simplifyHull, fastCollinearReduce, traceOuterContour, autoTraceContour];\n    var src = fns.map(function (f) { return f.toString(); }).join('\\n') +\n      '\\nself.onmessage = function (ev) {' +\n      '\\n  var d = ev.data;' +\n      '\\n  var polys = [];' +\n      '\\n  var off = d.polyOffsets, fl = d.polyCoords;' +\n      '\\n  for (var i = 0; i + 1 < off.length; i++) {' +\n      '\\n    var poly = [];' +\n      '\\n    for (var k = off[i]; k < off[i + 1]; k += 2) poly.push({ x: fl[k], y: fl[k + 1] });' +\n      '\\n    polys.push(poly);' +\n      '\\n  }' +\n      '\\n  var pts = [];' +\n      '\\n  for (var p = 0; p + 1 < d.points.length; p += 2) pts.push({ x: d.points[p], y: d.points[p + 1] });' +\n      '\\n  var dens = { points: pts, step: d.step, polys: polys, mmScale: d.mmScale || 1 };' +\n      '\\n  var res = autoTraceContour(dens, d.tightness, function (stage) { self.postMessage({ type: \"progress\", stage: stage }); });' +\n      '\\n  var h = res.hull || [];' +\n      '\\n  var flat = new Float64Array(h.length * 2);' +\n      '\\n  for (var q = 0; q < h.length; q++) { flat[q * 2] = h[q].x; flat[q * 2 + 1] = h[q].y; }' +\n      '\\n  self.postMessage({ type: \"done\", hull: flat.buffer, parts: res.parts, bridges: res.bridges, fallback: res.fallback }, [flat.buffer]);' +\n      '\\n};';\n    contourWorkerURL = URL.createObjectURL(new Blob([src], { type: 'application/javascript' }));\n    return contourWorkerURL;\n  }\n\n  function cancelContourJob(silent) {\n    if (!contourJob) return;\n    if (contourJob.worker) contourJob.worker.terminate();\n    if (contourJob.timer) clearTimeout(contourJob.timer);\n    contourJob = null;\n    setContourUI(hull ? 'done' : 'pending');\n    if (!silent) setStatus(loadStatus + ' Contour computation cancelled.');\n  }\n\n  function finishContourJob(newHull, meta, onDone) {\n    contourJob = null;\n    contourDeferred = false;\n    hull = newHull;\n    setContourUI('done');\n    if (!hull || hull.length < 3) {\n      document.getElementById('gn-trace-error').textContent = 'Contour trace produced no usable outline.';\n      hull = null;\n    } else if (meta.fallback) {\n      setStatus(loadStatus + ' Contour: trace failed sanity checks — showing the convex hull of everything.');\n    } else if (meta.bridges > 0) {\n      setStatus(loadStatus + ' Contour: ' + hull.length + ' vertices; ' + meta.parts + ' separate parts connected by ' + meta.bridges + ' bridges at their closest points.');\n    } else {\n      setStatus(loadStatus + ' Contour: ' + hull.length + ' vertices.');\n    }\n    renderMain(); // the single post-computation redraw\n    if (onDone && hull) onDone();\n  }\n\n  function startContourJob(onDone) {\n    if (!parsed) return;\n    cancelContourJob(true);\n    var errEl = document.getElementById('gn-trace-error');\n    errEl.textContent = '';\n    setContourUI('working', 4, 'Sampling toolpath\\u2026');\n    contourJob = { worker: null, timer: null };\n    // Yield one tick so the progress UI paints before the densify pass.\n    contourJob.timer = setTimeout(function () {\n      if (!contourJob) return;\n      contourJob.timer = null;\n      var includeRapids = document.getElementById('gn-include-rapids').checked;\n      // the outline shrink-wraps what you SEE: Z filter + layer toggles\n      var src = contourSourceSegments();\n      var dens = densifySegments(src.segments, includeRapids, src.bounds, parsed.units);\n      if (dens.points.length < 3) {\n        contourJob = null;\n        setContourUI('pending');\n        errEl.textContent = 'Not enough geometry to compute a contour (try enabling rapid moves).';\n        return;\n      }\n      var tightness = parseInt(document.getElementById('gn-tightness').value, 10);\n      if (isNaN(tightness)) tightness = 12;\n\n      function runSyncFallback() {\n        setContourUI('working', 30, 'Computing (worker unavailable)\\u2026');\n        setTimeout(function () {\n          if (!contourJob) return;\n          var res = autoTraceContour(dens, tightness);\n          var h = res.hull;\n          if (!h || h.length < 3) { h = convexHull(dens.points); res.fallback = true; }\n          finishContourJob(h, res, onDone);\n        }, 30);\n      }\n\n      try {\n        var w = new Worker(buildContourWorkerURL());\n        contourJob.worker = w;\n        w.onmessage = function (ev) {\n          if (!contourJob || contourJob.worker !== w) return;\n          var msg = ev.data;\n          if (msg.type === 'progress') {\n            var st = CONTOUR_STAGES[msg.stage];\n            if (st) setContourUI('working', st[0], st[1]);\n          } else if (msg.type === 'done') {\n            w.terminate();\n            var flat = new Float64Array(msg.hull);\n            var h = [];\n            for (var i = 0; i + 1 < flat.length; i += 2) h.push({ x: flat[i], y: flat[i + 1] });\n            if (h.length < 3) { h = convexHull(dens.points); msg.fallback = true; }\n            finishContourJob(h, msg, onDone);\n          }\n        };\n        w.onerror = function () {\n          if (!contourJob || contourJob.worker !== w) return;\n          w.terminate();\n          contourJob.worker = null;\n          runSyncFallback();\n        };\n        // Pack the densified geometry into transferable flat buffers —\n        // zero-copy handoff even for hundreds of thousands of polyline points.\n        var total = 0;\n        for (var pi = 0; pi < dens.polys.length; pi++) total += dens.polys[pi].length;\n        var polyCoords = new Float64Array(total * 2);\n        var polyOffsets = new Int32Array(dens.polys.length + 1);\n        var wIdx = 0;\n        for (var pj = 0; pj < dens.polys.length; pj++) {\n          polyOffsets[pj] = wIdx;\n          var pl = dens.polys[pj];\n          for (var pk = 0; pk < pl.length; pk++) { polyCoords[wIdx++] = pl[pk].x; polyCoords[wIdx++] = pl[pk].y; }\n        }\n        polyOffsets[dens.polys.length] = wIdx;\n        var ptsFlat = new Float64Array(dens.points.length * 2);\n        for (var pq = 0; pq < dens.points.length; pq++) { ptsFlat[pq * 2] = dens.points[pq].x; ptsFlat[pq * 2 + 1] = dens.points[pq].y; }\n        w.postMessage(\n          { points: ptsFlat, step: dens.step, mmScale: dens.mmScale || 1, polyCoords: polyCoords, polyOffsets: polyOffsets, tightness: tightness },\n          [ptsFlat.buffer, polyCoords.buffer, polyOffsets.buffer]\n        );\n      } catch (e) {\n        runSyncFallback();\n      }\n    }, 30);\n  }\n\n  document.getElementById('gn-contour-compute-btn').addEventListener('click', function () { startContourJob(); });\n  document.getElementById('gn-contour-cancel-btn').addEventListener('click', function () { cancelContourJob(); });\n\n  document.getElementById('gn-include-rapids').addEventListener('change', function () {\n    hull = null;\n    startContourJob();\n  });\n\n  // Layer visibility (legend items toggle these; hidden layers are also\n  // excluded from hit-testing so underlying geometry becomes clickable).\n  var layerVis = { rapid: true, feed: true, selline: true, contour: true, jobstart: true, jobend: true, selpoint: true };\n  document.getElementById('gn-legend').addEventListener('click', function (ev) {\n    var item = ev.target.closest('.gn-legend-item');\n    if (!item) return;\n    var key = item.getAttribute('data-layer');\n    layerVis[key] = !layerVis[key];\n    item.classList.toggle('gn-layer-off', !layerVis[key]);\n    if (key === 'contour' && layerVis.contour && contourDeferred) {\n      ensureContour(); // computing renders when done\n      return;\n    }\n    renderMain();\n    // hiding/showing geometry layers changes what the contour should wrap\n    if (key === 'rapid' || key === 'feed' || key.indexOf('tool:') === 0) contourRefilter();\n  });\n\n  // Per-tool legend entries: when the file changes tools, the single\n  // \"Feed\" item is replaced by one toggleable, color-coded item per tool.\n  var TOOL_COLORS = ['#4ec9b0', '#dcdcaa', '#9cdcfe', '#ce9178', '#b5cea8', '#f48fb1', '#4fc1ff', '#d7ba7d'];\n  function toolColor(tool) {\n    if (!parsed || !parsed.tools || parsed.tools.length === 0) return 'var(--gn-feed)';\n    var i = parsed.tools.indexOf(tool);\n    return i < 0 ? 'var(--gn-feed)' : TOOL_COLORS[i % TOOL_COLORS.length];\n  }\n\n  // ==== Depth (Z) and power (S) shading ====\n  // Z-depth: distinct pass heights get tinted along a light-to-dark ramp\n  // (shallow = lighter, deep = darker) so overlapping passes are visually\n  // separable instead of collapsing into one solid color. Only kicks in for\n  // a small, discrete set of Z levels (real multi-pass jobs); continuously\n  // varying Z (3D relief carving) has too many distinct values and falls\n  // back to the plain feed/tool color, matching pre-existing behavior.\n  var Z_SHADE_MIN_LEVELS = 2, Z_SHADE_MAX_LEVELS = 24;\n  function zShadeEnabled(p) {\n    return !!(p && p.zLevels && p.zLevels.length >= Z_SHADE_MIN_LEVELS && p.zLevels.length <= Z_SHADE_MAX_LEVELS);\n  }\n  function hexToRgb(hex) {\n    hex = hex.replace('#', '');\n    if (hex.length === 3) hex = hex.split('').map(function (c) { return c + c; }).join('');\n    var n = parseInt(hex, 16);\n    return [(n >> 16) & 255, (n >> 8) & 255, n & 255];\n  }\n  function mixRgb(a, b, t) {\n    return [\n      Math.round(a[0] + (b[0] - a[0]) * t),\n      Math.round(a[1] + (b[1] - a[1]) * t),\n      Math.round(a[2] + (b[2] - a[2]) * t)\n    ];\n  }\n  // Depth shading lightens shallow passes toward white and darkens deep\n  // passes toward black, centered on the segment's OWN color (tool hue in\n  // multi-tool files, teal otherwise) — so tool identity and pass depth\n  // are both visible at once instead of Z-hue overriding tool-hue.\n  // Capped short of pure white/black (0.70 / 0.55) so the base hue never\n  // fully washes out or blacks out at the extremes.\n  var DEPTH_LIGHTEN_MAX = 0.70, DEPTH_DARKEN_MAX = 0.55;\n  function depthShadedColor(baseHex, zLevels, z1) {\n    var n = zLevels.length;\n    var idx = zLevels.indexOf(Number(z1.toFixed(3)));\n    if (idx < 0 || n <= 1) return baseHex;\n    var t = (idx / (n - 1)) * 2 - 1; // -1 shallowest .. 0 middle .. 1 deepest\n    var base = hexToRgb(baseHex);\n    var mixed = t < 0 ? mixRgb(base, [255, 255, 255], -t * DEPTH_LIGHTEN_MAX) : mixRgb(base, [0, 0, 0], t * DEPTH_DARKEN_MAX);\n    return 'rgb(' + mixed.join(',') + ')';\n  }\n  // S-power: opacity quantized into buckets so a laser raster (thousands\n  // of distinct S values) reduces to a manageable number of <path> groups\n  // instead of one per segment. Files with constant/no S (ordinary milling)\n  // all land in the top bucket, i.e. full opacity everywhere — unchanged\n  // from pre-existing behavior.\n  var S_OPACITY_BUCKETS = 20;\n  function sOpacityBucket(p, s) {\n    if (!p || !p.maxS) return S_OPACITY_BUCKETS;\n    var frac = Math.max(0, Math.min(1, s / p.maxS));\n    return Math.round(frac * S_OPACITY_BUCKETS);\n  }\n  function rebuildLegend() {\n    var feedItem = document.querySelector('#gn-legend .gn-legend-item[data-layer=\"feed\"]');\n    // remove any previous per-tool items\n    document.querySelectorAll('#gn-legend .gn-legend-item[data-layer^=\"tool:\"]').forEach(function (el) { el.remove(); });\n    var multiTool = parsed && parsed.tools && parsed.tools.length > 0;\n    if (feedItem) feedItem.style.display = multiTool ? 'none' : '';\n    var powerNote = document.getElementById('gn-power-note');\n    var depthNote = document.getElementById('gn-depth-note');\n    if (powerNote) powerNote.style.display = (parsed && parsed.maxS > 0) ? '' : 'none';\n    var movesItem = document.getElementById('gn-moves-item');\n    if (movesItem) movesItem.style.display = (parsed && parsed.maxS > 0) ? '' : 'none';\n    if (depthNote) depthNote.style.display = zShadeEnabled(parsed) ? '' : 'none';\n    if (!multiTool) return;\n    var frag = document.createDocumentFragment();\n    var keys = parsed.tools.slice();\n    var hasUntooled = parsed.segments.some(function (s) { return s.type !== 'G0' && (s.tool === null || s.tool === undefined); });\n    if (hasUntooled) keys.unshift(null);\n    keys.forEach(function (t) {\n      var span = document.createElement('span');\n      span.className = 'gn-legend-item';\n      var key = 'tool:' + (t === null ? '_' : t);\n      span.setAttribute('data-layer', key);\n      span.title = 'Click to hide/show this layer';\n      if (layerVis[key] === undefined) layerVis[key] = true;\n      if (!layerVis[key]) span.classList.add('gn-layer-off');\n      var sw = document.createElement('i');\n      sw.className = 'gn-swatch';\n      sw.style.background = t === null ? 'var(--gn-feed)' : toolColor(t);\n      span.appendChild(sw);\n      span.appendChild(document.createTextNode(t === null ? 'Feed (no tool)' : 'Feed T' + t));\n      frag.appendChild(span);\n    });\n    feedItem.parentNode.insertBefore(frag, feedItem.nextSibling);\n  }\n\n  // ==== Jog & Zero controls + live spindle position ====\n  var jogStep = 1;\n  var lastMachine = null; // { status, wx, wy, wz } — always millimetres\n  // The map is drawn in FILE units; grbl reports WPos in mm. For G20\n  // (inch) files the crosshair must divide by 25.4 or it lands 25.4x off\n  // and \"drifts\" every jog — the sync bug you observed.\n  var fileUnitsScale = 1; // mm per file unit (25.4 when the file is G20)\n  var JOG_FEED_Z_CAP = 1200;\n  function jogFeedXY() {\n    var sel = document.getElementById('gn-jog-feed');\n    var v = sel ? parseInt(sel.value, 10) : 2000;\n    return isNaN(v) ? 2000 : v;\n  }\n  var CONT_DIST = 800; // continuous jog travel cap (mm); released -> 0x85 cancel\n\n  function jogMsg(text) {\n    var el = document.getElementById('gn-jog-msg');\n    if (!text) { el.style.display = 'none'; return; }\n    el.textContent = text;\n    el.style.display = '';\n    clearTimeout(jogMsg._t);\n    jogMsg._t = setTimeout(function () { el.style.display = 'none'; }, 4000);\n  }\n\n  // sendCommand resolves on HTTP 200 even when the body reports failure;\n  // surface those so a rejected jog is never silent.\n  function sendMachine(cmd, label) {\n    return sendCommand(cmd, label || cmd).then(function (resp) {\n      if (resp && resp.success === false) {\n        throw new Error(resp.message || resp.error || ('Rejected: ' + cmd));\n      }\n      // refresh the DRO/crosshair right away and again shortly after,\n      // so the display tracks motion instead of waiting for the next poll\n      pollMachineState();\n      setTimeout(pollMachineState, 280);\n      return resp;\n    }).catch(function (e) {\n      jogMsg(e.message || String(e));\n      throw e;\n    });\n  }\n\n  function jogAllowed() {\n    if (lastMachine && (lastMachine.status === 'Run' || lastMachine.status === 'Hold' || lastMachine.status === 'Alarm' || lastMachine.status === 'Home')) {\n      jogMsg('Jogging blocked while machine is in ' + lastMachine.status + '.');\n      return false;\n    }\n    return true;\n  }\n\n  function jogCommandFor(dxs, dys, dzs, dist) {\n    var cmd = '$J=G91 G21';\n    if (dxs) cmd += ' X' + (dxs * dist);\n    if (dys) cmd += ' Y' + (dys * dist);\n    cmd += dzs ? (' Z' + (dzs * dist) + ' F' + Math.min(jogFeedXY(), JOG_FEED_Z_CAP)) : (' F' + jogFeedXY());\n    return cmd;\n  }\n\n  // Pointer-based jog: tap = one step, hold (>=280 ms) = continuous jog that\n  // is cancelled (0x85) the instant the pointer lifts, leaves the button, or\n  // the page loses visibility — the dead-man behaviours a jog pad needs.\n  var jogHold = null; // { btn, dxs, dys, dzs, timer, continuous, t0 }\n  var jogBoxEl = document.getElementById('gn-jog-box');\n\n  function endJogHold(commitTap) {\n    if (!jogHold) return;\n    var h = jogHold;\n    jogHold = null;\n    clearTimeout(h.timer);\n    h.btn.classList.remove('gn-jogging');\n    if (h.continuous) {\n      sendMachine('0x85', 'Jog cancel');\n    } else if (commitTap) {\n      if (jogAllowed()) sendMachine(jogCommandFor(h.dxs, h.dys, h.dzs, jogStep));\n    }\n  }\n\n  var zeroHold = null; // { btn, timer }\n  function endZeroHold() {\n    if (!zeroHold) return;\n    clearTimeout(zeroHold.timer);\n    zeroHold.btn.classList.remove('gn-holding');\n    zeroHold = null;\n  }\n\n  jogBoxEl.addEventListener('pointerdown', function (ev) {\n    var b = ev.target.closest('button');\n    if (!b || b.disabled) return;\n    if (b.id === 'gn-jog-cancel') { sendMachine('0x85', 'Jog cancel'); return; }\n    if (b.hasAttribute('data-step')) {\n      jogStep = parseFloat(b.getAttribute('data-step'));\n      document.querySelectorAll('#gn-jog-steps .gn-step-pill').forEach(function (el) {\n        el.classList.toggle('gn-step-active', el === b);\n      });\n      return;\n    }\n    if (b.hasAttribute('data-zero')) {\n      endZeroHold();\n      var axes = b.getAttribute('data-zero');\n      b.classList.add('gn-holding');\n      zeroHold = {\n        btn: b,\n        timer: setTimeout(function () {\n          zeroHold = null;\n          b.classList.remove('gn-holding');\n          b.classList.add('gn-zeroed');\n          setTimeout(function () { b.classList.remove('gn-zeroed'); }, 700);\n          sendMachine('G10 L20 P0 ' + axes, 'Zero ' + axes);\n        }, 700)\n      };\n      try { b.setPointerCapture(ev.pointerId); } catch (e) {}\n      return;\n    }\n    var jd = b.getAttribute('data-jog');\n    var jz = b.getAttribute('data-jogz');\n    if (!jd && !jz) return;\n    if (!jogAllowed()) return;\n    var dxs = 0, dys = 0, dzs = 0;\n    if (jd) { var pr = jd.split(','); dxs = parseInt(pr[0], 10); dys = parseInt(pr[1], 10); }\n    if (jz) dzs = parseInt(jz, 10);\n    endJogHold(false);\n    var hold = { btn: b, dxs: dxs, dys: dys, dzs: dzs, continuous: false, t0: Date.now() };\n    hold.timer = setTimeout(function () {\n      if (jogHold !== hold) return;\n      hold.continuous = true;\n      b.classList.add('gn-jogging');\n      sendMachine(jogCommandFor(dxs, dys, dzs, CONT_DIST)).catch(function () {\n        if (jogHold === hold) { jogHold = null; b.classList.remove('gn-jogging'); }\n      });\n    }, 280);\n    jogHold = hold;\n    try { b.setPointerCapture(ev.pointerId); } catch (e) {}\n  });\n\n  ['pointerup', 'pointercancel'].forEach(function (evName) {\n    jogBoxEl.addEventListener(evName, function () {\n      endJogHold(evName === 'pointerup');\n      endZeroHold();\n    });\n  });\n  jogBoxEl.addEventListener('pointerleave', function () { endJogHold(false); endZeroHold(); });\n  document.addEventListener('visibilitychange', function () { if (document.hidden) { endJogHold(false); endZeroHold(); } });\n\n  // Live position poll: drives the DRO readout and the map crosshair.\n  // Crosshair moves are surgical DOM updates — never a scene rebuild.\n  function pollMachineState() {\n    api('/api/server-state').then(function (st) {\n      var ms = st && (st.machineState || st.MachineState);\n      if (!ms) return;\n      var wposStr = ms.WPos || ms.wPos || ms.wpos || '0,0,0';\n      var pp = String(wposStr).split(',').map(Number);\n      lastMachine = { status: ms.Status || ms.status || '?', wx: pp[0] || 0, wy: pp[1] || 0, wz: pp[2] || 0, wa: pp.length > 3 && isFinite(pp[3]) ? pp[3] : null };\n      var droEl = document.getElementById('gn-dro');\n      if (droEl) {\n        var us = fileUnitsScale || 1;\n        var dp = us > 1 ? 3 : 2; // inches deserve an extra decimal\n        droEl.textContent =\n          lastMachine.status + ' \\u00b7 X' + (lastMachine.wx / us).toFixed(dp) +\n          ' Y' + (lastMachine.wy / us).toFixed(dp) +\n          ' Z' + (lastMachine.wz / us).toFixed(dp) + (us > 1 ? ' in' : ' mm');\n      }\n      syncSpindleMarker();\n    }).catch(function () { /* transient poll errors are fine */ });\n  }\n  function syncSpindleMarker() {\n    if (lastMachine && layerVis.spindle !== false) {\n      var us = fileUnitsScale || 1;\n      if (viewMode === 'rotary') {\n        // vertical axis is unwrapped A; degrees are unit-independent\n        viewer.updateSpindle({ x: lastMachine.wx / us, y: (lastMachine.wa || 0) * (rotaryK || 1) });\n      } else {\n        viewer.updateSpindle({ x: lastMachine.wx / us, y: lastMachine.wy / us });\n      }\n    } else {\n      viewer.updateSpindle(null);\n    }\n  }\n  setInterval(pollMachineState, 300);\n  pollMachineState();\n\n  // ==== Rotary (4th-axis) unwrapped view ====\n  // Rotary G-code moves mostly in X and A, so the XY view collapses to a\n  // line. The rotary tab maps A onto the vertical axis (degrees, or true\n  // surface mm when a stock diameter is given), turning the file into a\n  // clickable graphic — click a move, get its line number, start from it.\n  var viewMode = 'xy';\n  var rotaryParsedCache = null;\n  var rotaryK = 1; // view-units per degree A\n\n  function rotaryScale() {\n    var dia = parseFloat(document.getElementById('gn-rotary-dia').value);\n    return (isFinite(dia) && dia > 0) ? (Math.PI * dia / 360) : 1;\n  }\n\n  function getRotaryParsed() {\n    var k = rotaryScale();\n    if (rotaryParsedCache && rotaryParsedCache._k === k && rotaryParsedCache._src === parsed) return rotaryParsedCache;\n    rotaryK = k;\n    var segs = parsed.segments;\n    var out = new Array(segs.length);\n    var mnX = Infinity, mnY = Infinity, mxX = -Infinity, mxY = -Infinity;\n    for (var i = 0; i < segs.length; i++) {\n      var s = segs[i];\n      var ry0 = (s.a0 || 0) * k, ry1 = (s.a1 || 0) * k;\n      out[i] = {\n        line: s.line, type: s.type, tool: s.tool,\n        x0: s.x0, y0: ry0, x1: s.x1, y1: ry1,\n        z0: s.z0, z1: s.z1, s: s.s, points: null, aSrc: s\n      };\n      if (s.x0 < mnX) mnX = s.x0; if (s.x0 > mxX) mxX = s.x0;\n      if (s.x1 < mnX) mnX = s.x1; if (s.x1 > mxX) mxX = s.x1;\n      if (ry0 < mnY) mnY = ry0; if (ry0 > mxY) mxY = ry0;\n      if (ry1 < mnY) mnY = ry1; if (ry1 > mxY) mxY = ry1;\n    }\n    if (!isFinite(mnX)) { mnX = mnY = 0; mxX = mxY = 1; }\n    rotaryParsedCache = {\n      segments: out, bounds: { minX: mnX, minY: mnY, maxX: mxX, maxY: mxY },\n      tools: parsed.tools, units: parsed.units, totalLines: parsed.totalLines,\n      maxS: parsed.maxS, zLevels: parsed.zLevels,\n      hasRotary: true, _k: k, _src: parsed\n    };\n    return rotaryParsedCache;\n  }\n\n  var zFilterMax = null; // null = off; otherwise hide segments entirely above this Z\n\n  // Everything the contour consumes flows through here: the Z filter AND\n  // the legend layer toggles (rapid / feed / per-tool). If it isn't drawn,\n  // it doesn't shape the outline.\n  function contourSourceSegments() {\n    var base = zFiltered(parsed);\n    if (!base || !base.segments) return { segments: [], bounds: parsed ? parsed.bounds : null };\n    var multiTool = parsed.tools && parsed.tools.length > 0;\n    var segs = base.segments.filter(function (s) {\n      if (s.type === 'G0') return layerVis.rapid !== false; // checkbox decides inclusion later\n      if (multiTool) {\n        var key = 'tool:' + (s.tool === null || s.tool === undefined ? '_' : s.tool);\n        return layerVis[key] !== false;\n      }\n      return layerVis.feed !== false;\n    });\n    // bounds of what remains, so the sampling step matches the visible\n    // geometry instead of the whole file\n    var b = null;\n    if (segs.length) {\n      b = { minX: Infinity, minY: Infinity, maxX: -Infinity, maxY: -Infinity };\n      segs.forEach(function (s) {\n        b.minX = Math.min(b.minX, s.x0, s.x1); b.maxX = Math.max(b.maxX, s.x0, s.x1);\n        b.minY = Math.min(b.minY, s.y0, s.y1); b.maxY = Math.max(b.maxY, s.y0, s.y1);\n      });\n    }\n    return { segments: segs, bounds: b || parsed.bounds };\n  }\n\n  // Shared invalidation for anything that changes which segments are\n  // visible: drop the stale outline immediately, then (debounced) either\n  // recompute automatically (small visible set) or re-offer the button.\n  var _contourRefilterTimer = null;\n  function contourRefilter() {\n    if (hull || contourJob) {\n      cancelContourJob(true);\n      hull = null;\n      renderMain();\n    }\n    if (_contourRefilterTimer) clearTimeout(_contourRefilterTimer);\n    if (viewMode === 'rotary') return;\n    _contourRefilterTimer = setTimeout(function () {\n      _contourRefilterTimer = null;\n      var src = contourSourceSegments();\n      if (src.segments.length && src.segments.length <= AUTO_CONTOUR_MAX_SEGMENTS) {\n        contourDeferred = false;\n        startContourJob();\n      } else {\n        contourDeferred = true;\n        setContourUI('pending');\n      }\n    }, 450);\n  }\n\n  var _zfCache = { src: null, z: undefined, out: null };\n  function zFiltered(vp) {\n    if (zFilterMax === null || !vp || !vp.segments) return vp;\n    // memoized: keeps object identity stable across renders so the\n    // viewer's per-file bbox cache survives pan/zoom between slider moves\n    if (_zfCache.src === vp && _zfCache.z === zFilterMax) return _zfCache.out;\n    var out = { };\n    for (var k in vp) if (Object.prototype.hasOwnProperty.call(vp, k)) out[k] = vp[k];\n    out.segments = vp.segments.filter(function (s) {\n      return Math.min(s.z0, s.z1) <= zFilterMax;\n    });\n    _zfCache.src = vp; _zfCache.z = zFilterMax; _zfCache.out = out;\n    return out;\n  }\n\n  function viewParsed() {\n    var vp = (viewMode === 'rotary' && parsed && parsed.hasRotary) ? getRotaryParsed() : parsed;\n    return zFiltered(vp);\n  }\n\n  function initZFilter() {\n    var wrap = document.getElementById('gn-zfilter-wrap');\n    var slider = document.getElementById('gn-zfilter');\n    var val = document.getElementById('gn-zfilter-val');\n    if (!wrap || !slider || !parsed || !parsed.segments || !parsed.segments.length) return;\n    var zmin = Infinity, zmax = -Infinity;\n    parsed.segments.forEach(function (s) {\n      if (s.z0 < zmin) zmin = s.z0; if (s.z1 < zmin) zmin = s.z1;\n      if (s.z0 > zmax) zmax = s.z0; if (s.z1 > zmax) zmax = s.z1;\n    });\n    if (!isFinite(zmin) || !isFinite(zmax) || zmax - zmin < 0.001) return;\n    var STEPS = 200;\n    slider.min = '0'; slider.max = String(STEPS); slider.value = String(STEPS);\n    wrap.style.display = 'inline-flex';\n    var toZ = function (v) { return zmin + (zmax - zmin) * (v / STEPS); };\n    slider.addEventListener('input', function () {\n      var v = parseInt(slider.value, 10);\n      if (v >= STEPS) { zFilterMax = null; val.textContent = 'off'; }\n      else { zFilterMax = toZ(v); val.textContent = zFilterMax.toFixed(2); }\n      renderMain();\n      contourRefilter();\n    });\n  }\n\n  function setViewMode(mode) {\n    if (mode === viewMode) return;\n    viewMode = mode;\n    // Trace/outline machinery is XY-only: hide the whole box and its\n    // legend entry in rotary view rather than showing disabled controls.\n    document.getElementById('gn-contour-box').style.display = mode === 'rotary' ? 'none' : '';\n    var traceBtn = document.getElementById('gn-trace-contour-btn');\n    if (traceBtn) traceBtn.style.display = mode === 'rotary' ? 'none' : '';\n    var contourLegend = document.querySelector('#gn-legend .gn-legend-item[data-layer=\"contour\"]');\n    if (contourLegend) contourLegend.style.display = mode === 'rotary' ? 'none' : '';\n    // re-select the same line in the other view's segment array\n    var line = selectedSegment ? selectedSegment.line : null;\n    var vp = viewParsed();\n    if (line !== null && vp) {\n      var match = null;\n      for (var i = 0; i < vp.segments.length; i++) { if (vp.segments[i].line === line) { match = vp.segments[i]; break; } }\n      selectedSegment = match;\n    }\n    targetOverride = null;\n    renderMain();\n  }\n\n  document.getElementById('gn-rotary-dia').addEventListener('change', function () {\n    rotaryParsedCache = null;\n    if (viewMode === 'rotary') renderMain();\n  });\n\n  var tightnessDebounce = null;\n  document.getElementById('gn-tightness').addEventListener('input', function () {\n    if (tightnessDebounce) clearTimeout(tightnessDebounce);\n    tightnessDebounce = setTimeout(function () {\n      hull = null;\n      startContourJob();\n    }, 250);\n  });\n\n  // Run the spindle around the traced contour — like the built-in \"Trace\n  // Outline\", but following the true silhouette instead of a bounding box.\n  document.getElementById('gn-trace-contour-btn').addEventListener('click', function () {\n    var errEl = document.getElementById('gn-trace-error');\n    errEl.textContent = '';\n    if (!hull && parsed) { ensureContour(traceContourClicked); return; } // deferred on large files\n    traceContourClicked();\n  });\n\n  function traceContourClicked() {\n    var errEl = document.getElementById('gn-trace-error');\n    if (!hull || hull.length < 3) { errEl.textContent = 'No contour computed yet.'; return; }\n\n    var raiseZ = document.getElementById('gn-raisez').checked;\n    var safeZ = Number(safeZValue());\n\n    var perimeter = 0;\n    for (var i = 0; i < hull.length; i++) {\n      var a = hull[i], b = hull[(i + 1) % hull.length];\n      perimeter += Math.hypot(b.x - a.x, b.y - a.y);\n    }\n    var unitLabel = (parsed && parsed.units === 'G20') ? 'in' : 'mm';\n\n    var body = '<b>' + hull.length + ' vertices<\/b>, perimeter ~<b>' + perimeter.toFixed(1) + ' ' + unitLabel + '<\/b>.<br>' +\n      (raiseZ\n        ? 'Z will be raised to safe height (G53 Z' + safeZ.toFixed(3) + ' mm) first, then '\n        : '<b>Z will NOT be raised first<\/b> \\u2014 ') +\n      'the spindle rapids around every vertex and returns to the first. Feed hold / Stop halts the trace at any time.';\n\n    confirmMotion('Trace Contour Outline', body, 'Trace').then(function (ok) {\n      if (!ok) return;\n      var cmds = [];\n      if (raiseZ) cmds.push('G21 G90 G53 G0 Z' + safeZ.toFixed(3));\n      var prefix = motionPrefix();\n      hull.forEach(function (p, idx) {\n        cmds.push((idx === 0 ? prefix : '') + 'G0 X' + p.x.toFixed(3) + ' Y' + p.y.toFixed(3));\n      });\n      cmds.push('G0 X' + hull[0].x.toFixed(3) + ' Y' + hull[0].y.toFixed(3));\n      return sendCommand(cmds.join('\\n'), 'Trace contour outline (' + hull.length + ' vertices, ~' + perimeter.toFixed(0) + ' ' + unitLabel + ')')\n        .then(function () {\n          setStatus(loadStatus + ' Tracing contour: ' + hull.length + ' vertices, ~' + perimeter.toFixed(1) + ' ' + unitLabel + ' perimeter.');\n        });\n    }).catch(function (err) { errEl.textContent = err.message || String(err); });\n  }\n\n  // ============================================================\n  // Boot\n  // ============================================================\n  loadGcodeAndSettings();\n})();\n";
    var gnBooted = false;
    function gnActivate(host) {
      try {
        if (!gnBooted) {
          gnBooted = true;
          host.innerHTML = NAV_MARKUP;
          var sc = document.createElement('script');
          sc.textContent = NAV_SCRIPT;
          (document.body || host).appendChild(sc);
        }
        // canvas measures itself against a visible container
        if (typeof window.dispatchEvent === 'function' && typeof Event === 'function') {
          setTimeout(function () { try { window.dispatchEvent(new Event('resize')); } catch (e) {} }, 30);
        }
      } catch (e) {
        try { if (typeof console !== 'undefined' && console.log) console.log('[gcode-explorer] navigator activation failed:', e && e.message); } catch (e2) {}
      }
    }

    var CHIP_CAP_PX = 0; // measured two-row chip width; 0 = CSS fallback

    function applyTabWidth() {
      // Per-tab width: Explain stretches to 1800px since G-code lines use
      // every pixel. NC Manual caps at 1260px - the manual is Material for
      // MkDocs, whose content grid maxes out at 61rem (~976px) and whose
      // sidebars+TOC layout completes at the 1220px breakpoint, so anything
      // wider is centered dead margin. Reference/Settings keep the
      // chip-fitted two-row cap.
      try {
        var root = document.getElementById('gref-root');
        if (!root) return;
        if (state.tab === 'explain' || state.tab === 'navigator') {
          root.style.maxWidth = '1800px';
        } else if (state.tab === 'manual') {
          root.style.maxWidth = '1260px';
        } else {
          root.style.maxWidth = CHIP_CAP_PX ? CHIP_CAP_PX + 'px' : '';
        }
      } catch (e) {}
    }

    function renderTabs() {
      styleTab(document.getElementById('gref-tab-reference'), state.tab === 'reference');
      styleTab(document.getElementById('gref-tab-explain'), state.tab === 'explain');
      styleTab(document.getElementById('gref-tab-navigator'), state.tab === 'navigator');
      styleTab(document.getElementById('gref-tab-manual'), state.tab === 'manual');
      styleTab(document.getElementById('gref-tab-settings'), state.tab === 'settings', !!DATA.showSettingsTab);
      document.getElementById('gref-panel-search').style.display = state.tab === 'reference' ? '' : 'none';
    }

    function render() {
      renderTabs();
      applyTabWidth();
      var foot = document.getElementById('gref-foot');
      if (foot) foot.style.display = (state.tab === 'reference' || state.tab === 'explain') ? '' : 'none';
      var body = document.getElementById('gref-body');
      var slot = document.getElementById('gref-settings');
      var manual = document.getElementById('gref-manual');
      var nav = document.getElementById('gn-host');
      body.style.display = 'none';
      slot.style.display = 'none';
      manual.style.display = 'none';
      if (nav) nav.style.display = 'none';
      if (state.tab === 'settings') {
        slot.style.display = 'block';
        return;
      }
      if (state.tab === 'navigator') {
        if (nav) {
          nav.style.display = 'flex';
          gnActivate(nav);
        }
        return;
      }
      if (state.tab === 'manual') {
        manual.style.display = 'flex';
        // lazy-load: only hit the manual site the first time the tab opens
        var frame = document.getElementById('gref-manual-frame');
        if (frame && !frame.src) frame.src = MANUAL_URL;
        return;
      }
      body.style.display = '';
      if (state.tab === 'reference') {
        // reference: the body itself scrolls the card list
        body.style.overflowY = 'auto';
        body.style.overflowX = '';
        renderChips(); renderReference();
      } else {
        // explain: the body is a fixed flex frame; the file list and the
        // explanation pane each scroll independently inside it, and
        // horizontal overflow is clipped so no content can ever push
        // the dialog wider than its frame
        body.style.display = 'flex';
        body.style.overflowY = 'hidden';
        body.style.overflowX = 'hidden';
        renderExplain();
      }
    }

    /* ---------------- global handlers (dialog scope) ---------------- */
    window.grefSwitchTab = function (tab) { state.tab = tab; render(); };
    window.grefSetCategory = function (cat) { state.category = cat; render(); };
    window.grefToggle = function (headEl) {
      var card = headEl.parentElement;
      var code = card.getAttribute('data-code');
      state.open[code] = !state.open[code];
      card.classList.toggle('open');
    };
    function scrollToLine(idx) {
      try {
        var list = document.getElementById('gref-filelist');
        if (list && list.children && list.children[idx] && list.children[idx].scrollIntoView) {
          list.children[idx].scrollIntoView({ block: 'center' });
        }
      } catch (e) {}
    }

    function selectLine(from, to) {
      state.gfocus = -1;
      var s = state.gsel;
      s.anchor = from; s.from = from; s.to = (to === undefined ? from : to);
      ensureRendered(s.from);
      applySelectionHighlights();
      scrollToLine(s.from);
      state.explainText = activeSrc().lines.slice(s.from, s.to + 1).join('\n');
      updateExout();
    }

    function fsearchCount() {
      var f = state.fsearch;
      var el = document.getElementById('gref-fsearch-count');
      if (!el) return;
      el.innerHTML = f.matches.length ? (f.cur + 1) + ' of ' + f.matches.length
                   : (f.q ? 'no matches' : '');
    }

    window.grefFileSearch = function (q) {
      var f = state.fsearch;
      f.q = q;
      f.matches = [];
      if (q) {
        var needle = q.toLowerCase();
        var lines = activeSrc().lines;
        for (var i = 0; i < lines.length; i++) {
          if (lines[i].toLowerCase().indexOf(needle) !== -1) f.matches.push(i);
        }
      }
      f.cur = f.matches.length ? 0 : -1;
      fsearchCount();
      if (f.cur >= 0) selectLine(f.matches[f.cur]);
    };
    window.grefFileFind = function (dir) {
      var f = state.fsearch;
      if (!f.matches.length) return;
      f.cur = (f.cur + dir + f.matches.length) % f.matches.length;
      fsearchCount();
      selectLine(f.matches[f.cur]);
    };
    window.grefFileSearchClear = function () {
      state.fsearch = { q: '', matches: [], cur: -1 };
      var inp = document.getElementById('gref-fsearch');
      if (inp) inp.value = '';
      fsearchCount();
    };

    window.grefLineClick = function (ev, i) {
      state.gfocus = -1;
      var s = state.gsel;
      if (ev && ev.shiftKey && s.anchor >= 0) {
        s.from = Math.min(s.anchor, i);
        s.to = Math.max(s.anchor, i);
      } else {
        s.anchor = i; s.from = i; s.to = i;
      }
      applySelectionHighlights();
      state.explainText = activeSrc().lines.slice(s.from, s.to + 1).join('\n');
      updateExout();
    };
    window.grefJump = function (val) {
      state.gfocus = -1;
      var m = String(val).trim().match(/^(\d+)(?:\s*[-\u2013]\s*(\d+))?$/);
      var src = activeSrc();
      if (!m || !src.ready) return;
      var n = src.lines.length;
      var a = Math.max(1, Math.min(n, parseInt(m[1], 10))) - 1;
      var b = m[2] ? Math.max(1, Math.min(n, parseInt(m[2], 10))) - 1 : a;
      var s = state.gsel;
      s.anchor = Math.min(a, b); s.from = Math.min(a, b); s.to = Math.max(a, b);
      ensureRendered(s.to);
      applySelectionHighlights();
      scrollToLine(s.from);
      state.explainText = src.lines.slice(s.from, s.to + 1).join('\n');
      updateExout();
    };
    window.grefJumpEnd = function () {
      var src = activeSrc();
      if (src.ready) window.grefJump(String(src.lines.length));
    };
    window.grefSetSrc = function (src) {
      if (state.src === src) return;
      state.src = src;
      state.gsel = { anchor: -1, from: -1, to: -1 };
      state.gfocus = -1;
      state.fsearch = { q: '', matches: [], cur: -1 };
      state.explainText = '';
      renderExplain();
    };
    window.grefPasteInput = function (v) {
      state.paste.text = v;
      state.paste.lines = v ? v.split(/\r?\n/) : [];
      state.gfocus = -1;
      state.fsearch.matches = []; state.fsearch.cur = -1;
      var n = state.paste.lines.length;
      var lc = document.getElementById('gref-linecount');
      if (lc) lc.innerHTML = String(n);
      var list = document.getElementById('gref-filelist');
      if (list) {
        list.innerHTML = n ? '' : '<div class="gref-empty" style="padding:16px">Paste G-code above to browse and explain it.</div>';
        state.rendered = 0;
        if (n) appendChunk();
      }
      fsearchCount();
      if (n) {
        // explain the whole paste right away (output caps at 300 lines)
        state.gsel = { anchor: 0, from: 0, to: n - 1 };
        applySelectionHighlights();
        state.explainText = state.paste.text;
        updateExout();
      } else {
        state.gsel = { anchor: -1, from: -1, to: -1 };
        state.explainText = '';
        updateExout();
      }
    };
    window.grefSplitStart = function (ev) {
      try {
        var wrap = document.getElementById('gref-exwrap');
        var left = document.getElementById('gref-leftpane');
        if (!wrap || !left || typeof wrap.getBoundingClientRect !== 'function' ||
            typeof document.addEventListener !== 'function') return;
        var rect = wrap.getBoundingClientRect();
        var move = function (e) {
          var pct = ((e.clientX - rect.left) / rect.width) * 100;
          pct = Math.max(20, Math.min(78, pct));
          state.splitPct = pct;
          left.style.flex = '0 0 ' + pct + '%';
        };
        var up = function () {
          document.removeEventListener('mousemove', move);
          document.removeEventListener('mouseup', up);
        };
        document.addEventListener('mousemove', move);
        document.addEventListener('mouseup', up);
        if (ev && ev.preventDefault) ev.preventDefault();
      } catch (e) {}
    };
    window.grefPasteClear = function () {
      var ta = document.getElementById('gref-paste');
      if (ta) ta.value = '';
      window.grefPasteInput('');
    };
    window.grefReloadFile = function () {
      state.gfile = { status: 'idle', name: '', lines: [] };
      state.gsel = { anchor: -1, from: -1, to: -1 };
      renderExplain();
    };

    /* ---------------- settings tab wiring ---------------- */
    if (DATA.showSettingsTab) (function initSettings() {
      var chk = document.getElementById('gcfg-terminal-lookup');
      var statusEl = document.getElementById('gcfg-status');
      if (!chk || typeof chk.addEventListener !== 'function') return;

      var SETTINGS_URL = apiBase() + '/api/plugins/com.cncdocs.gcode-reference/settings';

      function applySettings(s) {
        s = s || {};
        chk.checked = s.terminalLookup !== false && s.terminalLookup !== 'false';
      }

      if (typeof fetch !== 'undefined') {
        try {
          fetch(SETTINGS_URL)
            .then(function (r) { return r && r.ok ? r.json() : {}; })
            .then(applySettings)
            .catch(function () { applySettings({}); });
        } catch (e) { applySettings({}); }
      } else {
        applySettings({});
      }

      var saveTimer = null;
      function save() {
        if (typeof fetch === 'undefined') return;
        var body = JSON.stringify({ terminalLookup: chk.checked });
        fetch(SETTINGS_URL, {
          method: 'PUT',
          headers: { 'Content-Type': 'application/json' },
          body: body
        }).then(function (r) {
          statusEl.textContent = r && r.ok ? 'Saved' : 'Save failed';
          if (saveTimer) clearTimeout(saveTimer);
          saveTimer = setTimeout(function () { statusEl.textContent = ''; }, 2000);
        }).catch(function () {
          statusEl.textContent = 'Save failed';
        });
      }

      chk.addEventListener('change', save);
    })();

    /* ---------------- boot ---------------- */
    render();
    // Pin max-width to the REAL rendered width of the first 8 category
    // chips (All .. Canned Cycles) so at maximum size the chips settle
    // into exactly two rows, top row wider than the bottom. Measuring
    // the live DOM (not estimating) accounts for any padding/font the
    // host app's CSS adds to buttons. Narrower windows still wrap the
    // chips responsively onto more rows via flex-wrap. Set once on the
    // root, so all three tabs share the identical width.
    (function fitWidthToChipRow() {
      try {
        if (state.tab !== 'reference') return; // chips not rendered - keep CSS fallback
        var chipsEl = document.getElementById('gref-chips');
        var kids = chipsEl && chipsEl.children;
        if (!kids || kids.length < 8 || !kids[0].offsetWidth) return;
        var w = 0;
        for (var i = 0; i < 8; i++) w += kids[i].offsetWidth;
        w += 7 * 6;  // flex gaps between the 8 chips
        w += 48;     // container horizontal padding + scrollbar allowance
        var px = Math.ceil(w);
        if (px > 500 && px < 2200) {
          CHIP_CAP_PX = px;
          applyTabWidth();
        }
      } catch (e) { /* keep the CSS fallback */ }
    })();
    var searchEl = document.getElementById('gref-search');
    searchEl.value = state.query;
    searchEl.addEventListener('input', function () {
      state.query = searchEl.value;
      state.open = {}; // collapse on new search
      renderReference();
    });
    if (state.tab === 'reference') searchEl.focus();
  })();
</script>


<script>
  (function () {
    // In the Tools-menu dialog the server replaces the token (including
    // the one in the next line); from the Settings page it stays
    // literal. The concatenated comparison string is immune.
    var TML = '__TOOL_MENU_LABEL__';
    var IS_DIALOG = TML !== ('__TOOL' + '_MENU_LABEL__');
    // The Settings > Plugins page exists to configure, so land on the
    // Settings tab there. The Tools-menu dialog lands on the tab matching
    // the menu entry that was clicked: "G-code Navigator" opens the
    // Navigator, anything else opens the Reference.
    if (!IS_DIALOG && window.grefSwitchTab) window.grefSwitchTab('settings');
    else if (IS_DIALOG && /navigator/i.test(TML) && window.grefSwitchTab) window.grefSwitchTab('navigator');
  })();
</script>