three-slicer 0.3.3 → 0.3.5

package/engine/PARAMS.md

@@ -8,7 +8,7 @@ cannot drift from what `slice()` actually honours. Regenerate with `node types/g
 
 <!-- KERNEL-PARAMS:BEGIN — generated by types/gen_kernel_params.mjs, do not edit by hand -->
 
-The kernel accepts **189 parameters**. `deriveKernelParams()` produces 160 of them from the
+The kernel accepts **238 parameters**. `deriveKernelParams()` produces 209 of them from the
 OrcaSlicer settings map; the remaining 29 have no schema key behind them and can only be set by writing
 the params object directly — those rows show `—` in the *From setting* column.
 
@@ -46,21 +46,24 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 | `bottom_shell_layers` | `number` | `3` | `bottom_shell_layers` | top_shell_layers/bottom_shell_layers |
 | `infill_angle` | `number` | `45.0` | `infill_direction` | infill_direction |
 | `infill_density` | `number` | `0.15` | `sparse_infill_density` |  |
+| `infill_jerk` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `infill_jerk`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `infill_wall_overlap` | `number` | `15.0` | `infill_wall_overlap` | infill_wall_overlap (percent) |
 | `ironing_flow` | `number` | `10.0` | `ironing_flow` | ironing flow (%) |
 | `ironing_spacing` | `number` | `0.1` | `ironing_spacing` | ironing line spacing (mm) |
 | `ironing_speed` | `number` | `30.0` | `ironing_speed` | ironing speed (mm/s) |
 | `ironing_type` | `string` | `'none'` | `ironing_type` | none\|top\|topmost\|solid (the top family = on) |
+| `sparse_infill_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `sparse_infill_acceleration`, `time_lapse_gcode` |  |
 | `sparse_infill_filament_id` | `number` | `0` | `sparse_infill_filament_id` |  |
 | `sparse_infill_flow_ratio` | `number` | `1.0` | `sparse_infill_flow_ratio` |  |
 | `sparse_infill_pattern` | `string` | `'rectilinear'` | `sparse_infill_pattern` | rectilinear\|grid\|triangles\|zigzag\|gyroid |
+| `sparse_infill_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `sparse_infill_speed`, `time_lapse_gcode` |  |
 | `top_shell_layers` | `number` | `4` | `top_shell_layers` | top_shell_layers/bottom_shell_layers |
 
 ### Speeds, flow and temperature
 
 | Kernel param | Type | Default | From setting | Notes |
 | --- | --- | --- | --- | --- |
-| `bed_temp` | `number` | `60` | `hot_plate_temp` |  |
+| `bed_temp` | `number` | `60` | `curr_bed_type`, `hot_plate_temp` |  |
 | `bridge_speed` | `number` | `25.0` | `bridge_speed` | bridge_speed[0] (slowdown for unsupported bottoms) |
 | `close_fan_the_first_x_layers` | `number` | `1` | `close_fan_the_first_x_layers` | close_fan_the_first_x_layers |
 | `enable_pressure_advance` | `boolean` | `false` | `enable_pressure_advance` | enable_pressure_advance[0] |
@@ -78,6 +81,10 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 | `machine_max_accel_e` | `number` | `5000` | `machine_max_acceleration_e` | mm/s² (machine_max_acceleration_*) — per-axis ceiling, distinct from the accel_* feedrates above |
 | `machine_max_accel_xy` | `number` | `5000` | `machine_max_acceleration_x` | mm/s² (machine_max_acceleration_*) — per-axis ceiling, distinct from the accel_* feedrates above |
 | `machine_max_accel_z` | `number` | `500` | `machine_max_acceleration_z` | mm/s² (machine_max_acceleration_*) — per-axis ceiling, distinct from the accel_* feedrates above |
+| `machine_max_acceleration_extruding` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_max_acceleration_extruding`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `machine_max_acceleration_travel` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_max_acceleration_travel`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `machine_max_acceleration_y` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_max_acceleration_y`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `machine_max_jerk_y` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_max_jerk_y`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `machine_max_speed_e` | `number` | `30` | `machine_max_speed_e` | mm/s |
 | `machine_max_speed_xy` | `number` | `500` | `machine_max_speed_x` | mm/s |
 | `machine_max_speed_z` | `number` | `12` | `machine_max_speed_z` | mm/s |
@@ -87,6 +94,7 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 | `pressure_advance` | `number` | `0.02` | `pressure_advance` | pressure_advance[0] |
 | `print_speed` | `number` | `60` | `outer_wall_speed` |  |
 | `slow_down_layer_time` | `number` | `8.0` | `slow_down_layer_time` | slow_down_layer_time (s) |
+| `slow_down_layers` | `number` | `0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `slow_down_layers`, `time_lapse_gcode` | layers over which the first layer's speed ramps up to the print's |
 | `travel_speed` | `number` | `150` | `travel_speed` |  |
 
 ### Retraction and seams
