From 23afae69adaf5e0b1885a765bd80de3b95b3b616 Mon Sep 17 00:00:00 2001
From: Frick <frick@goblincorps.dev>
Date: Thu, 15 Jan 2026 04:05:32 +0000
Subject: [PATCH] Add API verification test suite and documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

tests/docs/:
- API_FINDINGS.md: Comprehensive migration guide from deprecated to modern API
- test_*.py: 9 executable tests verifying actual runtime behavior
- screenshots/: Visual verification of working examples

tests/conftest.py:
- Add 'docs' and 'demo' to pytest collection paths

Key findings documented:
- Entity uses grid_pos= not pos=
- Scene API: Scene() + activate() replaces createScene/setScene
- scene.children replaces sceneUI()
- scene.on_key replaces keypressScene()
- mcrfpy.current_scene (property) replaces currentScene() (function)
- Timer callback signature: (timer, runtime)
- Opacity animation does NOT work on Frame (documented bug)

🤖 Generated with Claude Code (https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 tests/conftest.py                             |   4 +-
 tests/docs/API_FINDINGS.md                    | 129 ++++++++++++++++++
 tests/docs/screenshots/features_animation.png | Bin 0 -> 31736 bytes
 tests/docs/screenshots/features_scenes.png    | Bin 0 -> 31707 bytes
 .../docs/screenshots/quickstart_entities.png  | Bin 0 -> 32512 bytes
 .../docs/screenshots/quickstart_main_menu.png | Bin 0 -> 45815 bytes
 .../screenshots/quickstart_simple_scene.png   | Bin 0 -> 31723 bytes
 tests/docs/screenshots/quickstart_sprites.png | Bin 0 -> 31978 bytes
 tests/docs/test_current_scene.py              |  18 +++
 tests/docs/test_defaults.py                   |  30 ++++
 tests/docs/test_entity_api.py                 |  30 ++++
 tests/docs/test_features_animation.py         |  86 ++++++++++++
 tests/docs/test_features_scenes.py            |  84 ++++++++++++
 tests/docs/test_quickstart_entities.py        |  70 ++++++++++
 tests/docs/test_quickstart_main_menu.py       |  74 ++++++++++
 tests/docs/test_quickstart_simple_scene.py    |  48 +++++++
 tests/docs/test_quickstart_sprites.py         |  49 +++++++
 17 files changed, 620 insertions(+), 2 deletions(-)
 create mode 100644 tests/docs/API_FINDINGS.md
 create mode 100644 tests/docs/screenshots/features_animation.png
 create mode 100644 tests/docs/screenshots/features_scenes.png
 create mode 100644 tests/docs/screenshots/quickstart_entities.png
 create mode 100644 tests/docs/screenshots/quickstart_main_menu.png
 create mode 100644 tests/docs/screenshots/quickstart_simple_scene.png
 create mode 100644 tests/docs/screenshots/quickstart_sprites.png
 create mode 100644 tests/docs/test_current_scene.py
 create mode 100644 tests/docs/test_defaults.py
 create mode 100644 tests/docs/test_entity_api.py
 create mode 100644 tests/docs/test_features_animation.py
 create mode 100644 tests/docs/test_features_scenes.py
 create mode 100644 tests/docs/test_quickstart_entities.py
 create mode 100644 tests/docs/test_quickstart_main_menu.py
 create mode 100644 tests/docs/test_quickstart_simple_scene.py
 create mode 100644 tests/docs/test_quickstart_sprites.py

diff --git a/tests/conftest.py b/tests/conftest.py
index aeac22c..981e78f 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -111,7 +111,7 @@ def pytest_collect_file(parent, file_path):
     except ValueError:
         return None
 
-    if rel_path.parts and rel_path.parts[0] in ('unit', 'integration', 'regression'):
+    if rel_path.parts and rel_path.parts[0] in ('unit', 'integration', 'regression', 'docs', 'demo'):
         if file_path.suffix == '.py' and file_path.name not in ('__init__.py', 'conftest.py'):
             return McRFTestFile.from_parent(parent, path=file_path)
     return None
@@ -121,7 +121,7 @@ def pytest_ignore_collect(collection_path, config):
     """Prevent pytest from trying to import test scripts as Python modules."""
     try:
         rel_path = collection_path.relative_to(TESTS_DIR)
-        if rel_path.parts and rel_path.parts[0] in ('unit', 'integration', 'regression'):
+        if rel_path.parts and rel_path.parts[0] in ('unit', 'integration', 'regression', 'docs', 'demo'):
             # Let our custom collector handle these, don't import them
             return False  # Don't ignore - we'll collect them our way
     except ValueError:
diff --git a/tests/docs/API_FINDINGS.md b/tests/docs/API_FINDINGS.md
new file mode 100644
index 0000000..b4cce5f
--- /dev/null
+++ b/tests/docs/API_FINDINGS.md
@@ -0,0 +1,129 @@
+# McRogueFace API Test Findings
+*Generated by Frack, January 14, 2026*
+
+## Summary
+
+Tested code snippets from docs site against actual runtime API.
+Tests created in `/tests/docs/` with screenshots in `/tests/docs/screenshots/`.
+
+---
+
+## Entity Constructor
+
+**Correct:**
+```python
+entity = mcrfpy.Entity(grid_pos=(10, 7), texture=texture, sprite_index=84)
+```
+
+**Wrong:**
+```python
+entity = mcrfpy.Entity(pos=(10, 7), ...)  # FAILS - no 'pos' kwarg
+entity = mcrfpy.Entity(grid_x=10, grid_y=7, ...)  # FAILS - no separate kwargs
+```
+
+---
+
+## Scene API
+
+**Modern (WORKS):**
+```python
+scene = mcrfpy.Scene("name")
+scene.children.append(frame)
+scene.on_key = handler
+scene.activate()
+```
+
+**Deprecated → Modern:**
+```python
+# OLD                          → NEW
+mcrfpy.createScene("name")     → scene = mcrfpy.Scene("name")
+mcrfpy.sceneUI("name")         → scene.children
+mcrfpy.setScene("name")        → scene.activate()
+mcrfpy.keypressScene(fn)       → scene.on_key = fn
+mcrfpy.currentScene()          → mcrfpy.current_scene  # property, not function!
+```
+
+---
+
+## Grid.at() Signature
+
+Both work:
+```python
+point = grid.at((x, y))  # Tuple - documented
+point = grid.at(x, y)    # Separate args - also works!
+```
+
+---
+
+## Animation System
+
+**Works:**
+- `x`, `y`, `w`, `h` properties animate correctly
+- Callbacks fire as expected
+- Multiple simultaneous animations work
+- Easing functions work
+
+**Does NOT work:**
+- `opacity` - property exists, can set directly, but animation ignores it
+
+---
+
+## Timer API
+
+**Modern:**
+```python
+timer = mcrfpy.Timer("name", callback, seconds)
+# Callback signature: def callback(timer, runtime):
+```
+
+**Deprecated:**
+```python
+mcrfpy.setTimer("name", callback, milliseconds)  # Wrong signature too
+```
+
+---
+
+## Color API
+
+Always use `mcrfpy.Color()`:
+```python
+frame.fill_color = mcrfpy.Color(255, 0, 0)     # CORRECT
+frame.fill_color = mcrfpy.Color(255, 0, 0, 128)  # With alpha
+```
+
+Tuples no longer work:
+```python
+frame.fill_color = (255, 0, 0)  # FAILS
+```
+
+---
+
+## Available Globals
+
+**All exist:**
+- `mcrfpy.default_texture` - Texture for kenney_tinydungeon.png
+- `mcrfpy.default_font` - Font for JetBrains Mono
+- `mcrfpy.default_fov` - (default FOV settings)
+
+---
+
+## Files Requiring Updates
+
+1. `quickstart.md` - All 4 code blocks use deprecated API
+2. `features/scenes.md` - "Procedural API" section entirely deprecated
+3. `features/animation.md` - opacity examples don't work
+4. Any file using `setTimer`, `createScene`, `sceneUI`, `setScene`, `keypressScene`
+
+---
+
+## Test Files Created
+
+| Test | Status | Notes |
+|------|--------|-------|
+| test_quickstart_simple_scene.py | PASS | |
+| test_quickstart_main_menu.py | PASS | |
+| test_quickstart_entities.py | PASS | Uses grid_pos= |
+| test_quickstart_sprites.py | PASS | |
+| test_features_animation.py | PASS | opacity test skipped |
+| test_features_scenes.py | PASS | Documents deprecated API |
+| test_entity_api.py | INFO | Verifies grid_pos= works |
diff --git a/tests/docs/screenshots/features_animation.png b/tests/docs/screenshots/features_animation.png
new file mode 100644
index 0000000000000000000000000000000000000000..4280a2c6563dc2c88b967b8c76b80793057a574d
GIT binary patch
literal 31736
zcmeI5PiPZC6viiMtV?K0JQPB-jY06zOOPC-h^=khTChb_)Qhsx9_mFb<WNyC^-o0D
zDk6gRpkSaNLh;;-K@kxI3AqUhrBLiqs!%<&PPSRIA-l6vnAx?>cUc#=Y-clXe(!tV
zyln5C7#WO&<6%NbWawDtBq1Ss+Cr38`p^7)M}&}TZ-z2QPETGK9n-Yc&#ACFpru2#
zLq4nMXO?bt|A`H*l*bi4U#uS5-bS_f^y5-A7MWrn781ci3n{$3ZoO~qH(1X46uq73
z`&ZcaqgOjgY`CS6OvQuj!@FciJxlc2Mb|q9lBph&n)x(X|M-@{RWF2Y7r&F@_<@Am
zWABO@kNr{LV~ZbTDUd6rT|Y+pA@AwevO9|7Jzd-4vHhHzEYZ@D+B$MPYr7kboe!jD
z?l)OTN|+nqf{k7YOxsD+vY9FzL!4f?qD+-KNMU)BJwkewJ2{A_q=b+ZKS-dwF<I9I
zmG}Sx%GtU~!ny&<>teb=tpeqqha^z$c}N1~>@rMzNK%yReZ6am>1Fo%GOjLk1`FLp
zJ+*2z3~W_kZlji8VwdssYLM2Sv~YU*;GY3ud%wI<oX1@~2|CR7WNJRBr8`~ks8ESY
z%jB`cZf?WAy&;wA-bcTEcx*ohSusvpUBp)<QRN2|eU3UeAH>bJpO4KQk`e|<ZL(Px
z+ihbdQWJ`<#PW|O3rX>FQ?W2F)mfts5r2>xgyCE%dkDC&H)y%%rsA^#<<1tjgnY9J
zl)u*1#R^r(v*>DXyvJmEraw24o^4ng<c6YO4#b9&=Fd5<4ul7r)e^D^w+h=tcp%fW
zwpI9-E;79%DU1u;xZqwl$n*}SmB}S;TyW0~GCeyj^5cSgZh&$#ob4S2Zd~xs4Nwl0
z+o*YNN=gVxZd`B=5-11CZR&o0N{SCj3F`(Z2g-qRb1Mj2DWWPSsB)-sOOv%3RuVFp
zk7*VLi#e|j!7hGo{8i=W)X}Te9+CWUCAF65did-4M7lI>TY8hP14gg;i{0!dhsczK
z{xT_@6P17$`8@zM!Fk?sgnnlBVidn_(9hhkiCW)&fF?MvLsCM%X<C#Qm7k02r6;c6
zC!;myw~bD{JO6d39x68nF<aGm5=t1Da4_Lu!oh?S-E<9<1LZK`%<2RE%&bN}y4j1Z
zanEtVZIA-xp3e<bIaE1RIaE1RISakq8H`(9z+myb@lO2QU~9a|w#G$MQhZ2C=-h-V
zXQhUG5hw@Bw|@_{cnRchmlIIV=*q#nKWu7Zt5Lw8W?`^cKextAAzlJOl|z-=wW^BG
zU=oxc_aLFlp~|uCiEU5g?fQ5lU!$-vWQTZl!LR&)a<7#i|J*>8dp$Q$<xu5N<>q%n
zV6ebov6C$P8H`(9h?hV>IZzIi1LeYBv<_7cRc@mT#Ah%+(=4_<?SxP5|0K)}ymENu
u@XFzp!z-_0w()FBq*<UGDBrp$50Ebx+t$mkLhtEc^d>_`M>2E$+ReXz7z@<^

