three-slicer 0.2.2 → 0.2.4

package/engine/PARAMS.md

@@ -0,0 +1,248 @@
+# three-slicer — kernel parameter reference
+
+The FFF kernel's accepted parameter set, generated from the kernel's own reader (`params.cpp`) — see
+[README.md](README.md) for install/usage and how these params are produced from an OrcaSlicer settings map.
+
+Generated from the kernel's own reader (`params.cpp`) — it is the definition of the accepted key set, so this table
+cannot drift from what `slice()` actually honours. Regenerate with `node types/gen_kernel_params.mjs`.
+
+<!-- KERNEL-PARAMS:BEGIN — generated by types/gen_kernel_params.mjs, do not edit by hand -->
+
+The kernel accepts **159 parameters**. `deriveKernelParams()` produces 131 of them from the
+OrcaSlicer settings map; the remaining 28 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.
+
+A parameter left out of the object keeps the default listed here, so sending a partial object is normal and is
+what `deriveKernelParams()` itself does.
+
+*From setting* names the schema key the value is read from, which is often **not** the same name and not the
+same unit — `first_layer_height` comes from `initial_layer_print_height`, and `infill_density` is
+`sparse_infill_density` divided by 100 (a settings map holding `20` produces `0.2` here).
+
+### Geometry and walls
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `auto_center` | `boolean` | `false` | — | stage 28: true = realign the combined bbox to the origin (stage-3 legacy). false (default) = trust the viewer coordinates (no realignment, only Z seating) -> the toolpath overlaps the on-screen model exactly. Upstream = only the plate origin offset (GCode.cpp:932). |
+| `first_layer_height` | `number` | `0.2` | `initial_layer_print_height` |  |
+| `gcode_resolution` | `number` | `0.01` | `resolution` | resolution (mm): path simplification tolerance. Upstream PrintConfig default 0.01 |
+| `initial_layer_line_width` | `number` | `0` | `initial_layer_line_width` |  |
+| `inner_wall_line_width` | `number` | `0` | `inner_wall_line_width` |  |
+| `internal_solid_infill_line_width` | `number` | `0` | `internal_solid_infill_line_width` |  |
+| `layer_height` | `number` | `0.2` | `layer_height` |  |
+| `line_width` | `number` | `0.42` | `line_width` |  |
+| `outer_wall_line_width` | `number` | `0` | `outer_wall_line_width` |  |
+| `sparse_infill_line_width` | `number` | `0` | `sparse_infill_line_width` |  |
+| `spiral_mode` | `boolean` | `false` | `spiral_mode` | spiral_mode (vase) |
+| `support_line_width` | `number` | `0.0` | `support_line_width` | support_line_width (0=auto; the real tree support extrusion width) |
+| `top_surface_line_width` | `number` | `0` | `top_surface_line_width` |  |
+| `wall_generator` | `string` | `'classic'` | `wall_generator` | classic\|arachne (arachne = the real ported WallToolPaths) |
+| `wall_loops` | `number` | `2` | `wall_loops` |  |
+
+### Infill
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `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` |  |
+| `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_filament_id` | `number` | `0` | `sparse_infill_filament_id` |  |
+| `sparse_infill_pattern` | `string` | `'rectilinear'` | `sparse_infill_pattern` | rectilinear\|grid\|triangles\|zigzag\|gyroid |
+| `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` |  |
+| `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] |
+| `fan_speed` | `number` | `100.0` | `fan_max_speed` | fan_speed (%) |
+| `filament_diameter` | `number` | `1.75` | `filament_diameter` |  |
+| `first_layer_speed` | `number` | `20` | `initial_layer_speed` |  |
+| `flow_ratio` | `number` | `1.0` | `filament_flow_ratio` |  |
+| `full_fan_speed_layer` | `number` | `3` | `full_fan_speed_layer` | full_fan_speed_layer |
+| `machine_accel_print` | `number` | `5000` | `default_acceleration` | mm/s² |
+| `machine_accel_retract` | `number` | `5000` | `machine_max_acceleration_retracting` | mm/s² |
+| `machine_accel_travel` | `number` | `5000` | `travel_acceleration` | mm/s² |
+| `machine_jerk_e` | `number` | `2.5` | `machine_max_jerk_e` | mm/s |
+| `machine_jerk_xy` | `number` | `9.0` | `machine_max_jerk_x` | mm/s |
+| `machine_jerk_z` | `number` | `0.4` | `machine_max_jerk_z` | mm/s |
+| `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_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 |
+| `max_volumetric_extrusion_rate_slope` | `number` | `0.0` | `max_volumetric_extrusion_rate_slope` | PE-lite flow change rate limit (mm³/s², 0=off) |
+| `nozzle_diameter` | `number` | `0.4` | `nozzle_diameter` |  |
+| `nozzle_temp` | `number` | `210` | `nozzle_temperature` |  |
+| `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) |
+| `travel_speed` | `number` | `150` | `travel_speed` |  |
+
+### Retraction and seams
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `retract_length` | `number` | `0.8` | `filament_retraction_length`, `retraction_length` | retraction_length/speed[0], z_hop[0] |
+| `retract_speed` | `number` | `30.0` | `filament_retraction_speed`, `retraction_speed` | retraction_length/speed[0], z_hop[0] |
+| `retraction_minimum_travel` | `number` | `2.0` | `filament_retraction_minimum_travel`, `retraction_minimum_travel` | retraction_minimum_travel (mm): minimum travel that triggers a retraction |
+| `scarf_length` | `number` | `10.0` | — | length of the scarf z/flow ramp (mm) |
+| `seam_position` | `string` | `'back'` | `seam_position` | nearest\|aligned\|back\|random |
+| `seam_slope_type` | `string` | `'none'` | `seam_slope_type` | none\|external\|all -> scarf seam (external/all = on) |
+| `z_hop` | `number` | `0.4` | `filament_z_hop`, `z_hop` | retraction_length/speed[0], z_hop[0] |
+
+### Adhesion (skirt, brim, raft)
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `brim_object_gap` | `number` | `0.0` | `brim_object_gap` | brim_object_gap (mm): gap between brim and object |
+| `brim_width` | `number` | `0.0` | `brim_width` | skirt_distance / brim_width |
+| `raft_contact_distance` | `number` | `0.1` | `raft_contact_distance` | raft_contact_distance (mm) |
+| `raft_expansion` | `number` | `1.5` | `raft_expansion` | raft_expansion (mm). Upstream default 1.5 (previously hardcoded to 3.0) |
+| `raft_first_layer_height` | `number` | `0.30` | — | raft first layer height (mm) |
+| `raft_layers` | `number` | `0` | `raft_layers` | raft_layers |
+| `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 |
+
+### Support
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `bridge_no_support` | `boolean` | `false` | `bridge_no_support` | bridge_no_support: no support under bridge regions |
+| `enable_support` | `boolean` | `false` | `enable_support` | enable_support |
+| `support_angle` | `number` | `0.0` | `support_angle` | support_angle: base angle of the support body (°). Upstream SupportParameters::base_angle |
+| `support_auto` | `boolean` | `true` | — | stage 20: true = automatic overhang detection, false = manual (painted enforcers only) |
+| `support_base_pattern` | `string` | `'default'` | `support_base_pattern` | support_base_pattern: default\|rectilinear\|rectilinear-grid\|honeycomb\|... |
+| `support_base_pattern_spacing` | `number` | `2.5` | `support_base_pattern_spacing` | support_base_pattern_spacing (mm). Determines spacing together with density |
+| `support_bottom_z_distance` | `number` | `0.2` | `support_bottom_z_distance` | stage 32: z gap under support resting on a model top surface (default 0.2 = equivalent to today's 1 layer -> default behavior and golden unchanged) |
+| `support_density` | `number` | `0.15` | — | density of the support body |
+| `support_expansion` | `number` | `0.0` | `support_expansion` | support_expansion (mm): expands the overhang region |
+| `support_filament` | `number` | `0` | `support_filament` | filament for the support base (and, upstream, the raft) |
+| `support_grid_snap` | `boolean` | `true` | — | equivalent of the upstream SupportGridPattern (default behavior of the grid style) |
+| `support_interface_bottom_layers` | `number` | `0` | `support_interface_bottom_layers` | support_interface_bottom_layers (0 = none) |
+| `support_interface_filament` | `number` | `0` | `support_interface_filament` | filament for the support interface |
+| `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_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_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) |
+| `support_top_z_distance` | `number` | `0.2` | `support_top_z_distance` | support_top_z_distance |
+| `support_xy_distance` | `number` | `0.35` | `support_object_xy_distance` | support_object_xy_distance |
+| `tree_lite_min_radius` | `number` | `1.5` | — | tree_lite taper constants (our own approximation — no matching upstream key) |
+| `tree_lite_shrink` | `number` | `0.5` | — | tree_lite taper constants (our own approximation — no matching upstream key) |
+| `tree_style` | `string` | `'organic'` | — | organic\|slim\|strong\|hybrid (upstream support_style smsTree*) |
+| `tree_support_angle_slow` | `number` | `25.0` | `tree_support_angle_slow` | tree_support_angle_slow (deg) |
+| `tree_support_branch_angle` | `number` | `40.0` | `tree_support_branch_angle` | fallback spelling — `tree_support_branch_angle_organic` wins when both are sent |
+| `tree_support_branch_angle_organic` | `number` | `40.0` | `tree_support_branch_angle_organic` | tree_support_branch_angle_organic (deg) |
+| `tree_support_branch_diameter` | `number` | `2.0` | `tree_support_branch_diameter` | fallback spelling — `tree_support_branch_diameter_organic` wins when both are sent |
+| `tree_support_branch_diameter_angle` | `number` | `5.0` | `tree_support_branch_diameter_angle` | tree_support_branch_diameter_angle (deg) |
+| `tree_support_branch_diameter_organic` | `number` | `2.0` | `tree_support_branch_diameter_organic` | tree_support_branch_diameter_organic (mm) |
+| `tree_support_branch_distance` | `number` | `1.0` | `tree_support_branch_distance` | fallback spelling — `tree_support_branch_distance_organic` wins when both are sent |
+| `tree_support_branch_distance_organic` | `number` | `1.0` | `tree_support_branch_distance_organic` | tree_support_branch_distance_organic (mm) |
+| `tree_support_tip_diameter` | `number` | `0.8` | `tree_support_tip_diameter` | tree_support_tip_diameter (mm) |
+| `tree_support_top_rate` | `number` | `30.0` | `tree_support_top_rate` | tree_support_top_rate (%) |
+| `tree_support_wall_count` | `number` | `0` | `tree_support_wall_count` | tree_support_wall_count (organic applies max(1,·) internally) |
+
+### Multi-material and prime tower
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `bottom_surface_filament_id` | `number` | `0` | `bottom_surface_filament_id` |  |
+| `enable_prime_tower` | `boolean` | `true` | `enable_prime_tower` |  |
+| `filament_cost` | `number[]` | `[]` | `filament_cost` | currency per kg, per filament |
+| `filament_density` | `number[]` | `[]` | `filament_density` | g/cm3, per filament |
+| `filament_map` | `number[]` | `[]` | `filament_map` |  |
+| `filament_settings_id` | `vector<std::string>` | `[]` | `filament_settings_id` |  |
+| `filament_type` | `vector<std::string>` | `[]` | `filament_type` |  |
+| `inner_wall_filament_id` | `number` | `0` | `inner_wall_filament_id` |  |
+| `internal_solid_filament_id` | `number` | `0` | `internal_solid_filament_id` |  |
+| `outer_wall_filament_id` | `number` | `0` | `outer_wall_filament_id` |  |
+| `top_surface_filament_id` | `number` | `0` | `top_surface_filament_id` |  |
+| `wipe_tower_real` | `boolean` | `false` | — | stage 12: use the real WipeTower.generate() on MM changes instead of the stage-6 square ring |
+
+### Bed and machine G-code
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `bed_depth` | `number` | `256.0` | `printable_area` | bed size (offset = bed/2) |
+| `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) |
+| `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 |
+| `printable_height` | `number` | `250.0` | `printable_height` | printable_height (mm) — the tree BuildVolume height |
+
+### Engine, streaming and diagnostics
+
+| Kernel param | Type | Default | From setting | Notes |
+| --- | --- | --- | --- | --- |
+| `arachne_dump` | `boolean` | `false` | — | temporary diagnostic: dump the PASS1 arachne input polygons to stderr |
+| `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_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) |
+| `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` |  |
+| `gcode_config_block` | `boolean` | `false` | — | ; CONFIG_BLOCK_START … the parameters this slice ran with … END |
+| `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) |
+| `keep_stages` | `boolean` | `false` | — | keep the stages cached after slicing (skips the early release — a memory trade-off) |
+| `mm_group_split` | `number` | `0` | — | triangle group boundary index ([0,split)=T0, [split,N)=T1) |
+| `mm_group_splits` | `number[]` | `[]` | — |  |
+| `mm_group_tools` | `number[]` | `[]` | — |  |
+| `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 |
+| `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). |
+| `prime_tower_x` | `number` | `10.0` | `wipe_tower_x` |  |
+| `prime_tower_y` | `number` | `10.0` | `wipe_tower_y` |  |
+| `prime_volume` | `number` | `0.0` | `prime_volume` | extra volume primed on every change, on top of the pair's |
+| `reduce_crossing_wall` | `boolean` | `false` | `reduce_crossing_wall` | wall-avoiding travel |
+| `reuse_stages` | `number` | `0` | — |  |
+| `time_engine` | `string` | `'full'` | — |  |
+
+<!-- KERNEL-PARAMS:END -->
+
+## The parameters no setting reaches
+
+A `—` in *From setting* means there is no OrcaSlicer option behind that parameter, so it exists only if you put it
+in the params object yourself. They are not one kind of thing, and the difference matters before you reach for one:
+
+- **Host runtime flags** — `economy`, `keep_stages`, `reuse_stages`, `time_engine`, `wipe_tower_real`,
+  `gcode_stats_block`, `gcode_config_block`. Decisions the *caller* makes about a particular run, not properties of
+  the print. `economy` is the last rung of an out-of-memory retry: it streams G-code and skips the preview
+  toolpaths and the time estimate, so a model that cannot finish any other way still finishes.
+- **Values the viewer computes** — `extruder_count`, `mm_group_split`, `mm_group_splits`, `mm_group_tools`,
+  `auto_center`. These come from the scene (how many extruders are loaded, which triangle ranges belong to which
+  tool), so there is nothing for a settings map to hold. `<Viewport/>` fills them in at slice time.
+- **Kernel-only tuning** — `support_density`, `support_auto`, `support_grid_snap`, `support_overhang_min_area`,
+  `tree_style`, `tree_lite_shrink`, `tree_lite_min_radius`, `scarf_length`, `prime_tower_ring_size`,
+  `raft_first_layer_height`, `extrusion_rate_slope_segment_length`. Real knobs with no upstream option of the same
+  name — some are this kernel's own approximations (the `tree_lite_*` taper), others are upstream behaviour that
+  upstream never exposed as a setting.
+- **Diagnostics** — `arachne_dump`, `pe_lite`, `pe_strip_tags`, `pe_external_perimeter_only`, `emit_pe_tags`. Left
+  at their defaults unless you are working on the kernel itself. `pe_lite` in particular defaults to `true` because
+  the real pressure equalizer only acts on G-code carrying OrcaSlicer's `;_EXTRUDE_SET_SPEED` tags, which this
+  kernel emits only when asked.

package/engine/README.md

@@ -17,7 +17,7 @@ npm i three-slicer
 ```js
 import { createSlicer } from 'three-slicer'
 
