Address #282 - improve readability of path.janet

[sogaiu]

This PR is an attempt to address #282.

Apart from the original proposal, additional changes include:

• Changes from Address #284 - handle path/normalize edge case #285 for normalize
• Docstrings were added to satisfy assert-docs
• A PEG was simplified (struct -> tuple)
• PEG special usage was made more consistent (e.g. + is used everywhere instead of a mix of + and choice)
• Some formatting was altered

[Copilot]

Pull request overview

Refactors spork/path.janet to improve readability by replacing macro-generated path functions with explicit posix/* and win32/* implementations, simplifying PEG usage, and adding docstrings to satisfy documentation checks.

Changes:

• Removed macro-based code generation and replaced it with explicit posix/* and win32/* function definitions.
• Simplified/standardized PEG patterns (e.g., consistent use of PEG specials like + and /).
• Added docstrings and reworked platform-specialization bindings (sep, join, normalize, etc.).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sogaiu]

I've made the following additional changes:

• re: :mingw - posix?'s definition should account for "not windows and not mingw" and
• re: comptime - delay has been used (hopefully in a correct fashion)

The result has been working here so far.

[bakpakin]

As a side note, I realized an even more obvious way to appease linting:

(comptime (def posix? (not (index-of (os/which) [:windows :mingw]))))

It's also is more directly about intention

[sogaiu]

I tried:

(comptime (def- posix? (not (index-of (os/which) [:windows :mingw]))))

and replaced instances of (posix?) with posix? here, but now I get the "dead code" linting warning [1] from before.

---

[1] Under strict mode.

[bakpakin]

Right I guess that would make sense. The current version with delay is fine, just a bit ugly imo. There are several ways to do conditional compilation, and it would be nice if the most obvious ways worked with linting.