@@ -115,6 +123,7 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 | `skirt_distance` | `number` | `2.0` | `skirt_distance` | skirt_distance / brim_width |
 | `skirt_height` | `number` | `1` | `skirt_height` | skirt_height: how many layers the skirt is drawn on |
 | `skirt_loops` | `number` | `1` | `skirt_loops` | skirt_loops |
+| `skirt_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `skirt_speed`, `time_lapse_gcode` | 0 = follow the role's speed |
 
 ### Support
 
@@ -137,11 +146,13 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 | `support_interface_flow_ratio` | `?` | — | `support_interface_flow_ratio` | undefined |
 | `support_interface_pattern` | `string` | `'auto'` | `support_interface_pattern` | support_interface_pattern: auto\|rectilinear\|concentric\|rectilinear_interlaced\|grid |
 | `support_interface_spacing` | `number` | `0.5` | `support_interface_spacing` | support_interface_spacing (mm, 0=solid). Upstream default 0.5 |
+| `support_interface_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `support_interface_speed`, `time_lapse_gcode` |  |
 | `support_interface_top_layers` | `number` | `2` | `support_interface_top_layers` | support_interface_top_layers |
 | `support_object_first_layer_gap` | `number` | `0.2` | `support_object_first_layer_gap` | support_object_first_layer_gap (mm) |
 | `support_on_build_plate_only` | `boolean` | `false` | `support_on_build_plate_only` | support_on_build_plate_only: only support reaching the bed |
 | `support_overhang_min_area` | `number` | `0.0` | — | minimum overhang area (mm², 0 = auto w²). Replaces the morphological opening filter |
 | `support_remove_small_overhang` | `boolean` | `true` | `support_remove_small_overhang` | support_remove_small_overhang (upstream default true) |
+| `support_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `support_speed`, `time_lapse_gcode` |  |
 | `support_style` | `string` | `'grid'` | `support_style`, `support_type` | grid\|tree_lite |
 | `support_threshold_angle` | `number` | `30.0` | `support_threshold_angle` | support_threshold_angle |
 | `support_threshold_overlap` | `number` | `0.5` | `support_threshold_overlap` | support_threshold_overlap: the overlap criterion when θ=0 (as a fraction of extrusion width) |
@@ -183,9 +194,11 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 
 | Kernel param | Type | Default | From setting | Notes |
 | --- | --- | --- | --- | --- |
-| `bed_depth` | `number` | `256.0` | `printable_area` | bed size (offset = bed/2) |
+| `bed_depth` | `number` | `256.0` | `printable_area` | bed size |
 | `bed_height` | `number` | `0.0` | `printable_height` | printable_height (mm). 0 = no ceiling (backwards compatible) |
-| `bed_width` | `number` | `256.0` | `printable_area` | bed size (offset = bed/2) |
+| `bed_origin_x` | `number` | `0.0` | `printable_area` |  |
+| `bed_origin_y` | `number` | `0.0` | `printable_area` |  |
+| `bed_width` | `number` | `256.0` | `printable_area` | bed size |
 | `enable_arc_fitting` | `boolean` | `false` | `enable_arc_fitting` | enable_arc_fitting |
 | `machine_end_gcode` | `string` | — | `machine_end_gcode` | printer profile custom G-code. Empty = the mini-kernel's own preamble/footer only |
 | `machine_start_gcode` | `string` | — | `machine_start_gcode` | printer profile custom G-code. Empty = the mini-kernel's own preamble/footer only |
@@ -195,45 +208,69 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 
 | Kernel param | Type | Default | From setting | Notes |
 | --- | --- | --- | --- | --- |
+| `accel_to_decel_enable` | `boolean` | `false` | `accel_to_decel_enable`, `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `accel_to_decel_factor` | `number` | `50.0` | `accel_to_decel_factor`, `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` | percent |
 | `alternate_extra_wall` | `boolean` | `false` | `alternate_extra_wall` | alternate_extra_wall |
 | `arachne_dump` | `boolean` | `false` | — | temporary diagnostic: dump the PASS1 arachne input polygons to stderr |
 | `bottom_solid_infill_flow_ratio` | `number` | `1.0` | `bottom_solid_infill_flow_ratio` |  |