-const slicer = await createSlicer()               // loads the WASM kernel (~3.3 MB, base64-inlined)
+const slicer = await createSlicer()               // loads the WASM kernel (embedded in the ~4.8 MB JS glue)
 
 // Batch: full result at once
 const r = slicer.slice(stlArrayBuffer, { layer_height: 0.2, wall_loops: 2 })
@@ -31,288 +31,45 @@ slicer.slice(stlArrayBuffer, params, {
 slicer.dispose()
 ```
 
-Off-main-thread (browser): `new Worker(engineWorkerURL(), { type: 'module' })` — the worker speaks a streaming protocol (`{type: 'layer' | 'done' | 'error' | 'progress'}`). Subpath `three-slicer/worker` exposes the worker entry for bundler-specific setups.
+Off-main-thread (browser): `new Worker(engineWorkerURL(), { type: 'module' })` — the worker speaks a streaming protocol (`{type: 'layer' | 'done' | 'error' | 'progress'}`). Subpath `three-slicer/worker` exposes the worker entry for bundler-specific setups, and `three-slicer/client` wraps the protocol in promises (`createSlicerClient()` — `warmup()`, `slice()`, `sliceSla()`, `cancel()`; cancellation needs the multithreaded kernel, i.e. a cross-origin-isolated page).
+
+The handle also carries `sliceSla(stl, slaParams)` for the resin path (see [SLA parameters](#sla-parameters)) and the painting surface `paintPrepare` / `paint` / `paintClear` / `overlay`.
 
 ## Parameters
 
 Two levels — use whichever fits:
 
-1. **Kernel params (this package's native contract)** — a flat JSON object (`layer_height`, `wall_loops`, `infill_density` 0–1, `sparse_infill_pattern`, `enable_support`, `wall_generator: 'classic' | 'arachne'`, …). Every accepted key is listed under [Kernel parameter reference](#kernel-parameter-reference) below.
-2. **OrcaSlicer settings map** — a sparse `{schemaKey: value}` map using original OrcaSlicer option keys (923 defined in `three-slicer/data`); unset keys fall back to schema defaults:
+1. **Kernel params (this package's native contract)** — a flat JSON object (`layer_height`, `wall_loops`, `infill_density` 0–1, `sparse_infill_pattern`, `enable_support`, `wall_generator: 'classic' | 'arachne'`, …). Every accepted key is listed in [PARAMS.md](PARAMS.md).
+2. **OrcaSlicer settings map** — a sparse `{schemaKey: value}` map using original OrcaSlicer option keys (976 defined in `three-slicer/data`); unset keys fall back to schema defaults:
 
 ```js
 import { deriveKernelParams } from 'three-slicer/settings'
 slicer.slice(stl, deriveKernelParams({ layer_height: 0.25, sparse_infill_density: 15 }))
 ```
 
-**Known limit:** `deriveKernelParams` maps a curated subset of schema keys to kernel params. Editing other schema keys has no slicing effect (they exist for UI/metadata). Scalar options use their first element only; the filament options listed under *Materials* below are the exception — those keep every extruder's entry. Kernel parameters with no schema key behind them are reachable only by writing the params object yourself — the reference table marks which those are.
+**Known limit:** `deriveKernelParams` maps a curated subset of schema keys to kernel params. Editing other schema keys has no slicing effect (they exist for UI/metadata). Scalar options use their first element only; the filament options listed under *Materials* below are the exception — those keep every extruder's entry. Kernel parameters with no schema key behind them are reachable only by writing the params object yourself — [PARAMS.md](PARAMS.md) marks which those are.
 
 ## Kernel parameter reference
 
-Generated from the kernel's own reader (`params.cpp`) — it is the definition of the accepted key set, so this table
-cannot drift from what `slice()` actually honours. Regenerate with `node types/gen_kernel_params.mjs`.
-
-<!-- KERNEL-PARAMS:BEGIN — generated by types/gen_kernel_params.mjs, do not edit by hand -->
-
-The kernel accepts **159 parameters**. `deriveKernelParams()` produces 131 of them from the
-OrcaSlicer settings map; the remaining 28 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.
-
-A parameter left out of the object keeps the default listed here, so sending a partial object is normal and is
-what `deriveKernelParams()` itself does.
-
-*From setting* names the schema key the value is read from, which is often **not** the same name and not the
-same unit — `first_layer_height` comes from `initial_layer_print_height`, and `infill_density` is
-`sparse_infill_density` divided by 100 (a settings map holding `20` produces `0.2` here).
-
-### Geometry and walls
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `auto_center` | `boolean` | `false` | — | stage 28: true = realign the combined bbox to the origin (stage-3 legacy). false (default) = trust the viewer coordinates (no realignment, only Z seating) -> the toolpath overlaps the on-screen model exactly. Upstream = only the plate origin offset (GCode.cpp:932). |
-| `first_layer_height` | `number` | `0.2` | `initial_layer_print_height` |  |
-| `gcode_resolution` | `number` | `0.01` | `resolution` | resolution (mm): path simplification tolerance. Upstream PrintConfig default 0.01 |
-| `initial_layer_line_width` | `number` | `0` | `initial_layer_line_width` |  |
-| `inner_wall_line_width` | `number` | `0` | `inner_wall_line_width` |  |
-| `internal_solid_infill_line_width` | `number` | `0` | `internal_solid_infill_line_width` |  |
-| `layer_height` | `number` | `0.2` | `layer_height` |  |
-| `line_width` | `number` | `0.42` | `line_width` |  |
-| `outer_wall_line_width` | `number` | `0` | `outer_wall_line_width` |  |
-| `sparse_infill_line_width` | `number` | `0` | `sparse_infill_line_width` |  |
-| `spiral_mode` | `boolean` | `false` | `spiral_mode` | spiral_mode (vase) |
-| `support_line_width` | `number` | `0.0` | `support_line_width` | support_line_width (0=auto; the real tree support extrusion width) |
-| `top_surface_line_width` | `number` | `0` | `top_surface_line_width` |  |
-| `wall_generator` | `string` | `'classic'` | `wall_generator` | classic\|arachne (arachne = the real ported WallToolPaths) |
-| `wall_loops` | `number` | `2` | `wall_loops` |  |
-
-### Infill
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `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` |  |
-| `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_filament_id` | `number` | `0` | `sparse_infill_filament_id` |  |
-| `sparse_infill_pattern` | `string` | `'rectilinear'` | `sparse_infill_pattern` | rectilinear\|grid\|triangles\|zigzag\|gyroid |
-| `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` |  |
-| `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] |
-| `fan_speed` | `number` | `100.0` | `fan_max_speed` | fan_speed (%) |
-| `filament_diameter` | `number` | `1.75` | `filament_diameter` |  |
-| `first_layer_speed` | `number` | `20` | `initial_layer_speed` |  |
-| `flow_ratio` | `number` | `1.0` | `filament_flow_ratio` |  |
-| `full_fan_speed_layer` | `number` | `3` | `full_fan_speed_layer` | full_fan_speed_layer |
-| `machine_accel_print` | `number` | `5000` | `default_acceleration` | mm/s² |
-| `machine_accel_retract` | `number` | `5000` | `machine_max_acceleration_retracting` | mm/s² |
-| `machine_accel_travel` | `number` | `5000` | `travel_acceleration` | mm/s² |
-| `machine_jerk_e` | `number` | `2.5` | `machine_max_jerk_e` | mm/s |
-| `machine_jerk_xy` | `number` | `9.0` | `machine_max_jerk_x` | mm/s |
-| `machine_jerk_z` | `number` | `0.4` | `machine_max_jerk_z` | mm/s |
-| `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_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 |
-| `max_volumetric_extrusion_rate_slope` | `number` | `0.0` | `max_volumetric_extrusion_rate_slope` | PE-lite flow change rate limit (mm³/s², 0=off) |
-| `nozzle_diameter` | `number` | `0.4` | `nozzle_diameter` |  |
-| `nozzle_temp` | `number` | `210` | `nozzle_temperature` |  |
-| `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) |
-| `travel_speed` | `number` | `150` | `travel_speed` |  |
-
-### Retraction and seams
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `retract_length` | `number` | `0.8` | `filament_retraction_length`, `retraction_length` | retraction_length/speed[0], z_hop[0] |
-| `retract_speed` | `number` | `30.0` | `filament_retraction_speed`, `retraction_speed` | retraction_length/speed[0], z_hop[0] |
-| `retraction_minimum_travel` | `number` | `2.0` | `filament_retraction_minimum_travel`, `retraction_minimum_travel` | retraction_minimum_travel (mm): minimum travel that triggers a retraction |
-| `scarf_length` | `number` | `10.0` | — | length of the scarf z/flow ramp (mm) |
-| `seam_position` | `string` | `'back'` | `seam_position` | nearest\|aligned\|back\|random |
-| `seam_slope_type` | `string` | `'none'` | `seam_slope_type` | none\|external\|all -> scarf seam (external/all = on) |
-| `z_hop` | `number` | `0.4` | `filament_z_hop`, `z_hop` | retraction_length/speed[0], z_hop[0] |
-
-### Adhesion (skirt, brim, raft)
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `brim_object_gap` | `number` | `0.0` | `brim_object_gap` | brim_object_gap (mm): gap between brim and object |
-| `brim_width` | `number` | `0.0` | `brim_width` | skirt_distance / brim_width |
-| `raft_contact_distance` | `number` | `0.1` | `raft_contact_distance` | raft_contact_distance (mm) |
-| `raft_expansion` | `number` | `1.5` | `raft_expansion` | raft_expansion (mm). Upstream default 1.5 (previously hardcoded to 3.0) |
-| `raft_first_layer_height` | `number` | `0.30` | — | raft first layer height (mm) |
-| `raft_layers` | `number` | `0` | `raft_layers` | raft_layers |
-| `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 |
-
-### Support
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `bridge_no_support` | `boolean` | `false` | `bridge_no_support` | bridge_no_support: no support under bridge regions |
-| `enable_support` | `boolean` | `false` | `enable_support` | enable_support |
-| `support_angle` | `number` | `0.0` | `support_angle` | support_angle: base angle of the support body (°). Upstream SupportParameters::base_angle |
-| `support_auto` | `boolean` | `true` | — | stage 20: true = automatic overhang detection, false = manual (painted enforcers only) |
-| `support_base_pattern` | `string` | `'default'` | `support_base_pattern` | support_base_pattern: default\|rectilinear\|rectilinear-grid\|honeycomb\|... |
-| `support_base_pattern_spacing` | `number` | `2.5` | `support_base_pattern_spacing` | support_base_pattern_spacing (mm). Determines spacing together with density |
-| `support_bottom_z_distance` | `number` | `0.2` | `support_bottom_z_distance` | stage 32: z gap under support resting on a model top surface (default 0.2 = equivalent to today's 1 layer -> default behavior and golden unchanged) |
-| `support_density` | `number` | `0.15` | — | density of the support body |
-| `support_expansion` | `number` | `0.0` | `support_expansion` | support_expansion (mm): expands the overhang region |
-| `support_filament` | `number` | `0` | `support_filament` | filament for the support base (and, upstream, the raft) |
-| `support_grid_snap` | `boolean` | `true` | — | equivalent of the upstream SupportGridPattern (default behavior of the grid style) |
-| `support_interface_bottom_layers` | `number` | `0` | `support_interface_bottom_layers` | support_interface_bottom_layers (0 = none) |
-| `support_interface_filament` | `number` | `0` | `support_interface_filament` | filament for the support interface |
-| `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_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_style` | `string` | `'grid'` | `support_style` | 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) |
-| `support_top_z_distance` | `number` | `0.2` | `support_top_z_distance` | support_top_z_distance |
-| `support_xy_distance` | `number` | `0.35` | `support_object_xy_distance` | support_object_xy_distance |
-| `tree_lite_min_radius` | `number` | `1.5` | — | tree_lite taper constants (our own approximation — no matching upstream key) |
-| `tree_lite_shrink` | `number` | `0.5` | — | tree_lite taper constants (our own approximation — no matching upstream key) |
-| `tree_style` | `string` | `'organic'` | — | organic\|slim\|strong\|hybrid (upstream support_style smsTree*) |
-| `tree_support_angle_slow` | `number` | `25.0` | `tree_support_angle_slow` | tree_support_angle_slow (deg) |
-| `tree_support_branch_angle` | `number` | `40.0` | `tree_support_branch_angle` | fallback spelling — `tree_support_branch_angle_organic` wins when both are sent |
-| `tree_support_branch_angle_organic` | `number` | `40.0` | `tree_support_branch_angle_organic` | tree_support_branch_angle_organic (deg) |
-| `tree_support_branch_diameter` | `number` | `2.0` | `tree_support_branch_diameter` | fallback spelling — `tree_support_branch_diameter_organic` wins when both are sent |
-| `tree_support_branch_diameter_angle` | `number` | `5.0` | `tree_support_branch_diameter_angle` | tree_support_branch_diameter_angle (deg) |
-| `tree_support_branch_diameter_organic` | `number` | `2.0` | `tree_support_branch_diameter_organic` | tree_support_branch_diameter_organic (mm) |
-| `tree_support_branch_distance` | `number` | `1.0` | `tree_support_branch_distance` | fallback spelling — `tree_support_branch_distance_organic` wins when both are sent |
-| `tree_support_branch_distance_organic` | `number` | `1.0` | `tree_support_branch_distance_organic` | tree_support_branch_distance_organic (mm) |
-| `tree_support_tip_diameter` | `number` | `0.8` | `tree_support_tip_diameter` | tree_support_tip_diameter (mm) |
-| `tree_support_top_rate` | `number` | `30.0` | `tree_support_top_rate` | tree_support_top_rate (%) |
-| `tree_support_wall_count` | `number` | `0` | `tree_support_wall_count` | tree_support_wall_count (organic applies max(1,·) internally) |
-
-### Multi-material and prime tower
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `bottom_surface_filament_id` | `number` | `0` | `bottom_surface_filament_id` |  |
-| `enable_prime_tower` | `boolean` | `true` | `enable_prime_tower` |  |
-| `filament_cost` | `number[]` | `[]` | `filament_cost` | currency per kg, per filament |
-| `filament_density` | `number[]` | `[]` | `filament_density` | g/cm3, per filament |
-| `filament_map` | `number[]` | `[]` | `filament_map` |  |
-| `filament_settings_id` | `vector<std::string>` | `[]` | `filament_settings_id` |  |
-| `filament_type` | `vector<std::string>` | `[]` | `filament_type` |  |
-| `inner_wall_filament_id` | `number` | `0` | `inner_wall_filament_id` |  |
-| `internal_solid_filament_id` | `number` | `0` | `internal_solid_filament_id` |  |
-| `outer_wall_filament_id` | `number` | `0` | `outer_wall_filament_id` |  |
-| `top_surface_filament_id` | `number` | `0` | `top_surface_filament_id` |  |
-| `wipe_tower_real` | `boolean` | `false` | — | stage 12: use the real WipeTower.generate() on MM changes instead of the stage-6 square ring |
-
-### Bed and machine G-code
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `bed_depth` | `number` | `256.0` | `printable_area` | bed size (offset = bed/2) |
-| `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) |
-| `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 |
-| `printable_height` | `number` | `250.0` | `printable_height` | printable_height (mm) — the tree BuildVolume height |
-
-### Engine, streaming and diagnostics
-
-| Kernel param | Type | Default | From setting | Notes |
-| --- | --- | --- | --- | --- |
-| `arachne_dump` | `boolean` | `false` | — | temporary diagnostic: dump the PASS1 arachne input polygons to stderr |
-| `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_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) |
-| `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` |  |
-| `gcode_config_block` | `boolean` | `false` | — | ; CONFIG_BLOCK_START … the parameters this slice ran with … END |
-| `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) |
-| `keep_stages` | `boolean` | `false` | — | keep the stages cached after slicing (skips the early release — a memory trade-off) |
-| `mm_group_split` | `number` | `0` | — | triangle group boundary index ([0,split)=T0, [split,N)=T1) |
-| `mm_group_splits` | `number[]` | `[]` | — |  |
-| `mm_group_tools` | `number[]` | `[]` | — |  |
-| `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 |
-| `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). |
-| `prime_tower_x` | `number` | `10.0` | `wipe_tower_x` |  |
-| `prime_tower_y` | `number` | `10.0` | `wipe_tower_y` |  |
-| `prime_volume` | `number` | `0.0` | `prime_volume` | extra volume primed on every change, on top of the pair's |
-| `reduce_crossing_wall` | `boolean` | `false` | `reduce_crossing_wall` | wall-avoiding travel |
-| `reuse_stages` | `number` | `0` | — |  |
-| `time_engine` | `string` | `'full'` | — |  |
-
-<!-- KERNEL-PARAMS:END -->
-
-### The parameters no setting reaches
-
-A `—` in *From setting* means there is no OrcaSlicer option behind that parameter, so it exists only if you put it
-in the params object yourself. They are not one kind of thing, and the difference matters before you reach for one:
-
-- **Host runtime flags** — `economy`, `keep_stages`, `reuse_stages`, `time_engine`, `wipe_tower_real`,
-  `gcode_stats_block`, `gcode_config_block`. Decisions the *caller* makes about a particular run, not properties of
-  the print. `economy` is the last rung of an out-of-memory retry: it streams G-code and skips the preview
-  toolpaths and the time estimate, so a model that cannot finish any other way still finishes.
-- **Values the viewer computes** — `extruder_count`, `mm_group_split`, `mm_group_splits`, `mm_group_tools`,
-  `auto_center`. These come from the scene (how many extruders are loaded, which triangle ranges belong to which
-  tool), so there is nothing for a settings map to hold. `<Viewport/>` fills them in at slice time.
-- **Kernel-only tuning** — `support_density`, `support_auto`, `support_grid_snap`, `support_overhang_min_area`,
-  `tree_style`, `tree_lite_shrink`, `tree_lite_min_radius`, `scarf_length`, `prime_tower_ring_size`,
-  `raft_first_layer_height`, `extrusion_rate_slope_segment_length`. Real knobs with no upstream option of the same
-  name — some are this kernel's own approximations (the `tree_lite_*` taper), others are upstream behaviour that
-  upstream never exposed as a setting.
-- **Diagnostics** — `arachne_dump`, `pe_lite`, `pe_strip_tags`, `pe_external_perimeter_only`, `emit_pe_tags`. Left
-  at their defaults unless you are working on the kernel itself. `pe_lite` in particular defaults to `true` because
-  the real pressure equalizer only acts on G-code carrying OrcaSlicer's `;_EXTRUDE_SET_SPEED` tags, which this
-  kernel emits only when asked.
+The full table — 159 parameters, generated from the kernel's own reader (`params.cpp`) so it cannot drift from
+what `slice()` actually honours — lives in [PARAMS.md](PARAMS.md), including the classification of the 28
+parameters no setting reaches. Regenerate with `node types/gen_kernel_params.mjs`.
 
 ## Materials and multi-material
 
 A material is a **filament preset**: a set of schema values (temperatures, flow, diameter, cooling, retraction/z-hop overrides) that a printer profile declares itself compatible with. Read the catalog through the facade, never by decoding `three-slicer/data/filaments.js` by hand:
 
 ```js
