Fix tile cancellation - #602

#!/bin/bash
rg -nP -C8 '\.prune\s*\(' --type=ts packages/render/src
rg -nP -C6 'pruneInfoByMapId|MapPruneInfo' --type=ts packages/render/src

#!/bin/bash
set -eu

printf '%s\n' '--- TileCache structure ---'
ast-grep outline packages/render/src/tilecache/TileCache.ts
printf '%s\n' '--- TileCache prune and removal logic ---'
sed -n '220,390p' packages/render/src/tilecache/TileCache.ts

printf '%s\n' '--- CacheableTile lifecycle and pruning ---'
ast-grep outline packages/render/src/tilecache/CacheableTile.ts
sed -n '1,220p' packages/render/src/tilecache/CacheableTile.ts

printf '%s\n' '--- pruneTileCache callers and renderer timing ---'
rg -n -P -C10 'pruneTileCache|requestAnimationFrame|setTimeout|setInterval|render\(' packages/render/src/renderers packages/render/src | head -n 500

#!/bin/bash
set -eu

printf '%s\n' '--- remaining TileCache removal and fetch handlers ---'
sed -n '380,620p' packages/render/src/tilecache/TileCache.ts

printf '%s\n' '--- BaseRenderer request and render flow ---'
sed -n '650,745p' packages/render/src/renderers/BaseRenderer.ts
sed -n '1080,1180p' packages/render/src/renderers/BaseRenderer.ts

printf '%s\n' '--- BaseRenderer render call sites and event handlers ---'
rg -n -P -C12 'render\(|changed\(|TILEFETCHED|TILEFETCHERROR|MAPTILELOADED' packages/render/src/renderers/BaseRenderer.ts packages/render/src/renderers/WebGL2Renderer.ts packages/render/src/renderers/CanvasRenderer.ts

printf '%s\n' '--- TileCache tests and queue assertions ---'
rg -n -P -C8 'tileRemoveQueue|delayedRemove|prune\(|abort|requestFetchableTiles' packages/render/test packages/render/src --glob '*.{ts,tsx}' 2>/dev/null | head -n 600

#!/bin/bash
set -eu

printf '%s\n' '--- BaseRenderer render preparation and scheduling ---'
ast-grep outline packages/render/src/renderers/BaseRenderer.ts
sed -n '250,430p' packages/render/src/renderers/BaseRenderer.ts
sed -n '430,650p' packages/render/src/renderers/BaseRenderer.ts
sed -n '1180,1345p' packages/render/src/renderers/BaseRenderer.ts

printf '%s\n' '--- TileCache request implementation ---'
sed -n '1,230p' packages/render/src/tilecache/TileCache.ts

printf '%s\n' '--- focused tile-cache tests ---'
sed -n '1,180p' packages/render/test/tile-cache.test.ts

printf '%s\n' '--- focused renderer scheduling symbols ---'
rg -n 'prepareRenderInternal|thrott|requestAnimationFrame|setTimeout|render\(' packages/render/src/renderers/BaseRenderer.ts packages/render/src/renderers/WebGL2Renderer.ts packages/render/src/renderers/CanvasRenderer.ts

#!/bin/bash
set -eu

printf '%s\n' '--- WebGL2Renderer throttle configuration and preparation ---'
sed -n '200,380p' packages/render/src/renderers/WebGL2Renderer.ts
sed -n '440,535p' packages/render/src/renderers/WebGL2Renderer.ts

printf '%s\n' '--- renderer option defaults and buffer relationships ---'
rg -n -P -C8 'requestViewportBufferRatio|pruneViewportBufferRatio|overviewRequestViewportBufferRatio|overviewPruneViewportBufferRatio|anticipateInteraction' packages/render/src packages/render/test --glob '*.{ts,tsx}'

printf '%s\n' '--- all TileCache prune tests and recent diff metadata ---'
rg -n -P -C12 'prune\(|pruned while|delayedRemove|tileRemoveQueue|in.flight|in-flight' packages/render/test --glob '*.{ts,tsx}'
git diff --stat