+| `bridge_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `bridge_acceleration`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `bridge_flow` | `number` | `1.0` | `bridge_flow` |  |
+| `default_acceleration` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `default_acceleration`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `default_jerk` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `default_jerk`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `detect_thin_wall` | `boolean` | `false` | `detect_thin_wall` | detect_thin_wall: medial-axis thin walls where one loop does not fit |
+| `disable_m73` | `boolean` | `true` | `before_layer_change_gcode`, `change_filament_gcode`, `disable_m73`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `economy` | `boolean` | `false` | — |  |
 | `emit_pe_tags` | `boolean` | `false` | — | emit PE tags on extrusion runs (enabled automatically when the real PE is used). Default false (backwards compatible) |
 | `extruder_count` | `number` | `1` | — | multi-material: how many extruders are used (1\|2) |
 | `extruder_filament_diameter` | `number[]` | `[]` | `filament_diameter` |  |
+| `extruder_first_layer_temp` | `number[]` | `[]` | `nozzle_temperature_initial_layer` | nozzle_temperature_initial_layer per extruder (the first layer's own) |
 | `extruder_flow_ratio` | `number[]` | `[]` | `filament_flow_ratio` |  |
 | `extruder_nozzle_temp` | `number[]` | `[]` | `nozzle_temperature` |  |
 | `extruder_retract_length` | `?` | `[]` | `filament_retraction_length` | undefined |
 | `extruder_retract_speed` | `?` | `[]` | `filament_retraction_speed` | undefined |
 | `extruder_z_hop` | `?` | `[]` | `filament_z_hop` | undefined |
 | `extrusion_rate_slope_segment_length` | `number` | `1.0` | — | segment split length for the real PE (mm) |
-| `filament_max_volumetric_speed` | `number[]` | `[]` | `filament_max_volumetric_speed` | mm³/s, per filament; empty = no cap (GW::capped_feed) |
+| `filament_max_volumetric_speed` | `number[]` | `[]` | `filament_max_volumetric_speed` | mm³/s, per filament; empty = no cap (GcodeWriter::capped_feed) |
 | `filter_out_gap_fill` | `number` | `0.0` | `filter_out_gap_fill` | filter_out_gap_fill (mm): gap fill shorter than this is dropped |
+| `first_layer_bed_temp` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `hot_plate_temp_initial_layer`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` | the plate type's _initial_layer bed option (<0 = none sent) |
 | `first_layer_flow_ratio` | `?` | — | `first_layer_flow_ratio` | undefined |
+| `first_layer_nozzle_temp` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `nozzle_temperature_initial_layer`, `time_lapse_gcode` | nozzle_temperature_initial_layer (<0 = none sent) |
 | `flush_into_infill` | `boolean` | `false` | `flush_into_infill` |  |
 | `flush_multiplier` | `number` | `1.0` | `flush_multiplier` | upstream scales the whole table by this |
 | `flush_volumes_matrix` | `number[]` | `[]` | `flush_volumes_matrix` |  |
 | `gap_fill_flow_ratio` | `?` | — | `gap_fill_flow_ratio` | undefined |
 | `gap_infill_speed` | `number[]` | `[]` | `gap_infill_speed` | gap_infill_speed (mm/s, per extruder): a first entry of 0 turns gap fill off (upstream has_gap_fill); empty = the schema's 30 |
 | `gcode_config_block` | `boolean` | `false` | — | ; CONFIG_BLOCK_START … the parameters this slice ran with … END |
+| `gcode_flavor` | `string` | — | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `gcode_flavor`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `gcode_role_tags` | `boolean` | `false` | — | ;TYPE:<role> on every role change (upstream GCodeProcessor tag) |
 | `gcode_stats_block` | `boolean` | `false` | — | ; filament used [mm]/[cm3]/[g], cost, total filament change |
 | `independent_support_layer_height` | `boolean` | `false` | `independent_support_layer_height` | false by default because of the kernel z grid constraint (gap quantized to layers) |