-import { filamentPresets, deriveKernelParams } from 'three-slicer/settings'
+import { filamentPresets, applyPreset, deriveKernelParams } from 'three-slicer/settings'
 
 const filaments = await filamentPresets()               // lazy — the artifact loads on first call
 filaments.listFor('Bambu Lab X1 Carbon 0.4 nozzle')     // [{name, type, vendor}, …]
 filaments.recommendedFor('Bambu Lab X1 Carbon 0.4 nozzle')  // the vendor's shortlist, filtered to the compatible set
 
-// Applying one: CLEAR the preset's key set first. A preset carries only the keys it sets, so a plain merge leaves
-//  behind whatever the previous material set and this one does not — a PLA pick after an ABS pick keeps ABS's
-//  chamber temperature. `keys` is the exact set to clear, and the filament and process key sets are disjoint, so
-//  clearing one never disturbs the other.
-function applyPreset(settings, preset, keys) {
-  const next = { ...settings }
-  for (const key of keys) delete next[key]
-  return Object.assign(next, preset)
-}
+// Applying one: applyPreset CLEARS the preset's key set first. A preset carries only the keys it sets, so a
+//  plain merge leaves behind whatever the previous material set and this one does not — a PLA pick after an
+//  ABS pick keeps ABS's chamber temperature. `keys` is the exact set to clear, the filament and process key
+//  sets are disjoint (clearing one never disturbs the other), and a null preset applies nothing.
 settings = applyPreset(settings, filaments.settingsFor('Bambu PLA Basic @BBL X1C'), filaments.keys)
 ```
 
@@ -337,7 +94,7 @@ The kernel reads those arrays **positionally** and reloads the whole loaded-fila
 
 Painting is the only way a **single** object can print in two materials — there is no triangle boundary to split on, only painted facets. The painted facets of each state are projected per layer and the sliced polygon is partitioned against them; where two extruders claim the same area the higher-numbered one wins (a total order on a small integer, so the result never depends on paint or clipper ordering).
 
-Painting states are upstream's `EnforcerBlockerType`, one enum serving two jobs: `1` = ENFORCER = **Extruder1**, `2` = BLOCKER = **Extruder2**, `3..16` = Extruder3..16. The state-addressed protocol lives on the worker (`three-slicer/worker`); the direct handle's `slice.paint({enforcer})` is the original boolean pair only.
+Painting states are upstream's `EnforcerBlockerType`, one enum serving two jobs: `1` = ENFORCER = **Extruder1**, `2` = BLOCKER = **Extruder2**, `3..16` = Extruder3..16. The state-addressed protocol lives on the worker (`three-slicer/worker`); the direct handle's `slicer.paint({enforcer})` is the original boolean pair only.
 
 ```js
 worker.postMessage({ cmd: 'prepare', stl })                          // -> {type:'prepared', facets}