#!/bin/bash
set -eu

python3 - <<'PY'
from pathlib import Path
import re

base = Path('packages/render/src/renderers/BaseRenderer.ts').read_text()
webgl = Path('packages/render/src/renderers/WebGL2Renderer.ts').read_text()
cache = Path('packages/render/src/tilecache/TileCache.ts').read_text()

def required(text, pattern, label):
    match = re.search(pattern, text, re.S)
    if not match:
        raise SystemExit(f'missing {label}')
    return match

defaults = required(
    base,
    r'anticipateInteraction:\s*false.*?'
    r'requestViewportBufferRatio:\s*([0-9.]+).*?'
    r'overviewRequestViewportBufferRatio:\s*([0-9.]+).*?'
    r'pruneViewportBufferRatio:\s*([0-9.]+).*?'
    r'overviewPruneViewportBufferRatio:\s*([0-9.]+)',
    'base buffer defaults',
)
print('BaseRenderer defaults:', defaults.groups())

webgl_default = required(
    webgl,
    r'defaultSpecificWebGL2RenderOptions\s*=\s*\{.*?'
    r'anticipateInteraction:\s*(true|false)',
    'WebGL anticipateInteraction default',
)
print('WebGL2Renderer anticipateInteraction:', webgl_default.group(1))

prepare = required(
    webgl,
    r'`#throttledPrepareRenderInternal`\s*=\s*throttle\(\s*'
    r'this\.\`#prepareRenderInternal`\.bind\(this\),\s*'
    r'([A-Z0-9_]+)',
    'prepare throttle',
)
print('WebGL2Renderer prepare throttle constant:', prepare.group(1))

request_pos = base.index('this.tileCache.requestFetchableTiles(allRequestedTilesForViewport)')
prune_pos = base.index('this.pruneTileCache(mapsInViewportForOverviewPrune)')
print('request-before-prune:', request_pos < prune_pos)

immediate_branch = required(
    cache,
    r'if \(cacheableTile && !cacheableTile\.isCachedTile\(\)\) \{\s*'
    r'this\.removeCacheableTileForMapId\(tileUrl, mapId\)',
    'immediate in-flight removal',
)
removal = required(
    cache,
    r'if \(!mapIds\.size\) \{\s*'
    r'if \(this\.stopFetching\(tileUrl\)\) \{\s*'
    r'cacheableTile\.abort\(\)',
    'abort on final map removal',
)
print('immediate branch and abort-on-last-map:', bool(immediate_branch and removal))

print('Conclusion: current requested tiles are associated before prune; an in-flight tile that prune removes is aborted and absent for a later request.')
PY

#!/bin/bash
set -eu

printf '%s\n' '--- exact throttle values and removal branch ---'
rg -n -C3 'THROTTLE_PREPARE_RENDER_WAIT_MS|THROTTLE_PREPARE_RENDER_OPTIONS|THROTTLE_CHANGED_WAIT_MS' packages/render/src/renderers/WebGL2Renderer.ts
sed -n '398,425p' packages/render/src/tilecache/TileCache.ts

printf '%s\n' '--- minimal read-only invariant check ---'
python3 - <<'PY'
from pathlib import Path

cache = Path('packages/render/src/tilecache/TileCache.ts').read_text()
base = Path('packages/render/src/renderers/BaseRenderer.ts').read_text()

checks = {
    'request precedes prune': base.index(
        'this.tileCache.requestFetchableTiles(allRequestedTilesForViewport)'
    ) < base.index(
        'this.pruneTileCache(mapsInViewportForOverviewPrune)'
    ),
    'in-flight branch removes immediately': (
        'if (cacheableTile && !cacheableTile.isCachedTile())' in cache
        and 'this.removeCacheableTileForMapId(tileUrl, mapId)' in cache
    ),
    'last-map removal aborts': (
        'if (!mapIds.size)' in cache
        and 'if (this.stopFetching(tileUrl))' in cache
        and 'cacheableTile.abort()' in cache
    ),
}
for name, result in checks.items():
    print(f'{name}: {result}')