+| `initial_layer_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `initial_layer_acceleration`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `initial_layer_infill_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `initial_layer_infill_speed`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `initial_layer_jerk` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `initial_layer_jerk`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `initial_layer_travel_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `initial_layer_travel_acceleration`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `initial_layer_travel_jerk` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `initial_layer_travel_jerk`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `initial_layer_travel_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `initial_layer_travel_speed`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` | the first layer's travel speed |
+| `inner_wall_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `inner_wall_acceleration`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `inner_wall_flow_ratio` | `number` | `1.0` | `inner_wall_flow_ratio` |  |
+| `inner_wall_jerk` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `inner_wall_jerk`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `inner_wall_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `inner_wall_speed`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
+| `internal_solid_infill_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `internal_solid_infill_acceleration`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `internal_solid_infill_flow_ratio` | `?` | — | `internal_solid_infill_flow_ratio` | undefined |
+| `internal_solid_infill_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `internal_solid_infill_speed`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `keep_stages` | `boolean` | `false` | — | keep the stages cached after slicing (skips the early release — a memory trade-off) |
+| `machine_envelope` | `number[]` | `[]` | `before_layer_change_gcode`, `change_filament_gcode`, `emit_machine_limits_to_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `mm_group_split` | `number` | `0` | — | triangle group boundary index ([0,split)=T0, [split,N)=T1) |
 | `mm_group_splits` | `number[]` | `[]` | — |  |
 | `mm_group_tools` | `number[]` | `[]` | — |  |
 | `only_one_wall_first_layer` | `boolean` | `false` | `only_one_wall_first_layer` | only_one_wall_first_layer |
+| `outer_wall_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `outer_wall_acceleration`, `time_lapse_gcode` |  |
 | `outer_wall_flow_ratio` | `number` | `1.0` | `outer_wall_flow_ratio` |  |
+| `outer_wall_jerk` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `outer_wall_jerk`, `time_lapse_gcode` |  |
 | `pe_external_perimeter_only` | `boolean` | `false` | — | real PE: smooth outer walls only |
 | `pe_lite` | `boolean` | `true` | — | true = the effective PE-lite (default), false = the ported real PE (tagged g-code) |
 | `pe_strip_tags` | `boolean` | `true` | — | strip the tags from the final output after real PE post-processing |
-| `placeholder_config` | `string` | — | `filament_end_gcode`, `machine_end_gcode`, `machine_start_gcode` |  |
+| `placeholder_config` | `string` | — | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode` |  |
 | `precise_outer_wall` | `boolean` | `true` | `precise_outer_wall` | precise_outer_wall |
 | `prime_tower_ring_size` | `number` | `15.0` | — | side length of the fallback square ring (mm) |
 | `prime_tower_width` | `number` | `30.0` | `prime_tower_width` | width of the real WipeTower (mm). Separate from the square ring width (15). |
@@ -242,16 +279,28 @@ same unit — `first_layer_height` comes from `initial_layer_print_height`, and
 | `prime_volume` | `number` | `0.0` | `prime_volume` | extra volume primed on every change, on top of the pair's |
 | `print_flow_ratio` | `number` | `1.0` | `print_flow_ratio` |  |
 | `reduce_crossing_wall` | `boolean` | `false` | `reduce_crossing_wall` | wall-avoiding travel |
+| `reduce_infill_retraction` | `boolean` | `false` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `reduce_infill_retraction`, `time_lapse_gcode` | no retraction for a travel inside the infill (GCode::needs_retraction); off = the kernel's own rule |
 | `reuse_stages` | `number` | `0` | — |  |
 | `scarf_joint_flow_ratio` | `?` | — | `scarf_joint_flow_ratio` | undefined |
 | `set_other_flow_ratios` | `boolean` | `false` | `set_other_flow_ratios` |  |
+| `single_extruder_multi_material` | `boolean` | `true` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `single_extruder_multi_material`, `time_lapse_gcode` | one nozzle carries every filament: the switch names no tool |
 | `single_tool` | `number` | `0` | — |  |