@@ -348,16 +105,13 @@ worker.postMessage({ cmd: 'erase', facet, hx, hy, hz, cx, cy, cz, radius })   //
 
 `erase` is its **own command**, not `{cmd:'paint', state: 0}`: embind coerces a JS `false` to the int `0` == NONE, and the legacy blocker brush sends exactly that `false` — so the state path rejects `0` outright and only `erase`, which takes no state argument, can clear anything. A message without `state`/`states` gets the original reply verbatim, so existing listeners are unaffected.
 
-Two consequences worth knowing before you build on this:
-
-- Because one selector serves both jobs, **a support BLOCKER paint and an Extruder2 paint are the same mark**, and a facet can hold only one of them. The two brushes are therefore mutually exclusive, which is a data constraint, not a UI simplification.
-- The painted multi-material path is taken only when support is **off** — it emits no support at all. **Paint and support cannot currently produce two materials together.**
+One consequence worth knowing before you build on this: because one selector serves both jobs, **a support BLOCKER paint and an Extruder2 paint are the same mark**, and a facet can hold only one of them. The two brushes are therefore mutually exclusive on a model, which is a data constraint, not a UI simplification. (Support itself is fine — the painted multi-material path runs the same support pass the single-material path does, so paint and generated support coexist on one slice.)
 
 Results carry the split: `stats.filament_mm_by_tool` (indexed by tool number, one slot per extruder, sums to `filament_mm`) and `stats.filament_mm_purge` (the prime/wipe tower share, already included in the per-tool figures). In the streamed toolpath, `paths[k+3]` encodes `role + tool * 16` — mask with `& 15` for the role and `>>> 4` for the tool.
 
 ## SLA parameters
 
