# scriptlib/_punktest — test-owned scriptlib fixtures

These scripts are **fixtures owned by the punk test suite**
(`src/tests/shell/testsuites/punkexe/scriptexec.test`), not user sample
scripts. They exist so tests can exercise the `lib:` scriptlib-resolution
mechanism and the `script` subcommand's Tk main-loop behaviour against
**stable, committed** scripts rather than user-editable samples.

- Do not hand-edit these files: the tests assert on their exact behaviour and
  output markers. Changing them will break the suite.
- The rest of `scriptlib/` is user-only territory; this `_punktest/` subfolder
  is the exception, owned and maintained by the test suite.
- They resolve via `<punkexe> script lib:_punktest/<name>` (subpath resolution
  through `punk::path::scriptlib_resolve`).

Fixtures:
- `echo.tcl` — emits a marker plus its `::argv0`/`::argv`; used for `lib:`
  resolution, subpath resolution, and file-form argument passing.
- `extless` — extensionless, first line `# tcl`; proves extensionless-tcl
  matching (punk::path 0.3.0 first-line identification).
- `dual` / `dual.tcl` — precedence pair with distinct markers; the spelling
  matching the call must win (`lib:_punktest/dual` runs `dual`,
  `lib:_punktest/dual.tcl` runs `dual.tcl`).
- `shebang_sh` — extensionless, portable sh-trampoline shebang (`#!/bin/sh`
  with commented `exec tclsh` continuation); proves the identification check
  accepts the classic cross-platform idiom.
- `notatcl` — extensionless with a python shebang and no `.tcl` sibling; must
  NOT resolve, and the not-found output must note the identification skip.
- `tk_countdown.tcl <ms>` — Tk window that exits 0 from an `after` callback;
  proves the `script` subcommand services a registered Tk main loop (the
  callback runs only if the event loop is serviced).
- `tk_noexit.tcl` — Tk window with no explicit exit; used to prove a GUI
  script stays alive (blocks) under `script`, as it does under tclsh/wish.
- `tk_error.tcl` — Tk window then an uncaught error; proves an errored GUI
  script exits promptly (no hanging window).