# LinuxCNC WASM smoke source map

This map records the source basis and boundaries for the Node and browser WASM
smoke wrappers. It is a smoke-test guard only; it must not add CNC behavior,
must not expand the temporary smoke parser, and must keep browser filesystem
persistence OPFS-only. In browser contexts, browser filesystem persistence
OPFS-only is the required boundary.

## LinuxCNC Source Basis

- `src/emc/rs274ngc/rs274ngc_pre.cc` provides `Interp::ini_load()`,
  `Interp::restore_parameters()`, `Interp::save_parameters()`, and `read_text()`
  behavior exercised by Node/browser bridge tests.
- `src/emc/rs274ngc/rs274ngc_pre.cc` saves parameters by writing
  `filename + ".new"`, unlinking `filename + ".bak"`, linking the previous file
  to `filename + ".bak"`, and renaming the temporary file over the main file.
- `src/emc/rs274ngc/interp_convert.cc` provides `convert_m()` coverage for
  M66 waits and M68 analog output side effects used by generated remap cases.
- `src/emc/nml_intf/canon.hh` declares the `WAIT()` and
  `SET_AUX_OUTPUT_VALUE()` canon entry points surfaced through the event bridge.
- `src/emc/kinematics/5axiskins.c`, `src/emc/kinematics/trtfuncs.c`,
  `src/emc/kinematics/xyzac-trt-kins.c`,
  `src/emc/kinematics/xyzbc-trt-kins.c`, and
  `src/emc/kinematics/userkfuncs.c` provide the RTCP/kinematics inverse paths
  covered by WASM smoke tests.
- `configs/sim/**.ini` files and `remap_subs/{428,429,430}remap.ngc` sources
  generate `web/public/linuxcnc_switchkins_remap_config_cases.json`.

## Smoke Coverage

| Smoke entry | Boundary |
| --- | --- |
| `test-web-wasm-node-smoke.sh` | Runs the Node WASM wrapper with generated LinuxCNC switchkins cases and LinuxCNC-backed RTCP checks. |
| `test-web-wasm-node-smoke.cjs` | Exercises the C ABI, `web/src/wasm-core.js`, generated switchkins config cases, and source-backed kinematics events. |
| `test-web-wasm-browser-smoke.sh` | Runs browser checks after verifying copied WASM artifacts and smoke module structure. |
| `web/test-browser-wasm-smoke-linuxcnc-sections.js` | Exercises LinuxCNC browser parsing and generated switchkins cases without INI_FILE_NAME remap-load aliases. |
| `web/test-browser-wasm-smoke-opfs-parameter-sections.js` | Exercises LinuxCNC parameter restore/save/backup semantics through OPFS. |
| `web/test-browser-wasm-smoke-app-sections.js` | Verifies the browser app uses OPFS program and parameter persistence. |

## Boundaries

- Node smoke must leave OPFS disabled and must reject `parseFile*` methods that
  require an OPFS workspace.
- Browser smoke must keep program files, LinuxCNC parameter files, temporary
  `.new` files, and `.bak` backups under OPFS-backed storage.
- Generated switchkins config smoke cases must continue to come from
  `web/public/linuxcnc_switchkins_remap_config_cases.json`.
- The browser smoke shell guard also pins required section names for LinuxCNC
  browser parsing, OPFS parameter restore/save failure handling, and browser
  app OPFS reload coverage.
- Smoke wrappers must keep positive minimum coverage thresholds so accidental
  section loss is visible.

## Checks

Run:

```bash
./check-linuxcnc-wasm-smoke-source-map.sh
./test-native.sh
./test-linuxcnc-source-link.sh
```

`check-linuxcnc-wasm-smoke-source-map.sh` keeps this document, LinuxCNC source
anchors, smoke wrapper boundaries, OPFS-only policy, and generated switchkins
case usage synchronized.