[jimmytacks]

Summary

Renames CELLTOPOS to TOPOS and generalises it into the universal to-position converter, and adds COLSTROF, the column-letters twin of COLOF.

TOPOS

• Address text (e.g. "E5"; sheet prefixes, $ anchors and ranges tolerated) encodes as an absolute packed position ROW*mult+COLUMN — behaviour unchanged from CELLTOPOS.
• Any direction spelling DIRDELTA accepts — arrow glyphs (↑ ↗ → ...), compass codes (NE, north-east), screen directions (UL, down) — converts to a relative packed movement delta, repacked as rowDelta*mult+colDelta when a custom mult is supplied.
• Numbers pass through unchanged, so pre-packed positions, deltas and knight moves survive (matches DIRDELTA mode-0 convention).
• Unrecognised text returns #N/A. Array input lifts element-wise (branch-plus-@ dispatcher retained, incl. the 1x1 arrays poison scalar branches: CELLTOPOS truncates multi-letter columns; FOLDROWS passes 1x1 arrays where REDUCE passes scalars #318 1x1-array guard).

The two branches can't collide: direction tokens never contain digits, addresses always do.

COLSTROF

COLSTROF(pos, [mult]) extracts the column letters from an encoded position — COLSTROF(1200028) returns "AB" — filling the one gap in the pos-decode family (POSTOCELL gives the full address, ROWOF/COLOF give numbers). Pure native-lifting body (MOD + ADDRESS + SUBSTITUTE), no dispatcher needed.

Rename fallout

• All 9 internal callers updated: CELLDIST, COLNUM, ROWNUM, GRIDAREA, GRIDLOOKUP, LABELCLUSTERS, MOVECELL, NEIGHBOURS, RELGRID.
• Help-text/description mentions updated in POSAT, POSTOCELL, ROWOF, COLOF, ADDRESSES, GRIDWHERE, MAZEHELP and the five _dir*.const files; dated revision-history lines keep the old name as historical record.
• COLOF/ROWOF test args composing with CELLTOPOS renamed; loader integration test asserts maps.TOPOS.
• TOPOS help delimiter switched to ¦ (help content now lists arrow glyphs).

Testing

• Format validation: 944 passed.
• Unit tests: 1767 passed.
• Full AddIn harness suite: 1244 passed, 0 failed — includes 33 TOPOS cases (all previous CELLTOPOS cases carried over, plus arrows, compass/screen spellings, numeric passthrough, custom-mult delta repack, mixed address+direction array, unrecognised-text #N/A, and the 1x1 arrays poison scalar branches: CELLTOPOS truncates multi-letter columns; FOLDROWS passes 1x1 arrays where REDUCE passes scalars #318 1x1-array case) and 10 COLSTROF cases (single/multi-letter, XFD, custom mult, TOPOS round-trips, array lifts).

🤖 Generated with Claude Code