-The table above is the FFF kernel's reader. The SLA entry (`slice_sla`) reads its own parameter set, produced
+The table in [PARAMS.md](PARAMS.md) is the FFF kernel's reader. The SLA entry (`slice_sla`) reads its own parameter set, produced
 by `deriveSlaParams(settings)` — unlike `deriveKernelParams` it always emits every key (54 today), filling
 schema/reference-machine defaults, because the SLA keys are not shared with another technology whose defaults
 could disagree. The groups:

package/engine/examples/headless.mjs

@@ -26,6 +26,10 @@ const slicer = await createSlicer()
 // (a) batch slice
 const r = slicer.slice(cube, params)
 console.log(`batch : layers=${r.stats.layers} segments=${r.stats.path_segments} filament=${r.stats.filament_mm.toFixed(1)}mm gcode=${r.gcode.length} chars`)
+// What a SUCCESSFUL slice got away with — empty here. It is not empty if you hand in a bed-centred model:
+//  the kernel takes plate-local coordinates, so pre-centring adds the bed offset twice and the part slices
+//  off the plate with plausible time and material and no error.
+console.log(`warn  : ${r.warnings.length ? r.warnings.join(', ') : 'none'}`)
 
 // (b) streaming slice via onLayer (stage 30) — assemble G-code from per-layer chunks
 let chunks = 0, gbytes = 0