+| `small_perimeter_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `small_perimeter_speed`, `time_lapse_gcode` | mm/s for a wall loop within small_perimeter_threshold; 0 = half the outer wall's |
+| `small_perimeter_threshold` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `small_perimeter_threshold`, `time_lapse_gcode` | a RADIUS (mm): loops up to 2*pi*threshold long are small (0 = off) |
 | `thick_bridges` | `boolean` | `false` | `thick_bridges` |  |
 | `time_engine` | `string` | `'full'` | — |  |
 | `top_bottom_infill_wall_overlap` | `number` | `25.0` | `top_bottom_infill_wall_overlap` | top_bottom_infill_wall_overlap (percent, first and topmost layer) |
 | `top_solid_infill_flow_ratio` | `number` | `1.0` | `top_solid_infill_flow_ratio` |  |
+| `top_surface_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode`, `top_surface_acceleration` |  |
+| `top_surface_jerk` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode`, `top_surface_jerk` |  |
+| `top_surface_speed` | `number` | `-1.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode`, `top_surface_speed` |  |
+| `travel_acceleration` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode`, `travel_acceleration` |  |
+| `travel_jerk` | `number` | `0.0` | `before_layer_change_gcode`, `change_filament_gcode`, `filament_end_gcode`, `filament_start_gcode`, `file_start_gcode`, `layer_change_gcode`, `machine_end_gcode`, `machine_start_gcode`, `time_lapse_gcode`, `travel_jerk` |  |
+| `use_firmware_retraction` | `boolean` | `false` | `use_firmware_retraction` | G10/G11 instead of E moves (upstream GCodeWriter::_retract) |
+| `use_relative_e_distances` | `boolean` | `true` | `use_relative_e_distances` | false = absolute E (M82, G92 E0 after each retraction), upstream's two modes |
 | `wall_direction` | `string` | `'ccw'` | `wall_direction` | wall_direction (ccw \| cw) |
 | `wall_sequence` | `string` | `'inner wall/outer wall'` | `wall_sequence` | wall_sequence (inner wall/outer wall \| outer wall/inner wall \| inner-outer-inner wall) |
+| `z_offset` | `number` | `0.0` | `z_offset` | added to every Z the G-code writes (upstream GCodeWriter, z_offset) |
 
 <!-- KERNEL-PARAMS:END -->
 

package/engine/src/contour_front_gpu.js

@@ -3,11 +3,11 @@
 //  between the cut and the union.
 //
 // What runs here (WGSL: contour_front_shaders.js), every layer at once:
-//   cut      per triangle, the layers it spans (exact z compares), each crossing in double-float, oriented as tri_plane
+//   cut      per triangle, the layers it spans (exact z compares), each crossing in double-float, oriented as intersect_triangle_with_plane
 //   cancel   segments coinciding exactly in opposite directions removed in pairs (cancel_coincident), by a hash on place
-//   chain    each end continues into the smallest unused segment starting at its 1e-3 mm key (chain_polys' greedy rule)
+//   chain    each end continues into the smallest unused segment starting at its 1e-3 mm key (chain_polygons' greedy rule)
 //   loops    pointer jumping for each loop's head and each segment's rank; tails that lead into a cycle stay out
-//   layout   loops sorted by (layer, head), laid out as chain_polys' n + 1 points, write_polygon's duplicates dropped
+//   layout   loops sorted by (layer, head), laid out as chain_polygons' n + 1 points, write_polygon's duplicates dropped
 //   tables   layer origins and grids, polygon ranges, the cell-list size
 //
 // Measured (design report gpu-full-port-trial-2026-10-01.md section 3): 3.0M triangles, 420 layers in 30 ms (the kernel's
@@ -205,10 +205,10 @@ export async function makeContourFront(device) {
     clear(loopStart, (headCount + 1) * 4)
     run(LOOPS_SHADER, 'lengths', 'urrrrwwwwwr', bound(uniform([segmentCount, padded, layerCount, headCount])), headCount)
     scan(loopStart, headCount + 1)
-    const [slotCount] = await readWords(loopStart, 1, headCount)      // points of the closed loops, chain_polys' n + 1 each
+    const [slotCount] = await readWords(loopStart, 1, headCount)      // points of the closed loops, chain_polygons' n + 1 each
     run(LOOPS_SHADER, 'place', 'urrrrwwwwwr', bound(uniform([segmentCount, padded, layerCount, headCount])), segmentCount)
 
-    // the points write_polygon keeps, the polygons chain_polys keeps, the layer boxes
+    // the points write_polygon keeps, the polygons chain_polygons keeps, the layer boxes
     const kept = buffer('kept', (slotCount + 1) * 4), polygonKept = buffer('polygonKept', (headCount + 1) * 4)
     const layerBox = buffer('layerBox', layerCount * 32), slotPolygon = buffer('slotPolygon', slotCount * 4)
     const boxStart = new Int32Array(layerCount * 8)

package/engine/src/contour_front_shaders.js

@@ -1,4 +1,4 @@
-// WGSL of the GPU front of PASS1 (contour_front_gpu.js): tri_plane -> chain_polys -> cancel_coincident ->
+// WGSL of the GPU front of PASS1 (contour_front_gpu.js): intersect_triangle_with_plane -> chain_polygons -> cancel_coincident ->
 //  build_gpu_input, every layer at once. Ported from the measured experiment (.omc/plans/gpu-work/fullport/gpu_slice.mjs,
 //  design report gpu-full-port-trial-2026-10-01.md section 3); edited only with a measurement beside it, as
 //  contour_gpu_shaders.js.

package/engine/src/settings.js

@@ -102,12 +102,14 @@ export function filamentPresets() {
   return filamentsPromise
 }
 
+// `parents` holds the abstract machine presets (`instantiation: false`): never offered by the picker, but a user
+//  preset file names one as its `inherits`, so printerSettings has to resolve it by name.
 function printerEntry(profileName) {
   for (const models of Object.values(printers.byVendor)) {
     const entry = models[profileName]
     if (entry) return entry
   }
-  return null
+  return printers.parents?.[profileName] ?? null
 }
 
 /** The settings a printer profile applies, ready to merge into the settings map. `null` when unknown. */

package/engine/src/slicer.worker.js

@@ -5,7 +5,7 @@
 //
 // Stage 30 (OOM tolerance): set_layer_sink lets the kernel emit layers as it produces them; each is transferred to main
 //  immediately (Float32Array buffers moved -> the worker copy is released at once) and the kernel frees that layer buffer
-//  from the heap. The resident result (the full gw.s + the full layersArr) disappears, so the WASM heap peak drops sharply
+//  from the heap. The resident result (the full GcodeWriter::gcode + the full layersArray) disappears, so the WASM heap peak drops sharply
 //  -> large models avoid OOM. The final 'done' carries stats only.
 //  In economy mode (params.economy) only G-code chunks are emitted, without toolpaths (finishes without a preview).
 //  The MM / real-PE paths fall back to batch mode.
@@ -27,7 +27,10 @@ import { FILL_TOOLS } from 'three-slicer-viewer/paint'
 //  and createSlicerClient both take an object and stringify it for you. One object, two shapes, and the difference
 //  showed up only at the boundary. The worker now accepts either; the SLA branch always did, which is what made
 //  the split arbitrary rather than principled.
-const paramsText = (params) => (typeof params === 'string' ? params : JSON.stringify(params ?? {}))
+const paramsText = (params) => {
+  if (typeof params === 'string') return params
+  return JSON.stringify(params ?? {})
+}
 
 let quiet = false
 const say = (level, ...args) => { if (!quiet) console[level](...args) }
@@ -120,7 +123,8 @@ const validatedPaintStates = (states) => {
 //  flow (viewer use_slicer.js) reads those two fields and nothing else.
 const reportedPaintStates = (message, paintedState) => {
   if (Array.isArray(message.states)) return validatedPaintStates(message.states)
-  return paintedState === null ? null : [paintedState]
+  if (paintedState === null) return null
+  return [paintedState]
 }
 
 // The state a paint message asks for: an explicit `state` wins, otherwise null meaning "use the legacy boolean path".
@@ -133,7 +137,10 @@ const explicitPaintState = (message) => {
 
 // Brush cursor shape (selector_bridge.h CURSOR_*). Sent as a name because the message is a protocol a host writes
 //  by hand; the integer stays on this side of it. Anything unknown is the sphere the brush has always used.
-const cursorShapeOf = (message) => (message.cursor === 'circle' ? 1 : 0)
+const cursorShapeOf = (message) => {
+  if (message.cursor === 'circle') return 1
+  return 0
+}
 
 // The tools that are not the radius brush: upstream's Smart fill and Bucket fill, plus its single-triangle POINTER
 //  cursor — which is literally bucket fill with propagation off, so the three share one dispatch. None of them takes
@@ -150,8 +157,15 @@ const strokeFrom = (message) =>
 // The fill modes the kernel's fill_preview takes (selector_bridge.h FILL_*), by the tool name the protocol uses.
 const FILL_PREVIEW_MODE = { smart: 0, bucket: 1, triangle: 2 }
 
+// A fill's angle limit in degrees, 30 when the message does not carry one. applyFill and the fill preview both
+//  read it here, so the preview selects what the fill will.
+const fillAngleOf = (message) => {
+  if (Number.isFinite(message.angle)) return message.angle
+  return 30
+}
+
 const applyFill = (Module, message, state) => {
-  const angle = Number.isFinite(message.angle) ? message.angle : 30
+  const angle = fillAngleOf(message)
   if (message.tool === 'smart') {
     if (state === null) Module.selector_seed_fill_erase(message.facet, message.hx, message.hy, message.hz, angle)
     else Module.selector_seed_fill(message.facet, message.hx, message.hy, message.hz, angle, state)
@@ -160,7 +174,8 @@ const applyFill = (Module, message, state) => {
   // Upstream passes -1 as the angle when it is not propagating (GLGizmoPainterBase.cpp ~861): with a single facet
   //  there is no neighbour to measure an angle against, and -1 is how that call says "no angle limit".
   const propagate = message.tool === 'bucket'
-  const bucketAngle = propagate ? angle : -1
+  let bucketAngle = -1
+  if (propagate) bucketAngle = angle
   if (state === null) Module.selector_bucket_fill_erase(message.facet, message.hx, message.hy, message.hz, bucketAngle, propagate)
   else Module.selector_bucket_fill(message.facet, message.hx, message.hy, message.hz, bucketAngle, propagate, state)
 }
@@ -276,7 +291,9 @@ const handleMessage = async (e) => {
     // `keepPaint` says the mesh is the same model in a new place, so the marks carry over — the reply reports whether
     //  they actually did, since a face-count change makes the kernel fall back to a clean registration.
     if (d.cmd === 'prepare') {
-      const kept = d.keepPaint ? Module.selector_reprepare(new Uint8Array(d.stl)) : (Module.selector_prepare(new Uint8Array(d.stl)), false)
+      let kept = false
+      if (d.keepPaint) kept = Module.selector_reprepare(new Uint8Array(d.stl))
+      else Module.selector_prepare(new Uint8Array(d.stl))
       reply({ type: 'prepared', facets: Module.selector_facet_count(), kept })
       return
     }
@@ -321,7 +338,8 @@ const handleMessage = async (e) => {
     //  A kernel built before this binding existed simply has no selector_import_paint; the reply says applied:0
     //  rather than throwing, because losing a 3mf's paint must not also lose its geometry.
     if (d.cmd === 'importPaint') {
-      const applied = Module.selector_import_paint ? Module.selector_import_paint(d.facets, d.hex ?? '') : 0
+      let applied = 0
+      if (Module.selector_import_paint) applied = Module.selector_import_paint(d.facets, d.hex ?? '')
       const importedReply = paintedReply(Module, d, null)
       importedReply.applied = applied
       reply(importedReply); return
@@ -332,7 +350,8 @@ const handleMessage = async (e) => {
     //  which objects were merged in what order is the viewer's knowledge. A kernel built before the binding existed
     //  reports supported:false rather than throwing — the save then falls back to the paint it imported.
     if (d.cmd === 'exportPaint') {
-      const exported = Module.selector_export_paint ? Module.selector_export_paint() : null
+      let exported = null
+      if (Module.selector_export_paint) exported = Module.selector_export_paint()
       reply({ type: 'paintExport', supported: !!Module.selector_export_paint,
                          facets: exported?.facets ?? [], hex: exported?.hex ?? '' })
       return
@@ -358,9 +377,11 @@ const handleMessage = async (e) => {
       // enf/blk stay unconditional for the listener that predates the per-state map. When the request names states,
       //  they are the ONLY ones read, so building the other two would be pure waste on the hot path.
       const wanted = states && !states.includes(PAINT_STATE_ENFORCER) && !states.includes(PAINT_STATE_BLOCKER)
-      const overlayReply = { type: 'overlay',
-        enf: wanted ? EMPTY_OVERLAY : Module.selector_overlay(true),
-        blk: wanted ? EMPTY_OVERLAY : Module.selector_overlay(false) }
+      const overlayReply = { type: 'overlay', enf: EMPTY_OVERLAY, blk: EMPTY_OVERLAY }
+      if (!wanted) {
+        overlayReply.enf = Module.selector_overlay(true)
+        overlayReply.blk = Module.selector_overlay(false)
+      }
       if (states) overlayReply.overlays = Object.fromEntries(states.map(state => [state, Module.selector_overlay_state(state)]))
       const transfer = [overlayReply.enf, overlayReply.blk, ...Object.values(overlayReply.overlays ?? {})]
         .filter(a => a?.buffer && a.byteLength > 0).map(a => a.buffer)
@@ -374,13 +395,15 @@ const handleMessage = async (e) => {
     if (d.cmd === 'fillPreview') {
       if (!Module.selector_fill_preview) { reply({ type: 'fillPreview', supported: false, tris: EMPTY_OVERLAY }); return }
       if (d.clear) { Module.selector_fill_preview_clear(); reply({ type: 'fillPreview', supported: true, tris: EMPTY_OVERLAY }); return }
-      const angle = Number.isFinite(d.angle) ? d.angle : 30
       const mode = FILL_PREVIEW_MODE[d.tool] ?? FILL_PREVIEW_MODE.smart
       // Upstream's -1 for the non-propagating case, the same value applyFill sends: one facet has no neighbour to
       //  measure an angle against.
-      const tris = Module.selector_fill_preview(d.facet, d.hx, d.hy, d.hz, mode === FILL_PREVIEW_MODE.triangle ? -1 : angle, mode)
-      reply({ type: 'fillPreview', supported: true, tris },
-                       tris?.buffer && tris.byteLength > 0 ? [tris.buffer] : [])
+      let previewAngle = fillAngleOf(d)
+      if (mode === FILL_PREVIEW_MODE.triangle) previewAngle = -1
+      const previewTriangles = Module.selector_fill_preview(d.facet, d.hx, d.hy, d.hz, previewAngle, mode)
+      const transfer = []
+      if (previewTriangles?.buffer && previewTriangles.byteLength > 0) transfer.push(previewTriangles.buffer)
+      reply({ type: 'fillPreview', supported: true, tris: previewTriangles }, transfer)
       return
     }
     // paintMode: the brush-wide options upstream keeps on the gizmo — the overhang restriction and the section

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "three-slicer",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Browser/WASM 3D-printing slicer reverse-engineered from OrcaSlicer: slicing engine (Arachne walls, tree/grid supports, multi-material), SLA resin slicing with PrusaSlicer's ported support/pad chain and .sl1 export, React viewer with GPU toolpath preview, and schema-driven settings UI.",
   "license": "AGPL-3.0-or-later",
   "type": "module",
@@ -134,6 +134,6 @@
     "clipping"
   ],
   "dependencies": {
-    "three-slicer-viewer": "0.3.3"
+    "three-slicer-viewer": "0.3.5"
   }
 }

package/types/data/printers.json.d.ts

@@ -24,6 +24,9 @@ export interface PrinterData {
   text?: unknown[]
   /** Vendor -> printer profile name -> entry */
   byVendor: Record<string, Record<string, PrinterEntry>>
+  /** The abstract machine presets (`instantiation: false`) by name: not offered for picking, but resolvable as
+   *  the parent a user preset file `inherits` */
+  parents?: Record<string, PrinterEntry>
 }
 
 declare const printers: PrinterData

package/types/settings.d.ts

@@ -17,7 +17,20 @@ export function settingScalar(settings: SlicerSettings | null | undefined, key:
  * ponytail: 53 returned keys, so Record instead of listing each — kernel params are passed straight to slice(),
  * not an API consumers read field by field. Expand it when field access is actually needed.
  */
-export function deriveKernelParams(settings: SlicerSettings | null | undefined, opts?: { plate?: number }): Record<string, unknown>
+export function deriveKernelParams(settings: SlicerSettings | null | undefined, opts?: { plate?: number; objectNames?: string[] }): Record<string, unknown>
+/**
+ * The printable area's lower-left corner and its centre in printer coordinates, from deriveKernelParams' output.
+ * The kernel slices in a plate frame centred on the bed and adds the centre on output, so a stored printer
+ * coordinate (wipe_tower_x/y, a 3mf position, G-code) converts to that frame by subtracting `bedCenter`.
+ */
+export function bedOrigin(params: Record<string, unknown> | null | undefined): { x: number; y: number }
+/** Code of a printer profile setting the template path reads but does not do yet. */
+export const PARTIAL_SUPPORT_CODE: 'PROFILE_PARTIAL_SUPPORT'
+/** The tool change settings a profile sets that the template path does not apply (empty off the template path or
+ *  with one tool), each with what happens instead. */
+export function partialSupport(settings: SlicerSettings | null | undefined, opts?: { toolCount?: number }):
+  { code: 'PROFILE_PARTIAL_SUPPORT'; key: string; effect: string }[]
+export function bedCenter(params: Record<string, unknown> | null | undefined): { x: number; y: number }
 
 /**
  * Clear-then-merge preset application: deletes `keys` (the catalog's own key set) from `settings`, then