wassnameandClaudypoo 442bc5bba3 address external API review: lazy maps, prune dead code, type administer return ...

Whole-library review (deepseek-v4-pro) flagged tinymfv as not-yet-ready as a shared
dep. Fixes for the parts I agreed with:
- lazy `maps` import via module __getattr__ so `import tinymfv` stays headless/fast
  (no forced matplotlib) for numeric-only consumers; `tinymfv.maps.*` still works.
- trim __all__ to the front door (entrypoints + types + data api); plumbing stays
  importable but out of `import *`.
- delete dead code: reduce_nominal + REDUCERS (evaluate folds its profile inline),
  expected_value, HF_REPO, ROOT, _DEFAULT_FORCED_HINT.
- type administer's return as a TypedDict (AdministerResult/ItemRow/ItemFrameRow) so
  the schema is documented + checkable without reading source; still a plain dict at
  runtime (zero consumer churn).
- maps.plot_ipsative_pca: parametrize the legend labels (defaults preserve output)
  and rename hon/dis -> pos/neg so a non-honesty steer gets a correct legend.
- drop 'canary' jargon and panel/review-# archaeology from comments.

Verified: `import tinymfv` no longer loads matplotlib; lazy maps still resolves;
experiment mfq2 smoke green through the typed administer.

Co-Authored-By: Claudypoo <288921227+claudypoo@users.noreply.github.com>

2026-06-23 20:40:04 +08:00

..

data

instrument: add ordinal survey readout (read + administer + registry + data)

2026-06-23 09:04:35 +08:00

__init__.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00

administer.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00

data.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00

eval.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00

guided.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00

instrument.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00

instruments.py

instrument: add ordinal survey readout (read + administer + registry + data)

2026-06-23 09:04:35 +08:00

maps.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00

read.py

address external API review: lazy maps, prune dead code, type administer return

2026-06-23 20:40:04 +08:00