if not all(checks.values()):
    raise SystemExit(1)
PY

#!/bin/bash
# Find all callers of getImageData and the tile lifecycle that can re-request a URL.
rg -nP -C6 '\bgetImageData\s*\(' --type=ts packages/render/src

# Check whether a tile URL can be re-added while a previous fetch is unsettled.
rg -nP -C8 'addCacheableTile|requestFetchableTile\b|tilesByTileUrl\.(set|delete)' packages/render/src/tilecache/TileCache.ts

#!/bin/bash
set -eu

printf '%s\n' '--- fetch-and-get-image-data.ts ---'
cat -n packages/render/src/workers/fetch-and-get-image-data.ts

printf '%s\n' '--- CacheableWorkerImageDataTile.ts ---'
cat -n packages/render/src/tilecache/CacheableWorkerImageDataTile.ts

printf '%s\n' '--- worker pool and worker API references ---'
rg -n -C5 'WorkerPool|fetchAndGetImageDataWorker|abortControllers|\.abort\(' packages/render/src/workers packages/render/src/tilecache --type=ts

printf '%s\n' '--- TileCache lifecycle around removal and cancellation ---'
sed -n '240,430p' packages/render/src/tilecache/TileCache.ts

#!/bin/bash
set -eu

printf '%s\n' '--- PoolWorkers.ts ---'
cat -n packages/render/src/workers/PoolWorkers.ts

printf '%s\n' '--- WorkerPool construction and cache wiring ---'
rg -n -C8 'new WorkerPool|createFactory\(|CacheableWorkerImageDataTile' packages/render/src --type=ts

printf '%s\n' '--- all getImageData and worker abort call sites ---'
rg -n -C4 '\.getImageData\(|\.abort\(this\.fetchableTile\.tileUrl\)|fetchAndGetImageDataWorker' packages --type=ts

printf '%s\n' '--- package tests for worker/tile concurrency ---'
rg -n -C5 'CacheableWorkerImageDataTile|PoolWorkers|getImageData|abortControllers' packages/render --glob '*.{test,spec}.{ts,tsx,js}'

#!/bin/bash
set -eu

printf '%s\n' '--- relevant worker-pool configuration ---'
rg -n -C3 'POOL_SIZE|new WorkerPool|`#workerPool`|workerPool' packages/render/src/renderers/WebGL2Renderer.ts packages/render/src --type=ts | head -120

printf '%s\n' '--- direct concurrency test ---'
sed -n '335,375p' packages/render/test/fetch-and-get-image-data.test.ts

printf '%s\n' '--- concise cache/renderer construction references ---'
rg -n 'new TileCache|new WebGL2Renderer|CacheableWorkerImageDataTile.createFactory|new WorkerPool' packages/render/src packages/render/test --type=ts

printf '%s\n' '--- deterministic WorkerPool simulation ---'
python3 - <<'PY'
from pathlib import Path
import re

source = Path('packages/render/src/workers/PoolWorkers.ts').read_text()
size = 4
outstanding = [0] * size
assignments = []

for request in range(size + 1):
    min_index = min(range(len(outstanding)), key=lambda i: outstanding[i])
    outstanding[min_index] += 1
    assignments.append(min_index)

print('acquire assignments for five overlapping requests with pool size four:', assignments)
print('same-worker overlap:', len(set(assignments)) < len(assignments))
print('pool acquire increments outstanding:', bool(re.search(r'`#outstanding`\\[minIndex\\]\\+\\+', source)))
print('pool release occurs only in caller finally:', 'release(index)' in Path('packages/render/src/tilecache/CacheableWorkerImageDataTile.ts').read_text())
PY