literal 0
HcmV?d00001

diff --git a/tests/docs/screenshots/features_scenes.png b/tests/docs/screenshots/features_scenes.png
new file mode 100644
index 0000000000000000000000000000000000000000..1c8ee9231122396786426da084aed9c263178f0a
GIT binary patch
literal 31707
zcmeI5F>6y%6vt0rLwp2Mvj`zjusFKBA%lntwlSK)BGOfPXotF25L{A`fDp0Zq@w``
zhkk%enRJxkCvcH&>ZX%k3V}c$_nqP16O6y*weTR^mvip#{?Gs1`|{$>_RV^&RTGhV
z?^froNX7lTDrwdI8IRA^MV`Lvb*}F`x&LrC&wqW+YTd28UGZNAkJIes$M1XTa4_*-
zew;m+uJorn*ILPFBlBD?oUe4xNcZ(`|L3{8YchO)Fl{vJC6}*_WOPxwUw)Q;V!zQ`
zm*(wn{t>#n$!5MUdHc<)vd2!-lgHi-_}JkGc`TE?R_WL1zUj4%Y@Fon_2qc%MaJf`
zWN)kfxpi`Pu$2yvTuOfW&r&i%Y`}$wx>1-mT9whG(lx~8`K9NR<63{Zf5kt-R-#`V
z!c#IrN`@aKDEEUhLIQzuzpjcfZ$P;pl;PzmC@-mSK)H2Ff^zee1m))H0+gGp3s4Tq
z3rx!JGcm#nw#Y%E%B|-Os@z-xVX&A>APg3B2?WYP`O-@uP!7rqwj!X)%|%rNUnzVM
zuO1|-+&qCmIVcC^vn^a~cq`eA2+GZIp*AK#xp{0bSTI-$c5tgH`A<|#sB%<!(Qf?(
z7K#z(4JZfYpnP_)f_>$_lU7b=qRP#2p<Zu5xp{18d(!r#?KwMA%W2P06%!~2<*0I0
zdFZzb;FaT*)Apq88Tw@;c;%s#9|nuL^21=UF5>ll3=9_Q*no0SPTO<#5+YuwRbX$<
zBMFq7<3hd729%q}27?8I1%m~H1%t(hUiAv5R~PCc9)ksgW$9aM`gw!FGGEP{7B6aC
zsF{W;_bm+$PN3X6CH1&a$A%p&=F2Q7x1Kkk9F*gg<CO>h$rex!$_pAV;fs+7%1=E=
zyz<lK=6u>mhz+V7RlfA*7pfdpjw(l$qso1Uxg)3xwerI&H&=e@*r3YIV}mM3m7~fz
g?HT&CXPU0a)qB-HhYvn9-H&!l@5XlLXfuEI7eRCD&Hw-a

literal 0
HcmV?d00001

diff --git a/tests/docs/screenshots/quickstart_entities.png b/tests/docs/screenshots/quickstart_entities.png
new file mode 100644
index 0000000000000000000000000000000000000000..da85c3421266e9f21f77789a52478442195fe488
GIT binary patch
literal 32512
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
A{Qv*}

literal 0
HcmV?d00001

diff --git a/tests/docs/screenshots/quickstart_main_menu.png b/tests/docs/screenshots/quickstart_main_menu.png
new file mode 100644
index 0000000000000000000000000000000000000000..6bb58d6d19ddd1b7f67667fe1eddb6fd7fc78849
GIT binary patch
literal 45815
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

literal 0
HcmV?d00001

diff --git a/tests/docs/screenshots/quickstart_simple_scene.png b/tests/docs/screenshots/quickstart_simple_scene.png
new file mode 100644
index 0000000000000000000000000000000000000000..e90b37d299a36a542215d0d435d59da7f056fdba
GIT binary patch
literal 31723
zcmeI5PiPZC6o;qVP}e|e5QGpCH0Y^ba)=-z{%K=02dii=BFLge>b;^MNGcK$QhM;D
z*9DI~c+4p$1uqf=J@+E<q~0nNbPWU+5@shb`!<c=Wm{MXJM(6~_nY6m*?oC^`En+m
zPb;M|^()mIN~MB-XO%k_{Ast3WR!aHu3o*k^7ziZRnOb~R8H5Hyh=)cX+Ctzo9}<D
zxvgeLfBAW6qdU{+uAIv|eyOav96y$-9Z<DbzxBTt+?`jgw;SDTE)#Lt$vXZ?Rr~xa
z@)sM~Tv6q&e$zi;aMxM%)|FRzy%p7L*X=iZ)nc<7S+DeEt57KT2k&a)(>v^(f4Y~;
zeE-)&GYc;|y>z2{;*_T6`>i(be*2x(Q=PSZWH^KN%$Le-$Ey^R>Hd8&MhqYFj4HpG
z)6en#-R6?p+7711hY6n=hRsfL{{FYvN-Q@1tnwd3=CWX%pMKt_<oel3rerKB#dd5!
zxgL};q*+j|*LN|@8&IwXrTsJu$|F`<sB-Bc3ChKXBq$eG7oc2RU4U{>KEf=uKNDlf
zU`akCs$6>BpvuK15C)651j1kumq4H#lux|`0_C85L`ejyTwGMe;49f*#2Y^(s$6^k
zfpSm|$_FJ}Q&)IryGjC-i{rxBm;~kGvB6-$U>Q+KZcNF2v0_4%qsm8}8c1-V7{j~)
z<)9pt4-QsPSFStp73fS<xi~J2^9?8$j}6<NY<sfpIXK$OX-``#CQuH_QRS#|+xr-J
z<#^?6d$R3m`=uy&<+hX`28+1z!(fqK#GCJ9V6aHX29$$xwmk<gA>wsfBkavEl0dmQ
zE{w};K)HBqFjz2HFjz2HFj#cxHO^q>>cV&tkHLb$GWA<)=JN)FCA^v$7B9xQFlHL6
zT$dUGIDvBMA!&{a<JeHaBA#Z)KzZxJwY{U89|wh7nh!JV6dnJzs@>exH)ot_%h1sG
zC7EP64Tp&s1Fej+JpPV&Y`}#jT$s<BF*3<?eXz%Ny&WhQ#|0=C#|4Xmusj(a@y0{a
z7#E;i+(R&q4gQXJY*6LH&<P{S92cNG+;79Z3d$!}UD%HeC<o=#LQ)H9{nNl0EYfK<
cS(GdF^;Y`N{e|YE;3M9uerdV7z34sr3)^hyV*mgE

literal 0
HcmV?d00001

diff --git a/tests/docs/screenshots/quickstart_sprites.png b/tests/docs/screenshots/quickstart_sprites.png
new file mode 100644
index 0000000000000000000000000000000000000000..a5d420e28b49707f8cee85fc78d3ac6d05ceadb2
GIT binary patch
literal 31978
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

literal 0
HcmV?d00001

diff --git a/tests/docs/test_current_scene.py b/tests/docs/test_current_scene.py
new file mode 100644
index 0000000..80eb18f
--- /dev/null
+++ b/tests/docs/test_current_scene.py
@@ -0,0 +1,18 @@
+#!/usr/bin/env python3
+"""Verify mcrfpy.current_scene property."""
+import mcrfpy
+import sys
+
+scene = mcrfpy.Scene("test")
+scene.activate()
+mcrfpy.step(0.1)
+
+try:
+    current = mcrfpy.current_scene
+    print(f"mcrfpy.current_scene = {current}")
+    print(f"type: {type(current)}")
+    print("VERIFIED: mcrfpy.current_scene WORKS")
+except AttributeError as e:
+    print(f"FAILED: {e}")
+
+sys.exit(0)
diff --git a/tests/docs/test_defaults.py b/tests/docs/test_defaults.py
new file mode 100644
index 0000000..6105cfc
--- /dev/null
+++ b/tests/docs/test_defaults.py
@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+"""Test mcrfpy default resources."""
+import mcrfpy
+import sys
+
+scene = mcrfpy.Scene("test")
+scene.activate()
+mcrfpy.step(0.01)
+
+print("Checking mcrfpy defaults:")
+
+try:
+    dt = mcrfpy.default_texture
+    print(f"  default_texture = {dt}")
+except AttributeError as e:
+    print(f"  default_texture: NOT FOUND")
+
+try:
+    df = mcrfpy.default_font
+    print(f"  default_font = {df}")
+except AttributeError as e:
+    print(f"  default_font: NOT FOUND")
+
+# Also check what other module-level attributes exist
+print("\nAll mcrfpy attributes starting with 'default':")
+for attr in dir(mcrfpy):
+    if 'default' in attr.lower():
+        print(f"  {attr}")
+
+sys.exit(0)
diff --git a/tests/docs/test_entity_api.py b/tests/docs/test_entity_api.py
new file mode 100644
index 0000000..6cc8601
--- /dev/null
+++ b/tests/docs/test_entity_api.py
@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+"""Quick test to verify Entity constructor signature."""
+import mcrfpy
+import sys
+
+scene = mcrfpy.Scene("test")
+scene.activate()
+mcrfpy.step(0.01)
+
+texture = mcrfpy.Texture("assets/kenney_tinydungeon.png", 16, 16)
+grid = mcrfpy.Grid(grid_size=(20, 15), texture=texture, pos=(10, 10), size=(640, 480))
+scene.children.append(grid)
+
+# Test grid_pos vs grid_x/grid_y
+try:
+    e1 = mcrfpy.Entity(grid_pos=(5, 5), texture=texture, sprite_index=85)
+    grid.entities.append(e1)
+    print("grid_pos= WORKS")
+except TypeError as e:
+    print(f"grid_pos= FAILS: {e}")
+
+try:
+    e2 = mcrfpy.Entity(grid_x=7, grid_y=7, texture=texture, sprite_index=85)
+    grid.entities.append(e2)
+    print("grid_x=/grid_y= WORKS")
+except TypeError as e:
+    print(f"grid_x=/grid_y= FAILS: {e}")
+
+print("Entity API test complete")
+sys.exit(0)
diff --git a/tests/docs/test_features_animation.py b/tests/docs/test_features_animation.py
new file mode 100644
index 0000000..2a40238
--- /dev/null
+++ b/tests/docs/test_features_animation.py
@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+"""Test for features/animation.md examples.
+
+Tests the modern API equivalents of animation examples.
+"""
+import mcrfpy
+from mcrfpy import automation
+import sys
+
+# Setup scene using modern API
+scene = mcrfpy.Scene("animation_demo")
+scene.activate()
+mcrfpy.step(0.01)
+
+# Test 1: Basic Animation (lines 9-19)
+frame = mcrfpy.Frame(pos=(0, 0), size=(100, 100))
+frame.fill_color = mcrfpy.Color(255, 0, 0)
+scene.children.append(frame)
+
+# Animate x position
+anim = mcrfpy.Animation("x", 500.0, 2.0, "easeInOut")
+anim.start(frame)
+print("Test 1: Basic animation started")
+
+# Step forward to run animation
+mcrfpy.step(2.5)
+
+# Verify animation completed
+if abs(frame.x - 500.0) < 1.0:
+    print("Test 1: PASS - frame moved to x=500")
+else:
+    print(f"Test 1: FAIL - frame at x={frame.x}, expected 500")
+    sys.exit(1)
+
+# Test 2: Multiple simultaneous animations (lines 134-144)
+frame2 = mcrfpy.Frame(pos=(0, 0), size=(100, 100))
+frame2.fill_color = mcrfpy.Color(0, 255, 0)
+scene.children.append(frame2)
+
+mcrfpy.Animation("x", 200.0, 1.0, "easeInOut").start(frame2)
+mcrfpy.Animation("y", 150.0, 1.0, "easeInOut").start(frame2)
+mcrfpy.Animation("w", 300.0, 1.0, "easeInOut").start(frame2)
+mcrfpy.Animation("h", 200.0, 1.0, "easeInOut").start(frame2)
+
+mcrfpy.step(1.5)
+
+if abs(frame2.x - 200.0) < 1.0 and abs(frame2.y - 150.0) < 1.0:
+    print("Test 2: PASS - multiple animations completed")
+else:
+    print(f"Test 2: FAIL - frame2 at ({frame2.x}, {frame2.y})")
+    sys.exit(1)
+
+# Test 3: Callback (lines 105-112)
+callback_fired = False
+
+def on_complete(animation, target):
+    global callback_fired
+    callback_fired = True
+    print("Test 3: Callback fired!")
+
+frame3 = mcrfpy.Frame(pos=(0, 300), size=(50, 50))
+frame3.fill_color = mcrfpy.Color(0, 0, 255)
+scene.children.append(frame3)
+
+anim3 = mcrfpy.Animation("x", 300.0, 0.5, "easeInOut", callback=on_complete)
+anim3.start(frame3)
+
+mcrfpy.step(1.0)
+
+if callback_fired:
+    print("Test 3: PASS - callback executed")
+else:
+    print("Test 3: FAIL - callback not executed")
+    sys.exit(1)
+
+# Test 4: NOTE - Opacity animation documented in features/animation.md
+# but DOES NOT WORK on Frame. The property exists but animation
+# system doesn't animate it. This is a DOCS BUG to report.
+# Skipping test 4 - opacity animation not supported.
+print("Test 4: SKIPPED - opacity animation not supported on Frame (docs bug)")
+
+# Take screenshot showing animation results
+automation.screenshot("/opt/goblincorps/repos/McRogueFace/tests/docs/screenshots/features_animation.png")
+
+print("\nAll animation tests PASS")
+sys.exit(0)
diff --git a/tests/docs/test_features_scenes.py b/tests/docs/test_features_scenes.py
new file mode 100644
index 0000000..89f6a6d
--- /dev/null
+++ b/tests/docs/test_features_scenes.py
@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""Test for features/scenes.md examples.
+
+Tests both modern and procedural APIs from the docs.
+"""
+import mcrfpy
+from mcrfpy import automation
+import sys
+
+# Test 1: Modern Scene API (lines 28-42)
+print("Test 1: Modern Scene API")
+scene = mcrfpy.Scene("test_modern")
+scene.children.append(mcrfpy.Frame(pos=(0, 0), size=(800, 600)))
+
+def my_handler(key, action):
+    if action == "start":
+        print(f"  Key handler received: {key}")
+
+scene.on_key = my_handler
+scene.activate()
+mcrfpy.step(0.1)
+print("  PASS - modern Scene API works")
+
+# Test 2: Check Scene properties
+print("Test 2: Scene properties")
+print(f"  scene.name = {scene.name}")
+print(f"  scene.active = {scene.active}")
+print(f"  len(scene.children) = {len(scene.children)}")
+
+# Test 3: Check if default_texture exists
+print("Test 3: default_texture")
+try:
+    dt = mcrfpy.default_texture
+    print(f"  mcrfpy.default_texture = {dt}")
+except AttributeError:
+    print("  default_texture NOT FOUND - docs bug!")
+
+# Test 4: Check if currentScene exists
+print("Test 4: currentScene()")
+try:
+    current = mcrfpy.currentScene()
+    print(f"  mcrfpy.currentScene() = {current}")
+except AttributeError:
+    print("  currentScene() NOT FOUND - docs bug!")
+
+# Test 5: Check Grid.at() signature
+print("Test 5: Grid.at() signature")
+texture = mcrfpy.Texture("assets/kenney_tinydungeon.png", 16, 16)
+grid = mcrfpy.Grid(grid_size=(10, 10), texture=texture, pos=(0, 0), size=(200, 200))
+
+# Try both signatures
+try:
+    point_tuple = grid.at((5, 5))
+    print("  grid.at((x, y)) - tuple WORKS")
+except Exception as e:
+    print(f"  grid.at((x, y)) FAILS: {e}")
+
+try:
+    point_sep = grid.at(5, 5)
+    print("  grid.at(x, y) - separate args WORKS")
+except Exception as e:
+    print(f"  grid.at(x, y) FAILS: {e}")
+
+# Test 6: Scene transitions (setScene)
+print("Test 6: setScene()")
+scene2 = mcrfpy.Scene("test_transitions")
+scene2.activate()
+mcrfpy.step(0.1)
+
+# Check if setScene exists
+try:
+    mcrfpy.setScene("test_modern")
+    print("  mcrfpy.setScene() WORKS")
+except AttributeError:
+    print("  mcrfpy.setScene() NOT FOUND - use scene.activate() instead")
+except Exception as e:
+    print(f"  mcrfpy.setScene() error: {e}")
+
+# Take screenshot
+mcrfpy.step(0.1)
+automation.screenshot("/opt/goblincorps/repos/McRogueFace/tests/docs/screenshots/features_scenes.png")
+
+print("\nAll scene tests complete")
+sys.exit(0)
diff --git a/tests/docs/test_quickstart_entities.py b/tests/docs/test_quickstart_entities.py
new file mode 100644
index 0000000..dfc668f
--- /dev/null
+++ b/tests/docs/test_quickstart_entities.py
@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+"""Test for quickstart.md 'Game Entity' example.
+
+Original (DEPRECATED - lines 133-168):
+    mcrfpy.createScene("game")
+    grid = mcrfpy.Grid(20, 15, texture, (10, 10), (640, 480))
+    ui = mcrfpy.sceneUI("game")
+    player = mcrfpy.Entity((10, 7), texture, 85)
+    mcrfpy.keypressScene(handle_keys)
+    mcrfpy.setScene("game")
+
+Modern equivalent below.
+"""
+import mcrfpy
+from mcrfpy import automation
+import sys
+
+# Create scene using modern API
+scene = mcrfpy.Scene("game")
+scene.activate()
+mcrfpy.step(0.01)
+
+# Load texture
+texture = mcrfpy.Texture("assets/kenney_tinydungeon.png", 16, 16)
+
+# Create grid using modern keyword API
+grid = mcrfpy.Grid(
+    grid_size=(20, 15),
+    texture=texture,
+    pos=(10, 10),
+    size=(640, 480)
+)
+scene.children.append(grid)
+
+# Add player entity
+player = mcrfpy.Entity(grid_pos=(10, 7), texture=texture, sprite_index=85)
+grid.entities.append(player)
+
+# Add NPC entity
+npc = mcrfpy.Entity(grid_pos=(5, 5), texture=texture, sprite_index=109)
+grid.entities.append(npc)
+
+# Add treasure chest
+treasure = mcrfpy.Entity(grid_pos=(15, 10), texture=texture, sprite_index=89)
+grid.entities.append(treasure)
+
+# Movement handler using modern API
+def handle_keys(key, state):
+    if state == "start":
+        x, y = player.pos[0], player.pos[1]
+        if key == "W":
+            player.pos = (x, y - 1)
+        elif key == "S":
+            player.pos = (x, y + 1)
+        elif key == "A":
+            player.pos = (x - 1, y)
+        elif key == "D":
+            player.pos = (x + 1, y)
+
+scene.on_key = handle_keys
+
+# Center grid on player
+grid.center = (10, 7)
+
+# Render and screenshot
+mcrfpy.step(0.1)
+automation.screenshot("/opt/goblincorps/repos/McRogueFace/tests/docs/screenshots/quickstart_entities.png")
+
+print("PASS - quickstart entities")
+sys.exit(0)
diff --git a/tests/docs/test_quickstart_main_menu.py b/tests/docs/test_quickstart_main_menu.py
new file mode 100644
index 0000000..30a9a0d
--- /dev/null
+++ b/tests/docs/test_quickstart_main_menu.py
@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""Test for quickstart.md 'Main Menu' example.
+
+Original (DEPRECATED - lines 82-125):
+    mcrfpy.createScene("main_menu")
+    ui = mcrfpy.sceneUI("main_menu")
+    bg = mcrfpy.Frame(0, 0, 1024, 768, fill_color=(20, 20, 40))
+    title = mcrfpy.Caption((312, 100), "My Awesome Game", font, fill_color=(255, 255, 100))
+    button_frame.click = start_game
+    mcrfpy.setScene("main_menu")
+
+Modern equivalent below.
+"""
+import mcrfpy
+from mcrfpy import automation
+import sys
+
+# Create scene using modern API
+scene = mcrfpy.Scene("main_menu")
+scene.activate()
+mcrfpy.step(0.01)
+
+# Load font
+font = mcrfpy.Font("assets/JetbrainsMono.ttf")
+
+# Add background using modern Frame API (keyword args)
+bg = mcrfpy.Frame(
+    pos=(0, 0),
+    size=(1024, 768),
+    fill_color=mcrfpy.Color(20, 20, 40)
+)
+scene.children.append(bg)
+
+# Add title using modern Caption API
+title = mcrfpy.Caption(
+    pos=(312, 100),
+    text="My Awesome Game",
+    font=font,
+    fill_color=mcrfpy.Color(255, 255, 100)
+)
+title.font_size = 48
+title.outline = 2
+title.outline_color = mcrfpy.Color(0, 0, 0)
+scene.children.append(title)
+
+# Create button frame
+button_frame = mcrfpy.Frame(
+    pos=(362, 300),
+    size=(300, 80),
+    fill_color=mcrfpy.Color(50, 150, 50)
+)
+
+# Button caption
+button_caption = mcrfpy.Caption(
+    pos=(90, 25),  # Centered in button
+    text="Start Game",
+    fill_color=mcrfpy.Color(255, 255, 255)
+)
+button_caption.font_size = 24
+button_frame.children.append(button_caption)
+
+# Click handler using modern on_click (3 args: x, y, button)
+def start_game(x, y, button):
+    print("Starting the game!")
+
+button_frame.on_click = start_game
+scene.children.append(button_frame)
+
+# Render and screenshot
+mcrfpy.step(0.1)
+automation.screenshot("/opt/goblincorps/repos/McRogueFace/tests/docs/screenshots/quickstart_main_menu.png")
+
+print("PASS - quickstart main menu")
+sys.exit(0)
diff --git a/tests/docs/test_quickstart_simple_scene.py b/tests/docs/test_quickstart_simple_scene.py
new file mode 100644
index 0000000..fdcb4f3
--- /dev/null
+++ b/tests/docs/test_quickstart_simple_scene.py
@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+"""Test for quickstart.md 'Simple Test Scene' example.
+
+Original (DEPRECATED - lines 48-74):
+    mcrfpy.createScene("test")
+    grid = mcrfpy.Grid(20, 15, texture, (10, 10), (800, 600))
+    ui = mcrfpy.sceneUI("test")
+    mcrfpy.setScene("test")
+    mcrfpy.keypressScene(move_around)
+
+Modern equivalent below.
+"""
+import mcrfpy
+from mcrfpy import automation
+import sys
+
+# Create scene using modern API
+scene = mcrfpy.Scene("test")
+scene.activate()
+mcrfpy.step(0.01)  # Initialize
+
+# Load texture
+texture = mcrfpy.Texture("assets/kenney_tinydungeon.png", 16, 16)
+
+# Create grid using modern keyword API
+grid = mcrfpy.Grid(
+    grid_size=(20, 15),
+    texture=texture,
+    pos=(10, 10),
+    size=(800, 600)
+)
+
+# Add to scene's children (not sceneUI)
+scene.children.append(grid)
+
+# Add keyboard controls using modern API
+def move_around(key, state):
+    if state == "start":
+        print(f"You pressed {key}")
+
+scene.on_key = move_around
+
+# Render and screenshot
+mcrfpy.step(0.1)
+automation.screenshot("/opt/goblincorps/repos/McRogueFace/tests/docs/screenshots/quickstart_simple_scene.png")
+
+print("PASS - quickstart simple scene")
+sys.exit(0)
diff --git a/tests/docs/test_quickstart_sprites.py b/tests/docs/test_quickstart_sprites.py
new file mode 100644
index 0000000..2975a48
--- /dev/null
+++ b/tests/docs/test_quickstart_sprites.py
@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+"""Test for quickstart.md 'Custom Sprite Sheet' example.
+
+Original (DEPRECATED - lines 176-201):
+    mcrfpy.createScene("game")
+    grid = mcrfpy.Grid(20, 15, my_texture, (10, 10), (640, 480))
+    grid.at(5, 5).sprite = 10
+    ui = mcrfpy.sceneUI("game")
+    mcrfpy.setScene("game")
+
+Modern equivalent below.
+"""
+import mcrfpy
+from mcrfpy import automation
+import sys
+
+# Create scene using modern API
+scene = mcrfpy.Scene("game")
+scene.activate()
+mcrfpy.step(0.01)
+
+# Load sprite sheet (using existing texture for test)
+texture = mcrfpy.Texture("assets/kenney_tinydungeon.png", 16, 16)
+
+# Create grid using modern keyword API
+grid = mcrfpy.Grid(
+    grid_size=(20, 15),
+    texture=texture,
+    pos=(10, 10),
+    size=(640, 480)
+)
+
+# Set specific tiles using modern API
+# grid.at() returns a GridPoint with tilesprite property
+grid.at((5, 5)).tilesprite = 10  # Note: tuple for position
+grid.at((6, 5)).tilesprite = 11
+
+# Set walkability
+grid.at((6, 5)).walkable = False
+
+# Add grid to scene
+scene.children.append(grid)
+
+# Render and screenshot
+mcrfpy.step(0.1)
+automation.screenshot("/opt/goblincorps/repos/McRogueFace/tests/docs/screenshots/quickstart_sprites.png")
+
+print("PASS - quickstart sprites")
+sys.exit(0)