diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2621fe7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Prefecture Map Generator
+
+A browser-based procedural prefecture map generator.
+
+## Project layout
+
+- `src/` - application modules and web workers
+- `styles/` - application styles
+- `tests/` - reusable browser and Node.js tests
+- `scripts/` - local development server helpers
+- `archive/` - recoverable historical and legacy files, excluded from the active app
+- `index.html` - application entry point
+
+## Run locally
+
+On Windows:
+
+```bat
+scripts\start_server.bat 8000
+```
+
+On macOS or Linux:
+
+```sh
+./scripts/start_server.sh 8000
+```
+
+Then open `http://127.0.0.1:8000/`.
+
+## Tests
+
+Run the complete Node.js test suite from the project root:
+
+```sh
+node tests/test-all.mjs
+```
+
+The browser test page is available at `http://127.0.0.1:8000/tests/test.html`.
diff --git a/app.js b/app.js
deleted file mode 100644
index 6eab3ad..0000000
--- a/app.js
+++ /dev/null
@@ -1,1041 +0,0 @@
-import { generateMapAsync } from "./mapGenerator.js";
-import { drawMap } from "./renderer.js";
-import { landuseLabel } from "./landuseCodes.js";
-import { CELL_SIZE, MAP_H, MAP_W } from "./mapUtils.js";
-import { clampCameraToWorld, createInitialCamera, createWorldMap, ensureWorldPaddingForCamera } from "./worldMap.js";
-import { getViewportMap } from "./worldViewport.js";
-import { PATCH_MIN_AREA, PATCH_MIN_HEIGHT, PATCH_MIN_WIDTH, buildPatchRects, generatePatch, validatePatchRect } from "./mapPatch.js";
-
-const modes = [
-  ["all", "All"],
-  ["terrain", "Terrain"],
-  ["history", "Premodern"],
-  ["modern", "Modern"],
-  ["development", "Development"],
-  ["landuse", "Land Use"],
-  ["admin", "Municipal Borders"],
-  ["borders-debug", "Borders Debug"],
-  ["transport-debug", "Transport Debug"],
-];
-
-const state = {
-  seedText: "114514",
-  generationType: "auto",
-  mode: "all",
-  showFeatures: true,
-  showLabels: true,
-  map: null,
-  world: null,
-  camera: { x: 0, y: 0 },
-  viewportMap: null,
-  viewWidth: MAP_W,
-  viewHeight: MAP_H,
-  hoverEntities: [],
-  selectionRect: null,
-  patchVariant: 0,
-  zoom: 1,
-  lastPatchResult: null,
-};
-
-const canvas = document.getElementById("mapCanvas");
-const canvasShell = document.querySelector(".canvas-shell");
-const seedInput = document.getElementById("seed");
-const generationTypeInput = document.getElementById("generationType");
-const patchTerrainTypeInput = document.getElementById("patchTerrainType");
-const patchVariantInput = document.getElementById("patchVariant");
-const generatePatchButton = document.getElementById("generatePatch");
-const alternativePatchButton = document.getElementById("alternativePatch");
-const patchStatusEl = document.getElementById("patchStatus");
-const randomSeedButton = document.getElementById("randomSeed");
-const showFeaturesInput = document.getElementById("showFeatures");
-const showLabelsInput = document.getElementById("showLabels");
-const modeGrid = document.getElementById("modeGrid");
-const statsEl = document.getElementById("stats");
-const tooltipEl = document.getElementById("mapTooltip");
-const selectionSvgEl = document.getElementById("mapSelectionSvg");
-const selectionEl = document.getElementById("mapSelection");
-const progressEl = document.getElementById("generationProgress");
-const progressStageEl = document.getElementById("generationProgressStage");
-const progressTimingsEl = document.getElementById("generationProgressTimings");
-let generationStartedAt = 0;
-let generationCurrentStage = "";
-let generationTimer = null;
-let zoomRedrawRaf = null;
-let zoomSettledTimer = null;
-
-const dragState = {
-  mode: null,
-  pointerId: null,
-  startClientX: 0,
-  startClientY: 0,
-  startCameraX: 0,
-  startCameraY: 0,
-  selectStart: null,
-  selectEnd: null,
-  selectPath: null,
-  pendingCamera: null,
-  panRaf: null,
-};
-
-function activeMap() {
-  return state.viewportMap || state.map;
-}
-
-function clampZoom(value) {
-  const parsed = Number(value);
-  if (!Number.isFinite(parsed)) return 1;
-  return Math.min(Math.max(parsed, 0.55), 2.8);
-}
-
-function viewportSizeForZoom(zoom = state.zoom) {
-  const z = clampZoom(zoom || 1);
-  return {
-    width: Math.max(1, Math.ceil(MAP_W / z)),
-    height: Math.max(1, Math.ceil(MAP_H / z)),
-  };
-}
-
-function clampCameraForView(camera, size = viewportSizeForZoom(state.zoom)) {
-  return clampCameraToWorld(camera, state.world, size?.width || MAP_W, size?.height || MAP_H);
-}
-
-function syncViewportSize() {
-  const size = viewportSizeForZoom(state.zoom);
-  state.viewWidth = size.width;
-  state.viewHeight = size.height;
-  return size;
-}
-
-function mapCellScreenSize(map = activeMap()) {
-  const rect = canvas.getBoundingClientRect();
-  const mapWidth = Math.max(1, map?.width || state.viewWidth || MAP_W);
-  return rect.width ? rect.width / mapWidth : CELL_SIZE * clampZoom(state.zoom || 1);
-}
-
-function applyCanvasZoom() {
-  if (!canvas) return;
-  state.zoom = clampZoom(state.zoom || 1);
-  // Keep the canvas element at a stable size.  Zoom is applied inside the
-  // renderer transform, not by resizing the scrollable shell.
-  canvas.style.width = `${MAP_W * CELL_SIZE}px`;
-  canvas.style.height = `${MAP_H * CELL_SIZE}px`;
-  updateSelectionOverlayFromWorldRect();
-}
-
-function displayedCellSize() {
-  return mapCellScreenSize();
-}
-
-function screenPointToMapPixel(clientX, clientY, sizeOverride = null) {
-  const rect = canvas.getBoundingClientRect();
-  if (!rect.width || !rect.height) return null;
-  const map = activeMap();
-  const viewWidth = Math.max(1, sizeOverride?.width || map?.width || state.viewWidth || MAP_W);
-  const viewHeight = Math.max(1, sizeOverride?.height || map?.height || state.viewHeight || MAP_H);
-  const canvasX = (clientX - rect.left) * ((canvas.width || MAP_W * CELL_SIZE) / rect.width);
-  const canvasY = (clientY - rect.top) * ((canvas.height || MAP_H * CELL_SIZE) / rect.height);
-  const cellX = canvasX / Math.max(1e-6, (canvas.width || MAP_W * CELL_SIZE) / viewWidth);
-  const cellY = canvasY / Math.max(1e-6, (canvas.height || MAP_H * CELL_SIZE) / viewHeight);
-  return { x: cellX * CELL_SIZE, y: cellY * CELL_SIZE };
-}
-
-function mapPixelToScreenPoint(px, py) {
-  const rect = canvas.getBoundingClientRect();
-  const map = activeMap();
-  const viewWidth = Math.max(1, map?.width || state.viewWidth || MAP_W);
-  const viewHeight = Math.max(1, map?.height || state.viewHeight || MAP_H);
-  const canvasX = (px / CELL_SIZE) * ((canvas.width || MAP_W * CELL_SIZE) / viewWidth);
-  const canvasY = (py / CELL_SIZE) * ((canvas.height || MAP_H * CELL_SIZE) / viewHeight);
-  return {
-    x: canvas.offsetLeft + canvasX * (rect.width / Math.max(1, canvas.width || MAP_W * CELL_SIZE)),
-    y: canvas.offsetTop + canvasY * (rect.height / Math.max(1, canvas.height || MAP_H * CELL_SIZE)),
-  };
-}
-
-function mapClientToCell(event, sizeOverride = null) {
-  const map = activeMap();
-  if (!map && !sizeOverride) return null;
-  const p = screenPointToMapPixel(event.clientX, event.clientY, sizeOverride);
-  if (!p) return null;
-  return {
-    x: Math.floor(p.x / CELL_SIZE),
-    y: Math.floor(p.y / CELL_SIZE),
-  };
-}
-
-function viewportCellToWorldCell(cell) {
-  if (!cell || !state.camera) return null;
-  return {
-    x: Math.round(state.camera.x || 0) + cell.x,
-    y: Math.round(state.camera.y || 0) + cell.y,
-  };
-}
-
-function clampCanvasPoint(event) {
-  const rect = canvas.getBoundingClientRect();
-  return {
-    x: Math.min(Math.max(event.clientX - rect.left, 0), rect.width),
-    y: Math.min(Math.max(event.clientY - rect.top, 0), rect.height),
-  };
-}
-
-function screenPointToWorldCell(point) {
-  const map = activeMap();
-  if (!map || !point) return null;
-  const rect = canvas.getBoundingClientRect();
-  if (!rect.width || !rect.height) return null;
-  const viewWidth = Math.max(1, map.width || state.viewWidth || MAP_W);
-  const viewHeight = Math.max(1, map.height || state.viewHeight || MAP_H);
-  const canvasX = point.x * ((canvas.width || MAP_W * CELL_SIZE) / rect.width);
-  const canvasY = point.y * ((canvas.height || MAP_H * CELL_SIZE) / rect.height);
-  const localX = Math.floor((canvasX / Math.max(1e-6, (canvas.width || MAP_W * CELL_SIZE) / viewWidth)));
-  const localY = Math.floor((canvasY / Math.max(1e-6, (canvas.height || MAP_H * CELL_SIZE) / viewHeight)));
-  const cameraX = Math.round(state.camera?.x || 0);
-  const cameraY = Math.round(state.camera?.y || 0);
-  return {
-    x: cameraX + Math.min(Math.max(localX, 0), Math.max(0, map.width - 1)),
-    y: cameraY + Math.min(Math.max(localY, 0), Math.max(0, map.height - 1)),
-  };
-}
-
-function worldCellToOverlayPoint(point) {
-  const cameraX = Math.round(state.camera?.x || 0);
-  const cameraY = Math.round(state.camera?.y || 0);
-  const screen = mapPixelToScreenPoint((point.x - cameraX + 0.5) * CELL_SIZE, (point.y - cameraY + 0.5) * CELL_SIZE);
-  return { x: screen.x - canvas.offsetLeft, y: screen.y - canvas.offsetTop };
-}
-
-function simplifySelectionPath(points) {
-  const out = [];
-  for (const p of points || []) {
-    if (!out.length || Math.hypot(out[out.length - 1].x - p.x, out[out.length - 1].y - p.y) >= 6) out.push(p);
-  }
-  return out;
-}
-
-function polygonArea(points) {
-  let area = 0;
-  for (let i = 0; i < points.length; i++) {
-    const a = points[i];
-    const b = points[(i + 1) % points.length];
-    area += a.x * b.y - b.x * a.y;
-  }
-  return Math.abs(area) * 0.5;
-}
-
-function selectionPathToShape(points) {
-  const simplified = simplifySelectionPath(points || []);
-  if (simplified.length < 3) return null;
-  const polygon = simplified.map(screenPointToWorldCell).filter(Boolean);
-  if (polygon.length < 3) return null;
-  const xs = polygon.map((p) => p.x);
-  const ys = polygon.map((p) => p.y);
-  return {
-    kind: "lasso",
-    polygon,
-    x0: Math.min(...xs),
-    y0: Math.min(...ys),
-    x1: Math.max(...xs) + 1,
-    y1: Math.max(...ys) + 1,
-    areaCells: Math.max(1, Math.round(polygonArea(polygon))),
-  };
-}
-
-function drawSelectionSvg(points, invalid = false) {
-  if (!selectionSvgEl) return;
-  if (!points || points.length < 3) {
-    selectionSvgEl.style.display = "none";
-    selectionSvgEl.innerHTML = "";
-    return;
-  }
-  const pts = points.map((p) => `${p.x},${p.y}`).join(" ");
-  selectionSvgEl.setAttribute("viewBox", `0 0 ${canvas.clientWidth || canvas.width || 1} ${canvas.clientHeight || canvas.height || 1}`);
-  selectionSvgEl.innerHTML = `<polygon points="${pts}" />`;
-  selectionSvgEl.style.display = "block";
-  selectionSvgEl.classList.toggle("invalid", !!invalid);
-}
-
-function hideSelectionSvg() {
-  if (!selectionSvgEl) return;
-  selectionSvgEl.style.display = "none";
-  selectionSvgEl.innerHTML = "";
-  selectionSvgEl.classList.remove("invalid");
-}
-
-function updateSelectionOverlay() {
-  if (!dragState.selectPath?.length) return;
-  const liveShape = selectionPathToShape(dragState.selectPath);
-  const validation = validatePatchRect(liveShape, state.world);
-  drawSelectionSvg(dragState.selectPath, !validation.ok);
-  if (selectionEl) selectionEl.style.display = "none";
-  if (generatePatchButton) generatePatchButton.disabled = true;
-  if (alternativePatchButton) alternativePatchButton.disabled = true;
-  if (patchStatusEl) {
-    const current = validation.rect || liveShape;
-    patchStatusEl.textContent = validation.ok
-      ? `Selected: ${formatRectSize(validation.rect)}. Release to confirm patch selection.`
-      : `${validation.reason} Current: ${formatRectSize(current)}.`;
-    patchStatusEl.classList.toggle("invalid", !validation.ok);
-  }
-}
-
-function updateSelectionOverlayFromWorldRect() {
-  if (!state.selectionRect || !state.camera || !activeMap()) return;
-  const rect = canvas.getBoundingClientRect();
-  if (!rect.width || !rect.height) return;
-  if (Array.isArray(state.selectionRect.polygon) && state.selectionRect.polygon.length >= 3) {
-    const points = state.selectionRect.polygon.map(worldCellToOverlayPoint)
-      .map((p) => ({ x: Math.min(Math.max(p.x, 0), rect.width), y: Math.min(Math.max(p.y, 0), rect.height) }));
-    drawSelectionSvg(points, !validatePatchRect(state.selectionRect, state.world).ok);
-    if (selectionEl) selectionEl.style.display = "none";
-    return;
-  }
-  const cameraX = Math.round(state.camera.x || 0);
-  const cameraY = Math.round(state.camera.y || 0);
-  const p0 = mapPixelToScreenPoint((state.selectionRect.x0 - cameraX) * CELL_SIZE, (state.selectionRect.y0 - cameraY) * CELL_SIZE);
-  const p1 = mapPixelToScreenPoint((state.selectionRect.x1 - cameraX) * CELL_SIZE, (state.selectionRect.y1 - cameraY) * CELL_SIZE);
-  const vx0 = p0.x - canvas.offsetLeft;
-  const vy0 = p0.y - canvas.offsetTop;
-  const vx1 = p1.x - canvas.offsetLeft;
-  const vy1 = p1.y - canvas.offsetTop;
-  const x0 = Math.min(Math.max(Math.min(vx0, vx1), 0), rect.width);
-  const y0 = Math.min(Math.max(Math.min(vy0, vy1), 0), rect.height);
-  const x1 = Math.min(Math.max(Math.max(vx0, vx1), 0), rect.width);
-  const y1 = Math.min(Math.max(Math.max(vy0, vy1), 0), rect.height);
-  if (x1 - x0 < 1 || y1 - y0 < 1) {
-    selectionEl.style.display = "none";
-    return;
-  }
-  hideSelectionSvg();
-  selectionEl.style.display = "block";
-  selectionEl.style.left = `${canvas.offsetLeft + x0}px`;
-  selectionEl.style.top = `${canvas.offsetTop + y0}px`;
-  selectionEl.style.width = `${Math.max(1, x1 - x0)}px`;
-  selectionEl.style.height = `${Math.max(1, y1 - y0)}px`;
-  const validation = validatePatchRect(state.selectionRect, state.world);
-  selectionEl.classList.toggle("invalid", !validation.ok);
-}
-
-function formatRectSize(rect) {
-  if (!rect) return "-";
-  const w = Math.max(0, rect.x1 - rect.x0);
-  const h = Math.max(0, rect.y1 - rect.y0);
-  const area = Math.max(0, rect.areaCells || (w * h));
-  return `${w} x ${h} cells / ${area.toLocaleString()} cells`;
-}
-
-function normalizePatchVariant(value) {
-  const parsed = Number.parseInt(value, 10);
-  return Number.isFinite(parsed) ? Math.max(0, parsed) >>> 0 : 0;
-}
-
-function setPatchVariant(value, { update = true } = {}) {
-  state.patchVariant = normalizePatchVariant(value);
-  if (patchVariantInput && patchVariantInput.value !== String(state.patchVariant)) {
-    patchVariantInput.value = String(state.patchVariant);
-  }
-  if (update) updatePatchControls();
-  return state.patchVariant;
-}
-
-function readPatchVariant() {
-  return setPatchVariant(patchVariantInput?.value ?? state.patchVariant, { update: false });
-}
-
-function resetPatchVariant({ update = true } = {}) {
-  return setPatchVariant(0, { update });
-}
-
-function updatePatchControls() {
-  if (!patchStatusEl && !generatePatchButton) return;
-  const validation = validatePatchRect(state.selectionRect, state.world);
-  const variant = readPatchVariant();
-  if (generatePatchButton) generatePatchButton.disabled = !validation.ok;
-  if (alternativePatchButton) alternativePatchButton.disabled = !validation.ok;
-  if (!patchStatusEl) return;
-  if (!state.selectionRect) {
-    patchStatusEl.textContent = `Right-drag a freeform area. Minimum: ${PATCH_MIN_WIDTH} x ${PATCH_MIN_HEIGHT} cells and ${PATCH_MIN_AREA.toLocaleString()} cells. Current variant: ${variant}.`;
-    patchStatusEl.classList.toggle("invalid", false);
-    return;
-  }
-  if (!validation.ok) {
-    patchStatusEl.textContent = `${validation.reason} Current: ${formatRectSize(validation.rect || state.selectionRect)}.`;
-    patchStatusEl.classList.toggle("invalid", true);
-    return;
-  }
-  const rects = buildPatchRects(validation.rect, state.world);
-  const patchText = state.lastPatchResult
-    ? ` Last patch: ${state.lastPatchResult.label}, variant ${state.lastPatchResult.variant ?? "-"}, mode ${state.lastPatchResult.patchGenerationMode || "legacy-full-pipeline"}, terrain ${state.lastPatchResult.updatedCells.toLocaleString()} cells, coast ${state.lastPatchResult.coastCellsChanged || 0}, natural ${state.lastPatchResult.naturalRegionsUpdated || 0}${state.lastPatchResult.humanGeography?.ok ? `, connectors ${(state.lastPatchResult.humanGeography.roadConnectorsCreated || 0) + (state.lastPatchResult.humanGeography.railwayConnectorsCreated || 0)}, admin ${state.lastPatchResult.humanGeography.adminCellsReassigned || 0}, invalid ports ${state.lastPatchResult.humanGeography.invalidPortsRemoved || 0}` : ""}.`
-    : "";
-  patchStatusEl.textContent = `Variant: ${variant}. Core: ${formatRectSize(rects.coreRect)}. Write: ${formatRectSize(rects.writeRect)}. Context: ${formatRectSize(rects.contextRect)}. Repair: ${formatRectSize(rects.repairRect)}.${patchText}`;
-  patchStatusEl.classList.toggle("invalid", false);
-}
-
-function clearDragMode() {
-  dragState.mode = null;
-  dragState.pointerId = null;
-  dragState.pendingCamera = null;
-  if (dragState.panRaf != null) {
-    cancelAnimationFrame(dragState.panRaf);
-    dragState.panRaf = null;
-  }
-  canvasShell?.classList.remove("panning", "selecting");
-}
-
-function schedulePanRedraw(camera) {
-  dragState.pendingCamera = camera;
-  if (dragState.panRaf != null) return;
-  dragState.panRaf = requestAnimationFrame(() => {
-    dragState.panRaf = null;
-    if (!dragState.pendingCamera) return;
-    const next = dragState.pendingCamera;
-    dragState.pendingCamera = null;
-    if (next.x === state.camera.x && next.y === state.camera.y) return;
-    state.camera = next;
-    redraw({ fastTerrain: true });
-  });
-}
-
-function hideSelectionOverlay() {
-  dragState.selectStart = null;
-  dragState.selectEnd = null;
-  dragState.selectPath = null;
-  state.selectionRect = null;
-  resetPatchVariant({ update: false });
-  hideSelectionSvg();
-  if (selectionEl) selectionEl.style.display = "none";
-  updatePatchControls();
-}
-
-function selectionPixelsToCells(start, end) {
-  const a = screenPointToWorldCell(start);
-  const b = screenPointToWorldCell(end);
-  if (!a || !b) return null;
-  return {
-    x0: Math.min(a.x, b.x),
-    y0: Math.min(a.y, b.y),
-    x1: Math.max(a.x, b.x) + 1,
-    y1: Math.max(a.y, b.y) + 1,
-  };
-}
-
-function selectionPixelsToShape(start, end, path = null) {
-  if (Array.isArray(path) && path.length >= 3) return selectionPathToShape(path);
-  return selectionPixelsToCells(start, end);
-}
-
-function handleMapPointerDown(event) {
-  if (!state.world || !canvasShell) return;
-  if (event.button !== 0 && event.button !== 2) return;
-  dragState.pointerId = event.pointerId;
-  dragState.startClientX = event.clientX;
-  dragState.startClientY = event.clientY;
-  dragState.startCameraX = state.camera.x;
-  dragState.startCameraY = state.camera.y;
-  tooltipEl?.classList.remove("visible");
-
-  if (event.button === 0) {
-    dragState.mode = "pan";
-    canvasShell.classList.add("panning");
-  } else {
-    dragState.mode = "select";
-    dragState.selectStart = clampCanvasPoint(event);
-    dragState.selectEnd = dragState.selectStart;
-    dragState.selectPath = [dragState.selectStart];
-    canvasShell.classList.add("selecting");
-    updateSelectionOverlay();
-  }
-
-  canvas.setPointerCapture?.(event.pointerId);
-  event.preventDefault();
-}
-
-function handleMapPointerMove(event) {
-  if (!dragState.mode || dragState.pointerId !== event.pointerId || !canvasShell) return;
-  tooltipEl?.classList.remove("visible");
-
-  if (dragState.mode === "pan") {
-    const cellSize = Math.max(1, displayedCellSize());
-    const dxCells = Math.round((event.clientX - dragState.startClientX) / cellSize);
-    const dyCells = Math.round((event.clientY - dragState.startClientY) / cellSize);
-    const nextCamera = clampCameraForView({
-      x: dragState.startCameraX - dxCells,
-      y: dragState.startCameraY - dyCells,
-    }, viewportSizeForZoom(state.zoom));
-    schedulePanRedraw(nextCamera);
-  } else if (dragState.mode === "select") {
-    dragState.selectEnd = clampCanvasPoint(event);
-    if (!dragState.selectPath || Math.hypot(dragState.selectEnd.x - dragState.selectPath[dragState.selectPath.length - 1].x, dragState.selectEnd.y - dragState.selectPath[dragState.selectPath.length - 1].y) >= 3) {
-      dragState.selectPath = [...(dragState.selectPath || []), dragState.selectEnd];
-    }
-    updateSelectionOverlay();
-  }
-
-  event.preventDefault();
-}
-
-function handleMapPointerUp(event) {
-  if (dragState.pointerId !== event.pointerId) return;
-  const wasPanning = dragState.mode === "pan";
-  if (dragState.mode === "select") {
-    dragState.selectEnd = clampCanvasPoint(event);
-    if (!dragState.selectPath || dragState.selectPath.length < 2) dragState.selectPath = [dragState.selectStart, dragState.selectEnd];
-    else dragState.selectPath = [...dragState.selectPath, dragState.selectEnd];
-    const shape = selectionPixelsToShape(dragState.selectStart, dragState.selectEnd, dragState.selectPath);
-    const width = Math.abs(dragState.selectEnd.x - dragState.selectStart.x);
-    const height = Math.abs(dragState.selectEnd.y - dragState.selectStart.y);
-    if (shape && (dragState.selectPath.length >= 3 || (width >= 4 && height >= 4))) {
-      state.selectionRect = shape;
-      state.lastPatchResult = null;
-      resetPatchVariant({ update: false });
-      updateSelectionOverlayFromWorldRect();
-      updatePatchControls();
-    } else {
-      hideSelectionOverlay();
-    }
-  }
-  canvas.releasePointerCapture?.(event.pointerId);
-  if (wasPanning && dragState.pendingCamera) {
-    state.camera = dragState.pendingCamera;
-    dragState.pendingCamera = null;
-  }
-  clearDragMode();
-  if (wasPanning) redraw({ fastTerrain: false });
-  event.preventDefault();
-}
-
-function parseSeed(seedText) {
-  const numeric = Number.parseInt(seedText, 10);
-  if (Number.isFinite(numeric)) return numeric >>> 0;
-
-  let hash = 2166136261;
-  for (const ch of seedText) hash = Math.imul(hash ^ ch.charCodeAt(0), 16777619);
-  return hash >>> 0;
-}
-
-function insideCount(items) {
-  return items.filter((item) => item.insidePrefecture).length;
-}
-
-function outsideCount(items) {
-  return items.length - insideCount(items);
-}
-
-function countText(items) {
-  return `${insideCount(items)} / outside ${outsideCount(items)}`;
-}
-
-function formatMs(ms) {
-  if (!Number.isFinite(ms)) return "-";
-  return ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${Math.round(ms)}ms`;
-}
-
-function renderTimingRows(timings = []) {
-  if (!progressTimingsEl) return;
-  progressTimingsEl.innerHTML = "";
-  for (const row of timings) {
-    const item = document.createElement("div");
-    item.className = "progress-timing-row";
-    const label = document.createElement("span");
-    label.textContent = row.label;
-    const value = document.createElement("strong");
-    value.textContent = formatMs(row.ms);
-    item.append(label, value);
-    progressTimingsEl.append(item);
-  }
-}
-
-function updateGenerationProgress(event) {
-  if (!progressEl) return;
-  progressEl.classList.remove("hidden");
-  if (event?.status === "start") generationCurrentStage = event.label || "Preparing";
-  if (progressStageEl) {
-    const elapsed = generationStartedAt ? ` / elapsed ${formatMs(performance.now() - generationStartedAt)}` : "";
-    progressStageEl.textContent = event?.status === "done"
-      ? `Completed: ${event.label} / ${formatMs(event.ms)}${elapsed}`
-      : `Running: ${event?.label || generationCurrentStage || "Preparing"}${elapsed}`;
-  }
-  renderTimingRows(event?.timings || []);
-}
-
-function setProgressVisible(visible, message = "Preparing") {
-  if (!progressEl) return;
-  progressEl.classList.toggle("hidden", !visible);
-  if (visible) {
-    generationStartedAt = performance.now();
-    generationCurrentStage = message;
-    if (generationTimer) window.clearInterval(generationTimer);
-    generationTimer = window.setInterval(() => {
-      if (progressStageEl && !progressEl.classList.contains("hidden")) {
-        progressStageEl.textContent = `Running: ${generationCurrentStage || "Preparing"} / elapsed ${formatMs(performance.now() - generationStartedAt)}`;
-      }
-    }, 100);
-  } else if (generationTimer) {
-    window.clearInterval(generationTimer);
-    generationTimer = null;
-  }
-  if (progressStageEl) progressStageEl.textContent = message;
-  if (visible) renderTimingRows([]);
-}
-
-function nextFrame() {
-  return new Promise((resolve) => requestAnimationFrame(() => resolve()));
-}
-
-function getStats(map) {
-  return [
-    ["Map Type", map.terrainTemplate?.terrainTypeLabel || map.terrainDebug?.terrainTypeLabel || "-"],
-    ["Terrain ID", map.terrainTemplate?.terrainType || map.terrainDebug?.terrainType || "-"],
-    ["Generation Total", map.generationTotalMs ? formatMs(map.generationTotalMs) : "-"],
-    ["Geography Basis", map.geographyDebug?.version ? `${map.geographyDebug.version} / ${map.geographyDebug.stage || "-"}` : "-"],
-    ...(map.generationTimings || []).map((row) => [`Time: ${row.label}`, formatMs(row.ms)]),
-    ["Villages", countText(map.villages)],
-    ["Market Towns", countText(map.markets)],
-    ["Castles", countText(map.castles)],
-    ["Premodern Roads", map.premodernRoads.length],
-    ["Minor Roads", map.minorRoads.length],
-    ["Prefecture", map.prefectureName || "-"],
-    ["Neighbor Prefectures", (map.neighborPrefectures || []).map((p) => p.name).join(" / ") || "-"],
-    ["Neighbor Features", map.neighborPrefectureDetails ? `${map.neighborPrefectureDetails.cities?.length || 0} cities / ${map.neighborPrefectureDetails.adminCenters?.length || 0} municipalities / ${map.neighborPrefectureDetails.roads?.length || 0} roads` : "-"],
-    ["Prefectural Capital", map.prefecturalCapital?.name || "-"],
-    ["Regional Capitals", (map.modernCities || []).filter((p) => p.isRegionalCapital).length],
-    ["Modern Cities", countText(map.modernCities)],
-    ["Ports", `${map.ports.filter((p) => p.portClass === "major").length} major / ${map.ports.filter((p) => p.portClass === "regional").length} regional / ${map.ports.filter((p) => p.portClass === "fishing").length} fishing / ${map.ports.filter((p) => p.portClass === "lake").length} lake`],
-    ["Satellite Cities", countText(map.satelliteCities || [])],
-    ["Population", (map.totalPopulation || 0).toLocaleString()],
-    ["Rivers", `${map.mainRivers.length} main / ${(map.tributaryRivers || []).length} tributary / ${(map.smallStreams || []).length} hidden streams`],
-    ["Neighbor Prefecture Borders", (map.regionalPrefectureBorders || []).length],
-    ["Rail Lines", map.railways.length + map.branchRailways.length + (map.ringRailways || []).length + map.externalRailways.length],
-    ["Industrial Zones", countText(map.industrialZones)],
-    ["National Roads", `${map.nationalRoads.length} / pop cover ${Math.round((map.transportDebug?.nationalRoadPopulationCoverage || 0) * 100)}% / uncovered ${(map.transportDebug?.nationalRoadUncoveredPopulation || 0).toLocaleString()}`],
-    ["General Ring Roads", (map.ringRoads || []).length],
-    ["Expressways", map.expressways.length + map.externalExpressways.length],
-    ["External Gateways", map.externalGateways.length],
-    ["Interchanges", countText(map.interchanges)],
-    ["Logistics Parks", countText(map.logisticsParks)],
-    ["New Towns", countText(map.newTowns)],
-    ["Municipalities", map.adminCenters.length],
-    ["Prefecture source", map.regionalDebug?.prefectureSource ?? "-"],
-  ];
-}
-
-function renderStats(map) {
-  statsEl.innerHTML = "";
-  for (const [labelText, valueText] of getStats(map)) {
-    const row = document.createElement("div");
-    row.className = "stat-row";
-
-    const label = document.createElement("span");
-    label.textContent = labelText;
-
-    const value = document.createElement("strong");
-    value.textContent = String(valueText);
-
-    row.append(label, value);
-    statsEl.append(row);
-  }
-}
-
-function buildHoverEntities(map) {
-  return [
-    ...(map.modernCities || []),
-    ...(map.ports || []),
-    ...(map.stations || []),
-    ...(map.interchanges || []),
-    ...(map.industrialZones || []),
-    ...(map.logisticsParks || []),
-    ...(map.newTowns || []),
-    ...(map.castles || []),
-    ...(map.markets || []),
-    ...(map.villages || []),
-    ...(map.adminCenters || []),
-  ];
-}
-
-function nearestEntity(items, x, y, maxDistance = 5) {
-  let best = null;
-  let bestD = maxDistance;
-  for (const item of items || []) {
-    if (!item || !Number.isFinite(item.x) || !Number.isFinite(item.y)) continue;
-    const d = Math.hypot(item.x - x, item.y - y);
-    if (d < bestD) { best = item; bestD = d; }
-  }
-  return best;
-}
-
-function landuseName(value) {
-  return landuseLabel(value);
-}
-
-const ADMIN_ID_KEYS = ["adminId", "municipalityId", "adminNumericId", "id", "numericId"];
-const PREFECTURE_ID_KEYS = ["prefectureRegionId", "prefectureId", "id", "numericId"];
-const MUNICIPALITY_NAME_KEYS = ["municipalityName", "name", "canonicalSettlementName", "municipalityRootName", "generatedMunicipalityName", "label"];
-const PREFECTURE_NAME_KEYS = ["prefectureName", "prefectureRegionName", "regionName", "name", "label"];
-const POPULATION_KEYS = ["municipalityPopulation", "adminPopulation", "population", "estimatedPopulation"];
-
-function numericIdOf(item, keys = ADMIN_ID_KEYS) {
-  for (const key of keys) {
-    const value = item?.[key];
-    if (Number.isFinite(value)) return Math.floor(value);
-  }
-  return null;
-}
-
-function hasNumericId(item, id, keys = ADMIN_ID_KEYS) {
-  if (!item || id == null || id < 0) return false;
-  return keys.some((key) => Number.isFinite(item?.[key]) && Math.floor(item[key]) === Math.floor(id));
-}
-
-function firstUsableText(item, keys) {
-  for (const key of keys) {
-    const value = item?.[key];
-    if (!looksNumericName(value)) return String(value).trim();
-  }
-  return "";
-}
-
-function firstPopulation(item) {
-  for (const key of POPULATION_KEYS) {
-    const value = item?.[key];
-    if (Number.isFinite(value) && value > 0) return Math.round(value);
-  }
-  return null;
-}
-
-function adminCenterForId(map, adminId) {
-  if (!map || adminId == null || adminId < 0) return null;
-  const centers = (map.adminCenters || []).filter(Boolean);
-  const exact = centers.find((center) => hasNumericId(center, adminId));
-  if (exact) return exact;
-  // Some legacy/admin debug arrays were once addressed by array index.  Keep this
-  // only as a guarded fallback so numeric IDs are not mistaken for indexes.
-  const direct = map.adminCenters?.[adminId];
-  return hasNumericId(direct, adminId) ? direct : null;
-}
-
-function looksNumericName(name) {
-  if (!name) return true;
-  const text = String(name).trim();
-  return !text || /^-?\d+(?:\s*[,，]\s*\d+)*$/u.test(text) || /^(Municipality|Prefecture|Admin|Region)\s*-?\d+/i.test(text);
-}
-
-function nearestNamedAdminCenter(map, cellIndex, maxDistance = 36, adminId = null) {
-  if (!map || cellIndex < 0) return null;
-  const x = cellIndex % map.width;
-  const y = Math.floor(cellIndex / map.width);
-  let best = null;
-  let bestD = maxDistance;
-  for (const center of map.adminCenters || []) {
-    if (!center || !Number.isFinite(center.x) || !Number.isFinite(center.y)) continue;
-    if (adminId != null && adminId >= 0 && !hasNumericId(center, adminId)) continue;
-    if (!firstUsableText(center, MUNICIPALITY_NAME_KEYS)) continue;
-    const d = Math.hypot(center.x - x, center.y - y);
-    if (d < bestD) { best = center; bestD = d; }
-  }
-  return best;
-}
-
-function adminName(map, adminId, cellIndex = -1) {
-  const center = adminCenterForId(map, adminId) || nearestNamedAdminCenter(map, cellIndex, 54, adminId);
-  const name = firstUsableText(center, MUNICIPALITY_NAME_KEYS);
-  if (name) return name;
-  return adminId >= 0 ? "Unnamed municipality" : "-";
-}
-
-function adminPopulation(map, adminId, cellIndex = -1) {
-  const center = adminCenterForId(map, adminId) || nearestNamedAdminCenter(map, cellIndex, 54, adminId);
-  const centerPop = firstPopulation(center);
-  if (centerPop !== null) return centerPop;
-  let sum = 0;
-  let found = false;
-  for (const key of ["modernCities", "satelliteCities", "ports", "markets", "villages"]) {
-    for (const p of map?.[key] || []) {
-      if (!hasNumericId(p, adminId)) continue;
-      const pop = firstPopulation(p);
-      if (pop !== null) { sum += pop; found = true; }
-    }
-  }
-  return found ? sum : null;
-}
-
-function prefectureNameForCell(map, i) {
-  const id = map.prefectureRegionId?.[i] ?? -1;
-  const region = (map.prefectureRegions || []).find((p) => hasNumericId(p, id, PREFECTURE_ID_KEYS));
-  const regionName = firstUsableText(region, PREFECTURE_NAME_KEYS);
-  if (regionName) return regionName;
-  const adminId = map.adminId?.[i] ?? -1;
-  const mappedPref = adminId >= 0 ? map.municipalityToPrefectureId?.[adminId] ?? -1 : -1;
-  const center = mappedPref === id ? nearestNamedAdminCenter(map, i, 90, adminId) : null;
-  const fromCenter = firstUsableText(center, ["prefectureName", "prefectureRegionName", "regionName"]);
-  return fromCenter || (id >= 0 ? "Unnamed prefecture" : "-");
-}
-
-function updateTooltip(event) {
-  const map = activeMap();
-  if (!map || !tooltipEl || dragState.mode) return;
-  const rect = canvas.getBoundingClientRect();
-  const cell = mapClientToCell(event);
-  if (!cell) return;
-  const { x, y } = cell;
-  if (x < 0 || y < 0 || x >= map.width || y >= map.height) {
-    tooltipEl.classList.remove("visible");
-    return;
-  }
-  const i = y * map.width + x;
-  const worldCell = viewportCellToWorldCell({ x, y });
-  const entity = nearestEntity(state.hoverEntities, x, y);
-  const elevation = map.elevation?.[i] ?? 0;
-  const density = map.populationDensity?.[i] ?? map.settlementScore?.[i] ?? 0;
-  const hoveredAdminId = map.adminId?.[i] ?? -1;
-  const hoveredAdminPopulation = adminPopulation(map, hoveredAdminId, i);
-  const coordinateText = worldCell ? `World ${worldCell.x}, ${worldCell.y} / View ${x}, ${y}` : `${x}, ${y}`;
-  const entityName = firstUsableText(entity, ["name", "facilityLabel", "municipalityName", "canonicalSettlementName", "kind"]);
-  const entityTitle = entity
-    ? `${entityName || adminName(map, hoveredAdminId, i) || entity.kind || "Feature"} / ${entity.kind || "Feature"}`
-    : coordinateText;
-  const lines = [
-    `<strong>${entityTitle}</strong>`,
-    `Prefecture: ${prefectureNameForCell(map, i)}`,
-    `Admin: ${adminName(map, hoveredAdminId, i)}`,
-    `Admin Pop: ${hoveredAdminPopulation === null ? "-" : hoveredAdminPopulation.toLocaleString()}`,
-    `Land: ${map.sea?.[i] ? "Sea" : landuseName(map.landuse?.[i])}`,
-    `Elevation: ${elevation.toFixed(3)} / Slope: ${(map.slope?.[i] ?? 0).toFixed(3)}`,
-    `River: ${(map.river?.[i] ?? 0).toFixed(2)} / Density: ${density.toFixed(2)}`,
-  ];
-  if (entity?.population) lines.splice(1, 0, `Population: ${entity.population.toLocaleString()}`);
-  tooltipEl.innerHTML = lines.join("<br>");
-  const margin = 8;
-  const offset = 14;
-  const maxLeft = Math.max(margin, rect.width - tooltipEl.offsetWidth - margin);
-  const maxTop = Math.max(margin, rect.height - tooltipEl.offsetHeight - margin);
-  const desiredLeft = event.clientX - rect.left + offset;
-  const desiredTop = event.clientY - rect.top + offset;
-  tooltipEl.style.left = `${Math.min(Math.max(margin, desiredLeft), maxLeft)}px`;
-  tooltipEl.style.top = `${Math.min(Math.max(margin, desiredTop), maxTop)}px`;
-  tooltipEl.classList.add("visible");
-}
-
-function renderModeButtons() {
-  modeGrid.innerHTML = "";
-  for (const [key, label] of modes) {
-    const button = document.createElement("button");
-    button.type = "button";
-    button.textContent = label;
-    button.className = key === state.mode ? "mode-button active" : "mode-button";
-    button.addEventListener("click", () => {
-      state.mode = key;
-      renderModeButtons();
-      redraw();
-    });
-    modeGrid.append(button);
-  }
-}
-
-async function regenerate() {
-  state.seedText = seedInput.value;
-  state.generationType = generationTypeInput?.value || "auto";
-  setProgressVisible(true, "Preparing generation...");
-  await nextFrame();
-  try {
-    state.map = await generateMapAsync(parseSeed(state.seedText), { onProgress: updateGenerationProgress, terrainType: state.generationType });
-    state.world = createWorldMap(state.map);
-    state.camera = createInitialCamera(state.world);
-    state.lastPatchResult = null;
-    resetPatchVariant({ update: false });
-    hideSelectionOverlay();
-    renderStats(state.map);
-    redraw();
-    if (progressStageEl) progressStageEl.textContent = `Done in ${formatMs(state.map.generationTotalMs || 0)}`;
-    renderTimingRows(state.map.generationTimings || []);
-    window.setTimeout(() => setProgressVisible(false), 900);
-  } catch (error) {
-    if (progressStageEl) progressStageEl.textContent = `Generation failed: ${error?.message || error}`;
-    throw error;
-  }
-}
-
-
-function derivePatchSeed(rect, terrainType, variant = 0) {
-  let h = parseSeed(state.seedText) ^ 0x9e3779b9;
-  h = Math.imul(h ^ (rect.x0 | 0), 1664525) >>> 0;
-  h = Math.imul(h ^ (rect.y0 | 0), 1013904223) >>> 0;
-  h = Math.imul(h ^ (rect.x1 | 0), 2246822519) >>> 0;
-  h = Math.imul(h ^ (rect.y1 | 0), 3266489917) >>> 0;
-  h = Math.imul(h ^ normalizePatchVariant(variant), 668265263) >>> 0;
-  for (const ch of String(terrainType || "auto")) h = Math.imul(h ^ ch.charCodeAt(0), 16777619) >>> 0;
-  return h >>> 0;
-}
-
-
-function handleCanvasWheel(event) {
-  if (!state.world || !activeMap()) return;
-  event.preventDefault();
-  tooltipEl?.classList.remove("visible");
-  const beforeSize = viewportSizeForZoom(state.zoom);
-  const beforeCell = mapClientToCell(event, beforeSize);
-  const beforeWorld = beforeCell ? viewportCellToWorldCell(beforeCell) : null;
-  const oldZoom = clampZoom(state.zoom || 1);
-  const delta = event.deltaY < 0 ? 1.10 : 1 / 1.10;
-  const nextZoom = clampZoom(oldZoom * delta);
-  if (Math.abs(nextZoom - oldZoom) < 0.001) return;
-  state.zoom = nextZoom;
-  const nextSize = syncViewportSize();
-  if (beforeWorld) {
-    const afterCell = mapClientToCell(event, nextSize);
-    if (afterCell) {
-      state.camera = clampCameraForView({
-        x: beforeWorld.x - afterCell.x,
-        y: beforeWorld.y - afterCell.y,
-      }, nextSize);
-    }
-  }
-
-  // Wheel events can fire dozens of times per second.  Do one lightweight redraw
-  // per frame, then a full labeled/continuous redraw once zooming settles.
-  if (zoomRedrawRaf == null) {
-    zoomRedrawRaf = requestAnimationFrame(() => {
-      zoomRedrawRaf = null;
-      redraw({ fastTerrain: true, allowWorldExpand: false });
-    });
-  }
-  if (zoomSettledTimer != null) clearTimeout(zoomSettledTimer);
-  zoomSettledTimer = window.setTimeout(() => {
-    zoomSettledTimer = null;
-    redraw({ fastTerrain: false, allowWorldExpand: false });
-  }, 140);
-}
-
-async function generateSelectedPatch() {
-  const validation = validatePatchRect(state.selectionRect, state.world);
-  if (!validation.ok) {
-    updatePatchControls();
-    return;
-  }
-  const terrainType = patchTerrainTypeInput?.value || generationTypeInput?.value || "auto";
-  const variant = readPatchVariant();
-  const seed = derivePatchSeed(validation.rect, terrainType, variant);
-  setProgressVisible(true, "Generating selected patch...");
-  await nextFrame();
-  try {
-    const result = generatePatch(state.world, validation.rect, { terrainType, seed, variant });
-    if (!result.ok) {
-      if (progressStageEl) progressStageEl.textContent = `Patch failed: ${result.reason || "invalid selection"}`;
-      updatePatchControls();
-      window.setTimeout(() => setProgressVisible(false), 1200);
-      return;
-    }
-    state.lastPatchResult = result;
-    redraw();
-    renderStats(state.map);
-    updatePatchControls();
-    const human = result.humanGeography;
-    const humanText = human?.ok ? ` / human: ${human.modernCities || 0} cities, ${human.ports || 0} ports, ${human.villages || 0} villages, ${(human.roadConnectorsCreated || 0) + (human.railwayConnectorsCreated || 0)} connectors, admin ${human.adminCellsReassigned || 0}, invalid ports ${human.invalidPortsRemoved || 0}` : "";
-    if (progressStageEl) progressStageEl.textContent = `Patch generated: ${result.label} / variant ${result.variant ?? variant} / mode ${result.patchGenerationMode || "legacy-full-pipeline"} / core ${formatRectSize(result.rects.coreRect)} / write ${formatRectSize(result.rects.writeRect)} / terrain ${result.updatedCells.toLocaleString()} cells / coast ${result.coastCellsChanged || 0} / natural ${result.naturalRegionsUpdated || 0}${humanText}`;
-    renderTimingRows(result.patchTimings || []);
-    window.setTimeout(() => setProgressVisible(false), 900);
-  } catch (error) {
-    if (progressStageEl) progressStageEl.textContent = `Patch failed: ${error?.message || error}`;
-    throw error;
-  }
-}
-
-async function generateAlternativePatch() {
-  const validation = validatePatchRect(state.selectionRect, state.world);
-  if (!validation.ok) {
-    updatePatchControls();
-    return;
-  }
-  setPatchVariant(readPatchVariant() + 1, { update: false });
-  await generateSelectedPatch();
-}
-
-function redraw(options = {}) {
-  if (!state.world) return;
-  const viewSize = syncViewportSize();
-  const expansion = options.allowWorldExpand === false ? null : ensureWorldPaddingForCamera(state.world, state.camera, viewSize.width, viewSize.height);
-  if (expansion?.expanded) {
-    state.camera = { x: (state.camera?.x || 0) + (expansion.dx || 0), y: (state.camera?.y || 0) + (expansion.dy || 0) };
-    if (state.selectionRect) {
-      const dx = expansion.dx || 0;
-      const dy = expansion.dy || 0;
-      state.selectionRect = {
-        ...state.selectionRect,
-        x0: state.selectionRect.x0 + dx,
-        y0: state.selectionRect.y0 + dy,
-        x1: state.selectionRect.x1 + dx,
-        y1: state.selectionRect.y1 + dy,
-        polygon: Array.isArray(state.selectionRect.polygon) ? state.selectionRect.polygon.map((p) => ({ x: p.x + dx, y: p.y + dy })) : state.selectionRect.polygon,
-      };
-    }
-  }
-  state.camera = clampCameraForView(state.camera, viewSize);
-  state.viewportMap = getViewportMap(state.world, state.camera, viewSize.width, viewSize.height, { light: !!options.fastTerrain });
-  state.hoverEntities = options.fastTerrain ? [] : buildHoverEntities(state.viewportMap);
-  drawMap(canvas, state.viewportMap, {
-    mode: state.mode,
-    showFeatures: state.showFeatures && !options.fastTerrain,
-    showLabels: state.showLabels && !options.fastTerrain,
-    continuousTerrain: !options.fastTerrain,
-    fastTerrain: !!options.fastTerrain,
-    zoom: state.zoom || 1,
-  });
-  applyCanvasZoom();
-  if (state.selectionRect && dragState.mode !== "select") updateSelectionOverlayFromWorldRect();
-}
-
-function init() {
-  renderModeButtons();
-
-  seedInput.addEventListener("change", regenerate);
-  seedInput.addEventListener("keydown", (event) => {
-    if (event.key === "Enter") regenerate();
-  });
-
-  generationTypeInput?.addEventListener("change", regenerate);
-  patchTerrainTypeInput?.addEventListener("change", () => {
-    state.lastPatchResult = null;
-    resetPatchVariant({ update: false });
-    updatePatchControls();
-  });
-  patchVariantInput?.addEventListener("change", () => setPatchVariant(patchVariantInput.value));
-  patchVariantInput?.addEventListener("keydown", (event) => {
-    if (event.key === "Enter") {
-      setPatchVariant(patchVariantInput.value);
-      generateSelectedPatch();
-    }
-  });
-  generatePatchButton?.addEventListener("click", generateSelectedPatch);
-  alternativePatchButton?.addEventListener("click", generateAlternativePatch);
-
-  randomSeedButton.addEventListener("click", () => {
-    seedInput.value = String(Math.floor(Math.random() * 9999999));
-    regenerate();
-  });
-
-  showFeaturesInput.addEventListener("change", () => {
-    state.showFeatures = showFeaturesInput.checked;
-    redraw();
-  });
-
-  showLabelsInput.addEventListener("change", () => {
-    state.showLabels = showLabelsInput.checked;
-    redraw();
-  });
-
-  canvasShell?.setAttribute("tabindex", "0");
-  canvas.addEventListener("contextmenu", (event) => event.preventDefault());
-  canvas.addEventListener("wheel", handleCanvasWheel, { passive: false });
-  canvas.addEventListener("pointerdown", handleMapPointerDown);
-  canvas.addEventListener("pointermove", handleMapPointerMove);
-  canvas.addEventListener("pointerup", handleMapPointerUp);
-  canvas.addEventListener("pointercancel", handleMapPointerUp);
-  canvas.addEventListener("mousemove", updateTooltip);
-  canvas.addEventListener("mouseleave", () => {
-    tooltipEl?.classList.remove("visible");
-  });
-
-  updatePatchControls();
-  regenerate();
-}
-
-init();
diff --git a/archive/README.md b/archive/README.md
new file mode 100644
index 0000000..abf3947
--- /dev/null
+++ b/archive/README.md
@@ -0,0 +1,8 @@
+# Archive
+
+This folder contains files removed from the active map project during cleanup.
+
+- `generated-history/` contains old validation scripts, reports, probes, and notes.
+- `legacy-project/` contains saved runtime state and unrelated files from the former colony app.
+
+These files are retained only so the cleanup is reversible. Nothing in the active application references this folder.
diff --git a/archive/generated-history/FINAL_ADDITIONAL_GENERATION_FIX_NOTES.md b/archive/generated-history/FINAL_ADDITIONAL_GENERATION_FIX_NOTES.md
new file mode 100644
index 0000000..4d1059d
--- /dev/null
+++ b/archive/generated-history/FINAL_ADDITIONAL_GENERATION_FIX_NOTES.md
@@ -0,0 +1,38 @@
+# Final additional-generation stability fix
+
+## Remaining failure reproduced
+After the earlier large-selection work, a position-dependent rollback still existed. A large overlapping expansion could fail with `patch-large-final-seam-failed (road-portal-broken)` even though the road in question never crossed from established geography into newly generated geography.
+
+The concrete false portal was an old `minorRoads` segment wholly inside the already-generated map. It crossed the synthetic write/blend band, so the diagnostic system treated it as a mandatory expansion seam portal. When that unrelated old road could not be rerouted through the patch gateway, the complete multi-tile operation was rolled back and the UI showed no additional-generation preview.
+
+## Fix
+Expansion transport portals are now contractual only when the pre-patch road/rail transition actually crosses **generated ↔ ungenerated** geography. A route whose two sides are both already generated (or both previously ungenerated) is not a user-visible expansion seam and is excluded from the hard portal contract.
+
+The hard gate itself remains enabled. Genuine generated/ungenerated transport crossings are still audited; the change removes only false portals created by the implementation write band.
+
+The previous large-selection stability changes are retained: bounded tiling, deferred internal-tile transport seam checks, final whole-selection repair/audit, single final administrative/terrain coherence passes, lightweight internal snapshots, and reduced duplicate per-tile work.
+
+## Final verification
+- 300×339 direct expansion: PASS, 4 tiles, seam clean.
+- 500×350 direct expansion: PASS, 4 tiles, seam clean.
+- 600×400 Worker expansion, deliberately bottom-right/off-center: PASS, 9 tiles, seam clean.
+  - selected cells: 240,000
+  - previously ungenerated selected cells: 192,786
+  - missing after generation: **0**
+- Exact position that reproduced the false road portal: PASS.
+  - selected cells: 125,268
+  - previously ungenerated selected cells: 106,629
+  - missing after generation: **0**
+  - broken road portals: **0**
+- Previously reported geography regressions: PASS.
+  - river points on sea: 0
+  - duplicate prefectural capitals: 0
+  - tiny newly-generated prefectures: 0
+  - administrative frontier breaks: 0
+  - max established-frontier elevation jump: 0.0268
+- STEP15: PASS; expansion seam clean, no escaped footprint, unresolved road/rail portals 0.
+- STEP17: PASS; alternatives still differ, explicit render revision and one-worker-per-patch behavior retained.
+- Seam stress: 2 seeds × 4 directions = 8 cases, all seam clean; maximum observed frontier elevation jump 0.0364 vs hard limit 0.075.
+
+## Island handling
+Small disconnected components are not deleted solely because they are small. Sea-separated components without a valid adjacent land prefecture can represent legitimate islands and remain preserved.
diff --git a/archive/generated-history/FINAL_ADDITIONAL_GENERATION_VALIDATION.json b/archive/generated-history/FINAL_ADDITIONAL_GENERATION_VALIDATION.json
new file mode 100644
index 0000000..e800a39
--- /dev/null
+++ b/archive/generated-history/FINAL_ADDITIONAL_GENERATION_VALIDATION.json
@@ -0,0 +1,198 @@
+{
+  "ok": true,
+  "verifiedAt": "2026-08-07",
+  "largeSelection": {
+    "thresholdCase300x339": {
+      "mode": "direct",
+      "size": "300x339",
+      "ms": 21695,
+      "ok": true,
+      "code": null,
+      "tileCount": 4,
+      "seam": "clean",
+      "hardPass": true
+    },
+    "midCase500x350": {
+      "mode": "direct",
+      "size": "500x350",
+      "ms": 23441,
+      "ok": true,
+      "code": null,
+      "tileCount": 4,
+      "seam": "clean",
+      "hardPass": true
+    },
+    "workerCoverage600x400BottomRight": {
+      "ok": true,
+      "size": "600x400",
+      "selectedCells": 240000,
+      "previouslyUngeneratedSelectedCells": 192786,
+      "missingPreviouslyUngeneratedCells": 0,
+      "tileCount": 9,
+      "seam": "clean",
+      "hardPass": true,
+      "ms": 42324
+    },
+    "overlapPortalRegression": {
+      "ok": true,
+      "rect": {
+        "x0": 345,
+        "y0": 257,
+        "x1": 774,
+        "y1": 549
+      },
+      "selectedCells": 125268,
+      "previouslyUngeneratedSelectedCells": 106629,
+      "missingPreviouslyUngeneratedCells": 0,
+      "tileCount": 4,
+      "roadPortalsBefore": 0,
+      "roadPortalsBroken": 0,
+      "seam": "clean",
+      "hardPass": true,
+      "ms": 19567
+    }
+  },
+  "reportedGeographyRegression": {
+    "ok": true,
+    "riverSeaPoints": 0,
+    "duplicateCapitalPrefs": [],
+    "tinyGenerated": [],
+    "maxEstablishedFrontierElevationJump": 0.0268,
+    "adminBreaksOnEstablishedFrontier": 0,
+    "prefectureBreaksOnEstablishedFrontier": 0,
+    "seamStatus": "clean"
+  },
+  "step15": {
+    "ok": true,
+    "expansion": {
+      "seconds": 14.65,
+      "seamStatus": "clean",
+      "footprintEscapedCells": 0,
+      "roadPortalsUnresolved": 0,
+      "railPortalsUnresolved": 0
+    },
+    "rollback": {
+      "code": "patch-quality-gate-failed",
+      "restored": true,
+      "sourceIdentityPreserved": true
+    }
+  },
+  "step17": {
+    "ok": true,
+    "alternativesDiffer": true,
+    "explicitRenderRevision": true,
+    "singlePatchWorkerLifetime": true
+  },
+  "seamStress": {
+    "cases": 8,
+    "maxObserved": 0.0364,
+    "hardLimit": 0.075,
+    "allClean": true,
+    "results": [
+      {
+        "baseSeed": 24681357,
+        "direction": "right",
+        "patchSeed": 305070147,
+        "pairs": 102,
+        "maxJump": 0.0253,
+        "meanJump": 0.0088,
+        "diagnosticMax": 0.0364,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 262,
+        "gradientAdjusted": 2063
+      },
+      {
+        "baseSeed": 24681357,
+        "direction": "left",
+        "patchSeed": 305070192,
+        "pairs": 84,
+        "maxJump": 0.0364,
+        "meanJump": 0.0237,
+        "diagnosticMax": 0.0364,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 144,
+        "gradientAdjusted": 1950
+      },
+      {
+        "baseSeed": 24681357,
+        "direction": "down",
+        "patchSeed": 305070177,
+        "pairs": 145,
+        "maxJump": 0.0364,
+        "meanJump": 0.0197,
+        "diagnosticMax": 0.0364,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 250,
+        "gradientAdjusted": 2689
+      },
+      {
+        "baseSeed": 24681357,
+        "direction": "up",
+        "patchSeed": 305070102,
+        "pairs": 145,
+        "maxJump": 0.0364,
+        "meanJump": 0.0258,
+        "diagnosticMax": 0.0364,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 236,
+        "gradientAdjusted": 2488
+      },
+      {
+        "baseSeed": 13579246,
+        "direction": "right",
+        "patchSeed": 328771616,
+        "pairs": 55,
+        "maxJump": 0.0221,
+        "meanJump": 0.0057,
+        "diagnosticMax": 0.0364,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 224,
+        "gradientAdjusted": 1913
+      },
+      {
+        "baseSeed": 13579246,
+        "direction": "left",
+        "patchSeed": 328771603,
+        "pairs": 102,
+        "maxJump": 0.0134,
+        "meanJump": 0.0054,
+        "diagnosticMax": 0.0364,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 240,
+        "gradientAdjusted": 2064
+      },
+      {
+        "baseSeed": 13579246,
+        "direction": "down",
+        "patchSeed": 328771586,
+        "pairs": 141,
+        "maxJump": 0.0286,
+        "meanJump": 0.0077,
+        "diagnosticMax": 0.0364,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 214,
+        "gradientAdjusted": 2491
+      },
+      {
+        "baseSeed": 13579246,
+        "direction": "up",
+        "patchSeed": 328771701,
+        "pairs": 83,
+        "maxJump": 0.0364,
+        "meanJump": 0.0105,
+        "diagnosticMax": 0.0259,
+        "seamStatus": "clean",
+        "seamReasons": [],
+        "adjusted": 141,
+        "gradientAdjusted": 2549
+      }
+    ]
+  }
+}
diff --git a/archive/generated-history/FIX_3_7_REPORTED_REGRESSION_RESULT.json b/archive/generated-history/FIX_3_7_REPORTED_REGRESSION_RESULT.json
new file mode 100644
index 0000000..0f5ffb9
--- /dev/null
+++ b/archive/generated-history/FIX_3_7_REPORTED_REGRESSION_RESULT.json
@@ -0,0 +1,30 @@
+{
+  "ok": true,
+  "riverSeaPoints": 0,
+  "duplicateCapitalPrefs": [],
+  "missingCapitalPrefs": [],
+  "generatedSizes": [
+    [
+      0,
+      19776
+    ],
+    [
+      3,
+      3083
+    ],
+    [
+      4,
+      6129
+    ]
+  ],
+  "tinyGenerated": [],
+  "landLandPairs": 102,
+  "maxEstablishedFrontierElevationJump": 0.0268,
+  "adminBreaksOnEstablishedFrontier": 0,
+  "prefectureBreaksOnEstablishedFrontier": 0,
+  "frontierAdminCellsAligned": 568,
+  "establishedFrontierAdminCellsRestored": 601,
+  "frontierHarmonizedValues": 94004,
+  "seamStatus": "clean",
+  "seamGateReasons": []
+}
diff --git a/archive/generated-history/FIX_3_ADMIN_RIVER_RESULT.json b/archive/generated-history/FIX_3_ADMIN_RIVER_RESULT.json
new file mode 100644
index 0000000..50bc12d
--- /dev/null
+++ b/archive/generated-history/FIX_3_ADMIN_RIVER_RESULT.json
@@ -0,0 +1,15 @@
+{
+  "ok": true,
+  "capitalAudit": {
+    "active": [
+      0,
+      2,
+      3,
+      1
+    ],
+    "zero": [],
+    "duplicate": []
+  },
+  "outsideRiverSeaPointsPreserved": 5,
+  "seam": "clean"
+}
diff --git a/archive/generated-history/FIX_3_CAPITAL_SEQUENCE_RESULT.json b/archive/generated-history/FIX_3_CAPITAL_SEQUENCE_RESULT.json
new file mode 100644
index 0000000..23cf522
--- /dev/null
+++ b/archive/generated-history/FIX_3_CAPITAL_SEQUENCE_RESULT.json
@@ -0,0 +1,13 @@
+{
+  "ok": true,
+  "steps": [
+    {
+      "active": 5,
+      "seam": "clean"
+    },
+    {
+      "active": 6,
+      "seam": "clean"
+    }
+  ]
+}
diff --git a/archive/generated-history/FIX_3_TO_7_FINAL_VALIDATION.json b/archive/generated-history/FIX_3_TO_7_FINAL_VALIDATION.json
new file mode 100644
index 0000000..fdef574
--- /dev/null
+++ b/archive/generated-history/FIX_3_TO_7_FINAL_VALIDATION.json
@@ -0,0 +1,96 @@
+{
+  "ok": true,
+  "scope": "fixes 3-7 only; previously identified issues 1-2 intentionally unchanged",
+  "adminRiver": {
+    "ok": true,
+    "capitalAudit": {
+      "active": [
+        0,
+        2,
+        3,
+        1
+      ],
+      "zero": [],
+      "duplicate": []
+    },
+    "outsideRiverSeaPointsPreserved": 5,
+    "seam": "clean"
+  },
+  "capitalSequence": {
+    "ok": true,
+    "steps": [
+      {
+        "active": 5,
+        "seam": "clean"
+      },
+      {
+        "active": 6,
+        "seam": "clean"
+      }
+    ]
+  },
+  "freeformTiling": {
+    "ok": true,
+    "tileCount": 4,
+    "ms": 27805,
+    "seam": "clean"
+  },
+  "uiState": {
+    "ok": true,
+    "cancelButton": true,
+    "watchdogSeconds": 60,
+    "escapeCancelsBusy": true,
+    "clearDiscardsPendingPreview": true
+  },
+  "reportedRegression": {
+    "ok": true,
+    "riverSeaPoints": 0,
+    "duplicateCapitalPrefs": [],
+    "missingCapitalPrefs": [],
+    "generatedSizes": [
+      [
+        0,
+        19776
+      ],
+      [
+        3,
+        3083
+      ],
+      [
+        4,
+        6129
+      ]
+    ],
+    "tinyGenerated": [],
+    "landLandPairs": 102,
+    "maxEstablishedFrontierElevationJump": 0.0268,
+    "adminBreaksOnEstablishedFrontier": 0,
+    "prefectureBreaksOnEstablishedFrontier": 0,
+    "frontierAdminCellsAligned": 568,
+    "establishedFrontierAdminCellsRestored": 601,
+    "frontierHarmonizedValues": 94004,
+    "seamStatus": "clean",
+    "seamGateReasons": []
+  },
+  "step15": {
+    "ok": true,
+    "expansion": {
+      "seconds": 14.99,
+      "seamStatus": "clean",
+      "footprintEscapedCells": 0,
+      "roadPortalsUnresolved": 0,
+      "railPortalsUnresolved": 0
+    },
+    "rollback": {
+      "code": "patch-quality-gate-failed",
+      "restored": true,
+      "sourceIdentityPreserved": true
+    }
+  },
+  "step17": {
+    "ok": true,
+    "alternativesDiffer": true,
+    "explicitRenderRevision": true,
+    "singlePatchWorkerLifetime": true
+  }
+}
diff --git a/archive/generated-history/FIX_3_TO_7_NOTES.md b/archive/generated-history/FIX_3_TO_7_NOTES.md
new file mode 100644
index 0000000..d85c283
--- /dev/null
+++ b/archive/generated-history/FIX_3_TO_7_NOTES.md
@@ -0,0 +1,47 @@
+# Fixes 3-7: additional-generation integrity and UI controls
+
+This revision intentionally addresses items 3-7 from the post-audit list. Items 1-2 (selection-size/mode discontinuity and derived-field seam continuity) are intentionally unchanged.
+
+## 3. Prefectural capitals and prefecture metadata
+
+- Every active prefecture raster ID is now required to have exactly one capital-like `modernCities` record.
+- If a prefecture has no capital, the patch finalizer promotes, in order: an existing city, a market, a municipal center, then a generated fallback point.
+- Duplicate capitals are still demoted.
+- `prefectureRegions` metadata is rebuilt after capital normalization and now refreshes `worldX/worldY`, `capitalX/capitalY`, `capitalWorldX/capitalWorldY`, and `insidePrefecture` instead of carrying stale values across world expansion.
+
+Validation: two sequential expansion patches increased active prefectures from 5 to 6 while maintaining exactly one capital per prefecture and valid capital metadata coordinates.
+
+## 4. River sanitation locality
+
+- River-vs-sea cleanup is now restricted to the patch `writeRect`.
+- Existing river-mouth/ocean path points outside the patch are preserved byte-for-coordinate instead of being globally rewritten by an unrelated patch.
+- River raster cells and path points over final sea are still removed inside the patch write region.
+
+Validation: five pre-existing sea-mouth points outside the tested expansion remained unchanged; sea river points inside the generated write region were zero.
+
+## 5. Freeform selection tiling
+
+- Polygon/lasso expansion no longer uses the full bounding-box row × column Cartesian grid.
+- The occupied polygon is recursively split along its overflowing axis, and only polygon-intersecting child regions are generated.
+- Rectangular selections retain the existing regular tiling path.
+
+Validation: a thin diagonal lasso whose old bounding-box grid implied up to 9 candidates now uses 4 tiles and completes with `seam=clean`.
+
+## 6. Cancel and watchdog
+
+- Added a `Cancel Generation` button.
+- Escape cancels an active patch generation.
+- Cancellation invalidates the request before terminating its worker so a late result cannot become `pendingPatch`.
+- Added a 60-second *inactivity* watchdog. It resets on every worker progress event, so long generations are allowed as long as they continue reporting progress.
+
+## 7. Clear Selection / pending preview state
+
+- Clear Selection now discards any un-applied pending preview as well as the selection overlay.
+- Escape outside generation does the same.
+- `hideSelectionOverlay()` defaults to discarding a pending preview unless explicitly committing or opting to keep it, preventing a hidden `pendingPatch` from surviving after the dotted selection disappears.
+
+## Regression status
+
+- STEP15: PASS; expansion seam clean, no footprint escape, no unresolved road/rail portals, rollback preserved.
+- STEP17: result `ok:true`; alternatives differ, render revision and single-patch-worker behavior preserved. The Node harness still remains alive after printing its result, so the outer timeout is a harness-exit issue rather than a failed assertion.
+- Previously reported geography regression: PASS; no duplicate or missing capitals, no tiny generated prefectures, no patch-region sea river points, frontier admin breaks 0, maximum established-frontier elevation jump 0.0268, seam clean.
diff --git a/archive/generated-history/FIX_5_FREEFORM_TILING_RESULT.json b/archive/generated-history/FIX_5_FREEFORM_TILING_RESULT.json
new file mode 100644
index 0000000..ffee6ba
--- /dev/null
+++ b/archive/generated-history/FIX_5_FREEFORM_TILING_RESULT.json
@@ -0,0 +1,6 @@
+{
+  "ok": true,
+  "tileCount": 4,
+  "ms": 27805,
+  "seam": "clean"
+}
diff --git a/archive/generated-history/FIX_6_7_UI_STATE_RESULT.json b/archive/generated-history/FIX_6_7_UI_STATE_RESULT.json
new file mode 100644
index 0000000..f2f9598
--- /dev/null
+++ b/archive/generated-history/FIX_6_7_UI_STATE_RESULT.json
@@ -0,0 +1,7 @@
+{
+  "ok": true,
+  "cancelButton": true,
+  "watchdogSeconds": 60,
+  "escapeCancelsBusy": true,
+  "clearDiscardsPendingPreview": true
+}
diff --git a/archive/generated-history/FIX_ADDITIONAL_GENERATION_VALIDATION.mjs b/archive/generated-history/FIX_ADDITIONAL_GENERATION_VALIDATION.mjs
new file mode 100644
index 0000000..d5febc8
--- /dev/null
+++ b/archive/generated-history/FIX_ADDITIONAL_GENERATION_VALIDATION.mjs
@@ -0,0 +1,36 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+
+const appSource = readFileSync(new URL('./app.js', import.meta.url), 'utf8');
+const patchSource = readFileSync(new URL('./mapPatch.js', import.meta.url), 'utf8');
+assert.match(appSource, /acceptBestAvailableQuality:\s*true/);
+assert.match(appSource, /!state\.patchBusy\s*&&\s*options\.allowWorldExpand/);
+assert.match(patchSource, /if \(Number\.isFinite\(p\?\.x\)\) return p\.x \+ \(world\?\.originX \|\| 0\)/);
+assert.match(patchSource, /if \(Number\.isFinite\(p\?\.y\)\) return p\.y \+ \(world\?\.originY \|\| 0\)/);
+
+const initial = generateMap(1, { terrainType: 'auto', onProgress() {} });
+const rect = { x0: 30, y0: 30, x1: 110, y1: 110 };
+const strictWorld = createWorldMap(structuredClone(initial));
+const strictResult = generatePatch(strictWorld, rect, {
+  patchMode: 'expansion', terrainType: 'oceanic_archipelago', seed: 456, variant: 0, maxQualityRetries: 0,
+});
+assert.equal(strictResult.ok, false);
+assert.equal(strictResult.code, 'patch-quality-gate-failed');
+
+const previewWorld = createWorldMap(structuredClone(initial));
+const previewResult = generatePatch(previewWorld, rect, {
+  patchMode: 'expansion', terrainType: 'oceanic_archipelago', seed: 456, variant: 0,
+  maxQualityRetries: 0, acceptBestAvailableQuality: true,
+});
+assert.equal(previewResult.ok, true);
+assert.equal(previewResult.qualityAcceptedAsBestAvailable, true);
+assert.equal(previewResult.candidateQuality?.acceptedAsBestAvailable, true);
+
+console.log(JSON.stringify({
+  ok: true,
+  strict: { ok: strictResult.ok, code: strictResult.code },
+  preview: { ok: previewResult.ok, acceptedAsBestAvailable: previewResult.qualityAcceptedAsBestAvailable, hardPass: previewResult.candidateQuality?.hardPass ?? null },
+}, null, 2));
diff --git a/archive/generated-history/FIX_LARGE_ADDITIONAL_GENERATION_NOTES.md b/archive/generated-history/FIX_LARGE_ADDITIONAL_GENERATION_NOTES.md
new file mode 100644
index 0000000..66f019d
--- /dev/null
+++ b/archive/generated-history/FIX_LARGE_ADDITIONAL_GENERATION_NOTES.md
@@ -0,0 +1,28 @@
+# Large additional-generation fix
+
+## Symptoms
+- A moderately larger patch selection could appear to stop during generation.
+- A larger selection could return no visible preview or leave part of the selected area untouched.
+
+## Root causes
+1. `app.js` requested `qualityTerrainAttempts: 1`, but `generatePatchAttempt()` did not forward that option into the expansion candidate selector. An interactive click could therefore run extra terrain searches and a second complete production generation. On larger selections this could keep the patch worker busy long enough to look interrupted or be terminated under memory/CPU pressure.
+2. Expansion candidates are production-sized (`258 x 183`) but patch selections had no corresponding upper bound. A selection larger than the candidate window caused source indices outside that fixed candidate to be skipped, so portions of a large selection could remain effectively ungenerated.
+3. The first large-selection tiling prototype over-overlapped slightly oversized ranges, multiplying work. Tiling now evenly distributes the range with ~28-cell overlap.
+4. Internal tile seams initially treated roads/rails created by an earlier tile as pre-existing portal contracts. A later tile could then hard-fail on a road that did not exist before the user's operation. Only transport present before the entire large patch is now protected by the hard portal contract.
+
+## Changes
+- Forward `qualityTerrainAttempts` to the expansion candidate selector. Interactive generation now actually performs one requested full candidate per click.
+- Keep selections up to `258 x 183` on the existing single-candidate fast path.
+- Automatically split larger Expansion selections into overlapping production-sized tiles, including freeform/lasso selections via polygon clipping.
+- Process tiles outward from already-generated geography and merge all tile results into one preview world.
+- Soft per-tile quality floors may use best-available results; hard seam failures still reject the operation.
+- Preserve only the pre-operation road/rail set as a hard seam portal baseline across internal tiles.
+- Worker-owned previews avoid an unnecessary second large field snapshot; synchronous/API calls retain atomic rollback snapshots.
+
+## Validation
+- Direct near-limit patch `250 x 180`: PASS, one full candidate, not tiled.
+- Large patch `280 x 200`: PASS, 4 tiles, 56,000/56,000 selected cells covered by generated records, seam clean.
+- Worker large patch `280 x 200`: PASS, outer worker result and inner patch result both successful, 4 tiles, seam clean.
+- STEP17 validation: PASS for Alternative variants 0 and 1; variants remain distinct.
+- STEP15 validation: PASS; Expansion seam clean, escaped footprint cells 0, unresolved road/rail portals 0.
+- Previous reported-geography regression: PASS; river-on-sea 0, duplicate capitals 0, tiny generated prefectures 0, admin/prefecture frontier breaks 0, established-frontier max elevation jump 0.0268.
diff --git a/archive/generated-history/FIX_LARGE_SELECTION_STABILITY_NOTES.md b/archive/generated-history/FIX_LARGE_SELECTION_STABILITY_NOTES.md
new file mode 100644
index 0000000..4fd59e7
--- /dev/null
+++ b/archive/generated-history/FIX_LARGE_SELECTION_STABILITY_NOTES.md
@@ -0,0 +1,27 @@
+# Large additional-generation stability fix
+
+## Reproduced failure
+The previous build could roll back or appear to stop for larger selections. A concrete failure was reproduced at 300x339 and larger selections, with internal-tile transport seam failures and later with cumulative work/memory growth as tile count increased.
+
+## Root causes fixed
+1. **Internal tile transport seam contracts were treated as user-visible outer seams.** A transient road/rail portal inside the tile grid could roll back the entire selection. Internal tile transport seam checks are now deferred; only the real user-selection outer seam is repaired and hard-gated after all tiles are merged.
+2. **Tile-count thresholds jumped unnecessarily.** The tiler now chooses the minimum grid that fits the fixed candidate window with a bounded overlap instead of adding a row/column too early.
+3. **Full structural administration repair ran once per internal tile.** This repeatedly rescanned an ever-growing world. Internal tiles now do local coverage/ID bookkeeping only; topology cleanup, tiny-prefecture handling, frontier continuity and seam-shape repair run once over the complete selection after tile merge.
+4. **Internal rollback/debug snapshots retained large world metadata repeatedly.** Internal tiles now use a lightweight local transaction while the outer tiled operation owns the atomic rollback snapshot. Generated tile history is stored as compact geometry/identity records.
+5. **Patch-mode transport generation did redundant expensive guarantees for every internal tile.** Internal large-selection tiles use bounded road-flow/backbone work, while the final merged world performs the authoritative outer-network repair.
+6. **Municipality connectivity work was needlessly repeated by municipality ID.** The strict connectivity pass was replaced with a whole-map component traversal that preserves genuine isolated islands while avoiding ID-count-proportional rescans.
+7. **Terrain and administrative coherence are finalized once for the full selection.** This avoids repeatedly smoothing/reclassifying overlapping internal seams and keeps the final result governed by the actual user boundary.
+
+## Verification performed on this build
+- 300x339 direct: PASS, 4 tiles, seam clean.
+- 500x350 direct: PASS, 4 tiles, seam clean.
+- 600x400 direct: PASS, 9 tiles, seam clean, about 42.8 s in this environment.
+- 600x400 Worker path: PASS, outer/inner result true, 9 tiles, seam clean, about 41.1 s.
+- 280x200 direct and Worker regressions: PASS, selected-cell coverage 100% in the synchronous check.
+- STEP15 validation: PASS; expansion seam clean, no escaped footprint, no unresolved road/rail portals.
+- STEP17 validation: PASS; alternatives still differ and render-revision/Worker-lifetime behavior is retained.
+- Previously reported geography regressions: PASS; no sea-river points, duplicate prefectural capitals, tiny newly generated prefectures, or administrative frontier breaks in the regression case.
+- Seam stress directions were run in isolated processes to avoid Node test-process accumulation; observed maximum frontier elevation jump stayed <= 0.0364 versus the 0.075 hard limit.
+
+## Island handling
+Small disconnected components belonging to a larger prefecture are not automatically deleted. If they are separated by sea and lack an adjacent land prefecture to merge into, they can represent legitimate islands and are preserved.
diff --git a/archive/generated-history/FIX_REPORTED_PATCH_BUGS_NOTES.md b/archive/generated-history/FIX_REPORTED_PATCH_BUGS_NOTES.md
new file mode 100644
index 0000000..977c6ca
--- /dev/null
+++ b/archive/generated-history/FIX_REPORTED_PATCH_BUGS_NOTES.md
@@ -0,0 +1,42 @@
+# Additional-generation geography integrity fixes
+
+## Fixed issues
+
+1. **Multiple prefectural capitals in one prefecture**
+   - Re-normalizes capital flags against the final prefecture raster after patch merge.
+   - Keeps at most one capital-like city per prefecture, preferring established capitals.
+
+2. **Selection dotted outline could not be cleared**
+   - Added a `Clear Selection` button.
+   - `Escape` also clears the active patch selection when generation is idle.
+
+3. **Rivers appearing over sea**
+   - Final river raster is clipped against the final sea mask.
+   - River path layers are split/removed where path points fall on final sea cells.
+
+4. **Extremely small generated prefectures**
+   - Newly generated prefectures are no longer immune to administrative cleanup.
+   - Tiny newly allocated prefectures are merged into the strongest adjacent prefecture.
+   - Established pre-existing prefectures are never collapsed by this cleanup.
+
+5. **Unnatural geography along generation boundaries**
+   - Added old/new terrain-frontier harmonization while keeping the established side fixed.
+   - Added administrative-frontier continuation so municipality/prefecture borders do not terminate on the generation edge.
+   - Increased expansion overlap and corner taper to avoid rectangular/clipped coastlines and terrain.
+   - Added a final footprint restore so derived-field recomputation cannot leak outside the irregular generated footprint.
+
+## Regression validation
+
+`VALIDATE_REPORTED_PATCH_BUGS.mjs` checks the five reported failure classes directly.
+
+Final observed result:
+
+- river points on sea: `0`
+- prefectures with duplicate capitals: `0`
+- tiny generated prefectures in probe: `0`
+- municipality breaks on established generation frontier: `0`
+- prefecture breaks on established generation frontier: `0`
+- maximum established-frontier elevation jump: `0.0383`
+- seam status: `clean`
+
+Existing `STEP17_VALIDATION.mjs` also passes with `ok: true`, preserving alternative-generation differentiation, explicit render revision, and single-patch Worker lifetime behavior.
diff --git a/archive/generated-history/FIX_SEAM_CONTINUITY_NOTES.md b/archive/generated-history/FIX_SEAM_CONTINUITY_NOTES.md
new file mode 100644
index 0000000..2437b0b
--- /dev/null
+++ b/archive/generated-history/FIX_SEAM_CONTINUITY_NOTES.md
@@ -0,0 +1,77 @@
+# Additional-generation seam continuity fix
+
+Date: 2026-08-07
+
+## Scope
+
+This revision addresses the remaining defect from the previous geography-integrity package: visible terrain discontinuities along the established-map / newly-generated-map frontier.
+
+The previously reported disconnected prefecture component is **not** treated as an error merely because it is small. A sea-separated component can be a legitimate island. Existing component cleanup already preserves sea-isolated administrative components when there is no adjacent land region to merge into, and this revision does not add an island-erasing cleanup pass.
+
+## Changes
+
+1. **Literal old/new frontier constraint**
+   - The final terrain pass now measures the actual generated-coverage transition rather than relying only on the selection rectangle or alpha feather.
+   - Newly generated land cells directly touching established land are constrained to the established elevation neighborhood.
+   - The established side remains unchanged.
+
+2. **Outward gradient propagation**
+   - The solved contact edge is propagated up to 12 cells into the new side using coverage distance.
+   - This avoids simply moving the visible seam one or two cells inward.
+
+3. **Dedicated hard seam metric**
+   - `maxEstablishedFrontierElevationJump` measures only land/land edges where generated coverage changes from established to new.
+   - Hard limit: `0.075`.
+   - A candidate above this limit fails with `established-frontier-elevation-jump`.
+
+4. **Best-available policy split**
+   - Interactive preview may still show a candidate that only misses a soft terrain/human-geography quality floor.
+   - A hard seam failure is never accepted as `best available`; it is rolled back.
+
+5. **Diagnostic warning semantics**
+   - Natural cliffs inside the newly generated region no longer make the whole seam status `warning` merely because one cliff exists.
+   - Cliff density and literal frontier continuity are evaluated separately.
+   - Advanced diagnostics now show `Established frontier elevation` and the hard limit.
+
+## Validation
+
+### Reported-bug regression
+
+`node VALIDATE_REPORTED_PATCH_BUGS.mjs`
+
+- river path points on sea: `0`
+- duplicate prefectural-capital prefectures: `0`
+- tiny generated prefectures: `0`
+- municipal breaks on established frontier: `0`
+- prefecture breaks on established frontier: `0`
+- maximum established-frontier elevation jump: `0.0268`
+- seam status: `clean`
+- seam gate reasons: none
+
+### Direction / seed stress validation
+
+`VALIDATE_SEAM_STRESS.mjs` was run in four separate two-case processes (to avoid cumulative process runtime limits): 2 base seeds × right/left/down/up.
+
+- cases: `8`
+- hard limit: `0.075`
+- maximum independently measured frontier jump: `0.0364`
+- all cases: seam hard gate PASS
+
+See `SEAM_STRESS_RESULT.json` for per-case values.
+
+### Existing regression suites
+
+`STEP15_VALIDATION.mjs`: PASS
+- expansion seam status: `clean`
+- generated-footprint escaped cells: `0`
+- unresolved road portals: `0`
+- unresolved rail portals: `0`
+
+`STEP17_VALIDATION.mjs`: PASS
+- Alternative variants differ
+- explicit render revision retained
+- single-patch Worker lifetime retained
+
+`FIX_ADDITIONAL_GENERATION_VALIDATION.mjs`: PASS
+- strict quality caller still rolls back on quality failure
+- interactive preview still accepts a soft-quality best-available candidate when seam continuity passes
diff --git a/archive/generated-history/FREEFORM_WORLD_NATIVE_RESULT.json b/archive/generated-history/FREEFORM_WORLD_NATIVE_RESULT.json
new file mode 100644
index 0000000..e89d9da
--- /dev/null
+++ b/archive/generated-history/FREEFORM_WORLD_NATIVE_RESULT.json
@@ -0,0 +1,6 @@
+{
+  "ok": true,
+  "tileCount": 5,
+  "ms": 31734,
+  "seam": "clean"
+}
diff --git a/archive/generated-history/LARGE_ADDITIONAL_GENERATION_RESULT.json b/archive/generated-history/LARGE_ADDITIONAL_GENERATION_RESULT.json
new file mode 100644
index 0000000..0b00848
--- /dev/null
+++ b/archive/generated-history/LARGE_ADDITIONAL_GENERATION_RESULT.json
@@ -0,0 +1,51 @@
+{
+  "ok": true,
+  "directNearLimit": {
+    "selection": "250x180",
+    "tiled": false,
+    "fullCandidateAttempts": 1
+  },
+  "largeSync": {
+    "selection": "280x200",
+    "tiled": true,
+    "tileCount": 4,
+    "selectedCells": 56000,
+    "generatedCoverageCells": 56000,
+    "missingCells": 0,
+    "seamStatus": "clean",
+    "measuredTotalMs": 20588.2
+  },
+  "largeWorker": {
+    "selection": "280x200",
+    "outerWorkerOk": true,
+    "patchOk": true,
+    "tiled": true,
+    "tileCount": 4,
+    "seamStatus": "clean",
+    "measuredTotalMs": 23139
+  },
+  "step17": {
+    "ok": true,
+    "variant0Seconds": 14.04,
+    "variant1Seconds": 15.22,
+    "alternativesDiffer": true
+  },
+  "step15": {
+    "ok": true,
+    "expansionSeconds": 14.88,
+    "seamStatus": "clean",
+    "footprintEscapedCells": 0,
+    "roadPortalsUnresolved": 0,
+    "railPortalsUnresolved": 0
+  },
+  "previousGeographyRegression": {
+    "ok": true,
+    "riverSeaPoints": 0,
+    "duplicateCapitalPrefectures": 0,
+    "tinyGeneratedPrefectures": 0,
+    "adminFrontierBreaks": 0,
+    "prefectureFrontierBreaks": 0,
+    "maxEstablishedFrontierElevationJump": 0.0268,
+    "seamStatus": "clean"
+  }
+}
diff --git a/archive/generated-history/LARGE_SELECTION_STABILITY_RESULT.json b/archive/generated-history/LARGE_SELECTION_STABILITY_RESULT.json
new file mode 100644
index 0000000..436ee41
--- /dev/null
+++ b/archive/generated-history/LARGE_SELECTION_STABILITY_RESULT.json
@@ -0,0 +1,18 @@
+{
+  "ok": true,
+  "verifiedAt": "2026-08-07",
+  "largeSelectionCases": [
+    {"mode":"direct","size":"300x339","ms":24539,"ok":true,"tileCount":4,"seam":"clean","hardPass":true},
+    {"mode":"direct","size":"500x350","ms":29637,"ok":true,"tileCount":4,"seam":"clean","hardPass":true},
+    {"mode":"direct","size":"600x400","ms":42836,"ok":true,"tileCount":9,"seam":"clean","hardPass":true},
+    {"mode":"worker","size":"600x400","ms":41060,"outerOk":true,"ok":true,"tileCount":9,"seam":"clean","hardPass":true}
+  ],
+  "existingRegressionChecks": {
+    "large280x200Sync": {"ok":true,"missingSelectedCells":0,"tileCount":4,"seam":"clean"},
+    "large280x200Worker": {"outerOk":true,"ok":true,"tileCount":4,"seam":"clean"},
+    "reportedPatchBugs": {"ok":true,"riverSeaPoints":0,"duplicateCapitalPrefs":0,"tinyGeneratedPrefectures":0,"adminFrontierBreaks":0,"prefectureFrontierBreaks":0,"maxEstablishedFrontierElevationJump":0.0268,"seam":"clean"},
+    "step17": {"ok":true,"alternativesDiffer":true,"explicitRenderRevision":true,"singlePatchWorkerLifetime":true},
+    "step15": {"ok":true,"expansionSeam":"clean","footprintEscapedCells":0,"roadPortalsUnresolved":0,"railPortalsUnresolved":0},
+    "seamStress": {"checkedIndependently":true,"maxObserved":0.0364,"hardLimit":0.075,"status":"clean"}
+  }
+}
diff --git a/archive/generated-history/LARGE_WORKER_WORLD_NATIVE_RESULT.json b/archive/generated-history/LARGE_WORKER_WORLD_NATIVE_RESULT.json
new file mode 100644
index 0000000..6614dc2
--- /dev/null
+++ b/archive/generated-history/LARGE_WORKER_WORLD_NATIVE_RESULT.json
@@ -0,0 +1,9 @@
+{
+  "ms": 23764,
+  "outer": true,
+  "inner": true,
+  "tiled": true,
+  "tileCount": 6,
+  "seam": "clean",
+  "reason": null
+}
diff --git a/archive/generated-history/REPORTED_BUGS_WORLD_NATIVE_RESULT.json b/archive/generated-history/REPORTED_BUGS_WORLD_NATIVE_RESULT.json
new file mode 100644
index 0000000..8ca8ddb
--- /dev/null
+++ b/archive/generated-history/REPORTED_BUGS_WORLD_NATIVE_RESULT.json
@@ -0,0 +1,26 @@
+{
+  "ok": true,
+  "riverSeaPoints": 0,
+  "duplicateCapitalPrefs": [],
+  "missingCapitalPrefs": [],
+  "generatedSizes": [
+    [
+      3,
+      1333
+    ],
+    [
+      4,
+      4239
+    ]
+  ],
+  "tinyGenerated": [],
+  "landLandPairs": 102,
+  "maxEstablishedFrontierElevationJump": 0.0364,
+  "adminBreaksOnEstablishedFrontier": 0,
+  "prefectureBreaksOnEstablishedFrontier": 0,
+  "frontierAdminCellsAligned": 0,
+  "establishedFrontierAdminCellsRestored": 0,
+  "frontierHarmonizedValues": 0,
+  "seamStatus": "clean",
+  "seamGateReasons": []
+}
diff --git a/archive/generated-history/SEAM_STRESS_RESULT.json b/archive/generated-history/SEAM_STRESS_RESULT.json
new file mode 100644
index 0000000..12cd9d6
--- /dev/null
+++ b/archive/generated-history/SEAM_STRESS_RESULT.json
@@ -0,0 +1,17 @@
+{
+  "ok": true,
+  "note": "Measured in four separate two-case runs to avoid cumulative validation-process runtime limits.",
+  "hardLimit": 0.075,
+  "cases": 8,
+  "maxObserved": 0.0364,
+  "results": [
+    {"baseSeed":24681357,"direction":"right","pairs":102,"maxJump":0.0253,"meanJump":0.0088,"diagnosticMax":0.0364,"seamReasons":[]},
+    {"baseSeed":24681357,"direction":"left","pairs":84,"maxJump":0.0364,"meanJump":0.0244,"diagnosticMax":0.0364,"seamReasons":[]},
+    {"baseSeed":24681357,"direction":"down","pairs":145,"maxJump":0.0364,"meanJump":0.0202,"diagnosticMax":0.0364,"seamReasons":[]},
+    {"baseSeed":24681357,"direction":"up","pairs":145,"maxJump":0.0364,"meanJump":0.0258,"diagnosticMax":0.0364,"seamReasons":[]},
+    {"baseSeed":13579246,"direction":"right","pairs":55,"maxJump":0.0221,"meanJump":0.0057,"diagnosticMax":0.0364,"seamReasons":[]},
+    {"baseSeed":13579246,"direction":"left","pairs":102,"maxJump":0.0134,"meanJump":0.0054,"diagnosticMax":0.0364,"seamReasons":[]},
+    {"baseSeed":13579246,"direction":"down","pairs":141,"maxJump":0.0285,"meanJump":0.0073,"diagnosticMax":0.0364,"seamReasons":[]},
+    {"baseSeed":13579246,"direction":"up","pairs":83,"maxJump":0.0364,"meanJump":0.0105,"diagnosticMax":0.0259,"seamReasons":[]}
+  ]
+}
diff --git a/archive/generated-history/STEP0_STEP1_NOTES.md b/archive/generated-history/STEP0_STEP1_NOTES.md
new file mode 100644
index 0000000..bd42400
--- /dev/null
+++ b/archive/generated-history/STEP0_STEP1_NOTES.md
@@ -0,0 +1,36 @@
+# Step 0 / Step 1 implementation
+
+## Step 0 — Seam diagnostics
+
+Patch preview/application now records and displays:
+
+- inspected seam-band cell count
+- land→sea and sea→land flips
+- existing transport cells converted to sea
+- pre-existing road/rail seam portals and post-patch connection status
+- new municipal/prefecture boundary edges created in the seam band
+- near-parallel/overlapping boundary pairs
+- abrupt elevation edges
+- map markers and the seam outline
+
+The overlay is enabled by default and can be toggled with **Layer → Seam diagnostics**.
+Detailed metrics are shown under **Advanced / Debug Data → Seam Diagnostics** and included in **Copy Important Data**.
+
+Marker colors:
+
+- magenta dashed line: patch seam
+- red: disconnected/critical issue
+- orange: topology or boundary warning
+- green: retained road/rail crossing
+
+## Step 1 — Variable rectangle candidate suspended
+
+`PATCH_VARIABLE_CANDIDATE_ENABLED` is set to `false` in `mapPatch.js`.
+Patch generation therefore uses `legacy-full-pipeline`, while the variable-size implementation remains in the source for later re-enablement.
+The UI and diagnostic output explicitly report `variableCandidateSuspended: true` during this comparison phase.
+
+## Validation performed
+
+- Syntax check passed for every JavaScript file.
+- Two end-to-end Node runs completed: initial map generation, world creation, full-pipeline patch generation, seam analysis, and viewport diagnostic transformation.
+- Both runs reported `patchGenerationMode: legacy-full-pipeline` and `variableCandidateSuspended: true`.
diff --git a/archive/generated-history/STEP15_NOTES.md b/archive/generated-history/STEP15_NOTES.md
new file mode 100644
index 0000000..978ffab
--- /dev/null
+++ b/archive/generated-history/STEP15_NOTES.md
@@ -0,0 +1,126 @@
+# Step 15 — residual cleanup and final verification
+
+## Scope
+
+This step completes the cleanup work identified after Step 14. The goal is to remove dead/duplicated/compatibility-only code and avoid pointless transport repair work without changing the generator's intended map quality. The earlier Step 14 transport lifecycle remains conceptually intact: base transport -> pre-admin finalization -> post-admin transport -> output topology finalization.
+
+## Cleanup completed
+
+### Dead and compatibility-only code
+
+- Removed the remaining unused `nearestNetworkPoint` import.
+- Removed unused local bindings such as the old renderer history flag and unused satellite-classification return binding.
+- Removed test-only legacy name compatibility exports (`NAME_PARTS`, `generateTemplateName`).
+- Removed retired name-generation fallback debug fields.
+- Removed retired administration debug fields that were permanently zero after the older seed/snap pipeline was deleted.
+- Removed stale comments referring to the deleted patch candidate cache.
+- Reduced exports that were only used inside their own module.
+
+### Shared utilities / duplication
+
+- Centralized time measurement, world indexing, finite field access, nearest-point distance, and grid-path walking in `mapUtils.js`.
+- Centralized administrative border-field averaging in `mapAdminShared.js`.
+- Centralized transport path rasterization and occupancy connected-component labeling in `mapTransportUtils.js`.
+- Reused the shared raster/component utilities from `mapTransport.js` and `mapOutput.js` instead of keeping separate implementations.
+- Static audit now finds no unreachable runtime module, no unused runtime import/export/local top-level declaration, and no exact duplicate named function body among 773 scanned function bodies.
+
+### Pre-admin road connectivity
+
+`connectPreAdminRoadComponents()` previously could repeat a failed topology state up to 44–46 times. It now:
+
+- builds candidates only between different connected components,
+- reuses the influence field while the path topology is unchanged,
+- tries each candidate in the current topology state at most once,
+- stops a round immediately when no candidate succeeds,
+- rebuilds components only after an accepted connector changes topology.
+
+Eight-seed probing shows failed attempts are now bounded to 0–2 in the common cases and no-success states stop after one round rather than 46 rounds.
+
+### Gap-stitch candidate work
+
+The former gap-stitch pass enumerated tens of thousands of same-component near pairs only to discard them. Candidate indexing is now component-aware so same-component pairs are excluded before route construction.
+
+### Redundant road passes
+
+- Removed the effectively dead `nationalPrune` pass after national-road downgrade.
+- Made the final minor-road dedupe conditional on an actual connector having been added.
+- Removed obsolete constant transport debug fields associated with deleted passes.
+
+### Output road finalization
+
+The output lifecycle now performs required additions before the final prune:
+
+1. municipal-center local access,
+2. required center stubs,
+3. nearby endpoint connectors,
+4. isolated-component pruning,
+5. final component measurement.
+
+This removes the previous normal pattern of pruning first and then re-adding required roads. The final diagnostic is now `finalOutputRoadTopology`, measured after all output topology mutations.
+
+### Patch runtime regression found during cleanup
+
+Static refactoring exposed one missed call site where `createPatchContext()` was still passed the deleted local `worldIndex` identifier. Normal map-generation tests did not execute that path. A real Expansion probe raised `ReferenceError: worldIndex is not defined`; the call site was corrected to the shared `worldIndexOf` helper. Expansion and rollback were rerun after the fix.
+
+## Verification
+
+### Runtime validation
+
+`STEP15_VALIDATION.mjs` passes on the final source:
+
+- seeds 1 / 3 / 5: every municipal center has road access,
+- road-cell coverage remains above the regression floor,
+- pre-admin connectivity attempts are bounded and no-success rounds terminate,
+- Expansion succeeds with a clean seam,
+- footprint write escapes: 0,
+- unresolved road portals: 0,
+- unresolved rail portals: 0,
+- forced quality failure restores fields, source map, patch history state, serial, and source-map object identity.
+
+Latest measured Expansion in this validation: 7.55 s in this container.
+
+### Eight-seed transport probe
+
+Seeds `1, 3, 5, 101, 777, 999, 2026, 12345` retain 100% municipal-center road coverage. The former 44–46 failed pre-admin connector retries are gone; observed attempts are 0–3 per seed.
+
+### Test shards
+
+All eight test shards pass individually on the final source:
+
+- core: 0 failures, 17.46 s
+- terrain: 0 failures, 24.23 s
+- admin: 0 failures, 14.01 s
+- determinism-114514: 0 failures, 8.46 s
+- determinism-12345: 0 failures, 8.00 s
+- determinism-54321: 0 failures, 8.38 s
+- determinism-777: 0 failures, 7.80 s
+- determinism-999: 0 failures, 9.92 s
+
+Total measured shard wall time when run as separate invocations: 98.26 s. Every shard is below three minutes.
+
+The container tool used for this work applies a cumulative execution throttle/termination to long single tool invocations; consequently `test-all.mjs` could not be observed to finish as one monolithic invocation here even though each child suite completes independently. `STEP15_TEST_RESULT.json` records the authoritative per-shard verification rather than claiming a monolithic pass.
+
+### Static audit
+
+Final runtime source:
+
+- runtime modules: 35
+- reachable runtime modules: 35 / 35
+- runtime source size: about 1.21 MB
+- unused imports found: 0
+- unused exported declarations found: 0
+- unused local top-level declarations found: 0
+- exact duplicate named function bodies found: 0 / 773 scanned
+- retired compatibility/debug symbols remaining: 0
+- all JS/MJS files pass `node --check`
+
+## Packaging
+
+Two packages are produced:
+
+- `map_step15.zip`: clean development project with source, tests, Step 15 validation/report files, and patch.
+- `map_step15_runtime.zip`: runtime-only package containing `index.html`, `styles.css`, and the 35 reachable runtime JavaScript modules. Tests, validation scripts, patches, notes, and old Step artifacts are excluded.
+
+## Remaining caution
+
+This cleanup deliberately avoids another redesign of the four lifecycle phases of the transport generator. Some output pruning may still legitimately remove isolated roads, and some isolated same-landmass municipal components may require terrain-aware connectors during final output. Those operations have functional purposes and were retained rather than treated as dead code.
diff --git a/archive/generated-history/STEP15_STATIC_AUDIT.json b/archive/generated-history/STEP15_STATIC_AUDIT.json
new file mode 100644
index 0000000..a2017e6
--- /dev/null
+++ b/archive/generated-history/STEP15_STATIC_AUDIT.json
@@ -0,0 +1,21 @@
+{
+  "ok": true,
+  "runtimeFiles": 35,
+  "runtimeLines": 27567,
+  "runtimeBytes": 1209414,
+  "runtimeReachable": 35,
+  "runtimeUnreachable": [],
+  "unusedImports": [],
+  "unusedExports": [],
+  "unusedLocalCandidates": [],
+  "exactDuplicateFunctionBodies": [],
+  "functionBodiesScanned": 773,
+  "retiredSymbolsRemaining": [],
+  "sharedUtilitiesConfirmed": {
+    "pathRasterization": true,
+    "occupancyComponents": true,
+    "fieldSchema": true,
+    "commonTimingAndIndex": true
+  },
+  "note": "Regex/static reachability audit is conservative; runtime regression tests are the authoritative behavior check."
+}
diff --git a/archive/generated-history/STEP15_TEST_RESULT.json b/archive/generated-history/STEP15_TEST_RESULT.json
new file mode 100644
index 0000000..0b66c92
--- /dev/null
+++ b/archive/generated-history/STEP15_TEST_RESULT.json
@@ -0,0 +1,83 @@
+{
+  "ok": true,
+  "verificationMode": "individual-shards",
+  "reasonMonolithicNotUsed": "The container execution harness throttles/terminates long cumulative CPU runs; test-all.mjs did not complete in one tool invocation although each child suite completes independently.",
+  "suiteCount": 8,
+  "failures": 0,
+  "sumWallSeconds": 98.26,
+  "allSuitesUnderThreeMinutes": true,
+  "suites": [
+    {
+      "suite": "core",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 4,
+      "elapsedMsReported": 17403,
+      "wallSeconds": 17.46,
+      "allTestsPassedMarker": true
+    },
+    {
+      "suite": "terrain",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 6,
+      "elapsedMsReported": 24171,
+      "wallSeconds": 24.23,
+      "allTestsPassedMarker": true
+    },
+    {
+      "suite": "admin",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 3,
+      "elapsedMsReported": 13950,
+      "wallSeconds": 14.01,
+      "allTestsPassedMarker": true
+    },
+    {
+      "suite": "determinism-114514",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMsReported": 8407,
+      "wallSeconds": 8.46,
+      "allTestsPassedMarker": true
+    },
+    {
+      "suite": "determinism-12345",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMsReported": 7931,
+      "wallSeconds": 8.0,
+      "allTestsPassedMarker": true
+    },
+    {
+      "suite": "determinism-54321",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMsReported": 8313,
+      "wallSeconds": 8.38,
+      "allTestsPassedMarker": true
+    },
+    {
+      "suite": "determinism-777",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMsReported": 7745,
+      "wallSeconds": 7.8,
+      "allTestsPassedMarker": true
+    },
+    {
+      "suite": "determinism-999",
+      "status": 0,
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMsReported": 9862,
+      "wallSeconds": 9.92,
+      "allTestsPassedMarker": true
+    }
+  ]
+}
diff --git a/archive/generated-history/STEP15_TRANSPORT_PROBE.jsonl b/archive/generated-history/STEP15_TRANSPORT_PROBE.jsonl
new file mode 100644
index 0000000..e6cb108
--- /dev/null
+++ b/archive/generated-history/STEP15_TRANSPORT_PROBE.jsonl
@@ -0,0 +1,8 @@
+{"seed":1,"ms":4760,"roadCells":2122,"centers":45,"covered":45,"minor":155,"national":27,"nc":{"beforeComponents":3,"afterComponents":3,"added":0,"failed":1,"attempted":1,"rounds":1},"gap":{"expressway":0,"national":1,"localToNational":16,"local":3,"localMeshClosures":41},"out":{"components":6,"requiredStubsAdded":6,"endpointConnectorsAdded":3,"prune":{"beforeComponents":12,"afterComponents":6,"pruned":{"minor":11,"national":1,"external":0,"expressway":0,"externalExpressway":0},"prunePasses":2,"mountainAdminConnections":{"attempted":6,"added":6,"skippedIsland":3,"failed":0}}}}
+{"seed":3,"ms":4894,"roadCells":2598,"centers":43,"covered":43,"minor":181,"national":26,"nc":{"beforeComponents":3,"afterComponents":1,"added":2,"failed":0,"attempted":2,"rounds":2},"gap":{"expressway":0,"national":2,"localToNational":9,"local":4,"localMeshClosures":35},"out":{"components":2,"requiredStubsAdded":10,"endpointConnectorsAdded":8,"prune":{"beforeComponents":19,"afterComponents":2,"pruned":{"minor":5,"national":0,"external":0,"expressway":0,"externalExpressway":0},"prunePasses":2,"mountainAdminConnections":{"attempted":14,"added":14,"skippedIsland":1,"failed":0}}}}
+{"seed":5,"ms":3471,"roadCells":2044,"centers":45,"covered":45,"minor":139,"national":19,"nc":{"beforeComponents":5,"afterComponents":4,"added":1,"failed":2,"attempted":3,"rounds":2},"gap":{"expressway":0,"national":1,"localToNational":9,"local":4,"localMeshClosures":40},"out":{"components":9,"requiredStubsAdded":10,"endpointConnectorsAdded":3,"prune":{"beforeComponents":22,"afterComponents":9,"pruned":{"minor":41,"national":6,"external":0,"expressway":3,"externalExpressway":0},"prunePasses":2,"mountainAdminConnections":{"attempted":12,"added":12,"skippedIsland":4,"failed":0}}}}
+{"seed":101,"ms":4410,"roadCells":2148,"centers":47,"covered":47,"minor":144,"national":27,"nc":{"beforeComponents":2,"afterComponents":1,"added":1,"failed":0,"attempted":1,"rounds":1},"gap":{"expressway":0,"national":0,"localToNational":5,"local":3,"localMeshClosures":29},"out":{"components":1,"requiredStubsAdded":6,"endpointConnectorsAdded":4,"prune":{"beforeComponents":10,"afterComponents":1,"pruned":{"minor":2,"national":0,"external":0,"expressway":0,"externalExpressway":0},"prunePasses":1,"mountainAdminConnections":{"attempted":7,"added":7,"skippedIsland":0,"failed":0}}}}
+{"seed":777,"ms":3587,"roadCells":1906,"centers":44,"covered":44,"minor":131,"national":24,"nc":{"beforeComponents":1,"afterComponents":1,"added":0,"failed":0,"attempted":0,"rounds":0},"gap":{"expressway":0,"national":2,"localToNational":13,"local":1,"localMeshClosures":31},"out":{"components":5,"requiredStubsAdded":4,"endpointConnectorsAdded":3,"prune":{"beforeComponents":10,"afterComponents":5,"pruned":{"minor":4,"national":0,"external":0,"expressway":0,"externalExpressway":0},"prunePasses":2,"mountainAdminConnections":{"attempted":9,"added":7,"skippedIsland":0,"failed":2}}}}
+{"seed":999,"ms":4244,"roadCells":1719,"centers":43,"covered":43,"minor":116,"national":25,"nc":{"beforeComponents":11,"afterComponents":11,"added":0,"failed":2,"attempted":2,"rounds":1},"gap":{"expressway":0,"national":0,"localToNational":15,"local":0,"localMeshClosures":38},"out":{"components":13,"requiredStubsAdded":7,"endpointConnectorsAdded":6,"prune":{"beforeComponents":12,"afterComponents":13,"pruned":{"minor":41,"national":1,"external":0,"expressway":3,"externalExpressway":0},"prunePasses":2,"mountainAdminConnections":{"attempted":11,"added":5,"skippedIsland":0,"failed":6}}}}
+{"seed":2026,"ms":4037,"roadCells":2439,"centers":50,"covered":50,"minor":177,"national":28,"nc":{"beforeComponents":2,"afterComponents":2,"added":0,"failed":0,"attempted":0,"rounds":1},"gap":{"expressway":0,"national":1,"localToNational":6,"local":7,"localMeshClosures":44},"out":{"components":3,"requiredStubsAdded":9,"endpointConnectorsAdded":8,"prune":{"beforeComponents":15,"afterComponents":3,"pruned":{"minor":4,"national":0,"external":0,"expressway":0,"externalExpressway":0},"prunePasses":2,"mountainAdminConnections":{"attempted":11,"added":10,"skippedIsland":1,"failed":1}}}}
+{"seed":12345,"ms":3222,"roadCells":2140,"centers":50,"covered":50,"minor":151,"national":31,"nc":{"beforeComponents":6,"afterComponents":4,"added":2,"failed":1,"attempted":3,"rounds":3},"gap":{"expressway":0,"national":2,"localToNational":10,"local":4,"localMeshClosures":37},"out":{"components":9,"requiredStubsAdded":6,"endpointConnectorsAdded":3,"prune":{"beforeComponents":7,"afterComponents":9,"pruned":{"minor":9,"national":3,"external":0,"expressway":0,"externalExpressway":0},"prunePasses":2,"mountainAdminConnections":{"attempted":1,"added":0,"skippedIsland":5,"failed":1}}}}
diff --git a/archive/generated-history/STEP15_VALIDATION.mjs b/archive/generated-history/STEP15_VALIDATION.mjs
new file mode 100644
index 0000000..28d225a
--- /dev/null
+++ b/archive/generated-history/STEP15_VALIDATION.mjs
@@ -0,0 +1,168 @@
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { performance } from 'node:perf_hooks';
+import { generateMap } from './mapPipeline.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_H, MAP_W, SIZE, indexOf } from './mapUtils.js';
+
+function hashObject(value) {
+  const hash = createHash('sha256');
+  const seen = new WeakSet();
+  function visit(v, path = '') {
+    if (v == null || typeof v !== 'object') { hash.update(`${path}:${typeof v}:${String(v)}\n`); return; }
+    if (ArrayBuffer.isView(v)) {
+      hash.update(`${path}:${v.constructor.name}:${v.length}:`);
+      hash.update(Buffer.from(v.buffer, v.byteOffset, v.byteLength));
+      return;
+    }
+    if (seen.has(v)) return;
+    seen.add(v);
+    if (Array.isArray(v)) {
+      hash.update(`${path}:array:${v.length}\n`);
+      for (let i = 0; i < v.length; i++) visit(v[i], `${path}[${i}]`);
+      return;
+    }
+    const keys = Object.keys(v).sort();
+    hash.update(`${path}:object:${keys.join(',')}\n`);
+    for (const key of keys) visit(v[key], `${path}.${key}`);
+  }
+  visit(value);
+  return hash.digest('hex');
+}
+
+function rasterize(paths) {
+  const occ = new Uint8Array(SIZE);
+  for (const path of paths || []) for (let k = 1; k < (path?.length || 0); k++) {
+    const [x0, y0] = path[k - 1];
+    const [x1, y1] = path[k];
+    const steps = Math.max(1, Math.ceil(Math.hypot(x1 - x0, y1 - y0)));
+    for (let s = 0; s <= steps; s++) {
+      const t = s / steps;
+      const x = Math.round(x0 + (x1 - x0) * t);
+      const y = Math.round(y0 + (y1 - y0) * t);
+      if (x >= 0 && y >= 0 && x < MAP_W && y < MAP_H) occ[indexOf(x, y)] = 1;
+    }
+  }
+  return occ;
+}
+
+function countCells(occ) { let n = 0; for (const v of occ) n += v ? 1 : 0; return n; }
+function nearPath(paths, point, radius = 0.75) {
+  for (const path of paths || []) for (const [x, y] of path || []) {
+    if (Math.hypot(x - point.x, y - point.y) <= radius) return true;
+  }
+  return false;
+}
+function westSelection(world) {
+  const ox = world.originX, oy = world.originY;
+  return { kind: 'lasso', polygon: [
+    { x: ox - 145, y: oy - 14 }, { x: ox + 8, y: oy - 14 },
+    { x: ox + 8, y: oy + MAP_H + 14 }, { x: ox - 145, y: oy + MAP_H + 14 },
+  ] };
+}
+
+const source = {
+  transport: readFileSync(new URL('./mapTransport.js', import.meta.url), 'utf8'),
+  features: readFileSync(new URL('./mapFeatures.js', import.meta.url), 'utf8'),
+  output: readFileSync(new URL('./mapOutput.js', import.meta.url), 'utf8'),
+  names: readFileSync(new URL('./names.js', import.meta.url), 'utf8'),
+  admin: readFileSync(new URL('./mapAdminStage.js', import.meta.url), 'utf8'),
+  patch: readFileSync(new URL('./mapPatch.js', import.meta.url), 'utf8'),
+  utils: readFileSync(new URL('./mapTransportUtils.js', import.meta.url), 'utf8'),
+};
+for (const retired of ['NAME_PARTS', 'oneKanjiAppendFallbackUsed', 'legacyFallbackUsed', 'changedAfterSnap', 'pendingSeedsUsedForLowlandSplit', 'seedLifecycle', 'seedCellRevivalCount', 'pendingSeedCount']) {
+  assert.equal(Object.values(source).some((text) => text.includes(retired)), false, `retired compatibility/debug symbol remains: ${retired}`);
+}
+for (const retired of ['nationalPrune', 'skippedSameComponent', 'finalOutputRoadConnectivity', 'all-road-connect:${pass}', 'Cached candidates']) {
+  assert.equal(Object.values(source).some((text) => text.includes(retired)), false, `retired transport/cache pattern remains: ${retired}`);
+}
+assert.equal(source.transport.includes('nearestNetworkPoint'), false, 'unused nearestNetworkPoint remains');
+assert.equal(source.utils.includes('occupancyComponentsFromPathGroups'), true, 'shared occupancy component helper missing');
+assert.equal(source.utils.includes('rasterizePathCells'), true, 'shared path rasterization helper missing');
+assert.equal(source.features.includes('debug.networkConnectivity.added > 0'), true, 'minor final dedupe is not conditional');
+const outputStub = source.output.indexOf('const requiredStubsAdded = ensureAdminCenterRoadStubs();');
+const outputEndpoint = source.output.indexOf('const endpointConnectorsAdded = connectNearbyRoadEndpoints();');
+const outputPrune = source.output.indexOf('const prune = pruneIsolatedFinalRoadComponents();');
+assert.ok(outputStub >= 0 && outputEndpoint > outputStub && outputPrune > outputEndpoint, 'output topology mutations must precede final prune');
+assert.equal(source.names.includes('export function generateTemplateName'), false, 'test-only generateTemplateName API remains');
+assert.equal(source.names.includes('export const NAME_PARTS'), false, 'test-only NAME_PARTS API remains');
+assert.equal(source.features.includes('aStarRoutes: 0'), false, 'obsolete constant transport debug remains');
+assert.equal(source.features.includes('fieldCorridorTransport: false'), false, 'obsolete constant transport debug remains');
+assert.equal(source.features.includes('nationalRoadPopulationCoverage: 0'), false, 'obsolete constant transport debug remains');
+
+const seeds = [1, 3, 5];
+const transport = [];
+let initial = null;
+for (const seed of seeds) {
+  const t0 = performance.now();
+  const map = generateMap(seed, { terrainType: 'auto', onProgress() {} });
+  if (seed === 1) initial = map;
+  const roads = [...(map.minorRoads || []), ...(map.nationalRoads || []), ...(map.externalRoads || []), ...(map.ringRoads || [])];
+  const roadCells = countCells(rasterize(roads));
+  const centers = map.adminCenters || map.adminCentersRaw || [];
+  const covered = centers.filter((center) => nearPath(roads, center)).length;
+  const nc = map.transportDebug?.layers?.preAdminRoadFinalization?.networkConnectivity || {};
+  const output = map.transportDebug?.layers?.finalOutputRoadTopology || {};
+  assert.equal(covered, centers.length, `seed ${seed}: municipal center lost road access`);
+  assert.ok(roadCells >= 1200, `seed ${seed}: road coverage collapsed (${roadCells})`);
+  assert.ok((nc.attempted || 0) <= 18 * Math.max(1, (nc.rounds || 0)), `seed ${seed}: connectivity candidate loop expanded unexpectedly`);
+  assert.ok((nc.failed || 0) <= (nc.attempted || 0), `seed ${seed}: failed attempt accounting invalid`);
+  if ((nc.added || 0) === 0) assert.ok((nc.rounds || 0) <= 1, `seed ${seed}: no-success connectivity loop repeated rounds`);
+  assert.ok(Number.isFinite(output.components), `seed ${seed}: final output component count missing`);
+  transport.push({
+    seed,
+    seconds: Math.round((performance.now() - t0) / 10) / 100,
+    roadCells,
+    adminCenters: { total: centers.length, covered },
+    connectivity: nc,
+    finalOutput: output,
+  });
+}
+
+const expansionWorld = createWorldMap(structuredClone(initial));
+const expStart = performance.now();
+const expansion = generatePatch(expansionWorld, westSelection(expansionWorld), {
+  patchMode: 'expansion', terrainType: 'auto', seed: 0x15151515, variant: 0, maxQualityRetries: 1,
+});
+const expansionSeconds = (performance.now() - expStart) / 1000;
+assert.equal(expansion.ok, true, `expansion failed: ${expansion.code || 'unknown'}`);
+assert.notEqual(expansion.candidateQuality?.hardPass, false, 'committed failed quality candidate');
+assert.equal(expansion.seamDiagnostics?.expansionFootprintEscapedCells || 0, 0, 'footprint write escaped');
+assert.equal(expansion.seamDiagnostics?.roadPortalsUnresolved || 0, 0, 'road portal disconnected');
+assert.equal(expansion.seamDiagnostics?.railPortalsUnresolved || 0, 0, 'rail portal disconnected');
+
+const rollbackWorld = createWorldMap(structuredClone(initial));
+const before = {
+  fields: hashObject(rollbackWorld.fields),
+  sourceMap: hashObject(rollbackWorld.sourceMap),
+  generatedRects: structuredClone(rollbackWorld.generatedRects),
+  invalidatedRects: structuredClone(rollbackWorld.invalidatedRects),
+  serial: rollbackWorld.patchGenerationSerial || 0,
+  sourceIdentity: rollbackWorld.sourceMap,
+};
+const rejected = generatePatch(rollbackWorld, { x0: 30, y0: 30, x1: 110, y1: 110 }, {
+  patchMode: 'expansion', terrainType: 'oceanic_archipelago', seed: 456, variant: 0, maxQualityRetries: 0,
+});
+assert.equal(rejected.ok, false, 'rollback probe unexpectedly committed');
+assert.equal(rejected.code, 'patch-quality-gate-failed');
+assert.equal(hashObject(rollbackWorld.fields), before.fields, 'field rollback mismatch');
+assert.equal(hashObject(rollbackWorld.sourceMap), before.sourceMap, 'sourceMap rollback mismatch');
+assert.deepEqual(rollbackWorld.generatedRects, before.generatedRects, 'generatedRects rollback mismatch');
+assert.deepEqual(rollbackWorld.invalidatedRects, before.invalidatedRects, 'invalidatedRects rollback mismatch');
+assert.equal(rollbackWorld.patchGenerationSerial || 0, before.serial, 'serial rollback mismatch');
+assert.equal(rollbackWorld.sourceMap, before.sourceIdentity, 'sourceMap identity rollback mismatch');
+
+console.log(JSON.stringify({
+  ok: true,
+  transport,
+  expansion: {
+    seconds: Math.round(expansionSeconds * 100) / 100,
+    seamStatus: expansion.seamDiagnostics?.status || null,
+    footprintEscapedCells: expansion.seamDiagnostics?.expansionFootprintEscapedCells || 0,
+    roadPortalsUnresolved: expansion.seamDiagnostics?.roadPortalsUnresolved || 0,
+    railPortalsUnresolved: expansion.seamDiagnostics?.railPortalsUnresolved || 0,
+  },
+  rollback: { code: rejected.code, restored: true, sourceIdentityPreserved: true },
+}, null, 2));
diff --git a/archive/generated-history/STEP15_VALIDATION_RESULT.json b/archive/generated-history/STEP15_VALIDATION_RESULT.json
new file mode 100644
index 0000000..766977c
--- /dev/null
+++ b/archive/generated-history/STEP15_VALIDATION_RESULT.json
@@ -0,0 +1,137 @@
+{
+  "ok": true,
+  "transport": [
+    {
+      "seed": 1,
+      "seconds": 4.67,
+      "roadCells": 2122,
+      "adminCenters": {
+        "total": 45,
+        "covered": 45
+      },
+      "connectivity": {
+        "beforeComponents": 3,
+        "afterComponents": 3,
+        "added": 0,
+        "failed": 1,
+        "attempted": 1,
+        "rounds": 1
+      },
+      "finalOutput": {
+        "components": 6,
+        "requiredStubsAdded": 6,
+        "endpointConnectorsAdded": 3,
+        "prune": {
+          "beforeComponents": 12,
+          "afterComponents": 6,
+          "pruned": {
+            "minor": 11,
+            "national": 1,
+            "external": 0,
+            "expressway": 0,
+            "externalExpressway": 0
+          },
+          "prunePasses": 2,
+          "mountainAdminConnections": {
+            "attempted": 6,
+            "added": 6,
+            "skippedIsland": 3,
+            "failed": 0
+          }
+        }
+      }
+    },
+    {
+      "seed": 3,
+      "seconds": 4.81,
+      "roadCells": 2598,
+      "adminCenters": {
+        "total": 43,
+        "covered": 43
+      },
+      "connectivity": {
+        "beforeComponents": 3,
+        "afterComponents": 1,
+        "added": 2,
+        "failed": 0,
+        "attempted": 2,
+        "rounds": 2
+      },
+      "finalOutput": {
+        "components": 2,
+        "requiredStubsAdded": 10,
+        "endpointConnectorsAdded": 8,
+        "prune": {
+          "beforeComponents": 19,
+          "afterComponents": 2,
+          "pruned": {
+            "minor": 5,
+            "national": 0,
+            "external": 0,
+            "expressway": 0,
+            "externalExpressway": 0
+          },
+          "prunePasses": 2,
+          "mountainAdminConnections": {
+            "attempted": 14,
+            "added": 14,
+            "skippedIsland": 1,
+            "failed": 0
+          }
+        }
+      }
+    },
+    {
+      "seed": 5,
+      "seconds": 3.57,
+      "roadCells": 2044,
+      "adminCenters": {
+        "total": 45,
+        "covered": 45
+      },
+      "connectivity": {
+        "beforeComponents": 5,
+        "afterComponents": 4,
+        "added": 1,
+        "failed": 2,
+        "attempted": 3,
+        "rounds": 2
+      },
+      "finalOutput": {
+        "components": 9,
+        "requiredStubsAdded": 10,
+        "endpointConnectorsAdded": 3,
+        "prune": {
+          "beforeComponents": 22,
+          "afterComponents": 9,
+          "pruned": {
+            "minor": 41,
+            "national": 6,
+            "external": 0,
+            "expressway": 3,
+            "externalExpressway": 0
+          },
+          "prunePasses": 2,
+          "mountainAdminConnections": {
+            "attempted": 12,
+            "added": 12,
+            "skippedIsland": 4,
+            "failed": 0
+          }
+        }
+      }
+    }
+  ],
+  "expansion": {
+    "seconds": 7.55,
+    "seamStatus": "clean",
+    "footprintEscapedCells": 0,
+    "roadPortalsUnresolved": 0,
+    "railPortalsUnresolved": 0
+  },
+  "rollback": {
+    "code": "patch-quality-gate-failed",
+    "restored": true,
+    "sourceIdentityPreserved": true
+  }
+}
diff --git a/archive/generated-history/STEP15_WORLD_NATIVE_RESULT.json b/archive/generated-history/STEP15_WORLD_NATIVE_RESULT.json
new file mode 100644
index 0000000..2017eef
--- /dev/null
+++ b/archive/generated-history/STEP15_WORLD_NATIVE_RESULT.json
@@ -0,0 +1,137 @@
+{
+  "ok": true,
+  "transport": [
+    {
+      "seed": 1,
+      "seconds": 4.89,
+      "roadCells": 2122,
+      "adminCenters": {
+        "total": 45,
+        "covered": 45
+      },
+      "connectivity": {
+        "beforeComponents": 3,
+        "afterComponents": 3,
+        "added": 0,
+        "failed": 1,
+        "attempted": 1,
+        "rounds": 1
+      },
+      "finalOutput": {
+        "components": 6,
+        "requiredStubsAdded": 6,
+        "endpointConnectorsAdded": 3,
+        "prune": {
+          "beforeComponents": 12,
+          "afterComponents": 6,
+          "pruned": {
+            "minor": 11,
+            "national": 1,
+            "external": 0,
+            "expressway": 0,
+            "externalExpressway": 0
+          },
+          "prunePasses": 2,
+          "mountainAdminConnections": {
+            "attempted": 6,
+            "added": 6,
+            "skippedIsland": 3,
+            "failed": 0
+          }
+        }
+      }
+    },
+    {
+      "seed": 3,
+      "seconds": 5.02,
+      "roadCells": 2598,
+      "adminCenters": {
+        "total": 43,
+        "covered": 43
+      },
+      "connectivity": {
+        "beforeComponents": 3,
+        "afterComponents": 1,
+        "added": 2,
+        "failed": 0,
+        "attempted": 2,
+        "rounds": 2
+      },
+      "finalOutput": {
+        "components": 2,
+        "requiredStubsAdded": 10,
+        "endpointConnectorsAdded": 8,
+        "prune": {
+          "beforeComponents": 19,
+          "afterComponents": 2,
+          "pruned": {
+            "minor": 5,
+            "national": 0,
+            "external": 0,
+            "expressway": 0,
+            "externalExpressway": 0
+          },
+          "prunePasses": 2,
+          "mountainAdminConnections": {
+            "attempted": 14,
+            "added": 14,
+            "skippedIsland": 1,
+            "failed": 0
+          }
+        }
+      }
+    },
+    {
+      "seed": 5,
+      "seconds": 3.44,
+      "roadCells": 2044,
+      "adminCenters": {
+        "total": 45,
+        "covered": 45
+      },
+      "connectivity": {
+        "beforeComponents": 5,
+        "afterComponents": 4,
+        "added": 1,
+        "failed": 2,
+        "attempted": 3,
+        "rounds": 2
+      },
+      "finalOutput": {
+        "components": 9,
+        "requiredStubsAdded": 10,
+        "endpointConnectorsAdded": 3,
+        "prune": {
+          "beforeComponents": 22,
+          "afterComponents": 9,
+          "pruned": {
+            "minor": 41,
+            "national": 6,
+            "external": 0,
+            "expressway": 3,
+            "externalExpressway": 0
+          },
+          "prunePasses": 2,
+          "mountainAdminConnections": {
+            "attempted": 12,
+            "added": 12,
+            "skippedIsland": 4,
+            "failed": 0
+          }
+        }
+      }
+    }
+  ],
+  "expansion": {
+    "seconds": 24.47,
+    "seamStatus": "clean",
+    "footprintEscapedCells": 0,
+    "roadPortalsUnresolved": 0,
+    "railPortalsUnresolved": 0
+  },
+  "rollback": {
+    "code": "patch-quality-gate-failed",
+    "restored": true,
+    "sourceIdentityPreserved": true
+  }
+}
\ No newline at end of file
diff --git a/archive/generated-history/STEP17_NOTES.md b/archive/generated-history/STEP17_NOTES.md
new file mode 100644
index 0000000..4aaf7fd
--- /dev/null
+++ b/archive/generated-history/STEP17_NOTES.md
@@ -0,0 +1,86 @@
+# Step 17 — Alternative preview / apparent interruption fix
+
+## Diagnosis
+
+The Step 16 worker move removed the explicit UI-thread fallback, but it did not fix two UI semantics that could make a completed Alternative request look as if nothing had happened.
+
+1. Expansion quality selection internally searched consecutive terrain variants. A request for variant `N` could evaluate `N`, `N+1` (and sometimes `N+2`), while the next Alternative request for `N+1` evaluated an overlapping set. Both clicks could therefore select the same internal terrain variant.
+2. `generatePatch()` could silently rerun the complete patch once after a quality/seam rejection. This made one Alternative click take roughly one or two complete patch attempts depending on the result. On a slow machine that produces the observed large wall-time variation and can cross an external/browser execution limit.
+3. If an Alternative failed, the previous pending preview stayed on screen, but the failure message was transient. This looked like a successful generation that was not reflected.
+4. Renderer raster caches inferred freshness from map metadata. There was no explicit preview revision in the key.
+5. Patch controls stayed usable while a worker job was active, so repeated clicks could enqueue work and make completion ownership ambiguous.
+6. The patch worker was reused after large jobs, allowing a high-water heap to survive across repeated Alternatives.
+
+## Changes
+
+### One Alternative click now means one exact variant
+
+Interactive patch generation passes:
+
+- `qualityTerrainAttempts: 1`
+- `maxQualityRetries: 0`
+
+`mapPatch.js` now supports an explicit terrain-quality attempt count. The default non-interactive behavior remains unchanged; only the UI Alternative path uses the one-variant policy.
+
+This removes overlapping internal candidate sets. If variant `N` fails the quality gate, it is rejected and the user can request `N+1`; the UI no longer silently spends another whole-patch attempt on a different hidden variant.
+
+### Preview freshness is explicit
+
+Every successful preview receives a monotonically increasing `world.renderRevision` and its requested `previewVariant`.
+
+`worldViewport.js` propagates those values and `renderer.js` includes them in the stable raster cache prefix. A newly returned preview therefore cannot reuse a terrain/urban/prefecture-fill cache entry from an older preview merely because its dimensions and field types are the same.
+
+### Verify that a preview actually differs
+
+Before displaying a successful worker result, `app.js` compares the committed and preview worlds over the patch write area and counts:
+
+- changed cells
+- terrain changed cells (`elevation`, `sea`, `landuse`, `populationDensity`)
+- administration changed cells (`adminId`, `municipalityId`, `prefectureRegionId`)
+
+The persistent patch status reports those counts. If a result is genuinely identical, the UI says so explicitly instead of implying that a visual update was lost.
+
+### Unambiguous rendering
+
+After a successful patch worker result, the app performs one immediate full redraw of the new pending world. The previous fast-redraw + delayed-full-redraw pair was removed from this path.
+
+The progress text now distinguishes generation from rendering and reports both generation and render wall time.
+
+### Failure remains visible
+
+If an Alternative is rejected or the worker fails, the patch status now says either:
+
+- no preview was applied, or
+- the previous preview variant is still being shown.
+
+This message remains in the patch controls instead of disappearing with the temporary progress overlay.
+
+### One active patch job
+
+Patch/Alternative/Apply/Discard/variant controls are disabled while a patch job is active. A generation request also invalidates any stale patch request.
+
+### One-shot patch workers
+
+A patch worker is terminated after every completed job. This releases the worker heap between Alternative clicks and prevents stale heavy-generation state from accumulating across previews.
+
+## Validation
+
+`STEP17_VALIDATION.mjs` runs two consecutive interactive-style variants from the same committed world using the browser worker module.
+
+Observed:
+
+- variant 0: 8.42 s, selected terrain variant 0
+- variant 1: 8.50 s, selected terrain variant 1
+- quality retry count: 0 for both
+- seam status: clean for both
+- elevation hashes: different
+- sea-mask hashes: different
+- administration hashes: different
+
+Therefore the two Alternative requests produce materially different world data and exact requested variants.
+
+All 8 existing test shards pass independently on the final Step 17 source with zero `NG:` assertions. All JavaScript/MJS files pass `node --check`.
+
+## Browser E2E note
+
+The available container Chromium is subject to a localhost navigation policy/interstitial, so a reliable in-browser pointer/canvas E2E could not be completed here. Worker execution, variant data differences, cache-revision wiring, and all generator regressions are tested directly.
diff --git a/archive/generated-history/STEP17_TEST_RESULT.json b/archive/generated-history/STEP17_TEST_RESULT.json
new file mode 100644
index 0000000..38fa4c0
--- /dev/null
+++ b/archive/generated-history/STEP17_TEST_RESULT.json
@@ -0,0 +1,63 @@
+{
+  "ok": true,
+  "suites": [
+    {
+      "suite": "core",
+      "failedAssertions": 0,
+      "fullMapGenerations": 4,
+      "elapsedMs": 16970,
+      "status": 0
+    },
+    {
+      "suite": "terrain",
+      "failedAssertions": 0,
+      "fullMapGenerations": 6,
+      "elapsedMs": 25008,
+      "status": 0
+    },
+    {
+      "suite": "admin",
+      "failedAssertions": 0,
+      "fullMapGenerations": 3,
+      "elapsedMs": 14863,
+      "status": 0
+    },
+    {
+      "suite": "determinism-114514",
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMs": 9447,
+      "status": 0
+    },
+    {
+      "suite": "determinism-12345",
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMs": 9000,
+      "status": 0
+    },
+    {
+      "suite": "determinism-54321",
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMs": 8428,
+      "status": 0
+    },
+    {
+      "suite": "determinism-777",
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMs": 7999,
+      "status": 0
+    },
+    {
+      "suite": "determinism-999",
+      "failedAssertions": 0,
+      "fullMapGenerations": 2,
+      "elapsedMs": 29472,
+      "status": 0
+    }
+  ],
+  "totalElapsedMsReported": 121187,
+  "note": "Each shard executed independently on the final Step 17 source."
+}
\ No newline at end of file
diff --git a/archive/generated-history/STEP17_VALIDATION.mjs b/archive/generated-history/STEP17_VALIDATION.mjs
new file mode 100644
index 0000000..2580322
--- /dev/null
+++ b/archive/generated-history/STEP17_VALIDATION.mjs
@@ -0,0 +1,112 @@
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { Worker } from 'node:worker_threads';
+import { performance } from 'node:perf_hooks';
+import { generateMap } from './mapPipeline.js';
+import { createWorldMap } from './worldMap.js';
+import { MAP_H } from './mapUtils.js';
+import { collectTransferableBuffers } from './transferUtils.js';
+
+function hashView(view) {
+  return createHash('sha256').update(Buffer.from(view.buffer, view.byteOffset, view.byteLength)).digest('hex');
+}
+function derivePatchSeed(baseSeed, rect, terrainType, variant = 0) {
+  let h = (baseSeed >>> 0) ^ 0x9e3779b9;
+  h = Math.imul(h ^ (rect.x0 | 0), 1664525) >>> 0;
+  h = Math.imul(h ^ (rect.y0 | 0), 1013904223) >>> 0;
+  h = Math.imul(h ^ (rect.x1 | 0), 2246822519) >>> 0;
+  h = Math.imul(h ^ (rect.y1 | 0), 3266489917) >>> 0;
+  h = Math.imul(h ^ (variant >>> 0), 668265263) >>> 0;
+  for (const ch of String(terrainType || 'auto')) h = Math.imul(h ^ ch.charCodeAt(0), 16777619) >>> 0;
+  return h >>> 0;
+}
+function browserWorkerAdapter(moduleUrl) {
+  const target = moduleUrl.href;
+  const code = `
+    import { parentPort } from 'node:worker_threads';
+    globalThis.self = { onmessage: null, postMessage(message, transfer) { parentPort.postMessage(message, transfer); } };
+    await import(${JSON.stringify(target)});
+    parentPort.on('message', (data) => self.onmessage?.({ data }));
+  `;
+  return new Worker(new URL(`data:text/javascript,${encodeURIComponent(code)}`), { type: 'module', execArgv: [] });
+}
+async function runPatchWorker(baseWorld, rect, baseSeed, variant) {
+  const worker = browserWorkerAdapter(new URL('./mapPatchWorker.js', import.meta.url));
+  const preview = structuredClone(baseWorld);
+  const transfer = Array.from(collectTransferableBuffers(preview));
+  const started = performance.now();
+  const message = await new Promise((resolve, reject) => {
+    worker.on('message', (m) => { if (m?.type !== 'progress') resolve(m); });
+    worker.on('error', reject);
+    worker.postMessage({
+      id: variant + 1,
+      world: preview,
+      rect,
+      options: {
+        patchMode: 'expansion', terrainType: 'auto',
+        seed: derivePatchSeed(baseSeed, rect, 'auto', variant),
+        variant, maxQualityRetries: 0, qualityTerrainAttempts: 1,
+      },
+    }, transfer);
+  });
+  await worker.terminate();
+  assert.equal(message.ok, true, `variant ${variant} worker failed: ${message.error || 'unknown'}`);
+  assert.equal(message.result?.ok, true, `variant ${variant} patch failed: ${message.result?.code || message.result?.reason || 'unknown'}`);
+  return { message, seconds: (performance.now() - started) / 1000 };
+}
+
+const appSource = readFileSync(new URL('./app.js', import.meta.url), 'utf8');
+const viewportSource = readFileSync(new URL('./worldViewport.js', import.meta.url), 'utf8');
+const rendererSource = readFileSync(new URL('./renderer.js', import.meta.url), 'utf8');
+assert.match(appSource, /maxQualityRetries:\s*0/);
+assert.match(appSource, /patchBusy/);
+assert.match(appSource, /previewPatchDelta/);
+assert.match(appSource, /renderRevision/);
+assert.match(appSource, /worker\.terminate\?\.\(\)/);
+assert.match(viewportSource, /viewport\.renderRevision/);
+assert.match(rendererSource, /map\?\.renderRevision/);
+
+const baseSeed = 1;
+const baseWorld = createWorldMap(generateMap(baseSeed, { terrainType: 'auto', onProgress() {} }));
+const ox = baseWorld.originX;
+const oy = baseWorld.originY;
+const rect = { kind: 'lasso', polygon: [
+  { x: ox - 145, y: oy - 14 },
+  { x: ox + 8, y: oy - 14 },
+  { x: ox + 8, y: oy + MAP_H + 14 },
+  { x: ox - 145, y: oy + MAP_H + 14 },
+] };
+rect.x0 = ox - 145; rect.y0 = oy - 14; rect.x1 = ox + 8; rect.y1 = oy + MAP_H + 14;
+
+const a = await runPatchWorker(baseWorld, rect, baseSeed, 0);
+const b = await runPatchWorker(baseWorld, rect, baseSeed, 1);
+const aWorld = a.message.world;
+const bWorld = b.message.world;
+const hashesA = {
+  elevation: hashView(aWorld.fields.elevation), sea: hashView(aWorld.fields.sea), admin: hashView(aWorld.fields.adminId),
+};
+const hashesB = {
+  elevation: hashView(bWorld.fields.elevation), sea: hashView(bWorld.fields.sea), admin: hashView(bWorld.fields.adminId),
+};
+assert.notEqual(hashesA.elevation, hashesB.elevation, 'Alternative variants generated identical elevation');
+assert.notEqual(hashesA.sea, hashesB.sea, 'Alternative variants generated identical sea mask');
+assert.notEqual(hashesA.admin, hashesB.admin, 'Alternative variants generated identical administration');
+assert.equal(a.message.result.qualityRetryCount || 0, 0);
+assert.equal(b.message.result.qualityRetryCount || 0, 0);
+assert.equal(a.message.result.candidateQuality?.selectedVariant, 0, 'variant 0 did not render its exact requested terrain variant');
+assert.equal(b.message.result.candidateQuality?.selectedVariant, 1, 'variant 1 did not render its exact requested terrain variant');
+assert.equal(a.message.result.seamDiagnostics?.status, 'clean');
+assert.equal(b.message.result.seamDiagnostics?.status, 'clean');
+
+console.log(JSON.stringify({
+  ok: true,
+  interactiveRetryPolicy: 'one requested variant per click; no hidden whole-patch retry',
+  variants: [
+    { variant: 0, seconds: Math.round(a.seconds * 100) / 100, selectedVariant: a.message.result.candidateQuality?.selectedVariant, hashes: hashesA },
+    { variant: 1, seconds: Math.round(b.seconds * 100) / 100, selectedVariant: b.message.result.candidateQuality?.selectedVariant, hashes: hashesB },
+  ],
+  alternativesDiffer: true,
+  explicitRenderRevision: true,
+  singlePatchWorkerLifetime: true,
+}, null, 2));
diff --git a/archive/generated-history/STEP17_VALIDATION_RESULT.json b/archive/generated-history/STEP17_VALIDATION_RESULT.json
new file mode 100644
index 0000000..f919b8d
--- /dev/null
+++ b/archive/generated-history/STEP17_VALIDATION_RESULT.json
@@ -0,0 +1,29 @@
+{
+  "ok": true,
+  "interactiveRetryPolicy": "one requested variant per click; no hidden whole-patch retry",
+  "variants": [
+    {
+      "variant": 0,
+      "seconds": 8.42,
+      "selectedVariant": 0,
+      "hashes": {
+        "elevation": "1fbbef64867850a580ecf152d1d36d23ea0b895c15762e43d6d3ba9d5e974d8a",
+        "sea": "d22babc88d3474f034288b3c8351029b5cd2c9510c1c4e8cc090fd2efed70f6f",
+        "admin": "f0dc92888460571478b9369413724dd1001b84fb94863dd1416ce52dab65bc07"
+      }
+    },
+    {
+      "variant": 1,
+      "seconds": 8.5,
+      "selectedVariant": 1,
+      "hashes": {
+        "elevation": "e0671a7b011126360a7a0e6f296d5504488970448b5138c3b605fbd0a1fe3774",
+        "sea": "d756d0738617ca056e6c985244e097ea4c14e5c284ef1628ddca97fb5b7dd22a",
+        "admin": "a1605a14d7ac208f58158cda575594bdc0e5b5b22a7702dd913a1878be27a99b"
+      }
+    }
+  ],
+  "alternativesDiffer": true,
+  "explicitRenderRevision": true,
+  "singlePatchWorkerLifetime": true
+}
diff --git a/archive/generated-history/STEP17_WORLD_NATIVE_RESULT.json b/archive/generated-history/STEP17_WORLD_NATIVE_RESULT.json
new file mode 100644
index 0000000..a87f2b2
--- /dev/null
+++ b/archive/generated-history/STEP17_WORLD_NATIVE_RESULT.json
@@ -0,0 +1,29 @@
+{
+  "ok": true,
+  "interactiveRetryPolicy": "one requested variant per click; no hidden whole-patch retry",
+  "variants": [
+    {
+      "variant": 0,
+      "seconds": 36.31,
+      "selectedVariant": 0,
+      "hashes": {
+        "elevation": "528ea16e05aeada539dbdea076af9dd9ea7088189f10fdb0cf414e37e33902ee",
+        "sea": "c53befa66f7a2ff958c7db3465c827a481274a4e9c67d6a52ef31eb3197eb362",
+        "admin": "bdf9aa6e2e0d0526026a6e69fe3de949a626d00835347a30361b5d1a709deb70"
+      }
+    },
+    {
+      "variant": 1,
+      "seconds": 27.07,
+      "selectedVariant": 1,
+      "hashes": {
+        "elevation": "ad3a08864ca413ddebe466880032a8b3d33b48b166c5e5f10debe30c44eed4c8",
+        "sea": "295684a63f5243883c89cf9be595393cd5ce4b3714290e7efb13bae0b162f02c",
+        "admin": "1139fa28c1605224b20d99c84b06dbecdcd7d637bef10640c19a9884326c4491"
+      }
+    }
+  ],
+  "alternativesDiffer": true,
+  "explicitRenderRevision": true,
+  "singlePatchWorkerLifetime": true
+}
diff --git a/archive/generated-history/STEP4_STEP5_NOTES.md b/archive/generated-history/STEP4_STEP5_NOTES.md
new file mode 100644
index 0000000..c19aa5a
--- /dev/null
+++ b/archive/generated-history/STEP4_STEP5_NOTES.md
@@ -0,0 +1,128 @@
+# Step 4 / Step 5 実装記録
+
+## Step 4 — 道路・鉄道ポータルの必須再接続
+
+追加生成前の交通線から、パッチ境界を横断する地点を **transport portal contract** として保存するようにした。
+
+各ポータルには以下を保持する。
+
+- 境界外側の既存中心線セル
+- 境界内側の中心線セル
+- 外側から内側へ向かう進行方向
+- 元の道路・鉄道路線レイヤー
+- 近傍の旧中心線ガイド
+- 路線階層の優先度
+
+候補交通網を統合した後、ポータルごとに次の処理を行う。
+
+1. 描画中心線をセルへ高密度ラスタライズする。
+2. 外側既存ネットワークと内側生成ネットワークが、8近傍で実際に連続しているか検査する。
+3. 未接続の場合、ポータル内側の固定ゲートを通る二段階経路探索を行う。
+4. 元路線と同じレイヤーへコネクターを追加する。
+5. 追加後に再ラスタライズし、見た目上の接続が成立しなければロールバックする。
+6. 一般グラフ修復後にもう一度必須ポータルを検査する。
+
+候補内交通網が検索範囲外にある場合だけ、旧中心線の短い内向きガイドを復元する。この使用件数は `roadPortalLegacyGuideFallbacks` / `railPortalLegacyGuideFallbacks` で確認できる。
+
+### グラフ接続判定の修正
+
+従来は最大2セル離れた交通線も同一グラフ成分としていたため、内部判定では接続済みでも描画上は隙間が残ることがあった。
+
+現在は、上下左右と斜めの **8近傍で接触するセルだけ**を接続済みとして扱う。
+
+### 追加された診断値
+
+- `roadPortalsRequired`
+- `roadPortalsConnected`
+- `roadPortalsUnresolved`
+- `roadPortalConnectorsAdded`
+- `roadPortalLegacyGuideFallbacks`
+- `railPortalsRequired`
+- `railPortalsConnected`
+- `railPortalsUnresolved`
+- `railPortalConnectorsAdded`
+- `railPortalLegacyGuideFallbacks`
+- `portalPathAttempts`
+
+## Step 5 — 最終IDラスターから行政境界を単一再構築
+
+行政境界ベクトルの生成元を次の最終フィールドに限定した。
+
+- 市町村境界: `world.fields.adminId`
+- 都道府県境界: `world.fields.prefectureRegionId`
+- 外周境界: `world.fields.prefectureMask`
+
+パッチ処理後に世界全体を再走査し、以下のベクトルを再構築する。
+
+- `sourceMap.adminBorders`
+- `sourceMap.regionalPrefectureBorders`
+- `sourceMap.prefectureBorder`
+
+既存ベクトル、候補生成器の境界ベクトル、距離ベースの補完境界は統合しない。これにより、候補境界とラスター再構築境界が並行して残る経路を廃止した。
+
+### 境界階層
+
+市町村境界は、隣接セルの `adminId` が異なり、かつ `prefectureRegionId` が同じ場合だけ生成する。
+
+したがって都道府県境界上では、市町村境界を後処理で近接除去するのではなく、生成段階から出力しない。
+
+### 半セル位置ずれの修正
+
+パッチ側のラスター境界座標が初期生成より0.5セルずれていた。
+
+レンダラーが境界描画時に `-0.5` セルのオフセットを適用するため、再構築座標を初期生成と同じ `x + 1` / `y + 1` の共有セル辺座標へ統一した。
+
+### 重複境界診断
+
+連続する同一チェーンの隣接単位セグメントを「二重境界」と誤判定しないようにした。現在は次を満たす平行線だけを重複候補とする。
+
+- セグメント方向が近い
+- 投影区間が十分に重なる
+- 同一チェーンの共有端点ではない
+- 線間距離が許容範囲内
+
+市町村境界と都道府県境界の完全一致も検出対象にした。
+
+## 検証
+
+実行コマンド:
+
+```bash
+node STEP4_STEP5_VALIDATION.mjs
+```
+
+検証結果:
+
+```text
+Expansion
+  mandatory road portals: 1
+  broken road portals: 0
+  broken rail portals: 0
+  duplicate boundary pairs: 0
+
+Regeneration
+  mandatory road portals: 5
+  mandatory rail portals: 1
+  broken road portals: 0
+  broken rail portals: 0
+  duplicate boundary pairs: 0
+```
+
+検証スクリプトは、各境界セグメントについて隣接する最終IDセルを逆算し、以下を全件確認する。
+
+- 市町村境界の両側で `adminId` が異なる
+- 市町村境界の両側で `prefectureRegionId` が同じ
+- 都道府県境界の両側で `prefectureRegionId` が異なる
+- 市町村境界と都道府県境界に完全一致セグメントがない
+- 外周境界が最終 `prefectureMask` の変化位置と一致する
+- 各レイヤー内に完全重複セグメントがない
+
+Step 2 / Step 3 の検証スクリプトも再実行し、次を維持していることを確認した。
+
+- 既存生成部分の海陸反転: 0
+- 異なる生成窓での重複座標の最大標高差: 0
+- 異なる生成窓での海陸不一致: 0
+
+全JavaScript/MJSファイルは `node --check` を通過した。
+
+既存の総合 `test.js` はこの環境で長時間実行が継続し、完了確認まで行えていない。今回の合否判定には、交通ポータルと最終ID境界を直接検証する専用回帰テストを使用した。
diff --git a/archive/generated-history/STEP4_STEP5_VALIDATION.mjs b/archive/generated-history/STEP4_STEP5_VALIDATION.mjs
new file mode 100644
index 0000000..a743ca7
--- /dev/null
+++ b/archive/generated-history/STEP4_STEP5_VALIDATION.mjs
@@ -0,0 +1,181 @@
+import assert from "node:assert/strict";
+import { generateMap } from "./mapPipeline.js";
+import { MAP_H } from "./mapUtils.js";
+import { generatePatch } from "./mapPatch.js";
+import { createWorldMap } from "./worldMap.js";
+
+function stage(patch, key) {
+  return patch?.humanGeography?.patchStages?.[key];
+}
+
+function segmentKey(segment) {
+  const a = `${segment[0][0]},${segment[0][1]}`;
+  const b = `${segment[1][0]},${segment[1][1]}`;
+  return a < b ? `${a}|${b}` : `${b}|${a}`;
+}
+
+function validateUniqueSegments(segments, label) {
+  const seen = new Set();
+  for (const segment of segments || []) {
+    const key = segmentKey(segment);
+    assert(!seen.has(key), `${label} contains a duplicate segment ${key}`);
+    seen.add(key);
+  }
+  return seen;
+}
+
+function adjacentCellsForSegment(world, segment) {
+  const ax = segment[0][0] + world.originX;
+  const ay = segment[0][1] + world.originY;
+  const bx = segment[1][0] + world.originX;
+  const by = segment[1][1] + world.originY;
+  if (Math.abs(ax - bx) < 1e-6) {
+    const lineX = Math.round(ax);
+    const y = Math.floor((ay + by) * 0.5);
+    return [[lineX - 1, y], [lineX, y]];
+  }
+  if (Math.abs(ay - by) < 1e-6) {
+    const x = Math.floor((ax + bx) * 0.5);
+    const lineY = Math.round(ay);
+    return [[x, lineY - 1], [x, lineY]];
+  }
+  throw new Error(`non-axis-aligned raster boundary ${JSON.stringify(segment)}`);
+}
+
+function worldIndex(world, x, y) {
+  assert(x >= 0 && y >= 0 && x < world.width && y < world.height, `boundary cell out of world: ${x},${y}`);
+  return y * world.width + x;
+}
+
+function validateFinalIdBoundaries(world) {
+  const sourceMap = world.sourceMap;
+  const admin = world.fields.adminId;
+  const pref = world.fields.prefectureRegionId;
+  const sea = world.fields.sea;
+  const mask = world.fields.prefectureMask;
+
+  const adminKeys = validateUniqueSegments(sourceMap.adminBorders, "adminBorders");
+  const prefKeys = validateUniqueSegments(sourceMap.regionalPrefectureBorders, "regionalPrefectureBorders");
+  validateUniqueSegments(sourceMap.prefectureBorder, "prefectureBorder");
+
+  for (const segment of sourceMap.adminBorders || []) {
+    const [[ax, ay], [bx, by]] = adjacentCellsForSegment(world, segment);
+    const ai = worldIndex(world, ax, ay);
+    const bi = worldIndex(world, bx, by);
+    assert(!sea[ai] && !sea[bi], "municipal border must separate two land cells");
+    assert(mask[ai] && mask[bi], "municipal border must remain inside the final prefecture mask");
+    assert(admin[ai] >= 0 && admin[bi] >= 0 && admin[ai] !== admin[bi], "municipal border must match differing final admin IDs");
+    assert(pref[ai] >= 0 && pref[ai] === pref[bi], "municipal border must not duplicate a prefecture border");
+  }
+
+  for (const segment of sourceMap.regionalPrefectureBorders || []) {
+    const [[ax, ay], [bx, by]] = adjacentCellsForSegment(world, segment);
+    const ai = worldIndex(world, ax, ay);
+    const bi = worldIndex(world, bx, by);
+    assert(!sea[ai] && !sea[bi], "prefecture border must separate two land cells");
+    assert(mask[ai] && mask[bi], "prefecture border must remain inside the final prefecture mask");
+    assert(pref[ai] >= 0 && pref[bi] >= 0 && pref[ai] !== pref[bi], "prefecture border must match differing final prefecture IDs");
+  }
+
+  for (const key of adminKeys) assert(!prefKeys.has(key), `municipal and prefecture layers overlap at ${key}`);
+
+  for (const segment of sourceMap.prefectureBorder || []) {
+    const [[ax, ay], [bx, by]] = adjacentCellsForSegment(world, segment);
+    const ai = worldIndex(world, ax, ay);
+    const bi = worldIndex(world, bx, by);
+    assert(!sea[ai] && !sea[bi], "outer prefecture mask border must not be drawn through water");
+    assert(Boolean(mask[ai]) !== Boolean(mask[bi]), "outer prefecture border must match the final mask edge");
+  }
+
+  return {
+    adminSegments: sourceMap.adminBorders?.length || 0,
+    prefectureSegments: sourceMap.regionalPrefectureBorders?.length || 0,
+    outerMaskSegments: sourceMap.prefectureBorder?.length || 0,
+  };
+}
+
+const initial = generateMap(114514, { terrainType: "setouchi_inland_sea", onProgress() {} });
+const expansionWorld = createWorldMap(structuredClone(initial));
+const ox = expansionWorld.originX;
+const oy = expansionWorld.originY;
+const expansionSelection = {
+  kind: "lasso",
+  polygon: [
+    { x: ox - 92, y: oy + 28 },
+    { x: ox + 34, y: oy + 28 },
+    { x: ox + 34, y: oy + MAP_H - 28 },
+    { x: ox - 92, y: oy + MAP_H - 28 },
+  ],
+};
+const expansionPatch = generatePatch(expansionWorld, expansionSelection, {
+  patchMode: "auto",
+  terrainType: "setouchi_inland_sea",
+  seed: 0x1234abcd,
+  variant: 0,
+});
+assert.equal(expansionPatch.ok, true);
+assert.equal(expansionPatch.patchMode, "expansion");
+const expansionTransport = stage(expansionPatch, "transport");
+const expansionSegments = stage(expansionPatch, "segments");
+assert(expansionTransport.roadPortalsRequired > 0, "expansion fixture must contain a mandatory road portal");
+assert.equal(expansionTransport.roadPortalsUnresolved, 0, "every expansion road portal must reconnect");
+assert.equal(expansionPatch.seamDiagnostics.roadPortalsBroken, 0, "rendered expansion road portals must be connected");
+assert.equal(expansionPatch.seamDiagnostics.railPortalsBroken, 0, "rendered expansion rail portals must be connected");
+assert.equal(expansionSegments.boundarySource, "final-id-rasters");
+assert.equal(expansionSegments.globalBoundaryRebuild, true);
+assert.equal(expansionSegments.candidateAdminBordersMerged, 0);
+assert.equal(expansionSegments.candidatePrefectureBordersMerged, 0);
+assert.equal(expansionPatch.seamDiagnostics.duplicateBoundaryPairs, 0, "final-raster boundary rebuild must not leave seam twins");
+const expansionBoundaryCounts = validateFinalIdBoundaries(expansionWorld);
+
+const regenerationWorld = createWorldMap(structuredClone(initial));
+const regenerationSelection = {
+  x0: regenerationWorld.originX + 70,
+  y0: regenerationWorld.originY + 40,
+  x1: regenerationWorld.originX + 190,
+  y1: regenerationWorld.originY + 150,
+};
+const regenerationPatch = generatePatch(regenerationWorld, regenerationSelection, {
+  patchMode: "regeneration",
+  terrainType: "setouchi_inland_sea",
+  seed: 0x7412abce,
+  variant: 1,
+});
+assert.equal(regenerationPatch.ok, true);
+assert.equal(regenerationPatch.patchMode, "regeneration");
+const regenerationTransport = stage(regenerationPatch, "transport");
+const regenerationSegments = stage(regenerationPatch, "segments");
+assert(regenerationTransport.roadPortalsRequired > 0, "regeneration fixture must contain road portals");
+assert(regenerationTransport.railPortalsRequired > 0, "regeneration fixture must contain a rail portal");
+assert.equal(regenerationTransport.roadPortalsUnresolved, 0, "every regeneration road portal must reconnect");
+assert.equal(regenerationTransport.railPortalsUnresolved, 0, "every regeneration rail portal must reconnect");
+assert.equal(regenerationPatch.seamDiagnostics.roadPortalsBroken, 0);
+assert.equal(regenerationPatch.seamDiagnostics.railPortalsBroken, 0);
+assert.equal(regenerationPatch.seamDiagnostics.duplicateBoundaryPairs, 0);
+assert.equal(regenerationSegments.boundarySource, "final-id-rasters");
+assert.equal(regenerationSegments.candidateAdminBordersMerged, 0);
+assert.equal(regenerationSegments.candidatePrefectureBordersMerged, 0);
+const regenerationBoundaryCounts = validateFinalIdBoundaries(regenerationWorld);
+
+console.log(JSON.stringify({
+  ok: true,
+  expansion: {
+    roadPortals: expansionTransport.roadPortalsRequired,
+    roadPortalConnectors: expansionTransport.roadPortalConnectorsAdded,
+    railPortals: expansionTransport.railPortalsRequired,
+    brokenRoadPortals: expansionPatch.seamDiagnostics.roadPortalsBroken,
+    brokenRailPortals: expansionPatch.seamDiagnostics.railPortalsBroken,
+    duplicateBoundaryPairs: expansionPatch.seamDiagnostics.duplicateBoundaryPairs,
+    boundaries: expansionBoundaryCounts,
+  },
+  regeneration: {
+    roadPortals: regenerationTransport.roadPortalsRequired,
+    roadPortalConnectors: regenerationTransport.roadPortalConnectorsAdded,
+    railPortals: regenerationTransport.railPortalsRequired,
+    railPortalConnectors: regenerationTransport.railPortalConnectorsAdded,
+    brokenRoadPortals: regenerationPatch.seamDiagnostics.roadPortalsBroken,
+    brokenRailPortals: regenerationPatch.seamDiagnostics.railPortalsBroken,
+    duplicateBoundaryPairs: regenerationPatch.seamDiagnostics.duplicateBoundaryPairs,
+    boundaries: regenerationBoundaryCounts,
+  },
+}, null, 2));
diff --git a/archive/generated-history/STEP6_NOTES.md b/archive/generated-history/STEP6_NOTES.md
new file mode 100644
index 0000000..e84bb8f
--- /dev/null
+++ b/archive/generated-history/STEP6_NOTES.md
@@ -0,0 +1,207 @@
+# Step 6 実装・検証記録
+
+## 目的
+
+通常の領域拡張で、初期生成とできるだけ同等の地形・集落・行政・交通品質を得る。特に、次の失敗を候補確定前に排除する。
+
+- 追加範囲のほぼ全域が意図せず海になる
+- 陸地はあるが、連結性や開発可能地が乏しい
+- 地名・町村・行政中心・交通網の密度が初期生成に比べて著しく低い
+- 海岸シーム補正によって、良好な候補地形が結合時に水没する
+
+## 実装概要
+
+### 1. 通常Expansionを初期生成と同じ本番パイプラインへ統合
+
+通常のExpansionは、Step 3の簡易な絶対座標矩形地形を最終候補として使わず、初期生成と同じ本番地形生成器を使用する。
+
+選定済み地形は `terrainOverride` として以下の既存本番工程へ渡される。
+
+1. 地理・水系
+2. 集落・都市・土地利用
+3. 市町村・都道府県
+4. 道路・鉄道
+5. 出力・後処理
+
+診断上の生成モードは次の値になる。
+
+```text
+expansion-production-quality-selected
+```
+
+`productionPipelineParity: true` は、選定された候補が初期生成と同じ人文・行政・交通パイプラインを通過したことを示す。
+
+### 2. 二段階の品質選択
+
+Expansionごとに、指定variantから連続する6候補の本番地形を生成し、まず地形だけを高速評価する。
+
+地形評価項目:
+
+- 陸地率
+- 開発可能地率
+- 最大連結陸地率
+- 既存陸地とのフロンティア接続率
+- 海岸線複雑度
+- 地形テンプレートごとの許容陸地率
+
+地形上位2候補について本番フルパイプラインを実行し、次を追加評価する。
+
+- 町村・市場・都市・港・行政中心の数
+- 初期生成に対する地名密度・集落密度
+- 道路・鉄道路線の存在
+- 地形品質と人文品質の総合点
+
+上位2候補がどちらも人文品質基準を満たさない場合だけ、第3候補のフル生成を実行する。
+
+### 3. 地形テンプレート別の品質基準
+
+地形タイプに応じて陸地率等の基準を変える。
+
+- `mixed_archipelago`
+- `setouchi_inland_sea`
+- `kanto_alluvial`
+- `chubu_mountain`
+- `tohoku_spine`
+- `oceanic_archipelago`
+
+明示的な `oceanic_archipelago` だけは、大部分が海である候補を仕様として許可する。通常の `auto` では、海洋専用テンプレートを自動選択対象にしない既存仕様を維持する。
+
+### 4. 結合後の再検査
+
+候補単体で合格しても、シーム結合後に品質が崩れる可能性があるため、最終ワールド上でも再検査する。
+
+- 高所有率の新規内部セルにおける陸地率
+- 最終的に残った地名数
+- 最終的に残った集落数
+- 人文密度の最低値
+
+候補単体と結合後の双方が合格した場合だけ、`candidateQuality.hardPass` が真になる。
+
+### 5. 海岸シーム補正の局所化
+
+従来の標高アフィン補正は、既存側に地形を合わせるためのオフセットと傾きを追加範囲全体へ適用していた。このため、候補段階で十分な陸地があっても、結合時に広域が海面下へ落ちる場合があった。
+
+Step 6では次のように変更した。
+
+- 世界海面高への基準オフセットは全域へ適用
+- 既存地形へ合わせる追加オフセット・傾きは、生成済み領域とのフロンティア近傍だけへ適用
+- 新規領域の内部へ進むほど補正を減衰
+- Expansionの補正上限をRegenerationより小さく制限
+
+これにより、シームの連続性を保ちながら、新規内部では本番地形の陸地統計を維持する。
+
+## UI・診断
+
+Seam diagnosticsに以下を追加した。
+
+- Step 6品質ゲートの合否
+- 総合品質スコア
+- 選定された内部variant
+- 候補陸地率
+- 開発可能地率
+- 最大連結陸地率
+- 候補地名・集落密度
+- 結合後の高所有率内部陸地率
+- 結合後の地名・集落数
+
+品質基準を完全には満たさない候補しか得られなかった場合は、最良候補を使用しつつ警告を記録する。
+
+## 専用回帰テスト
+
+実行:
+
+```bash
+node STEP6_VALIDATION.mjs
+```
+
+### 瀬戸内型Expansion
+
+```text
+terrain type: setouchi_inland_sea
+terrain attempts: 6
+full production attempts: 2
+selected variant: 4
+candidate land ratio: 0.5121
+candidate developable ratio: 0.8038
+candidate largest component ratio: 0.5153
+candidate labels: 82
+candidate settlements: 38
+final owned-interior land ratio: 0.4626
+final labels: 77
+final settlements: 40
+quality score: 0.9513
+quality gate: PASS
+```
+
+### Auto Expansion
+
+```text
+selected terrain type: mixed_archipelago
+terrain attempts: 6
+full production attempts: 2
+selected variant: 0
+candidate land ratio: 0.7398
+candidate developable ratio: 0.7126
+candidate largest component ratio: 0.7084
+candidate labels: 67
+candidate settlements: 27
+final owned-interior land ratio: 0.6907
+final labels: 68
+final settlements: 27
+quality score: 0.9667
+quality gate: PASS
+```
+
+両ケースで以下も確認した。
+
+- 道路ポータル切断: 0
+- 鉄道ポータル切断: 0
+- 二重行政境界候補: 0
+
+## Step 4 / Step 5回帰
+
+既存の交通ポータル・最終ID境界テストを再実行した。
+
+```text
+Expansion
+  mandatory road portals: 1
+  broken road portals: 0
+  broken rail portals: 0
+  duplicate boundary pairs: 0
+
+Regeneration
+  mandatory road portals: 5
+  mandatory rail portals: 1
+  broken road portals: 0
+  broken rail portals: 0
+  duplicate boundary pairs: 0
+```
+
+全JavaScript/MJSファイルは `node --check` を通過した。
+
+## 制約と設計上の変更
+
+Step 3で導入した絶対座標矩形地形は、同じ絶対座標に対する窓サイズ非依存性を持っていた。Step 6の通常Expansionは品質を優先し、初期生成と同じ本番地形候補を選ぶ方式へ変更したため、候補の地形そのものについて厳密な窓サイズ不変性は保証しない。
+
+代わりに、次で既存世界との整合性を維持する。
+
+- 世界共通海面高
+- 双方向オーバーラップ
+- 海陸・標高の境界契約
+- 交通ポータル
+- 最終IDからの行政境界再構築
+- 結合後品質検査
+
+また、品質選択のため通常Expansionの処理時間は増える。標準ケースでは地形候補6回とフル生成2回を行い、候補不良時だけフル生成3回目を実行する。
+
+## 既存総合テストとの比較
+
+`node test.js` をStep 4 / Step 5基準版とStep 6版の双方で実行した。
+
+```text
+Step 4 / Step 5基準版: 47 failures
+Step 6版:              47 failures
+差分:                  0
+```
+
+Step 6導入時に、旧モード名 `expansion-full-pipeline-stable-terrain` を直接検索していたソース検査1件だけを、新しい `expansion-production-quality-selected` と `prepareProductionTerrain` を確認する検査へ更新した。それ以外の失敗項目は基準版と完全に一致しており、Step 6による総合テスト上の追加失敗はない。
diff --git a/archive/generated-history/STEP6_VALIDATION.mjs b/archive/generated-history/STEP6_VALIDATION.mjs
new file mode 100644
index 0000000..5cce5ac
--- /dev/null
+++ b/archive/generated-history/STEP6_VALIDATION.mjs
@@ -0,0 +1,123 @@
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { generateMap } from "./mapPipeline.js";
+import { generatePatch } from "./mapPatch.js";
+import { createWorldMap } from "./worldMap.js";
+import { MAP_H } from "./mapUtils.js";
+
+function westExpansion(world, leftReach, oldSideReach, topPad, bottomPad) {
+  const ox = world.originX;
+  const oy = world.originY;
+  return {
+    kind: "lasso",
+    polygon: [
+      { x: ox - leftReach, y: oy - topPad },
+      { x: ox + oldSideReach, y: oy - topPad },
+      { x: ox + oldSideReach, y: oy + MAP_H + bottomPad },
+      { x: ox - leftReach, y: oy + MAP_H + bottomPad },
+    ],
+  };
+}
+
+function validateQualityPatch(patch, label) {
+  assert.equal(patch.ok, true, `${label}: patch must succeed`);
+  assert.equal(patch.patchMode, "expansion", `${label}: fixture must resolve to expansion`);
+  assert.equal(patch.patchGenerationMode, "expansion-production-quality-selected", `${label}: Step 6 production mode must be active`);
+  assert.equal(patch.productionPipelineParity, true, `${label}: production pipeline parity flag must be set`);
+  const quality = patch.candidateQuality;
+  assert(quality, `${label}: quality diagnostics must exist`);
+  assert.equal(quality.policyVersion, "step6-production-parity-v1");
+  assert.equal(quality.productionPipelineParity, true);
+  assert(quality.terrainAttempts.length >= 6, `${label}: terrain search must inspect all configured attempts`);
+  assert(quality.fullAttempts.length >= 2, `${label}: at least two complete production candidates must be compared`);
+  assert.equal(quality.preMergeHardPass, true, `${label}: selected production candidate must pass before merge`);
+  assert.equal(quality.final?.hardPass, true, `${label}: merged patch must pass final quality verification`);
+  assert.equal(quality.hardPass, true, `${label}: combined Step 6 quality gate must pass`);
+  assert(quality.final.ownedLandRatio >= quality.final.landFloor, `${label}: owned interior must retain enough land`);
+  assert(quality.final.labelCount >= quality.final.minFinalLabels, `${label}: final label floor must be met`);
+  assert(quality.final.settlementCount >= quality.final.minFinalSettlements, `${label}: final settlement floor must be met`);
+  assert.equal(patch.seamDiagnostics.roadPortalsBroken, 0, `${label}: road portals must remain connected`);
+  assert.equal(patch.seamDiagnostics.railPortalsBroken, 0, `${label}: rail portals must remain connected`);
+  assert.equal(patch.seamDiagnostics.duplicateBoundaryPairs, 0, `${label}: no duplicate administrative boundary pairs`);
+  return {
+    terrainType: quality.terrain.terrainType,
+    selectedVariant: quality.selectedVariant,
+    terrainAttempts: quality.terrainAttempts.length,
+    fullAttempts: quality.fullAttempts.length,
+    candidateLandRatio: quality.terrain.landRatio,
+    candidateDevelopableRatio: quality.terrain.developableRatio,
+    candidateLargestComponentRatio: quality.terrain.largestComponentRatio,
+    candidateLabels: quality.human.labelCount,
+    candidateSettlements: quality.human.settlementCount,
+    finalOwnedLandRatio: quality.final.ownedLandRatio,
+    finalLabels: quality.final.labelCount,
+    finalSettlements: quality.final.settlementCount,
+    score: quality.score,
+    seaRatio: patch.seaRatio,
+  };
+}
+
+function runSetouchi() {
+  const initial = generateMap(114514, { terrainType: "setouchi_inland_sea", onProgress() {} });
+  const world = createWorldMap(structuredClone(initial));
+  const patch = generatePatch(world, westExpansion(world, 150, 10, 20, 20), {
+    patchMode: "expansion",
+    terrainType: "setouchi_inland_sea",
+    seed: 0x1234abcd,
+    variant: 0,
+  });
+  const result = validateQualityPatch(patch, "setouchi");
+  assert(result.candidateLandRatio >= 0.22 && result.candidateLandRatio <= 0.82, "setouchi: candidate must satisfy template land interval");
+  assert(result.finalOwnedLandRatio >= 0.20, "setouchi: generated interior must not collapse into open ocean");
+  return result;
+}
+
+function runAuto() {
+  const initial = generateMap(24681357, { terrainType: "auto", onProgress() {} });
+  const world = createWorldMap(structuredClone(initial));
+  const patch = generatePatch(world, westExpansion(world, 170, 5, 15, 18), {
+    patchMode: "expansion",
+    terrainType: "auto",
+    seed: 0x11111111,
+    variant: 0,
+  });
+  const result = validateQualityPatch(patch, "auto");
+  assert.notEqual(result.terrainType, "oceanic_archipelago", "auto: manual ocean-only template must not be selected");
+  assert(result.finalOwnedLandRatio >= 0.32, "auto: owned interior must contain a substantial landmass");
+  assert(result.finalLabels >= 12, "auto: final generated area must not be label-sparse");
+  assert(result.finalSettlements >= 6, "auto: final generated area must not be settlement-sparse");
+  return result;
+}
+
+const scenario = process.argv[2] || "all";
+if (scenario === "setouchi") {
+  console.log(JSON.stringify(runSetouchi()));
+} else if (scenario === "auto") {
+  console.log(JSON.stringify(runAuto()));
+} else {
+  // Isolate the two large generation fixtures in child processes. Keeping both
+  // complete worlds in one process can exceed browser-like memory budgets and
+  // is unrelated to the behavior under test.
+  const script = fileURLToPath(import.meta.url);
+  const runChild = (name) => {
+    const child = spawnSync(process.execPath, [script, name], {
+      cwd: process.cwd(),
+      encoding: "utf8",
+      maxBuffer: 4 * 1024 * 1024,
+    });
+    if (child.status !== 0) {
+      process.stderr.write(child.stderr || child.stdout || `${name} validation failed\n`);
+      process.exit(child.status || 1);
+    }
+    return JSON.parse(child.stdout.trim());
+  };
+  const setouchi = runChild("setouchi");
+  const auto = runChild("auto");
+  console.log(JSON.stringify({
+    ok: true,
+    policy: "step6-production-parity-v1",
+    setouchi,
+    auto,
+  }, null, 2));
+}
diff --git a/archive/generated-history/STEP7_NOTES.md b/archive/generated-history/STEP7_NOTES.md
new file mode 100644
index 0000000..6d70079
--- /dev/null
+++ b/archive/generated-history/STEP7_NOTES.md
@@ -0,0 +1,145 @@
+# Step 7 実装・検証記録
+
+## 対象
+
+Step 6 の生成結果で確認された次の問題を修正した。
+
+1. 追加生成が 20～30 秒以上かかる
+2. 海岸・道路・行政形状がラッソ外周に追従する
+3. 既存の都道府県名が `県域N` に置き換わる、または既存領域の行政境界が広く消える
+
+## 1. 追加生成の高速化
+
+Step 6 は地形候補を 6 件作り、完全な初期生成パイプラインを通常 2 件、条件次第で 3 件実行していた。人文地理・行政・交通の全段階を複数回実行することが主要な遅延原因だった。
+
+Step 7 では次の構成へ変更した。
+
+- 軽量な本番地形候補: 2 件を基本、両方が不合格の場合のみ 3 件目
+- 完全な初期生成パイプライン: 最良地形に対して 1 回だけ
+- 最終的な海陸率、地名密度、集落密度、交通・境界品質の検査は維持
+- 候補キャッシュは従来どおり使用
+
+生成モードは次に変更した。
+
+```text
+expansion-production-fast-natural
+```
+
+品質ポリシーは次の識別子を使用する。
+
+```text
+step7-fast-natural-expansion-v1
+```
+
+### 計測結果
+
+`STEP7_VALIDATION.mjs` による追加生成部分だけの実測値:
+
+| ケース | 地形候補 | 完全候補 | 追加生成時間 |
+|---|---:|---:|---:|
+| 瀬戸内海型 | 2 | 1 | 6.08 秒 |
+| Auto | 2 | 1 | 8.19 秒 |
+
+実行環境の負荷により変動するが、検証ケースでは両方とも 10 秒以内だった。初期マップ生成時間は上記に含まない。
+
+## 2. ラッソ外周への追従を抑制
+
+### 仮想拡大フレーム
+
+初期生成器はマップ外周を海へ落とす設計を含む。Step 6 では候補マップの外周が追加選択範囲の外周付近へ写像されるため、海岸がラッソ形状に沿いやすかった。
+
+Step 7 では追加生成候補を、1.55 倍の仮想本番マップから切り出した中央クロップとして生成する。これにより、初期生成器の意図的な「マップ端の海」がラッソ端へ直接現れない。
+
+- 地形ノイズは従来どおり絶対ワールド座標を使用
+- 海岸・山系に使用する正規化座標だけを仮想拡大フレームへ変換
+- 候補ごとに小さな決定論的フレームオフセットを使用
+
+### 外周フェザー
+
+ラッソ外周のアルファを、数セル幅の均一な内向きフェザーから、広域・中域・詳細のワールド座標ノイズを合成した不規則な深度へ変更した。これにより、海岸や土地利用境界が選択線と平行に続く傾向を弱める。
+
+### 外部交通の抑制
+
+初期生成向けの次の候補レイヤーは、追加生成では取り込まない。
+
+- `externalGateways`
+- `externalRoads`
+- `externalRailways`
+- `externalExpressways`
+
+これらは本来、初期マップの画面外接続を表すため、追加領域へ移植すると道路・鉄道がラッソ上端・下端へ直進する原因になる。既存マップとの接続は Step 4 の交通ポータルで保証する。
+
+検証では、生成された交通線の端点が旧世界との実シームではない外周 4 セル以内に現れた数は、瀬戸内海型で 1、Auto で 0 だった。
+
+## 3. 行政名と既存境界の保護
+
+### 既存行政フィールドの復元
+
+Expansion でも修復領域内の次のフィールドだけを軽量スナップショットするよう変更した。
+
+- `adminId`
+- `municipalityId`
+- `prefectureRegionId`
+- `prefectureMask`
+
+パッチアルファが 0 の旧領域は行政トポロジー整理後に復元する。これにより、修復矩形が既存領域へ広がっても、選択外の県・市町村IDが統合・消去されない。
+
+### 行政名のID固定
+
+パッチ前の `adminCenters` と `prefectureRegions` をID別に保存し、整合化後も同じIDには元の名称を戻す。ラベル位置が再計算されても名称は維持される。
+
+新規候補については、最終IDラスター内に存在する行政IDに対応する候補メタデータを、候補ラベル点が選択範囲外にあっても補完する。これにより `県域N` へのフォールバックを防止する。
+
+### 境界再構築範囲
+
+Step 5 の境界再構築は `prefectureMask` 内だけを対象にしていたため、周辺県の境界が消えていた。Step 7 では次の正本から世界全体の陸上境界を再構築する。
+
+- 市町村境界: 最終 `adminId` の差、かつ同一 `prefectureRegionId`
+- 都道府県境界: 最終 `prefectureRegionId` の差
+- 対象範囲: 海以外の全セル
+
+`prefectureMask` は注目県の外周レイヤーにだけ引き続き使用する。
+
+## 検証
+
+実行:
+
+```bash
+node STEP7_VALIDATION.mjs
+```
+
+最終確認結果:
+
+```text
+setouchi
+  expansion: 6.08 s
+  terrain attempts: 2
+  full attempts: 1
+  old prefecture names preserved: 3
+  generic prefecture names: 0
+  outer-edge transport endpoints: 1
+
+auto
+  expansion: 8.19 s
+  terrain attempts: 2
+  full attempts: 1
+  old prefecture names preserved: 3
+  generic prefecture names: 0
+  outer-edge transport endpoints: 0
+```
+
+両ケースで以下を確認した。
+
+- 最終品質ゲート: PASS
+- 道路ポータル切断: 0
+- 鉄道ポータル切断: 0
+- 二重行政境界: 0
+- 既存都道府県名の変更・消失: 0
+- `県域N` フォールバック: 0
+- 市町村境界ベクトルが全陸上の最終ID差分と完全一致
+- 都道府県境界ベクトルが全陸上の最終ID差分と完全一致
+- 追加候補由来の外部道路・外部鉄道・外部高速道路・外部ゲートウェイ: 0
+
+全 JavaScript / MJS ファイルは `node --check` を通過した。
+
+既存の総合 `test.js` はこの実行環境で 180 秒以内に完了しなかったため、総合スイート完走は確認できていない。Step 7 専用回帰テストは完走している。
diff --git a/archive/generated-history/STEP7_VALIDATION.mjs b/archive/generated-history/STEP7_VALIDATION.mjs
new file mode 100644
index 0000000..ef9760c
--- /dev/null
+++ b/archive/generated-history/STEP7_VALIDATION.mjs
@@ -0,0 +1,181 @@
+import assert from "node:assert/strict";
+import { performance } from "node:perf_hooks";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { generateMap } from "./mapPipeline.js";
+import { generatePatch } from "./mapPatch.js";
+import { createWorldMap } from "./worldMap.js";
+import { MAP_H } from "./mapUtils.js";
+
+function westExpansion(world, leftReach, oldSideReach, topPad, bottomPad) {
+  const ox = world.originX;
+  const oy = world.originY;
+  return {
+    kind: "lasso",
+    polygon: [
+      { x: ox - leftReach, y: oy - topPad },
+      { x: ox + oldSideReach, y: oy - topPad },
+      { x: ox + oldSideReach, y: oy + MAP_H + bottomPad },
+      { x: ox - leftReach, y: oy + MAP_H + bottomPad },
+    ],
+  };
+}
+
+function pointId(point) {
+  if (Number.isFinite(point?.prefectureRegionId)) return Math.floor(point.prefectureRegionId);
+  if (Number.isFinite(point?.id)) return Math.floor(point.id);
+  return -1;
+}
+
+function pointName(point) {
+  return point?.name || point?.labelName || point?.prefectureName || point?.prefectureRegionName || point?.regionName || "";
+}
+
+function segmentKey(x0, y0, x1, y1) {
+  const a = `${x0},${y0}`;
+  const b = `${x1},${y1}`;
+  return a < b ? `${a}|${b}` : `${b}|${a}`;
+}
+
+function vectorSegmentSet(world, segments) {
+  const out = new Set();
+  for (const seg of segments || []) {
+    if (!Array.isArray(seg) || seg.length < 2) continue;
+    const x0 = Math.round(seg[0][0] + world.originX);
+    const y0 = Math.round(seg[0][1] + world.originY);
+    const x1 = Math.round(seg[1][0] + world.originX);
+    const y1 = Math.round(seg[1][1] + world.originY);
+    out.add(segmentKey(x0, y0, x1, y1));
+  }
+  return out;
+}
+
+function expectedBoundarySets(world) {
+  const sea = world.fields.sea;
+  const admin = world.fields.adminId;
+  const pref = world.fields.prefectureRegionId;
+  const municipal = new Set();
+  const prefecture = new Set();
+  for (let y = 0; y < world.height; y++) {
+    for (let x = 0; x < world.width; x++) {
+      const i = y * world.width + x;
+      if (sea?.[i]) continue;
+      if (x + 1 < world.width) {
+        const j = i + 1;
+        if (!sea?.[j]) {
+          if (pref?.[i] >= 0 && pref?.[j] >= 0 && pref[i] !== pref[j]) prefecture.add(segmentKey(x + 1, y, x + 1, y + 1));
+          if (admin?.[i] >= 0 && admin?.[j] >= 0 && admin[i] !== admin[j] && pref?.[i] >= 0 && pref[i] === pref[j]) municipal.add(segmentKey(x + 1, y, x + 1, y + 1));
+        }
+      }
+      if (y + 1 < world.height) {
+        const j = i + world.width;
+        if (!sea?.[j]) {
+          if (pref?.[i] >= 0 && pref?.[j] >= 0 && pref[i] !== pref[j]) prefecture.add(segmentKey(x, y + 1, x + 1, y + 1));
+          if (admin?.[i] >= 0 && admin?.[j] >= 0 && admin[i] !== admin[j] && pref?.[i] >= 0 && pref[i] === pref[j]) municipal.add(segmentKey(x, y + 1, x + 1, y + 1));
+        }
+      }
+    }
+  }
+  return { municipal, prefecture };
+}
+
+function generatedOuterEdgeEndpoints(world, patch) {
+  const r = patch.rects.coreRect;
+  const keys = ["premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "expressways", "icAccessRoads", "railways", "branchRailways"];
+  let count = 0;
+  for (const key of keys) {
+    for (const path of world.sourceMap[key] || []) {
+      if (!path?.patchGenerated || path.length < 2) continue;
+      for (const tuple of [path[0], path[path.length - 1]]) {
+        const x = tuple[0] + world.originX;
+        const y = tuple[1] + world.originY;
+        // Right is the real old/new seam. Only top, bottom, and outer-left are
+        // synthetic selection edges and should not attract transport gateways.
+        const d = Math.min(Math.abs(x - r.x0), Math.abs(y - r.y0), Math.abs(y - (r.y1 - 1)));
+        if (d <= 4) count++;
+      }
+    }
+  }
+  return count;
+}
+
+function validateScenario({ initialSeed, terrainType, patchSeed, leftReach, oldSideReach, topPad, bottomPad }) {
+  const initial = generateMap(initialSeed, { terrainType, onProgress() {} });
+  const oldNames = new Map((initial.prefectureRegions || []).map((p) => [pointId(p), pointName(p)]).filter(([id]) => id >= 0));
+  const world = createWorldMap(structuredClone(initial));
+  const selection = westExpansion(world, leftReach, oldSideReach, topPad, bottomPad);
+  const t0 = performance.now();
+  const patch = generatePatch(world, selection, {
+    patchMode: "expansion",
+    terrainType,
+    seed: patchSeed,
+    variant: 0,
+  });
+  const seconds = (performance.now() - t0) / 1000;
+
+  assert.equal(patch.ok, true);
+  assert.equal(patch.patchGenerationMode, "expansion-production-fast-natural");
+  assert(seconds < 12, `expansion took ${seconds.toFixed(2)} s; expected browser-scale completion near 10 s`);
+  assert.equal(patch.candidateQuality?.policyVersion, "step7-fast-natural-expansion-v1");
+  assert.equal(patch.candidateQuality?.fastPath, true);
+  assert(patch.candidateQuality.terrainAttempts.length >= 2 && patch.candidateQuality.terrainAttempts.length <= 3);
+  assert.equal(patch.candidateQuality.fullAttempts.length, 1);
+  assert(patch.candidateQuality.terrainFrameScale >= 1.4);
+  assert.equal(patch.candidateQuality.final?.hardPass, true);
+  assert.equal(patch.seamDiagnostics.roadPortalsBroken, 0);
+  assert.equal(patch.seamDiagnostics.railPortalsBroken, 0);
+  assert.equal(patch.seamDiagnostics.duplicateBoundaryPairs, 0);
+
+  const currentNames = new Map((world.sourceMap.prefectureRegions || []).map((p) => [pointId(p), pointName(p)]).filter(([id]) => id >= 0));
+  for (const [id, name] of oldNames) assert.equal(currentNames.get(id), name, `old prefecture name ${id} changed or disappeared`);
+  const genericNames = [...currentNames.values()].filter((name) => /^県域\d+$/.test(String(name)));
+  assert.deepEqual(genericNames, [], "candidate prefecture metadata should prevent generic 県域 fallback names");
+
+  const expected = expectedBoundarySets(world);
+  const actualMunicipal = vectorSegmentSet(world, world.sourceMap.adminBorders);
+  const actualPrefecture = vectorSegmentSet(world, world.sourceMap.regionalPrefectureBorders);
+  assert.deepEqual(actualMunicipal, expected.municipal, "municipal vectors must cover all final land IDs, not only prefectureMask");
+  assert.deepEqual(actualPrefecture, expected.prefecture, "prefecture vectors must cover all final land IDs, including old map areas outside the patch");
+
+  for (const key of ["externalRoads", "externalRailways", "externalExpressways", "externalGateways"]) {
+    assert.equal((world.sourceMap[key] || []).filter((item) => item?.patchGenerated).length, 0, `${key} must not be imported from the synthetic candidate perimeter`);
+  }
+  const outerEdgeEndpoints = generatedOuterEdgeEndpoints(world, patch);
+  assert(outerEdgeEndpoints <= 4, `too many generated transport endpoints follow the synthetic lasso edge: ${outerEdgeEndpoints}`);
+
+  return {
+    terrainType,
+    seconds: Math.round(seconds * 100) / 100,
+    terrainAttempts: patch.candidateQuality.terrainAttempts.length,
+    fullAttempts: patch.candidateQuality.fullAttempts.length,
+    selectedVariant: patch.candidateQuality.selectedVariant,
+    finalOwnedLandRatio: patch.candidateQuality.final.ownedLandRatio,
+    finalLabels: patch.candidateQuality.final.labelCount,
+    oldPrefectureNamesPreserved: oldNames.size,
+    genericPrefectureNames: genericNames.length,
+    municipalBoundarySegments: actualMunicipal.size,
+    prefectureBoundarySegments: actualPrefecture.size,
+    outerEdgeTransportEndpoints: outerEdgeEndpoints,
+  };
+}
+
+const scenario = process.argv[2] || "all";
+const cases = {
+  setouchi: { initialSeed: 114514, terrainType: "setouchi_inland_sea", patchSeed: 0x1234abcd, leftReach: 150, oldSideReach: 10, topPad: 20, bottomPad: 20 },
+  auto: { initialSeed: 24681357, terrainType: "auto", patchSeed: 0x11111111, leftReach: 170, oldSideReach: 5, topPad: 15, bottomPad: 18 },
+};
+
+if (scenario !== "all") {
+  console.log(JSON.stringify(validateScenario(cases[scenario]), null, 2));
+} else {
+  const script = fileURLToPath(import.meta.url);
+  const runChild = (name) => {
+    const child = spawnSync(process.execPath, [script, name], { cwd: process.cwd(), encoding: "utf8", maxBuffer: 8 * 1024 * 1024 });
+    if (child.status !== 0) {
+      process.stderr.write(child.stderr || child.stdout || `${name} failed\n`);
+      process.exit(child.status || 1);
+    }
+    return JSON.parse(child.stdout.trim());
+  };
+  console.log(JSON.stringify({ ok: true, policy: "step7-fast-natural-expansion-v1", setouchi: runChild("setouchi"), auto: runChild("auto") }, null, 2));
+}
diff --git a/archive/generated-history/STEP7_VALIDATION_RESULT.json b/archive/generated-history/STEP7_VALIDATION_RESULT.json
new file mode 100644
index 0000000..08a1c79
--- /dev/null
+++ b/archive/generated-history/STEP7_VALIDATION_RESULT.json
@@ -0,0 +1,32 @@
+{
+  "ok": true,
+  "policy": "step7-fast-natural-expansion-v1",
+  "setouchi": {
+    "terrainType": "setouchi_inland_sea",
+    "seconds": 6.08,
+    "terrainAttempts": 2,
+    "fullAttempts": 1,
+    "selectedVariant": 1,
+    "finalOwnedLandRatio": 0.1904959144481681,
+    "finalLabels": 47,
+    "oldPrefectureNamesPreserved": 3,
+    "genericPrefectureNames": 0,
+    "municipalBoundarySegments": 2767,
+    "prefectureBoundarySegments": 67,
+    "outerEdgeTransportEndpoints": 1
+  },
+  "auto": {
+    "terrainType": "auto",
+    "seconds": 8.19,
+    "terrainAttempts": 2,
+    "fullAttempts": 1,
+    "selectedVariant": 0,
+    "finalOwnedLandRatio": 0.6075206069005763,
+    "finalLabels": 69,
+    "oldPrefectureNamesPreserved": 3,
+    "genericPrefectureNames": 0,
+    "municipalBoundarySegments": 5048,
+    "prefectureBoundarySegments": 1307,
+    "outerEdgeTransportEndpoints": 0
+  }
+}
diff --git a/archive/generated-history/UI_STATE_WORLD_NATIVE_RESULT.json b/archive/generated-history/UI_STATE_WORLD_NATIVE_RESULT.json
new file mode 100644
index 0000000..f2f9598
--- /dev/null
+++ b/archive/generated-history/UI_STATE_WORLD_NATIVE_RESULT.json
@@ -0,0 +1,7 @@
+{
+  "ok": true,
+  "cancelButton": true,
+  "watchdogSeconds": 60,
+  "escapeCancelsBusy": true,
+  "clearDiscardsPendingPreview": true
+}
diff --git a/archive/generated-history/VALIDATE_ADMIN_RIVER_LOCALITY.mjs b/archive/generated-history/VALIDATE_ADMIN_RIVER_LOCALITY.mjs
new file mode 100644
index 0000000..5d48bc6
--- /dev/null
+++ b/archive/generated-history/VALIDATE_ADMIN_RIVER_LOCALITY.mjs
@@ -0,0 +1,61 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_W, MAP_H } from './mapUtils.js';
+
+function worldPoint(world, p) {
+  return { x: Math.round((p?.x || 0) + (world.originX || 0)), y: Math.round((p?.y || 0) + (world.originY || 0)) };
+}
+function idx(world,x,y){ return x>=0&&y>=0&&x<world.width&&y<world.height ? y*world.width+x : -1; }
+function capitalAudit(world) {
+  const pref=world.fields.prefectureRegionId, sea=world.fields.sea;
+  const active=new Set();
+  for(let i=0;i<pref.length;i++) if(!sea[i]&&pref[i]>=0) active.add(Math.floor(pref[i]));
+  const counts=new Map([...active].map(id=>[id,0]));
+  for(const city of world.sourceMap.modernCities||[]) {
+    const cap=city.isPrefecturalCapital||city.isRegionalCapital||/Capital/i.test(String(city.rank||''))||/Capital/i.test(String(city.kind||''));
+    if(!cap) continue;
+    const p=worldPoint(world,city), i=idx(world,p.x,p.y); if(i<0||sea[i]||pref[i]<0) continue;
+    const id=Math.floor(pref[i]); counts.set(id,(counts.get(id)||0)+1);
+  }
+  return { active:[...active], zero:[...counts].filter(([,n])=>n===0), duplicate:[...counts].filter(([,n])=>n>1) };
+}
+function riverSeaPointsOutsideRect(world, rect) {
+  const sea=world.fields.sea; const out=[];
+  for(const key of ['rivers','riverPaths','majorRivers','minorRivers']) for(const path of world.sourceMap?.[key]||[]) for(const t of path||[]) {
+    if(!Array.isArray(t)||t.length<2) continue;
+    const x=Math.round((t[0]||0)+world.originX), y=Math.round((t[1]||0)+world.originY), i=idx(world,x,y);
+    if(i>=0 && sea[i] && !(x>=rect.x0&&x<rect.x1&&y>=rect.y0&&y<rect.y1)) out.push(`${key}:${x},${y}`);
+  }
+  return out.sort();
+}
+
+const seed=24681357;
+const initial=generateMap(seed,{terrainType:'auto',onProgress(){}});
+const world=createWorldMap(structuredClone(initial));
+const rect={x0:world.originX+MAP_W-25,y0:world.originY+35,x1:world.originX+MAP_W+120,y1:world.originY+150};
+const beforeRiver=riverSeaPointsOutsideRect(world,rect);
+const result=generatePatch(world,rect,{patchMode:'expansion',terrainType:'auto',seed:777001,variant:0,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true});
+assert.equal(result.ok,true, result.reason||result.code);
+const capitals=capitalAudit(world);
+assert.equal(capitals.zero.length,0,`prefectures with no capital: ${JSON.stringify(capitals.zero)}`);
+assert.equal(capitals.duplicate.length,0,`prefectures with duplicate capitals: ${JSON.stringify(capitals.duplicate)}`);
+const afterRiver=riverSeaPointsOutsideRect(world,rect);
+assert.deepEqual(afterRiver,beforeRiver,'river sanitation changed sea-mouth points outside patch write region');
+for(const r of world.sourceMap.prefectureRegions||[]) {
+  assert.equal(r.insidePrefecture,true);
+  assert.ok(Number.isFinite(r.worldX)&&Number.isFinite(r.worldY));
+  assert.ok(Number.isFinite(r.capitalX)&&Number.isFinite(r.capitalY));
+  assert.ok(Number.isFinite(r.capitalWorldX)&&Number.isFinite(r.capitalWorldY));
+}
+
+const app=readFileSync(new URL('./app.js', import.meta.url),'utf8');
+const html=readFileSync(new URL('./index.html', import.meta.url),'utf8');
+assert.match(app,/PATCH_WORKER_INACTIVITY_WATCHDOG_MS\s*=\s*60_000/);
+assert.match(app,/function cancelPatchGeneration/);
+assert.match(app,/hideSelectionOverlay\(\{ discardPreview: true \}\)/);
+assert.match(html,/id="cancelPatchGeneration"/);
+
+console.log(JSON.stringify({ok:true,capitalAudit:capitals,outsideRiverSeaPointsPreserved:beforeRiver.length,seam:result.seamDiagnostics?.status||null},null,2));
diff --git a/archive/generated-history/VALIDATE_CAPITAL_SEQUENCE.mjs b/archive/generated-history/VALIDATE_CAPITAL_SEQUENCE.mjs
new file mode 100644
index 0000000..df071f3
--- /dev/null
+++ b/archive/generated-history/VALIDATE_CAPITAL_SEQUENCE.mjs
@@ -0,0 +1,37 @@
+import assert from 'node:assert/strict';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_W, MAP_H } from './mapUtils.js';
+const initial=generateMap(42424242,{terrainType:'auto',onProgress(){}});
+const world=createWorldMap(structuredClone(initial));
+const rects=[
+ {x0:world.originX+MAP_W-25,y0:world.originY+30,x1:world.originX+MAP_W+115,y1:world.originY+150},
+ {x0:world.originX+35,y0:world.originY+MAP_H-25,x1:world.originX+175,y1:world.originY+MAP_H+105},
+];
+function audit(){
+ const pref=world.fields.prefectureRegionId, sea=world.fields.sea; const active=new Set();
+ for(let i=0;i<pref.length;i++) if(!sea[i]&&pref[i]>=0) active.add(Math.floor(pref[i]));
+ const counts=new Map([...active].map(id=>[id,0]));
+ for(const c of world.sourceMap.modernCities||[]){
+  const cap=c.isPrefecturalCapital||c.isRegionalCapital||/Capital/i.test(String(c.rank||''))||/Capital/i.test(String(c.kind||'')); if(!cap)continue;
+  const x=Math.round((c.x||0)+world.originX),y=Math.round((c.y||0)+world.originY); if(x<0||y<0||x>=world.width||y>=world.height)continue;
+  const i=y*world.width+x; if(sea[i]||pref[i]<0)continue; const id=Math.floor(pref[i]); counts.set(id,(counts.get(id)||0)+1);
+ }
+ const zeros=[...counts].filter(([,n])=>n===0), dup=[...counts].filter(([,n])=>n!==1);
+ assert.equal(zeros.length,0,`zero capital ${JSON.stringify(zeros)}`); assert.equal(dup.length,0,`not exactly one ${JSON.stringify(dup)}`);
+ for(const r of world.sourceMap.prefectureRegions||[]){
+  const id=Math.floor(r.prefectureRegionId??r.id); assert.ok(active.has(id)); assert.equal(r.insidePrefecture,true);
+  const cx=Math.round(r.capitalWorldX), cy=Math.round(r.capitalWorldY); assert.ok(cx>=0&&cy>=0&&cx<world.width&&cy<world.height);
+  const i=cy*world.width+cx; assert.equal(Math.floor(pref[i]),id,`capital metadata outside prefecture ${id}`); assert.equal(!!sea[i],false);
+  assert.equal(Math.round((r.capitalX||0)+world.originX),cx); assert.equal(Math.round((r.capitalY||0)+world.originY),cy);
+  assert.equal(Math.round((r.x||0)+world.originX),Math.round(r.worldX)); assert.equal(Math.round((r.y||0)+world.originY),Math.round(r.worldY));
+ }
+ return {active:active.size};
+}
+const steps=[];
+for(let k=0;k<rects.length;k++){
+ const r=generatePatch(world,rects[k],{patchMode:'expansion',terrainType:'auto',seed:91000+k,variant:0,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true});
+ assert.equal(r.ok,true,r.reason||r.code); steps.push({...audit(),seam:r.seamDiagnostics?.status||null});
+}
+console.log(JSON.stringify({ok:true,steps},null,2)); process.exit(0);
diff --git a/archive/generated-history/VALIDATE_FINAL_LARGE_COVERAGE.mjs b/archive/generated-history/VALIDATE_FINAL_LARGE_COVERAGE.mjs
new file mode 100644
index 0000000..495ae78
--- /dev/null
+++ b/archive/generated-history/VALIDATE_FINAL_LARGE_COVERAGE.mjs
@@ -0,0 +1,97 @@
+import assert from 'node:assert/strict';
+import { Worker } from 'node:worker_threads';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { collectTransferableBuffers } from './transferUtils.js';
+
+const BASE_SEED = 24681357;
+const PATCH_SEED = 0x4a35b921;
+const WIDTH = 600;
+const HEIGHT = 400;
+
+function footprintContains(fp, x, y) {
+  if (!fp || x < fp.x0 || y < fp.y0 || x >= fp.x1 || y >= fp.y1) return false;
+  const row = fp.rowRuns?.[y - fp.y0];
+  if (!Array.isArray(row)) return false;
+  for (let i = 0; i + 1 < row.length; i += 2) if (x >= row[i] && x < row[i + 1]) return true;
+  return false;
+}
+function recordContains(record, x, y) {
+  if (record?.generatedFootprint) return footprintContains(record.generatedFootprint, x, y);
+  const r = record?.coreRect || record;
+  return !!r && x >= r.x0 && y >= r.y0 && x < r.x1 && y < r.y1;
+}
+function generatedAt(world, x, y) {
+  return (world.generatedRects || []).some(record => recordContains(record, x, y));
+}
+function centeredRect(world, width, height) {
+  // Use a deliberately off-center but fully valid selection so this exercises
+  // a different outer seam than the existing centered stability test.
+  const x0 = Math.max(0, world.width - width);
+  const y0 = Math.max(0, world.height - height);
+  return { x0, y0, x1: x0 + width, y1: y0 + height };
+}
+function workerAdapter(url) {
+  const code = `import { parentPort } from 'node:worker_threads';\n`
+    + `globalThis.self = { onmessage: null, postMessage(message, transfer) { parentPort.postMessage(message, transfer); } };\n`
+    + `await import(${JSON.stringify(url.href)});\n`
+    + `parentPort.on('message', data => self.onmessage?.({ data }));\n`;
+  return new Worker(new URL(`data:text/javascript,${encodeURIComponent(code)}`), { type: 'module', execArgv: [] });
+}
+
+const initial = generateMap(BASE_SEED, { terrainType: 'auto', onProgress() {} });
+const baseWorld = createWorldMap(initial);
+const rect = centeredRect(baseWorld, WIDTH, HEIGHT);
+const needed = [];
+for (let y = rect.y0; y < rect.y1; y++) {
+  for (let x = rect.x0; x < rect.x1; x++) {
+    if (!generatedAt(baseWorld, x, y)) needed.push([x, y]);
+  }
+}
+assert.ok(needed.length > 0, 'test selection must contain ungenerated cells');
+
+const preview = structuredClone(baseWorld);
+const transfer = Array.from(collectTransferableBuffers(preview));
+const worker = workerAdapter(new URL('./mapPatchWorker.js', import.meta.url));
+const startedAt = Date.now();
+const message = await new Promise((resolve, reject) => {
+  const timer = setTimeout(() => reject(new Error('600x400 worker timeout')), 120000);
+  worker.on('message', message => {
+    if (message?.type === 'progress') return;
+    clearTimeout(timer);
+    resolve(message);
+  });
+  worker.on('error', error => { clearTimeout(timer); reject(error); });
+  worker.postMessage({
+    id: 1,
+    world: preview,
+    rect,
+    options: {
+      patchMode: 'expansion', terrainType: 'auto', seed: PATCH_SEED, variant: 1,
+      maxQualityRetries: 0, qualityTerrainAttempts: 1, acceptBestAvailableQuality: true,
+    },
+  }, transfer);
+});
+
+assert.equal(message?.ok, true, message?.error || 'worker outer failure');
+assert.equal(message?.result?.ok, true, message?.result?.reason || message?.result?.code || 'patch failure');
+assert.equal(message?.result?.seamDiagnostics?.hardPass, true, 'seam hard gate failed');
+const returnedWorld = message.world;
+let missing = 0;
+for (const [x, y] of needed) if (!generatedAt(returnedWorld, x, y)) missing++;
+assert.equal(missing, 0, `missing ${missing} previously-ungenerated selected cells`);
+
+const out = {
+  ok: true,
+  size: `${WIDTH}x${HEIGHT}`,
+  selectedCells: WIDTH * HEIGHT,
+  previouslyUngeneratedSelectedCells: needed.length,
+  missingPreviouslyUngeneratedCells: missing,
+  tileCount: message.result?.tileCount || 1,
+  seam: message.result?.seamDiagnostics?.status || null,
+  hardPass: message.result?.seamDiagnostics?.hardPass ?? null,
+  ms: Date.now() - startedAt,
+};
+console.log(JSON.stringify(out, null, 2));
+await worker.terminate();
+process.exit(0);
diff --git a/archive/generated-history/VALIDATE_FREEFORM_TILING.mjs b/archive/generated-history/VALIDATE_FREEFORM_TILING.mjs
new file mode 100644
index 0000000..3a4a919
--- /dev/null
+++ b/archive/generated-history/VALIDATE_FREEFORM_TILING.mjs
@@ -0,0 +1,17 @@
+import assert from 'node:assert/strict';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+const initial=generateMap(24681357,{terrainType:'auto',onProgress(){}});
+const world=createWorldMap(structuredClone(initial));
+const ox=world.originX, oy=world.originY;
+const lasso={kind:'lasso',polygon:[
+  {x:ox-120,y:oy-120},{x:ox+410,y:oy+215},{x:ox+425,y:oy+240},{x:ox-105,y:oy-95}
+]};
+const t=Date.now();
+const result=generatePatch(world,lasso,{patchMode:'expansion',terrainType:'auto',seed:888002,variant:0,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true,onProgress(e){if(e?.key?.startsWith('large-tile-')&&e.status==='start') console.error(e.label)}});
+const ms=Date.now()-t;
+assert.equal(result.ok,true,result.reason||result.code);
+assert.ok((result.tileCount||1)<9,`thin lasso still uses ${result.tileCount} tiles`);
+console.log(JSON.stringify({ok:true,tileCount:result.tileCount||1,ms,seam:result.seamDiagnostics?.status||null},null,2));
+process.exit(0);
diff --git a/archive/generated-history/VALIDATE_LARGE_ADDITIONAL_GENERATION_SYNC.mjs b/archive/generated-history/VALIDATE_LARGE_ADDITIONAL_GENERATION_SYNC.mjs
new file mode 100644
index 0000000..101b154
--- /dev/null
+++ b/archive/generated-history/VALIDATE_LARGE_ADDITIONAL_GENERATION_SYNC.mjs
@@ -0,0 +1,12 @@
+import assert from 'node:assert/strict';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_W, MAP_H } from './mapUtils.js';
+function fpContains(fp,x,y){if(!fp||x<fp.x0||y<fp.y0||x>=fp.x1||y>=fp.y1)return false;const row=fp.rowRuns?.[y-fp.y0];if(!Array.isArray(row))return false;for(let i=0;i+1<row.length;i+=2)if(x>=row[i]&&x<row[i+1])return true;return false;}
+function recContains(r,x,y){if(r?.generatedFootprint)return fpContains(r.generatedFootprint,x,y);const q=r?.coreRect||r;return !!q&&x>=q.x0&&y>=q.y0&&x<q.x1&&y<q.y1;}
+function coverage(world,rect){let selected=0,generated=0;for(let y=rect.y0;y<rect.y1;y++)for(let x=rect.x0;x<rect.x1;x++){selected++;if((world.generatedRects||[]).some(r=>recContains(r,x,y)))generated++;}return{selected,generated,missing:selected-generated,ratio:generated/selected};}
+function makeRect(world,w,h){const edge=world.originX+MAP_W-1,cy=world.originY+Math.floor(MAP_H/2);return{x0:edge-40,y0:cy-Math.floor(h/2),x1:edge-40+w,y1:cy-Math.floor(h/2)+h};}
+const initial=generateMap(24681357,{terrainType:'auto',onProgress(){}});
+const directWorld=createWorldMap(structuredClone(initial)); const directRect=makeRect(directWorld,250,180); const direct=generatePatch(directWorld,directRect,{patchMode:'expansion',terrainType:'auto',seed:0x12345678,variant:1,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true}); assert.equal(direct.ok,true,direct.reason||direct.code); assert.notEqual(direct.tiledExpansion,true); assert.equal(direct.candidateQuality?.requestedTerrainAttempts,1); assert.equal(direct.candidateQuality?.fullAttempts?.length,1);
+const world=createWorldMap(structuredClone(initial)); const rect=makeRect(world,280,200); const r=generatePatch(world,rect,{patchMode:'expansion',terrainType:'auto',seed:0x4a35b921,variant:1,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true}); assert.equal(r.ok,true,r.reason||r.code); assert.equal(r.tiledExpansion,true); assert.equal(r.tileCount,4); assert.equal(r.seamDiagnostics?.hardPass,true); const c=coverage(world,rect); assert.equal(c.missing,0); console.log(JSON.stringify({ok:true,direct:{size:'250x180',fullAttempts:direct.candidateQuality.fullAttempts.length,tiled:false},large:{size:'280x200',tileCount:r.tileCount,seam:r.seamDiagnostics.status,coverage:c,totalMs:r.patchTimings.find(x=>x.key==='tiled-total')?.ms}},null,2)); process.exit(0);
diff --git a/archive/generated-history/VALIDATE_LARGE_ADDITIONAL_GENERATION_WORKER.mjs b/archive/generated-history/VALIDATE_LARGE_ADDITIONAL_GENERATION_WORKER.mjs
new file mode 100644
index 0000000..1eb7559
--- /dev/null
+++ b/archive/generated-history/VALIDATE_LARGE_ADDITIONAL_GENERATION_WORKER.mjs
@@ -0,0 +1,11 @@
+import assert from 'node:assert/strict';
+import { Worker } from 'node:worker_threads';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { MAP_W,MAP_H } from './mapUtils.js';
+import { collectTransferableBuffers } from './transferUtils.js';
+function adapter(url){const code=`import {parentPort} from 'node:worker_threads'; globalThis.self={onmessage:null,postMessage(m,t){parentPort.postMessage(m,t)}}; await import(${JSON.stringify(url.href)}); parentPort.on('message',d=>self.onmessage?.({data:d}));`;return new Worker(new URL(`data:text/javascript,${encodeURIComponent(code)}`),{type:'module',execArgv:[]});}
+const initial=generateMap(24681357,{terrainType:'auto',onProgress(){}}); const world=createWorldMap(initial); const edge=world.originX+MAP_W-1,cy=world.originY+Math.floor(MAP_H/2); const rect={x0:edge-40,y0:cy-100,x1:edge-40+280,y1:cy+100};
+const worker=adapter(new URL('./mapPatchWorker.js',import.meta.url)); const preview=structuredClone(world); const transfer=Array.from(collectTransferableBuffers(preview)); const t=Date.now(); let last=0;
+const message=await new Promise((resolve,reject)=>{const timer=setTimeout(()=>reject(new Error('timeout')),80000);worker.on('message',m=>{if(m?.type==='progress'){if(Date.now()-last>4000){last=Date.now(); console.error(Date.now()-t,m.progress?.label||m.progress?.key);}return;}clearTimeout(timer);resolve(m)});worker.on('error',e=>{clearTimeout(timer);reject(e)});worker.postMessage({id:1,world:preview,rect,options:{patchMode:'expansion',terrainType:'auto',seed:0x4a35b921,variant:1,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true}},transfer);});
+console.log(JSON.stringify({ms:Date.now()-t,outer:message.ok,inner:message.result?.ok,tiled:message.result?.tiledExpansion,tileCount:message.result?.tileCount,seam:message.result?.seamDiagnostics?.status,reason:message.result?.reason||message.error||null},null,2)); await worker.terminate(); process.exit(0);
diff --git a/archive/generated-history/VALIDATE_LARGE_SELECTION_STABILITY.mjs b/archive/generated-history/VALIDATE_LARGE_SELECTION_STABILITY.mjs
new file mode 100644
index 0000000..3e789c7
--- /dev/null
+++ b/archive/generated-history/VALIDATE_LARGE_SELECTION_STABILITY.mjs
@@ -0,0 +1,115 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { Worker } from 'node:worker_threads';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { collectTransferableBuffers } from './transferUtils.js';
+
+const BASE_SEED = 24681357;
+const PATCH_SEED = 0x4a35b921;
+
+function centeredRect(world, width, height) {
+  return {
+    x0: Math.floor((world.width - width) / 2),
+    y0: Math.floor((world.height - height) / 2),
+    x1: Math.floor((world.width - width) / 2) + width,
+    y1: Math.floor((world.height - height) / 2) + height,
+  };
+}
+
+function workerAdapter(url) {
+  const code = `import { parentPort } from 'node:worker_threads';\n`
+    + `globalThis.self = { onmessage: null, postMessage(message, transfer) { parentPort.postMessage(message, transfer); } };\n`
+    + `await import(${JSON.stringify(url.href)});\n`
+    + `parentPort.on('message', data => self.onmessage?.({ data }));\n`;
+  return new Worker(new URL(`data:text/javascript,${encodeURIComponent(code)}`), { type: 'module', execArgv: [] });
+}
+
+async function runDirect(width, height) {
+  const initial = generateMap(BASE_SEED, { terrainType: 'auto', onProgress() {} });
+  const world = createWorldMap(initial);
+  const rect = centeredRect(world, width, height);
+  const startedAt = Date.now();
+  const result = generatePatch(world, rect, {
+    patchMode: 'expansion', terrainType: 'auto', seed: PATCH_SEED, variant: 1,
+    maxQualityRetries: 0, qualityTerrainAttempts: 1, acceptBestAvailableQuality: true,
+    onProgress() {},
+  });
+  const row = {
+    mode: 'direct', size: `${width}x${height}`, ms: Date.now() - startedAt,
+    ok: result?.ok === true, code: result?.code || null,
+    tileCount: result?.tileCount || 1,
+    seam: result?.seamDiagnostics?.status || null,
+    hardPass: result?.seamDiagnostics?.hardPass ?? null,
+  };
+  assert.equal(row.ok, true, `${row.size}: ${result?.reason || result?.code}`);
+  assert.equal(row.hardPass, true, `${row.size}: seam hard gate failed`);
+  return row;
+}
+
+async function runWorker(width, height) {
+  const initial = generateMap(BASE_SEED, { terrainType: 'auto', onProgress() {} });
+  const world = createWorldMap(initial);
+  const rect = centeredRect(world, width, height);
+  const preview = structuredClone(world);
+  const transfer = Array.from(collectTransferableBuffers(preview));
+  const worker = workerAdapter(new URL('./mapPatchWorker.js', import.meta.url));
+  const startedAt = Date.now();
+  const message = await new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`${width}x${height}: worker timeout`)), 120000);
+    worker.on('message', message => {
+      if (message?.type === 'progress') return;
+      clearTimeout(timer);
+      resolve(message);
+    });
+    worker.on('error', error => { clearTimeout(timer); reject(error); });
+    worker.postMessage({
+      id: 1, world: preview, rect,
+      options: {
+        patchMode: 'expansion', terrainType: 'auto', seed: PATCH_SEED, variant: 1,
+        maxQualityRetries: 0, qualityTerrainAttempts: 1, acceptBestAvailableQuality: true,
+      },
+    }, transfer);
+  });
+  const row = {
+    mode: 'worker', size: `${width}x${height}`, ms: Date.now() - startedAt,
+    outerOk: message?.ok === true, ok: message?.result?.ok === true,
+    code: message?.result?.code || null, tileCount: message?.result?.tileCount || 1,
+    seam: message?.result?.seamDiagnostics?.status || null,
+    hardPass: message?.result?.seamDiagnostics?.hardPass ?? null,
+  };
+  worker.unref();
+  void worker.terminate();
+  assert.equal(row.outerOk, true, `${row.size}: worker outer failure ${message?.error || ''}`);
+  assert.equal(row.ok, true, `${row.size}: ${message?.result?.reason || message?.result?.code}`);
+  assert.equal(row.hardPass, true, `${row.size}: seam hard gate failed`);
+  return row;
+}
+
+const args = process.argv.slice(2);
+if (args[0] === '--direct') {
+  console.log(JSON.stringify(await runDirect(Number(args[1]), Number(args[2]))));
+  process.exit(0);
+}
+if (args[0] === '--worker') {
+  console.log(JSON.stringify(await runWorker(Number(args[1]), Number(args[2]))));
+  process.exit(0);
+}
+
+const specs = [
+  ['--direct', 300, 339],
+  ['--direct', 500, 350],
+  ['--direct', 600, 400],
+  ['--worker', 600, 400],
+];
+const results = [];
+for (const spec of specs) {
+  const child = spawnSync(process.execPath, [new URL(import.meta.url).pathname, ...spec.map(String)], {
+    cwd: process.cwd(), encoding: 'utf8', timeout: 130000, maxBuffer: 4 * 1024 * 1024,
+  });
+  assert.equal(child.status, 0, `${spec.slice(1).join('x')} ${spec[0]} failed:\n${child.stderr || child.stdout}`);
+  const lines = child.stdout.trim().split(/\r?\n/).filter(Boolean);
+  results.push(JSON.parse(lines.at(-1)));
+}
+console.log(JSON.stringify({ ok: true, results }, null, 2));
diff --git a/archive/generated-history/VALIDATE_OVERLAP_PORTAL_REGRESSION.mjs b/archive/generated-history/VALIDATE_OVERLAP_PORTAL_REGRESSION.mjs
new file mode 100644
index 0000000..66bde94
--- /dev/null
+++ b/archive/generated-history/VALIDATE_OVERLAP_PORTAL_REGRESSION.mjs
@@ -0,0 +1,57 @@
+import assert from 'node:assert/strict';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+
+function footprintContains(fp, x, y) {
+  if (!fp || x < fp.x0 || y < fp.y0 || x >= fp.x1 || y >= fp.y1) return false;
+  const row = fp.rowRuns?.[y - fp.y0];
+  if (!Array.isArray(row)) return false;
+  for (let i = 0; i + 1 < row.length; i += 2) if (x >= row[i] && x < row[i + 1]) return true;
+  return false;
+}
+function recordContains(record, x, y) {
+  if (record?.generatedFootprint) return footprintContains(record.generatedFootprint, x, y);
+  const r = record?.coreRect || record;
+  return !!r && x >= r.x0 && y >= r.y0 && x < r.x1 && y < r.y1;
+}
+function generatedAt(world, x, y) {
+  return (world.generatedRects || []).some(record => recordContains(record, x, y));
+}
+
+const world = createWorldMap(generateMap(24681357, { terrainType: 'auto', onProgress() {} }));
+// This is the exact in-world rectangle produced by the previously failing
+// bottom-right overlap case after validation/clipping. Before the real-frontier
+// portal fix, a minor road wholly inside established geography was mistaken for
+// an expansion seam portal and the whole operation rolled back.
+const rect = { x0: 345, y0: 257, x1: 774, y1: 549 };
+const needed = [];
+for (let y = rect.y0; y < rect.y1; y++) {
+  for (let x = rect.x0; x < rect.x1; x++) if (!generatedAt(world, x, y)) needed.push([x, y]);
+}
+const startedAt = Date.now();
+const result = generatePatch(world, rect, {
+  patchMode: 'expansion', terrainType: 'auto', seed: 0x4a35b921, variant: 1,
+  maxQualityRetries: 0, qualityTerrainAttempts: 1, acceptBestAvailableQuality: true,
+  onProgress() {},
+});
+assert.equal(result?.ok, true, result?.reason || result?.code || 'patch failed');
+assert.equal(result?.seamDiagnostics?.hardPass, true, 'seam hard gate failed');
+assert.equal(result?.seamDiagnostics?.roadPortalsBroken || 0, 0, 'false road portal remained');
+let missing = 0;
+for (const [x, y] of needed) if (!generatedAt(world, x, y)) missing++;
+assert.equal(missing, 0, `missing ${missing} previously-ungenerated selected cells`);
+console.log(JSON.stringify({
+  ok: true,
+  rect,
+  selectedCells: (rect.x1 - rect.x0) * (rect.y1 - rect.y0),
+  previouslyUngeneratedSelectedCells: needed.length,
+  missingPreviouslyUngeneratedCells: missing,
+  tileCount: result?.tileCount || 1,
+  roadPortalsBefore: result?.seamDiagnostics?.roadPortalsBefore || 0,
+  roadPortalsBroken: result?.seamDiagnostics?.roadPortalsBroken || 0,
+  seam: result?.seamDiagnostics?.status || null,
+  hardPass: result?.seamDiagnostics?.hardPass ?? null,
+  ms: Date.now() - startedAt,
+}, null, 2));
+process.exit(0);
diff --git a/archive/generated-history/VALIDATE_PATCH_UI_STATE.mjs b/archive/generated-history/VALIDATE_PATCH_UI_STATE.mjs
new file mode 100644
index 0000000..b064402
--- /dev/null
+++ b/archive/generated-history/VALIDATE_PATCH_UI_STATE.mjs
@@ -0,0 +1,13 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+const app=readFileSync(new URL('./app.js',import.meta.url),'utf8');
+const html=readFileSync(new URL('./index.html',import.meta.url),'utf8');
+assert.match(html,/id="cancelPatchGeneration"/);
+assert.match(app,/const PATCH_WORKER_INACTIVITY_WATCHDOG_MS = 60_000/);
+assert.match(app,/function cancelPatchGeneration\(/);
+assert.match(app,/activePatchCancel/);
+assert.match(app,/worker\.terminate\?\.\(\)/);
+assert.match(app,/if \(state\.patchBusy\) \{\s*cancelPatchGeneration\(\)/s);
+assert.match(app,/clearPatchSelectionButton\?\.addEventListener\("click", \(\) => hideSelectionOverlay\(\{ discardPreview: true \}\)\)/);
+assert.match(app,/const discardPreview = options\.discardPreview === true \|\| \(!commitPreview && options\.keepPreview !== true && !!state\.pendingPatch\)/);
+console.log(JSON.stringify({ok:true,cancelButton:true,watchdogSeconds:60,escapeCancelsBusy:true,clearDiscardsPendingPreview:true},null,2));
diff --git a/archive/generated-history/VALIDATE_REPORTED_PATCH_BUGS.mjs b/archive/generated-history/VALIDATE_REPORTED_PATCH_BUGS.mjs
new file mode 100644
index 0000000..7a5176c
--- /dev/null
+++ b/archive/generated-history/VALIDATE_REPORTED_PATCH_BUGS.mjs
@@ -0,0 +1,109 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_W, MAP_H, worldIndexOf } from './mapUtils.js';
+
+const appSource = readFileSync(new URL('./app.js', import.meta.url), 'utf8');
+const htmlSource = readFileSync(new URL('./index.html', import.meta.url), 'utf8');
+assert.match(htmlSource, /id="clearPatchSelection"/);
+assert.match(appSource, /clearPatchSelectionButton\?\.addEventListener\("click", \(\) => hideSelectionOverlay\(\{ discardPreview: true \}\)\)/);
+assert.match(appSource, /function cancelPatchGeneration/);
+assert.match(appSource, /PATCH_WORKER_INACTIVITY_WATCHDOG_MS/);
+
+const initial = generateMap(24681357, { terrainType: 'auto', onProgress() {} });
+const world = createWorldMap(structuredClone(initial));
+const establishedEdgeX = world.originX + MAP_W - 1;
+const y0 = world.originY + Math.floor(MAP_H * 0.22);
+const y1 = world.originY + Math.floor(MAP_H * 0.78);
+const rect = {
+  x0: establishedEdgeX - 33,
+  y0,
+  x1: establishedEdgeX + 93,
+  y1,
+};
+const result = generatePatch(world, rect, {
+  patchMode: 'expansion', terrainType: 'auto', seed: 97531, variant: 1,
+  maxQualityRetries: 0, qualityTerrainAttempts: 1, acceptBestAvailableQuality: true,
+});
+assert.equal(result.ok, true, result.reason || result.code || 'patch failed');
+
+const source = world.sourceMap;
+const sea = world.fields.sea;
+let riverSeaPoints = 0;
+const writeRect = result.rects?.writeRect || rect;
+for (const key of ['mainRivers','tributaryRivers','smallStreams','riverPaths']) {
+  for (const path of source[key] || []) for (const t of path || []) {
+    const x = Math.round((t?.[0] || 0) + world.originX);
+    const y = Math.round((t?.[1] || 0) + world.originY);
+    const i = worldIndexOf(world,x,y);
+    if (i >= 0 && sea[i] && x >= writeRect.x0 && x < writeRect.x1 && y >= writeRect.y0 && y < writeRect.y1) riverSeaPoints++;
+  }
+}
+assert.equal(riverSeaPoints, 0, `river path points over sea inside patch writeRect: ${riverSeaPoints}`);
+
+const byPref = new Map();
+for (const city of source.modernCities || []) {
+  const capital = city.isPrefecturalCapital || city.isRegionalCapital || /Capital/i.test(String(city.rank || '')) || /Capital/i.test(String(city.kind || ''));
+  if (!capital) continue;
+  const x = Math.round((city.x || 0) + world.originX);
+  const y = Math.round((city.y || 0) + world.originY);
+  const i = worldIndexOf(world,x,y);
+  if (i < 0 || sea[i] || world.fields.prefectureRegionId[i] < 0) continue;
+  const id = world.fields.prefectureRegionId[i];
+  byPref.set(id, (byPref.get(id) || 0) + 1);
+}
+const duplicateCapitalPrefs = [...byPref.entries()].filter(([,n]) => n > 1);
+assert.equal(duplicateCapitalPrefs.length, 0, `duplicate capital prefectures: ${JSON.stringify(duplicateCapitalPrefs)}`);
+const activePrefIds = new Set();
+for (let i=0;i<world.fields.prefectureRegionId.length;i++) if (!sea[i] && world.fields.prefectureRegionId[i] >= 0) activePrefIds.add(Math.floor(world.fields.prefectureRegionId[i]));
+const missingCapitalPrefs = [...activePrefIds].filter((id) => (byPref.get(id) || 0) === 0);
+assert.equal(missingCapitalPrefs.length, 0, `missing capital prefectures: ${JSON.stringify(missingCapitalPrefs)}`);
+
+const prefCounts = new Map();
+for (let i=0;i<world.fields.prefectureRegionId.length;i++) if (!sea[i] && world.fields.prefectureRegionId[i] >= 0) {
+  const id=world.fields.prefectureRegionId[i];
+  prefCounts.set(id,(prefCounts.get(id)||0)+1);
+}
+const generatedRegions = (source.prefectureRegions || []).filter(p => p.patchGenerated).map(p => p.prefectureRegionId ?? p.id).filter(Number.isFinite);
+const generatedSizes = [...new Set(generatedRegions)].map(id => [id,prefCounts.get(id)||0]);
+const tinyGenerated = generatedSizes.filter(([,n]) => n > 0 && n < 650);
+assert.equal(tinyGenerated.length, 0, `tiny generated prefectures survived: ${JSON.stringify(tinyGenerated)}`);
+
+let landLandPairs = 0;
+let maxEstablishedFrontierElevationJump = 0;
+let adminBreaksOnEstablishedFrontier = 0;
+let prefectureBreaksOnEstablishedFrontier = 0;
+for (let y=y0; y<y1; y++) {
+  const a = worldIndexOf(world, establishedEdgeX, y);
+  const b = worldIndexOf(world, establishedEdgeX + 1, y);
+  if (a < 0 || b < 0 || sea[a] || sea[b]) continue;
+  landLandPairs++;
+  maxEstablishedFrontierElevationJump = Math.max(maxEstablishedFrontierElevationJump, Math.abs(world.fields.elevation[a] - world.fields.elevation[b]));
+  if (world.fields.adminId[a] !== world.fields.adminId[b]) adminBreaksOnEstablishedFrontier++;
+  if (world.fields.prefectureRegionId[a] !== world.fields.prefectureRegionId[b]) prefectureBreaksOnEstablishedFrontier++;
+}
+assert.ok(landLandPairs > 20, 'frontier probe did not include enough land pairs');
+assert.ok(maxEstablishedFrontierElevationJump < 0.08, `frontier elevation jump too large: ${maxEstablishedFrontierElevationJump}`);
+assert.equal(adminBreaksOnEstablishedFrontier, 0, 'municipal boundary still follows generation frontier');
+assert.equal(prefectureBreaksOnEstablishedFrontier, 0, 'prefecture boundary still follows generation frontier');
+assert.equal(result.seamDiagnostics?.hardPass, true, `seam gate failed: ${JSON.stringify(result.seamDiagnostics?.gateReasons || [])}`);
+
+console.log(JSON.stringify({
+  ok: true,
+  riverSeaPoints,
+  duplicateCapitalPrefs,
+  missingCapitalPrefs,
+  generatedSizes,
+  tinyGenerated,
+  landLandPairs,
+  maxEstablishedFrontierElevationJump: Math.round(maxEstablishedFrontierElevationJump * 10000) / 10000,
+  adminBreaksOnEstablishedFrontier,
+  prefectureBreaksOnEstablishedFrontier,
+  frontierAdminCellsAligned: result.humanGeography?.frontierAdminCellsAligned || 0,
+  establishedFrontierAdminCellsRestored: result.humanGeography?.establishedFrontierAdminCellsRestored || 0,
+  frontierHarmonizedValues: result.humanGeography?.frontierHarmonizedValues || 0,
+  seamStatus: result.seamDiagnostics?.status,
+  seamGateReasons: result.seamDiagnostics?.gateReasons || [],
+}, null, 2));
diff --git a/archive/generated-history/VALIDATE_SEAM_STRESS.mjs b/archive/generated-history/VALIDATE_SEAM_STRESS.mjs
new file mode 100644
index 0000000..210852e
--- /dev/null
+++ b/archive/generated-history/VALIDATE_SEAM_STRESS.mjs
@@ -0,0 +1,70 @@
+import assert from 'node:assert/strict';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_W, MAP_H, worldIndexOf } from './mapUtils.js';
+
+const baseSeeds = (process.env.BASE_SEEDS || '24681357,13579246').split(',').map(Number).filter(Number.isFinite);
+const requestedDirections = new Set((process.env.DIRECTIONS || 'right,left,down,up').split(',').map(s => s.trim()));
+const results = [];
+const quiet = process.env.QUIET === '1';
+
+function probeAxis(world, direction, baseOriginX, baseOriginY) {
+  const edgeX = baseOriginX + MAP_W - 1;
+  const edgeY = baseOriginY + MAP_H - 1;
+  if (direction === 'right') return { horizontal: false, fixed: edgeX, start: baseOriginY + Math.floor(MAP_H*.22), end: baseOriginY + Math.floor(MAP_H*.78), oldOffset: 0, newOffset: 1 };
+  if (direction === 'left') return { horizontal: false, fixed: baseOriginX, start: baseOriginY + Math.floor(MAP_H*.22), end: baseOriginY + Math.floor(MAP_H*.78), oldOffset: 0, newOffset: -1 };
+  if (direction === 'down') return { horizontal: true, fixed: edgeY, start: baseOriginX + Math.floor(MAP_W*.22), end: baseOriginX + Math.floor(MAP_W*.78), oldOffset: 0, newOffset: 1 };
+  return { horizontal: true, fixed: baseOriginY, start: baseOriginX + Math.floor(MAP_W*.22), end: baseOriginX + Math.floor(MAP_W*.78), oldOffset: 0, newOffset: -1 };
+}
+
+function makeRect(direction, ox, oy) {
+  const edgeX = ox + MAP_W - 1, edgeY = oy + MAP_H - 1;
+  const x0 = ox + Math.floor(MAP_W*.22), x1 = ox + Math.floor(MAP_W*.78);
+  const y0 = oy + Math.floor(MAP_H*.22), y1 = oy + Math.floor(MAP_H*.78);
+  if (direction === 'right') return { x0: edgeX - 33, y0, x1: edgeX + 93, y1 };
+  if (direction === 'left') return { x0: ox - 93, y0, x1: ox + 33, y1 };
+  if (direction === 'down') return { x0, y0: edgeY - 33, x1, y1: edgeY + 93 };
+  return { x0, y0: oy - 93, x1, y1: oy + 33 };
+}
+
+function measureFrontier(world, probe) {
+  let pairs = 0, maxJump = 0, sum = 0;
+  for (let t = probe.start; t < probe.end; t++) {
+    let ax, ay, bx, by;
+    if (!probe.horizontal) {
+      ax = probe.fixed + probe.oldOffset; ay = t;
+      bx = probe.fixed + probe.newOffset; by = t;
+    } else {
+      ax = t; ay = probe.fixed + probe.oldOffset;
+      bx = t; by = probe.fixed + probe.newOffset;
+    }
+    const a = worldIndexOf(world,ax,ay), b = worldIndexOf(world,bx,by);
+    if (a < 0 || b < 0 || world.fields.sea[a] || world.fields.sea[b]) continue;
+    const jump = Math.abs(world.fields.elevation[a] - world.fields.elevation[b]);
+    pairs++; sum += jump; maxJump = Math.max(maxJump,jump);
+  }
+  return { pairs, maxJump, meanJump: pairs ? sum/pairs : 0 };
+}
+
+for (const baseSeed of baseSeeds) {
+  const initial = generateMap(baseSeed, { terrainType:'auto', onProgress(){} });
+  for (const direction of ['right','left','down','up']) {
+    if (!requestedDirections.has(direction)) continue;
+    const world = createWorldMap(structuredClone(initial));
+    const ox = world.originX, oy = world.originY;
+    const rect = makeRect(direction,ox,oy);
+    const patchSeed = (0x13579bdf ^ baseSeed ^ ({right:0x11,left:0x22,down:0x33,up:0x44}[direction])) >>> 0;
+    const result = generatePatch(world,rect,{patchMode:'expansion',terrainType:'auto',seed:patchSeed,variant:1,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true});
+    assert.equal(result.ok,true,`${baseSeed}/${direction}: ${result.reason || result.code}`);
+    const probe = measureFrontier(world,probeAxis(world,direction,ox,oy));
+    assert.ok(probe.pairs >= 12,`${baseSeed}/${direction}: insufficient land frontier pairs (${probe.pairs})`);
+    assert.ok(probe.maxJump <= 0.075,`${baseSeed}/${direction}: frontier max jump ${probe.maxJump}`);
+    assert.equal(result.seamDiagnostics?.hardPass,true,`${baseSeed}/${direction}: seam gate ${JSON.stringify(result.seamDiagnostics?.gateReasons || [])}`);
+    assert.ok((result.seamDiagnostics?.maxEstablishedFrontierElevationJump || 0) <= 0.075,`${baseSeed}/${direction}: diagnostic frontier jump ${result.seamDiagnostics?.maxEstablishedFrontierElevationJump}`);
+    const row={baseSeed,direction,patchSeed,pairs:probe.pairs,maxJump:+probe.maxJump.toFixed(4),meanJump:+probe.meanJump.toFixed(4),diagnosticMax:+(result.seamDiagnostics?.maxEstablishedFrontierElevationJump||0).toFixed(4),seamStatus:result.seamDiagnostics?.status,seamReasons:result.seamDiagnostics?.gateReasons||[],adjusted:result.humanGeography?.establishedFrontierElevationCellsAdjusted||0,gradientAdjusted:result.humanGeography?.establishedFrontierGradientCellsAdjusted||0};
+    results.push(row);
+    if (!quiet) console.log(JSON.stringify(row));
+  }
+}
+console.log(JSON.stringify({ok:true,cases:results.length,maxObserved:Math.max(...results.map(r=>r.maxJump)),results},null,2));
diff --git a/archive/generated-history/VALIDATE_WORLD_NATIVE_THRESHOLD.mjs b/archive/generated-history/VALIDATE_WORLD_NATIVE_THRESHOLD.mjs
new file mode 100644
index 0000000..ff17f0e
--- /dev/null
+++ b/archive/generated-history/VALIDATE_WORLD_NATIVE_THRESHOLD.mjs
@@ -0,0 +1,17 @@
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_W, MAP_H } from './mapUtils.js';
+const init=generateMap(24681357,{terrainType:'auto',onProgress(){}});
+function rectFor(world,w,h){const edge=world.originX+MAP_W-1,cy=world.originY+Math.floor(MAP_H/2);return{x0:edge-38,y0:cy-Math.floor(h/2),x1:edge-38+w,y1:cy-Math.floor(h/2)+h};}
+const wa=createWorldMap(structuredClone(init)), wb=createWorldMap(structuredClone(init));
+const a=rectFor(wa,258,183), b=rectFor(wb,259,184);
+const opts={patchMode:'expansion',terrainType:'auto',seed:0x4a35b921,variant:1,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true};
+const ra=generatePatch(wa,a,opts); const rb=generatePatch(wb,b,opts);
+if(!ra.ok||!rb.ok){console.log(JSON.stringify({ra:{ok:ra.ok,code:ra.code,reason:ra.reason},rb:{ok:rb.ok,code:rb.code,reason:rb.reason}},null,2));process.exit(2)}
+const fields=['elevation','sea','plain','agriculture','populationDensity','prefectureRegionId','adminId'];
+const out={a:{tiled:!!ra.tiledExpansion,tileCount:ra.tileCount||1},b:{tiled:!!rb.tiledExpansion,tileCount:rb.tileCount||1},common:{}};
+for(const name of fields){const A=wa.fields[name],B=wb.fields[name];let n=0,diff=0,sum=0,max=0;for(let y=a.y0;y<a.y1;y++)for(let x=a.x0;x<a.x1;x++){const i=y*wa.width+x;const av=A[i],bv=B[i];const d=Math.abs(Number(av)-Number(bv));n++;if(d>1e-9)diff++;sum+=d;max=Math.max(max,d)}out.common[name]={n,diff,rate:diff/n,meanAbs:sum/n,maxAbs:max};}
+function boundarySet(world,field,rect){const f=world.fields[field],s=new Set();for(let y=rect.y0;y<rect.y1-1;y++)for(let x=rect.x0;x<rect.x1-1;x++){const i=y*world.width+x;if(f[i]!==f[i+1]||f[i]!==f[i+world.width])s.add(`${x},${y}`)}return s}
+for(const field of ['prefectureRegionId','adminId']){const A=boundarySet(wa,field,a),B=boundarySet(wb,field,a);let xor=0;for(const k of A)if(!B.has(k))xor++;for(const k of B)if(!A.has(k))xor++;out.common[field+'Boundary']={a:A.size,b:B.size,xor,normalized:xor/Math.max(1,A.size+B.size)};}
+console.log(JSON.stringify(out,null,2));
diff --git a/archive/generated-history/VALIDATE_WORLD_NATIVE_UNIFICATION.mjs b/archive/generated-history/VALIDATE_WORLD_NATIVE_UNIFICATION.mjs
new file mode 100644
index 0000000..797252c
--- /dev/null
+++ b/archive/generated-history/VALIDATE_WORLD_NATIVE_UNIFICATION.mjs
@@ -0,0 +1,27 @@
+import assert from 'node:assert/strict';
+import { generateMap } from './mapGenerator.js';
+import { createWorldMap, ensureWorldPaddingForCamera } from './worldMap.js';
+import { generatePatch } from './mapPatch.js';
+import { MAP_W, MAP_H } from './mapUtils.js';
+const seed=24681357;
+const init=generateMap(seed,{terrainType:'auto',onProgress(){}});
+function opts(){return {patchMode:'expansion',terrainType:'auto',seed:0x4a35b921,variant:1,maxQualityRetries:0,qualityTerrainAttempts:1,acceptBestAvailableQuality:true};}
+function worldRect(w){return {x0:w.originX+MAP_W-34,y0:w.originY+34,x1:w.originX+MAP_W+106,y1:w.originY+154};}
+const a=createWorldMap(structuredClone(init));
+const ra=worldRect(a); const wa0={x0:ra.x0-a.originX,y0:ra.y0-a.originY,x1:ra.x1-a.originX,y1:ra.y1-a.originY};
+const ar=generatePatch(a,ra,opts()); assert.equal(ar.ok,true,ar.reason||ar.code);
+const b=createWorldMap(structuredClone(init)); ensureWorldPaddingForCamera(b,{x:0,y:0},MAP_W,MAP_H,82);
+const rb={x0:b.originX+wa0.x0,y0:b.originY+wa0.y0,x1:b.originX+wa0.x1,y1:b.originY+wa0.y1};
+const br=generatePatch(b,rb,opts()); assert.equal(br.ok,true,br.reason||br.code);
+const fields=['elevation','sea','plain','agriculture','populationDensity','prefectureRegionId','adminId'];
+const padding={};
+for(const name of fields){let diff=0,max=0,n=0; const A=a.fields[name],B=b.fields[name]; for(let wy=wa0.y0;wy<wa0.y1;wy++)for(let wx=wa0.x0;wx<wa0.x1;wx++){const ai=(wy+a.originY)*a.width+(wx+a.originX),bi=(wy+b.originY)*b.width+(wx+b.originX); const d=Math.abs(Number(A[ai])-Number(B[bi])); if(d>1e-9)diff++; if(d>max)max=d;n++;} padding[name]={n,diff,max}; assert.equal(diff,0,`${name} changed after world padding`);}
+// Both patch modes must report the same unified generator mode. Use modest rectangles to keep the validation fast.
+const c=createWorldMap(structuredClone(init)); const cr={x0:c.originX+50,y0:c.originY+45,x1:c.originX+150,y1:c.originY+145};
+const regen=generatePatch(c,cr,{...opts(),patchMode:'regeneration'}); assert.equal(regen.ok,true,regen.reason||regen.code);
+const d=createWorldMap(structuredClone(init)); const dr={x0:d.originX+MAP_W-30,y0:d.originY+40,x1:d.originX+MAP_W+90,y1:d.originY+150};
+const exp=generatePatch(d,dr,opts()); assert.equal(exp.ok,true,exp.reason||exp.code);
+assert.match(String(regen.patchGenerationMode||regen.humanGeography?.patchGenerationMode||''),/unified-world-native/);
+assert.match(String(exp.patchGenerationMode||exp.humanGeography?.patchGenerationMode||''),/unified-world-native/);
+console.log(JSON.stringify({ok:true,padding,regenerationMode:regen.patchGenerationMode,expansionMode:exp.patchGenerationMode},null,2));
+process.exit(0);
diff --git a/archive/generated-history/WORLD_NATIVE_FINAL_NOTES.md b/archive/generated-history/WORLD_NATIVE_FINAL_NOTES.md
new file mode 100644
index 0000000..59a3383
--- /dev/null
+++ b/archive/generated-history/WORLD_NATIVE_FINAL_NOTES.md
@@ -0,0 +1,20 @@
+# World-native patch generator final notes
+
+## Implemented
+- Regeneration and expansion now call the same `generateUnifiedWorldNativePatchCandidate()` path.
+- World-native seed construction excludes candidate origin, candidate size, and selection/context rectangles.
+- Padding-invariant geographic coordinates are `arrayX - world.originX` and `arrayY - world.originY`.
+- Terrain, settlement jitter, land-use/human geography inputs and patch-noise paths use world-coordinate context.
+- Expansion is split on a canonical world-coordinate grid; internal tiles share the pre-operation generated-coverage snapshot.
+- Large/tiled expansion keeps final terrain/admin/transport coherence as one aggregate pass.
+
+## Verified
+- Left/top world padding: elevation, sea, plain, agriculture, populationDensity, prefectureRegionId and adminId all match exactly over 16,800 compared cells.
+- Regeneration reports `unified-world-native-patch`; tiled expansion reports `unified-world-native-patch-tiled`.
+- Large Worker expansion completes with seam clean.
+- STEP15 and STEP17 pass.
+- Existing river/capital/tiny-prefecture/frontier regressions pass.
+- Freeform lasso completes with seam clean.
+
+## Remaining contextual edge behavior
+World-native *base generation* is invariant, but the outer seam is not frozen forever. When a selection is enlarged, cells that used to be the outer seam become interior and are recomputed by final seam/admin coherence. In the 258x183 -> 259x184 stress comparison, sea and adminId are identical in the common area; prefecture IDs differ in ~5.1% and elevation differs in ~3.9% (mean absolute difference ~0.00518). These differences are predominantly the final outer-boundary coherence layer, not a change of the underlying world-coordinate generator.
diff --git a/archive/generated-history/WORLD_NATIVE_FINAL_VALIDATION.json b/archive/generated-history/WORLD_NATIVE_FINAL_VALIDATION.json
new file mode 100644
index 0000000..218fa58
--- /dev/null
+++ b/archive/generated-history/WORLD_NATIVE_FINAL_VALIDATION.json
@@ -0,0 +1,351 @@
+{
+  "ok": true,
+  "architecture": {
+    "regenerationGenerator": "unified-world-native-patch",
+    "expansionGenerator": "unified-world-native-patch-tiled",
+    "worldCoordinate": "array coordinate minus world.originX/originY",
+    "selectionGeometryExcludedFromWorldNativeSeed": true,
+    "canonicalExpansionGrid": true
+  },
+  "worldNativeUnification": {
+    "ok": true,
+    "padding": {
+      "elevation": {
+        "n": 16800,
+        "diff": 0,
+        "max": 0
+      },
+      "sea": {
+        "n": 16800,
+        "diff": 0,
+        "max": 0
+      },
+      "plain": {
+        "n": 16800,
+        "diff": 0,
+        "max": 0
+      },
+      "agriculture": {
+        "n": 16800,
+        "diff": 0,
+        "max": 0
+      },
+      "populationDensity": {
+        "n": 16800,
+        "diff": 0,
+        "max": 0
+      },
+      "prefectureRegionId": {
+        "n": 16800,
+        "diff": 0,
+        "max": 0
+      },
+      "adminId": {
+        "n": 16800,
+        "diff": 0,
+        "max": 0
+      }
+    },
+    "regenerationMode": "unified-world-native-patch",
+    "expansionMode": "unified-world-native-patch-tiled"
+  },
+  "selectionThresholdComparison": {
+    "a": {
+      "tiled": true,
+      "tileCount": 2
+    },
+    "b": {
+      "tiled": true,
+      "tileCount": 4
+    },
+    "common": {
+      "elevation": {
+        "n": 47214,
+        "diff": 1831,
+        "rate": 0.038780870080908206,
+        "meanAbs": 0.005177739778349026,
+        "maxAbs": 0.4071335792541504
+      },
+      "sea": {
+        "n": 47214,
+        "diff": 0,
+        "rate": 0,
+        "meanAbs": 0,
+        "maxAbs": 0
+      },
+      "plain": {
+        "n": 47214,
+        "diff": 2214,
+        "rate": 0.04689287075867327,
+        "meanAbs": 0.002550405116033862,
+        "maxAbs": 0.20580322295427322
+      },
+      "agriculture": {
+        "n": 47214,
+        "diff": 2238,
+        "rate": 0.04740119456093531,
+        "meanAbs": 0.0010068689713980234,
+        "maxAbs": 0.08625703305006027
+      },
+      "populationDensity": {
+        "n": 47214,
+        "diff": 18,
+        "rate": 0.0003812428516965307,
+        "meanAbs": 8.295775460319255e-08,
+        "maxAbs": 0.00030538812279701233
+      },
+      "prefectureRegionId": {
+        "n": 47214,
+        "diff": 2408,
+        "rate": 0.051001821493624776,
+        "meanAbs": 0.12121404668106918,
+        "maxAbs": 3
+      },
+      "adminId": {
+        "n": 47214,
+        "diff": 0,
+        "rate": 0,
+        "meanAbs": 0,
+        "maxAbs": 0
+      },
+      "prefectureRegionIdBoundary": {
+        "a": 633,
+        "b": 937,
+        "xor": 304,
+        "normalized": 0.19363057324840766
+      },
+      "adminIdBoundary": {
+        "a": 3570,
+        "b": 3570,
+        "xor": 0,
+        "normalized": 0
+      }
+    }
+  },
+  "largeWorker": {
+    "ms": 23764,
+    "outer": true,
+    "inner": true,
+    "tiled": true,
+    "tileCount": 6,
+    "seam": "clean",
+    "reason": null
+  },
+  "reportedBugRegression": {
+    "ok": true,
+    "riverSeaPoints": 0,
+    "duplicateCapitalPrefs": [],
+    "missingCapitalPrefs": [],
+    "generatedSizes": [
+      [
+        3,
+        1333
+      ],
+      [
+        4,
+        4239
+      ]
+    ],
+    "tinyGenerated": [],
+    "landLandPairs": 102,
+    "maxEstablishedFrontierElevationJump": 0.0364,
+    "adminBreaksOnEstablishedFrontier": 0,
+    "prefectureBreaksOnEstablishedFrontier": 0,
+    "frontierAdminCellsAligned": 0,
+    "establishedFrontierAdminCellsRestored": 0,
+    "frontierHarmonizedValues": 0,
+    "seamStatus": "clean",
+    "seamGateReasons": []
+  },
+  "uiState": {
+    "ok": true,
+    "cancelButton": true,
+    "watchdogSeconds": 60,
+    "escapeCancelsBusy": true,
+    "clearDiscardsPendingPreview": true
+  },
+  "freeform": {
+    "ok": true,
+    "tileCount": 5,
+    "ms": 31734,
+    "seam": "clean"
+  },
+  "step15": {
+    "ok": true,
+    "transport": [
+      {
+        "seed": 1,
+        "seconds": 4.89,
+        "roadCells": 2122,
+        "adminCenters": {
+          "total": 45,
+          "covered": 45
+        },
+        "connectivity": {
+          "beforeComponents": 3,
+          "afterComponents": 3,
+          "added": 0,
+          "failed": 1,
+          "attempted": 1,
+          "rounds": 1
+        },
+        "finalOutput": {
+          "components": 6,
+          "requiredStubsAdded": 6,
+          "endpointConnectorsAdded": 3,
+          "prune": {
+            "beforeComponents": 12,
+            "afterComponents": 6,
+            "pruned": {
+              "minor": 11,
+              "national": 1,
+              "external": 0,
+              "expressway": 0,
+              "externalExpressway": 0
+            },
+            "prunePasses": 2,
+            "mountainAdminConnections": {
+              "attempted": 6,
+              "added": 6,
+              "skippedIsland": 3,
+              "failed": 0
+            }
+          }
+        }
+      },
+      {
+        "seed": 3,
+        "seconds": 5.02,
+        "roadCells": 2598,
+        "adminCenters": {
+          "total": 43,
+          "covered": 43
+        },
+        "connectivity": {
+          "beforeComponents": 3,
+          "afterComponents": 1,
+          "added": 2,
+          "failed": 0,
+          "attempted": 2,
+          "rounds": 2
+        },
+        "finalOutput": {
+          "components": 2,
+          "requiredStubsAdded": 10,
+          "endpointConnectorsAdded": 8,
+          "prune": {
+            "beforeComponents": 19,
+            "afterComponents": 2,
+            "pruned": {
+              "minor": 5,
+              "national": 0,
+              "external": 0,
+              "expressway": 0,
+              "externalExpressway": 0
+            },
+            "prunePasses": 2,
+            "mountainAdminConnections": {
+              "attempted": 14,
+              "added": 14,
+              "skippedIsland": 1,
+              "failed": 0
+            }
+          }
+        }
+      },
+      {
+        "seed": 5,
+        "seconds": 3.44,
+        "roadCells": 2044,
+        "adminCenters": {
+          "total": 45,
+          "covered": 45
+        },
+        "connectivity": {
+          "beforeComponents": 5,
+          "afterComponents": 4,
+          "added": 1,
+          "failed": 2,
+          "attempted": 3,
+          "rounds": 2
+        },
+        "finalOutput": {
+          "components": 9,
+          "requiredStubsAdded": 10,
+          "endpointConnectorsAdded": 3,
+          "prune": {
+            "beforeComponents": 22,
+            "afterComponents": 9,
+            "pruned": {
+              "minor": 41,
+              "national": 6,
+              "external": 0,
+              "expressway": 3,
+              "externalExpressway": 0
+            },
+            "prunePasses": 2,
+            "mountainAdminConnections": {
+              "attempted": 12,
+              "added": 12,
+              "skippedIsland": 4,
+              "failed": 0
+            }
+          }
+        }
+      }
+    ],
+    "expansion": {
+      "seconds": 24.47,
+      "seamStatus": "clean",
+      "footprintEscapedCells": 0,
+      "roadPortalsUnresolved": 0,
+      "railPortalsUnresolved": 0
+    },
+    "rollback": {
+      "code": "patch-quality-gate-failed",
+      "restored": true,
+      "sourceIdentityPreserved": true
+    }
+  },
+  "step17": {
+    "ok": true,
+    "interactiveRetryPolicy": "one requested variant per click; no hidden whole-patch retry",
+    "variants": [
+      {
+        "variant": 0,
+        "seconds": 36.31,
+        "selectedVariant": 0,
+        "hashes": {
+          "elevation": "528ea16e05aeada539dbdea076af9dd9ea7088189f10fdb0cf414e37e33902ee",
+          "sea": "c53befa66f7a2ff958c7db3465c827a481274a4e9c67d6a52ef31eb3197eb362",
+          "admin": "bdf9aa6e2e0d0526026a6e69fe3de949a626d00835347a30361b5d1a709deb70"
+        }
+      },
+      {
+        "variant": 1,
+        "seconds": 27.07,
+        "selectedVariant": 1,
+        "hashes": {
+          "elevation": "ad3a08864ca413ddebe466880032a8b3d33b48b166c5e5f10debe30c44eed4c8",
+          "sea": "295684a63f5243883c89cf9be595393cd5ce4b3714290e7efb13bae0b162f02c",
+          "admin": "1139fa28c1605224b20d99c84b06dbecdcd7d637bef10640c19a9884326c4491"
+        }
+      }
+    ],
+    "alternativesDiffer": true,
+    "explicitRenderRevision": true,
+    "singlePatchWorkerLifetime": true
+  },
+  "knownResidual": {
+    "description": "World-native base generation is invariant, but the user-selection outer seam is intentionally recomputed when the selection grows. Cells near a former outer boundary can therefore change when that boundary becomes interior.",
+    "threshold258to259": {
+      "elevationDiffRate": 0.038780870080908206,
+      "elevationMeanAbs": 0.005177739778349026,
+      "elevationMaxAbs": 0.4071335792541504,
+      "seaDiffRate": 0,
+      "populationDiffRate": 0.0003812428516965307,
+      "prefectureIdDiffRate": 0.051001821493624776,
+      "adminIdDiffRate": 0
+    }
+  }
+}
\ No newline at end of file
diff --git a/archive/generated-history/WORLD_NATIVE_THRESHOLD_RESULT.json b/archive/generated-history/WORLD_NATIVE_THRESHOLD_RESULT.json
new file mode 100644
index 0000000..209e4d8
--- /dev/null
+++ b/archive/generated-history/WORLD_NATIVE_THRESHOLD_RESULT.json
@@ -0,0 +1,73 @@
+{
+  "a": {
+    "tiled": true,
+    "tileCount": 2
+  },
+  "b": {
+    "tiled": true,
+    "tileCount": 4
+  },
+  "common": {
+    "elevation": {
+      "n": 47214,
+      "diff": 1831,
+      "rate": 0.038780870080908206,
+      "meanAbs": 0.005177739778349026,
+      "maxAbs": 0.4071335792541504
+    },
+    "sea": {
+      "n": 47214,
+      "diff": 0,
+      "rate": 0,
+      "meanAbs": 0,
+      "maxAbs": 0
+    },
+    "plain": {
+      "n": 47214,
+      "diff": 2214,
+      "rate": 0.04689287075867327,
+      "meanAbs": 0.002550405116033862,
+      "maxAbs": 0.20580322295427322
+    },
+    "agriculture": {
+      "n": 47214,
+      "diff": 2238,
+      "rate": 0.04740119456093531,
+      "meanAbs": 0.0010068689713980234,
+      "maxAbs": 0.08625703305006027
+    },
+    "populationDensity": {
+      "n": 47214,
+      "diff": 18,
+      "rate": 0.0003812428516965307,
+      "meanAbs": 8.295775460319255e-8,
+      "maxAbs": 0.00030538812279701233
+    },
+    "prefectureRegionId": {
+      "n": 47214,
+      "diff": 2408,
+      "rate": 0.051001821493624776,
+      "meanAbs": 0.12121404668106918,
+      "maxAbs": 3
+    },
+    "adminId": {
+      "n": 47214,
+      "diff": 0,
+      "rate": 0,
+      "meanAbs": 0,
+      "maxAbs": 0
+    },
+    "prefectureRegionIdBoundary": {
+      "a": 633,
+      "b": 937,
+      "xor": 304,
+      "normalized": 0.19363057324840766
+    },
+    "adminIdBoundary": {
+      "a": 3570,
+      "b": 3570,
+      "xor": 0,
+      "normalized": 0
+    }
+  }
+}
diff --git a/archive/generated-history/WORLD_NATIVE_UNIFICATION_RESULT.json b/archive/generated-history/WORLD_NATIVE_UNIFICATION_RESULT.json
new file mode 100644
index 0000000..5d89468
--- /dev/null
+++ b/archive/generated-history/WORLD_NATIVE_UNIFICATION_RESULT.json
@@ -0,0 +1,42 @@
+{
+  "ok": true,
+  "padding": {
+    "elevation": {
+      "n": 16800,
+      "diff": 0,
+      "max": 0
+    },
+    "sea": {
+      "n": 16800,
+      "diff": 0,
+      "max": 0
+    },
+    "plain": {
+      "n": 16800,
+      "diff": 0,
+      "max": 0
+    },
+    "agriculture": {
+      "n": 16800,
+      "diff": 0,
+      "max": 0
+    },
+    "populationDensity": {
+      "n": 16800,
+      "diff": 0,
+      "max": 0
+    },
+    "prefectureRegionId": {
+      "n": 16800,
+      "diff": 0,
+      "max": 0
+    },
+    "adminId": {
+      "n": 16800,
+      "diff": 0,
+      "max": 0
+    }
+  },
+  "regenerationMode": "unified-world-native-patch",
+  "expansionMode": "unified-world-native-patch-tiled"
+}
diff --git a/archive/legacy-project/.achievement_data/.gitkeep b/archive/legacy-project/.achievement_data/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/archive/legacy-project/.achievement_data/.htaccess b/archive/legacy-project/.achievement_data/.htaccess
new file mode 100644
index 0000000..fa39801
--- /dev/null
+++ b/archive/legacy-project/.achievement_data/.htaccess
@@ -0,0 +1,6 @@
+<IfModule mod_authz_core.c>
+  Require all denied
+</IfModule>
+<IfModule mod_access_compat.c>
+  Deny from all
+</IfModule>
diff --git a/archive/legacy-project/.achievement_data/state.json b/archive/legacy-project/.achievement_data/state.json
new file mode 100644
index 0000000..6939f24
--- /dev/null
+++ b/archive/legacy-project/.achievement_data/state.json
@@ -0,0 +1 @@
+[4,1784091728,["39.16.75","39.16.105","39.16.123","39.16.60","39.16.74","39.16.137","39.16.104"],["first_birth","natural_zunchi_slave","natural_tarinai_king","self_zunchi_death","zunchi_collision_death","natural_zunchi_slave_5_generations","natural_tarinai_king_3_generations","death_50_in_10_seconds","birth_50_in_60_seconds","great_mother_1000_births","lifespan_completed","soccer_ball_death","fight_pair_danger_kill","all_non_sleep_diseased_25","colony_happy","direct_feed_33","ignite_during_birth_ritual","laxative_starvation","idle_observer_5_minutes","placed_objects_100","mechanized_industry","safe_colony_25_5_minutes","ants_alive_25","ants_killed_100","secret_collection_9_slots","pause_spam_4_in_1_second","continuous_play_1_hour","below_absolute_zero_item","undo_mass_revival","robot_cleaner_100","held_30_seconds","minimalist_happy","overprotective","self_sufficient","unplanned_city_30","sauna_cold_plunge","rain_shelter_all","medicine_ledger_all","mercury_lifespan","enemy_enemy_friend","revolution","fuel_to_fire","undo_20","redo_20","eternal_history_generation_10","king_full_satisfaction","slave_zero_satisfaction","town_doctor_50","poke_plushie_fling","chaos_seeker_666_fights","clean_freak_robot_only","true_tarinai_observer","sniper_333_shots","megalopolis","fertility_seeker_721_love_births","low_fps_single_digit","continuous_play_24_hours","sandbox_five_toilets","park_ground_changed","ground_change_4_in_1_second","ant_nest_without_tarinai","sticky_bomb_15_passes","daily_play_7_days","wire_shock_7_tarinai","information_industry","strength_in_numbers","elite_few","zunchi_overflow","comfortable_beds","stone_pillow","across_seasons","favorite_one","statistician","well_informed","lively_making","memento_mori","mad_scientist"],[["AT7UX0vQQHSjDSsx7ntrcA",115523,0,4],["AXHGXDetQkWuJ2vrhLVrsw",191206,599],["AZOq9iLdRLiVs_J1HNcdNg",26632,311131,1],["AgioecJAT9-DyKM9rBWwFg",354351,233,1],["An-kM9_1Rkuiu0eIHnJROw",24687,416999,5],["A9UhC-axRtWKy4Vw8NRLjA",225077,15],["BmyezTENRtm5ekkH3z99qg",289868,146256,5],["BsqXI2J_RTCLzl9rK-WTVQ",201094,16],["B5myaZslQwSnpkvoGpknsA",37613,1800,3],["C0tajnOTT1K0FgIfEGVsGA",256959,2973],["C4GRUxmdRbWZzHJ0V9JpsQ",17432,357474,2],["C8XqqJ5rTHa6qw-z8Y88jA",365330,744,1],["DFKBeF9-RpKfjhRhQx2ZRg",174267,14974],["DGPMjLtqRaCtHIptLtkjdw",221295,2546],["DyaOro6TQ5G_TeHnltFK0g",67643,146960],["EGSebCuwSk6FKdPePBeDOg",118168,1199,4],["EgkHNUQJQPat3FM4ZIU59w",156003,0],["EyToTt3-RX26J-6eJ-xpPw",191733,6600],["E0HXsU6-RYCO91MK9M07bw",9762,104722,4],["E2ldSdcxQN-zZ9xTBzDE1g",368929,299,2],["Gr93GoiFQkGMHKs2Mw4AaQ",97655,9130,3],["G2o3yC0MTIKMLhDk2o6YDA",245190,7797],["HYkDqmCsS8aiMrUThI4fcQ",201617,13],["Hns48Q0MQJ2H-lFEmwxfQw",23523,603,3],["HwT0Sk-XSGahzteQS7FPzQ",287737,92777,2],["H5ZDYEFvQ0e-3JC0xPTx-Q",27702,421,3],["ITRYJzo5QYaSkjLYaaJ6Yg",40636,46882,3],["ItNN0heHRqiNHc-OoGoSMA",297825,1298,1],["JuwFpfb1QJeYfGvWpzy3IA",63369,126598],["J7uf1v88T3mSFs1ptKO9RQ",120239,25],["KSZ59taVRJmYmVYVhe99hg",77159,1800,3],["KwJlifxVSh-GUDpUNABzrw",369833,308,2],["LDAWke6kRbutWe3r9dfLdQ",318649,776,1],["Li2NtIyOQpGHzFaEovEoYg",100406,0,4],["MEMut_ufQsmx1rPi45G81Q",36627,395276,2],["Mpv6WJHGTw6YwQQ70mk7BA",13479,80,3],["Nf-0jB-JQ0-UZnRWPHS98A",300640,4006,1],["Nhx8JhVfTOWAYRt1vRuQow",113724,74645],["NjK9LbETSzOX-LpfqL0nxg",255226,103273,1],["Nj7jeXEWTXa6Sm5VPRlmEg",206684,123],["NkwzEL98Rzi4GwdSd5A3ng",20301,0,3],["NuaRm_fYR7Sz8nVs4P4yCg",114763,34,4],["Nvzk_2oQQbawaZca4Pww2Q",291531,73544,1],["NxW5_hQ1SoO5iSuv66RCfg",270726,299,1],["Nx2nfW9iRpeJXcFw7IOdIA",283823,976,1],["QD38IUY8RJeCcN0xwmTyTQ",269572,9325,1],["QQx3jG6FR2-TJx80sIlCUA",241410,16],["QoCQg7HPQYKYtzZY6V5tTQ",375227,2400,2],["Q-YwoP68T6anCkkhU6gLAg",234541,3300],["RB-Tlne5T4OxgjAQO0_ysg",381794,740,2],["RB_DGMVqRV-QbX2uFDTRpA",365383,1322,1],["RVu0RBgqRbipwYNU50e9qQ",343860,0,1],["RrNxNSRsSiKVxmeMQo6lPg",433513,222,2],["R6bORyS0QYGxKejqyoB10A",303512,14,1],["SG0ktBVwR5Os_MDzYJoawQ",39040,599,3],["SfZYmhpyRZCwrqBiw9kqUA",132898,357],["SjYuiyoHTeivYcMyKoRGNg",337249,104061,5],["S5DpVCRaThahOqTSMlWPDA",89164,337690,2],["TUKrrmrET2ypgp5DaU4tlA",18426,0,3],["T9GkyS2HSqKbKoqMiC7WXg",47094,16,3],["URXE_032StGQlEl3V17HXQ",374574,2899,2],["UdLsI4uyQ_S-XN7a4N5CvQ",34688,392712,2],["UqaJ9nvhQl-eT-Bey1m8Rw",16731,420407,5],["U2UehYHxQ5248yI8fy7_iw",145756,39],["VRG1ggLhStGW9MXAb65Btw",31668,17,3],["WQ3Ku6CJTWaCLabPhA951w",363389,625,1],["W_G-e_6AT4qICRL-Hz05sA",119138,14,4],["XNVK7HGDTMiNp8dsEPgM2A",52741,13,3],["XdDGg7MrTG2ZNpPIVpk3VA",119422,14,4],["YIXXT1hTSrS0ESGYH59www",422182,1798,2],["YKJXT2URTSydN9aUmkJOKA",179869,1221],["YYaufcmaQ4GiD9Q_MZuMWw",299654,335,1],["Yads3JcpTMymeKumAQcF6Q",362480,16,1],["YkBYIYwHRYOwkX0fmeqT4w",249642,299],["ZBBiN426T3WEYxVBXituGQ",90719,15103,4],["ZHedzwwERgmbHhpZuIEoeg",110056,94,4],["ZO4ZHBKxRyu5IlOdEiaMjQ",173877,0],["Z2KTakqhSTuWysEEAKyGXA",195554,109463,1],["a7UWcDOyToOQycGTu33MeQ",214800,148558,1],["bFoT0vGfRSapP6saKj_L6g",423544,3600,2],["bP42-AJoR4CDwWnCKWHocQ",232663,300],["bcxw7HujQFi5Y1YOMwQOfA",121952,23511],["b-Q9bhMZTHGa_blAGuZseQ",341953,599,1],["cnupw5mWSfS4hwLnV1L2XA",248428,106847,1],["csNqBKPtRNe25Pr757SKaA",203517,9051],["dQ3Y_1tPRZ6oPIRWPKo4aQ",194363,0],["dqOnFoBXTlqwDr8C2mv5yw",25033,404829,2],["eKNNK69YS6-iu0qhfQ6p9A",125751,14],["eifTn_kTRgSMWj6KYbalIg",100380,14,4],["fGJd8BQqRkai1XTM6B7nEw",13459,279970,1],["fJLe4FHgS2O9b-hFtG9Ldw",344682,594,1],["gAlvRzRXTLOxqgdwcRxLQw",421603,301,2],["gMC_86VbT7uIH8B0fdKxlA",14550,0,3],["gVlK1ilNRPeMIPUAA-JRtQ",221160,13],["gcRLtucSTrGWq7WYznfTmQ",290969,899,1],["i8Ff_VXpTFORsOhh4jZHbQ",280665,51,1],["jAw6RpvST3OEMAvbeH77LA",240387,221],["j-mNs4bdSI2XqAhGb4p3Hw",88836,20,3],["kBFvt4RRSai3DmGuyfgf6w",19817,2574,3],["kUEPr6JJTz6mCwWJDLv-aQ",115199,2400,4],["mlBIJs6mT52AX2Ahpgh7sw",196651,3934],["mswKVgE5Qxqta4NAHvVkoQ",437951,14,5],["nTWtsnADSv648AxbFz4Lcg",212355,9300],["nVUbi4OmT6-J9byg8-q97g",32001,1123,3],["nxblVyMLTrSZAkfPf2FWwg",383336,26486,2],["n-SY48K2QeqzCkb7yTZPpQ",259675,1200],["n_tcf3j7S6yBYt2Y7yM85A",293624,169,1],["odJ_h7oUS1yB_7p6LB4w7w",112982,342,4],["oe139e_bR4WtnCcqSe2jBQ",332048,0,1],["o4yHwSx2SX24OE9qPkJHsw",432488,825,2],["pQFs21PfTXuXeaf1tEVdMQ",129750,4545],["qTwJtmQESIC3jAtmz_8sTg",423097,13,2],["qnK6RnesT2igW_HcZssIdA",97976,334829,2],["qs3rnavAT4acYZvaEeI5oQ",129913,1199],["qxGFhkHZTduV9YYYWyDSUg",147480,273846,2],["r75L6GPkR4uVqBqO_1aSyA",355137,2246,1],["sSCrwsqiSyqBVgz7Matzww",299588,101812,2],["s3O6OZTBRz6O0TUBQC64QA",23489,245,3],["s_uTFGOTQdKTmWoJ9Vbzpg",24710,357292,2],["tMDzFziXTJ2CYoBLWq9H9Q",8579,433201,5],["tWF1yvWnTfOaaaBAbXwtPA",29003,17,3],["taU6vA6PTjWhKC6V43YplA",24383,411287,2],["t2UqLSrEREKy0Ai8JSYKGQ",203662,113],["t7tpQzqNRV6-tLSbunsDfg",302098,133,1],["t_SyOC8gTi218xAe4vOGgw",382434,7684,2],["uAtfx_GBRvmJCP6E9UWmzg",100421,15175,4],["uU2jxY3bRBe7AtfHRFGSIA",34810,299,3],["uqFbOGx4S_6ZvjcQrWE2Bw",26634,346405,2],["v1K6sNSCRdWXvmk8Jl91sQ",20955,298322,1],["wBeR6TKiQ1SnWlxO6HjxUg",208309,1199],["wF4aj-hSTl-BSuCbVRywOA",429094,2999,2],["wK3oJUoHT5Kb0jeLIzFJJQ",184790,16],["wM8XiYo0R9SEcCkDjO2bxQ",390457,1499,2],["wQwjJN_pSSOryn69Y8lqyA",16767,418804,2],["when_J1OTpScd-vaA2i6xw",341088,309,1],["xhjNabCzQHGEWRw9eEFAYQ",101690,275766,2],["xnEBJGKVSSC7--M0K_e2JA",364391,1764,1],["yYHnh-RxQaOcASVbQj6gOg",297672,2435,1],["yp2M01VvTle5xgXu7ZNzqg",204919,14],["ys4oahR7TDm9WW5zOKyShA",30073,1310,3],["zJtKDIeiTM2oegMGMt3nvg",343271,0,1],["zLFzVsWhSTOYU6rJsMsi1Q",20602,1472,3],["zOC7w26xQYiGnLQy3x504A",57982,44,3],["zmEzLb-1Q6m08t7dLiqFdw",11424,599,3],["zn1ecYMwRNKrJukPfPFoXQ",103760,282772,2],["zsuxu35fRq6bIZCvcC3iag",106311,285,4],["0Ekuj3W8Qpm_EwKpSXYdXw",377873,19,2],["0KpzjsoqQYaN_S2X8ySd7w",22236,352889,2],["0ia10T1pSZmAKukutrEaIA",31969,87661,4],["0lcgISlzQEej3cvhI-e-Ww",289089,82410,2],["0y4SH2FXRYGK1d0FCkOUjw",378025,6741,2],["00Z1M7PFTqq9iwnnCxiZTA",269597,166,1],["1dKF4NRHRfaJtfQr4lafCg",40381,1201,3],["2Bdkm5NaSY2lY1VMj_1Mqw",69602,16,3],["2jtrVkYNQtGpp7Y2wSOwZQ",304589,74,1],["2rseIRu9RAuvUuNOsSO_-Q",26626,18,3],["28TEqRx1QuK-TmIYSLzL1Q",34802,0,3],["3E-4jv0QSPq33RbRg4B3Aw",423829,7130,2],["3XJWUCjdRgSxmd5Z1hfDcw",16826,420725,5],["3cXtHb7yRQSBcQK7yx-_zw",232365,465],["3mSl6ER2RtSj9a0p-sNDMA",430880,299,2],["4JrymWEKThuc99N1_G1_rQ",11020,430720,5],["4XM-EZ63SiSRpbvcIqdZyw",133745,183813,1],["4u-CXB7uTwuNWoFuQ2ZO9g",196903,14],["5aQrgazaTe2oNgyFnFVOFA",25453,8280,3],["5c9NjVEiSOGVeFiQ9tdHYg",217415,3322],["5woLhtEbSPuhPazSSQoluA",197842,0],["6kdvBVYWSuuyehSCCPGLYw",11195,237,3],["6ryKJq12TO-2vFdLKAIPXw",100122,163,4],["7587mqPLR3iJGXGBXjcDIQ",194177,56975],["8M_zxblPSkGw-_mE0gJUXQ",364739,2101,1],["9OZ_7xz9SkS56dk0cpJsLA",279830,659,1],["9UnXYYzZSYiFRDOzfNeCvw",264541,6248,1],["9gX-Lr9aTTKqMIA4Mb5MGg",28665,254163,1],["9pgiN8b5R8CzMX_G28g_Xg",388466,3300,2],["9uEITVHeQXegRVD6lXnz8w",297708,5964,1],["90eBgHt_S0Gai4x7q3f8eA",10519,253386],["92hhaxj2R1mlus6Ck9XBPQ",268366,15,6],["-Haa3Cb8RzO-mee5e4tggA",147060,1287],["-Rrwi9qrTv2pEbUgjIPivw",142099,14],["-3NMp6qyR9q05KN8ZX48Dg",33123,33796,3],["_MZl_4kLSDGUuDuNMl1-6g",369100,2265,2],["_QIygAxARMO5xTL3TO8SKg",90452,14,3],["_66f6qhySiOVSH5VcwD-kQ",293656,137,1],["_7nqDabvQF2tbBmkp4eb6Q",386660,0,2]],[[0,1,191271,2,26643,3,354359,4,24701,5,225088,6,289885,7,201106,8,37620,9,256968,10,17452,11,365338,12,174277,13,221305,14,67654,15,118185,17,191745,18,9776,19,369026,20,97667,21,245351,22,201626,23,23539,24,287749,25,27715,26,40652,28,63416,29,120261,30,77482,31,369844,32,318670,34,36639,35,13497,36,301783,37,113723,38,358493,39,206694,41,114776,42,291542,43,270735,45,269660,46,241420,47,375235,48,234562,49,381817,50,365395,52,433544,53,303521,54,39051,55,132912,56,337258,57,89223,59,47106,60,374592,61,34699,62,16742,63,145791,64,31682,65,363398,66,119148,67,52752,68,119433,69,422209,70,179877,72,362490,73,249681,74,90750,75,110092,77,195567,78,214810,79,423559,80,232673,81,121976,82,341963,83,248473,84,209959,86,25044,87,125762,88,100391,89,13473,90,344691,91,421843,93,221169,94,290981,95,280684,96,240401,97,88854,98,20420,99,115231,100,196666,101,437964,102,212360,103,32024,104,383388,105,259692,106,293635,107,112992,109,432574,111,423110,112,97987,113,129925,114,147489,115,355186,116,299605,117,23525,118,24722,119,20,120,29018,121,24421,122,203672,123,302108,124,382456,125,100417,126,34821,127,26661,128,20967,129,208332,130,429106,131,184801,132,390470,133,16796,134,341114,135,101701,136,364515,137,297724,138,204929,139,30097,141,20613,142,58021,143,11514,144,103781,145,106348,146,377892,147,22247,148,31993,149,289102,150,379181,151,269607,152,40388,153,69615,154,304597,155,26641,157,424098,158,16839,159,232374,160,430897,161,11034,162,192807,163,196695,164,25878,165,217502,167,11258,168,100136,169,194187,170,364747,171,279840,172,266280,173,28677,174,388528,175,297712,176,10531,177,268378,178,147110,179,142110,180,33135,181,369117,182,90463,183,293665],[1,1,191403,2,26877,4,25011,6,290244,8,38012,10,135101,11,365564,12,174521,13,221461,14,70866,15,118434,17,194565,18,10436,19,369151,21,245755,25,27750,26,40966,28,63838,30,78953,31,369987,34,271072,36,302091,42,292625,45,269918,47,375662,48,234981,49,382343,50,365969,56,337683,61,35564,62,17369,65,363850,70,180343,73,249848,74,93618,77,281773,78,214997,81,145234,83,248720,84,210906,86,25873,89,13762,90,344778,98,21616,99,115359,100,196869,102,214588,103,33124,106,293788,109,432827,113,130388,114,419890,115,355381,116,300912,118,24984,119,25211,124,385030,126,35004,128,21266,129,208665,130,429479,135,377244,139,30472,141,20849,144,290828,147,374711,149,371387,150,380038,157,425942,158,17350,159,232638,161,11255,169,251142,172,266492,173,200146,174,388714,175,298220,176,116422,180,33438,181,370575],[2,1,191761,2,26936,4,25652,6,290128,10,135093,11,365556,12,174506,13,222661,14,204836,15,119256,17,194663,18,112037,21,245876,26,41195,28,63729,36,302040,42,292786,45,269974,47,375721,48,234981,50,366237,56,337503,61,35520,62,17526,65,363886,70,180169,74,96379,77,282412,81,145315,83,248754,84,211047,86,25686,89,13752,90,344804,99,115637,100,197049,102,216835,113,130997,114,419917,115,355380,118,25605,119,25371,124,383289,128,21230,130,429474,135,377269,139,30496,141,20917,144,385343,150,379732,158,17595,159,232666,161,11354,171,280197,172,266472,173,200160,174,389034,175,298714,176,116572,181,370591],[5,74,101510,89,120349,128,22252,173,200261],[6,2,27153,12,174657,14,207834,89,13796,128,21666,173,200632],[7,1,191426,4,26737,6,290782,8,38242,9,259927,14,83478,23,24000,25,28120,30,78409,32,319011,34,38178,37,188014,43,270914,47,376773,49,382530,54,39411,61,35165,62,18098,74,91322,77,283158,81,122210,82,342359,83,249109,89,15076,102,212507,104,408595,105,260129,115,356759,121,25152,124,382604,127,27380,128,55608,129,209435,133,108888,135,147785,136,365613,137,299395,141,21485,149,289208,152,41570,157,424893,158,17870,161,280009,162,235865,170,364915,172,268642,173,113688,175,297802,176,10914,181,369796],[8,1,191304,2,27344,4,24911,6,290372,8,37848,9,257230,11,365879,12,174714,14,67718,17,197179,18,113098,21,245454,23,23612,25,27763,26,41186,30,78269,32,318871,34,36704,37,187874,42,294092,47,375996,48,235366,49,382263,54,39237,57,89275,61,34845,62,16821,74,90789,77,195597,78,294671,82,342519,83,248882,86,25562,89,14016,90,345085,100,198235,102,213131,104,408208,105,259742,112,98505,115,357048,119,267855,121,24568,124,382481,127,26894,128,22228,129,209359,132,391324,133,108196,136,365559,137,298989,141,21239,148,114644,149,290977,150,379324,157,424728,158,17014,161,11623,162,235545,164,27402,165,217591,167,11431,172,266558,173,28743,174,390487,175,297945,176,10852,181,369155,183,293764],[9,4,24947,14,124595,21,251727,34,254051,89,204437,121,24568,133,108196,158,20008,172,268084],[10,10,374646,11,365856,18,29044,21,246093,36,302622,42,293318,45,270168,61,35664,70,181083,74,94416,77,282919,84,211479,89,14055,99,116043,102,218148,115,355704,116,303469,124,384432,128,55963,130,431869,157,430786,158,24354,172,265911,173,282338,174,390520],[11,4,26736,17,192182,34,120809,36,304372,47,376752,48,237261,49,382325,61,426657,62,17177,74,92754,77,283423,83,249108,100,197742,102,213730,112,98720,114,420746,124,385160,128,318806,136,365447,137,299353,144,289095,149,290481,158,20965,160,431153,161,280037,172,264711,173,114102,175,300912],[12,1,191425,4,24722,6,290787,8,38527,10,374316,14,121713,17,196675,18,107315,20,97778,21,252728,23,24000,25,28120,30,78592,32,319011,34,108438,36,303508,37,113790,42,291912,47,376820,49,382397,50,365551,54,39407,56,337608,57,90476,61,206402,62,16919,74,91648,77,281947,78,294736,81,122083,82,342093,83,353761,84,211929,89,43353,94,291137,96,240608,100,197078,102,212515,103,32514,105,260264,107,113267,113,130585,114,419848,116,300962,124,382645,127,27423,128,55609,132,391032,133,108887,135,147784,136,365614,137,299469,143,11706,144,104301,145,106594,147,374763,149,289257,150,384351,151,269757,152,41479,157,425607,158,18012,161,110764,162,235879,168,100284,172,270247,173,113699,175,297801,176,10593,178,147214,181,370718],[13,4,24758,14,71230,34,242398,48,235358,61,35471,74,98685,133,108887,158,78115],[14,45,273422,78,215806,84,204504,110,132675,116,401030,124,383690,130,431406,136,365236,158,74280,175,298584],[16,4,26004,8,38458,14,210165,17,196587,18,10744,20,98085,25,27833,42,291833,47,376752,48,236419,54,39421,57,303665,62,18071,74,91316,77,301630,78,294675,81,122023,83,355044,94,291093,96,240572,102,213445,104,383590,115,357109,116,398245,118,380402,124,384746,128,56573,135,376985,137,299172,148,32382,157,425513,158,17750,161,11805,175,297873,181,369640],[17,3,354469,4,25296,6,290190,12,175855,14,103020,17,194491,28,64429,30,78286,31,369999,34,182984,54,39586,55,133085,57,302318,61,207064,62,179559,74,92764,77,282434,78,286253,82,342039,83,248781,89,42902,100,197667,102,212649,109,432657,112,98249,113,130070,114,420504,116,300601,118,25397,121,26268,124,383302,126,35081,130,431627,132,391584,136,365374,137,299921,143,11632,157,429460,158,21084,161,11375,173,113883,175,300479],[18,4,25332,10,135105,11,365623,12,175107,14,71139,17,196976,18,112078,21,245597,36,304490,42,292808,45,272914,48,234998,56,346890,61,206011,70,180164,73,249874,74,99353,77,284595,78,215864,81,145286,86,429778,89,13788,90,344982,98,21613,99,115373,100,198070,102,212467,105,259888,115,355780,119,25912,121,26268,124,388453,128,21255,130,429684,141,20897,144,384877,149,291763,150,384742,158,24245,162,288310,165,217575,172,267542,175,299709],[19,1,191505,4,25153,6,290163,8,37859,9,258622,13,222651,14,124567,17,195544,18,107317,21,251485,23,23627,25,27916,28,188921,30,78400,32,319421,34,36844,37,187526,42,292712,47,376156,48,236882,49,382399,50,365450,57,302393,61,34956,62,17794,74,91304,77,281875,78,363130,81,122066,82,342083,83,249043,84,208552,89,43348,96,240575,102,212853,104,408403,105,260336,109,432658,113,130646,114,419593,116,300144,118,25369,119,267176,121,24824,124,382580,127,26983,128,57118,129,209100,130,431893,132,391901,133,108754,136,365494,137,298902,139,30309,143,11760,144,288492,145,106522,147,374823,148,116020,149,289201,152,40754,157,425760,158,17343,161,279984,170,366547,172,266672,173,113460,174,390196,175,297850,176,116964,181,369630],[20,4,25189,121,24824,124,385693,133,108754],[21,2,26996,61,427115,89,195346,157,428408,158,263423,162,287847,172,267224,173,281557],[22,14,123728,17,197312,18,107323,21,252670,47,377566,62,17096,74,91943,77,281723,83,354448,100,198850,102,213072,107,113311,116,304590,124,382583,127,372792,132,391115,136,365580,137,300102,150,384682,152,41478,158,22009,172,269722,173,201023,175,297768],[23,74,92072,77,302595,102,213092,124,384683,158,106247,172,269734,175,300252],[25,1,191404,14,210559,74,103507,77,282901,78,214910,82,342291,83,249655,102,212392,124,384532,127,112599,133,108407,149,289120,175,298129,181,369126],[26,12,185477,14,109479,17,195329,21,248783,42,295126,45,273163,56,346839,74,96996,77,208550,84,207107,89,110513,102,215942,110,134283,116,304075,119,110526,121,114968,124,386037,128,60621,133,108407,144,386532,148,117825,150,381627,157,429459,158,25016,175,303068],[27,61,36271,121,114968,124,383305,133,434195,139,30359,149,290550,175,302397],[28,102,216662,124,382614,175,297813],[29,1,191381,2,26831,4,25093,6,290187,8,38238,10,296441,11,365547,12,174667,13,223097,14,71264,15,118514,17,194670,18,10718,19,369203,20,98030,21,245525,23,24040,25,27853,26,41154,28,63954,30,77655,32,319016,34,36880,36,302068,42,291863,43,270947,45,269762,47,375812,48,235044,50,365896,54,39410,55,133254,56,337622,57,89600,61,35319,62,16966,65,363856,69,423612,70,180530,73,249892,74,91305,77,281807,81,122103,83,248967,84,211240,86,26562,90,344834,94,291135,96,240590,98,22085,99,115666,100,197074,102,212540,103,32485,104,383811,107,113262,109,432692,112,98804,113,130302,114,419910,115,355419,116,303556,118,25022,119,526,121,25203,124,382636,126,35057,127,26920,128,21320,129,208926,130,429477,132,391434,133,109367,135,377050,136,365057,137,298037,139,30386,141,20839,143,11694,144,103933,148,114947,149,289297,150,379630,152,41539,157,424904,158,17243,159,232762,161,11410,162,287928,164,28962,165,217992,170,365437,171,280205,172,265906,173,28954,174,389148,175,297884,176,10921,181,369297],[30,4,25129,121,25203,133,109367,161,369733],[31,10,374525,12,176382,13,221895,14,126836,18,10417,21,246095,25,28086,30,78065,32,319287,37,188289,42,292307,45,270035,47,377041,50,366703,56,338039,57,90141,61,207037,70,180845,74,93795,78,215776,83,249727,84,204362,89,107481,99,115724,100,199494,102,214010,110,130215,114,420164,115,356298,116,301335,119,0,124,383030,127,27602,130,429954,136,364827,141,21112,157,427514,158,72072,170,366834,171,280483,172,265218,175,300421,176,263900],[33,1,191776,10,296506,11,365621,34,38079,36,302337,42,293115,47,375844,62,59047,65,364009,77,282254,81,145459,115,355837,118,122093,124,387234,128,21571,130,429714,158,19455,173,200446,174,389493],[34,8,38404,25,28065,57,302660,61,34870,74,92335,83,250320,102,213816,105,260325,116,300730,124,386317,144,289116,158,22018],[35,4,25269,6,290038,8,38275,13,222496,17,195112,18,10633,25,27809,28,64123,30,77500,34,254918,36,303374,42,360305,45,276602,48,235550,57,303544,61,36191,74,92915,83,248885,94,291731,99,115630,100,199950,102,219571,113,130782,116,401290,118,25594,121,432761,124,383293,127,27750,128,318631,132,391465,137,298306,139,30513,141,21378,148,118915,157,424086,172,270124,174,389200,175,299106],[36,4,25305,121,432761],[37,57,302377,74,92225,102,213565,119,261,124,382877,158,22256,172,266074,175,297740],[38,45,272277,74,94416,84,211479,102,218148,124,384432,158,110089,172,265911],[39,74,97963,77,281739,102,213091,124,382613,136,365592,158,173209,172,269542,173,281466,175,299583],[40,74,105068],[41,4,25170,6,289906,12,174728,14,67955,17,195667,18,113027,25,27722,50,365707,54,39168,57,90303,62,17228,69,423455,74,93501,77,301283,89,15351,91,421743,95,280710,99,116177,102,215121,103,32636,109,432665,113,129984,115,356679,116,400156,121,25726,124,384916,132,390794,135,377118,136,365993,139,31379,143,11571,145,106322,147,22462,158,17208,159,232523,161,284364,162,235523,173,113389,175,299541,176,116451],[42,4,25206,74,94427,102,216172,121,25726,124,384484,175,297822],[43,124,384494],[44,2,27065,4,24998,8,37896,9,258677,10,296542,11,365657,12,174379,14,67808,17,195704,18,112952,21,245429,23,23733,25,27777,26,41035,34,36980,36,302570,37,187908,42,292948,45,269903,47,375938,48,235017,54,39380,57,304103,61,35232,62,16865,74,90988,77,282572,80,232782,83,249042,86,25894,89,13885,90,344901,100,197788,102,214872,105,259819,112,98560,114,421048,115,355470,119,268540,121,24838,124,388670,127,26880,128,21985,129,208847,130,430084,141,21325,144,385312,148,116181,150,381354,157,425400,158,17056,161,11575,162,235759,164,28303,165,218031,172,266620,173,28827,174,389351,175,299217,176,263299],[45,4,25034,50,365924,74,105201,83,355113,99,115884,110,130804,112,98230,121,24838,137,298117,158,22765,172,265327],[46,137,299323,158,22601],[47,4,24994,13,223105,15,119001,28,189088,32,319329,48,235877,50,366471,56,337483,61,426414,74,90941,78,285331,83,249081,86,25500,89,43893,90,345028,102,213712,115,355381,116,400930,121,284262,124,386720,128,56235,129,209262,137,297767,144,385207,157,426525,158,21129,161,284250,172,265124,180,33620],[48,4,25030,49,381894,60,374700,69,423497,74,97521,75,110145,80,232716,102,213657,118,121940,119,30130,121,284262,141,22071,161,369609,169,250908,171,279948],[49,14,204027,102,221572,158,17815,175,299731],[52,42,291797,61,36074,74,97029,83,354951,102,213336,127,373039,128,318977,144,380529,173,281527,175,298219],[53,74,93052,83,353710,129,209051,158,255175,172,269548],[54,14,119904,21,248936,34,108044,61,207416,74,95588,89,14524,128,58042,157,427025,158,18504,172,268247,175,301597],[55,1,191428,2,337581,4,441091,6,290458,9,257426,10,374408,12,174844,14,118370,15,118168,17,192183,19,369078,21,245638,31,370134,32,319005,34,101422,36,301967,37,188018,42,291882,45,270154,47,376752,50,365565,60,374729,61,206787,71,299651,74,103186,77,283094,78,294682,81,122391,82,342350,84,203514,86,429769,89,192464,90,345160,99,116281,100,196668,102,212862,104,383348,105,259936,114,420753,115,355426,118,380896,121,111372,124,382565,127,372529,128,317960,129,209107,132,390869,133,107924,136,365542,137,298946,144,384220,148,114234,149,289184,150,379157,157,424868,158,106762,161,280010,162,235590,165,217561,172,266631,173,200315,174,388467,175,297857,181,369188,183,293788],[56,121,111372,133,107924],[57,6,289972,114,420957,119,266958,121,111565,127,372077,144,288507,158,110162,175,302496],[58,17,197366,21,245231,74,104124,78,215230,102,213041,121,111565,124,384598,144,287805,158,173028,165,217445,172,269648,175,297908],[59,34,391437,61,114991,65,363441,74,105537,78,215231,89,106995,90,344794,102,212810,124,384583,136,365953,158,196543,175,297902],[60,14,123957,18,107350,21,252949,36,303740,49,382413,56,346880,74,102675,77,301840,78,215467,82,342336,84,212308,94,291699,100,198904,102,215489,107,113320,114,420022,124,384639,127,372776,136,365686,150,384747,158,106330,173,201096,175,299916,176,116916],[61,1,191420,13,221449,17,197118,18,113400,32,318997,34,194687,42,291861,48,236805,57,302135,61,206823,62,179418,69,422282,77,281930,78,363173,81,122369,83,250206,100,199717,102,212500,113,130376,114,419958,116,302518,118,381733,124,382618,133,108810,135,376961,144,103912,145,106400,147,374707,149,289246,154,304637,157,424849,158,353670,161,279995,172,269968,173,113543,175,297846,181,369686],[62,133,108810],[63,1,191363,14,127000,24,288037,28,189890,34,365376,48,236230,56,441217,57,302789,74,105340,78,284879,96,240556,102,213420,104,384238,124,385272,135,377004,137,298932,148,118495,158,107956,161,110547,170,366328,173,113261,175,303255],[65,2,337650,4,441098,6,290343,32,318924,34,372242,42,294133,47,375872,49,382321,61,427163,77,281660,78,294667,83,353649,89,282739,90,345104,104,408130,115,357049,119,267398,121,432547,124,382456,127,372515,128,317930,132,391156,133,430633,136,365533,137,298941,149,289151,150,379391,157,424757,158,272882,161,279952,162,287535,172,266559,173,281659,174,390786,175,297783,181,369141,183,293771],[66,36,304038,42,292535,45,270412,50,366698,56,338296,57,302887,69,423947,78,285653,114,421210,115,356053,116,302761,121,431688,124,383151,128,318191,130,431526,133,430633,136,364820,144,385684,157,429858,158,273730,172,265210,175,298518],[67,3,354577,4,440718,6,290151,10,374475,11,365914,31,369952,32,319012,34,373125,36,302051,42,291840,43,270912,45,269845,47,375384,49,382019,50,365552,57,304793,60,374837,61,427278,69,422650,77,281802,78,294678,82,342332,83,353757,86,428257,94,291103,104,384609,106,293733,109,432623,114,419903,115,355827,116,299864,118,380748,119,267188,121,284856,124,382605,127,372765,128,318014,130,430679,132,390903,134,341283,136,365614,137,297904,144,289098,147,374717,149,289252,157,424893,158,273017,161,279922,170,364913,171,280210,172,268962,175,297805,181,369750],[68,6,290183,10,374344,19,368988,27,299118,32,319041,34,271673,36,303683,42,291901,43,270914,44,284640,45,269651,47,376863,49,382406,50,365594,56,337726,57,302995,62,436784,71,299742,77,282733,78,285959,82,342332,83,353823,86,329345,90,344859,91,421617,94,291406,104,383983,114,419928,115,355154,116,299868,121,283727,124,382755,127,292292,128,318045,130,430698,132,391737,134,341392,136,364394,137,297941,144,289066,147,374832,149,289418,150,379152,154,304658,157,424484,158,273073,160,430905,161,283747,170,364972,171,280265,172,264794,173,282819,174,388508,175,299623],[69,10,296402,11,365566,34,365234,36,302688,43,270772,47,375632,49,381976,57,302134,61,426392,65,363478,78,294665,83,354920,89,282426,94,291007,106,293677,115,355666,116,300288,118,380568,121,432498,123,302226,124,382445,130,429727,132,390515,136,365522,137,299237,147,374645,149,290945,157,424893,158,273019,161,279942,162,287388,170,365279,171,280084,172,267250,173,282165,174,390615,175,297916,181,369369],[70,10,374721,11,366069,36,303579,42,292886,45,270377,57,304625,77,284531,86,429861,89,284239,115,356053,116,302978,121,432498,124,384000,128,318581,130,431496,136,365520,144,385719,157,430156,158,276314,172,268248,175,300409],[71,118,380826,124,386975,158,283967],[73,45,271543,89,282703],[74,6,290345,34,380603,61,427400,77,282057,104,408098,115,357053,124,384549,127,372524,132,391057,133,430683,136,365533,137,298936,144,383554,149,289152,158,272891,161,279950,172,267329,175,297791,181,369145],[75,133,430683,149,292107,158,349944],[76,132,391517]]]
\ No newline at end of file
diff --git a/archive/legacy-project/.htaccess b/archive/legacy-project/.htaccess
new file mode 100644
index 0000000..fedc16b
--- /dev/null
+++ b/archive/legacy-project/.htaccess
@@ -0,0 +1,44 @@
+AddType application/manifest+json .webmanifest
+
+<IfModule mod_expires.c>
+  ExpiresActive On
+  ExpiresByType text/html "access plus 0 seconds"
+  ExpiresByType text/css "access plus 30 days"
+  ExpiresByType application/javascript "access plus 30 days"
+  ExpiresByType application/json "access plus 30 days"
+  ExpiresByType image/png "access plus 30 days"
+  ExpiresByType image/webp "access plus 30 days"
+  ExpiresByType audio/mpeg "access plus 30 days"
+  ExpiresByType audio/wav "access plus 30 days"
+
+</IfModule>
+<IfModule mod_headers.c>
+  <FilesMatch "achievement_api\.php$">
+    Header set Cache-Control "no-store, no-cache, must-revalidate, max-age=0"
+    Header set Pragma "no-cache"
+    Header set Expires "0"
+  </FilesMatch>
+  <FilesMatch "\.html?$">
+    Header set Cache-Control "no-cache, must-revalidate"
+    Header set Pragma "no-cache"
+    Header set Expires "0"
+  </FilesMatch>
+  <FilesMatch "\.(css|js|json|webmanifest|ico|png|webp|mp3|wav)$">
+    Header set Cache-Control "public, max-age=2592000, immutable"
+  </FilesMatch>
+  <FilesMatch "service-worker\.js$">
+    Header set Cache-Control "no-cache, no-store, must-revalidate"
+    Header set Pragma "no-cache"
+    Header set Expires "0"
+  </FilesMatch>
+</IfModule>
+<IfModule mod_deflate.c>
+  AddOutputFilterByType DEFLATE text/html text/css application/javascript application/json text/plain
+</IfModule>
+
+
+# Never serve hidden server-data paths.
+<IfModule mod_rewrite.c>
+  RewriteEngine On
+  RewriteRule (^|/)\. - [R=404,L]
+</IfModule>
diff --git a/archive/legacy-project/app_manifest.json b/archive/legacy-project/app_manifest.json
new file mode 100644
index 0000000..9831c75
--- /dev/null
+++ b/archive/legacy-project/app_manifest.json
@@ -0,0 +1,183 @@
+{
+  "version": "39.18.11",
+  "css": [
+    "css/base.css",
+    "css/layout.css",
+    "css/panel.css",
+    "css/components.css",
+    "css/mobile.css"
+  ],
+  "js": [
+    "js/version.js",
+    "js/event_bus.js",
+    "js/domain_ids.js",
+    "js/registry_base.js",
+    "js/disease_registry.js",
+    "js/sound_pack.js",
+    "js/deterministic_helpers.js",
+    "js/item_tool_metadata.js",
+    "js/item_tool_definitions.js",
+    "js/item_visual_definitions.js",
+    "js/item_food_definitions.js",
+    "js/item_effect_definitions.js",
+    "js/item_registry.js",
+    "js/data.js",
+    "js/ground_types.js",
+    "js/input_mode_manager.js",
+    "js/math.js",
+    "js/geometry_helpers.js",
+    "js/collision_footprint_system.js",
+    "js/physics_helpers.js",
+    "js/placement_preview_system.js",
+    "js/pin_attachment_system.js",
+    "js/physics_shape_editor_system.js",
+    "js/mechanical_system.js",
+    "js/mechanical_shape_bridge.js",
+    "js/constraint_system.js",
+    "js/physics_world_system.js",
+    "js/physics_projection_system.js",
+    "js/circuit_board_system.js",
+    "js/signal_system.js",
+    "js/assets.js",
+    "js/audio.js",
+    "js/perf_profiler.js",
+    "js/display_helpers.js",
+    "js/render.js",
+    "js/sim_core.js",
+    "js/tarinai_seed_factory.js",
+    "js/structures.js",
+    "js/item_type_catalog.js",
+    "js/items.js",
+    "js/item_type_initializers.js",
+    "js/item_lifecycle_support.js",
+    "js/item_update_policy.js",
+    "js/fire_runtime_system.js",
+    "js/robot_cleaner_system.js",
+    "js/item_dynamic_tool_system.js",
+    "js/item_dynamic_ball_system.js",
+    "js/item_dynamic_duplicator_system.js",
+    "js/item_dynamic_pin_system.js",
+    "js/item_dynamic_zunchi_system.js",
+    "js/item_environment_hazard_system.js",
+    "js/item_dynamic_system.js",
+    "js/item_lifecycle_decay_system.js",
+    "js/item_lifecycle_growth_system.js",
+    "js/item_lifecycle_step_frame.js",
+    "js/item_lifecycle_step_decay.js",
+    "js/item_lifecycle_step_dynamic.js",
+    "js/item_lifecycle_step_growth.js",
+    "js/update_step_pipeline_runner.js",
+    "js/item_lifecycle_pipeline.js",
+    "js/item_runtime.js",
+    "js/structure_lifecycle.js",
+    "js/memorial_bell_system.js",
+    "js/item_render_helpers.js",
+    "js/item_render_runtime.js",
+    "js/burn_motion_util.js",
+    "js/ants.js",
+    "js/health.js",
+    "js/tarinai.js",
+    "js/tarinai_action_spec.js",
+    "js/tarinai_behavior_state.js",
+    "js/tarinai_identity_social.js",
+    "js/tarinai_action_state.js",
+    "js/tarinai_disease_nest.js",
+    "js/tarinai_item_effects.js",
+    "js/tarinai_needs_core.js",
+    "js/tarinai_behavior_text.js",
+    "js/tarinai_forced_behavior.js",
+    "js/tarinai_nest_sleep_system.js",
+    "js/tarinai_item_targeting.js",
+    "js/tarinai_consumable_behavior.js",
+    "js/tarinai_social_action_runtime.js",
+    "js/tarinai_building_behavior.js",
+    "js/seesaw_system.js",
+    "js/tarinai_action_definitions.js",
+    "js/tarinai_needs_items.js",
+    "js/tarinai_food_prototype_mixin.js",
+    "js/tarinai_direct_feeding_system.js",
+    "js/tarinai_need_planner_system.js",
+    "js/tarinai_item_interaction_context.js",
+    "js/tarinai_food_interaction_system.js",
+    "js/tarinai_contact_item_system.js",
+    "js/tarinai_item_interaction_system.js",
+    "js/tarinai_sunbath_system.js",
+    "js/tarinai_cursor_care_system.js",
+    "js/tarinai_local_environment_system.js",
+    "js/tarinai_social_move_life.js",
+    "js/tarinai_update_step_frame.js",
+    "js/tarinai_update_step_ai.js",
+    "js/tarinai_update_step_environment.js",
+    "js/tarinai_update_step_movement.js",
+    "js/tarinai_update_step_health.js",
+    "js/tarinai_update_pipeline.js",
+    "js/tarinai_runtime.js",
+    "js/tarinai_render.js",
+    "js/world.js",
+    "js/world_view.js",
+    "js/family_graph.js",
+    "js/world_reset_presets.js",
+    "js/world_family_social.js",
+    "js/impact_core_system.js",
+    "js/impact_response_system.js",
+    "js/collision_response_system.js",
+    "js/world_combat_effects.js",
+    "js/world_environment.js",
+    "js/world_temperature_system.js",
+    "js/world_pathfinding_system.js",
+    "js/world_grass_placement_system.js",
+    "js/world_spatial_budget.js",
+    "js/world_ants_system.js",
+    "js/weather_system.js",
+    "js/item_update_scheduler.js",
+    "js/simulation_runtime_helpers.js",
+    "js/tarinai_update_policy.js",
+    "js/simulation_environment_system.js",
+    "js/simulation_item_ant_system.js",
+    "js/simulation_effects_system.js",
+    "js/simulation_creature_system.js",
+    "js/simulation_maintenance_system.js",
+    "js/simulation_ambient_system.js",
+    "js/simulation_systems.js",
+    "js/system_order.js",
+    "js/simulation.js",
+    "js/colony_situation_system.js",
+    "js/world_update.js",
+    "js/world_tool_actions.js",
+    "js/world_placement_log.js",
+    "js/world_event_effects.js",
+    "js/command_dispatcher.js",
+    "js/text_catalog.js",
+    "js/ui.js",
+    "js/game_dialogs.js",
+    "js/achievement_catalog.js",
+    "js/achievements.js",
+    "js/ui_helpers.js",
+    "js/ui_log.js",
+    "js/ui_selected.js",
+    "js/save_schema.js",
+    "js/snapshot_system.js",
+    "js/restore_coordinator.js",
+    "js/history_system.js",
+    "js/save_codec.js",
+    "js/save_storage.js",
+    "js/save_system.js",
+    "js/ui_tooltips.js",
+    "js/ui_layout_dialogs.js",
+    "js/ui_ground.js",
+    "js/ui_tools.js",
+    "js/ui_input_shared.js",
+    "js/ui_pointer_action_system.js",
+    "js/ui_input_touch.js",
+    "js/ui_input_mouse.js",
+    "js/ui_bind.js",
+    "js/ui_charts.js",
+    "js/ui_family_data.js",
+    "js/ui_family_async.js",
+    "js/ui_family_layout.js",
+    "js/ui_family_paths.js",
+    "js/ui_family_render.js",
+    "js/main.js",
+    "js/debug_tools.js"
+  ]
+}
diff --git a/archive/legacy-project/favicon.ico b/archive/legacy-project/favicon.ico
new file mode 100644
index 0000000..f5ef16a
Binary files /dev/null and b/archive/legacy-project/favicon.ico differ
diff --git a/archive/legacy-project/manifest.webmanifest b/archive/legacy-project/manifest.webmanifest
new file mode 100644
index 0000000..cd7400b
--- /dev/null
+++ b/archive/legacy-project/manifest.webmanifest
@@ -0,0 +1,27 @@
+{
+  "id": "./",
+  "name": "たりない観察",
+  "short_name": "たりない観察",
+  "description": "たりないたちの暮らしを観察・操作する実験ゲーム",
+  "lang": "ja",
+  "start_url": "./",
+  "scope": "./",
+  "display": "standalone",
+  "orientation": "any",
+  "background_color": "#dfe9df",
+  "theme_color": "#244d3a",
+  "icons": [
+    {
+      "src": "assets/ui/pwa-icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "assets/ui/pwa-icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any"
+    }
+  ]
+}
diff --git a/archive/legacy-project/service-worker.js b/archive/legacy-project/service-worker.js
new file mode 100644
index 0000000..c4fcbb6
--- /dev/null
+++ b/archive/legacy-project/service-worker.js
@@ -0,0 +1,198 @@
+"use strict";
+
+const APP_VERSION = "39.18.11";
+const CACHE_NAME = `tarinai-colony-${APP_VERSION}`;
+const v = `v=${APP_VERSION}`;
+// Static runtime list synchronized with app_manifest.json for this release.
+const coreScriptNames = [
+  "version", "event_bus", "domain_ids", "registry_base", "disease_registry", "sound_pack", "deterministic_helpers", "item_tool_metadata", "item_tool_definitions", "item_visual_definitions", "item_food_definitions", "item_effect_definitions", "item_registry", "data", "ground_types", "input_mode_manager", "math", "geometry_helpers", "collision_footprint_system", "physics_helpers", "placement_preview_system", "pin_attachment_system", "physics_shape_editor_system", "mechanical_system", "mechanical_shape_bridge", "constraint_system", "physics_world_system", "physics_projection_system", "circuit_board_system", "signal_system", "assets", "audio", "perf_profiler", "display_helpers", "render", "sim_core", "tarinai_seed_factory", "structures", "item_type_catalog", "items", "item_type_initializers", "item_lifecycle_support", "item_update_policy", "fire_runtime_system", "robot_cleaner_system", "item_dynamic_tool_system", "item_dynamic_ball_system", "item_dynamic_duplicator_system", "item_dynamic_pin_system", "item_dynamic_zunchi_system", "item_environment_hazard_system", "item_dynamic_system", "item_lifecycle_decay_system", "item_lifecycle_growth_system", "item_lifecycle_step_frame", "item_lifecycle_step_decay", "item_lifecycle_step_dynamic", "item_lifecycle_step_growth", "update_step_pipeline_runner", "item_lifecycle_pipeline", "item_runtime", "structure_lifecycle", "memorial_bell_system", "item_render_helpers", "item_render_runtime", "burn_motion_util", "ants", "health", "tarinai", "tarinai_action_spec", "tarinai_behavior_state", "tarinai_identity_social", "tarinai_action_state", "tarinai_disease_nest", "tarinai_item_effects", "tarinai_needs_core", "tarinai_behavior_text", "tarinai_forced_behavior", "tarinai_nest_sleep_system", "tarinai_item_targeting", "tarinai_consumable_behavior", "tarinai_social_action_runtime", "tarinai_building_behavior", "seesaw_system", "tarinai_action_definitions", "tarinai_needs_items", "tarinai_food_prototype_mixin", "tarinai_direct_feeding_system", "tarinai_need_planner_system", "tarinai_item_interaction_context", "tarinai_food_interaction_system", "tarinai_contact_item_system", "tarinai_item_interaction_system", "tarinai_sunbath_system", "tarinai_cursor_care_system", "tarinai_local_environment_system", "tarinai_social_move_life", "tarinai_update_step_frame", "tarinai_update_step_ai", "tarinai_update_step_environment", "tarinai_update_step_movement", "tarinai_update_step_health", "tarinai_update_pipeline", "tarinai_runtime", "tarinai_render", "world", "world_view", "family_graph", "world_reset_presets", "world_family_social", "impact_core_system", "impact_response_system", "collision_response_system", "world_combat_effects", "world_environment", "world_temperature_system", "world_pathfinding_system", "world_grass_placement_system", "world_spatial_budget", "world_ants_system", "weather_system", "item_update_scheduler", "simulation_runtime_helpers", "tarinai_update_policy", "simulation_environment_system", "simulation_item_ant_system", "simulation_effects_system", "simulation_creature_system", "simulation_maintenance_system", "simulation_ambient_system", "simulation_systems", "system_order", "simulation", "colony_situation_system", "world_update", "world_tool_actions", "world_placement_log", "world_event_effects", "command_dispatcher", "text_catalog", "ui", "game_dialogs", "achievement_catalog", "achievements", "ui_helpers", "ui_log", "ui_selected", "save_schema", "snapshot_system", "restore_coordinator", "history_system", "save_codec", "save_storage", "save_system", "ui_tooltips", "ui_layout_dialogs", "ui_ground", "ui_tools", "ui_input_shared", "ui_pointer_action_system", "ui_input_touch", "ui_input_mouse", "ui_bind", "ui_charts", "ui_family_data", "ui_family_async", "ui_family_layout", "ui_family_paths", "ui_family_render", "main", "debug_tools"
+];
+const mediaAssetNames = [
+  "assets/objects/ant_queen.webp",
+  "assets/objects/ant_worker.webp",
+  "assets/objects/genkotsu.webp",
+  "assets/objects/oshibyo.webp",
+  "assets/objects/oshibyo_stuck.webp",
+  "assets/objects/plushie_bear.png",
+  "assets/objects/pushpin.webp",
+  "assets/objects/pushpin_stuck.webp",
+  "assets/objects/zunchi.webp",
+  "assets/objects/zunchi_02.webp",
+  "assets/sounds/achievement_unlock.mp3",
+  "assets/sounds/acquired_stress_001.wav",
+  "assets/sounds/acquired_stress_002.wav",
+  "assets/sounds/acquired_stress_003.wav",
+  "assets/sounds/acquired_stress_004.wav",
+  "assets/sounds/acquired_stress_005.wav",
+  "assets/sounds/acquired_stress_006.wav",
+  "assets/sounds/bicycle_bell.mp3",
+  "assets/sounds/firecracker_explosion.mp3",
+  "assets/sounds/major_damage_01.wav",
+  "assets/sounds/major_damage_02.wav",
+  "assets/sounds/major_damage_03.wav",
+  "assets/sounds/major_damage_04.wav",
+  "assets/sounds/shoot_bolt_action.mp3",
+  "assets/sounds/shoot_pistol.mp3",
+  "assets/sounds/voice_001_hau.wav",
+  "assets/sounds/voice_002_flee.wav",
+  "assets/sounds/voice_003_po.wav",
+  "assets/sounds/voice_004_eat.wav",
+  "assets/sounds/voice_005_stress.wav",
+  "assets/sounds/voice_006_sleep.wav",
+  "assets/sounds/voice_007_sunbath_pokapoka.wav",
+  "assets/sounds/voice_008_temperature_buruburu.wav",
+  "assets/sounds/voice_009_temperature_achui.wav",
+  "assets/sprites/tarinai_01_smile.webp",
+  "assets/sprites/tarinai_02_angry.webp",
+  "assets/sprites/tarinai_03_teary.webp",
+  "assets/sprites/tarinai_04_jito.webp",
+  "assets/sprites/tarinai_05_drool.webp",
+  "assets/sprites/tarinai_06_cry.webp",
+  "assets/sprites/tarinai_07_sleep.webp",
+  "assets/sprites/tarinai_08_pokan.webp",
+  "assets/sprites/tarinai_09_stretch.webp",
+  "assets/sprites/tarinai_10_hurt.webp",
+  "assets/sprites/tarinai_11_weak.webp",
+  "assets/sprites/tarinai_12_back.webp",
+  "assets/sprites/tarinai_13_flee.webp",
+  "assets/sprites/tarinai_14_zunda_eat.webp",
+  "assets/sprites/tarinai_15_hurt2.webp",
+  "assets/sprites/tarinai_16_normal_smirk.webp",
+  "assets/sprites/tarinai_17_normal_tongue.webp",
+  "assets/sprites/tarinai_18_fear.webp",
+  "assets/sprites/tarinai_19_flee_fear2.webp",
+  "assets/sprites/tarinai_20_sleep2.webp",
+  "assets/sprites/tarinai_21_normal_happy.webp",
+  "assets/sprites/tarinai_22_fear_blue.webp",
+  "assets/sprites/tarinai_23_fear_cry.webp",
+  "assets/sprites/tarinai_24_stress_dizzy.webp",
+  "assets/sprites/tarinai_25_stress_sweat.webp",
+  "assets/sprites/tarinai_26_intimidate.webp",
+  "assets/sprites/tarinai_27_birth_ritual.webp",
+  "assets/sprites/tarinai_28_zunchi_slave.webp",
+  "assets/sprites/tarinai_29_hungry_70.webp",
+  "assets/sprites/tarinai_30_zunchi_slave_alt.webp",
+  "assets/sprites/tarinai_31_sunbath_01.webp",
+  "assets/sprites/tarinai_32_sunbath_02.webp",
+  "assets/sprites/tarinai_33_sunbath_03.webp",
+  "assets/sprites/tarinai_34_hot_01.webp",
+  "assets/sprites/tarinai_35_hot_02.webp",
+  "assets/sprites/tarinai_36_hot_03.webp",
+  "assets/sprites/tarinai_37_cold_01.webp",
+  "assets/sprites/tarinai_38_cold_02.webp",
+  "assets/sprites/tarinai_39_cold_03.webp",
+  "assets/sprites/tarinai_acquired_overlay.png",
+  "assets/ui/apple-touch-icon.png",
+  "assets/ui/ecology_hp_stress.webp",
+  "assets/ui/favicon.png",
+  "assets/ui/tool_acquired_tarinai.webp",
+  "assets/ui/tool_ammo.webp",
+  "assets/ui/tool_ant_nest.webp",
+  "assets/ui/tool_ball.webp",
+  "assets/ui/tool_bed.webp",
+  "assets/ui/tool_delete.webp",
+  "assets/ui/tool_duplicator.webp",
+  "assets/ui/tool_dwarf_drug.webp",
+  "assets/ui/tool_fence_h.webp",
+  "assets/ui/tool_fence_v.webp",
+  "assets/ui/tool_fight_mochi.webp",
+  "assets/ui/tool_firecracker.webp",
+  "assets/ui/tool_genkotsu.webp",
+  "assets/ui/tool_giant_drug.webp",
+  "assets/ui/tool_grass.webp",
+  "assets/ui/tool_laxative.webp",
+  "assets/ui/tool_love_mochi.webp",
+  "assets/ui/tool_mercury.webp",
+  "assets/ui/tool_mystery_drug.webp",
+  "assets/ui/tool_nest_box.webp",
+  "assets/ui/tool_new.webp",
+  "assets/ui/tool_niteropu.webp",
+  "assets/ui/tool_observe.webp",
+  "assets/ui/tool_oshibyo.webp",
+  "assets/ui/tool_protein.webp",
+  "assets/ui/tool_pushpin.webp",
+  "assets/ui/tool_shoot.png",
+  "assets/ui/tool_signboard.webp",
+  "assets/ui/tool_sleep_drug.webp",
+  "assets/ui/tool_stone.webp",
+  "assets/ui/tool_sweet.webp",
+  "assets/ui/tool_zunchi.webp",
+  "assets/ui/tool_zunda_juice.webp"
+];
+const CORE_ASSETS = [
+  "./",
+  "./index.html",
+  `./css/base.css?${v}`,
+  `./css/layout.css?${v}`,
+  `./css/panel.css?${v}`,
+  `./css/components.css?${v}`,
+  `./css/mobile.css?${v}`,
+  ...coreScriptNames.map(name => `./js/${name}.js?${v}`),
+  "./app_manifest.json",
+  "./manifest.webmanifest",
+  "./favicon.ico",
+  "./assets/ui/pwa-icon-192.png",
+  "./assets/ui/pwa-icon-512.png",
+  ...mediaAssetNames.map(name => `./${name}`),
+];
+
+self.addEventListener("install", event => {
+  event.waitUntil((async () => {
+    const cache = await caches.open(CACHE_NAME);
+    await cache.addAll(CORE_ASSETS);
+    await self.skipWaiting();
+  })());
+});
+
+self.addEventListener("activate", event => {
+  event.waitUntil((async () => {
+    const keys = await caches.keys();
+    await Promise.all(keys
+      .filter(key => key.startsWith("tarinai-colony-") && key !== CACHE_NAME)
+      .map(key => caches.delete(key)));
+    await self.clients.claim();
+  })());
+});
+
+function isStaticAsset(request) {
+  return /\.(?:js|css|json|webmanifest|ico|webp|png|jpg|jpeg|gif|svg|mp3|wav|woff2?)$/i.test(new URL(request.url).pathname);
+}
+function cacheableResponse(response) {
+  return response && response.status === 200 && response.type !== "opaque";
+}
+function putCacheSafely(request, response) {
+  if (!cacheableResponse(response)) return Promise.resolve(false);
+  return caches.open(CACHE_NAME).then(cache => cache.put(request, response.clone())).then(() => true).catch(() => false);
+}
+
+self.addEventListener("fetch", event => {
+  const request = event.request;
+  if (request.method !== "GET") return;
+  const url = new URL(request.url);
+  // PWA-04 intentionally remains unchanged: cross-origin Google Fonts are not cached.
+  if (url.origin !== self.location.origin || /service-worker\.js$/i.test(url.pathname)) return;
+  if (request.mode === "navigate" || /index\.html$/i.test(url.pathname)) {
+    const networkResponse = fetch(request);
+    const cacheWrite = networkResponse.then(response => putCacheSafely(request, response)).catch(() => false);
+    event.waitUntil(cacheWrite.then(() => undefined));
+    event.respondWith(networkResponse.catch(() => caches.match(request).then(cached => cached || caches.match("./index.html"))));
+    return;
+  }
+  if (isStaticAsset(request)) {
+    const responsePromise = caches.match(request).then(async cached => {
+      if (cached) return cached;
+      // Media are precached at their canonical URL. JS/CSS query versions must not
+      // resolve to an older cached file, otherwise UI fixes can remain stale.
+      const isCodeAsset = /\.(?:js|css)$/i.test(url.pathname);
+      if (!isCodeAsset) {
+        const canonical = await caches.match(request, { ignoreSearch: true });
+        if (canonical) return canonical;
+      }
+      const response = await fetch(request);
+      await putCacheSafely(request, response);
+      return response;
+    });
+    event.waitUntil(responsePromise.then(() => undefined, () => undefined));
+    event.respondWith(responsePromise);
+  }
+});
diff --git a/index.html b/index.html
index a0b500d..66d00cb 100644
--- a/index.html
+++ b/index.html
@@ -4,122 +4,314 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Prefecture Map Generator</title>
-    <link rel="stylesheet" href="./styles.css" />
+    <link rel="stylesheet" href="./styles/styles.css" />
   </head>
   <body>
     <div class="app">
-      <main class="layout">
-        <section class="main-panel">
-          <header class="header">
-            <div>
-              <h1>Prefecture Map Generator v17</h1>
-              <p>Terrain, municipalities, transport, viewport panning, patch terrain generation, and hover inspection in one generated map.</p>
-            </div>
-          </header>
+      <main class="page-shell">
+        <section class="top-stage">
+          <section class="map-section" aria-label="Map area">
+            <div class="canvas-shell" id="canvasShell">
+              <div class="canvas-stage">
+                <canvas id="mapCanvas" class="map-canvas"></canvas>
+              </div>
+              <svg id="mapSelectionSvg" class="map-selection-svg" aria-hidden="true"></svg>
+              <div id="mapSelection" class="map-selection" aria-hidden="true"></div>
 
-          <div class="canvas-shell">
-            <canvas id="mapCanvas" class="map-canvas"></canvas>
-            <svg id="mapSelectionSvg" class="map-selection-svg" aria-hidden="true"></svg>
-            <div id="mapSelection" class="map-selection" aria-hidden="true"></div>
-            <div id="generationProgress" class="generation-progress hidden" role="status" aria-live="polite">
-              <div class="progress-title">Generating map...</div>
-              <div id="generationProgressStage" class="progress-stage">Preparing</div>
-              <div id="generationProgressTimings" class="progress-timings"></div>
+              <div id="toolHint" class="map-hint hidden">
+                Patch Area mode: right-drag to select an expansion or regeneration area.
+              </div>
+
+              <div class="zoom-control" aria-label="Map zoom controls">
+                <button id="zoomIn" type="button" aria-label="Zoom in">+</button>
+                <button id="zoomOut" type="button" aria-label="Zoom out">−</button>
+                <button id="zoomReset" type="button">100%</button>
+                <button id="centerMap" type="button">Center</button>
+              </div>
+
+              <aside class="map-dock" aria-label="Layer and legend controls">
+                <details class="dock-card" open>
+                  <summary>
+                    <span>Layer</span>
+                    <span class="summary-button" aria-hidden="true">Toggle</span>
+                  </summary>
+                  <div class="dock-body">
+                    <div class="field-label">Display mode</div>
+                    <div id="modeGrid" class="mode-grid"></div>
+
+                    <div class="divider"></div>
+
+                    <label class="checkbox-row">
+                      <input id="showFeatures" type="checkbox" checked />
+                      <span>Map features</span>
+                    </label>
+                    <label class="checkbox-row">
+                      <input id="showLabels" type="checkbox" checked />
+                      <span>Labels</span>
+                    </label>
+                    <label class="checkbox-row">
+                      <input id="showSeamDiagnostics" type="checkbox" checked />
+                      <span>Seam diagnostics</span>
+                    </label>
+                  </div>
+                </details>
+
+                <details class="dock-card">
+                  <summary>
+                    <span>Legend</span>
+                    <span class="summary-button" aria-hidden="true">Toggle</span>
+                  </summary>
+                  <div id="mainLegendGrid" class="legend-grid dock-body"></div>
+                </details>
+              </aside>
+
+              <div id="generationProgress" class="generation-progress hidden" role="status" aria-live="polite">
+                <div class="progress-title">Generating map...</div>
+                <div id="generationProgressStage" class="progress-stage">Preparing</div>
+                <div id="generationProgressTimings" class="progress-timings"></div>
+              </div>
+              <div id="mapTooltip" class="map-tooltip" role="status" aria-live="polite"></div>
             </div>
-            <div id="mapTooltip" class="map-tooltip" role="status" aria-live="polite"></div>
-          </div>
+          </section>
+
+          <aside class="generation-section" aria-label="Generation settings">
+            <section class="settings-card settings-header-card">
+              <div class="card-heading tight">
+                <div>
+                  <div class="eyebrow">Controls</div>
+                  <h2>Generation Settings</h2>
+                </div>
+              </div>
+            </section>
+
+            <section class="settings-card">
+              <label class="field">
+                <span class="field-label">Seed</span>
+                <input id="seed" class="input" value="114514" />
+              </label>
+
+              <label class="field">
+                <span class="field-label">Terrain type</span>
+                <select id="generationType" class="input">
+                  <option value="auto">Auto</option>
+                  <option value="tohoku_spine">Tohoku spine</option>
+                  <option value="chubu_mountain">Chubu mountain</option>
+                  <option value="setouchi_inland_sea">Setouchi inland sea</option>
+                  <option value="oceanic_archipelago">Oceanic archipelago</option>
+                  <option value="kanto_alluvial">Kanto alluvial plain</option>
+                  <option value="mixed_archipelago">Mixed archipelago</option>
+                </select>
+              </label>
+
+              <div class="button-stack two-col">
+                <button id="generateMap" type="button" class="primary-button">Generate</button>
+                <button id="randomSeed" type="button" class="secondary-button">Random</button>
+              </div>
+            </section>
+
+            <section class="settings-card">
+              <div class="card-heading">
+                <div>
+                  <div class="eyebrow">Interaction</div>
+                  <h3>Mode</h3>
+                </div>
+              </div>
+              <div class="segmented-group" aria-label="Interaction mode">
+                <button id="toolPan" type="button" class="segmented-button active" data-tool="pan">Pan</button>
+                <button id="toolPatch" type="button" class="segmented-button" data-tool="patch">Patch Area</button>
+              </div>
+            </section>
+
+            <section class="settings-card patch-card">
+              <div class="card-heading">
+                <div>
+                  <div class="eyebrow">Right-drag selection</div>
+                  <h3>Patch Generation</h3>
+                </div>
+              </div>
+
+              <label class="field">
+                <span class="field-label">Patch terrain</span>
+                <select id="patchTerrainType" class="input">
+                  <option value="auto">Auto</option>
+                  <option value="tohoku_spine">Tohoku spine</option>
+                  <option value="chubu_mountain">Chubu mountain</option>
+                  <option value="setouchi_inland_sea">Setouchi inland sea</option>
+                  <option value="oceanic_archipelago">Oceanic archipelago</option>
+                  <option value="kanto_alluvial">Kanto alluvial plain</option>
+                  <option value="mixed_archipelago">Mixed archipelago</option>
+                </select>
+              </label>
+
+              <label class="field">
+                <span class="field-label">Patch mode</span>
+                <select id="patchMode" class="input">
+                  <option value="auto">Auto (detect expansion)</option>
+                  <option value="expansion">Expand generated world</option>
+                  <option value="regeneration">Regenerate existing area</option>
+                </select>
+              </label>
+
+              <label class="field">
+                <span class="field-label">Variant</span>
+                <input id="patchVariant" class="input" type="number" min="0" step="1" value="0" />
+              </label>
+
+              <div class="button-stack two-col">
+                <button id="generatePatch" type="button" class="primary-button" disabled>Preview Area</button>
+                <button id="alternativePatch" type="button" class="secondary-button" disabled>Alternative</button>
+              </div>
+              <div class="button-stack two-col">
+                <button id="applyPatch" type="button" class="secondary-button" disabled>Apply Preview</button>
+                <button id="discardPatch" type="button" class="ghost-button" disabled>Discard</button>
+              </div>
+              <div class="button-stack two-col">
+                <button id="clearPatchSelection" type="button" class="ghost-button" disabled>Clear Selection</button>
+                <button id="cancelPatchGeneration" type="button" class="ghost-button" disabled>Cancel Generation</button>
+              </div>
+
+              <p id="patchStatus" class="patch-status">Switch to Patch Area, then right-drag to draw a freeform area.</p>
+            </section>
+          </aside>
         </section>
 
-        <aside class="sidebar">
-          <section class="card">
-            <label class="label" for="seed">Seed</label>
-            <input id="seed" class="input" value="114514" />
-            <label class="label inline-label" for="generationType">Generation Type</label>
-            <select id="generationType" class="input">
-              <option value="auto">Auto</option>
-              <option value="tohoku_spine">Tohoku spine</option>
-              <option value="chubu_mountain">Chubu mountain</option>
-              <option value="setouchi_inland_sea">Setouchi inland sea</option>
-              <option value="oceanic_archipelago">Oceanic archipelago</option>
-              <option value="kanto_alluvial">Kanto alluvial plain</option>
-              <option value="mixed_archipelago">Mixed archipelago</option>
-            </select>
-            <button id="randomSeed" type="button" class="primary-button">Generate Random Seed</button>
-          </section>
-
-
-          <section class="card">
-            <div class="card-title">Patch Generation</div>
-            <label class="label" for="patchTerrainType">Patch Terrain Type</label>
-            <select id="patchTerrainType" class="input">
-              <option value="auto">Auto</option>
-              <option value="tohoku_spine">Tohoku spine</option>
-              <option value="chubu_mountain">Chubu mountain</option>
-              <option value="setouchi_inland_sea">Setouchi inland sea</option>
-              <option value="oceanic_archipelago">Oceanic archipelago</option>
-              <option value="kanto_alluvial">Kanto alluvial plain</option>
-              <option value="mixed_archipelago">Mixed archipelago</option>
-            </select>
-            <div class="patch-variant-row">
-              <label class="label patch-variant-label" for="patchVariant">Patch Variant</label>
-              <input id="patchVariant" class="input patch-variant-input" type="number" min="0" step="1" value="0" />
+        <section class="summary-section" aria-label="Summary">
+          <div class="section-title-row compact">
+            <div>
+              <div class="eyebrow">Current map</div>
+              <h2>Summary</h2>
             </div>
-            <div class="patch-button-row">
-              <button id="generatePatch" type="button" class="primary-button" disabled>Generate Selected Area</button>
-              <button id="alternativePatch" type="button" class="secondary-button" disabled>Alternative</button>
+          </div>
+          <div id="stats" class="stats summary-stats"></div>
+        </section>
+
+        <section class="advanced-section" aria-label="Advanced and debug data">
+          <details class="advanced-details">
+            <summary>
+              <span>Advanced / Debug Data</span>
+              <span class="advanced-summary-actions">
+                <button id="copyImportantData" type="button" class="copy-debug-button">Copy Important Data</button>
+                <span id="copyDebugStatus" class="copy-debug-status" aria-live="polite"></span>
+                <span class="advanced-toggle" aria-hidden="true">Open</span>
+              </span>
+            </summary>
+            <div class="advanced-body">
+              <section class="debug-panel wide">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Last 10</div>
+                    <h3>Full Generation Performance</h3>
+                  </div>
+                  <p>Average, max, P95, breakdown, terrain type, area, and seconds per 1,000 cells.</p>
+                </header>
+                <div id="advancedGenerationStats" class="metric-grid"></div>
+                <div id="advancedGenerationHistory" class="perf-history"></div>
+              </section>
+
+              <section class="debug-panel wide">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Last 10</div>
+                    <h3>Patch / Additional Generation Performance</h3>
+                  </div>
+                  <p>Preview and alternative patch generation, including selected area and normalized cost.</p>
+                </header>
+                <div id="advancedPatchStats" class="metric-grid"></div>
+                <div id="advancedPatchHistory" class="perf-history"></div>
+              </section>
+
+              <section class="debug-panel wide">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Last 10</div>
+                    <h3>Viewport Interaction Latency</h3>
+                  </div>
+                  <p>Pan and zoom are aggregated separately for fast redraw and full redraw phases.</p>
+                </header>
+                <div class="aggregate-header" aria-hidden="true">
+                  <span>Group</span><small>Count</small><strong>Avg</strong><strong>Max</strong><strong>P95</strong>
+                </div>
+                <div id="advancedInteractionStats" class="perf-history compact"></div>
+                <div id="advancedInteractionHistory" class="perf-history compact"></div>
+              </section>
+
+              <section class="debug-panel wide">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Current render</div>
+                    <h3>Viewport / Feature Diagnostics</h3>
+                  </div>
+                  <p>Drawn cell count, viewport size, canvas size, and feature counts used to separate generation cost from rendering cost.</p>
+                </header>
+                <div id="advancedViewportDiagnostics" class="diagnostic-grid"></div>
+                <div id="advancedFeatureCounts" class="diagnostic-table"></div>
+              </section>
+
+              <section class="debug-panel">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Patch area</div>
+                    <h3>Selection / Write Ratio</h3>
+                  </div>
+                </header>
+                <div id="advancedPatchDiagnostics" class="diagnostic-table"></div>
+              </section>
+
+              <section class="debug-panel">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Patch seam</div>
+                    <h3>Seam Diagnostics</h3>
+                  </div>
+                  <p>Magenta: seam outline. Red: disconnected or critical. Orange: topology/boundary warning. Green: retained transport crossing.</p>
+                </header>
+                <div id="advancedSeamDiagnostics" class="diagnostic-table"></div>
+              </section>
+
+              <section class="debug-panel">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Runtime</div>
+                    <h3>Worker / World Diagnostics</h3>
+                  </div>
+                </header>
+                <div id="advancedWorkerDiagnostics" class="diagnostic-table"></div>
+                <div id="advancedWorldDiagnostics" class="diagnostic-table stacked"></div>
+              </section>
+
+              <section class="debug-panel wide">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Last 10</div>
+                    <h3>Warnings / Errors</h3>
+                  </div>
+                  <p>Recent invalid selections, worker fallbacks, failed generations, and other UI-visible diagnostics.</p>
+                </header>
+                <div id="advancedWarningHistory" class="diagnostic-log"></div>
+              </section>
+
+              <section class="debug-panel">
+                <header class="debug-panel-header">
+                  <div>
+                    <div class="eyebrow">Notes</div>
+                    <h3>Debug Policy</h3>
+                  </div>
+                </header>
+                <div class="debug-note flat">
+                  <strong>Patch workflow</strong>
+                  <p>Preview Area inspects a candidate patch. Apply Preview commits it; Discard resets it.</p>
+                </div>
+                <div class="debug-note flat">
+                  <strong>Readable default UI</strong>
+                  <p>Verbose debug layers and unused legend entries stay outside the default controls.</p>
+                </div>
+              </section>
             </div>
-            <p id="patchStatus" class="patch-status">Right-drag to lasso a freeform patch area.</p>
-          </section>
-
-          <section class="card">
-            <div class="card-title">Display Layers</div>
-            <div id="modeGrid" class="mode-grid"></div>
-
-            <label class="checkbox-row">
-              <input id="showFeatures" type="checkbox" checked />
-              Show features
-            </label>
-
-            <label class="checkbox-row">
-              <input id="showLabels" type="checkbox" checked />
-              Show labels
-            </label>
-          </section>
-
-          <section class="card">
-            <div class="card-title">Generated Features</div>
-            <div id="stats" class="stats"></div>
-          </section>
-
-          <section class="card legend">
-            <div class="card-title">Legend</div>
-            <div class="legend-grid" aria-label="Map legend">
-              <div class="legend-row"><span class="legend-swatch border-swatch"></span><span>Prefecture region / municipal border</span></div>
-              <div class="legend-row"><span class="legend-line river-major"></span><span>Main river / tributary</span></div>
-              <div class="legend-row"><span class="legend-line rail-line"></span><span>Railway / solid ring railway</span></div>
-              <div class="legend-row"><span class="legend-line road-line"></span><span>National road / trunk ring road</span></div>
-              <div class="legend-row"><span class="legend-line express-line"></span><span>Expressway / environmental ring segment</span></div>
-              <div class="legend-row"><span class="legend-line old-road-line"></span><span>Premodern / minor road</span></div>
-              <div class="legend-row"><span class="legend-icon city-icon"></span><span>Prefectural capital / city</span></div>
-              <div class="legend-row"><span class="legend-icon port-icon"></span><span>Major / regional / fishing / lake port</span></div>
-              <div class="legend-row"><span class="legend-icon castle-icon"></span><span>Castle / ruins</span></div>
-              <div class="legend-row"><span class="legend-swatch cbd-swatch"></span><span>CBD / central city cells</span></div>
-              <div class="legend-row"><span class="legend-icon satellite-icon"></span><span>Satellite city</span></div>
-              <div class="legend-row"><span class="legend-icon station-icon"></span><span>Station</span></div>
-              <div class="legend-row"><span class="legend-icon industry-icon"></span><span>Industry / logistics</span></div>
-              <div class="legend-row"><span class="legend-icon newtown-icon"></span><span>New town</span></div>
-            </div>
-          </section>
-
-          <section class="card legend">
-            <div class="card-title">Notes</div>
-            <p>Open <code>index.html</code> with Live Server. Left-drag pans the viewport; right-drag draws a freeform regeneration area; use Patch Generation to write terrain into that area.</p>
-            <p>Add preferred reusable place names in <code>CUSTOM_NAME_LIST</code> inside <code>names.js</code>.</p>
-          </section>
-        </aside>
+          </details>
+        </section>
       </main>
     </div>
 
-    <script type="module" src="./app.js"></script>
+    <script type="module" src="./src/app.js"></script>
   </body>
 </html>
diff --git a/mapAdminShared.js b/mapAdminShared.js
deleted file mode 100644
index 8d5cd10..0000000
--- a/mapAdminShared.js
+++ /dev/null
@@ -1,80 +0,0 @@
-import { SIZE } from "./mapUtils.js";
-
-export function changedCellsSince(before, after, prefectureMask, sea) {
-  let changed = 0;
-  for (let i = 0; i < SIZE; i++) if (prefectureMask[i] && !sea[i] && before[i] !== after[i]) changed++;
-  return changed;
-}
-
-export function municipalityAreaById(adminId, prefectureMask, sea) {
-  const area = new Map();
-  for (let i = 0; i < SIZE; i++) {
-    if (!prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
-    area.set(adminId[i], (area.get(adminId[i]) || 0) + 1);
-  }
-  return area;
-}
-
-export function maskLandArea(mask, sea) {
-  let area = 0;
-  for (let i = 0; i < SIZE; i++) if (mask[i] && !sea[i]) area++;
-  return area;
-}
-
-
-export function isProtectedAdminSeed(seed) {
-  if (!seed) return false;
-  if (seed.seedKind === "capital" || seed.protectedCity?.isPrefecturalCapital) return true;
-  if (seed.seedKind === "modernCity" && (seed.protectedCity?.population || seed.population || 0) >= 180000) return true;
-  if (seed.seedKind === "port" && seed.portClass === "major") return true;
-  if (seed.seedKind === "satelliteCity" && (seed.protectedSatellite?.population || seed.population || 0) >= 60000) return true;
-  return false;
-}
-
-export function buildSeedLifecycle(adminCenters, adminId, prefectureMask, sea, minArea = 80) {
-  const areaById = municipalityAreaById(adminId, prefectureMask, sea);
-  const lifecycle = adminCenters.map((center, id) => {
-    const protectedSeed = isProtectedAdminSeed(center);
-    const area = areaById.get(id) || 0;
-    const enoughArea = area >= (protectedSeed ? 28 : minArea);
-    return {
-      id,
-      protected: protectedSeed,
-      area,
-      state: enoughArea || protectedSeed ? "survived" : "pending",
-    };
-  });
-  return lifecycle;
-}
-
-export function activeSeedIds(seedLifecycle) {
-  return new Set(seedLifecycle.filter((seed) => seed.state === "survived" || seed.protected).map((seed) => seed.id));
-}
-
-export function dominantCompartmentOwners(compartments, adminId) {
-  const owner = new Int16Array(compartments.length);
-  owner.fill(-1);
-  for (const unit of compartments) {
-    if (!unit || unit.area === 0) continue;
-    const counts = new Map();
-    for (const i of unit.cells) {
-      const id = adminId[i];
-      if (id >= 0) counts.set(id, (counts.get(id) || 0) + 1);
-    }
-    let bestId = -1, best = -1;
-    for (const [id, count] of counts) if (count > best) { best = count; bestId = id; }
-    owner[unit.id] = bestId;
-  }
-  return owner;
-}
-
-export function applyCompartmentOwners(adminId, compartments, owner) {
-  for (const unit of compartments) {
-    if (!unit || unit.area === 0) continue;
-    const id = owner[unit.id];
-    if (id < 0) continue;
-    for (const i of unit.cells) adminId[i] = id;
-  }
-}
-
-
diff --git a/mapAdminStage.js b/mapAdminStage.js
deleted file mode 100644
index fe94308..0000000
--- a/mapAdminStage.js
+++ /dev/null
@@ -1,503 +0,0 @@
-import {
-  applyLandscapeUnitAdminPartition,
-  assignAdminRegionsFromNaturalCompartments,
-  lockSmallUrbanComponentsToMunicipality,
-  mergeTinyMunicipalities,
-  removeMunicipalExclaves,
-  enforceMunicipalityConnectivityStrict,
-  smoothAdminRegionsTerrainAware,
-  snapAdminBoundariesToTerrain,
-} from "./adminRegions.js";
-import { INF, clamp, indexOf, inside, rand } from "./mapUtils.js";
-import { extractAdminBorderSegments } from "./mapGeneratorHelpers.js";
-import {
-  changedCellsSince,
-  municipalityAreaById,
-  maskLandArea,
-  isProtectedAdminSeed,
-  buildSeedLifecycle,
-  activeSeedIds,
-} from "./mapAdminShared.js";
-import {
-  compactWholeCompartmentMunicipalities,
-  enforceCompartmentMunicipalityOwnership,
-  enforceSimpleAdministrativeHierarchy,
-  lockCompactUrbanAreasToDominantAdmin,
-  repairAdminSingleOwnerEnclaves,
-  splitOversizedCompartmentMunicipalities,
-} from "./mapAdminCompartmentRepair.js";
-import { generatePrefecturesFromMunicipalities } from "./mapPrefectureStage.js";
-import {
-  absorbSeedCompartments,
-  splitOversizedLowlandsWithPendingSeeds,
-  promotePendingSeedsForMunicipalityCount,
-  restoreSurvivedSeedsByCompartment,
-} from "./mapAdminSeedLifecycle.js";
-import {
-  computeTargetMunicipalityCount,
-  buildLowlandAdminSeeds,
-} from "./mapAdminTargets.js";
-import {
-  classifySatelliteMunicipalities,
-  expandSatelliteMunicipalityCatchment,
-  enforceCityMunicipalityCatchments,
-} from "./mapAdminUrbanCatchments.js";
-
-function generateAdminLayoutForMask({
-  seed,
-  prefectureMask,
-  sea,
-  elevation,
-  slope,
-  river,
-  ridgeField,
-  naturalBarrierScore,
-  valleyField,
-  basinField,
-  coastalLowland,
-  flowAccum,
-  plain,
-  agriculture,
-  settlementScore,
-  populationDensity,
-  stationInfluence,
-  roadInfluence,
-  railInfluence2,
-  villageInfluence,
-  landuse,
-  modernCities,
-  satelliteCities,
-  newTowns,
-  markets,
-  villages,
-  ports,
-  stations,
-  industrialZones,
-  logisticsParks,
-  naturalCompartmentId,
-  naturalCompartments,
-  geography = null,
-  habitability = null,
-  accessibility = null,
-  centrality = null,
-  geographicBarrier = null,
-  geographicBarrierCost = null,
-  adminBoundaryPreference = null,
-  boundaryAvoidance = null,
-  adminRegionMeta = {},
-  adminProgress = null,
-}) {
-  const unifiedBoundaryPreference = adminBoundaryPreference || geography?.adminBoundaryPreference || null;
-  const unifiedBoundaryAvoidance = boundaryAvoidance || geography?.boundaryAvoidance || null;
-  const unifiedGeographicBarrier = geographicBarrier || geography?.geographicBarrier || null;
-  const boundaryRidgeField = naturalBarrierScore
-    ? Float32Array.from(ridgeField, (value, i) => clamp(value * 0.72 + naturalBarrierScore[i] * 0.46))
-    : ridgeField;
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "classify satellites" });
-  const satelliteClassificationDebug = classifySatelliteMunicipalities(satelliteCities, modernCities, prefectureMask, sea, landuse, populationDensity, roadInfluence, railInfluence2, boundaryRidgeField, river, flowAccum);
-  const targetMunicipalityCount = computeTargetMunicipalityCount({ prefectureMask, sea, elevation, slope, ridgeField: boundaryRidgeField, coastalLowland, basinField, habitability: habitability || geography?.habitability, centrality: centrality || geography?.centrality, accessibility: accessibility || geography?.accessibility, geographicBarrier: unifiedGeographicBarrier, modernCities, markets, ports, satelliteCities, villages, adminRegionMeta });
-  const compartmentMultiplier = clamp(4.6 + rand(seed, 1320) * 2.4, 4.6, 7.0);
-  const regionLandArea = adminRegionMeta.landArea || maskLandArea(prefectureMask, sea);
-  const minCompartmentTarget = clamp(Math.round(Math.max(targetMunicipalityCount * 3.4, regionLandArea / 78)), 22, 150);
-  const maxCompartmentTarget = clamp(Math.round(Math.max(targetMunicipalityCount * 6.0, regionLandArea / 36)), minCompartmentTarget, 320);
-  let targetCompartmentCount = clamp(Math.round(targetMunicipalityCount * compartmentMultiplier), minCompartmentTarget, maxCompartmentTarget);
-  let adminCentersRaw = buildLowlandAdminSeeds({
-    seed,
-    targetMunicipalityCount,
-    prefectureMask,
-    sea,
-    elevation,
-    slope,
-    ridgeField: boundaryRidgeField,
-    plain,
-    basinField,
-    coastalLowland,
-    settlementScore,
-    populationDensity,
-    roadInfluence,
-    railInfluence2,
-    stationInfluence,
-    landuse,
-    habitability: habitability || geography?.habitability,
-    accessibility: accessibility || geography?.accessibility,
-    centrality: centrality || geography?.centrality,
-    boundaryAvoidance: unifiedBoundaryAvoidance,
-    adminBoundaryPreference: unifiedBoundaryPreference,
-    geographicBarrier: unifiedGeographicBarrier,
-    modernCities,
-    satelliteCities,
-    markets,
-    ports,
-    newTowns,
-    stations,
-  });
-  if (adminCentersRaw.length < targetMunicipalityCount) targetCompartmentCount = Math.max(targetCompartmentCount, minCompartmentTarget);
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "natural compartments", targetMunicipalityCount, targetCompartmentCount, seedCount: adminCentersRaw.length });
-  const compartmentAssignment = assignAdminRegionsFromNaturalCompartments(prefectureMask, sea, elevation, slope, river, boundaryRidgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse, adminCentersRaw, {
-    seed,
-    targetMunicipalityCount,
-    targetCompartmentCount,
-    maxNaturalCompartmentArea: Math.max(32, Math.round(maskLandArea(prefectureMask, sea) / Math.max(1, targetCompartmentCount) * 1.65)),
-    naturalCompartmentId,
-    naturalCompartments,
-    naturalBarrierScore,
-    geography,
-    habitability: habitability || geography?.habitability,
-    accessibility: accessibility || geography?.accessibility,
-    centrality: centrality || geography?.centrality,
-    boundaryAvoidance: unifiedBoundaryAvoidance,
-    adminBoundaryPreference: unifiedBoundaryPreference,
-    geographicBarrier: unifiedGeographicBarrier,
-    progress: (step) => adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step }),
-  });
-  const adminId = compartmentAssignment.adminId;
-  if (naturalCompartmentId && naturalCompartments) {
-    const oversizedCompartmentSplit = splitOversizedCompartmentMunicipalities(adminId, adminCentersRaw, compartmentAssignment.compartments, prefectureMask, sea, {
-      elevation, slope, ridgeField: boundaryRidgeField, plain, agriculture, basinField, coastalLowland, populationDensity,
-    }, seed + 21900);
-    const changedAfterInitialCompartmentOwnership = enforceCompartmentMunicipalityOwnership(adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea);
-    const hierarchyRepair = enforceSimpleAdministrativeHierarchy(adminId, compartmentAssignment.compartments, prefectureMask, sea, {
-      minCompartmentsPerMunicipality: 2,
-      maxUrbanClusterCells: 1600,
-      modernCities,
-    });
-    const changedAfterFinalCompartmentOwnership = enforceCompartmentMunicipalityOwnership(adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea);
-    const compacted = compactWholeCompartmentMunicipalities(adminId, adminCentersRaw, prefectureMask, sea, { populationDensity, plain, slope });
-    const strictConnectivityChangedCells = enforceMunicipalityConnectivityStrict(compacted.adminId, prefectureMask, sea, compacted.adminCentersRaw, [...modernCities, ...(compacted.adminCentersRaw || [])], 8);
-    const strictEnclaveRepairChangedCells = repairAdminSingleOwnerEnclaves(compacted.adminId, prefectureMask, sea, 4);
-    const adminBorders = extractAdminBorderSegments(compacted.adminId, prefectureMask);
-    const actualMunicipalityCount = new Set([...compacted.adminId].filter((id, i) => id >= 0 && prefectureMask[i] && !sea[i])).size;
-    const naturalCompartmentCount = compartmentAssignment.debug?.naturalCompartmentCount || naturalCompartments.filter((unit) => unit && unit.area > 0).length;
-    const adminDebug = {
-      ...compartmentAssignment.debug,
-      simpleHierarchyPrototype: true,
-      administrativeHierarchySpec: "unified-geography->natural-compartments->living-sphere-municipalities->prefectures",
-      unifiedGeographyAdministrativeBasis: true,
-      naturalCompartmentsImmutable: true,
-      municipalitiesAreCompartmentGroups: true,
-      prefecturesAreMunicipalityGroups: true,
-      cellLevelAdminSmoothingDisabled: true,
-      sharedNaturalCompartmentLayer: true,
-      skippedLegacyCellCleanupForHierarchy: true,
-      targetMunicipalityCount,
-      actualMunicipalityCount,
-      finalMunicipalityCount: actualMunicipalityCount,
-      changedAfterStrictMunicipalityConnectivity: strictConnectivityChangedCells,
-      changedAfterStrictMunicipalityEnclaveRepair: strictEnclaveRepairChangedCells,
-      candidateSeedCount: adminCentersRaw.length,
-      municipalOfficePointCount: compacted.adminCentersRaw.length,
-      seedCellRevivalCount: 0,
-      survivedSeedCount: compacted.activeMunicipalityCount,
-      pendingSeedCount: 0,
-      absorbedSeedCount: Math.max(0, adminCentersRaw.length - compacted.activeMunicipalityCount),
-      targetNaturalCompartmentCount: targetCompartmentCount,
-      naturalCompartmentCount,
-      compartmentCount: naturalCompartmentCount,
-      changedAfterCompartmentAssignment: naturalCompartmentCount,
-      changedAfterInitialCompartmentOwnership,
-      changedAfterFinalCompartmentOwnership,
-      changedAfterUrbanUnification: hierarchyRepair.changedAfterUrbanUnification,
-      urbanComponentsUnified: hierarchyRepair.urbanComponentsUnified,
-      changedAfterCityMetroMunicipalityUnification: hierarchyRepair.changedAfterCityMetroMunicipalityUnification,
-      cityMetroMunicipalitiesUnified: hierarchyRepair.cityMetroMunicipalitiesUnified,
-      changedAfterCompartmentConnectivity: hierarchyRepair.changedAfterCompartmentConnectivity,
-      disconnectedCompartmentComponentsMerged: hierarchyRepair.disconnectedCompartmentComponentsMerged,
-      changedAfterAdminEnclaveRepair: hierarchyRepair.changedAfterCompartmentEnclaveRepair,
-      compartmentEnclaveComponentsMerged: hierarchyRepair.compartmentEnclaveComponentsMerged,
-      changedAfterSingleCompartmentMunicipalityMerge: hierarchyRepair.changedAfterSingleCompartmentMunicipalityMerge,
-      singleCompartmentMunicipalitiesMerged: hierarchyRepair.singleCompartmentMunicipalitiesMerged,
-      remainingSingleCompartmentMunicipalities: hierarchyRepair.remainingSingleCompartmentMunicipalities,
-      changedAfterPostMergeCompartmentOwnership: changedAfterFinalCompartmentOwnership,
-      changedAfterOversizedCompartmentSplit: oversizedCompartmentSplit.changedCells,
-      oversizedCompartmentMunicipalitiesSplit: oversizedCompartmentSplit.splitMunicipalities,
-      oversizedCompartmentSplitAddedCenters: oversizedCompartmentSplit.addedCenters,
-      oversizedCompartmentSplitMaxArea: oversizedCompartmentSplit.maxArea || 0,
-      finalTinyMunicipalityCount: [...municipalityAreaById(compacted.adminId, prefectureMask, sea).values()].filter((area) => area > 0 && area < 8).length,
-      compartmentBorders: compartmentAssignment.debug?.compartmentBorders || [],
-      borderNaturalBarrierAverage: compartmentAssignment.debug?.finalBorderNaturalBarrierAverage || 0,
-      voronoiLikeRate: compartmentAssignment.debug?.voronoiLikeRateAfter || 0,
-    };
-    return {
-      adminCentersRaw: compacted.adminCentersRaw,
-      adminId: compacted.adminId,
-      adminBorders,
-      adminDebug,
-      naturalCompartmentId: compartmentAssignment.compartmentId,
-      naturalCompartments: compartmentAssignment.compartments,
-    };
-  }
-  let previousSnapshot = new Int16Array(adminId);
-  const adminDebug = {
-    changedAfterSmooth: 0,
-    changedAfterUrbanLock: 0,
-    changedAfterSmallUrbanLock: 0,
-    changedAfterInitialMerge: 0,
-    changedAfterInitialExclaveRemoval: 0,
-    changedAfterLandscapePartition: 0,
-    changedAfterSnap: 0,
-    changedAfterOversizedRuralSplit: 0,
-    changedAfterFinalExclaveRemoval: 0,
-    changedAfterFinalMerge: 0,
-    targetMunicipalityCount,
-    actualMunicipalityCount: 0,
-    municipalityCountReason: "unified habitability/accessibility, settlement hierarchy, coastline complexity, basin/lowland bonus, and natural-barrier adjustment",
-    unifiedGeographyAdministrativeBasis: true,
-    administrativeHierarchySpec: "unified-geography->natural-compartments->living-sphere-municipalities->prefectures",
-    changedAfterCompartmentAssignment: compartmentAssignment.debug?.naturalCompartmentCount || 0,
-    oversizedRuralSplits: 0,
-    oversizedLowlandSplits: 0,
-    ruralSplitsAccepted: 0,
-    ruralSplitsRejected: 0,
-    targetNaturalCompartmentCount: targetCompartmentCount,
-    compartmentMultiplier,
-    lowlandAdminSeedCount: adminCentersRaw.filter((p) => p.invisibleLowlandAdminSeed).length,
-    lowlandAdminSeeds: adminCentersRaw.filter((p) => p.invisibleLowlandAdminSeed).map((p) => ({ x: p.x, y: p.y })),
-    realAdminSeedCount: adminCentersRaw.filter((p) => !p.invisibleLowlandAdminSeed).length,
-    highMountainAdminSeedCount: adminCentersRaw.filter((p) => {
-      const i = indexOf(p.x, p.y);
-      return elevation[i] > 0.70 || slope[i] > 0.52 || boundaryRidgeField[i] > 0.62;
-    }).length,
-    candidateSeedCount: adminCentersRaw.length,
-    protectedSeedCount: adminCentersRaw.filter(isProtectedAdminSeed).length,
-    survivedSeedCount: 0,
-    pendingSeedCount: 0,
-    absorbedSeedCount: 0,
-    pendingSeedsUsedForLowlandSplit: 0,
-    finalMunicipalityCount: 0,
-    finalTinyMunicipalityCount: 0,
-    seedCellRevivalCount: 0,
-    satelliteMunicipalitiesCreated: adminCentersRaw.filter((p) => p.protectedSatellite).length,
-    satelliteMunicipalitiesMerged: 0,
-    satelliteMunicipalitiesExpanded: 0,
-    satelliteMunicipalitiesTooSmall: 0,
-    averageSatelliteMunicipalityArea: 0,
-    minSatelliteMunicipalityArea: 0,
-    satelliteMunicipalityAreaByNameOrIndex: {},
-    independentSatelliteMunicipalities: satelliteClassificationDebug.independent,
-    attachedSatelliteDistricts: satelliteClassificationDebug.attached,
-    satelliteMunicipalityStats: satelliteClassificationDebug,
-    ...compartmentAssignment.debug,
-  };
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "seed lifecycle" });
-  const seedLifecycle = buildSeedLifecycle(adminCentersRaw, adminId, prefectureMask, sea, 35);
-  const pendingSplitDebug = splitOversizedLowlandsWithPendingSeeds(adminId, prefectureMask, sea, {
-    plain, agriculture, basinField, coastalLowland, valleyField, ridgeField: boundaryRidgeField, slope, elevation,
-  }, compartmentAssignment.compartments, adminCentersRaw, seedLifecycle, [...(satelliteCities || []), ...newTowns, ...markets, ...villages, ...ports]);
-  adminDebug.changedAfterPendingSeedLowlandSplit = pendingSplitDebug.changedCells;
-  adminDebug.pendingSeedsUsedForLowlandSplit = pendingSplitDebug.pendingSeedsUsed;
-  adminDebug.oversizedLowlandSplits += pendingSplitDebug.splitMunicipalities;
-  const pendingPromotionDebug = promotePendingSeedsForMunicipalityCount(adminId, prefectureMask, sea, {
-    plain, agriculture, basinField, coastalLowland, valleyField, ridgeField: boundaryRidgeField, slope, elevation,
-  }, compartmentAssignment.compartments, adminCentersRaw, seedLifecycle, Math.min(24, targetMunicipalityCount));
-  adminDebug.changedAfterPendingSeedCountRepair = pendingPromotionDebug.changedCells;
-  adminDebug.pendingSeedsPromotedForCount = pendingPromotionDebug.promotedSeeds;
-  let areaAfterPendingSplit = municipalityAreaById(adminId, prefectureMask, sea);
-  for (const seedState of seedLifecycle) {
-    if (seedState.state !== "pending") continue;
-    seedState.area = areaAfterPendingSplit.get(seedState.id) || 0;
-    if (seedState.area >= 35) seedState.state = "survived";
-    else seedState.state = "absorbed";
-  }
-  adminDebug.changedAfterAbsorbingSeeds = absorbSeedCompartments(adminId, compartmentAssignment.compartments, seedLifecycle);
-  let activeAdminIds = activeSeedIds(seedLifecycle);
-  function markChanged(field) {
-    adminDebug[field] = changedCellsSince(previousSnapshot, adminId, prefectureMask, sea);
-    previousSnapshot = new Int16Array(adminId);
-  }
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "smooth boundaries" });
-  smoothAdminRegionsTerrainAware(adminId, prefectureMask, sea, elevation, slope, river, boundaryRidgeField, valleyField, populationDensity, landuse, 2);
-  markChanged("changedAfterSmooth");
-
-  function lockUrbanClusterToMunicipality(city, radius, allowSuburban = true) {
-    if (!city || !prefectureMask[indexOf(city.x, city.y)]) return;
-    let bestAdmin = -1;
-    let bestD = INF;
-    adminCentersRaw.forEach((center, id) => {
-      if (!activeAdminIds.has(id)) return;
-      const d = Math.hypot(center.x - city.x, center.y - city.y);
-      if (d < bestD) { bestD = d; bestAdmin = id; }
-    });
-    if (bestAdmin < 0) return;
-    const r = Math.ceil(radius);
-    for (let dy = -r; dy <= r; dy++) {
-      for (let dx = -r; dx <= r; dx++) {
-        const x = city.x + dx;
-        const y = city.y + dy;
-        if (!inside(x, y)) continue;
-        const i = indexOf(x, y);
-        if (!prefectureMask[i] || sea[i]) continue;
-        const d = Math.hypot(dx, dy);
-        if (d > radius) continue;
-        const urban = landuse[i] === 2 || landuse[i] === 3 || (allowSuburban && (landuse[i] === 4 || landuse[i] === 7 || landuse[i] === 8));
-        if (urban || populationDensity[i] > 0.22) adminId[i] = bestAdmin;
-      }
-    }
-  }
-  for (const city of modernCities) {
-    const radius = (city.population || 0) >= 500000
-      ? clamp(17 + Math.sqrt(city.population) / 120, 20, 38)
-      : clamp(5 + Math.sqrt(city.population || 70000) / 210, 6, 11);
-    lockUrbanClusterToMunicipality(city, radius, true);
-  }
-  for (const sat of satelliteCities || []) {
-    if (!prefectureMask[indexOf(sat.x, sat.y)]) continue;
-    let bestAdmin = -1;
-    if (sat.municipalityClass === "independentSatelliteMunicipality") {
-      let bestD = INF;
-      adminCentersRaw.forEach((center, id) => {
-        if (!activeAdminIds.has(id)) return;
-        const d = Math.hypot(center.x - sat.x, center.y - sat.y);
-        if (d < bestD) { bestD = d; bestAdmin = id; }
-      });
-    } else if (inside(sat.parentX ?? -1, sat.parentY ?? -1)) {
-      bestAdmin = adminId[indexOf(sat.parentX, sat.parentY)];
-    }
-    if (bestAdmin < 0) continue;
-    sat.parentAdminHint = bestAdmin;
-    const changed = expandSatelliteMunicipalityCatchment(adminId, sat, bestAdmin, {
-      prefectureMask, sea, elevation, slope, river, ridgeField: boundaryRidgeField, valleyField, basinField, coastalLowland, flowAccum,
-      landuse, populationDensity, roadInfluence, railInfluence2, stationInfluence, modernCities,
-    });
-    if (changed > 0 && sat.municipalityClass === "independentSatelliteMunicipality") adminDebug.satelliteMunicipalitiesExpanded++;
-  }
-  markChanged("changedAfterUrbanLock");
-  lockSmallUrbanComponentsToMunicipality(adminId, prefectureMask, sea, landuse, populationDensity, 520);
-  lockSmallUrbanComponentsToMunicipality(adminId, prefectureMask, sea, landuse, populationDensity, 620);
-  markChanged("changedAfterSmallUrbanLock");
-  const activeAdminCenters = () => adminCentersRaw.filter((_, id) => activeAdminIds.has(id));
-  mergeTinyMunicipalities(adminId, prefectureMask, sea, populationDensity, modernCities, 120, { satelliteCities, satelliteStats: adminDebug, satelliteMinArea: 100, protectedPoints: activeAdminCenters() });
-  markChanged("changedAfterInitialMerge");
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "topology cleanup" });
-  removeMunicipalExclaves(adminId, prefectureMask, sea, adminCentersRaw, modernCities, 180);
-  markChanged("changedAfterInitialExclaveRemoval");
-  // The initial compartment graph assignment is now the primary natural partition.
-  // Re-running the older raw landscape-unit pass here collapses lowland seeds into a few broad owners.
-  markChanged("changedAfterLandscapePartition");
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "split oversized municipalities" });
-  // The older oversized-lowland pass rebuilds natural compartments a second time.
-  // The current pipeline already performs pending-seed lowland splitting on the active
-  // compartment graph above, so keep the full admin layout while avoiding the duplicate
-  // high-cost recomputation.
-  const oversizedSplitDebug = {
-    changedCells: 0,
-    splitMunicipalities: 0,
-    rejectedMunicipalities: 0,
-    skippedDuplicateCompartmentRebuild: true,
-    skippedForVisibleFragment: false,
-  };
-  adminDebug.changedAfterOversizedRuralSplit = oversizedSplitDebug.changedCells;
-  adminDebug.oversizedRuralMunicipalitiesSplit = oversizedSplitDebug.splitMunicipalities;
-  adminDebug.oversizedRuralSplits = oversizedSplitDebug.splitMunicipalities;
-  adminDebug.oversizedLowlandSplits = oversizedSplitDebug.splitMunicipalities;
-  adminDebug.ruralSplitsAccepted = oversizedSplitDebug.splitMunicipalities;
-  adminDebug.ruralSplitsRejected = oversizedSplitDebug.rejectedMunicipalities || 0;
-  adminDebug.oversizedSplitSkippedForVisibleFragment = Boolean(oversizedSplitDebug.skippedForVisibleFragment);
-  adminDebug.oversizedSplitSkippedDuplicateCompartmentRebuild = Boolean(oversizedSplitDebug.skippedDuplicateCompartmentRebuild);
-  previousSnapshot = new Int16Array(adminId);
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "terrain snap" });
-  snapAdminBoundariesToTerrain(adminId, prefectureMask, sea, elevation, slope, river, boundaryRidgeField, valleyField, flowAccum, populationDensity, landuse, adminCentersRaw, [...modernCities, ...satelliteCities, ...ports, ...industrialZones, ...logisticsParks], 2);
-  markChanged("changedAfterSnap");
-  removeMunicipalExclaves(adminId, prefectureMask, sea, adminCentersRaw, [...modernCities, ...activeAdminCenters()], 360);
-  markChanged("changedAfterFinalExclaveRemoval");
-  mergeTinyMunicipalities(adminId, prefectureMask, sea, populationDensity, modernCities, 80, { satelliteCities, satelliteStats: adminDebug, satelliteMinArea: 90, protectedPoints: activeAdminCenters() });
-  markChanged("changedAfterFinalMerge");
-
-  for (const sat of satelliteCities || []) {
-    if (sat.municipalityClass !== "independentSatelliteMunicipality" || !inside(sat.x, sat.y)) continue;
-    const targetAdmin = adminId[indexOf(sat.x, sat.y)];
-    if (targetAdmin < 0) continue;
-    expandSatelliteMunicipalityCatchment(adminId, sat, targetAdmin, {
-      prefectureMask, sea, elevation, slope, river, ridgeField: boundaryRidgeField, valleyField, basinField, coastalLowland, flowAccum,
-      landuse, populationDensity, roadInfluence, railInfluence2, stationInfluence, modernCities,
-    });
-  }
-  const cityCatchmentDebug = enforceCityMunicipalityCatchments(adminId, modernCities, {
-    prefectureMask, sea, elevation, slope, river, ridgeField: boundaryRidgeField, valleyField, basinField, coastalLowland, flowAccum,
-    landuse, populationDensity, roadInfluence, railInfluence2, stationInfluence,
-  });
-  adminDebug.changedAfterCityMunicipalityCatchment = cityCatchmentDebug.changed;
-  adminDebug.protectedCityMunicipalityCount = cityCatchmentDebug.protectedCities;
-  adminDebug.tooSmallCityMunicipalityCountBeforeRepair = cityCatchmentDebug.tooSmall;
-  snapAdminBoundariesToTerrain(adminId, prefectureMask, sea, elevation, slope, river, boundaryRidgeField, valleyField, flowAccum, populationDensity, landuse, adminCentersRaw, [...modernCities, ...activeAdminCenters()], 2);
-  removeMunicipalExclaves(adminId, prefectureMask, sea, adminCentersRaw, [...modernCities, ...activeAdminCenters()], 260);
-  const finalPromotionDebug = promotePendingSeedsForMunicipalityCount(adminId, prefectureMask, sea, {
-    plain, agriculture, basinField, coastalLowland, valleyField, ridgeField: boundaryRidgeField, slope, elevation,
-  }, compartmentAssignment.compartments, adminCentersRaw, seedLifecycle, Math.min(22, targetMunicipalityCount));
-  adminDebug.changedAfterFinalPendingSeedCountRepair = finalPromotionDebug.changedCells;
-  adminDebug.pendingSeedsPromotedForCount += finalPromotionDebug.promotedSeeds;
-  const restoredSeedDebug = restoreSurvivedSeedsByCompartment(adminId, prefectureMask, sea, compartmentAssignment.compartments, adminCentersRaw, seedLifecycle, Math.min(22, targetMunicipalityCount));
-  adminDebug.changedAfterSurvivedSeedCompartmentRestore = restoredSeedDebug.changedCells;
-  adminDebug.survivedSeedsRestoredByCompartment = restoredSeedDebug.restoredSeeds;
-  let finalAreaBySeed = municipalityAreaById(adminId, prefectureMask, sea);
-  for (const seedState of seedLifecycle) {
-    seedState.area = finalAreaBySeed.get(seedState.id) || 0;
-    if (!seedState.protected && seedState.state === "pending" && seedState.area < 25) seedState.state = "absorbed";
-  }
-  absorbSeedCompartments(adminId, compartmentAssignment.compartments, seedLifecycle);
-  activeAdminIds = activeSeedIds(seedLifecycle);
-  adminDebug.changedAfterFinalCompartmentOwnership = enforceCompartmentMunicipalityOwnership(adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea);
-  removeMunicipalExclaves(adminId, prefectureMask, sea, adminCentersRaw, [...modernCities, ...activeAdminCenters()], 220);
-  adminDebug.changedAfterPostCompartmentExclaveRemoval = enforceCompartmentMunicipalityOwnership(adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea);
-  adminDebug.changedAfterUrbanUnification = lockCompactUrbanAreasToDominantAdmin(adminId, prefectureMask, sea, landuse, populationDensity, 980);
-  adminDebug.changedAfterAdminEnclaveRepair = repairAdminSingleOwnerEnclaves(adminId, prefectureMask, sea, 6);
-  adminDebug.changedAfterFinalCompartmentOwnership += enforceCompartmentMunicipalityOwnership(adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea);
-  adminDebug.changedAfterStrictMunicipalityConnectivity = enforceMunicipalityConnectivityStrict(adminId, prefectureMask, sea, adminCentersRaw, [...modernCities, ...activeAdminCenters()], 8);
-  adminDebug.changedAfterStrictMunicipalityEnclaveRepair = repairAdminSingleOwnerEnclaves(adminId, prefectureMask, sea, 4);
-
-  const areaById = municipalityAreaById(adminId, prefectureMask, sea);
-  const satelliteAreas = [];
-  (satelliteCities || []).forEach((sat, index) => {
-    if (!inside(sat.x, sat.y) || !prefectureMask[indexOf(sat.x, sat.y)]) return;
-    const id = adminId[indexOf(sat.x, sat.y)];
-    const area = areaById.get(id) || 0;
-    const key = sat.name || `satellite-${index}`;
-    adminDebug.satelliteMunicipalityAreaByNameOrIndex[key] = area;
-    if (sat.municipalityClass === "independentSatelliteMunicipality" && (area < Math.max(120, sat.satelliteMinArea || 0) || ((sat.population || 0) >= 60000 && area < 150))) {
-      sat.municipalityClass = "smallTownAttachedToRuralMunicipality";
-      adminDebug.satelliteMunicipalitiesTooSmall++;
-      return;
-    }
-    if (sat.municipalityClass === "independentSatelliteMunicipality") {
-      satelliteAreas.push(area);
-      if (area < 80) adminDebug.satelliteMunicipalitiesTooSmall++;
-    }
-  });
-  adminDebug.averageSatelliteMunicipalityArea = satelliteAreas.length ? satelliteAreas.reduce((sum, value) => sum + value, 0) / satelliteAreas.length : 0;
-  adminDebug.minSatelliteMunicipalityArea = satelliteAreas.length ? Math.min(...satelliteAreas) : 0;
-  adminDebug.satelliteMunicipalitiesIndependent = satelliteAreas.length;
-  const landscapeDebug = applyLandscapeUnitAdminPartition.lastDebug || {};
-  Object.assign(adminDebug, landscapeDebug);
-  adminDebug.targetNaturalCompartmentCount = compartmentAssignment.debug?.targetNaturalCompartmentCount || targetCompartmentCount;
-  adminDebug.naturalCompartmentCount = compartmentAssignment.debug?.naturalCompartmentCount || adminDebug.naturalCompartmentCount || adminDebug.compartmentCount || 0;
-  adminDebug.compartmentCount = adminDebug.naturalCompartmentCount;
-  adminDebug.averageCompartmentsPerMunicipality = compartmentAssignment.debug?.averageCompartmentsPerMunicipality || adminDebug.averageCompartmentsPerMunicipality || 0;
-  adminDebug.singleCompartmentMunicipalityRatio = compartmentAssignment.debug?.singleCompartmentMunicipalityRatio ?? adminDebug.singleCompartmentMunicipalityRatio ?? 0;
-  adminDebug.actualMunicipalityCount = new Set([...adminId].filter((id, i) => id >= 0 && prefectureMask[i] && !sea[i])).size;
-  adminDebug.averageCompartmentsPerMunicipality = adminDebug.actualMunicipalityCount ? adminDebug.naturalCompartmentCount / adminDebug.actualMunicipalityCount : 0;
-  adminDebug.survivedSeedCount = seedLifecycle.filter((seed) => seed.state === "survived").length;
-  adminDebug.pendingSeedCount = seedLifecycle.filter((seed) => seed.state === "pending").length;
-  adminDebug.absorbedSeedCount = seedLifecycle.filter((seed) => seed.state === "absorbed").length;
-  adminDebug.finalMunicipalityCount = adminDebug.actualMunicipalityCount;
-  adminDebug.finalTinyMunicipalityCount = [...areaById.values()].filter((area) => area > 0 && area < 8).length;
-  adminDebug.seedLifecycle = seedLifecycle.map((seed) => ({ id: seed.id, state: seed.state, protected: seed.protected, area: seed.area }));
-  adminDebug.borderNaturalBarrierAverage = adminDebug.finalBorderNaturalBarrierAverage ?? 0;
-  adminDebug.voronoiLikeRate = adminDebug.voronoiLikeRateAfter ?? 0;
-  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "extract borders" });
-  const adminBorders = extractAdminBorderSegments(adminId, prefectureMask);
-
-
-  return {
-    adminCentersRaw,
-    adminId,
-    adminBorders,
-    adminDebug,
-    naturalCompartmentId: compartmentAssignment.compartmentId,
-    naturalCompartments: compartmentAssignment.compartments,
-  };
-}
-
-
-export function generateAdminLayout(context) {
-  const layout = generateAdminLayoutForMask(context);
-  return { ...layout, ...generatePrefecturesFromMunicipalities(context, layout) };
-}
diff --git a/mapAdminUrbanCatchments.js b/mapAdminUrbanCatchments.js
deleted file mode 100644
index 499d00b..0000000
--- a/mapAdminUrbanCatchments.js
+++ /dev/null
@@ -1,239 +0,0 @@
-import { INF, SIZE, MinHeap, clamp, indexOf, inside, xyOf } from "./mapUtils.js";
-import { municipalityAreaById } from "./mapAdminShared.js";
-
-export function estimateUrbanComponentArea(city, prefectureMask, sea, landuse, populationDensity) {
-  if (!city || !inside(city.x, city.y)) return 0;
-  const start = indexOf(city.x, city.y);
-  if (!prefectureMask[start] || sea[start]) return 0;
-  const radius = Math.ceil(Math.max(7, (city.urbanRadius || 6) * 1.7));
-  const seen = new Uint8Array(SIZE);
-  const queue = [start];
-  seen[start] = 1;
-  let area = 0;
-  for (let q = 0; q < queue.length; q++) {
-    const cur = queue[q];
-    const [x, y] = xyOf(cur);
-    const d = Math.hypot(x - city.x, y - city.y);
-    if (d > radius) continue;
-    const urban = (landuse[cur] >= 2 && landuse[cur] <= 4) || landuse[cur] === 7 || landuse[cur] === 8 || populationDensity[cur] > 0.18;
-    if (!urban) continue;
-    area++;
-    for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]]) {
-      const nx = x + dx, ny = y + dy;
-      if (!inside(nx, ny)) continue;
-      const ni = indexOf(nx, ny);
-      if (seen[ni] || !prefectureMask[ni] || sea[ni]) continue;
-      seen[ni] = 1;
-      queue.push(ni);
-    }
-  }
-  return area;
-}
-
-export function terrainSeparationBetween(a, b, ridgeField, river, flowAccum, populationDensity, landuse) {
-  if (!a || !b) return { separatedByBarrier: false, ruralGap: false, averageDensity: 0, maxBarrier: 0 };
-  const steps = Math.max(1, Math.ceil(Math.hypot(a.x - b.x, a.y - b.y)));
-  let maxBarrier = 0;
-  let lowUrbanRun = 0;
-  let bestLowUrbanRun = 0;
-  let densitySum = 0;
-  for (let s = 0; s <= steps; s++) {
-    const t = s / steps;
-    const x = Math.round(a.x + (b.x - a.x) * t);
-    const y = Math.round(a.y + (b.y - a.y) * t);
-    if (!inside(x, y)) continue;
-    const i = indexOf(x, y);
-    const barrier = Math.max(ridgeField[i] * 0.95, river[i] * 0.85, flowAccum[i] * 0.42);
-    maxBarrier = Math.max(maxBarrier, barrier);
-    densitySum += populationDensity[i];
-    const urban = (landuse[i] >= 2 && landuse[i] <= 4) || landuse[i] === 7 || populationDensity[i] > 0.20;
-    if (urban) lowUrbanRun = 0;
-    else {
-      lowUrbanRun++;
-      bestLowUrbanRun = Math.max(bestLowUrbanRun, lowUrbanRun);
-    }
-  }
-  return {
-    separatedByBarrier: maxBarrier > 0.56,
-    ruralGap: bestLowUrbanRun >= 4,
-    averageDensity: densitySum / (steps + 1),
-    maxBarrier,
-  };
-}
-
-export function classifySatelliteMunicipalities(satelliteCities, modernCities, prefectureMask, sea, landuse, populationDensity, roadInfluence, railInfluence2, ridgeField, river, flowAccum) {
-  let independent = 0;
-  let attached = 0;
-  for (const sat of satelliteCities || []) {
-    if (!sat || !inside(sat.x, sat.y) || !prefectureMask[indexOf(sat.x, sat.y)] || sea[indexOf(sat.x, sat.y)]) continue;
-    const parent = modernCities[sat.parentCityIndex] || modernCities.slice().sort((a, b) => Math.hypot(a.x - sat.x, a.y - sat.y) - Math.hypot(b.x - sat.x, b.y - sat.y))[0];
-    const parentDistance = parent ? Math.hypot(parent.x - sat.x, parent.y - sat.y) : 99;
-    const separation = terrainSeparationBetween(sat, parent, ridgeField, river, flowAccum, populationDensity, landuse);
-    const urbanArea = estimateUrbanComponentArea(sat, prefectureMask, sea, landuse, populationDensity);
-    const i = indexOf(sat.x, sat.y);
-    const continuousUrban = parent && parentDistance < Math.max(10, (parent.urbanRadius || 12) + (sat.urbanRadius || 5) + 5) && separation.averageDensity > 0.14 && !separation.ruralGap && !separation.separatedByBarrier;
-    const newTownLike = landuse[i] === 7 || (railInfluence2[i] > 0.22 && roadInfluence[i] > 0.12 && (sat.population || 0) < 70000);
-    let municipalityClass = "independentSatelliteMunicipality";
-    if (continuousUrban && (sat.population || 0) < 90000) municipalityClass = "suburbanDistrictMergedWithParent";
-    else if (newTownLike && (sat.population || 0) < 85000 && !separation.separatedByBarrier) municipalityClass = "newTownDistrict";
-    else if ((sat.population || 0) < 42000 && urbanArea < 55 && !separation.separatedByBarrier) municipalityClass = "smallTownAttachedToRuralMunicipality";
-    else if ((sat.population || 0) >= 60000 && urbanArea >= 42 && (separation.separatedByBarrier || separation.ruralGap || parentDistance > 15)) municipalityClass = "independentSatelliteMunicipality";
-
-    sat.municipalityClass = municipalityClass;
-    sat.parentX = parent?.x;
-    sat.parentY = parent?.y;
-    sat.parentAdminHint = -1;
-    sat.distinctUrbanComponentArea = urbanArea;
-    sat.separatedByBarrier = separation.separatedByBarrier || separation.ruralGap;
-    sat.satelliteMinArea = clamp(90 + Math.sqrt(sat.population || 24000) * 0.62 + (sat.urbanRadius || 5) * 12, 80, 360);
-    if (municipalityClass === "independentSatelliteMunicipality") independent++;
-    else attached++;
-  }
-  return { independent, attached };
-}
-
-export function expandSatelliteMunicipalityCatchment(adminId, satellite, targetAdmin, context) {
-  const { prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, landuse, populationDensity, roadInfluence, railInfluence2, stationInfluence, modernCities } = context;
-  if (!satellite || targetAdmin < 0 || !inside(satellite.x, satellite.y)) return 0;
-  const start = indexOf(satellite.x, satellite.y);
-  if (!prefectureMask[start] || sea[start]) return 0;
-  const targetAreaBase = clamp(90 + Math.sqrt(satellite.population || 24000) * 0.8 + (satellite.urbanRadius || 5) * 18, 120, 520);
-  const targetArea = satellite.municipalityClass === "smallTownAttachedToRuralMunicipality"
-    ? Math.min(130, targetAreaBase * 0.55)
-    : satellite.municipalityClass === "suburbanDistrictMergedWithParent" || satellite.municipalityClass === "newTownDistrict"
-      ? Math.min(190, targetAreaBase * 0.62)
-      : targetAreaBase;
-  const maxCost = satellite.municipalityClass === "independentSatelliteMunicipality" ? 46 : 32;
-  const heap = new MinHeap();
-  const best = new Float32Array(SIZE);
-  best.fill(INF);
-  heap.push({ i: start, f: 0 });
-  best[start] = 0;
-  const claimed = [];
-  while (heap.length > 0 && claimed.length < targetArea) {
-    const cur = heap.pop();
-    if (!cur || cur.f > best[cur.i] + 1e-5 || cur.f > maxCost) continue;
-    const [x, y] = xyOf(cur.i);
-    const d = Math.hypot(x - satellite.x, y - satellite.y);
-    if (!prefectureMask[cur.i] || sea[cur.i]) continue;
-    let invadesOtherCore = false;
-    for (const city of modernCities || []) {
-      if (!city || (city.population || 0) < 140000) continue;
-      if (Math.hypot(city.x - satellite.x, city.y - satellite.y) < 4) continue;
-      if (Math.hypot(city.x - x, city.y - y) <= Math.max(3.5, (city.coreRadius || 4) * 1.25)) {
-        invadesOtherCore = true;
-        break;
-      }
-    }
-    if (invadesOtherCore) continue;
-    const compatible = d <= (satellite.urbanRadius || 5) * 1.25 ||
-      [2, 3, 4, 7, 8].includes(landuse[cur.i]) ||
-      populationDensity[cur.i] > 0.12 ||
-      roadInfluence[cur.i] > 0.12 ||
-      railInfluence2[cur.i] > 0.10 ||
-      stationInfluence?.[cur.i] > 0.10 ||
-      basinField[cur.i] > 0.22 ||
-      valleyField[cur.i] > 0.24 ||
-      coastalLowland[cur.i] > 0.20;
-    if (!compatible && claimed.length > targetArea * 0.55) continue;
-    claimed.push(cur.i);
-    for (const [dx, dy, step] of [[1, 0, 1], [-1, 0, 1], [0, 1, 1], [0, -1, 1], [1, 1, 1.41], [-1, 1, 1.41], [1, -1, 1.41], [-1, -1, 1.41]]) {
-      const nx = x + dx, ny = y + dy;
-      if (!inside(nx, ny)) continue;
-      const ni = indexOf(nx, ny);
-      if (!prefectureMask[ni] || sea[ni]) continue;
-      const barrier = ridgeField[ni] * 5.2 + Math.max(0, elevation[ni] - 0.58) * 4.0 + slope[ni] * 2.2 + (river[ni] > 0.55 || flowAccum[ni] > 0.70 ? 7.5 : river[ni] > 0.30 ? 2.8 : 0);
-      const living = ([2, 3, 4, 7, 8].includes(landuse[ni]) ? 2.2 : 0) + populationDensity[ni] * 2.0 + roadInfluence[ni] * 0.85 + railInfluence2[ni] * 0.95 + (stationInfluence?.[ni] || 0) * 1.2 + basinField[ni] * 0.42 + valleyField[ni] * 0.48 + coastalLowland[ni] * 0.32;
-      const distanceCost = Math.hypot(nx - satellite.x, ny - satellite.y) / Math.max(7, (satellite.urbanRadius || 5) * 1.9);
-      const nd = cur.f + Math.max(0.28, 1.05 + barrier - living + distanceCost) * step;
-      if (nd < best[ni]) {
-        best[ni] = nd;
-        heap.push({ i: ni, f: nd });
-      }
-    }
-  }
-  let changed = 0;
-  for (const i of claimed) {
-    if (adminId[i] !== targetAdmin) changed++;
-    adminId[i] = targetAdmin;
-  }
-  return changed;
-}
-
-export function cityMinimumMunicipalityArea(city) {
-  const populationArea = Math.sqrt(city.population || 0) * 0.72;
-  const footprintArea = (city.urbanFootprintCells || 0) * 0.42;
-  return clamp(95 + populationArea + footprintArea, 130, (city.population || 0) >= 450000 ? 780 : 520);
-}
-
-export function enforceCityMunicipalityCatchments(adminId, cities, context) {
-  const { prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, landuse, populationDensity, roadInfluence, railInfluence2, stationInfluence } = context;
-  const areaById = municipalityAreaById(adminId, prefectureMask, sea);
-  let changed = 0;
-  let protectedCities = 0;
-  let tooSmall = 0;
-  for (const city of cities || []) {
-    if (!city || (city.population || 0) < 95000 || !inside(city.x, city.y)) continue;
-    const start = indexOf(city.x, city.y);
-    if (!prefectureMask[start] || sea[start]) continue;
-    const targetAdmin = adminId[start];
-    if (targetAdmin < 0) continue;
-    protectedCities++;
-    const minArea = cityMinimumMunicipalityArea(city);
-    if ((areaById.get(targetAdmin) || 0) >= minArea) continue;
-    tooSmall++;
-    const heap = new MinHeap();
-    const best = new Float32Array(SIZE);
-    best.fill(INF);
-    heap.push({ i: start, f: 0 });
-    best[start] = 0;
-    const claimed = [];
-    const maxCost = (city.population || 0) >= 450000 ? 78 : 56;
-    let projectedArea = areaById.get(targetAdmin) || 0;
-    while (heap.length > 0 && projectedArea < minArea) {
-      const cur = heap.pop();
-      if (!cur || cur.f > best[cur.i] + 1e-5 || cur.f > maxCost) continue;
-      const [x, y] = xyOf(cur.i);
-      if (!prefectureMask[cur.i] || sea[cur.i]) continue;
-      const d = Math.hypot(x - city.x, y - city.y);
-      const compatible = d <= Math.max(5, (city.coreRadius || 3) * 2.0) ||
-        [2, 3, 4, 7, 8].includes(landuse[cur.i]) ||
-        populationDensity[cur.i] > 0.10 ||
-        roadInfluence[cur.i] > 0.10 ||
-        railInfluence2[cur.i] > 0.10 ||
-        (stationInfluence?.[cur.i] || 0) > 0.10 ||
-        valleyField[cur.i] > 0.22 ||
-        basinField[cur.i] > 0.20 ||
-        coastalLowland[cur.i] > 0.18;
-      if (!compatible && claimed.length > minArea * 0.55) continue;
-      claimed.push(cur.i);
-      if (adminId[cur.i] !== targetAdmin) projectedArea++;
-      for (const [dx, dy, step] of [[1, 0, 1], [-1, 0, 1], [0, 1, 1], [0, -1, 1], [1, 1, 1.41], [-1, 1, 1.41], [1, -1, 1.41], [-1, -1, 1.41]]) {
-        const nx = x + dx, ny = y + dy;
-        if (!inside(nx, ny)) continue;
-        const ni = indexOf(nx, ny);
-        if (!prefectureMask[ni] || sea[ni]) continue;
-        const majorBarrier = river[ni] > 0.62 || flowAccum[ni] > 0.74 || ridgeField[ni] > 0.70;
-        const barrier = ridgeField[ni] * 5.4 + Math.max(0, elevation[ni] - 0.60) * 4.4 + slope[ni] * 2.6 + (majorBarrier ? 8.5 : river[ni] > 0.34 ? 2.6 : 0);
-        const fit = ([2, 3, 4, 7, 8].includes(landuse[ni]) ? 2.4 : 0) + populationDensity[ni] * 2.2 + roadInfluence[ni] * 0.88 + railInfluence2[ni] * 0.92 + (stationInfluence?.[ni] || 0) * 1.15 + valleyField[ni] * 0.56 + basinField[ni] * 0.42 + coastalLowland[ni] * 0.34;
-        const nd = cur.f + Math.max(0.30, 1.05 + barrier - fit + Math.hypot(nx - city.x, ny - city.y) / Math.max(8, (city.urbanRadius || 7) * 2.1)) * step;
-        if (nd < best[ni]) {
-          best[ni] = nd;
-          heap.push({ i: ni, f: nd });
-        }
-      }
-    }
-    for (const i of claimed) {
-      const old = adminId[i];
-      if (old === targetAdmin) continue;
-      if (old >= 0) areaById.set(old, Math.max(0, (areaById.get(old) || 0) - 1));
-      adminId[i] = targetAdmin;
-      areaById.set(targetAdmin, (areaById.get(targetAdmin) || 0) + 1);
-      changed++;
-    }
-    city.municipalityMinArea = minArea;
-  }
-  return { changed, protectedCities, tooSmall };
-}
-
-
diff --git a/mapGeneratorHelpers.js b/mapGeneratorHelpers.js
deleted file mode 100644
index 68a3b16..0000000
--- a/mapGeneratorHelpers.js
+++ /dev/null
@@ -1,1375 +0,0 @@
-import { generateEntityName } from "./names.js";
-import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, hash2, indexOf, inside, nearMapEdge, pickEntities, rand, xyOf } from "./mapUtils.js";
-
-
-export function neighbors8(x, y) {
-  const out = [];
-  for (let dy = -1; dy <= 1; dy++) {
-    for (let dx = -1; dx <= 1; dx++) {
-      if (dx === 0 && dy === 0) continue;
-      const nx = x + dx;
-      const ny = y + dy;
-      if (inside(nx, ny)) out.push([nx, ny, Math.hypot(dx, dy)]);
-    }
-  }
-  return out;
-}
-
-export function neighbors4(x, y) {
-  const out = [];
-  for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]]) {
-    const nx = x + dx;
-    const ny = y + dy;
-    if (inside(nx, ny)) out.push([nx, ny, 1]);
-  }
-  return out;
-}
-
-export function distanceToNearest(points, x, y, fallback = 999) {
-  let best = fallback;
-  for (const p of points) best = Math.min(best, Math.hypot(p.x - x, p.y - y));
-  return best;
-}
-
-export function createPointSpatialIndex(points, cellSize = 12) {
-  const buckets = new Map();
-  const normalized = (points || [])
-    .filter((p) => p && Number.isFinite(p.x) && Number.isFinite(p.y))
-    .map((p) => ({ ...p, x: Math.round(p.x), y: Math.round(p.y) }));
-  const keyOf = (cx, cy) => `${cx},${cy}`;
-  for (const p of normalized) {
-    const cx = Math.floor(p.x / cellSize);
-    const cy = Math.floor(p.y / cellSize);
-    const key = keyOf(cx, cy);
-    let bucket = buckets.get(key);
-    if (!bucket) {
-      bucket = [];
-      buckets.set(key, bucket);
-    }
-    bucket.push(p);
-  }
-
-  function nearestDistanceSq(x, y, maxDistance = Math.max(MAP_W, MAP_H)) {
-    if (!normalized.length) return maxDistance * maxDistance;
-    const cx = Math.floor(x / cellSize);
-    const cy = Math.floor(y / cellSize);
-    const maxRing = Number.isFinite(maxDistance) ? Math.ceil(maxDistance / cellSize) : Math.ceil(Math.max(MAP_W, MAP_H) / cellSize);
-    let best = maxDistance * maxDistance;
-    for (let ring = 0; ring <= maxRing; ring++) {
-      for (let by = cy - ring; by <= cy + ring; by++) {
-        for (let bx = cx - ring; bx <= cx + ring; bx++) {
-          if (ring > 0 && bx > cx - ring && bx < cx + ring && by > cy - ring && by < cy + ring) continue;
-          const bucket = buckets.get(keyOf(bx, by));
-          if (!bucket) continue;
-          for (const p of bucket) {
-            const dx = p.x - x;
-            const dy = p.y - y;
-            const d2 = dx * dx + dy * dy;
-            if (d2 < best) best = d2;
-          }
-        }
-      }
-    }
-    return best;
-  }
-
-  return {
-    points: normalized,
-    hasWithin(x, y, radius) {
-      return nearestDistanceSq(x, y, radius) < radius * radius;
-    },
-    distance(x, y, fallback = 999) {
-      const d2 = nearestDistanceSq(x, y, fallback);
-      return d2 < fallback * fallback ? Math.sqrt(d2) : fallback;
-    },
-    nearestDistanceSq,
-  };
-}
-
-export function aStar(start, goal, costAt) {
-  const startIndex = indexOf(start.x, start.y);
-  const goalIndex = indexOf(goal.x, goal.y);
-  if (startIndex === goalIndex) return [[start.x, start.y]];
-
-  const score = new Float32Array(SIZE);
-  const cameFrom = new Int32Array(SIZE);
-  const closed = new Uint8Array(SIZE);
-  score.fill(INF);
-  cameFrom.fill(-1);
-
-  const heap = new MinHeap();
-  score[startIndex] = 0;
-  heap.push({ i: startIndex, f: Math.hypot(start.x - goal.x, start.y - goal.y) });
-
-  let guard = 0;
-  while (heap.length > 0 && guard++ < SIZE * 3) {
-    const current = heap.pop();
-    if (!current || closed[current.i]) continue;
-    closed[current.i] = 1;
-
-    if (current.i === goalIndex) {
-      const path = [];
-      let p = goalIndex;
-      while (p !== -1) {
-        const [x, y] = xyOf(p);
-        path.push([x, y]);
-        if (p === startIndex) break;
-        p = cameFrom[p];
-      }
-      return path.reverse();
-    }
-
-    const [cx, cy] = xyOf(current.i);
-    for (const [nx, ny, stepDistance] of neighbors8(cx, cy)) {
-      const nextIndex = indexOf(nx, ny);
-      if (closed[nextIndex]) continue;
-      const cost = costAt(nx, ny, cx, cy);
-      if (cost >= INF) continue;
-      const nextScore = score[current.i] + cost * stepDistance;
-      if (nextScore < score[nextIndex]) {
-        score[nextIndex] = nextScore;
-        cameFrom[nextIndex] = current.i;
-        heap.push({ i: nextIndex, f: nextScore + Math.hypot(nx - goal.x, ny - goal.y) * 0.78 });
-      }
-    }
-  }
-  return [];
-}
-
-export function influenceFromPaths(paths, radius) {
-  const grid = new Float32Array(SIZE);
-  const r = Math.ceil(radius);
-  const r2 = radius * radius;
-  for (const path of paths) {
-    for (const [x, y] of path) {
-      for (let dy = -r; dy <= r; dy++) {
-        for (let dx = -r; dx <= r; dx++) {
-          const nx = x + dx;
-          const ny = y + dy;
-          if (!inside(nx, ny)) continue;
-          const d2 = dx * dx + dy * dy;
-          if (d2 > r2) continue;
-          const d = Math.sqrt(d2);
-          const i = indexOf(nx, ny);
-          grid[i] = Math.max(grid[i], 1 / (1 + d));
-        }
-      }
-    }
-  }
-  return grid;
-}
-
-export function pointKey(p) {
-  return `${p.x},${p.y}`;
-}
-
-export function getDegree(degreeMap, p) {
-  return degreeMap.get(pointKey(p)) || 0;
-}
-
-export function incrementDegree(degreeMap, p) {
-  degreeMap.set(pointKey(p), getDegree(degreeMap, p) + 1);
-}
-
-export function nearestConnectable(points, target, degreeMap, maxDegree = 3) {
-  if (!points.length) return null;
-  const sorted = points
-    .map((p) => ({ ...p, d: Math.hypot(p.x - target.x, p.y - target.y), degree: getDegree(degreeMap, p) }))
-    .sort((a, b) => (a.degree >= maxDegree ? 22 : 0) + a.d + a.degree * 7 - ((b.degree >= maxDegree ? 22 : 0) + b.d + b.degree * 7));
-  return sorted.find((p) => p.degree < maxDegree) || sorted[0];
-}
-
-export function corridorPenalty(grid, x, y, hubs, endpoints, strength = 6) {
-  if (!grid) return 0;
-  const value = grid[indexOf(x, y)];
-  if (value <= 0.0001) return 0;
-
-  const nearEndpoint = distanceToNearest(endpoints, x, y) <= 3.2;
-  if (nearEndpoint) return 0;
-
-  const hubDistance = distanceToNearest(hubs, x, y);
-  if (hubDistance <= 3.5) return 0;
-  if (hubDistance <= 7.5) return value * strength * 0.28;
-  return value * strength;
-}
-
-export function nodeAvoidPenalty(points, x, y, endpoints, radius = 3.0, strength = 5.0) {
-  if (!points || points.length === 0) return 0;
-  if (distanceToNearest(endpoints, x, y) <= radius + 0.4) return 0;
-  const d = distanceToNearest(points, x, y);
-  if (d >= radius) return 0;
-  return (radius - d) * strength;
-}
-
-export function makeTransportCost(baseCost, existingPaths, hubs, endpoints, radius = 4, strength = 6, avoidPoints = [], avoidRadius = 3.0, avoidStrength = 5.0) {
-  const grid = existingPaths.length ? influenceFromPaths(existingPaths, radius) : null;
-  return (x, y, cx, cy) => {
-    const base = baseCost(x, y, cx, cy);
-    if (base >= INF) return base;
-    return base
-      + corridorPenalty(grid, x, y, hubs, endpoints, strength)
-      + nodeAvoidPenalty(avoidPoints, x, y, endpoints, avoidRadius, avoidStrength);
-  };
-}
-
-export function pathLength(path) {
-  let total = 0;
-  for (let i = 1; i < path.length; i++) total += Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]);
-  return total;
-}
-
-export function pathEndpointDistance(path) {
-  if (!path || path.length < 2) return 0;
-  const a = path[0];
-  const b = path[path.length - 1];
-  return Math.hypot(a[0] - b[0], a[1] - b[1]);
-}
-
-export function pathCompactness(path) {
-  const direct = pathEndpointDistance(path);
-  if (direct <= 0.001) return INF;
-  return pathLength(path) / direct;
-}
-
-export function pathOverlapRatio(path, existingPaths, radius = 2) {
-  if (!path?.length || !existingPaths?.length) return 0;
-  const grid = influenceFromPaths(existingPaths, radius);
-  let overlap = 0;
-  for (const [x, y] of path) if (grid[indexOf(x, y)] > 0.18) overlap++;
-  return overlap / Math.max(1, path.length);
-}
-
-export function compactPathArray(paths, { minLength = 8, maxOverlap = 0.35, maxCount = 99 } = {}) {
-  const kept = [];
-  for (const path of paths.slice().sort((a, b) => pathLength(b) - pathLength(a))) {
-    if (pathLength(path) < minLength) continue;
-    if (pathOverlapRatio(path, kept, 2) > maxOverlap) continue;
-    kept.push(path);
-    if (kept.length >= maxCount) break;
-  }
-  paths.splice(0, paths.length, ...kept);
-}
-
-export function bresenhamCells(a, b) {
-  const cells = [];
-  let x0 = a[0];
-  let y0 = a[1];
-  const x1 = b[0];
-  const y1 = b[1];
-  const dx = Math.abs(x1 - x0);
-  const dy = Math.abs(y1 - y0);
-  const sx = x0 < x1 ? 1 : -1;
-  const sy = y0 < y1 ? 1 : -1;
-  let err = dx - dy;
-  while (true) {
-    cells.push([x0, y0]);
-    if (x0 === x1 && y0 === y1) break;
-    const e2 = 2 * err;
-    if (e2 > -dy) { err -= dy; x0 += sx; }
-    if (e2 < dx) { err += dx; y0 += sy; }
-  }
-  return cells;
-}
-
-export function smoothPathByLineOfSight(path, passable, maxSegment = 9) {
-  if (!path || path.length < 3) return path || [];
-  const out = [path[0]];
-  let i = 0;
-  while (i < path.length - 1) {
-    let best = i + 1;
-    const limit = Math.min(path.length - 1, i + maxSegment);
-    for (let j = limit; j > i + 1; j--) {
-      const cells = bresenhamCells(path[i], path[j]);
-      if (cells.every(([x, y]) => inside(x, y) && passable(x, y))) { best = j; break; }
-    }
-    for (const cell of bresenhamCells(path[i], path[best]).slice(1)) out.push(cell);
-    i = best;
-  }
-  return out;
-}
-
-export function averagePathField(path, field) {
-  if (!path?.length) return 0;
-  let sum = 0;
-  for (const [x, y] of path) sum += field[indexOf(x, y)] || 0;
-  return sum / path.length;
-}
-
-export function influenceFromPoints(points, radius, weightFn = () => 1) {
-  const grid = new Float32Array(SIZE);
-  const r = Math.ceil(radius);
-  const r2 = radius * radius;
-  for (const p of points) {
-    const weight = weightFn(p);
-    for (let dy = -r; dy <= r; dy++) {
-      for (let dx = -r; dx <= r; dx++) {
-        const nx = p.x + dx;
-        const ny = p.y + dy;
-        if (!inside(nx, ny)) continue;
-        const d2 = dx * dx + dy * dy;
-        if (d2 > r2) continue;
-        const d = Math.sqrt(d2);
-        const i = indexOf(nx, ny);
-        grid[i] = Math.max(grid[i], weight / (1 + d));
-      }
-    }
-  }
-  return grid;
-}
-
-export function samplePath(path, step) {
-  const out = [];
-  for (let i = step; i < path.length - step; i += step) {
-    const [x, y] = path[i];
-    out.push({ x, y, score: 1 });
-  }
-  return out;
-}
-
-export function smoothMask(mask, passes = 2) {
-  let current = new Uint8Array(mask);
-  for (let pass = 0; pass < passes; pass++) {
-    const next = new Uint8Array(current);
-    for (let y = 1; y < MAP_H - 1; y++) {
-      for (let x = 1; x < MAP_W - 1; x++) {
-        const i = indexOf(x, y);
-        let count = 0;
-        for (let dy = -1; dy <= 1; dy++) {
-          for (let dx = -1; dx <= 1; dx++) {
-            if (current[indexOf(x + dx, y + dy)]) count++;
-          }
-        }
-        if (count >= 5) next[i] = 1;
-        else if (count <= 3) next[i] = 0;
-      }
-    }
-    current = next;
-  }
-  return current;
-}
-
-export function largestConnectedMask(mask) {
-  const seen = new Uint8Array(SIZE);
-  let best = [];
-  const queue = [];
-
-  for (let i = 0; i < SIZE; i++) {
-    if (!mask[i] || seen[i]) continue;
-    const component = [];
-    queue.length = 0;
-    queue.push(i);
-    seen[i] = 1;
-
-    for (let q = 0; q < queue.length; q++) {
-      const cur = queue[q];
-      component.push(cur);
-      const [x, y] = xyOf(cur);
-      for (const [nx, ny] of neighbors8(x, y)) {
-        const ni = indexOf(nx, ny);
-        if (!mask[ni] || seen[ni]) continue;
-        seen[ni] = 1;
-        queue.push(ni);
-      }
-    }
-
-    if (component.length > best.length) best = component;
-  }
-
-  const out = new Uint8Array(SIZE);
-  for (const i of best) out[i] = 1;
-  return out;
-}
-
-export function componentCount(mask) {
-  const seen = new Uint8Array(SIZE);
-  const queue = [];
-  let count = 0;
-  for (let i = 0; i < SIZE; i++) {
-    if (!mask[i] || seen[i]) continue;
-    count++;
-    queue.length = 0;
-    queue.push(i);
-    seen[i] = 1;
-    for (let q = 0; q < queue.length; q++) {
-      const [x, y] = xyOf(queue[q]);
-      for (const [nx, ny] of neighbors8(x, y)) {
-        const ni = indexOf(nx, ny);
-        if (!mask[ni] || seen[ni]) continue;
-        seen[ni] = 1;
-        queue.push(ni);
-      }
-    }
-  }
-  return count;
-}
-
-
-export function makePrefectureMask(seed, sea, elevation, slope, river) {
-  const candidates = [];
-  for (let y = 8; y < MAP_H - 8; y++) {
-    for (let x = 8; x < MAP_W - 8; x++) {
-      const i = indexOf(x, y);
-      if (sea[i]) continue;
-      const centrality = 1 - Math.hypot((x / MAP_W) - 0.5, (y / MAP_H) - 0.5) / 0.72;
-      const score = centrality * 0.28 + (1 - slope[i]) * 0.42 + (1 - Math.abs(elevation[i] - 0.42)) * 0.22 + Math.min(0.16, river[i] * 0.08);
-      candidates.push({ x, y, score });
-    }
-  }
-
-  const regionSeeds = pickEntities(candidates, {
-    max: 1,
-    minDistance: 18,
-    threshold: 0.35,
-    seed: seed + 904,
-    jitter: 0.02,
-  });
-
-  const mask = new Uint8Array(SIZE);
-  const dist = new Float32Array(SIZE);
-  dist.fill(INF);
-  const heap = new MinHeap();
-  const landCells = sea.reduce((a, v) => a + (v ? 0 : 1), 0);
-  const target = Math.floor(landCells * (0.23 + rand(seed, 906) * 0.08));
-
-  for (const s of regionSeeds) {
-    const i = indexOf(s.x, s.y);
-    dist[i] = 0;
-    heap.push({ i, f: 0 });
-  }
-
-  let claimed = 0;
-  while (heap.length > 0 && claimed < target) {
-    const current = heap.pop();
-    if (!current) continue;
-    const ci = current.i;
-    if (current.f > dist[ci] + 1e-5 || mask[ci]) continue;
-    const [cx, cy] = xyOf(ci);
-    if (sea[ci]) continue;
-
-    mask[ci] = 1;
-    claimed++;
-
-    for (const [nx, ny, step] of neighbors8(cx, cy)) {
-      const ni = indexOf(nx, ny);
-      if (sea[ni] || mask[ni]) continue;
-      const edgePenalty = nearMapEdge(nx, ny, 2) ? 4.2 : nearMapEdge(nx, ny, 5) ? 1.8 : 0;
-      const ridgePenalty = Math.max(0, elevation[ni] - 0.5) * 5.4 + Math.max(0, elevation[ni] - elevation[ci]) * 3.2;
-      const slopePenalty = slope[ni] * 4.1;
-      const riverPenalty = river[ni] > 0.65 ? 2.2 : river[ni] > 0.32 ? 0.9 : 0;
-      const cost = Math.max(0.18, 1 + edgePenalty + ridgePenalty + slopePenalty + riverPenalty + Math.abs(elevation[ni] - elevation[ci]) * 4.2) * step;
-      const nd = dist[ci] + cost;
-      if (nd < dist[ni]) {
-        dist[ni] = nd;
-        heap.push({ i: ni, f: nd });
-      }
-    }
-  }
-
-  return largestConnectedMask(smoothMask(mask, 2));
-}
-
-export function generateRegionalPrefectures(seed, sea, elevation, slope, river, ridgeField, flowAccum, anchorMask) {
-  const seeded = generateRegionalPrefecturesSeedGrowth(seed, sea, elevation, slope, river, ridgeField, flowAccum, anchorMask);
-  const beforeRegionId = new Int16Array(seeded.regionId);
-  const naturalBarrierScore = buildRegionalNaturalBarrierScore(sea, elevation, slope, river, ridgeField, flowAccum);
-  const beforeBorderCount = countRegionBorderEdges(beforeRegionId, sea);
-  const beforeNaturalAverage = averageRegionBorderBarrier(beforeRegionId, sea, naturalBarrierScore);
-  const beforeVoronoiLikeRate = regionalVoronoiLikeRate(beforeRegionId, seeded.centers, sea, naturalBarrierScore);
-
-  const { compartmentId, compartments } = buildRegionalNaturalCompartments(sea, elevation, slope, river, ridgeField, flowAccum, naturalBarrierScore);
-  const owner = new Int16Array(compartments.length);
-  owner.fill(-1);
-  for (let id = 0; id < seeded.centers.length; id++) {
-    const center = seeded.centers[id];
-    if (!center || !inside(center.x, center.y)) continue;
-    const ci = compartmentId[indexOf(center.x, center.y)];
-    if (ci >= 0) owner[ci] = id;
-  }
-  for (const unit of compartments) {
-    if (!unit || unit.area === 0) continue;
-    if (unit.cells.some((i) => anchorMask[i])) owner[unit.id] = 0;
-  }
-  for (let pass = 0; pass < compartments.length + 6; pass++) {
-    let changedThisPass = 0;
-    for (const unit of compartments) {
-      if (!unit || unit.area === 0 || owner[unit.id] >= 0) continue;
-      let bestOwner = -1;
-      let bestScore = -INF;
-      for (const [neighborId, edge] of unit.adjacent || []) {
-        const neighborOwner = owner[neighborId];
-        if (neighborOwner < 0) continue;
-        const neighbor = compartments[neighborId];
-        const center = seeded.centers[neighborOwner];
-        const barrier = edge.target / Math.max(1, edge.count);
-        const sameClass = neighbor?.classId === unit.classId ? 1.0 : 0;
-        const d = center ? Math.hypot(unit.x - center.x, unit.y - center.y) : 0;
-        const score = edge.count * 0.45 + sameClass + neighbor.coastalExposure * 0.08 + neighbor.ridgeExposure * 0.05 - barrier * 2.6 - d * 0.008;
-        if (score > bestScore) { bestScore = score; bestOwner = neighborOwner; }
-      }
-      if (bestOwner >= 0) {
-        owner[unit.id] = bestOwner;
-        changedThisPass++;
-      }
-    }
-    if (changedThisPass === 0) break;
-  }
-  for (const unit of compartments) {
-    if (!unit || unit.area === 0 || owner[unit.id] >= 0) continue;
-    let bestId = 0;
-    let best = -INF;
-    for (let id = 0; id < seeded.centers.length; id++) {
-      const center = seeded.centers[id];
-      if (!center) continue;
-      const d = Math.hypot(unit.x - center.x, unit.y - center.y);
-      const score = -d + (id === 0 ? (unit.cells.some((i) => anchorMask[i]) ? 1000 : -12) : 0);
-      if (score > best) { best = score; bestId = id; }
-    }
-    owner[unit.id] = bestId;
-  }
-
-  const regionId = new Int16Array(beforeRegionId);
-  for (const unit of compartments) {
-    const id = owner[unit.id];
-    if (id < 0) continue;
-    for (const i of unit.cells) regionId[i] = anchorMask[i] ? 0 : id;
-  }
-  for (let i = 0; i < SIZE; i++) if (anchorMask[i] && !sea[i]) regionId[i] = 0;
-  for (let pass = 0; pass < 4; pass++) repairRegionalTopology(regionId, sea, seeded.centers, anchorMask, 260);
-  repairDisconnectedRegionalPrefectures(regionId, sea, seeded.centers, anchorMask);
-  mergeTinyRegionalPrefectures(regionId, sea, seeded.centers, anchorMask, 720);
-  rebalanceOversizedRegionalPrefectures(regionId, sea, seeded.centers, anchorMask, naturalBarrierScore);
-  snapRegionalBoundariesToNaturalFeatures(regionId, sea, anchorMask, naturalBarrierScore, 2);
-  repairFinalRegionalTopology(regionId, sea, seeded.centers, anchorMask, naturalBarrierScore);
-
-  let changed = 0;
-  for (let i = 0; i < SIZE; i++) if (!sea[i] && beforeRegionId[i] !== regionId[i]) changed++;
-  const afterBorderCount = countRegionBorderEdges(regionId, sea);
-  const measuredAfterNaturalAverage = averageRegionBorderBarrier(regionId, sea, naturalBarrierScore);
-  const afterNaturalAverage = measuredAfterNaturalAverage;
-  const afterVoronoiLikeRate = regionalVoronoiLikeRate(regionId, seeded.centers, sea, naturalBarrierScore);
-
-  return {
-    regionId,
-    centers: seeded.centers,
-    naturalBarrierScore,
-    debug: {
-      regionalChangedAfterNaturalPartition: changed,
-      regionalBorderCountBefore: beforeBorderCount,
-      regionalBorderCountAfter: afterBorderCount,
-      regionalVoronoiLikeRateBefore: beforeVoronoiLikeRate,
-      regionalVoronoiLikeRateAfter: afterVoronoiLikeRate,
-      regionalNaturalBarrierAverageBefore: beforeNaturalAverage,
-      regionalNaturalBarrierAverageAfter: afterNaturalAverage,
-      regionalDisplayBorderCount: countRegionBorderEdges(regionId, sea),
-      regionalDisplayNaturalBarrierAverage: averageRegionBorderBarrier(regionId, sea, naturalBarrierScore),
-      regionalCompartmentCount: compartments.filter((unit) => unit.area > 0).length,
-      compartmentCount: compartments.filter((unit) => unit.area > 0).length,
-      changedAfterCompartmentAssignment: changed,
-      borderNaturalBarrierAverage: afterNaturalAverage,
-      voronoiLikeRate: afterVoronoiLikeRate,
-      finalRegionConnectivityMaxComponents: Math.max(0, ...[...new Set([...regionId].filter((id, i) => id >= 0 && !sea[i]))].map((id) => collectRegionComponents(regionId, sea, id).length)),
-      finalRegionalEnclaveCount: countRegionalEnclaves(regionId, sea),
-      finalRegionalMaxAreaShare: maxRegionalAreaShare(regionId, sea),
-    },
-  };
-}
-
-function generateRegionalPrefecturesSeedGrowth(seed, sea, elevation, slope, river, ridgeField, flowAccum, anchorMask) {
-  const centers = [];
-  let sx = 0;
-  let sy = 0;
-  let sc = 0;
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (anchorMask[i]) { sx += x; sy += y; sc++; }
-    }
-  }
-  if (sc > 0) centers.push({ x: Math.round(sx / sc), y: Math.round(sy / sc), score: 2, kind: "Current Prefecture" });
-
-  const candidates = [];
-  const ax = centers[0]?.x ?? MAP_W / 2;
-  const ay = centers[0]?.y ?? MAP_H / 2;
-  for (let y = 4; y < MAP_H - 4; y++) {
-    for (let x = 4; x < MAP_W - 4; x++) {
-      const i = indexOf(x, y);
-      if (sea[i] || anchorMask[i]) continue;
-      const edgePull = Math.max(Math.abs(x / MAP_W - 0.5), Math.abs(y / MAP_H - 0.5));
-      const awayFromCurrent = Math.hypot(x - ax, y - ay) / Math.hypot(MAP_W, MAP_H);
-      const settleable = (1 - slope[i]) * 0.24 + Math.max(0, 0.62 - elevation[i]) * 0.28 + flowAccum[i] * 0.08;
-      const score = edgePull * 0.55 + awayFromCurrent * 0.38 + settleable + hash2(x, y, seed + 6100) * 0.06;
-      candidates.push({ x, y, score, kind: "Neighbor Prefecture" });
-    }
-  }
-  centers.push(...pickEntities(candidates, {
-    max: 6 + Math.floor(rand(seed, 6101) * 4),
-    minDistance: 31,
-    threshold: 0.42,
-    seed: seed + 6102,
-    jitter: 0.02,
-  }));
-
-  const regionId = new Int16Array(SIZE);
-  regionId.fill(-1);
-  const dist = new Float32Array(SIZE);
-  dist.fill(INF);
-  const heap = new MinHeap();
-  centers.forEach((center, id) => {
-    const i = indexOf(center.x, center.y);
-    if (sea[i]) return;
-    regionId[i] = id;
-    dist[i] = 0;
-    heap.push({ i, f: 0 });
-  });
-
-  let guard = 0;
-  while (heap.length > 0 && guard++ < SIZE * 16) {
-    const cur = heap.pop();
-    if (!cur || cur.f > dist[cur.i] + 1e-5) continue;
-    const [cx, cy] = xyOf(cur.i);
-    const curRegion = regionId[cur.i];
-    for (const [nx, ny, step] of neighbors8(cx, cy)) {
-      const ni = indexOf(nx, ny);
-      if (sea[ni]) continue;
-      const ridge = Math.max(ridgeField[ni], ridgeField[cur.i]);
-      const riverBarrier = Math.max(river[ni], river[cur.i]);
-      const divide = ridge * 7.8 + Math.max(0, elevation[ni] - 0.54) * 4.4 + slope[ni] * 3.8;
-      const watershed = Math.max(0, flowAccum[cur.i] - flowAccum[ni]) * 0.7;
-      const riverCost = riverBarrier > 0.72 ? 4.6 : riverBarrier > 0.35 ? 1.9 : 0;
-      const stepCost = Math.max(0.22, 1 + divide + riverCost + watershed + Math.abs(elevation[ni] - elevation[cur.i]) * 3.2) * step;
-      const nd = dist[cur.i] + stepCost;
-      if (nd < dist[ni]) {
-        dist[ni] = nd;
-        regionId[ni] = curRegion;
-        heap.push({ i: ni, f: nd });
-      }
-    }
-  }
-  return { regionId, centers };
-}
-
-function collectRegionComponents(regionId, sea, id) {
-  const seen = new Uint8Array(SIZE);
-  const components = [];
-  for (let i = 0; i < SIZE; i++) {
-    if (seen[i] || sea[i] || regionId[i] !== id) continue;
-    const queue = [i];
-    const cells = [];
-    seen[i] = 1;
-    for (let q = 0; q < queue.length; q++) {
-      const cur = queue[q];
-      cells.push(cur);
-      const [x, y] = xyOf(cur);
-      for (const [nx, ny] of neighbors4(x, y)) {
-        const ni = indexOf(nx, ny);
-        if (seen[ni] || sea[ni] || regionId[ni] !== id) continue;
-        seen[ni] = 1;
-        queue.push(ni);
-      }
-    }
-    components.push(cells);
-  }
-  return components.sort((a, b) => b.length - a.length);
-}
-
-function chooseRegionalReassignment(cells, regionId, sea, centers, forbiddenId = -1) {
-  const adjacent = new Map();
-  let sx = 0, sy = 0;
-  for (const i of cells) {
-    const [x, y] = xyOf(i);
-    sx += x; sy += y;
-    for (const [nx, ny] of neighbors4(x, y)) {
-      const ni = indexOf(nx, ny);
-      const id = regionId[ni];
-      if (sea[ni] || id < 0 || id === forbiddenId) continue;
-      adjacent.set(id, (adjacent.get(id) || 0) + 1);
-    }
-  }
-  let bestId = -1;
-  let bestScore = -INF;
-  const cx = sx / Math.max(1, cells.length);
-  const cy = sy / Math.max(1, cells.length);
-  for (const [id, edge] of adjacent) {
-    const center = centers[id];
-    const d = center ? Math.hypot(center.x - cx, center.y - cy) : 0;
-    const score = edge * 4 - d * 0.04 + (id === 0 ? -1.5 : 0);
-    if (score > bestScore) { bestScore = score; bestId = id; }
-  }
-  if (bestId >= 0) return bestId;
-  for (let id = 0; id < centers.length; id++) {
-    if (id === forbiddenId || !centers[id]) continue;
-    const d = Math.hypot(centers[id].x - cx, centers[id].y - cy);
-    const score = -d + (id === 0 ? -8 : 0);
-    if (score > bestScore) { bestScore = score; bestId = id; }
-  }
-  return bestId;
-}
-
-function nearestRegionalReassignmentByLand(cells, regionId, sea, forbiddenId = -1) {
-  const seen = new Uint8Array(SIZE);
-  const queue = [];
-  for (const i of cells) {
-    seen[i] = 1;
-    queue.push(i);
-  }
-  for (let q = 0; q < queue.length; q++) {
-    const cur = queue[q];
-    const [x, y] = xyOf(cur);
-    for (const [nx, ny] of neighbors4(x, y)) {
-      const ni = indexOf(nx, ny);
-      if (sea[ni] || seen[ni]) continue;
-      const id = regionId[ni];
-      if (id >= 0 && id !== forbiddenId) return id;
-      seen[ni] = 1;
-      queue.push(ni);
-    }
-  }
-  return -1;
-}
-
-function repairDisconnectedRegionalPrefectures(regionId, sea, centers, anchorMask) {
-  let totalChanged = 0;
-  for (let pass = 0; pass < 10; pass++) {
-    let changedThisPass = 0;
-    const ids = [...new Set([...regionId].filter((id, i) => id >= 0 && !sea[i]))].sort((a, b) => a - b);
-    for (const id of ids) {
-      const components = collectRegionComponents(regionId, sea, id);
-      if (components.length <= 1) continue;
-      let keepIndex = 0;
-      if (id === 0) {
-        const anchorIndex = components.findIndex((cells) => cells.some((i) => anchorMask[i]));
-        if (anchorIndex >= 0) keepIndex = anchorIndex;
-      }
-      for (let c = 0; c < components.length; c++) {
-        if (c === keepIndex) continue;
-        const replacement =
-          chooseRegionalReassignment(components[c], regionId, sea, centers, id) ??
-          nearestRegionalReassignmentByLand(components[c], regionId, sea, id);
-        const target = replacement >= 0 ? replacement : nearestRegionalReassignmentByLand(components[c], regionId, sea, id);
-        if (target < 0) continue;
-        for (const i of components[c]) {
-          if (anchorMask[i]) continue;
-          regionId[i] = target;
-          changedThisPass++;
-        }
-      }
-    }
-    totalChanged += changedThisPass;
-    for (let i = 0; i < SIZE; i++) if (anchorMask[i] && !sea[i]) regionId[i] = 0;
-    if (changedThisPass === 0) break;
-  }
-  return totalChanged;
-}
-
-function componentTouchesOutside(cells, sea) {
-  for (const i of cells) {
-    const [x, y] = xyOf(i);
-    if (x === 0 || y === 0 || x === MAP_W - 1 || y === MAP_H - 1) return true;
-    for (const [nx, ny] of neighbors4(x, y)) if (sea[indexOf(nx, ny)]) return true;
-  }
-  return false;
-}
-
-function boundaryNeighborIds(cells, regionId, sea, ownId) {
-  const ids = new Set();
-  for (const i of cells) {
-    const [x, y] = xyOf(i);
-    for (const [nx, ny] of neighbors4(x, y)) {
-      const ni = indexOf(nx, ny);
-      const id = regionId[ni];
-      if (!sea[ni] && id >= 0 && id !== ownId) ids.add(id);
-    }
-  }
-  return ids;
-}
-
-function countRegionalEnclaves(regionId, sea) {
-  let count = 0;
-  const ids = [...new Set([...regionId].filter((id, i) => id >= 0 && !sea[i]))].sort((a, b) => a - b);
-  for (const id of ids) {
-    for (const cells of collectRegionComponents(regionId, sea, id)) {
-      if (componentTouchesOutside(cells, sea)) continue;
-      if (boundaryNeighborIds(cells, regionId, sea, id).size === 1) count++;
-    }
-  }
-  return count;
-}
-
-function carveRegionalCorridor(regionId, sea, cells, ownId, enclosingId, naturalBarrierScore) {
-  const best = new Float32Array(SIZE);
-  const cameFrom = new Int32Array(SIZE);
-  best.fill(INF);
-  cameFrom.fill(-1);
-  const heap = new MinHeap();
-  const source = new Uint8Array(SIZE);
-  for (const i of cells) {
-    source[i] = 1;
-    best[i] = 0;
-    heap.push({ i, f: 0 });
-  }
-  let target = -1;
-  while (heap.length) {
-    const cur = heap.pop();
-    if (!cur || cur.f > best[cur.i] + 1e-5) continue;
-    const [x, y] = xyOf(cur.i);
-    if (!source[cur.i]) {
-      if (x === 0 || y === 0 || x === MAP_W - 1 || y === MAP_H - 1) { target = cur.i; break; }
-      let seaAdjacent = false;
-      let otherAdjacent = false;
-      for (const [nx, ny] of neighbors4(x, y)) {
-        const ni = indexOf(nx, ny);
-        if (sea[ni]) seaAdjacent = true;
-        else if (regionId[ni] >= 0 && regionId[ni] !== ownId && regionId[ni] !== enclosingId) otherAdjacent = true;
-      }
-      if (seaAdjacent || otherAdjacent) { target = cur.i; break; }
-    }
-    for (const [nx, ny] of neighbors4(x, y)) {
-      const ni = indexOf(nx, ny);
-      if (sea[ni] || regionId[ni] === ownId) continue;
-      const id = regionId[ni];
-      const regionPenalty = id === enclosingId ? 0 : 8;
-      const barrier = naturalBarrierScore?.[ni] || 0;
-      const nd = cur.f + 1 + barrier * 3.2 + regionPenalty;
-      if (nd < best[ni]) {
-        best[ni] = nd;
-        cameFrom[ni] = cur.i;
-        heap.push({ i: ni, f: nd });
-      }
-    }
-  }
-  if (target < 0) return 0;
-  let changed = 0;
-  for (let i = target; i >= 0 && regionId[i] !== ownId; i = cameFrom[i]) {
-    if (!sea[i] && regionId[i] !== ownId) {
-      regionId[i] = ownId;
-      changed++;
-    }
-    if (cameFrom[i] < 0) break;
-  }
-  return changed;
-}
-
-function repairRegionalEnclaves(regionId, sea, centers, anchorMask, naturalBarrierScore) {
-  let changed = 0;
-  const ids = [...new Set([...regionId].filter((id, i) => id >= 0 && !sea[i]))].sort((a, b) => a - b);
-  for (const id of ids) {
-    const components = collectRegionComponents(regionId, sea, id);
-    for (const cells of components) {
-      if (componentTouchesOutside(cells, sea)) continue;
-      const neighbors = boundaryNeighborIds(cells, regionId, sea, id);
-      if (neighbors.size !== 1) continue;
-      const enclosingId = [...neighbors][0];
-      const protectedAnchor = id === 0 && cells.some((i) => anchorMask[i]);
-      if (protectedAnchor) {
-        changed += carveRegionalCorridor(regionId, sea, cells, id, enclosingId, naturalBarrierScore);
-      } else {
-        for (const i of cells) {
-          if (anchorMask[i]) continue;
-          regionId[i] = enclosingId;
-          changed++;
-        }
-      }
-    }
-  }
-  for (let i = 0; i < SIZE; i++) if (anchorMask[i] && !sea[i]) regionId[i] = 0;
-  return changed;
-}
-
-function repairFinalRegionalTopology(regionId, sea, centers, anchorMask, naturalBarrierScore) {
-  let totalChanged = 0;
-  for (let pass = 0; pass < 12; pass++) {
-    const disconnected = repairDisconnectedRegionalPrefectures(regionId, sea, centers, anchorMask);
-    const enclaves = repairRegionalEnclaves(regionId, sea, centers, anchorMask, naturalBarrierScore);
-    totalChanged += disconnected + enclaves;
-    if (disconnected + enclaves === 0) break;
-  }
-  return totalChanged;
-}
-
-function regionalAreaById(regionId, sea) {
-  const area = new Map();
-  for (let i = 0; i < SIZE; i++) if (!sea[i] && regionId[i] >= 0) area.set(regionId[i], (area.get(regionId[i]) || 0) + 1);
-  return area;
-}
-
-function maxRegionalAreaShare(regionId, sea) {
-  const area = regionalAreaById(regionId, sea);
-  const land = [...area.values()].reduce((sum, value) => sum + value, 0);
-  return land ? Math.max(0, ...area.values()) / land : 0;
-}
-
-function canMoveRegionalBoundaryCell(regionId, sea, i, ownId) {
-  const [x, y] = xyOf(i);
-  let ownNeighbors = 0;
-  let otherNeighbors = 0;
-  for (const [nx, ny] of neighbors4(x, y)) {
-    const ni = indexOf(nx, ny);
-    if (sea[ni]) continue;
-    if (regionId[ni] === ownId) ownNeighbors++;
-    else if (regionId[ni] >= 0) otherNeighbors++;
-  }
-  return ownNeighbors >= 2 && otherNeighbors > 0;
-}
-
-function rebalanceOversizedRegionalPrefectures(regionId, sea, centers, anchorMask, naturalBarrierScore) {
-  const minArea = 720;
-  for (let pass = 0; pass < 4; pass++) {
-    const area = regionalAreaById(regionId, sea);
-    const land = [...area.values()].reduce((sum, value) => sum + value, 0);
-    const maxArea = Math.max(minArea * 2, Math.floor(land * 0.32));
-    let changed = 0;
-    const oversized = [...area.entries()].filter(([, value]) => value > maxArea).sort((a, b) => b[1] - a[1]);
-    for (const [id] of oversized) {
-      const candidates = [];
-      for (let y = 1; y < MAP_H - 1; y++) {
-        for (let x = 1; x < MAP_W - 1; x++) {
-          const i = indexOf(x, y);
-          if (sea[i] || regionId[i] !== id || anchorMask[i] || !canMoveRegionalBoundaryCell(regionId, sea, i, id)) continue;
-          const counts = new Map();
-          for (const [nx, ny] of neighbors4(x, y)) {
-            const ni = indexOf(nx, ny);
-            const other = regionId[ni];
-            if (!sea[ni] && other >= 0 && other !== id && (area.get(other) || 0) < maxArea) counts.set(other, (counts.get(other) || 0) + 1);
-          }
-          for (const [other, edge] of counts) {
-            const center = centers[other];
-            const d = center ? Math.hypot(center.x - x, center.y - y) : 0;
-            candidates.push({ i, other, score: edge * 2.0 + (naturalBarrierScore?.[i] || 0) * 1.4 - d * 0.006 });
-          }
-        }
-      }
-      candidates.sort((a, b) => b.score - a.score || a.i - b.i);
-      for (const candidate of candidates) {
-        if ((area.get(id) || 0) <= maxArea) break;
-        if ((area.get(candidate.other) || 0) >= maxArea || regionId[candidate.i] !== id) continue;
-        regionId[candidate.i] = candidate.other;
-        area.set(id, (area.get(id) || 0) - 1);
-        area.set(candidate.other, (area.get(candidate.other) || 0) + 1);
-        changed++;
-      }
-    }
-    repairDisconnectedRegionalPrefectures(regionId, sea, centers, anchorMask);
-    if (!changed) break;
-  }
-}
-
-function snapRegionalBoundariesToNaturalFeatures(regionId, sea, anchorMask, naturalBarrierScore, passes = 2) {
-  for (let pass = 0; pass < passes; pass++) {
-    const before = new Int16Array(regionId);
-    let changed = 0;
-    for (let y = 1; y < MAP_H - 1; y++) {
-      for (let x = 1; x < MAP_W - 1; x++) {
-        const i = indexOf(x, y);
-        const own = before[i];
-        if (sea[i] || own < 0 || anchorMask[i]) continue;
-        const hereBarrier = naturalBarrierScore?.[i] || 0;
-        if (hereBarrier > 0.54 || !canMoveRegionalBoundaryCell(before, sea, i, own)) continue;
-        const counts = new Map();
-        let bestNeighborBarrier = 0;
-        for (const [nx, ny] of neighbors4(x, y)) {
-          const ni = indexOf(nx, ny);
-          const other = before[ni];
-          if (sea[ni] || other < 0) continue;
-          bestNeighborBarrier = Math.max(bestNeighborBarrier, naturalBarrierScore?.[ni] || 0);
-          if (other !== own) counts.set(other, (counts.get(other) || 0) + 1);
-        }
-        if (counts.size === 0 || bestNeighborBarrier < hereBarrier + 0.18) continue;
-        let target = -1, best = -1;
-        for (const [other, count] of counts) if (count > best) { best = count; target = other; }
-        if (target >= 0 && best >= 2) {
-          regionId[i] = target;
-          changed++;
-        }
-      }
-    }
-    if (!changed) break;
-  }
-}
-
-function mergeTinyRegionalPrefectures(regionId, sea, centers, anchorMask, minArea) {
-  const ids = [...new Set([...regionId].filter((id, i) => id >= 0 && !sea[i]))].sort((a, b) => a - b);
-  for (const id of ids) {
-    if (id === 0) continue;
-    const cells = [];
-    for (let i = 0; i < SIZE; i++) if (!sea[i] && regionId[i] === id) cells.push(i);
-    if (cells.length === 0 || cells.length >= minArea) continue;
-    const replacement = chooseRegionalReassignment(cells, regionId, sea, centers, id);
-    if (replacement < 0) continue;
-    for (const i of cells) if (!anchorMask[i]) regionId[i] = replacement;
-  }
-}
-
-function buildRegionalNaturalBarrierScore(sea, elevation, slope, river, ridgeField, flowAccum) {
-  const score = new Float32Array(SIZE);
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (sea[i]) continue;
-      let coast = 0;
-      for (const [nx, ny] of neighbors8(x, y)) if (sea[indexOf(nx, ny)]) coast = 1;
-      const highRidge = clamp(ridgeField[i] * 1.75 + Math.max(0, elevation[i] - 0.56) * 0.72);
-      const slopeBreak = clamp(slope[i] * 0.92 + Math.max(0, slope[i] - 0.32) * 0.80);
-      const majorRiver = clamp(Math.max(0, river[i] - 0.26) * 1.85 + Math.max(0, flowAccum[i] - 0.36) * 0.86);
-      const watershedDivide = clamp(ridgeField[i] * Math.max(0, 0.62 - flowAccum[i]) * 1.08 + Math.max(0, elevation[i] - 0.50) * slope[i] * 0.72);
-      score[i] = clamp(highRidge * 0.88 + slopeBreak * 0.48 + majorRiver * 0.82 + watershedDivide * 0.58 + coast * 0.46);
-    }
-  }
-  return score;
-}
-
-function regionalLandscapeClass(i, sea, elevation, slope, river, ridgeField, flowAccum) {
-  if (sea[i]) return -1;
-  if (ridgeField[i] > 0.56 || elevation[i] > 0.68) return 1;
-  if (river[i] > 0.44 || flowAccum[i] > 0.58) return 2;
-  if (slope[i] > 0.42 || (ridgeField[i] > 0.36 && elevation[i] > 0.52)) return 3;
-  if (elevation[i] < 0.36 && slope[i] < 0.20) return 4;
-  if (elevation[i] < 0.48 && flowAccum[i] > 0.18) return 5;
-  return 6;
-}
-
-function canShareRegionalCompartment(a, b, classA, classB, barrier, river, flowAccum) {
-  const sameFamily = classA === classB || ([4, 5, 6].includes(classA) && [4, 5, 6].includes(classB));
-  if (!sameFamily) return false;
-  const majorRiver = Math.max(river[a], river[b]) > 0.58 || Math.max(flowAccum[a], flowAccum[b]) > 0.72;
-  const threshold = classA === 1 || classB === 1 ? 0.38 : classA === 2 || classB === 2 ? 0.52 : 0.62;
-  return barrier < threshold && !majorRiver;
-}
-
-function buildRegionalNaturalCompartments(sea, elevation, slope, river, ridgeField, flowAccum, naturalBarrierScore) {
-  const compartmentId = new Int32Array(SIZE);
-  const cellClass = new Int16Array(SIZE);
-  compartmentId.fill(-1);
-  cellClass.fill(-1);
-  for (let i = 0; i < SIZE; i++) cellClass[i] = regionalLandscapeClass(i, sea, elevation, slope, river, ridgeField, flowAccum);
-
-  const compartments = [];
-  const queue = [];
-  for (let i = 0; i < SIZE; i++) {
-    if (cellClass[i] < 0 || compartmentId[i] >= 0) continue;
-    const id = compartments.length;
-    const klass = cellClass[i];
-    const cells = [];
-    let sx = 0, sy = 0, ridgeExposure = 0, riverExposure = 0, coastalExposure = 0;
-    queue.length = 0;
-    queue.push(i);
-    compartmentId[i] = id;
-    for (let q = 0; q < queue.length; q++) {
-      const cur = queue[q];
-      const [x, y] = xyOf(cur);
-      cells.push(cur);
-      sx += x;
-      sy += y;
-      ridgeExposure += ridgeField[cur];
-      riverExposure += river[cur] + flowAccum[cur] * 0.45;
-      let coast = 0;
-      for (const [nx, ny] of neighbors8(x, y)) if (sea[indexOf(nx, ny)]) coast = 1;
-      coastalExposure += coast;
-      for (const [nx, ny] of neighbors4(x, y)) {
-        const ni = indexOf(nx, ny);
-        if (compartmentId[ni] >= 0 || cellClass[ni] < 0) continue;
-        const barrier = (naturalBarrierScore[cur] + naturalBarrierScore[ni]) * 0.5;
-        if (!canShareRegionalCompartment(cur, ni, klass, cellClass[ni], barrier, river, flowAccum)) continue;
-        compartmentId[ni] = id;
-        queue.push(ni);
-      }
-    }
-    const area = cells.length;
-    compartments.push({
-      id,
-      cells,
-      area,
-      classId: klass,
-      x: sx / Math.max(1, area),
-      y: sy / Math.max(1, area),
-      ridgeExposure: ridgeExposure / Math.max(1, area),
-      riverExposure: riverExposure / Math.max(1, area),
-      coastalExposure: coastalExposure / Math.max(1, area),
-      adjacent: new Map(),
-    });
-  }
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (sea[i]) continue;
-      const a = compartmentId[i];
-      if (a < 0 || !compartments[a]) continue;
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        if (!inside(nx, ny)) continue;
-        const ni = indexOf(nx, ny);
-        if (sea[ni]) continue;
-        const b = compartmentId[ni];
-        if (b < 0 || a === b || !compartments[b]) continue;
-        const v = (naturalBarrierScore[i] + naturalBarrierScore[ni]) * 0.5;
-        const edgeA = compartments[a].adjacent.get(b) || { count: 0, target: 0 };
-        edgeA.count++;
-        edgeA.target += v;
-        compartments[a].adjacent.set(b, edgeA);
-        const edgeB = compartments[b].adjacent.get(a) || { count: 0, target: 0 };
-        edgeB.count++;
-        edgeB.target += v;
-        compartments[b].adjacent.set(a, edgeB);
-      }
-    }
-  }
-  return { compartmentId, compartments };
-}
-
-function countRegionBorderEdges(regionId, sea) {
-  let count = 0;
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (sea[i] || regionId[i] < 0) continue;
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        if (!inside(nx, ny)) continue;
-        const ni = indexOf(nx, ny);
-        if (!sea[ni] && regionId[ni] >= 0 && regionId[ni] !== regionId[i]) count++;
-      }
-    }
-  }
-  return count;
-}
-
-function averageRegionBorderBarrier(regionId, sea, naturalBarrierScore) {
-  let sum = 0;
-  let count = 0;
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (sea[i] || regionId[i] < 0) continue;
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        if (!inside(nx, ny)) continue;
-        const ni = indexOf(nx, ny);
-        if (sea[ni] || regionId[ni] < 0 || regionId[ni] === regionId[i]) continue;
-        sum += (naturalBarrierScore[i] + naturalBarrierScore[ni]) * 0.5;
-        count++;
-      }
-    }
-  }
-  return count ? sum / count : 0;
-}
-
-function regionalVoronoiLikeRate(regionId, centers, sea, naturalBarrierScore) {
-  let weak = 0;
-  let total = 0;
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (sea[i] || regionId[i] < 0) continue;
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        if (!inside(nx, ny)) continue;
-        const ni = indexOf(nx, ny);
-        const a = regionId[i];
-        const b = regionId[ni];
-        if (sea[ni] || a < 0 || b < 0 || a === b) continue;
-        total++;
-        const ca = centers[a], cb = centers[b];
-        if (!ca || !cb) continue;
-        const mx = (x + nx) * 0.5;
-        const my = (y + ny) * 0.5;
-        const nearBisector = Math.abs(Math.hypot(mx - ca.x, my - ca.y) - Math.hypot(mx - cb.x, my - cb.y)) < 4.5;
-        if (nearBisector && (naturalBarrierScore[i] + naturalBarrierScore[ni]) * 0.5 < 0.36) weak++;
-      }
-    }
-  }
-  return total ? weak / total : 0;
-}
-
-function repairRegionalTopology(regionId, sea, centers, anchorMask, maxIslandCells = 260) {
-  const ids = new Set();
-  for (let i = 0; i < SIZE; i++) if (!sea[i] && regionId[i] >= 0) ids.add(regionId[i]);
-  const queue = [];
-  for (const id of ids) {
-    const seen = new Uint8Array(SIZE);
-    const components = [];
-    for (let i = 0; i < SIZE; i++) {
-      if (seen[i] || sea[i] || regionId[i] !== id) continue;
-      const cells = [];
-      let hasAnchor = false;
-      let hasCenter = false;
-      const centerIndex = centers[id] && inside(centers[id].x, centers[id].y) ? indexOf(centers[id].x, centers[id].y) : -1;
-      queue.length = 0;
-      queue.push(i);
-      seen[i] = 1;
-      for (let q = 0; q < queue.length; q++) {
-        const cur = queue[q];
-        cells.push(cur);
-        if (anchorMask[cur]) hasAnchor = true;
-        if (cur === centerIndex) hasCenter = true;
-        const [x, y] = xyOf(cur);
-        for (const [nx, ny] of neighbors4(x, y)) {
-          const ni = indexOf(nx, ny);
-          if (seen[ni] || sea[ni] || regionId[ni] !== id) continue;
-          seen[ni] = 1;
-          queue.push(ni);
-        }
-      }
-      components.push({ cells, hasAnchor, hasCenter });
-    }
-    if (components.length <= 1) continue;
-    components.sort((a, b) => (b.hasAnchor ? 2000000 : 0) + (b.hasCenter ? 1000000 : 0) + b.cells.length - ((a.hasAnchor ? 2000000 : 0) + (a.hasCenter ? 1000000 : 0) + a.cells.length));
-    for (const comp of components.slice(1)) {
-      const counts = new Map();
-      for (const ci of comp.cells) {
-        const [x, y] = xyOf(ci);
-        for (const [nx, ny] of neighbors4(x, y)) {
-          const ni = indexOf(nx, ny);
-          const other = regionId[ni];
-          if (!sea[ni] && other >= 0 && other !== id) counts.set(other, (counts.get(other) || 0) + 1);
-        }
-      }
-      let target = -1;
-      let best = -1;
-      for (const [other, count] of counts) if (count > best) { best = count; target = other; }
-      if (target >= 0) for (const ci of comp.cells) if (!anchorMask[ci]) regionId[ci] = target;
-    }
-  }
-  for (let i = 0; i < SIZE; i++) if (anchorMask[i] && !sea[i]) regionId[i] = 0;
-}
-
-export function extractRegionBorderSegments(regionId, sea, options = {}) {
-  const segments = [];
-  const nameById = options.prefectureRegions
-    ? new Map(options.prefectureRegions.map((region) => [region.id, region.name]))
-    : null;
-  const fail = (message) => {
-    if (options.throwOnInvalid) throw new Error(message);
-    if (options.logInvalid) console.error(message);
-  };
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (sea[i] || regionId[i] < 0) continue;
-      const a = regionId[i];
-      if (x + 1 < MAP_W && !sea[indexOf(x + 1, y)]) {
-        const ni = indexOf(x + 1, y);
-        const b = regionId[ni];
-        if (b >= 0 && a !== b) segments.push([[x + 1, y], [x + 1, y + 1]]);
-        else if (options.validateSameId && b >= 0 && a === b) fail(`Invalid prefecture border candidate at (${x},${y})/(${x + 1},${y}): both id=${a}, name=${nameById?.get(a) || "-"}`);
-      }
-      if (y + 1 < MAP_H && !sea[indexOf(x, y + 1)]) {
-        const ni = indexOf(x, y + 1);
-        const b = regionId[ni];
-        if (b >= 0 && a !== b) segments.push([[x, y + 1], [x + 1, y + 1]]);
-        else if (options.validateSameId && b >= 0 && a === b) fail(`Invalid prefecture border candidate at (${x},${y})/(${x},${y + 1}): both id=${a}, name=${nameById?.get(a) || "-"}`);
-      }
-    }
-  }
-  if (options.throwOnInvalid) {
-    for (const segment of segments) {
-      const [[x1, y1], [x2, y2]] = segment;
-      let ax = -1, ay = -1, bx = -1, by = -1;
-      if (x1 === x2) {
-        ax = x1 - 1; bx = x1; ay = by = Math.min(y1, y2);
-      } else if (y1 === y2) {
-        ax = bx = Math.min(x1, x2); ay = y1 - 1; by = y1;
-      }
-      if (!inside(ax, ay) || !inside(bx, by)) continue;
-      const ai = indexOf(ax, ay);
-      const bi = indexOf(bx, by);
-      const a = regionId[ai];
-      const b = regionId[bi];
-      if (sea[ai] || sea[bi] || a < 0 || b < 0 || a === b) {
-        throw new Error(`Invalid emitted prefecture border ${JSON.stringify(segment)} between (${ax},${ay}) id=${a} name=${nameById?.get(a) || "-"} and (${bx},${by}) id=${b} name=${nameById?.get(b) || "-"}`);
-      }
-    }
-  }
-  return segments;
-}
-
-export function extractMaskBorder(mask, sea = null) {
-  const segments = [];
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      const a = mask[i];
-      if (x + 1 < MAP_W) {
-        const ni = indexOf(x + 1, y);
-        const b = mask[ni];
-        if (a !== b && !(sea && (sea[i] || sea[ni]))) segments.push([[x + 1, y], [x + 1, y + 1]]);
-      }
-      if (y + 1 < MAP_H) {
-        const ni = indexOf(x, y + 1);
-        const b = mask[ni];
-        if (a !== b && !(sea && (sea[i] || sea[ni]))) segments.push([[x, y + 1], [x + 1, y + 1]]);
-      }
-    }
-  }
-  return segments;
-}
-
-export function extractAdminBorderSegments(adminId, prefectureMask) {
-  const segments = [];
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (!prefectureMask[i]) continue;
-      const a = adminId[i];
-      if (a < 0) continue;
-      if (x + 1 < MAP_W && prefectureMask[indexOf(x + 1, y)]) {
-        const b = adminId[indexOf(x + 1, y)];
-        if (b >= 0 && a !== b) segments.push([[x + 1, y], [x + 1, y + 1]]);
-      }
-      if (y + 1 < MAP_H && prefectureMask[indexOf(x, y + 1)]) {
-        const b = adminId[indexOf(x, y + 1)];
-        if (b >= 0 && a !== b) segments.push([[x, y + 1], [x + 1, y + 1]]);
-      }
-    }
-  }
-  return segments;
-}
-
-export function tagInsidePrefecture(points, prefectureMask) {
-  return points.map((p) => ({ ...p, insidePrefecture: Boolean(prefectureMask[indexOf(p.x, p.y)]) }));
-}
-
-export function attachIdsAndNames(points, prefix, seed, kindOverride = null, nameFields = null, usedNames = null, nameDebug = null) {
-  return points.map((p, i) => {
-    const id = `${prefix}-${i}`;
-    const kind = kindOverride || p.kind;
-    if (prefix === "logistics") {
-      return {
-        ...p,
-        id,
-        name: null,
-        facilityLabel: p.facilityLabel || "Logistics Park",
-        kind,
-        labelStyle: "facility",
-        suppressSettlementLabel: true,
-        insidePrefecture: Boolean(p.insidePrefecture),
-      };
-    }
-    const name = generateEntityName(seed + prefix.length * 1000, id, { ...p, kind }, nameFields, usedNames, nameDebug);
-    if (usedNames) usedNames.add(name);
-    return {
-      ...p,
-      id,
-      name,
-      kind,
-      insidePrefecture: Boolean(p.insidePrefecture),
-    };
-  });
-}
-
-export function applyOutputOptions(map, options = {}) {
-  if (options.includeDebugFields !== false) return map;
-  const slim = { ...map };
-  delete slim.settlementCluster;
-  delete slim.ridgeField;
-  delete slim.valleyField;
-  delete slim.basinField;
-  delete slim.coastalLowland;
-  delete slim.flowAccum;
-  delete slim.erosionField;
-  delete slim.depositionField;
-  delete slim.terrainTemplate;
-  delete slim.ocean;
-  delete slim.lake;
-  delete slim.arcSpineField;
-  delete slim.branchRidgeField;
-  delete slim.depositionalLowland;
-  delete slim.alluvialFanField;
-  delete slim.deltaField;
-  delete slim.naturalBarrierScore;
-  return slim;
-}
diff --git a/mapPatch.js b/mapPatch.js
deleted file mode 100644
index f8457d2..0000000
--- a/mapPatch.js
+++ /dev/null
@@ -1,2272 +0,0 @@
-import { MAP_H, MAP_W, SIZE, MinHeap, clamp, hash2, lerp, smoothstep, valueNoise } from "./mapUtils.js";
-import { generateMap } from "./mapPipeline.js";
-import { LANDUSE } from "./landuseCodes.js";
-import { reconcileMunicipalMetadata, refreshPrefectureRegionsMetadata } from "./mapMunicipalCoherence.js";
-
-export const PATCH_MIN_WIDTH = 48;
-export const PATCH_MIN_HEIGHT = 48;
-export const PATCH_MIN_AREA = 3000;
-
-const POINT_LAYER_KEYS = [
-  "villages", "geographicUrbanAnchors", "markets", "castles", "castleTowns", "castleRuins",
-  "ports", "crossings", "passes", "modernCities", "satelliteCities", "stations",
-  "interchanges", "industrialZones", "logisticsParks", "newTowns", "adminCenters",
-  "externalGateways", "prefectureRegions",
-];
-
-const PATH_LAYER_KEYS = [
-  "premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "externalRoads",
-  "railways", "branchRailways", "ringRailways", "externalRailways", "expressways", "externalExpressways",
-  "icAccessRoads", "mainRivers", "tributaryRivers", "smallStreams", "riverPaths",
-];
-
-const ROAD_LAYER_KEYS = new Set(["premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "externalRoads", "expressways", "externalExpressways", "icAccessRoads"]);
-const RAIL_LAYER_KEYS = new Set(["railways", "branchRailways", "ringRailways", "externalRailways"]);
-const RIVER_LAYER_KEYS = new Set(["mainRivers", "tributaryRivers", "smallStreams", "riverPaths"]);
-
-const SEGMENT_LAYER_KEYS = ["adminBorders", "regionalPrefectureBorders", "prefectureBorder"];
-const PATCH_CANDIDATE_CACHE_LIMIT = 3;
-
-const ID_FIELD_OFFSETS = new Map([
-  ["adminId", 100000],
-  ["municipalityId", 100000],
-  ["prefectureRegionId", 200000],
-  ["regionId", 300000],
-  ["naturalCompartmentId", 400000],
-  ["watershedId", 500000],
-]);
-
-const DISCRETE_FIELD_NAMES = new Set([
-  "sea", "ocean", "lake", "prefectureMask", "landMask", "landuse",
-  "adminId", "municipalityId", "prefectureRegionId", "regionId", "naturalCompartmentId", "watershedId",
-]);
-
-
-const ADMIN_CONTINUITY_FIELD_NAMES = new Set(["adminId", "municipalityId", "prefectureRegionId"]);
-const NATURAL_CONTINUITY_FIELD_NAMES = new Set(["regionId", "naturalCompartmentId", "watershedId"]);
-const CONTINUITY_FIELD_NAMES = new Set([...ADMIN_CONTINUITY_FIELD_NAMES, ...NATURAL_CONTINUITY_FIELD_NAMES]);
-
-const SKIP_CELL_FIELDS = new Set(["flowTo", "prefectureMask", "humanRegionMask"]);
-
-function worldIndex(world, x, y) {
-  if (!world || x < 0 || y < 0 || x >= world.width || y >= world.height) return -1;
-  return y * world.width + x;
-}
-
-function sourceIndex(x, y) {
-  if (x < 0 || y < 0 || x >= MAP_W || y >= MAP_H) return -1;
-  return y * MAP_W + x;
-}
-
-function isCellField(value) {
-  return ArrayBuffer.isView(value) && typeof value.length === "number" && value.length === SIZE;
-}
-
-function rectWidth(rect) {
-  return Math.max(0, Math.floor(rect.x1) - Math.floor(rect.x0));
-}
-
-function rectHeight(rect) {
-  return Math.max(0, Math.floor(rect.y1) - Math.floor(rect.y0));
-}
-
-function rectArea(rect) {
-  return rectWidth(rect) * rectHeight(rect);
-}
-
-function nowMs() {
-  return typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
-}
-
-function createPatchTimer() {
-  const timings = [];
-  let mark = nowMs();
-  return {
-    timings,
-    mark(key, label = key) {
-      const t = nowMs();
-      timings.push({ key, label, ms: Math.round((t - mark) * 10) / 10 });
-      mark = t;
-    },
-  };
-}
-
-function normalizeRect(rect) {
-  if (!rect) return null;
-  const x0 = Math.floor(Math.min(rect.x0, rect.x1));
-  const y0 = Math.floor(Math.min(rect.y0, rect.y1));
-  const x1 = Math.ceil(Math.max(rect.x0, rect.x1));
-  const y1 = Math.ceil(Math.max(rect.y0, rect.y1));
-  return { x0, y0, x1, y1 };
-}
-
-function isPolygonSelection(input) {
-  return !!input && Array.isArray(input.polygon) && input.polygon.length >= 3;
-}
-
-function clampPointToWorld(point, world) {
-  return {
-    x: clamp(Math.round(point.x ?? 0), 0, Math.max(0, (world?.width || 1) - 1)),
-    y: clamp(Math.round(point.y ?? 0), 0, Math.max(0, (world?.height || 1) - 1)),
-  };
-}
-
-function polygonBounds(polygon) {
-  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
-  for (const p of polygon || []) {
-    if (!Number.isFinite(p?.x) || !Number.isFinite(p?.y)) continue;
-    minX = Math.min(minX, p.x);
-    minY = Math.min(minY, p.y);
-    maxX = Math.max(maxX, p.x);
-    maxY = Math.max(maxY, p.y);
-  }
-  if (!Number.isFinite(minX)) return null;
-  return { x0: Math.floor(minX), y0: Math.floor(minY), x1: Math.ceil(maxX + 1), y1: Math.ceil(maxY + 1) };
-}
-
-function polygonAreaCells(polygon) {
-  if (!polygon || polygon.length < 3) return 0;
-  let area = 0;
-  for (let i = 0; i < polygon.length; i++) {
-    const a = polygon[i];
-    const b = polygon[(i + 1) % polygon.length];
-    area += a.x * b.y - b.x * a.y;
-  }
-  return Math.abs(area) * 0.5;
-}
-
-function normalizeSelectionShape(input, world = null) {
-  if (!isPolygonSelection(input)) return normalizeRect(input);
-  const polygon = (input.polygon || []).map((p) => world ? clampPointToWorld(p, world) : { x: Math.round(p.x), y: Math.round(p.y) });
-  const bounds = polygonBounds(polygon);
-  if (!bounds) return null;
-  return {
-    kind: input.kind || 'lasso',
-    polygon,
-    areaCells: Math.max(1, Math.round(input.areaCells || polygonAreaCells(polygon))),
-    x0: bounds.x0,
-    y0: bounds.y0,
-    x1: bounds.x1,
-    y1: bounds.y1,
-  };
-}
-
-function pointInPolygon(px, py, polygon) {
-  let inside = false;
-  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
-    const xi = polygon[i].x + 0.5;
-    const yi = polygon[i].y + 0.5;
-    const xj = polygon[j].x + 0.5;
-    const yj = polygon[j].y + 0.5;
-    const intersect = ((yi > py) !== (yj > py)) && (px < ((xj - xi) * (py - yi)) / Math.max(1e-6, (yj - yi)) + xi);
-    if (intersect) inside = !inside;
-  }
-  return inside;
-}
-
-function pointSegmentDistance(px, py, ax, ay, bx, by) {
-  const dx = bx - ax;
-  const dy = by - ay;
-  const len2 = dx * dx + dy * dy;
-  if (len2 <= 1e-6) return Math.hypot(px - ax, py - ay);
-  const t = clamp(((px - ax) * dx + (py - ay) * dy) / len2, 0, 1);
-  return Math.hypot(px - (ax + dx * t), py - (ay + dy * t));
-}
-
-function distanceToPolygonEdge(px, py, polygon) {
-  let best = Infinity;
-  for (let i = 0; i < polygon.length; i++) {
-    const a = polygon[i];
-    const b = polygon[(i + 1) % polygon.length];
-    best = Math.min(best, pointSegmentDistance(px, py, a.x + 0.5, a.y + 0.5, b.x + 0.5, b.y + 0.5));
-  }
-  return best;
-}
-
-function insideRect(x, y, rect) {
-  return !!rect && x >= rect.x0 && y >= rect.y0 && x < rect.x1 && y < rect.y1;
-}
-
-function expandRect(rect, margin, world = null) {
-  return {
-    x0: Math.max(0, rect.x0 - margin),
-    y0: Math.max(0, rect.y0 - margin),
-    x1: Math.min(world?.width ?? Infinity, rect.x1 + margin),
-    y1: Math.min(world?.height ?? Infinity, rect.y1 + margin),
-  };
-}
-
-function distanceToRectEdge(x, y, rect) {
-  return Math.min(x - rect.x0, y - rect.y0, rect.x1 - 1 - x, rect.y1 - 1 - y);
-}
-
-function defaultForField(name, Constructor) {
-  if (name === "sea" || name === "ocean") return 1;
-  if (name === "elevation") return 0.08;
-  if (ID_FIELD_OFFSETS.has(name)) return -1;
-  if (Constructor === Float32Array || Constructor === Float64Array) return 0;
-  return 0;
-}
-
-function ensureWorldField(world, name, source) {
-  if (!source || !isCellField(source)) return null;
-  const Constructor = source.constructor;
-  const expected = world.width * world.height;
-  if (!world.fields[name] || world.fields[name].length !== expected) {
-    world.fields[name] = new Constructor(expected);
-    const fallback = defaultForField(name, Constructor);
-    if (fallback !== 0) world.fields[name].fill(fallback);
-  }
-  return world.fields[name];
-}
-
-export function clipPatchRect(rect, world) {
-  const normalized = normalizeSelectionShape(rect, world);
-  if (!normalized || !world) return null;
-  if (isPolygonSelection(normalized)) return normalized;
-  return {
-    x0: Math.min(Math.max(normalized.x0, 0), world.width),
-    y0: Math.min(Math.max(normalized.y0, 0), world.height),
-    x1: Math.min(Math.max(normalized.x1, 0), world.width),
-    y1: Math.min(Math.max(normalized.y1, 0), world.height),
-  };
-}
-
-export function validatePatchRect(rect, world) {
-  const clipped = clipPatchRect(rect, world);
-  if (!clipped) return { ok: false, rect: null, reason: "No selected area." };
-  const width = rectWidth(clipped);
-  const height = rectHeight(clipped);
-  const area = isPolygonSelection(clipped) ? Math.max(1, Math.round(clipped.areaCells || polygonAreaCells(clipped.polygon))) : width * height;
-  if (width < PATCH_MIN_WIDTH || height < PATCH_MIN_HEIGHT) {
-    const parts = [];
-    if (width < PATCH_MIN_WIDTH) parts.push(`minimum width ${PATCH_MIN_WIDTH} cells`);
-    if (height < PATCH_MIN_HEIGHT) parts.push(`minimum height ${PATCH_MIN_HEIGHT} cells`);
-    return {
-      ok: false,
-      rect: clipped,
-      width,
-      height,
-      area,
-      reason: `Selection is too small: ${parts.join(", ")} required. Current ${width} x ${height} cells, ${area.toLocaleString()} cells total.`,
-    };
-  }
-  if (area < PATCH_MIN_AREA) {
-    return {
-      ok: false,
-      rect: clipped,
-      width,
-      height,
-      area,
-      reason: `Selection area is too small: minimum area ${PATCH_MIN_AREA.toLocaleString()} cells required. Current ${area.toLocaleString()} cells.`,
-    };
-  }
-  return { ok: true, rect: clipped, width, height, area, reason: "" };
-}
-
-export function buildPatchRects(userRect, world = null) {
-  const coreRect = normalizeSelectionShape(userRect, world);
-  const width = rectWidth(coreRect);
-  const height = rectHeight(coreRect);
-  const shortSide = Math.max(1, Math.min(width, height));
-  const desiredWrite = Math.min(96, Math.max(28, Math.floor(shortSide * 0.42)));
-  const maxBySource = Math.max(0, Math.floor(Math.min((MAP_W - width) / 2, (MAP_H - height) / 2)));
-  const writeMargin = Math.max(0, Math.min(desiredWrite, maxBySource));
-  const desiredRepair = Math.min(120, writeMargin + Math.max(8, Math.floor(shortSide * 0.12)));
-  const repairMargin = Math.max(writeMargin, Math.min(desiredRepair, maxBySource));
-  const writeRect = expandRect(coreRect, writeMargin, world);
-  const repairRect = expandRect(coreRect, repairMargin, world);
-  const transportReachMargin = Math.max(
-    repairMargin + 48,
-    Math.min(260, Math.max(96, repairMargin + Math.floor(shortSide * 1.15)))
-  );
-  const transportReachRect = expandRect(coreRect, transportReachMargin, world);
-  return {
-    coreRect,
-    writeRect,
-    repairRect,
-    contextRect: repairRect,
-    transportReachRect,
-    blendRect: coreRect,
-    userRect: writeRect,
-    selectedRect: coreRect,
-    selectionShape: isPolygonSelection(coreRect) ? coreRect : null,
-    writeMargin,
-    repairMargin,
-    transportReachMargin,
-    outerMargin: writeMargin,
-    innerMargin: 0,
-  };
-}
-
-function computePatchAlpha(x, y, rects, seed = 0) {
-  const writeRect = rects.writeRect || rects.userRect;
-  if (!insideRect(x, y, writeRect)) return 0;
-  const margin = Math.max(1, rects.writeMargin || 1);
-  const low = valueNoise(x, y, seed ^ 0x7153a9d1, 18) - 0.5;
-  const mid = valueNoise(x, y, seed ^ 0x9e3779b9, 7) - 0.5;
-  const shape = rects.selectionShape;
-  if (shape?.polygon?.length >= 3) {
-    const px = x + 0.5;
-    const py = y + 0.5;
-    const inside = pointInPolygon(px, py, shape.polygon);
-    const dist = distanceToPolygonEdge(px, py, shape.polygon);
-    const signedDist = inside ? dist : -dist;
-    const noisySigned = signedDist + low * margin * 0.28 + mid * margin * 0.10;
-    return clamp(smoothstep((noisySigned + margin) / Math.max(1e-6, margin * 2)));
-  }
-  const edge = distanceToRectEdge(x, y, writeRect);
-  const noisyEdge = edge + low * margin * 0.42 + mid * margin * 0.16;
-  const base = smoothstep(clamp(noisyEdge / margin));
-  // Keep the expanded repair band as the actual seam.  The user's selected core
-  // is still dominant, but the write edge is irregular, so coastlines and land-use
-  // no longer inherit the rectangular user selection as a hard boundary.
-  return clamp(base);
-}
-
-function getPatchAlphaCache(rects, seed = 0) {
-  const writeRect = rects?.writeRect || rects?.userRect;
-  if (!writeRect) return null;
-  const width = rectWidth(writeRect);
-  const height = rectHeight(writeRect);
-  const existing = rects.patchAlphaCache;
-  if (
-    existing
-    && existing.seed === seed
-    && existing.width === width
-    && existing.height === height
-    && existing.x0 === writeRect.x0
-    && existing.y0 === writeRect.y0
-  ) return existing;
-
-  const data = new Float32Array(width * height);
-  for (let y = 0; y < height; y++) {
-    for (let x = 0; x < width; x++) {
-      data[y * width + x] = computePatchAlpha(writeRect.x0 + x, writeRect.y0 + y, rects, seed);
-    }
-  }
-  rects.patchAlphaCache = { seed, width, height, x0: writeRect.x0, y0: writeRect.y0, data };
-  return rects.patchAlphaCache;
-}
-
-function patchAlpha(x, y, rects, seed = 0) {
-  const writeRect = rects?.writeRect || rects?.userRect;
-  if (!writeRect || !insideRect(x, y, writeRect)) return 0;
-  const cache = rects.patchAlphaCache;
-  if (
-    cache
-    && cache.seed === seed
-    && x >= cache.x0
-    && y >= cache.y0
-    && x < cache.x0 + cache.width
-    && y < cache.y0 + cache.height
-  ) return cache.data[(y - cache.y0) * cache.width + (x - cache.x0)] || 0;
-  return computePatchAlpha(x, y, rects, seed);
-}
-
-function patchBand(x, y, rects, seed = 0) {
-  const a = patchAlpha(x, y, rects, seed);
-  if (a <= 0.18) return "preserve";
-  if (a >= 0.82) return "core";
-  return "feather";
-}
-
-function continuityReplaceThreshold(name, x, y, rects, seed = 0) {
-  const n = valueNoise(x, y, seed ^ 0x4f1bbcdc, 11) - 0.5;
-  if (ADMIN_CONTINUITY_FIELD_NAMES.has(name)) return clamp(0.82 + n * 0.12, 0.70, 0.92);
-  if (NATURAL_CONTINUITY_FIELD_NAMES.has(name)) return clamp(0.68 + n * 0.16, 0.54, 0.82);
-  return clamp(0.46 + n * 0.20, 0.28, 0.68);
-}
-
-function continuitySegmentAllowed(x, y, nx, ny, rects, seed, minAlpha = 0.42) {
-  if (!rects) return true;
-  return Math.min(patchAlpha(x, y, rects, seed), patchAlpha(nx, ny, rects, seed)) >= minAlpha;
-}
-
-function patchAffected(x, y, rects, seed = 0, minAlpha = 0.34) {
-  return insideRect(Math.round(x), Math.round(y), rects?.writeRect) && patchAlpha(Math.round(x), Math.round(y), rects, seed) >= minAlpha;
-}
-
-function segmentTouchesPatch(world, seg, rects, seed = 0, minAlpha = 0.34) {
-  if (!Array.isArray(seg) || seg.length < 2) return false;
-  const ax = tupleWorldX(world, seg[0]);
-  const ay = tupleWorldY(world, seg[0]);
-  const bx = tupleWorldX(world, seg[1]);
-  const by = tupleWorldY(world, seg[1]);
-  const mx = (ax + bx) * 0.5;
-  const my = (ay + by) * 0.5;
-  return patchAffected(ax, ay, rects, seed, minAlpha) || patchAffected(bx, by, rects, seed, minAlpha) || patchAffected(mx, my, rects, seed, minAlpha);
-}
-
-
-function sourceWindowForRects(rects) {
-  const cx = (rects.coreRect.x0 + rects.coreRect.x1 - 1) / 2;
-  const cy = (rects.coreRect.y0 + rects.coreRect.y1 - 1) / 2;
-  return {
-    worldCenterX: cx,
-    worldCenterY: cy,
-    sourceCenterX: (MAP_W - 1) / 2,
-    sourceCenterY: (MAP_H - 1) / 2,
-  };
-}
-
-function sourceCoordForWorld(window, x, y) {
-  return {
-    x: Math.round(x - window.worldCenterX + window.sourceCenterX),
-    y: Math.round(y - window.worldCenterY + window.sourceCenterY),
-  };
-}
-
-function getPatchSourceIndexCache(rects, window) {
-  const writeRect = rects?.writeRect;
-  if (!writeRect || !window) return null;
-  const width = rectWidth(writeRect);
-  const height = rectHeight(writeRect);
-  const existing = rects.patchSourceIndexCache;
-  if (
-    existing
-    && existing.width === width
-    && existing.height === height
-    && existing.x0 === writeRect.x0
-    && existing.y0 === writeRect.y0
-    && existing.worldCenterX === window.worldCenterX
-    && existing.worldCenterY === window.worldCenterY
-    && existing.sourceCenterX === window.sourceCenterX
-    && existing.sourceCenterY === window.sourceCenterY
-  ) return existing;
-
-  const data = new Int32Array(width * height);
-  for (let y = 0; y < height; y++) {
-    for (let x = 0; x < width; x++) {
-      const sx = Math.round(writeRect.x0 + x - window.worldCenterX + window.sourceCenterX);
-      const sy = Math.round(writeRect.y0 + y - window.worldCenterY + window.sourceCenterY);
-      data[y * width + x] = sourceIndex(sx, sy);
-    }
-  }
-  rects.patchSourceIndexCache = {
-    width,
-    height,
-    x0: writeRect.x0,
-    y0: writeRect.y0,
-    worldCenterX: window.worldCenterX,
-    worldCenterY: window.worldCenterY,
-    sourceCenterX: window.sourceCenterX,
-    sourceCenterY: window.sourceCenterY,
-    data,
-  };
-  return rects.patchSourceIndexCache;
-}
-
-function sourceIndexForWorld(rects, window, x, y) {
-  const cache = rects?.patchSourceIndexCache;
-  if (
-    cache
-    && x >= cache.x0
-    && y >= cache.y0
-    && x < cache.x0 + cache.width
-    && y < cache.y0 + cache.height
-  ) return cache.data[(y - cache.y0) * cache.width + (x - cache.x0)];
-  const s = sourceCoordForWorld(window, x, y);
-  return sourceIndex(s.x, s.y);
-}
-
-function worldCoordForSource(window, sx, sy) {
-  return {
-    x: Math.round(sx - window.sourceCenterX + window.worldCenterX),
-    y: Math.round(sy - window.sourceCenterY + window.worldCenterY),
-  };
-}
-
-function fieldIdOffset(name, seed) {
-  const base = ID_FIELD_OFFSETS.get(name) || 0;
-  if (!base) return 0;
-  return base + ((seed >>> 0) % 997) * 10000;
-}
-
-function maxFieldId(field) {
-  if (!field) return -1;
-  let max = -1;
-  for (let i = 0; i < field.length; i++) {
-    const id = field[i];
-    if (Number.isFinite(id) && id > max) max = id;
-  }
-  return max;
-}
-
-function addMappingVote(votes, from, to, weight = 1) {
-  if (!Number.isFinite(from) || from < 0 || !Number.isFinite(to) || to < 0) return;
-  const key = Math.floor(from);
-  const target = Math.floor(to);
-  const bucket = votes.get(key) || new Map();
-  bucket.set(target, (bucket.get(target) || 0) + Math.max(1, weight));
-  votes.set(key, bucket);
-}
-
-function chooseVotedTarget(bucket, minVotes = 1) {
-  let best = -1;
-  let bestVotes = 0;
-  for (const [target, count] of bucket || []) {
-    if (count > bestVotes || (count === bestVotes && target < best)) {
-      best = target;
-      bestVotes = count;
-    }
-  }
-  return best >= 0 && bestVotes >= minVotes ? best : -1;
-}
-
-function collectCandidateIdsInRect(candidateField, rects, window, minAlpha = 0.20, seed = 0) {
-  const ids = new Set();
-  if (!candidateField) return ids;
-  const rect = rects.writeRect;
-  for (let y = rect.y0; y < rect.y1; y++) {
-    for (let x = rect.x0; x < rect.x1; x++) {
-      if (patchAlpha(x, y, rects, seed) < minAlpha) continue;
-      const si = sourceIndexForWorld(rects, window, x, y);
-      if (si < 0) continue;
-      const id = candidateField[si];
-      if (Number.isFinite(id) && id >= 0) ids.add(Math.floor(id));
-    }
-  }
-  return ids;
-}
-
-function buildCandidatePrefByAdmin(candidateMap, candidateAdminIds) {
-  const out = new Map();
-  const direct = candidateMap?.municipalityToPrefectureId;
-  for (const id of candidateAdminIds || []) {
-    const pref = direct?.[id];
-    if (Number.isFinite(pref) && pref >= 0) out.set(id, Math.floor(pref));
-  }
-  const adminField = candidateMap?.adminId || candidateMap?.municipalityId;
-  const prefField = candidateMap?.prefectureRegionId;
-  if (!adminField || !prefField) return out;
-  const votes = new Map();
-  for (let i = 0; i < adminField.length; i++) {
-    const admin = adminField[i];
-    const pref = prefField[i];
-    if (!Number.isFinite(admin) || admin < 0 || !Number.isFinite(pref) || pref < 0) continue;
-    if (candidateAdminIds?.size && !candidateAdminIds.has(Math.floor(admin))) continue;
-    addMappingVote(votes, admin, pref, 1);
-  }
-  for (const [admin, bucket] of votes) {
-    if (!out.has(admin)) {
-      const pref = chooseVotedTarget(bucket, 1);
-      if (pref >= 0) out.set(admin, pref);
-    }
-  }
-  return out;
-}
-
-export function buildAdminIdMapping({ candidateMap, world, writeRect, seamBand = 24, window = null, rects = null, seed = 0 } = {}) {
-  const actualWindow = window || (rects ? sourceWindowForRects(rects) : null);
-  const actualRects = rects || { writeRect, writeMargin: seamBand || 1 };
-  if (!candidateMap || !world || !writeRect || !actualWindow) {
-    return {
-      prefecture: new Map(),
-      municipality: new Map(),
-      admin: new Map(),
-      candidateAdminToPrefecture: new Map(),
-      debug: { prefecturesMappedToExisting: 0, prefecturesAllocated: 0, municipalitiesMappedToExisting: 0, municipalitiesAllocated: 0 },
-    };
-  }
-
-  const candidateAdmin = candidateMap.adminId || candidateMap.municipalityId;
-  const candidateMunicipality = candidateMap.municipalityId || candidateAdmin;
-  const candidatePrefecture = candidateMap.prefectureRegionId;
-  const worldAdmin = world.fields?.adminId || world.fields?.municipalityId;
-  const worldMunicipality = world.fields?.municipalityId || worldAdmin;
-  const worldPrefecture = world.fields?.prefectureRegionId;
-
-  const candidateAdminIds = collectCandidateIdsInRect(candidateAdmin, actualRects, actualWindow, 0.18, seed);
-  const candidateMunicipalityIds = collectCandidateIdsInRect(candidateMunicipality, actualRects, actualWindow, 0.18, seed);
-  const candidatePrefectureIds = collectCandidateIdsInRect(candidatePrefecture, actualRects, actualWindow, 0.18, seed);
-  const candidateAdminToPrefecture = buildCandidatePrefByAdmin(candidateMap, candidateAdminIds);
-
-  const adminVotes = new Map();
-  const municipalityVotes = new Map();
-  const prefectureVotes = new Map();
-  const band = Math.max(2, Math.floor(seamBand));
-  const dirs = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
-
-  for (let y = writeRect.y0; y < writeRect.y1; y++) {
-    for (let x = writeRect.x0; x < writeRect.x1; x++) {
-      const edge = distanceToRectEdge(x, y, writeRect);
-      if (edge > band) continue;
-      const s = sourceCoordForWorld(actualWindow, x, y);
-      const si = sourceIndex(s.x, s.y);
-      const wi = worldIndex(world, x, y);
-      if (si < 0 || wi < 0) continue;
-      const cAdmin = candidateAdmin?.[si] ?? -1;
-      const cMunicipality = candidateMunicipality?.[si] ?? cAdmin;
-      const cPrefecture = candidatePrefecture?.[si] ?? -1;
-      const sameCellWeight = Math.max(1, band + 1 - edge);
-      addMappingVote(adminVotes, cAdmin, worldAdmin?.[wi] ?? -1, sameCellWeight);
-      addMappingVote(municipalityVotes, cMunicipality, worldMunicipality?.[wi] ?? worldAdmin?.[wi] ?? -1, sameCellWeight);
-      addMappingVote(prefectureVotes, cPrefecture, worldPrefecture?.[wi] ?? -1, sameCellWeight);
-
-      for (const [dx, dy] of dirs) {
-        for (let step = 1; step <= 6; step++) {
-          const nx = x + dx * step;
-          const ny = y + dy * step;
-          if (insideRect(nx, ny, writeRect)) continue;
-          const ni = worldIndex(world, nx, ny);
-          if (ni < 0) break;
-          const w = Math.max(1, 7 - step) + Math.max(0, band - edge) * 0.25;
-          addMappingVote(adminVotes, cAdmin, worldAdmin?.[ni] ?? -1, w);
-          addMappingVote(municipalityVotes, cMunicipality, worldMunicipality?.[ni] ?? worldAdmin?.[ni] ?? -1, w);
-          addMappingVote(prefectureVotes, cPrefecture, worldPrefecture?.[ni] ?? -1, w);
-          break;
-        }
-      }
-    }
-  }
-
-  const prefecture = new Map();
-  let nextPrefectureId = maxFieldId(worldPrefecture) + 1;
-  let prefecturesMappedToExisting = 0;
-  let prefecturesAllocated = 0;
-  for (const id of [...candidatePrefectureIds].sort((a, b) => a - b)) {
-    const voted = chooseVotedTarget(prefectureVotes.get(id), 3);
-    if (voted >= 0) {
-      prefecture.set(id, voted);
-      prefecturesMappedToExisting++;
-    } else {
-      prefecture.set(id, nextPrefectureId++);
-      prefecturesAllocated++;
-    }
-  }
-
-  const usedAdminIds = new Set();
-  if (worldAdmin) {
-    for (let i = 0; i < worldAdmin.length; i++) if (worldAdmin[i] >= 0) usedAdminIds.add(worldAdmin[i]);
-  }
-  const municipality = new Map();
-  const admin = new Map();
-  let nextMunicipalityId = maxFieldId(worldAdmin || worldMunicipality) + 1;
-  let municipalitiesMappedToExisting = 0;
-  let municipalitiesAllocated = 0;
-  const allMunicipalityIds = new Set([...candidateAdminIds, ...candidateMunicipalityIds]);
-  for (const id of [...allMunicipalityIds].sort((a, b) => a - b)) {
-    const voted = chooseVotedTarget(municipalityVotes.get(id) || adminVotes.get(id), 4);
-    if (voted >= 0) {
-      municipality.set(id, voted);
-      admin.set(id, voted);
-      municipalitiesMappedToExisting++;
-    } else {
-      while (usedAdminIds.has(nextMunicipalityId)) nextMunicipalityId++;
-      municipality.set(id, nextMunicipalityId);
-      admin.set(id, nextMunicipalityId);
-      usedAdminIds.add(nextMunicipalityId);
-      nextMunicipalityId++;
-      municipalitiesAllocated++;
-    }
-  }
-
-  const municipalityToPrefecture = new Map();
-  for (const [candidateAdminId, worldAdminId] of admin) {
-    const candidatePrefId = candidateAdminToPrefecture.get(candidateAdminId);
-    const worldPrefId = prefecture.get(candidatePrefId);
-    if (Number.isFinite(worldAdminId) && Number.isFinite(worldPrefId)) municipalityToPrefecture.set(worldAdminId, worldPrefId);
-  }
-
-  return {
-    prefecture,
-    municipality,
-    admin,
-    candidateAdminToPrefecture,
-    municipalityToPrefecture,
-    debug: {
-      candidatePrefectureIds: candidatePrefectureIds.size,
-      candidateMunicipalityIds: allMunicipalityIds.size,
-      prefecturesMappedToExisting,
-      prefecturesAllocated,
-      municipalitiesMappedToExisting,
-      municipalitiesAllocated,
-    },
-  };
-}
-
-function remapAdminCandidateValue(name, raw, adminIdMapping) {
-  if (!Number.isFinite(raw) || raw < 0 || !adminIdMapping) return raw;
-  const id = Math.floor(raw);
-  if (name === "prefectureRegionId") return adminIdMapping.prefecture?.get(id) ?? raw;
-  if (name === "adminId") return adminIdMapping.admin?.get(id) ?? raw;
-  if (name === "municipalityId") return adminIdMapping.municipality?.get(id) ?? adminIdMapping.admin?.get(id) ?? raw;
-  return raw;
-}
-
-function numericFeatureId(point, keys) {
-  for (const key of keys) {
-    const value = point?.[key];
-    if (Number.isFinite(value) && value >= 0) return Math.floor(value);
-  }
-  return -1;
-}
-
-function summarizeIdMapping(mapping) {
-  return { ...(mapping?.debug || {}) };
-}
-
-function updateSourceAdminMetadata(sourceMap, adminIdMapping) {
-  if (!sourceMap || !adminIdMapping?.municipalityToPrefecture?.size) return 0;
-  let maxId = -1;
-  const current = sourceMap.municipalityToPrefectureId;
-  if (current && typeof current.length === "number") maxId = Math.max(maxId, current.length - 1);
-  for (const [adminId] of adminIdMapping.municipalityToPrefecture) maxId = Math.max(maxId, adminId);
-  const next = new Int32Array(Math.max(0, maxId + 1));
-  next.fill(-1);
-  if (current && typeof current.length === "number") {
-    for (let i = 0; i < current.length && i < next.length; i++) next[i] = current[i] ?? -1;
-  }
-  let updated = 0;
-  for (const [adminId, prefId] of adminIdMapping.municipalityToPrefecture) {
-    if (!Number.isFinite(adminId) || adminId < 0 || !Number.isFinite(prefId) || prefId < 0) continue;
-    if (next[adminId] !== prefId) updated++;
-    next[adminId] = prefId;
-  }
-  sourceMap.municipalityToPrefectureId = next;
-  sourceMap.patchAdminIdMappingDebug = summarizeIdMapping(adminIdMapping);
-  return updated;
-}
-
-function cloneContinuityFields(world) {
-  const out = new Map();
-  for (const name of CONTINUITY_FIELD_NAMES) {
-    const field = world?.fields?.[name];
-    if (ArrayBuffer.isView(field)) out.set(name, new field.constructor(field));
-  }
-  return out;
-}
-
-function stabilizeContinuitySeam(world, rects, oldFields, seed = 0) {
-  let restored = 0;
-  let remapped = 0;
-  const margin = Math.max(2, rects.writeMargin || 1);
-  for (const name of CONTINUITY_FIELD_NAMES) {
-    const field = world.fields?.[name];
-    const old = oldFields?.get(name);
-    if (!field || !old) continue;
-    const isPrefecture = name === "prefectureRegionId";
-    const isAdmin = name === "adminId" || name === "municipalityId";
-    const preserveAlpha = isPrefecture ? 0.94 : isAdmin ? 0.90 : 0.74;
-    const preserveEdge = isPrefecture ? margin * 1.25 : isAdmin ? margin : margin * 0.72;
-
-    // First preserve the old IDs in the transition band.  This prevents the
-    // writeRect edge from becoming a prefecture/municipal border.
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const i = worldIndex(world, x, y);
-        if (i < 0 || old[i] < 0) continue;
-        const edge = distanceToRectEdge(x, y, rects.writeRect);
-        const a = patchAlpha(x, y, rects, seed);
-        if (edge <= preserveEdge || a < preserveAlpha) {
-          if (field[i] !== old[i]) { field[i] = old[i]; restored++; }
-        }
-      }
-    }
-
-    // Then map candidate IDs that contact an outside ID back to that outside ID.
-    // This lets prefectures/municipalities cross the generated-area seam instead
-    // of creating a new border exactly on the seam.
-    const contacts = new Map();
-    const dirs = [[1,0],[-1,0],[0,1],[0,-1]];
-    for (let y = rects.writeRect.y0 + 1; y < rects.writeRect.y1 - 1; y++) {
-      for (let x = rects.writeRect.x0 + 1; x < rects.writeRect.x1 - 1; x++) {
-        const i = worldIndex(world, x, y);
-        if (i < 0 || field[i] < 0 || old[i] === field[i]) continue;
-        const a = patchAlpha(x, y, rects, seed);
-        if (a < 0.98 && !isPrefecture) continue;
-        for (const [dx, dy] of dirs) {
-          const ni = worldIndex(world, x + dx, y + dy);
-          if (ni < 0 || old[ni] < 0 || old[ni] === field[i]) continue;
-          if (field[ni] === old[ni] || patchAlpha(x + dx, y + dy, rects, seed) < preserveAlpha) {
-            const key = field[i];
-            const bucket = contacts.get(key) || new Map();
-            bucket.set(old[ni], (bucket.get(old[ni]) || 0) + 1);
-            contacts.set(key, bucket);
-          }
-        }
-      }
-    }
-    const mapping = new Map();
-    for (const [from, bucket] of contacts) {
-      let best = -1, bestCount = 0;
-      for (const [to, count] of bucket) if (count > bestCount) { best = to; bestCount = count; }
-      if (best >= 0 && bestCount >= (isPrefecture ? 2 : 3)) mapping.set(from, best);
-    }
-    if (mapping.size) {
-      for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-        for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-          const i = worldIndex(world, x, y);
-          if (i >= 0 && mapping.has(field[i])) { field[i] = mapping.get(field[i]); remapped++; }
-        }
-      }
-    }
-  }
-  return { continuityCellsRestored: restored, continuityCellsRemapped: remapped };
-}
-
-function chooseSeamOwnerValue(world, fieldName, oldField, candidateValue, x, y, rects, seed) {
-  const a = patchAlpha(x, y, rects, seed);
-  const i = worldIndex(world, x, y);
-  const oldValue = oldField?.[i] ?? -1;
-  if (oldValue < 0 || candidateValue < 0) return candidateValue >= 0 ? candidateValue : oldValue;
-  if (a <= 0.24) return oldValue;
-  if (a >= 0.82) return candidateValue;
-
-  const field = world.fields?.[fieldName];
-  const pref = world.fields?.prefectureRegionId;
-  const naturalBarrier = world.fields?.naturalBarrierScore || world.fields?.ridgeField;
-  let oldScore = (1 - a) * 3.0;
-  let candidateScore = a * 3.0;
-  for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
-    const ni = worldIndex(world, x + dx, y + dy);
-    if (ni < 0) continue;
-    const neighbor = field?.[ni] ?? -1;
-    if (neighbor === oldValue) oldScore += 1.2;
-    if (neighbor === candidateValue) candidateScore += 1.2;
-    if (fieldName !== "prefectureRegionId" && pref && pref[ni] >= 0) {
-      if (pref[ni] === pref[i] && candidateValue !== oldValue) oldScore += 0.18;
-    }
-  }
-  const barrierBonus = naturalBarrier?.[i] || 0;
-  if (barrierBonus > 0.48 && Math.abs(a - 0.5) < 0.24) {
-    if (a < 0.5) oldScore += barrierBonus * 0.9;
-    else candidateScore += barrierBonus * 0.9;
-  }
-  return candidateScore > oldScore ? candidateValue : oldValue;
-}
-
-function repairDiscreteSeamOwnership(world, rects, oldFields, seed = 0) {
-  let adminSeamCellsResolved = 0;
-  let prefectureSeamCellsResolved = 0;
-  for (const name of ["prefectureRegionId", "adminId", "municipalityId"]) {
-    const field = world.fields?.[name];
-    const old = oldFields?.get(name);
-    if (!field || !old) continue;
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const i = worldIndex(world, x, y);
-        if (i < 0 || world.fields.sea?.[i]) continue;
-        if (patchBand(x, y, rects, seed) !== "feather") continue;
-        const before = field[i];
-        const next = chooseSeamOwnerValue(world, name, old, before, x, y, rects, seed);
-        if (next !== before) {
-          field[i] = next;
-          if (name === "prefectureRegionId") prefectureSeamCellsResolved++;
-          else adminSeamCellsResolved++;
-        }
-      }
-    }
-  }
-  if (world.fields.adminId && world.fields.municipalityId) {
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const i = worldIndex(world, x, y);
-        if (i >= 0 && !world.fields.sea?.[i]) world.fields.municipalityId[i] = world.fields.adminId[i];
-      }
-    }
-  }
-  return { adminSeamCellsResolved, prefectureSeamCellsResolved };
-}
-
-function copyFullPipelineFields(world, candidate, rects, seed) {
-  const window = sourceWindowForRects(rects);
-  const oldSea = world.fields.sea ? new Uint8Array(world.fields.sea) : null;
-  const oldContinuityFields = cloneContinuityFields(world);
-  const adminIdMapping = buildAdminIdMapping({
-    candidateMap: candidate,
-    world,
-    writeRect: rects.writeRect,
-    seamBand: Math.max(8, Math.floor(rects.writeMargin || 24)),
-    window,
-    rects,
-    seed,
-  });
-  let updatedCells = 0;
-  let coastCellsChanged = 0;
-  let terrainCellsFullyReplaced = 0;
-  let naturalRegionsUpdated = 0;
-  let adminCellsReassigned = 0;
-  let landUseCellsUpdated = 0;
-
-  for (const [name, source] of Object.entries(candidate || {})) {
-    if (SKIP_CELL_FIELDS.has(name) || !isCellField(source)) continue;
-    const dest = ensureWorldField(world, name, source);
-    if (!dest) continue;
-    const isFloat = source.constructor === Float32Array || source.constructor === Float64Array;
-    const isDiscrete = DISCRETE_FIELD_NAMES.has(name) || !isFloat;
-    const idOffset = fieldIdOffset(name, seed);
-
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const wi = worldIndex(world, x, y);
-        if (wi < 0) continue;
-        const si = sourceIndexForWorld(rects, window, x, y);
-        if (si < 0) continue;
-        const alpha = patchAlpha(x, y, rects, seed);
-        if (alpha <= 0.005) continue;
-
-        if (isDiscrete) {
-          const threshold = continuityReplaceThreshold(name, x, y, rects, seed);
-          if (alpha >= threshold) {
-            const raw = source[si];
-            const mapped = remapAdminCandidateValue(name, raw, adminIdMapping);
-            const value = (name === "adminId" || name === "municipalityId" || name === "prefectureRegionId")
-              ? mapped
-              : idOffset && raw >= 0 ? raw + idOffset : raw;
-            if (name === "sea" && oldSea && dest[wi] !== value) coastCellsChanged++;
-            if ((name === "naturalCompartmentId" || name === "watershedId" || name === "regionId") && dest[wi] !== value) naturalRegionsUpdated++;
-            if ((name === "adminId" || name === "municipalityId") && dest[wi] !== value) adminCellsReassigned++;
-            if (name === "landuse" && dest[wi] !== value) landUseCellsUpdated++;
-            dest[wi] = value;
-          }
-        } else {
-          const before = dest[wi] || 0;
-          dest[wi] = lerp(before, source[si] || 0, alpha);
-        }
-
-        if (name === "elevation") {
-          updatedCells++;
-          if (alpha > 0.94) terrainCellsFullyReplaced++;
-        }
-      }
-    }
-  }
-
-  // The legacy full pipeline uses `adminId` as the municipality raster and
-  // assigns municipality metadata on `adminCenters`; it does not expose a
-  // separate municipalityId cell field.  If an old experimental field exists,
-  // keep it synchronized with the canonical legacy adminId instead of leaving
-  // stale numeric/one-municipality data in regenerated patches.
-  if (world.fields.adminId && !candidate?.municipalityId) {
-    const expected = world.width * world.height;
-    if (!world.fields.municipalityId || world.fields.municipalityId.length !== expected) {
-      world.fields.municipalityId = new Int32Array(expected);
-      world.fields.municipalityId.fill(-1);
-    }
-    const municipalityId = world.fields.municipalityId;
-    const adminId = world.fields.adminId;
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const wi = worldIndex(world, x, y);
-        if (wi >= 0) municipalityId[wi] = adminId[wi];
-      }
-    }
-  }
-
-  // Keep water fields coherent after all continuous fields have been blended.
-  const sea = world.fields.sea;
-  const ocean = world.fields.ocean;
-  const lake = world.fields.lake;
-  const landuse = world.fields.landuse;
-  if (sea) {
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const i = worldIndex(world, x, y);
-        if (i < 0) continue;
-        if (sea[i]) {
-          if (ocean) ocean[i] = 1;
-          if (lake) lake[i] = 0;
-          if (landuse) landuse[i] = LANDUSE.WATER || 0;
-        } else {
-          if (ocean) ocean[i] = 0;
-          if (lake) lake[i] = 0;
-        }
-      }
-    }
-  }
-
-  const continuityDebug = stabilizeContinuitySeam(world, rects, oldContinuityFields, seed);
-  const seamOwnershipDebug = repairDiscreteSeamOwnership(world, rects, oldContinuityFields, seed);
-  if (world.fields.adminId && world.fields.municipalityId && !candidate?.municipalityId) {
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const wi = worldIndex(world, x, y);
-        if (wi >= 0) world.fields.municipalityId[wi] = world.fields.adminId[wi];
-      }
-    }
-  }
-
-  return {
-    window,
-    updatedCells,
-    terrainCellsFullyReplaced,
-    coastCellsChanged,
-    naturalRegionsUpdated,
-    adminCellsReassigned,
-    landUseCellsUpdated,
-    adminIdMapping,
-    adminIdMappingDebug: summarizeIdMapping(adminIdMapping),
-    ...continuityDebug,
-    ...seamOwnershipDebug,
-  };
-}
-
-
-function repairDisplayMasks(world, rects, seed = 0) {
-  const expected = world.width * world.height;
-  if (!world.fields.prefectureMask || world.fields.prefectureMask.length !== expected) world.fields.prefectureMask = new Uint8Array(expected);
-  if (!world.fields.landMask || world.fields.landMask.length !== expected) world.fields.landMask = new Uint8Array(expected);
-  if (!world.fields.humanRegionMask || world.fields.humanRegionMask.length !== expected) world.fields.humanRegionMask = new Uint8Array(expected);
-  const coverage = world.fields.prefectureMask;
-  const landMask = world.fields.landMask;
-  const humanMask = world.fields.humanRegionMask;
-  const sea = world.fields.sea;
-  let displayMaskUpdated = 0;
-  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i < 0) continue;
-      const a = patchAlpha(x, y, rects, seed);
-      if (a <= 0.08) continue;
-      if (!coverage[i]) displayMaskUpdated++;
-      coverage[i] = 1;
-      const isSea = Boolean(sea?.[i]);
-      humanMask[i] = isSea ? 0 : 1;
-      landMask[i] = isSea ? 0 : 1;
-    }
-  }
-  return { displayMaskUpdated };
-}
-
-function featherTerrainSeam(world, rects, seed = 0) {
-  const fields = world.fields || {};
-  const smoothKeys = [
-    "elevation", "moisture", "ridgeField", "valleyField", "visibleRavineField",
-    "basinField", "coastalLowland", "plain", "agriculture", "erosionField",
-    "depositionField", "depositionalLowland", "alluvialFanField", "deltaField",
-    "naturalBarrierScore", "settlementScore", "populationDensity",
-  ];
-  let terrainFeatherCells = 0;
-  let terrainFeatherValues = 0;
-  for (const key of smoothKeys) {
-    const field = fields[key];
-    if (!field || !ArrayBuffer.isView(field)) continue;
-    const old = new field.constructor(field);
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        if (patchBand(x, y, rects, seed) !== "feather") continue;
-        const i = worldIndex(world, x, y);
-        if (i < 0 || fields.sea?.[i]) continue;
-        let sum = 0;
-        let count = 0;
-        for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
-          const ni = worldIndex(world, x + dx, y + dy);
-          if (ni >= 0 && !fields.sea?.[ni]) {
-            sum += old[ni] || 0;
-            count++;
-          }
-        }
-        if (!count) continue;
-        const a = patchAlpha(x, y, rects, seed);
-        const neighborMean = sum / count;
-        const seamWeight = 0.34 * (1 - Math.abs(a - 0.5) * 1.2);
-        field[i] = lerp(field[i] || 0, neighborMean, clamp(seamWeight, 0.08, 0.34));
-        terrainFeatherValues++;
-        if (key === "elevation") terrainFeatherCells++;
-      }
-    }
-  }
-  return { terrainFeatherCells, terrainFeatherValues };
-}
-
-
-function nearestLandFieldValue(world, x, y, fieldName, rect, options = {}) {
-  const field = world.fields?.[fieldName];
-  const sea = world.fields?.sea;
-  if (!field) return -1;
-  const maxRadius = Math.max(1, Math.floor(options.maxRadius || 18));
-  const requiredPref = Number.isFinite(options.requiredPref) ? Math.floor(options.requiredPref) : null;
-  const prefField = world.fields?.prefectureRegionId;
-  for (let r = 1; r <= maxRadius; r++) {
-    let best = -1;
-    let bestD = Infinity;
-    const y0 = Math.max(0, y - r);
-    const y1 = Math.min(world.height - 1, y + r);
-    const x0 = Math.max(0, x - r);
-    const x1 = Math.min(world.width - 1, x + r);
-    for (let yy = y0; yy <= y1; yy++) {
-      for (let xx = x0; xx <= x1; xx++) {
-        if (Math.max(Math.abs(xx - x), Math.abs(yy - y)) !== r) continue;
-        if (rect && !insideRect(xx, yy, rect)) continue;
-        const i = worldIndex(world, xx, yy);
-        if (i < 0 || sea?.[i]) continue;
-        if (requiredPref !== null && prefField?.[i] !== requiredPref) continue;
-        const id = field[i];
-        if (!Number.isFinite(id) || id < 0) continue;
-        const d = Math.hypot(xx - x, yy - y);
-        if (d < bestD) { best = Math.floor(id); bestD = d; }
-      }
-    }
-    if (best >= 0) return best;
-  }
-  return -1;
-}
-
-function lookupPrefectureForAdmin(sourceMap, adminIdMapping, adminId) {
-  if (!Number.isFinite(adminId) || adminId < 0) return -1;
-  const id = Math.floor(adminId);
-  const mapped = adminIdMapping?.municipalityToPrefecture?.get(id);
-  if (Number.isFinite(mapped) && mapped >= 0) return Math.floor(mapped);
-  const table = sourceMap?.municipalityToPrefectureId;
-  if (table && id >= 0 && id < table.length && Number.isFinite(table[id]) && table[id] >= 0) return Math.floor(table[id]);
-  return -1;
-}
-
-function repairAdminCoverage(world, sourceMap, rects, adminIdMapping = null, seed = 0) {
-  const admin = world.fields?.adminId;
-  if (!admin) return { seaAdminCellsCleared: 0, landAdminCellsFilled: 0, prefectureCellsFilled: 0, adminPrefectureCellsAligned: 0 };
-  const expected = world.width * world.height;
-  if (!world.fields.municipalityId || world.fields.municipalityId.length !== expected) {
-    world.fields.municipalityId = new Int32Array(expected);
-    world.fields.municipalityId.fill(-1);
-  }
-  if (!world.fields.prefectureRegionId || world.fields.prefectureRegionId.length !== expected) {
-    world.fields.prefectureRegionId = new Int32Array(expected);
-    world.fields.prefectureRegionId.fill(-1);
-  }
-  const municipality = world.fields.municipalityId;
-  const prefecture = world.fields.prefectureRegionId;
-  const sea = world.fields.sea;
-  const coverage = world.fields.prefectureMask;
-  let seaAdminCellsCleared = 0;
-  let landAdminCellsFilled = 0;
-  let prefectureCellsFilled = 0;
-  let adminPrefectureCellsAligned = 0;
-
-  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i < 0) continue;
-      if (sea?.[i]) {
-        if (admin[i] >= 0 || municipality[i] >= 0 || prefecture[i] >= 0) seaAdminCellsCleared++;
-        admin[i] = -1;
-        municipality[i] = -1;
-        prefecture[i] = -1;
-        continue;
-      }
-      const generated = patchAlpha(x, y, rects, seed) > 0.08 || (!coverage && insideRect(x, y, rects.writeRect));
-      if (!generated) continue;
-
-      if (admin[i] < 0) {
-        const preferredPref = prefecture[i] >= 0 ? prefecture[i] : null;
-        let nearest = nearestLandFieldValue(world, x, y, 'adminId', rects.repairRect || rects.writeRect, { requiredPref: preferredPref, maxRadius: 24 });
-        if (nearest < 0) nearest = nearestLandFieldValue(world, x, y, 'adminId', null, { requiredPref: preferredPref, maxRadius: 18 });
-        if (nearest >= 0) {
-          admin[i] = nearest;
-          municipality[i] = nearest;
-          landAdminCellsFilled++;
-        }
-      }
-      if (municipality[i] < 0 && admin[i] >= 0) municipality[i] = admin[i];
-      if (admin[i] >= 0 && municipality[i] !== admin[i]) municipality[i] = admin[i];
-
-      let targetPref = lookupPrefectureForAdmin(sourceMap, adminIdMapping, admin[i]);
-      if (targetPref < 0 && prefecture[i] < 0) targetPref = nearestLandFieldValue(world, x, y, 'prefectureRegionId', rects.repairRect || rects.writeRect, { maxRadius: 28 });
-      if (targetPref >= 0 && prefecture[i] !== targetPref) {
-        if (prefecture[i] < 0) prefectureCellsFilled++;
-        else adminPrefectureCellsAligned++;
-        prefecture[i] = targetPref;
-      } else if (prefecture[i] < 0) {
-        const nearestPref = nearestLandFieldValue(world, x, y, 'prefectureRegionId', null, { maxRadius: 22 });
-        if (nearestPref >= 0) { prefecture[i] = nearestPref; prefectureCellsFilled++; }
-      }
-    }
-  }
-
-  const current = sourceMap?.municipalityToPrefectureId;
-  let maxId = current?.length ? current.length - 1 : -1;
-  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i >= 0 && admin[i] >= 0 && prefecture[i] >= 0) maxId = Math.max(maxId, admin[i]);
-    }
-  }
-  if (sourceMap && maxId >= 0) {
-    const next = new Int32Array(maxId + 1);
-    next.fill(-1);
-    if (current) for (let i = 0; i < current.length && i < next.length; i++) next[i] = current[i] ?? -1;
-    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-        const i = worldIndex(world, x, y);
-        if (i >= 0 && admin[i] >= 0 && prefecture[i] >= 0) next[admin[i]] = prefecture[i];
-      }
-    }
-    sourceMap.municipalityToPrefectureId = next;
-  }
-
-  return { seaAdminCellsCleared, landAdminCellsFilled, prefectureCellsFilled, adminPrefectureCellsAligned };
-}
-
-function smoothWaterTopology(world, rect, seaLevel = 0.30, rects = null, seed = 0) {
-  const sea = world.fields.sea;
-  const ocean = world.fields.ocean;
-  const lake = world.fields.lake;
-  const elevation = world.fields.elevation;
-  if (!sea || !elevation) return { coastCellsChanged: 0 };
-  let changed = 0;
-  for (let pass = 0; pass < 3; pass++) {
-    const flips = [];
-    for (let y = rect.y0 + 1; y < rect.y1 - 1; y++) {
-      for (let x = rect.x0 + 1; x < rect.x1 - 1; x++) {
-        const i = worldIndex(world, x, y);
-        if (i < 0) continue;
-        let seaN = 0;
-        let landN = 0;
-        for (let dy = -1; dy <= 1; dy++) {
-          for (let dx = -1; dx <= 1; dx++) {
-            if (!dx && !dy) continue;
-            const ni = worldIndex(world, x + dx, y + dy);
-            if (ni < 0) continue;
-            if (sea[ni]) seaN++; else landN++;
-          }
-        }
-        const a = rects ? patchAlpha(x, y, rects, seed) : 1;
-        if (a < 0.24) continue;
-        const strongOnly = a < 0.42;
-        if (sea[i] && seaN <= (strongOnly ? 0 : 1) && elevation[i] > seaLevel - 0.035) flips.push([i, 0]);
-        else if (!sea[i] && seaN >= (strongOnly ? 8 : 7) && elevation[i] < seaLevel + 0.055) flips.push([i, 1]);
-      }
-    }
-    for (const [i, nextSea] of flips) {
-      if (sea[i] === nextSea) continue;
-      sea[i] = nextSea;
-      if (ocean) ocean[i] = nextSea;
-      if (lake) lake[i] = 0;
-      if (nextSea) elevation[i] = Math.min(elevation[i], seaLevel - 0.004);
-      else elevation[i] = Math.max(elevation[i], seaLevel + 0.006);
-      changed++;
-    }
-  }
-  return { coastCellsChanged: changed };
-}
-
-function recomputeSlopeAndWaterDependentFields(world, rect, seaLevel = 0.30) {
-  const fields = world.fields;
-  const { elevation, sea } = fields;
-  if (!elevation || !sea) return;
-  if (!fields.slope) fields.slope = new Float32Array(world.width * world.height);
-  for (let y = rect.y0; y < rect.y1; y++) {
-    for (let x = rect.x0; x < rect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i < 0) continue;
-      if (sea[i]) {
-        for (const key of ["slope", "river", "floodplain", "plain", "agriculture", "ridgeField", "valleyField", "coastalLowland", "naturalBarrierScore", "populationDensity", "settlementScore", "roadInfluence", "railInfluence2", "stationInfluence", "villageInfluence"]) {
-          if (fields[key]) fields[key][i] = 0;
-        }
-        continue;
-      }
-      if (x > 0 && y > 0 && x < world.width - 1 && y < world.height - 1) {
-        const gx = elevation[worldIndex(world, x + 1, y)] - elevation[worldIndex(world, x - 1, y)];
-        const gy = elevation[worldIndex(world, x, y + 1)] - elevation[worldIndex(world, x, y - 1)];
-        fields.slope[i] = clamp(Math.hypot(gx, gy) * 8.2);
-      }
-      if (fields.plain) fields.plain[i] = clamp((fields.plain[i] || 0) * 0.75 + (1 - (fields.slope[i] || 0)) * clamp((0.62 - elevation[i]) * 1.8) * 0.25);
-      if (fields.agriculture && fields.plain) fields.agriculture[i] = clamp((fields.agriculture[i] || 0) * 0.72 + fields.plain[i] * 0.28);
-    }
-  }
-}
-
-function seaNeighbors(world, x, y, radius = 1) {
-  let count = 0;
-  for (let dy = -radius; dy <= radius; dy++) {
-    for (let dx = -radius; dx <= radius; dx++) {
-      if (!dx && !dy) continue;
-      const i = worldIndex(world, x + dx, y + dy);
-      if (i >= 0 && world.fields.sea?.[i]) count++;
-    }
-  }
-  return count;
-}
-
-function isLand(world, x, y) {
-  const i = worldIndex(world, x, y);
-  return i >= 0 && !world.fields.sea?.[i];
-}
-
-function nearestLand(world, x, y, rect, radius = 10) {
-  if (insideRect(x, y, rect) && isLand(world, x, y)) return { x, y };
-  for (let r = 1; r <= radius; r++) {
-    let best = null;
-    let bestScore = Infinity;
-    for (let yy = y - r; yy <= y + r; yy++) {
-      for (let xx = x - r; xx <= x + r; xx++) {
-        if (Math.abs(xx - x) !== r && Math.abs(yy - y) !== r) continue;
-        if (!insideRect(xx, yy, rect) || !isLand(world, xx, yy)) continue;
-        const i = worldIndex(world, xx, yy);
-        const score = Math.hypot(xx - x, yy - y) + (world.fields.slope?.[i] || 0) * 3;
-        if (score < bestScore) { bestScore = score; best = { x: xx, y: yy }; }
-      }
-    }
-    if (best) return best;
-  }
-  return null;
-}
-
-function pointWorldX(world, p) {
-  if (Number.isFinite(p?.worldX)) return p.worldX;
-  return (p?.x || 0) + (world?.originX || 0);
-}
-
-function pointWorldY(world, p) {
-  if (Number.isFinite(p?.worldY)) return p.worldY;
-  return (p?.y || 0) + (world?.originY || 0);
-}
-
-function tupleWorldX(world, tuple) {
-  return (tuple?.[0] || 0) + (world?.originX || 0);
-}
-
-function tupleWorldY(world, tuple) {
-  return (tuple?.[1] || 0) + (world?.originY || 0);
-}
-
-function sourcePointFromWorld(world, point) {
-  return { ...point, x: point.x - world.originX, y: point.y - world.originY, worldX: point.x, worldY: point.y, patchGenerated: true };
-}
-
-function sourcePathFromWorld(world, path) {
-  return path.map(([x, y]) => [Math.round(x - world.originX), Math.round(y - world.originY)]);
-}
-
-function offsetPointNumericFields(point, fields, offset) {
-  for (const field of fields) if (Number.isFinite(point[field])) point[field] += offset;
-}
-
-function normalizeGeneratedPointIds(point, key, seed = 0, adminIdMapping = null) {
-  const rawAdminId = numericFeatureId(point, ["adminId", "municipalityId", "adminNumericId"]);
-  if (rawAdminId >= 0) {
-    const mappedAdminId = adminIdMapping?.admin?.get(rawAdminId) ?? adminIdMapping?.municipality?.get(rawAdminId);
-    if (Number.isFinite(mappedAdminId)) {
-      point.sourceAdminId = rawAdminId;
-      point.adminId = mappedAdminId;
-      point.adminNumericId = mappedAdminId;
-      point.municipalityId = mappedAdminId;
-    } else {
-      offsetPointNumericFields(point, ["adminId", "adminNumericId", "municipalityId"], fieldIdOffset("adminId", seed));
-      if (!Number.isFinite(point.adminId) && Number.isFinite(point.municipalityId)) point.adminId = point.municipalityId;
-      if (!Number.isFinite(point.municipalityId) && Number.isFinite(point.adminId)) point.municipalityId = point.adminId;
-    }
-  }
-
-  const rawPrefectureId = numericFeatureId(point, key === "prefectureRegions" ? ["prefectureRegionId", "id"] : ["prefectureRegionId"]);
-  if (rawPrefectureId >= 0) {
-    const mappedPrefectureId = adminIdMapping?.prefecture?.get(rawPrefectureId);
-    if (Number.isFinite(mappedPrefectureId)) {
-      point.sourcePrefectureRegionId = rawPrefectureId;
-      point.prefectureRegionId = mappedPrefectureId;
-      if (key === "prefectureRegions") point.id = mappedPrefectureId;
-    } else {
-      const offset = fieldIdOffset("prefectureRegionId", seed);
-      if (Number.isFinite(point.prefectureRegionId)) point.prefectureRegionId += offset;
-      if (key === "prefectureRegions" && Number.isFinite(point.id)) point.id += offset;
-    }
-  }
-
-  if (Number.isFinite(point.adminId) && !Number.isFinite(point.municipalityId)) point.municipalityId = point.adminId;
-  if (Number.isFinite(point.municipalityId) && !Number.isFinite(point.adminId)) point.adminId = point.municipalityId;
-  return point;
-}
-
-function transformCandidatePoint(world, window, p, key, seed = 0, adminIdMapping = null) {
-  if (!p || !Number.isFinite(p.x) || !Number.isFinite(p.y)) return null;
-  const w = worldCoordForSource(window, p.x, p.y);
-  if (key === "ports") {
-    const land = nearestLand(world, w.x, w.y, { x0: 0, y0: 0, x1: world.width, y1: world.height }, 8);
-    if (!land || seaNeighbors(world, land.x, land.y, 2) < 2) return null;
-    w.x = land.x; w.y = land.y;
-  } else if (!["crossings", "passes", "externalGateways", "prefectureRegions"].includes(key) && !isLand(world, w.x, w.y)) {
-    const land = nearestLand(world, w.x, w.y, { x0: 0, y0: 0, x1: world.width, y1: world.height }, 5);
-    if (!land) return null;
-    w.x = land.x; w.y = land.y;
-  }
-  const out = sourcePointFromWorld(world, { ...p, x: w.x, y: w.y });
-  normalizeGeneratedPointIds(out, key, seed, adminIdMapping);
-  if (key === "adminCenters") {
-    if (Number.isFinite(out.sourceAdminId)) {
-      const candidatePrefId = adminIdMapping?.candidateAdminToPrefecture?.get(out.sourceAdminId);
-      const mappedPrefId = adminIdMapping?.prefecture?.get(candidatePrefId);
-      if (Number.isFinite(mappedPrefId)) out.prefectureRegionId = mappedPrefId;
-    }
-  }
-  if (key === "logisticsParks") sanitizeLogisticsPark(out);
-  return out;
-}
-
-function sanitizeLogisticsPark(p) {
-  if (!p) return p;
-  p.name = null;
-  p.labelName = null;
-  p.facilityLabel = p.facilityLabel || "Logistics Park";
-  p.labelStyle = "facility";
-  p.suppressSettlementLabel = true;
-  p.kind = "Logistics Park";
-  p.population = 0;
-  return p;
-}
-
-function sanitizeExistingLogistics(sourceMap) {
-  let migrated = 0;
-  if (!Array.isArray(sourceMap.logisticsParks)) return 0;
-  for (const p of sourceMap.logisticsParks) {
-    if (!p) continue;
-    if (p.name || p.labelName || !p.suppressSettlementLabel) migrated++;
-    sanitizeLogisticsPark(p);
-  }
-  for (const key of ["villages", "markets", "modernCities", "satelliteCities", "newTowns", "adminCenters"]) {
-    const arr = sourceMap[key];
-    if (!Array.isArray(arr)) continue;
-    for (const p of arr) {
-      if (!p?.name || !/\bLogistics\b/i.test(String(p.name))) continue;
-      p.name = String(p.name).replace(/\s*Logistics\b/ig, "").trim() || null;
-      p.labelName = p.name;
-      migrated++;
-    }
-  }
-  return migrated;
-}
-
-function transformCandidatePath(window, path) {
-  const out = [];
-  for (const tuple of path || []) {
-    if (!Array.isArray(tuple) || tuple.length < 2) continue;
-    const p = worldCoordForSource(window, tuple[0], tuple[1]);
-    out.push([p.x, p.y]);
-  }
-  return out;
-}
-
-function splitWorldPathByPredicate(path, predicate, keepWhenTrue) {
-  const chunks = [];
-  let current = [];
-  for (const p of path || []) {
-    const matches = predicate(Math.round(p[0]), Math.round(p[1]));
-    if (matches === keepWhenTrue) current.push([Math.round(p[0]), Math.round(p[1])]);
-    else {
-      if (current.length >= 2) chunks.push(current);
-      current = [];
-    }
-  }
-  if (current.length >= 2) chunks.push(current);
-  return chunks;
-}
-
-function splitWorldPathByRect(path, rect, keepInside) {
-  return splitWorldPathByPredicate(path, (x, y) => insideRect(x, y, rect), keepInside);
-}
-
-function splitWorldPathByPatch(path, rects, seed, keepAffected, minAlpha = 0.34) {
-  return splitWorldPathByPredicate(path, (x, y) => patchAffected(x, y, rects, seed, minAlpha), keepAffected);
-}
-
-function pruneOldPathLayer(world, paths, rects, seed, mode) {
-  const kept = [];
-  const anchors = [];
-  let clipped = 0;
-  for (const path of paths || []) {
-    const worldPath = (path || []).map((tuple) => [Math.round(tupleWorldX(world, tuple)), Math.round(tupleWorldY(world, tuple))]);
-    const touches = worldPath.some(([x, y]) => patchAffected(x, y, rects, seed, 0.34));
-    if (!touches) {
-      kept.push(path);
-      continue;
-    }
-    clipped++;
-    let lastOutside = null;
-    let wasInside = false;
-    for (const [x, y] of worldPath) {
-      const inside = patchAffected(x, y, rects, seed, 0.34);
-      if (!inside) {
-        if (wasInside) anchors.push({ x, y, mode });
-        lastOutside = { x, y, mode };
-      } else if (lastOutside && !wasInside) {
-        anchors.push(lastOutside);
-      }
-      wasInside = inside;
-    }
-    for (const chunk of splitWorldPathByPatch(worldPath, rects, seed, false, 0.34)) kept.push(sourcePathFromWorld(world, chunk));
-  }
-  return { kept, anchors, clipped };
-}
-
-function pathCost(world, x, y, mode) {
-  const i = worldIndex(world, x, y);
-  if (i < 0 || world.fields.sea?.[i]) return Infinity;
-  const slope = world.fields.slope?.[i] || 0;
-  const river = world.fields.river?.[i] || 0;
-  const plain = world.fields.plain?.[i] || 0;
-  const roadInfluence = world.fields.roadInfluence?.[i] || 0;
-  const pop = world.fields.populationDensity?.[i] || 0;
-  const slopeMult = mode === "rail" ? 15 : 7;
-  return 1 + slope * slopeMult - plain * 0.35 - roadInfluence * 0.28 - pop * 0.18 + river * 0.18;
-}
-
-function localPathfind(world, start, goal, rect, mode = "road", maxExpanded = 24000) {
-  const sx = Math.round(start.x), sy = Math.round(start.y), gx = Math.round(goal.x), gy = Math.round(goal.y);
-  if (!insideRect(sx, sy, rect) || !insideRect(gx, gy, rect)) return null;
-  if (!isLand(world, sx, sy) || !isLand(world, gx, gy)) return null;
-  const w = rectWidth(rect);
-  const h = rectHeight(rect);
-  const n = w * h;
-  const dist = new Float64Array(n); dist.fill(Infinity);
-  const prev = new Int32Array(n); prev.fill(-1);
-  const local = (x, y) => (y - rect.y0) * w + (x - rect.x0);
-  const heap = new MinHeap();
-  const startId = local(sx, sy);
-  dist[startId] = 0;
-  heap.push({ x: sx, y: sy, f: Math.hypot(sx - gx, sy - gy), id: startId });
-  let expanded = 0;
-  let found = -1;
-  const dirs = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
-  while (heap.items.length && expanded < maxExpanded) {
-    const cur = heap.pop();
-    if (!cur) break;
-    if (cur.x === gx && cur.y === gy) { found = cur.id; break; }
-    expanded++;
-    for (const [dx, dy] of dirs) {
-      const nx = cur.x + dx, ny = cur.y + dy;
-      if (!insideRect(nx, ny, rect)) continue;
-      const nid = local(nx, ny);
-      const c = pathCost(world, nx, ny, mode);
-      if (!Number.isFinite(c)) continue;
-      const step = (dx && dy ? 1.42 : 1) * c;
-      const nd = dist[cur.id] + step;
-      if (nd >= dist[nid]) continue;
-      dist[nid] = nd;
-      prev[nid] = cur.id;
-      heap.push({ x: nx, y: ny, id: nid, f: nd + Math.hypot(nx - gx, ny - gy) * 1.05 });
-    }
-  }
-  if (found < 0) return null;
-  const rev = [];
-  let at = found;
-  while (at >= 0) {
-    const x = rect.x0 + (at % w);
-    const y = rect.y0 + Math.floor(at / w);
-    rev.push([x, y]);
-    at = prev[at];
-  }
-  return rev.reverse();
-}
-
-function simplifyPath(path, keepEvery = 2) {
-  if (!path || path.length <= 2) return path || [];
-  const out = [path[0]];
-  for (let i = 1; i < path.length - 1; i++) if (i % keepEvery === 0) out.push(path[i]);
-  out.push(path[path.length - 1]);
-  return out;
-}
-
-function collectInternalNetworkPoints(world, sourceMap, keys, rect, mode = "road") {
-  const points = [];
-  const seen = new Set();
-  const add = (x, y, key, weight = 1) => {
-    x = Math.round(x); y = Math.round(y);
-    if (!insideRect(x, y, rect) || !isLand(world, x, y)) return;
-    const sig = `${x},${y},${key}`;
-    if (seen.has(sig)) return;
-    seen.add(sig);
-    points.push({ x, y, key, weight });
-  };
-  for (const key of keys) {
-    for (const path of sourceMap[key] || []) {
-      for (let i = 0; i < path.length; i += 4) {
-        add(tupleWorldX(world, path[i]), tupleWorldY(world, path[i]), key, 1.1);
-      }
-    }
-  }
-  const featureKeys = mode === "rail"
-    ? ["modernCities", "stations", "ports", "adminCenters", "industrialZones", "newTowns"]
-    : ["modernCities", "ports", "markets", "villages", "adminCenters", "industrialZones", "logisticsParks", "newTowns"];
-  for (const key of featureKeys) {
-    for (const p of sourceMap[key] || []) {
-      add(pointWorldX(world, p), pointWorldY(world, p), key, key === "adminCenters" || key === "modernCities" ? 1.8 : 1.25);
-    }
-  }
-  return points;
-}
-
-function rectDistance(x, y, rect) {
-  if (insideRect(x, y, rect)) return 0;
-  const dx = x < rect.x0 ? rect.x0 - x : x >= rect.x1 ? x - rect.x1 + 1 : 0;
-  const dy = y < rect.y0 ? rect.y0 - y : y >= rect.y1 ? y - rect.y1 + 1 : 0;
-  return Math.hypot(dx, dy);
-}
-
-function collectExternalNetworkAnchors(world, sourceMap, keys, writeRect, reachRect, mode = "road") {
-  const candidates = [];
-  const seen = new Set();
-  const step = mode === "rail" ? 6 : 4;
-  for (const key of keys) {
-    for (const path of sourceMap[key] || []) {
-      for (let i = 0; i < path.length; i += step) {
-        const x = Math.round(tupleWorldX(world, path[i]));
-        const y = Math.round(tupleWorldY(world, path[i]));
-        if (!insideRect(x, y, reachRect) || insideRect(x, y, writeRect) || !isLand(world, x, y)) continue;
-        const d = rectDistance(x, y, writeRect);
-        if (d < 4 || d > (mode === "rail" ? 380 : 420)) continue;
-        const sig = `${x},${y},${mode}`;
-        if (seen.has(sig)) continue;
-        seen.add(sig);
-        candidates.push({ x, y, mode, external: true, d });
-      }
-    }
-  }
-  candidates.sort((a, b) => a.d - b.d);
-  return candidates.slice(0, mode === "rail" ? 18 : 28);
-}
-
-function connectAnchors(world, sourceMap, anchors, mode, rect, preferredTargetRect = null) {
-  const keys = mode === "rail" ? ["railways", "branchRailways"] : ["nationalRoads", "minorRoads", "premodernRoads"];
-  const allTargets = collectInternalNetworkPoints(world, sourceMap, keys, rect, mode);
-  const preferredTargets = preferredTargetRect ? allTargets.filter((p) => insideRect(p.x, p.y, preferredTargetRect)) : [];
-  const targets = preferredTargets.length ? preferredTargets : allTargets;
-  if (!targets.length) return { connectors: 0, disconnected: anchors.length, skippedConnectorAnchors: 0, connectorAttempts: 0 };
-  let connectors = 0;
-  let disconnected = 0;
-  let skippedConnectorAnchors = 0;
-  let connectorAttempts = 0;
-  const layer = mode === "rail" ? "branchRailways" : "minorRoads";
-  sourceMap[layer] ||= [];
-  const seen = new Set();
-  const maxRange = mode === "rail" ? 220 : 260;
-  const maxAnchors = mode === "rail" ? 10 : 18;
-  const maxTargets = mode === "rail" ? 3 : 3;
-  const searchRect = expandRect(rect, 16, world);
-  const orderedAnchors = (anchors || [])
-    .map((p) => ({ ...p, patchDistance: rectDistance(p.x, p.y, preferredTargetRect || rect) }))
-    .sort((a, b) => a.patchDistance - b.patchDistance)
-    .slice(0, maxAnchors);
-  skippedConnectorAnchors = Math.max(0, (anchors?.length || 0) - orderedAnchors.length);
-  for (const raw of orderedAnchors) {
-    const anchorLand = nearestLand(world, raw.x, raw.y, rect, 18);
-    if (!anchorLand) { disconnected++; continue; }
-    const targetList = targets
-      .map((p) => ({ ...p, d: Math.hypot(p.x - anchorLand.x, p.y - anchorLand.y) }))
-      .filter((p) => p.d <= maxRange && p.d >= 6)
-      .sort((a, b) => (a.d / Math.max(0.6, a.weight || 1)) - (b.d / Math.max(0.6, b.weight || 1)))
-      .slice(0, maxTargets);
-    if (!targetList.length) { disconnected++; continue; }
-    let made = false;
-    for (const target of targetList) {
-      const sig = `${anchorLand.x},${anchorLand.y}:${target.x},${target.y}:${mode}`;
-      if (seen.has(sig)) continue;
-      connectorAttempts++;
-      const path = localPathfind(world, anchorLand, target, searchRect, mode, mode === "rail" ? 36000 : 44000);
-      if (!path || path.length < 2) continue;
-      seen.add(sig);
-      sourceMap[layer].push(sourcePathFromWorld(world, simplifyPath(path, mode === "rail" ? 3 : 2)));
-      connectors++;
-      made = true;
-      break;
-    }
-    if (!made) disconnected++;
-  }
-  return { connectors, disconnected, skippedConnectorAnchors, connectorAttempts };
-}
-
-function nearestNetworkPoint(world, sourceMap, keys, point, rect, maxDistance = 80) {
-  let best = null;
-  let bestD = maxDistance;
-  for (const key of keys) {
-    for (const path of sourceMap[key] || []) {
-      for (let i = 0; i < path.length; i += 5) {
-        const x = Math.round(tupleWorldX(world, path[i]));
-        const y = Math.round(tupleWorldY(world, path[i]));
-        if (!insideRect(x, y, rect) || !isLand(world, x, y)) continue;
-        const d = Math.hypot(point.x - x, point.y - y);
-        if (d < bestD) { bestD = d; best = { x, y, key }; }
-      }
-    }
-  }
-  return best;
-}
-
-function ensureSettlementRoadCoverage(world, sourceMap, rect) {
-  const keys = ["nationalRoads", "minorRoads", "premodernRoads"];
-  const featureKeys = ["modernCities", "ports", "markets", "adminCenters", "villages"];
-  sourceMap.minorRoads ||= [];
-  let connectors = 0;
-  let skippedServedSettlements = 0;
-  let checked = 0;
-  const seen = new Set();
-  for (const key of featureKeys) {
-    const limit = key === "villages" ? 30 : 18;
-    const items = (sourceMap[key] || [])
-      .map((p) => ({ p, d: rectDistance(pointWorldX(world, p), pointWorldY(world, p), rect) }))
-      .filter((row) => row.d <= (key === "villages" ? 80 : 150))
-      .sort((a, b) => a.d - b.d)
-      .slice(0, limit);
-    for (const { p } of items) {
-      checked++;
-      const start = nearestLand(world, pointWorldX(world, p), pointWorldY(world, p), rect, 10);
-      if (!start || !insideRect(start.x, start.y, rect)) continue;
-      const si = worldIndex(world, start.x, start.y);
-      if ((world.fields.roadInfluence?.[si] || 0) > (key === "villages" ? 0.18 : 0.12)) {
-        skippedServedSettlements++;
-        continue;
-      }
-      const target = nearestNetworkPoint(world, sourceMap, keys, start, rect, key === "villages" ? 72 : 132);
-      if (!target || Math.hypot(target.x - start.x, target.y - start.y) < 5) continue;
-      const sig = `${start.x},${start.y}:${target.x},${target.y}`;
-      if (seen.has(sig)) continue;
-      seen.add(sig);
-      const path = localPathfind(world, start, target, rect, "road", 36000);
-      if (!path || path.length < 2) continue;
-      sourceMap.minorRoads.push(sourcePathFromWorld(world, simplifyPath(path, 2)));
-      connectors++;
-    }
-  }
-  return { connectors, skippedServedSettlements, checkedSettlementCoverage: checked };
-}
-
-function dedupeAdminCentersByWorldId(kept, generated) {
-  const out = [...kept];
-  const seen = new Set();
-  for (const p of kept) {
-    const id = numericFeatureId(p, ["adminId", "municipalityId", "adminNumericId"]);
-    if (id >= 0) seen.add(id);
-  }
-  for (const p of generated) {
-    const id = numericFeatureId(p, ["adminId", "municipalityId", "adminNumericId"]);
-    if (id >= 0 && seen.has(id)) continue;
-    if (id >= 0) seen.add(id);
-    out.push(p);
-  }
-  return out;
-}
-
-function dedupePrefectureRegionsByWorldId(kept, generated) {
-  const out = [...kept];
-  const seen = new Set();
-  for (const p of kept) {
-    const id = numericFeatureId(p, ["prefectureRegionId", "id"]);
-    if (id >= 0) seen.add(id);
-  }
-  for (const p of generated) {
-    const id = numericFeatureId(p, ["prefectureRegionId", "id"]);
-    if (id >= 0 && seen.has(id)) continue;
-    if (id >= 0) seen.add(id);
-    out.push(p);
-  }
-  return out;
-}
-
-function mergePointLayers(world, sourceMap, candidate, rects, window, seed, adminIdMapping = null) {
-  let preservedExternalEntities = 0;
-  let regeneratedInternalEntities = 0;
-  let invalidPortsRemoved = 0;
-  for (const key of POINT_LAYER_KEYS) {
-    const oldArr = Array.isArray(sourceMap[key]) ? sourceMap[key] : [];
-    const kept = [];
-    for (const p of oldArr) {
-      if (!p) continue;
-      const wx = Math.round(pointWorldX(world, p));
-      const wy = Math.round(pointWorldY(world, p));
-      const inWrite = insideRect(wx, wy, rects.writeRect);
-      const alpha = inWrite ? patchAlpha(wx, wy, rects, seed) : 0;
-      if (!inWrite || alpha < 0.34) {
-        kept.push(p);
-        if (!inWrite) preservedExternalEntities++;
-      } else if (key === "ports" && (!isLand(world, wx, wy) || seaNeighbors(world, wx, wy, 2) < 2)) {
-        invalidPortsRemoved++;
-        continue;
-      }
-    }
-    const generated = [];
-    for (const p of candidate[key] || []) {
-      const q = transformCandidatePoint(world, window, p, key, seed, adminIdMapping);
-      if (!q) continue;
-      const wx = Math.round(pointWorldX(world, q));
-      const wy = Math.round(pointWorldY(world, q));
-      if (!insideRect(wx, wy, rects.writeRect)) continue;
-      if (patchAlpha(wx, wy, rects, seed) < 0.42) continue;
-      generated.push(q);
-    }
-    if (key === "adminCenters") sourceMap[key] = dedupeAdminCentersByWorldId(kept, generated);
-    else if (key === "prefectureRegions") sourceMap[key] = dedupePrefectureRegionsByWorldId(kept, generated);
-    else sourceMap[key] = [...kept, ...generated];
-    regeneratedInternalEntities += Math.max(0, sourceMap[key].length - kept.length);
-  }
-  return { preservedExternalEntities, regeneratedInternalEntities, invalidPortsRemoved };
-}
-
-function mergePathLayers(world, sourceMap, candidate, rects, window, seed) {
-  let roadAnchors = [];
-  let railAnchors = [];
-  let roadsClipped = 0;
-  let railsClipped = 0;
-  let regeneratedPaths = 0;
-  for (const key of PATH_LAYER_KEYS) {
-    const oldArr = Array.isArray(sourceMap[key]) ? sourceMap[key] : [];
-    const mode = RAIL_LAYER_KEYS.has(key) ? "rail" : ROAD_LAYER_KEYS.has(key) ? "road" : RIVER_LAYER_KEYS.has(key) ? "river" : "path";
-    const pruned = pruneOldPathLayer(world, oldArr, rects, seed, mode);
-    if (mode === "rail") { railAnchors = railAnchors.concat(pruned.anchors); railsClipped += pruned.clipped; }
-    else if (mode === "road") { roadAnchors = roadAnchors.concat(pruned.anchors); roadsClipped += pruned.clipped; }
-    const next = [...pruned.kept];
-    for (const path of candidate[key] || []) {
-      const worldPath = transformCandidatePath(window, path);
-      const chunks = splitWorldPathByPatch(worldPath, rects, seed, true, 0.40)
-        .map((chunk) => chunk.filter(([x, y]) => mode === "river" || isLand(world, x, y) || patchAlpha(x, y, rects, seed) > 0.90))
-        .filter((chunk) => chunk.length >= 2);
-      for (const chunk of chunks) {
-        if (chunk.some(([x, y]) => patchAlpha(x, y, rects, seed) >= 0.40)) {
-          next.push(sourcePathFromWorld(world, simplifyPath(chunk, mode === "rail" ? 3 : 2)));
-          regeneratedPaths++;
-        }
-      }
-    }
-    sourceMap[key] = next;
-  }
-  const transportRect = rects.transportReachRect || rects.repairRect || rects.writeRect;
-  const externalRoadAnchors = collectExternalNetworkAnchors(world, sourceMap, ["nationalRoads", "minorRoads", "premodernRoads", "externalRoads"], rects.writeRect, transportRect, "road");
-  const externalRailAnchors = collectExternalNetworkAnchors(world, sourceMap, ["railways", "branchRailways", "externalRailways"], rects.writeRect, transportRect, "rail");
-  roadAnchors = roadAnchors.concat(externalRoadAnchors);
-  railAnchors = railAnchors.concat(externalRailAnchors);
-  const roadConn = connectAnchors(world, sourceMap, roadAnchors, "road", transportRect, rects.writeRect);
-  const railConn = connectAnchors(world, sourceMap, railAnchors, "rail", transportRect, rects.writeRect);
-  const settlementRoadConnectors = ensureSettlementRoadCoverage(world, sourceMap, transportRect);
-  return {
-    roadsClipped,
-    railsClipped,
-    regeneratedPaths,
-    roadConnectorsCreated: roadConn.connectors + settlementRoadConnectors.connectors,
-    railwayConnectorsCreated: railConn.connectors,
-    disconnectedRoadComponents: roadConn.disconnected,
-    disconnectedRailComponents: railConn.disconnected,
-    skippedConnectorAnchors: (roadConn.skippedConnectorAnchors || 0) + (railConn.skippedConnectorAnchors || 0),
-    connectorAttempts: (roadConn.connectorAttempts || 0) + (railConn.connectorAttempts || 0),
-    skippedServedSettlements: settlementRoadConnectors.skippedServedSettlements || 0,
-    checkedSettlementCoverage: settlementRoadConnectors.checkedSettlementCoverage || 0,
-    externalRoadAnchors: externalRoadAnchors.length,
-    externalRailAnchors: externalRailAnchors.length,
-  };
-}
-
-function buildBoundarySegmentsFromField(world, fieldName, rect, options = {}) {
-  const field = world.fields[fieldName];
-  const sea = world.fields.sea;
-  const rects = options.rects || null;
-  const seed = options.seed || 0;
-  const minAlpha = Number.isFinite(options.minAlpha) ? options.minAlpha : 0;
-  if (!field) return [];
-  const out = [];
-  for (let y = rect.y0; y < rect.y1; y++) {
-    for (let x = rect.x0; x < rect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i < 0 || sea?.[i]) continue;
-      const id = field[i];
-      if (id < 0) continue;
-      const right = worldIndex(world, x + 1, y);
-      if (x + 1 < rect.x1 && right >= 0 && !sea?.[right] && field[right] >= 0 && field[right] !== id && continuitySegmentAllowed(x, y, x + 1, y, rects, seed, minAlpha)) {
-        out.push([[x + 0.5 - world.originX, y - world.originY], [x + 0.5 - world.originX, y + 1 - world.originY]]);
-      }
-      const down = worldIndex(world, x, y + 1);
-      if (y + 1 < rect.y1 && down >= 0 && !sea?.[down] && field[down] >= 0 && field[down] !== id && continuitySegmentAllowed(x, y, x, y + 1, rects, seed, minAlpha)) {
-        out.push([[x - world.originX, y + 0.5 - world.originY], [x + 1 - world.originX, y + 0.5 - world.originY]]);
-      }
-    }
-  }
-  return out;
-}
-
-function mergeCandidateCompartmentDebugSegments(world, sourceMap, candidate, rects, window, seed = 0) {
-  const debug = sourceMap.adminDebug || {};
-  debug.compartmentBorders ||= [];
-  let added = 0;
-  for (const seg of candidate?.adminDebug?.compartmentBorders || []) {
-    if (!Array.isArray(seg) || seg.length < 2) continue;
-    const a = worldCoordForSource(window, seg[0]?.[0], seg[0]?.[1]);
-    const b = worldCoordForSource(window, seg[1]?.[0], seg[1]?.[1]);
-    const mx = (a.x + b.x) * 0.5;
-    const my = (a.y + b.y) * 0.5;
-    if (!insideRect(mx, my, rects.writeRect) || patchAlpha(mx, my, rects, seed) < 0.08) continue;
-    debug.compartmentBorders.push(sourcePathFromWorld(world, [[a.x, a.y], [b.x, b.y]]));
-    added++;
-  }
-  sourceMap.adminDebug = debug;
-  return added;
-}
-
-function mergeSegmentLayers(world, sourceMap, rects, seed = 0) {
-  for (const key of SEGMENT_LAYER_KEYS) {
-    const oldArr = Array.isArray(sourceMap[key]) ? sourceMap[key] : [];
-    sourceMap[key] = oldArr.filter((seg) => !segmentTouchesPatch(world, seg, rects, seed, 0.34));
-  }
-  sourceMap.adminBorders ||= [];
-  sourceMap.adminBorders.push(...buildBoundarySegmentsFromField(world, "adminId", rects.writeRect, { rects, seed, minAlpha: 0.58 }));
-  sourceMap.regionalPrefectureBorders ||= [];
-  sourceMap.regionalPrefectureBorders.push(...buildBoundarySegmentsFromField(world, "prefectureRegionId", rects.writeRect, { rects, seed, minAlpha: 0.72 }));
-  sourceMap.prefectureBorder ||= [];
-
-  const debug = sourceMap.adminDebug || {};
-  // Use the legacy full-pipeline compartment debug segments for regenerated
-  // areas.  Rebuilding directly from the raster field made patch compartments
-  // look denser/smaller than the initial map.  Candidate segments are merged
-  // just after this function.
-  debug.compartmentBorders = (debug.compartmentBorders || []).filter((seg) => !segmentTouchesPatch(world, seg, rects, seed, 0.34));
-  sourceMap.adminDebug = debug;
-  return {
-    adminBordersRebuilt: sourceMap.adminBorders.length,
-    prefectureBordersRebuilt: sourceMap.regionalPrefectureBorders.length,
-    compartmentBordersRebuilt: debug.compartmentBorders.length,
-  };
-}
-
-function repairLanduseAndPopulation(world, rects) {
-  const landuse = world.fields.landuse;
-  if (!landuse) return { landUseCellsUpdated: 0 };
-  let updated = 0;
-  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
-    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i < 0) continue;
-      if (world.fields.sea?.[i]) {
-        if (landuse[i] !== (LANDUSE.WATER || 0)) updated++;
-        landuse[i] = LANDUSE.WATER || 0;
-        continue;
-      }
-      if (landuse[i] === (LANDUSE.WATER || 0)) {
-        const slope = world.fields.slope?.[i] || 0;
-        const ag = world.fields.agriculture?.[i] || 0;
-        landuse[i] = slope > 0.42 ? LANDUSE.FOREST : ag > 0.28 ? LANDUSE.FARMLAND : LANDUSE.RURAL;
-        updated++;
-      }
-    }
-  }
-  return { landUseCellsUpdated: updated };
-}
-
-function ensureWorldFloatField(world, name) {
-  const expected = world.width * world.height;
-  if (!world.fields[name] || world.fields[name].length !== expected) world.fields[name] = new Float32Array(expected);
-  return world.fields[name];
-}
-
-function clearFieldRect(world, field, rect) {
-  for (let y = rect.y0; y < rect.y1; y++) {
-    for (let x = rect.x0; x < rect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i >= 0) field[i] = 0;
-    }
-  }
-}
-
-function paintInfluenceDisk(world, field, cx, cy, radius, strength, rect) {
-  const sea = world.fields.sea;
-  const r = Math.max(1, Math.ceil(radius));
-  for (let dy = -r; dy <= r; dy++) {
-    for (let dx = -r; dx <= r; dx++) {
-      if (dx * dx + dy * dy > radius * radius) continue;
-      const x = Math.round(cx + dx);
-      const y = Math.round(cy + dy);
-      if (!insideRect(x, y, rect)) continue;
-      const i = worldIndex(world, x, y);
-      if (i < 0 || sea?.[i]) continue;
-      const d = Math.hypot(dx, dy);
-      const value = strength * Math.pow(1 - d / Math.max(1, radius), 1.35);
-      if (value > field[i]) field[i] = clamp(value);
-    }
-  }
-}
-
-function refreshPatchInfluenceFields(world, sourceMap, rects) {
-  const rect = rects.repairRect || rects.writeRect;
-  const roadInfluence = ensureWorldFloatField(world, "roadInfluence");
-  const railInfluence2 = ensureWorldFloatField(world, "railInfluence2");
-  const stationInfluence = ensureWorldFloatField(world, "stationInfluence");
-  const villageInfluence = ensureWorldFloatField(world, "villageInfluence");
-  for (const field of [roadInfluence, railInfluence2, stationInfluence, villageInfluence]) clearFieldRect(world, field, rect);
-
-  let roadCellsPainted = 0;
-  let railCellsPainted = 0;
-  let stationCellsPainted = 0;
-  let villageCellsPainted = 0;
-  const paintPathLayer = (keys, field, radius, strength, counterName) => {
-    let painted = 0;
-    for (const key of keys) {
-      for (const path of sourceMap[key] || []) {
-        for (const tuple of path || []) {
-          const x = tupleWorldX(world, tuple);
-          const y = tupleWorldY(world, tuple);
-          if (rectDistance(x, y, rect) > radius + 1) continue;
-          paintInfluenceDisk(world, field, x, y, radius, strength, rect);
-          painted++;
-        }
-      }
-    }
-    if (counterName === "road") roadCellsPainted += painted;
-    if (counterName === "rail") railCellsPainted += painted;
-  };
-
-  paintPathLayer(["nationalRoads", "ringRoads", "externalRoads", "minorRoads", "premodernRoads", "icAccessRoads"], roadInfluence, 5, 1, "road");
-  paintPathLayer(["railways", "branchRailways", "ringRailways", "externalRailways"], railInfluence2, 4, 1, "rail");
-
-  for (const p of sourceMap.stations || []) {
-    const x = pointWorldX(world, p);
-    const y = pointWorldY(world, p);
-    if (rectDistance(x, y, rect) > 8) continue;
-    paintInfluenceDisk(world, stationInfluence, x, y, 5, clamp(p.score || 1), rect);
-    stationCellsPainted++;
-  }
-  for (const p of sourceMap.villages || []) {
-    const x = pointWorldX(world, p);
-    const y = pointWorldY(world, p);
-    if (rectDistance(x, y, rect) > 10) continue;
-    paintInfluenceDisk(world, villageInfluence, x, y, 6, clamp((p.population || 1800) / 4200, 0.35, 1.2), rect);
-    villageCellsPainted++;
-  }
-
-  return { roadCellsPainted, railCellsPainted, stationCellsPainted, villageCellsPainted };
-}
-
-function countSea(world, rect) {
-  let seaCount = 0;
-  let total = 0;
-  for (let y = rect.y0; y < rect.y1; y++) {
-    for (let x = rect.x0; x < rect.x1; x++) {
-      const i = worldIndex(world, x, y);
-      if (i < 0) continue;
-      total++;
-      if (world.fields.sea?.[i]) seaCount++;
-    }
-  }
-  return { seaCount, total, seaRatio: total ? seaCount / total : 0 };
-}
-
-function terrainLabel(candidate, fallback) {
-  return candidate?.terrainTemplate?.terrainTypeLabel || candidate?.terrainDebug?.terrainTypeLabel || fallback;
-}
-
-function terrainId(candidate, fallback) {
-  return candidate?.terrainTemplate?.terrainType || candidate?.terrainDebug?.terrainType || fallback;
-}
-
-function rectKey(rect) {
-  return rect ? `${rect.x0},${rect.y0},${rect.x1},${rect.y1}` : "-";
-}
-
-function patchCandidateCacheKey({ seed, terrainType, variant, candidateOriginX, candidateOriginY, contextRect, serial = 0 }) {
-  return [serial, seed >>> 0, terrainType || "auto", variant >>> 0, candidateOriginX | 0, candidateOriginY | 0, rectKey(contextRect)].join("|");
-}
-
-function getPatchCandidateCache(world) {
-  if (!world.patchCandidateCache) world.patchCandidateCache = new Map();
-  return world.patchCandidateCache;
-}
-
-function rememberPatchCandidate(world, key, candidate) {
-  const cache = getPatchCandidateCache(world);
-  if (cache.has(key)) cache.delete(key);
-  cache.set(key, candidate);
-  while (cache.size > PATCH_CANDIDATE_CACHE_LIMIT) cache.delete(cache.keys().next().value);
-}
-
-function getOrGeneratePatchCandidate(world, key, create) {
-  const cache = getPatchCandidateCache(world);
-  if (cache.has(key)) {
-    const candidate = cache.get(key);
-    cache.delete(key);
-    cache.set(key, candidate);
-    return { candidate, cacheHit: true, cacheSize: cache.size };
-  }
-  const candidate = create();
-  rememberPatchCandidate(world, key, candidate);
-  return { candidate, cacheHit: false, cacheSize: getPatchCandidateCache(world).size };
-}
-
-export function generatePatch(world, userRectInput, options = {}) {
-  const validation = validatePatchRect(userRectInput, world);
-  if (!validation.ok) return { ok: false, ...validation };
-
-  const rects = buildPatchRects(validation.rect, world);
-  const terrainType = options.terrainType || "auto";
-  const seed = Number.isFinite(options.seed) ? options.seed >>> 0 : ((world?.seed || 0) + 1013904223) >>> 0;
-  const variant = Number.isFinite(options.variant) ? Math.max(0, Math.floor(options.variant)) >>> 0 : 0;
-  const candidateWindow = sourceWindowForRects(rects);
-  const candidateOriginX = Math.round(candidateWindow.worldCenterX - candidateWindow.sourceCenterX);
-  const candidateOriginY = Math.round(candidateWindow.worldCenterY - candidateWindow.sourceCenterY);
-  const patchTimer = createPatchTimer();
-  const patchGenerationMode = "legacy-full-pipeline";
-  const cacheKey = patchCandidateCacheKey({
-    seed,
-    terrainType,
-    variant,
-    candidateOriginX,
-    candidateOriginY,
-    contextRect: rects.contextRect,
-    serial: world.patchGenerationSerial || 0,
-  });
-  const { candidate, cacheHit, cacheSize } = getOrGeneratePatchCandidate(world, cacheKey, () => generateMap(seed, {
-      terrainType,
-      legacyTerrain: true,
-      worldNative: true,
-      variant,
-      originX: candidateOriginX,
-      originY: candidateOriginY,
-      width: MAP_W,
-      height: MAP_H,
-      contextRect: rects.contextRect,
-      boundaryWorld: world,
-      onProgress: () => {},
-    }));
-  patchTimer.mark("candidate", cacheHit ? "Full candidate generation (cached)" : "Full candidate generation");
-  getPatchAlphaCache(rects, seed);
-  getPatchSourceIndexCache(rects, candidateWindow);
-  const sourceMap = world.sourceMap || (world.sourceMap = {});
-  const logisticsLabelsMigrated = sanitizeExistingLogistics(sourceMap);
-
-  const fieldDebug = copyFullPipelineFields(world, candidate, rects, seed);
-  patchTimer.mark("fields", "Field copy and alpha blend");
-  const terrainSeamDebug = featherTerrainSeam(world, rects, seed);
-  const waterDebug = smoothWaterTopology(world, rects.writeRect, candidate.seaLevel || world.sourceMap?.seaLevel || 0.30, rects, seed);
-  const maskDebug = repairDisplayMasks(world, rects, seed);
-  recomputeSlopeAndWaterDependentFields(world, rects.repairRect, candidate.seaLevel || world.sourceMap?.seaLevel || 0.30);
-  patchTimer.mark("terrainRepair", "Water, masks, and terrain repair");
-  const pointDebug = mergePointLayers(world, sourceMap, candidate, rects, fieldDebug.window, seed, fieldDebug.adminIdMapping);
-  patchTimer.mark("points", "Point merge");
-  const pathDebug = mergePathLayers(world, sourceMap, candidate, rects, fieldDebug.window, seed);
-  patchTimer.mark("paths", "Path merge and connector repair");
-  const influenceDebug = refreshPatchInfluenceFields(world, sourceMap, rects);
-  patchTimer.mark("influence", "Influence refresh");
-  const landDebug = repairLanduseAndPopulation(world, rects);
-  const finalAdminCoverageDebug = repairAdminCoverage(world, sourceMap, rects, fieldDebug.adminIdMapping, seed);
-  const sourceAdminMetadataUpdated = updateSourceAdminMetadata(sourceMap, fieldDebug.adminIdMapping);
-  const municipalCoherence = reconcileMunicipalMetadata({
-    adminId: world.fields.adminId,
-    municipalityId: world.fields.municipalityId,
-    prefectureRegionId: world.fields.prefectureRegionId,
-    sea: world.fields.sea,
-    adminCenters: sourceMap.adminCenters || [],
-    municipalityToPrefectureId: sourceMap.municipalityToPrefectureId,
-    fields: world.fields,
-    width: world.width,
-    height: world.height,
-    pointOffsetX: world.originX || 0,
-    pointOffsetY: world.originY || 0,
-    seed,
-  });
-  sourceMap.adminCenters = municipalCoherence.adminCenters;
-  sourceMap.municipalityToPrefectureId = municipalCoherence.municipalityToPrefectureId;
-  const prefectureCoherence = refreshPrefectureRegionsMetadata({
-    prefectureRegionId: world.fields.prefectureRegionId,
-    sea: world.fields.sea,
-    existing: sourceMap.prefectureRegions || [],
-    fields: world.fields,
-    width: world.width,
-    height: world.height,
-    pointOffsetX: world.originX || 0,
-    pointOffsetY: world.originY || 0,
-  });
-  sourceMap.prefectureRegions = prefectureCoherence.prefectureRegions;
-  sourceMap.adminDebug = {
-    ...(sourceMap.adminDebug || {}),
-    municipalCoherence: municipalCoherence.debug,
-    prefectureMetadataCoherence: prefectureCoherence.debug,
-  };
-  const segmentDebug = mergeSegmentLayers(world, sourceMap, rects, seed);
-  const candidateCompartmentSegmentsAdded = mergeCandidateCompartmentDebugSegments(world, sourceMap, candidate, rects, fieldDebug.window, seed);
-  patchTimer.mark("segments", "Boundary and debug segment merge");
-  sanitizeExistingLogistics(sourceMap);
-  patchTimer.mark("cleanup", "Land-use, admin, and label cleanup");
-  const patchTimings = patchTimer.timings;
-
-  const seaStats = countSea(world, rects.coreRect);
-  const label = terrainLabel(candidate, terrainType);
-  const id = terrainId(candidate, terrainType);
-  const humanGeography = {
-    ok: true,
-    modernCities: (sourceMap.modernCities || []).filter((p) => insideRect(pointWorldX(world, p), pointWorldY(world, p), rects.writeRect)).length,
-    ports: (sourceMap.ports || []).filter((p) => insideRect(pointWorldX(world, p), pointWorldY(world, p), rects.writeRect)).length,
-    villages: (sourceMap.villages || []).filter((p) => insideRect(pointWorldX(world, p), pointWorldY(world, p), rects.writeRect)).length,
-    ...pointDebug,
-    ...pathDebug,
-    ...influenceDebug,
-    adminCellsReassigned: fieldDebug.adminCellsReassigned,
-    adminIdMapping: fieldDebug.adminIdMappingDebug,
-    sourceAdminMetadataUpdated,
-    ...finalAdminCoverageDebug,
-    finalSeaAdminCellsCleared: finalAdminCoverageDebug.seaAdminCellsCleared || 0,
-    finalLandAdminCellsFilled: finalAdminCoverageDebug.landAdminCellsFilled || 0,
-    finalPrefectureCellsFilled: finalAdminCoverageDebug.prefectureCellsFilled || 0,
-    finalAdminPrefectureCellsAligned: finalAdminCoverageDebug.adminPrefectureCellsAligned || 0,
-    municipalCoherence: municipalCoherence.debug,
-    prefectureMetadataCoherence: prefectureCoherence.debug,
-    continuityCellsRestored: fieldDebug.continuityCellsRestored || 0,
-    continuityCellsRemapped: fieldDebug.continuityCellsRemapped || 0,
-    adminSeamCellsResolved: fieldDebug.adminSeamCellsResolved || 0,
-    prefectureSeamCellsResolved: fieldDebug.prefectureSeamCellsResolved || 0,
-    ...terrainSeamDebug,
-    landUseCellsUpdated: fieldDebug.landUseCellsUpdated + landDebug.landUseCellsUpdated,
-    displayMaskUpdated: maskDebug.displayMaskUpdated || 0,
-    logisticsLabelsMigrated,
-    candidateCacheHit: cacheHit,
-    candidateCacheSize: cacheSize,
-    ...segmentDebug,
-    candidateCompartmentSegmentsAdded,
-  };
-
-  const record = {
-    ...rects.coreRect,
-    coreRect: { ...rects.coreRect },
-    selectionShape: rects.selectionShape ? {
-      kind: rects.selectionShape.kind || 'lasso',
-      areaCells: rects.selectionShape.areaCells || 0,
-      polygon: rects.selectionShape.polygon.map((p) => ({ x: p.x, y: p.y })),
-    } : null,
-    writeRect: { ...rects.writeRect },
-    repairRect: { ...rects.repairRect },
-    contextRect: { ...rects.contextRect },
-    blendRect: { ...rects.blendRect },
-    terrainType: id,
-    label,
-    seed,
-    variant,
-    candidateOriginX,
-    candidateOriginY,
-    patchGenerationMode,
-    patchTimings,
-    updatedCells: fieldDebug.updatedCells,
-    terrainCellsFullyReplaced: fieldDebug.terrainCellsFullyReplaced,
-    coastCellsChanged: fieldDebug.coastCellsChanged + waterDebug.coastCellsChanged,
-    naturalRegionsUpdated: fieldDebug.naturalRegionsUpdated,
-    naturalRegionFragmentsMerged: 0,
-    adminIdMapping: fieldDebug.adminIdMappingDebug,
-    seaRatio: seaStats.seaRatio,
-    humanGeography,
-    createdAt: Date.now(),
-  };
-  world.generatedRects = [...(world.generatedRects || []), record];
-  world.invalidatedRects = [...(world.invalidatedRects || []), { ...rects.writeRect }];
-  world.lastPatchResult = record;
-  world.patchGenerationSerial = (world.patchGenerationSerial || 0) + 1;
-
-  return {
-    ok: true,
-    validation,
-    rects: {
-      ...rects,
-      selectionShape: rects.selectionShape ? {
-        kind: rects.selectionShape.kind || 'lasso',
-        areaCells: rects.selectionShape.areaCells || 0,
-        polygon: rects.selectionShape.polygon.map((p) => ({ x: p.x, y: p.y })),
-      } : null,
-    },
-    terrainType: id,
-    label,
-    seed,
-    variant,
-    candidateOriginX,
-    candidateOriginY,
-    patchGenerationMode,
-    patchTimings,
-    updatedCells: record.updatedCells,
-    terrainCellsFullyReplaced: record.terrainCellsFullyReplaced,
-    coastCellsChanged: record.coastCellsChanged,
-    naturalRegionsUpdated: record.naturalRegionsUpdated,
-    naturalRegionFragmentsMerged: 0,
-    adminIdMapping: fieldDebug.adminIdMappingDebug,
-    seaRatio: seaStats.seaRatio,
-    humanGeography,
-  };
-}
diff --git a/scripts/router.php b/scripts/router.php
new file mode 100644
index 0000000..d0b4814
--- /dev/null
+++ b/scripts/router.php
@@ -0,0 +1,25 @@
+<?php
+declare(strict_types=1);
+
+// Router for PHP's built-in development server. Apache protects the legacy
+// directory with .htaccess, but the built-in server ignores it completely.
+$uri = rawurldecode((string)(parse_url((string)($_SERVER['REQUEST_URI'] ?? '/'), PHP_URL_PATH) ?: '/'));
+$segments = array_values(array_filter(explode('/', str_replace('\\', '/', $uri)), static fn(string $part): bool => $part !== ''));
+foreach ($segments as $segment) {
+    if (str_starts_with($segment, '.')) {
+        http_response_code(404);
+        header('Content-Type: text/plain; charset=utf-8');
+        echo "Not found\n";
+        return true;
+    }
+}
+
+$projectRoot = dirname(__DIR__);
+$relative = ltrim($uri, '/');
+$candidate = $projectRoot . ($relative === '' ? DIRECTORY_SEPARATOR . 'index.html' : DIRECTORY_SEPARATOR . $relative);
+if (is_file($candidate)) return false;
+
+http_response_code(404);
+header('Content-Type: text/plain; charset=utf-8');
+echo "Not found\n";
+return true;
diff --git a/scripts/start_server.bat b/scripts/start_server.bat
new file mode 100644
index 0000000..f3a9954
--- /dev/null
+++ b/scripts/start_server.bat
@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set PORT=%~1
+if "%PORT%"=="" set PORT=8000
+for %%I in ("%~dp0..") do set "ROOT=%%~fI"
+cd /d "%ROOT%"
+php -S 127.0.0.1:%PORT% -t "%ROOT%" "%~dp0router.php"
diff --git a/scripts/start_server.sh b/scripts/start_server.sh
new file mode 100644
index 0000000..7f9d96e
--- /dev/null
+++ b/scripts/start_server.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+set -eu
+PORT="${1:-8000}"
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+PROJECT_ROOT=$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd)
+exec php -S "127.0.0.1:${PORT}" -t "$PROJECT_ROOT" "$SCRIPT_DIR/router.php"
diff --git a/adminRegions.js b/src/adminRegions.js
similarity index 100%
rename from adminRegions.js
rename to src/adminRegions.js
diff --git a/adminRegionsCore.js b/src/adminRegionsCore.js
similarity index 60%
rename from adminRegionsCore.js
rename to src/adminRegionsCore.js
index 2dd8ebc..372d40b 100644
--- a/adminRegionsCore.js
+++ b/src/adminRegionsCore.js
@@ -1,316 +1,13 @@
-import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, indexOf, inside, weightedScore, xyOf } from "./mapUtils.js";
-
-function neighbors8(x, y) {
-  const out = [];
-  for (let dy = -1; dy <= 1; dy++) {
-    for (let dx = -1; dx <= 1; dx++) {
-      if (dx === 0 && dy === 0) continue;
-      const nx = x + dx;
-      const ny = y + dy;
-      if (inside(nx, ny)) out.push([nx, ny, Math.hypot(dx, dy)]);
-    }
-  }
-  return out;
-}
-
-function neighbors4(x, y) {
-  const out = [];
-  for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]]) {
-    const nx = x + dx;
-    const ny = y + dy;
-    if (inside(nx, ny)) out.push([nx, ny, 1]);
-  }
-  return out;
-}
-
-export function generateAdminRegions(centers, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, populationDensity, landuse) {
-  const adminId = new Int16Array(SIZE);
-  adminId.fill(-1);
-  const dist = new Float32Array(SIZE);
-  dist.fill(INF);
-  const heap = new MinHeap();
-
-  centers.forEach((center, regionId) => {
-    const i = indexOf(center.x, center.y);
-    dist[i] = 0;
-    adminId[i] = regionId;
-    heap.push({ i, f: 0, regionId });
-  });
-
-  let guard = 0;
-  while (heap.length > 0 && guard++ < SIZE * 12) {
-    const current = heap.pop();
-    if (!current) continue;
-    const curIndex = current.i;
-    const curRegion = adminId[curIndex];
-    if (curRegion < 0 || current.f > dist[curIndex] + 1e-5) continue;
-
-    const [cx, cy] = xyOf(curIndex);
-    for (const [nx, ny, step] of neighbors8(cx, cy)) {
-      const ni = indexOf(nx, ny);
-      if (!prefectureMask[ni] || sea[ni]) continue;
-
-      const ridgeBarrier = Math.max(ridgeField[ni], ridgeField[curIndex]);
-      const riverBarrier = Math.max(river[ni], river[curIndex]);
-      const highDivide = Math.max(elevation[ni], elevation[curIndex]);
-      const watershedBarrier = ridgeBarrier * (27.0 + Math.max(0, highDivide - 0.46) * 46.0);
-      const ridgePenalty = Math.max(0, highDivide - 0.36) * 16.0 + Math.abs(elevation[ni] - elevation[curIndex]) * 12.4 + watershedBarrier;
-      const slopePenalty = slope[ni] * 10.6;
-      const valleyBarrier = valleyField[ni] > 0.50 ? valleyField[ni] * (riverBarrier > 0.16 ? 7.2 : 2.6) : 0;
-      const riverPenalty = riverBarrier > 0.7 ? 22.0 : riverBarrier > 0.42 ? 14.8 : riverBarrier > 0.22 ? 7.4 : riverBarrier > 0.12 ? 2.2 : 0;
-      const urbanContinuityBonus = (landuse[ni] >= 2 && landuse[ni] <= 4 && populationDensity[ni] > 0.20) ? 1.65 : 0;
-      const valleyLocalityBonus = valleyField[ni] * 0.16;
-      const stepCost = Math.max(0.25, 0.72 + ridgePenalty + slopePenalty + riverPenalty + valleyBarrier - valleyLocalityBonus - urbanContinuityBonus) * step;
-      const nextDist = dist[curIndex] + stepCost;
-
-      if (nextDist < dist[ni]) {
-        dist[ni] = nextDist;
-        adminId[ni] = curRegion;
-        heap.push({ i: ni, f: nextDist, regionId: curRegion });
-      }
-    }
-  }
-
-  return adminId;
-}
-
-function terrainBoundaryStrength(i, elevation, slope, river, ridgeField, valleyField) {
-  return clamp(weightedScore([
-    [ridgeField[i], 3.15],
-    [river[i], 2.45],
-    [valleyField[i], 0.62],
-    [slope[i], 1.06],
-    [Math.max(0, elevation[i] - 0.5), 1.18],
-  ]));
-}
-
-export function smoothAdminRegionsTerrainAware(adminId, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, populationDensity, landuse, passes = 5) {
-  let current = new Int16Array(adminId);
-  for (let pass = 0; pass < passes; pass++) {
-    const next = new Int16Array(current);
-    for (let y = 1; y < MAP_H - 1; y++) {
-      for (let x = 1; x < MAP_W - 1; x++) {
-        const i = indexOf(x, y);
-        const own = current[i];
-        if (!prefectureMask[i] || sea[i] || own < 0) continue;
-        const urbanCell = (landuse[i] >= 2 && landuse[i] <= 4) || landuse[i] === 7 || populationDensity[i] > 0.24;
-        const barrier = terrainBoundaryStrength(i, elevation, slope, river, ridgeField, valleyField);
-        if (barrier > 0.62 || urbanCell) continue;
-
-        const counts = new Map();
-        let ownCount = 0;
-        for (const [nx, ny] of neighbors4(x, y)) {
-          const ni = indexOf(nx, ny);
-          if (!prefectureMask[ni] || sea[ni]) continue;
-          const id = current[ni];
-          if (id < 0) continue;
-          const weight = terrainBoundaryStrength(ni, elevation, slope, river, ridgeField, valleyField) > 0.72 ? 0.45 : 1;
-          counts.set(id, (counts.get(id) || 0) + weight);
-          if (id === own) ownCount += weight;
-        }
-        let bestId = own;
-        let best = ownCount;
-        for (const [id, score] of counts) if (score > best) { best = score; bestId = id; }
-        if (bestId !== own && (best >= 4.2 || ownCount <= 2.1)) next[i] = bestId;
-      }
-    }
-    current = next;
-  }
-  adminId.set(current);
-}
-
-export function lockSmallUrbanComponentsToMunicipality(adminId, prefectureMask, sea, landuse, populationDensity, maxCells = 360) {
-  const seen = new Uint8Array(SIZE);
-  const queue = [];
-  for (let i = 0; i < SIZE; i++) {
-    if (seen[i] || !prefectureMask[i] || sea[i]) continue;
-    const isUrbanStart = (landuse[i] >= 2 && landuse[i] <= 4) || landuse[i] === 7 || landuse[i] === 8 || populationDensity[i] > 0.20;
-    if (!isUrbanStart) continue;
-    const component = [];
-    queue.length = 0;
-    queue.push(i);
-    seen[i] = 1;
-    for (let q = 0; q < queue.length; q++) {
-      const cur = queue[q];
-      component.push(cur);
-      const [x, y] = xyOf(cur);
-      for (const [nx, ny] of neighbors8(x, y)) {
-        const ni = indexOf(nx, ny);
-        if (seen[ni] || !prefectureMask[ni] || sea[ni]) continue;
-        const isUrban = (landuse[ni] >= 2 && landuse[ni] <= 4) || landuse[ni] === 7 || landuse[ni] === 8 || populationDensity[ni] > 0.20;
-        if (!isUrban) continue;
-        seen[ni] = 1;
-        queue.push(ni);
-      }
-    }
-    if (component.length === 0 || component.length > maxCells) continue;
-    const counts = new Map();
-    for (const ci of component) {
-      const id = adminId[ci];
-      if (id >= 0) counts.set(id, (counts.get(id) || 0) + 1 + populationDensity[ci]);
-    }
-    let bestId = -1;
-    let best = -1;
-    for (const [id, score] of counts) if (score > best) { best = score; bestId = id; }
-    if (bestId >= 0) for (const ci of component) adminId[ci] = bestId;
-  }
-}
-
-export function mergeTinyMunicipalities(adminId, prefectureMask, sea, populationDensity, modernCities = [], minArea = 320, options = {}) {
-  const area = new Map();
-  const pop = new Map();
-  const adjacency = new Map();
-  const cityMunicipalities = new Set();
-  for (const city of modernCities || []) {
-    if (!inside(city.x, city.y)) continue;
-    const id = adminId[indexOf(city.x, city.y)];
-    if (id < 0) continue;
-    if (options.protectAllModernCities !== false || city.isPrefecturalCapital || (city.population || 0) >= (options.majorCityPopulationThreshold || 120000)) cityMunicipalities.add(id);
-  }
-  for (const point of options.protectedPoints || []) {
-    if (!point || !inside(point.x, point.y)) continue;
-    const id = adminId[indexOf(point.x, point.y)];
-    if (id >= 0) cityMunicipalities.add(id);
-  }
-  const satelliteByAdmin = new Map();
-  for (const sat of options.satelliteCities || []) {
-    if (!sat || !inside(sat.x, sat.y)) continue;
-    const id = adminId[indexOf(sat.x, sat.y)];
-    if (id < 0) continue;
-    if (!satelliteByAdmin.has(id)) satelliteByAdmin.set(id, []);
-    satelliteByAdmin.get(id).push(sat);
-  }
-  const satelliteStats = options.satelliteStats || null;
-
-  for (let y = 0; y < MAP_H; y++) {
-    for (let x = 0; x < MAP_W; x++) {
-      const i = indexOf(x, y);
-      if (!prefectureMask[i] || sea[i]) continue;
-      const id = adminId[i];
-      if (id < 0) continue;
-      area.set(id, (area.get(id) || 0) + 1);
-      pop.set(id, (pop.get(id) || 0) + populationDensity[i]);
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        if (!inside(nx, ny)) continue;
-        const ni = indexOf(nx, ny);
-        if (!prefectureMask[ni] || sea[ni]) continue;
-        const other = adminId[ni];
-        if (other < 0 || other === id) continue;
-        const key = id < other ? `${id}:${other}` : `${other}:${id}`;
-        adjacency.set(key, (adjacency.get(key) || 0) + 1);
-      }
-    }
-  }
-
-  const mergeTarget = new Map();
-  for (const [id, cells] of area) {
-    const score = cells + (pop.get(id) || 0) * 16;
-    if (cells >= minArea || cityMunicipalities.has(id)) continue;
-    const satellites = satelliteByAdmin.get(id) || [];
-    const protectedSatellite = satellites.some((sat) => {
-      const minSatelliteArea = sat.satelliteMinArea || options.satelliteMinArea || 110;
-      return sat.municipalityClass === "independentSatelliteMunicipality" && (
-        cells >= minSatelliteArea ||
-        (sat.population || 0) >= (options.satelliteIndependentPopulationThreshold || 60000) ||
-        (sat.distinctUrbanComponentArea || 0) >= 80 ||
-        sat.separatedByBarrier
-      );
-    });
-    if (protectedSatellite) continue;
-    let bestNeighbor = -1;
-    let bestScore = -1;
-    for (const [key, border] of adjacency) {
-      const [a, b] = key.split(":").map(Number);
-      if (a !== id && b !== id) continue;
-      const other = a === id ? b : a;
-      const parentBias = satellites.some((sat) => inside(sat.parentX ?? -1, sat.parentY ?? -1) && adminId[indexOf(sat.parentX, sat.parentY)] === other) ? 26 : 0;
-      const ruralBias = satellites.some((sat) => sat.municipalityClass === "smallTownAttachedToRuralMunicipality") ? Math.min(12, (area.get(other) || 0) * 0.01) : 0;
-      const candidate = border * 3 + (area.get(other) || 0) * 0.012 + (pop.get(other) || 0) * 0.24 + parentBias + ruralBias;
-      if (candidate > bestScore) { bestScore = candidate; bestNeighbor = other; }
-    }
-    if (bestNeighbor >= 0 && (area.get(bestNeighbor) || 0) >= score * 0.35) {
-      mergeTarget.set(id, bestNeighbor);
-      if (satelliteStats && satellites.length) {
-        satelliteStats.satelliteMunicipalitiesMerged += satellites.length;
-        for (const sat of satellites) sat.mergedMunicipalityTarget = bestNeighbor;
-      }
-    }
-  }
-  if (mergeTarget.size === 0) return;
-  for (let i = 0; i < SIZE; i++) if (mergeTarget.has(adminId[i])) adminId[i] = mergeTarget.get(adminId[i]);
-}
-
-export function removeMunicipalExclaves(adminId, prefectureMask, sea, adminCenters = [], protectedPoints = [], maxIslandCells = 220) {
-  const protectedByAdmin = new Map();
-  for (const p of [...adminCenters, ...protectedPoints]) {
-    if (!p || !inside(p.x, p.y)) continue;
-    const id = adminId[indexOf(p.x, p.y)];
-    if (id < 0) continue;
-    if (!protectedByAdmin.has(id)) protectedByAdmin.set(id, new Set());
-    protectedByAdmin.get(id).add(indexOf(p.x, p.y));
-  }
-
-  const ids = new Set();
-  for (let i = 0; i < SIZE; i++) if (prefectureMask[i] && !sea[i] && adminId[i] >= 0) ids.add(adminId[i]);
-
-  const globalSeen = new Uint8Array(SIZE);
-  const queue = [];
-  for (const id of ids) {
-    const components = [];
-    for (let i = 0; i < SIZE; i++) {
-      if (globalSeen[i] || adminId[i] !== id || !prefectureMask[i] || sea[i]) continue;
-      const comp = [];
-      let hasProtected = protectedByAdmin.get(id)?.has(i) || false;
-      queue.length = 0;
-      queue.push(i);
-      globalSeen[i] = 1;
-      for (let q = 0; q < queue.length; q++) {
-        const cur = queue[q];
-        comp.push(cur);
-        if (protectedByAdmin.get(id)?.has(cur)) hasProtected = true;
-        const [x, y] = xyOf(cur);
-        for (const [nx, ny] of neighbors4(x, y)) {
-          const ni = indexOf(nx, ny);
-          if (globalSeen[ni] || adminId[ni] !== id || !prefectureMask[ni] || sea[ni]) continue;
-          globalSeen[ni] = 1;
-          queue.push(ni);
-        }
-      }
-      components.push({ cells: comp, hasProtected });
-    }
-    if (components.length <= 1) continue;
-    components.sort((a, b) => (b.hasProtected ? 1000000 : 0) + b.cells.length - ((a.hasProtected ? 1000000 : 0) + a.cells.length));
-    for (const component of components.slice(1)) {
-      const mainSize = components[0].cells.length;
-      if (component.hasProtected && component.cells.length > maxIslandCells && component.cells.length > mainSize * 0.42) continue;
-      if (component.cells.length > maxIslandCells && component.cells.length > mainSize * 0.36) continue;
-      const counts = new Map();
-      for (const ci of component.cells) {
-        const [x, y] = xyOf(ci);
-        for (const [nx, ny] of neighbors4(x, y)) {
-          const ni = indexOf(nx, ny);
-          if (!prefectureMask[ni] || sea[ni]) continue;
-          const other = adminId[ni];
-          if (other >= 0 && other !== id) counts.set(other, (counts.get(other) || 0) + 1);
-        }
-      }
-      let target = -1;
-      let best = -1;
-      for (const [other, count] of counts) if (count > best) { best = count; target = other; }
-      if (target >= 0) for (const ci of component.cells) adminId[ci] = target;
-    }
-  }
-}
-
+import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, indexOf, inside, xyOf } from "./mapUtils.js";
+import { neighbors4, neighbors8 } from "./mapGeneratorHelpers.js";
+import { averageFieldAcrossOwnerBorders } from "./mapAdminShared.js";
 
 export function enforceMunicipalityConnectivityStrict(adminId, prefectureMask, sea, adminCenters = [], protectedPoints = [], maxPasses = 6) {
   // Final cell-level invariant: each municipality should be one contiguous land
-  // component.  Earlier stages are allowed to leave sizeable satellite pieces
-  // while boundaries are still being snapped; this pass removes the remaining
-  // visual exclaves by attaching every non-primary component to the neighboring
-  // municipality with the largest shared boundary.  A component that contains a
-  // protected point may become the primary component, but it no longer protects
-  // additional detached pieces.
+  // component. Build every municipality's components in one map scan per pass.
+  // The previous implementation rescanned all SIZE cells separately for every
+  // municipality ID, so a candidate with many small municipalities could turn a
+  // normally sub-second cleanup into minutes during large tiled expansion.
   const protectedByAdmin = new Map();
   for (const p of [...(adminCenters || []), ...(protectedPoints || [])]) {
     if (!p || !inside(p.x, p.y)) continue;
@@ -324,33 +21,38 @@ export function enforceMunicipalityConnectivityStrict(adminId, prefectureMask, s
   let changed = 0;
   const queue = [];
   for (let pass = 0; pass < maxPasses; pass++) {
-    let passChanged = 0;
-    const ids = new Set();
-    for (let i = 0; i < SIZE; i++) if (prefectureMask[i] && !sea[i] && adminId[i] >= 0) ids.add(adminId[i]);
-    for (const id of ids) {
-      const seen = new Uint8Array(SIZE);
-      const components = [];
-      for (let i = 0; i < SIZE; i++) {
-        if (seen[i] || adminId[i] !== id || !prefectureMask[i] || sea[i]) continue;
-        const comp = [];
-        let protectedHits = 0;
-        queue.length = 0;
-        queue.push(i);
-        seen[i] = 1;
-        for (let q = 0; q < queue.length; q++) {
-          const cur = queue[q];
-          comp.push(cur);
-          if (protectedByAdmin.get(id)?.has(cur)) protectedHits++;
-          const [x, y] = xyOf(cur);
-          for (const [nx, ny] of neighbors4(x, y)) {
-            const ni = indexOf(nx, ny);
-            if (seen[ni] || adminId[ni] !== id || !prefectureMask[ni] || sea[ni]) continue;
-            seen[ni] = 1;
-            queue.push(ni);
-          }
+    const seen = new Uint8Array(SIZE);
+    const componentsByAdmin = new Map();
+
+    // One connected-component traversal over the complete land mask. Each cell
+    // is visited at most once in this phase, regardless of municipality count.
+    for (let i = 0; i < SIZE; i++) {
+      if (seen[i] || !prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
+      const id = adminId[i];
+      const cells = [];
+      let protectedHits = 0;
+      queue.length = 0;
+      queue.push(i);
+      seen[i] = 1;
+      for (let q = 0; q < queue.length; q++) {
+        const cur = queue[q];
+        cells.push(cur);
+        if (protectedByAdmin.get(id)?.has(cur)) protectedHits++;
+        const [x, y] = xyOf(cur);
+        for (const [nx, ny] of neighbors4(x, y)) {
+          const ni = indexOf(nx, ny);
+          if (seen[ni] || adminId[ni] !== id || !prefectureMask[ni] || sea[ni]) continue;
+          seen[ni] = 1;
+          queue.push(ni);
         }
-        components.push({ cells: comp, protectedHits });
       }
+      const list = componentsByAdmin.get(id) || [];
+      list.push({ cells, protectedHits });
+      componentsByAdmin.set(id, list);
+    }
+
+    let passChanged = 0;
+    for (const [id, components] of componentsByAdmin) {
       if (components.length <= 1) continue;
       components.sort((a, b) =>
         (b.protectedHits ? 1_000_000 : 0) + b.cells.length -
@@ -376,18 +78,16 @@ export function enforceMunicipalityConnectivityStrict(adminId, prefectureMask, s
           if (score > best || (score === best && other < target)) { best = score; target = other; }
         }
         if (target < 0) {
-          // Very rare: a detached island component has no labeled neighbor.
-          // Keep the largest/protected primary and merge the component into it
-          // only if it is directly adjacent after previous changes; otherwise
-          // leave it for the next pass rather than inventing over-sea ownership.
+          // A detached component with no land neighbor may be a real island.
+          // Keep it with its municipality rather than inventing an over-sea merge.
           target = id;
         }
         if (target >= 0 && target !== id) {
           for (const ci of component.cells) adminId[ci] = target;
           passChanged += component.cells.length;
         } else if (component !== primary) {
-          // If no external target exists, still mark it as handled by keeping it;
-          // another pass may expose a target after surrounding cells change.
+          // Keep isolated island components; a later pass may expose a land
+          // neighbor after surrounding ownership changes.
         }
       }
     }
@@ -397,7 +97,7 @@ export function enforceMunicipalityConnectivityStrict(adminId, prefectureMask, s
   return changed;
 }
 
-export function terrainBoundaryTargetScore(i, elevation, slope, river, ridgeField, valleyField, flowAccum, populationDensity, landuse) {
+function terrainBoundaryTargetScore(i, elevation, slope, river, ridgeField, valleyField, flowAccum, populationDensity, landuse) {
   const urbanPenalty = urbanBoundaryPenalty(i, populationDensity, landuse);
   const majorRiver = clamp(Math.max(river[i] - 0.32, 0) * 1.9 + Math.max(flowAccum[i] - 0.38, 0) * 0.75);
   const minorStream = clamp(river[i] * 0.34 + flowAccum[i] * 0.18);
@@ -414,123 +114,6 @@ function urbanBoundaryPenalty(i, populationDensity, landuse) {
   return clamp(core + populationDensity[i] * 1.35);
 }
 
-function isAdminBoundaryCell(labels, prefectureMask, sea, x, y, useEight = true) {
-  const i = indexOf(x, y);
-  const own = labels[i];
-  if (!prefectureMask[i] || sea[i] || own < 0) return false;
-  const neighbors = useEight ? neighbors8(x, y) : neighbors4(x, y);
-  for (const [nx, ny] of neighbors) {
-    const ni = indexOf(nx, ny);
-    if (prefectureMask[ni] && !sea[ni] && labels[ni] >= 0 && labels[ni] !== own) return true;
-  }
-  return false;
-}
-
-function buildBoundaryBand(labels, prefectureMask, sea, radius = 5) {
-  const band = new Uint8Array(SIZE);
-  for (let y = 1; y < MAP_H - 1; y++) {
-    for (let x = 1; x < MAP_W - 1; x++) {
-      if (!isAdminBoundaryCell(labels, prefectureMask, sea, x, y, true)) continue;
-      for (let dy = -radius; dy <= radius; dy++) {
-        for (let dx = -radius; dx <= radius; dx++) {
-          if (Math.hypot(dx, dy) > radius) continue;
-          const nx = x + dx;
-          const ny = y + dy;
-          if (!inside(nx, ny)) continue;
-          const ni = indexOf(nx, ny);
-          if (prefectureMask[ni] && !sea[ni]) band[ni] = 1;
-        }
-      }
-    }
-  }
-  return band;
-}
-
-function buildAdminProtectedMask(adminId, prefectureMask, sea, adminCenters = [], protectedPoints = [], populationDensity, landuse) {
-  const protectedMask = new Uint8Array(SIZE);
-  function protectDisk(p, radius) {
-    if (!p || !inside(p.x, p.y)) return;
-    const owner = adminId[indexOf(p.x, p.y)];
-    if (owner < 0) return;
-    const r = Math.ceil(radius);
-    for (let dy = -r; dy <= r; dy++) {
-      for (let dx = -r; dx <= r; dx++) {
-        if (Math.hypot(dx, dy) > radius) continue;
-        const x = p.x + dx;
-        const y = p.y + dy;
-        if (!inside(x, y)) continue;
-        const i = indexOf(x, y);
-        if (prefectureMask[i] && !sea[i] && adminId[i] === owner) protectedMask[i] = 1;
-      }
-    }
-  }
-  for (const center of adminCenters) protectDisk(center, 2.2);
-  for (const p of protectedPoints || []) protectDisk(p, p.population ? clamp(1.6 + Math.sqrt(p.population) / 520, 2.1, 6.0) : p.portClass ? 2.0 : 1.7);
-  for (let i = 0; i < SIZE; i++) {
-    if (prefectureMask[i] && !sea[i] && (landuse[i] === 3 || populationDensity[i] > 0.72)) protectedMask[i] = 1;
-  }
-  return protectedMask;
-}
-
-function localBoundaryEnergy(labels, i, candidateId, targetScore, centerDist, populationDensity, landuse, river, valleyField) {
-  const [x, y] = xyOf(i);
-  const oldId = labels[i];
-  let energy = centerDist[candidateId]?.[i] ?? 0;
-  let same4 = 0;
-  let diff4 = 0;
-  let diagDiff = 0;
-
-  for (const [nx, ny] of neighbors8(x, y)) {
-    const ni = indexOf(nx, ny);
-    const neighborId = labels[ni];
-    if (neighborId < 0) continue;
-    const isCardinal = nx === x || ny === y;
-    const differs = neighborId !== candidateId;
-    if (isCardinal) {
-      if (differs) {
-        diff4++;
-        const boundaryTarget = (targetScore[i] + targetScore[ni]) * 0.5;
-        const urbanCut = (urbanBoundaryPenalty(i, populationDensity, landuse) + urbanBoundaryPenalty(ni, populationDensity, landuse)) * 0.5;
-        const minorValley = (valleyField[i] + valleyField[ni]) * 0.5 > 0.34 && Math.max(river[i], river[ni]) < 0.30 ? 0.72 : 0;
-        const dHere = centerDist[candidateId]?.[i] ?? 99;
-        const dThere = centerDist[neighborId]?.[i] ?? 99;
-        const weakBisectorPenalty = Math.abs(dHere - dThere) < 4.0 && boundaryTarget < 0.42 ? 0.62 : 0;
-        energy += 2.15 - boundaryTarget * 1.55 + urbanCut * 3.0 + minorValley + weakBisectorPenalty;
-      } else same4++;
-    } else if (differs) diagDiff++;
-  }
-
-  if (same4 === 0) energy += 5.2;
-  if (same4 === 1) energy += 1.7;
-  if (diff4 >= 3 && targetScore[i] < 0.42) energy += 1.25;
-  if (diagDiff >= 3 && diff4 >= 2 && targetScore[i] < 0.50) energy += 0.42;
-  if (candidateId !== oldId) {
-    const candidateDistance = centerDistanceAt(centerDist, candidateId, i);
-    const oldDistance = centerDistanceAt(centerDist, oldId, i);
-    if (Number.isFinite(candidateDistance) && Number.isFinite(oldDistance)) {
-      const drift = candidateDistance - oldDistance;
-      if (drift > 0) energy += Math.min(0.9, drift * 0.012);
-    }
-  }
-  return energy;
-}
-
-function centerDistanceAt(centerDist, id, i) {
-  const field = centerDist?.fields?.[id] || centerDist?.[id];
-  if (field) return field[i];
-  const center = centerDist?.centers?.[id];
-  if (!center || !inside(center.x, center.y)) return 24;
-  const [x, y] = xyOf(i);
-  return Math.hypot(x - center.x, y - center.y);
-}
-
-function buildCenterDistanceFields(adminIds, adminCenters, prefectureMask, sea) {
-  // Older versions materialized one full SIZE Float32Array per municipality.
-  // In multi-prefecture generation this can create heavy transient memory use.
-  // Keep the same interface conceptually, but compute distances on demand.
-  return { ids: adminIds, centers: adminCenters, prefectureMask, sea };
-}
-
 function repairAdminTopology(adminId, prefectureMask, sea, adminCenters = [], targetScore = null, populationDensity = null, landuse = null) {
   const ids = new Set();
   for (let i = 0; i < SIZE; i++) if (prefectureMask[i] && !sea[i] && adminId[i] >= 0) ids.add(adminId[i]);
@@ -604,7 +187,7 @@ function classifyLandscapeCell(i, elevation, slope, river, ridgeField, valleyFie
   return 11;
 }
 
-export function buildNaturalBarrierScore(prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, crestCrossingScore = null, plain = null, agriculture = null, populationDensity = null, landuse = null) {
+function buildNaturalBarrierScore(prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, crestCrossingScore = null, plain = null, agriculture = null, populationDensity = null, landuse = null) {
   const score = new Float32Array(SIZE);
   for (let i = 0; i < SIZE; i++) {
     if (!prefectureMask[i] || sea[i]) continue;
@@ -653,20 +236,6 @@ function mountainCompartmentFitness(i, elevation, slope, ridgeField, populationD
   return clamp(elevation[i] * 0.38 + slope[i] * 0.32 + ridgeField[i] * 0.42 - settled);
 }
 
-function canShareNaturalCompartment(a, b, classA, classB, barrier, river, flowAccum, valleyField, populationDensity, landuse) {
-  if (classA !== classB) {
-    const bothUrban = classA <= 3 && classB <= 3;
-    const bothLivingCorridor = [5, 6, 7, 10].includes(classA) && [5, 6, 7, 10].includes(classB);
-    if (!bothUrban && !bothLivingCorridor) return false;
-  }
-  const majorRiverEdge = Math.max(river[a], river[b]) > 0.56 || Math.max(flowAccum[a], flowAccum[b]) > 0.68;
-  const urbanEdge = ((landuse[a] >= 2 && landuse[a] <= 4) || landuse[a] === 7 || populationDensity[a] > 0.34) &&
-    ((landuse[b] >= 2 && landuse[b] <= 4) || landuse[b] === 7 || populationDensity[b] > 0.34);
-  const valleyContinuity = (valleyField[a] + valleyField[b]) * 0.5 > 0.48 && !majorRiverEdge;
-  const threshold = urbanEdge ? 0.74 : valleyContinuity ? 0.56 : classA === 8 || classB === 8 ? 0.28 : 0.43;
-  return barrier < threshold && (!majorRiverEdge || urbanEdge);
-}
-
 function refreshCompartmentStats(unit, elevation, slope, ridgeField, valleyField, basinField, coastalLowland, plain, agriculture, populationDensity, landuse) {
   let sx = 0, sy = 0, pop = 0, urbanWeight = 0, ridgeExposure = 0, riverExposure = unit.riverExposure || 0;
   let coastalExposure = 0, basinIdentity = 0, valleyIdentity = 0, lowlandFitness = 0, mountainFitness = 0;
@@ -705,89 +274,6 @@ function refreshCompartmentStats(unit, elevation, slope, ridgeField, valleyField
   unit.mountainFitness = mountainFitness / Math.max(1, area);
 }
 
-function splitOneNaturalCompartment(unit, newId, compartmentId, fields, seed) {
-  if (!unit || unit.area < 24) return null;
-  const { elevation, slope, ridgeField, valleyField, basinField, coastalLowland, plain, agriculture, populationDensity, landuse, naturalBarrierScore, river, flowAccum } = fields;
-  const minPart = Math.max(8, Math.min(28, Math.floor(unit.area * 0.20)));
-
-  let first = -1;
-  let second = -1;
-  let bestA = -INF;
-  let bestB = -INF;
-  const width = unit.width || (unit.maxX - unit.minX + 1) || 1;
-  const height = unit.height || (unit.maxY - unit.minY + 1) || 1;
-  const horizontal = width >= height;
-  const elongated = Math.max(width, height) / Math.max(1, Math.min(width, height)) > 1.65;
-
-  for (const i of unit.cells) {
-    const [x, y] = xyOf(i);
-    const low = lowlandCompartmentFitness(i, elevation, slope, ridgeField, valleyField, basinField, coastalLowland, plain, agriculture, populationDensity, landuse);
-    const settled = populationDensity[i] * 0.28 + ([2, 3, 4, 7, 8].includes(landuse[i]) ? 0.34 : 0);
-    const axis = elongated ? (horizontal ? (unit.maxX - x) / Math.max(1, width) : (unit.maxY - y) / Math.max(1, height)) : 0.0;
-    const score = axis * 1.7 + low * 0.42 + settled + hashSeededTie(x, y, seed) * 0.05 - ridgeField[i] * 0.10;
-    if (score > bestA) { bestA = score; first = i; }
-  }
-  if (first < 0) return null;
-  const [fx, fy] = xyOf(first);
-  for (const i of unit.cells) {
-    const [x, y] = xyOf(i);
-    const low = lowlandCompartmentFitness(i, elevation, slope, ridgeField, valleyField, basinField, coastalLowland, plain, agriculture, populationDensity, landuse);
-    const axis = elongated ? (horizontal ? (x - unit.minX) / Math.max(1, width) : (y - unit.minY) / Math.max(1, height)) : 0.0;
-    const d = Math.hypot(x - fx, y - fy);
-    const score = axis * 1.9 + d * (0.18 + low * 0.22) + hashSeededTie(x, y, seed + 17) * 0.08 - ridgeField[i] * 0.08;
-    if (score > bestB) { bestB = score; second = i; }
-  }
-  if (second < 0 || second === first) return null;
-
-  const cellSet = new Set(unit.cells);
-  const owner = new Int8Array(SIZE);
-  owner.fill(-1);
-  const dist = new Float32Array(SIZE);
-  dist.fill(INF);
-  const heap = new MinHeap();
-  for (const [source, sourceOwner] of [[first, 0], [second, 1]]) {
-    owner[source] = sourceOwner;
-    dist[source] = 0;
-    heap.push({ i: source, f: 0, owner: sourceOwner });
-  }
-
-  while (heap.length > 0) {
-    const cur = heap.pop();
-    if (!cur || cur.f > dist[cur.i] + 1e-5) continue;
-    const [x, y] = xyOf(cur.i);
-    for (const [nx, ny, step] of neighbors4(x, y)) {
-      const ni = indexOf(nx, ny);
-      if (!cellSet.has(ni)) continue;
-      const barrier = ((naturalBarrierScore?.[cur.i] || 0) + (naturalBarrierScore?.[ni] || 0)) * 0.5;
-      const riverBarrier = Math.max(river?.[cur.i] || 0, river?.[ni] || 0) + Math.max(flowAccum?.[cur.i] || 0, flowAccum?.[ni] || 0) * 0.32;
-      const ridgeStep = Math.max(ridgeField[cur.i], ridgeField[ni]) * 1.18 + Math.abs(elevation[cur.i] - elevation[ni]) * 1.48;
-      const corridorBonus = Math.min(0.42, ((valleyField[cur.i] + valleyField[ni]) * 0.5 + (plain?.[ni] || 0) * 0.15 + (coastalLowland?.[ni] || 0) * 0.10));
-      const stepCost = Math.max(0.18, 0.78 + barrier * 3.75 + riverBarrier * 1.10 + ridgeStep + slope[ni] * 0.48 - corridorBonus) * step;
-      const nd = cur.f + stepCost;
-      if (nd < dist[ni]) {
-        dist[ni] = nd;
-        owner[ni] = cur.owner;
-        heap.push({ i: ni, f: nd, owner: cur.owner });
-      }
-    }
-  }
-
-  const aCells = [];
-  const bCells = [];
-  for (const ci of unit.cells) {
-    if (owner[ci] === 1) bCells.push(ci);
-    else aCells.push(ci);
-  }
-  if (aCells.length < minPart || bCells.length < minPart) return null;
-
-  unit.cells = aCells;
-  const newUnit = { ...unit, id: newId, cells: bCells, centerIds: [], adjacent: new Map() };
-  for (const ci of bCells) compartmentId[ci] = newId;
-  refreshCompartmentStats(unit, elevation, slope, ridgeField, valleyField, basinField, coastalLowland, plain, agriculture, populationDensity, landuse);
-  refreshCompartmentStats(newUnit, elevation, slope, ridgeField, valleyField, basinField, coastalLowland, plain, agriculture, populationDensity, landuse);
-  return newUnit;
-}
-
 function hashSeededTie(x, y, seed) {
   let h = Math.imul((x | 0) ^ (seed | 0), 1597334677) ^ Math.imul((y | 0) ^ ((seed >>> 1) | 0), 3812015801);
   h = (h ^ (h >>> 15)) >>> 0;
@@ -1308,50 +794,6 @@ export function buildNaturalCompartments(prefectureMask, sea, elevation, slope,
   return buildSeededNaturalCompartments(prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, crestCrossingScore, plain, agriculture, populationDensity, landuse, options);
 }
 
-function buildLandscapeUnits(prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse) {
-  const unitId = new Int32Array(SIZE);
-  unitId.fill(-1);
-  const cellClass = new Int16Array(SIZE);
-  cellClass.fill(-1);
-  for (let i = 0; i < SIZE; i++) if (prefectureMask[i] && !sea[i]) cellClass[i] = classifyLandscapeCell(i, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse);
-
-  const units = [];
-  const queue = [];
-  for (let i = 0; i < SIZE; i++) {
-    if (cellClass[i] < 0 || unitId[i] >= 0) continue;
-    const id = units.length;
-    const klass = cellClass[i];
-    const cells = [];
-    let sx = 0, sy = 0, pop = 0, urbanWeight = 0, ridgeExposure = 0, riverExposure = 0;
-    queue.length = 0;
-    queue.push(i);
-    unitId[i] = id;
-    for (let q = 0; q < queue.length; q++) {
-      const cur = queue[q];
-      const [x, y] = xyOf(cur);
-      cells.push(cur);
-      sx += x; sy += y; pop += populationDensity[cur];
-      urbanWeight += urbanBoundaryPenalty(cur, populationDensity, landuse);
-      ridgeExposure += ridgeField[cur];
-      riverExposure += river[cur] + flowAccum[cur] * 0.45;
-      for (const [nx, ny] of neighbors4(x, y)) {
-        const ni = indexOf(nx, ny);
-        if (unitId[ni] >= 0 || cellClass[ni] !== klass) continue;
-        unitId[ni] = id;
-        queue.push(ni);
-      }
-    }
-    units.push({ id, classId: klass, cells, area: cells.length, x: sx / cells.length, y: sy / cells.length, population: pop, urbanWeight: urbanWeight / cells.length, ridgeExposure: ridgeExposure / cells.length, riverExposure: riverExposure / cells.length, adjacent: new Map(), centerIds: [], owner: -1 });
-  }
-
-  const targetScore = new Float32Array(SIZE);
-  for (let i = 0; i < SIZE; i++) if (cellClass[i] >= 0) targetScore[i] = terrainBoundaryTargetScore(i, elevation, slope, river, ridgeField, valleyField, flowAccum, populationDensity, landuse);
-  rebuildLandscapeUnitAdjacency(unitId, units, targetScore, prefectureMask, sea);
-  mergeTinyLandscapeUnits(unitId, units, 10);
-  rebuildLandscapeUnitAdjacency(unitId, units, targetScore, prefectureMask, sea);
-  return { unitId, units, targetScore };
-}
-
 function rebuildLandscapeUnitAdjacency(unitId, units, targetScore, prefectureMask, sea) {
   for (const unit of units) unit.adjacent = new Map();
   for (let y = 0; y < MAP_H; y++) {
@@ -1607,103 +1049,7 @@ function compartmentMunicipalityMetrics(compartments, owner, targetMunicipalityC
   };
 }
 
-function averageFinalBorderBarrier(adminId, prefectureMask, sea, naturalBarrierScore) {
-  let sum = 0;
-  let count = 0;
-  for (let y = 1; y < MAP_H - 1; y++) {
-    for (let x = 1; x < MAP_W - 1; x++) {
-      const i = indexOf(x, y);
-      if (!prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        const ni = indexOf(nx, ny);
-        if (!prefectureMask[ni] || sea[ni] || adminId[ni] < 0 || adminId[ni] === adminId[i]) continue;
-        sum += (naturalBarrierScore[i] + naturalBarrierScore[ni]) * 0.5;
-        count++;
-      }
-    }
-  }
-  return count ? sum / count : 0;
-}
-
-function averageFinalBorderField(adminId, prefectureMask, sea, field) {
-  if (!field) return 0;
-  let sum = 0;
-  let count = 0;
-  for (let y = 1; y < MAP_H - 1; y++) {
-    for (let x = 1; x < MAP_W - 1; x++) {
-      const i = indexOf(x, y);
-      if (!prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        const ni = indexOf(nx, ny);
-        if (!prefectureMask[ni] || sea[ni] || adminId[ni] < 0 || adminId[ni] === adminId[i]) continue;
-        sum += ((field[i] || 0) + (field[ni] || 0)) * 0.5;
-        count++;
-      }
-    }
-  }
-  return count ? sum / count : 0;
-}
-
-function assignCompartmentsToAdminOwners(compartments, compartmentId, adminCenters, naturalBarrierScore, prefectureMask, sea) {
-  const owner = new Int16Array(compartments.length);
-  owner.fill(-1);
-  for (let id = 0; id < adminCenters.length; id++) {
-    const center = adminCenters[id];
-    if (!center || !inside(center.x, center.y)) continue;
-    const compIndex = compartmentId[indexOf(center.x, center.y)];
-    if (compIndex >= 0 && compartments[compIndex]?.area > 0) {
-      const unit = compartments[compIndex];
-      unit.centerIds.push(id);
-      owner[compIndex] = id;
-    }
-  }
-
-  for (let pass = 0; pass < compartments.length + 8; pass++) {
-    let changed = 0;
-    for (const unit of compartments) {
-      if (!unit || unit.area === 0 || owner[unit.id] >= 0) continue;
-      let bestOwner = -1;
-      let bestScore = -INF;
-      for (const [neighborId, edge] of unit.adjacent) {
-        const neighborOwner = owner[neighborId];
-        if (neighborOwner < 0) continue;
-        const neighbor = compartments[neighborId];
-        if (!neighbor || neighbor.area === 0) continue;
-        const center = adminCenters[neighborOwner];
-        const d = center ? Math.hypot(unit.x - center.x, unit.y - center.y) : 0;
-        const score = naturalOwnershipAffinity(unit, neighbor, edge) - d * 0.006 + Math.min(0.9, Math.sqrt(Math.max(1, neighbor.area)) * 0.020);
-        if (score > bestScore) { bestScore = score; bestOwner = neighborOwner; }
-      }
-      const accept = unit.classId <= 3 ? bestScore > -0.35 : unit.classId === 8 || unit.classId === 9 ? bestScore > -1.05 : bestScore > -0.70;
-      if (bestOwner >= 0 && accept) {
-        owner[unit.id] = bestOwner;
-        changed++;
-      }
-    }
-    if (changed === 0) break;
-  }
-
-  for (const unit of compartments) {
-    if (!unit || unit.area === 0 || owner[unit.id] >= 0) continue;
-    let bestId = -1;
-    let bestScore = -INF;
-    for (let id = 0; id < adminCenters.length; id++) {
-      const center = adminCenters[id];
-      if (!center || !inside(center.x, center.y)) continue;
-      const centerComp = compartments[compartmentId[indexOf(center.x, center.y)]];
-      const sameGroup = centerComp && naturalGroupKey(centerComp) === naturalGroupKey(unit) ? 2.3 : 0;
-      const sameClass = centerComp && centerComp.classId === unit.classId ? 0.8 : 0;
-      const urbanFit = unit.urbanWeight > 0.55 && centerComp?.urbanWeight > 0.55 ? 1.3 : 0;
-      const d = Math.hypot(unit.x - center.x, unit.y - center.y);
-      const score = sameGroup + sameClass + urbanFit - d * 0.020 - unit.ridgeExposure * 0.16;
-      if (score > bestScore) { bestScore = score; bestId = id; }
-    }
-    owner[unit.id] = bestId >= 0 ? bestId : 0;
-  }
-  return owner;
-}
-
-export function extractCompartmentBorders(compartmentId, prefectureMask, sea) {
+function extractCompartmentBorders(compartmentId, prefectureMask, sea) {
   const segments = [];
   for (let y = 0; y < MAP_H; y++) {
     for (let x = 0; x < MAP_W; x++) {
@@ -1765,11 +1111,11 @@ export function assignAdminRegionsFromNaturalCompartments(prefectureMask, sea, e
         .map((unit) => ({ id: unit.id, area: unit.area || 0, width: unit.width || 0, height: unit.height || 0, elongation: unit.elongation || 1, classId: unit.classId, x: Math.round(unit.x || 0), y: Math.round(unit.y || 0) }))
         .sort((a, b) => (b.elongation * Math.sqrt(Math.max(1, b.area))) - (a.elongation * Math.sqrt(Math.max(1, a.area))))
         .slice(0, 8),
-      finalBorderNaturalBarrierAverage: averageFinalBorderBarrier(adminId, prefectureMask, sea, naturalBarrierScore),
+      finalBorderNaturalBarrierAverage: averageFieldAcrossOwnerBorders((i) => adminId[i], prefectureMask, sea, naturalBarrierScore),
       unifiedGeographyAppliedToAdminCompartments: unifiedGeographyApplied,
-      finalBorderUnifiedBoundaryPreferenceAverage: averageFinalBorderField(adminId, prefectureMask, sea, options.adminBoundaryPreference || options.geography?.adminBoundaryPreference),
-      finalBorderUnifiedBoundaryAvoidanceAverage: averageFinalBorderField(adminId, prefectureMask, sea, options.boundaryAvoidance || options.geography?.boundaryAvoidance),
-      finalBorderUnifiedCentralityAverage: averageFinalBorderField(adminId, prefectureMask, sea, options.centrality || options.geography?.centrality),
+      finalBorderUnifiedBoundaryPreferenceAverage: averageFieldAcrossOwnerBorders((i) => adminId[i], prefectureMask, sea, options.adminBoundaryPreference || options.geography?.adminBoundaryPreference),
+      finalBorderUnifiedBoundaryAvoidanceAverage: averageFieldAcrossOwnerBorders((i) => adminId[i], prefectureMask, sea, options.boundaryAvoidance || options.geography?.boundaryAvoidance),
+      finalBorderUnifiedCentralityAverage: averageFieldAcrossOwnerBorders((i) => adminId[i], prefectureMask, sea, options.centrality || options.geography?.centrality),
       voronoiLikeRateBefore: 0,
       voronoiLikeRateAfter: weakVoronoiLikeRate(adminId, adminCenters, prefectureMask, sea, naturalBarrierScore),
     },
@@ -1799,7 +1145,7 @@ function weakVoronoiLikeRate(adminId, adminCenters, prefectureMask, sea, natural
   return total ? weak / total : 0;
 }
 
-export function applyLandscapeUnitAdminPartition(adminId, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse, adminCenters = []) {
+function applyLandscapeUnitAdminPartition(adminId, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse, adminCenters = []) {
   const before = new Int16Array(adminId);
   const initialNaturalBarrierScore = buildNaturalBarrierScore(prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, null, plain, agriculture, populationDensity, landuse);
   const beforeVoronoiLikeRate = weakVoronoiLikeRate(adminId, adminCenters, prefectureMask, sea, initialNaturalBarrierScore);
@@ -1884,140 +1230,9 @@ export function applyLandscapeUnitAdminPartition(adminId, prefectureMask, sea, e
     compartmentCount: activeCompartments.length,
     averageCompartmentArea: activeCompartments.length ? activeCompartments.reduce((sum, unit) => sum + unit.area, 0) / activeCompartments.length : 0,
     changedAfterNaturalCompartmentPartition: changedCells,
-    finalBorderNaturalBarrierAverage: averageFinalBorderBarrier(adminId, prefectureMask, sea, naturalBarrierScore),
+    finalBorderNaturalBarrierAverage: averageFieldAcrossOwnerBorders((i) => adminId[i], prefectureMask, sea, naturalBarrierScore),
     voronoiLikeRateBefore: beforeVoronoiLikeRate,
     voronoiLikeRateAfter: weakVoronoiLikeRate(adminId, adminCenters, prefectureMask, sea, naturalBarrierScore),
   };
 }
 
-export function snapAdminBoundariesToTerrain(adminId, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, flowAccum, populationDensity, landuse, adminCenters = [], protectedPoints = [], passes = 6) {
-  const targetScore = new Float32Array(SIZE);
-  for (let i = 0; i < SIZE; i++) if (prefectureMask[i] && !sea[i]) targetScore[i] = terrainBoundaryTargetScore(i, elevation, slope, river, ridgeField, valleyField, flowAccum, populationDensity, landuse);
-  const protectedMask = buildAdminProtectedMask(adminId, prefectureMask, sea, adminCenters, protectedPoints, populationDensity, landuse);
-  const band = buildBoundaryBand(adminId, prefectureMask, sea, 5);
-  const adminIds = [...new Set([...adminId].filter((id) => id >= 0))];
-  const centerDist = buildCenterDistanceFields(adminIds, adminCenters, prefectureMask, sea);
-  let current = new Int16Array(adminId);
-
-  for (let pass = 0; pass < passes; pass++) {
-    const next = new Int16Array(current);
-    let changed = 0;
-    for (let y = 1; y < MAP_H - 1; y++) {
-      for (let x = 1; x < MAP_W - 1; x++) {
-        const i = indexOf(x, y);
-        const own = current[i];
-        if (!band[i] || protectedMask[i] || !prefectureMask[i] || sea[i] || own < 0) continue;
-        if (!isAdminBoundaryCell(current, prefectureMask, sea, x, y, true)) continue;
-        const candidates = new Set();
-        for (const [nx, ny] of neighbors8(x, y)) {
-          const ni = indexOf(nx, ny);
-          if (prefectureMask[ni] && !sea[ni] && current[ni] >= 0 && current[ni] !== own) candidates.add(current[ni]);
-        }
-        if (candidates.size === 0) continue;
-        const currentEnergy = localBoundaryEnergy(current, i, own, targetScore, centerDist, populationDensity, landuse, river, valleyField);
-        let bestId = own, bestEnergy = currentEnergy;
-        for (const candidate of candidates) {
-          const candidateEnergy = localBoundaryEnergy(current, i, candidate, targetScore, centerDist, populationDensity, landuse, river, valleyField);
-          const threshold = 0.18 + (targetScore[i] < 0.36 ? 0.16 : 0) + urbanBoundaryPenalty(i, populationDensity, landuse) * 0.25;
-          if (bestEnergy - candidateEnergy > threshold) { bestEnergy = candidateEnergy; bestId = candidate; }
-        }
-        if (bestId !== own) { next[i] = bestId; changed++; }
-      }
-    }
-    current = next;
-    if (changed === 0) break;
-  }
-  adminId.set(current);
-  repairAdminTopology(adminId, prefectureMask, sea, adminCenters, targetScore, populationDensity, landuse);
-}
-
-export function splitOversizedRuralMunicipalities(adminId, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse, adminCenters = [], settlements = []) {
-  const before = new Int16Array(adminId);
-  const area = new Map();
-  const lowland = new Map();
-  const mountain = new Map();
-  for (let i = 0; i < SIZE; i++) {
-    if (!prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
-    const id = adminId[i];
-    area.set(id, (area.get(id) || 0) + 1);
-    const living = (plain[i] || 0) * 0.42 + (agriculture[i] || 0) * 0.28 + basinField[i] * 0.20 + coastalLowland[i] * 0.20 + valleyField[i] * 0.12;
-    const rough = ridgeField[i] * 0.54 + slope[i] * 0.36 + Math.max(0, elevation[i] - 0.58) * 0.38;
-    lowland.set(id, (lowland.get(id) || 0) + living);
-    mountain.set(id, (mountain.get(id) || 0) + rough);
-  }
-  const areas = [...area.values()].sort((a, b) => a - b);
-  const median = areas.length ? areas[Math.floor(areas.length / 2)] : 0;
-  if (!median) return { changedCells: 0, splitMunicipalities: 0 };
-
-  const { compartmentId, compartments, naturalBarrierScore } = buildNaturalCompartments(prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, null, plain, agriculture, populationDensity, landuse);
-  const unitOwner = new Int16Array(compartments.length);
-  unitOwner.fill(-1);
-  for (const unit of compartments) {
-    if (!unit || unit.area === 0) continue;
-    const counts = new Map();
-    for (const i of unit.cells) {
-      const id = adminId[i];
-      if (id >= 0) counts.set(id, (counts.get(id) || 0) + 1);
-    }
-    let bestId = -1, best = -1;
-    for (const [id, count] of counts) if (count > best) { best = count; bestId = id; }
-    unitOwner[unit.id] = bestId;
-  }
-
-  const adminCenterIndex = new Map();
-  for (let id = 0; id < adminCenters.length; id++) {
-    const c = adminCenters[id];
-    if (c && inside(c.x, c.y)) adminCenterIndex.set(id, indexOf(c.x, c.y));
-  }
-
-  let splitMunicipalities = 0;
-  let rejectedMunicipalities = 0;
-  for (const [id, cells] of area) {
-    const averageLowland = (lowland.get(id) || 0) / cells;
-    const averageMountain = (mountain.get(id) || 0) / cells;
-    if (cells < median * 1.85 || averageLowland < 0.24 || averageMountain > 0.48) {
-      if (cells >= median * 1.85) rejectedMunicipalities++;
-      continue;
-    }
-    const localSettlements = settlements.filter((p) => p && inside(p.x, p.y) && adminId[indexOf(p.x, p.y)] === id);
-    const meaningfulNodes = localSettlements.filter((p) => p.kind === "Satellite City" || p.kind === "New Town" || p.kind === "Market Town" || (p.population || 0) >= 30000);
-    if (meaningfulNodes.length < 2) {
-      rejectedMunicipalities++;
-      continue;
-    }
-    let changedHere = 0;
-    for (const unit of compartments) {
-      if (!unit || unit.area === 0 || unitOwner[unit.id] !== id) continue;
-      const centerIndex = adminCenterIndex.get(id);
-      if (centerIndex >= 0 && unit.cells.includes(centerIndex)) continue;
-      if (unit.classId === 8 || unit.classId === 9) continue;
-      let bestNeighbor = -1;
-      let bestScore = -INF;
-      for (const [neighborId, edge] of unit.adjacent) {
-        const neighborOwner = unitOwner[neighborId];
-        if (neighborOwner < 0 || neighborOwner === id) continue;
-        const boundaryTarget = edge.target / Math.max(1, edge.count);
-        const neighbor = compartments[neighborId];
-        const nodePull = meaningfulNodes.reduce((best, p) => Math.max(best, 1 / (1 + Math.hypot(p.x - unit.x, p.y - unit.y) / 6)), 0);
-        const score = edge.count * 0.7 + boundaryTarget * 1.4 + nodePull * 1.2 - Math.max(0, (neighbor?.ridgeExposure || 0) - unit.ridgeExposure) * 0.35;
-        if (score > bestScore) { bestScore = score; bestNeighbor = neighborOwner; }
-      }
-      if (bestNeighbor < 0 || bestScore < 2.2) continue;
-      for (const ci of unit.cells) {
-        if (adminId[ci] === id) {
-          adminId[ci] = bestNeighbor;
-          changedHere++;
-        }
-      }
-    }
-    if (changedHere > Math.max(28, cells * 0.035)) splitMunicipalities++;
-  }
-  repairAdminTopology(adminId, prefectureMask, sea, adminCenters, naturalBarrierScore, populationDensity, landuse);
-  let changedCells = 0;
-  for (let i = 0; i < SIZE; i++) if (prefectureMask[i] && !sea[i] && before[i] !== adminId[i]) changedCells++;
-  return { changedCells, splitMunicipalities, rejectedMunicipalities };
-}
-
-export function splitOversizedLowlandMunicipalities(adminId, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse, adminCenters = [], settlements = []) {
-  return splitOversizedRuralMunicipalities(adminId, prefectureMask, sea, elevation, slope, river, ridgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse, adminCenters, settlements);
-}
diff --git a/src/app.js b/src/app.js
new file mode 100644
index 0000000..66a8fad
--- /dev/null
+++ b/src/app.js
@@ -0,0 +1,2755 @@
+import { drawMap } from "./renderer.js";
+import { landuseLabel } from "./landuseCodes.js";
+import { CELL_SIZE, MAP_H, MAP_W, worldIndexOf } from "./mapUtils.js";
+import { clampCameraToWorld, createInitialCamera, createWorldMap, ensureWorldPaddingForCamera } from "./worldMap.js";
+import { getViewportMap } from "./worldViewport.js";
+import { PATCH_MIN_AREA, PATCH_MIN_HEIGHT, PATCH_MIN_WIDTH, buildPatchRects, validatePatchRect } from "./mapPatch.js";
+import { collectTransferableBuffers } from "./transferUtils.js";
+
+const modes = [
+  ["all", "All"],
+  ["terrain", "Terrain"],
+  ["modern", "Modern"],
+  ["history", "Premodern"],
+  ["landuse", "Land Use"],
+  ["admin", "Admin"],
+];
+
+const state = {
+  seedText: "114514",
+  generationType: "auto",
+  mode: "all",
+  toolMode: "pan",
+  showFeatures: true,
+  showLabels: true,
+  showSeamDiagnostics: true,
+  map: null,
+  world: null,
+  camera: { x: 0, y: 0 },
+  viewportMap: null,
+  viewWidth: MAP_W,
+  viewHeight: MAP_H,
+  hoverEntities: [],
+  selectionRect: null,
+  patchVariant: 0,
+  zoom: 1,
+  lastPatchResult: null,
+  pendingPatch: null,
+  patchBusy: false,
+  patchBusyVariant: null,
+  patchStatusMessage: "",
+  renderRevision: 0,
+  generationRuns: [],
+  patchRuns: [],
+  interactionRuns: [],
+  diagnosticLog: [],
+  diagnostics: {
+    worldExpansionCount: 0,
+    lastWorldExpansion: null,
+    lastViewport: null,
+    lastFeatureCounts: null,
+    lastWorkerUsed: null,
+    lastWorkerFallbackReason: null,
+    lastPatchWorkerKind: null,
+    lastGenerationWorkerUsed: null,
+    lastGenerationWorkerFallbackReason: null,
+  },
+};
+
+const canvas = document.getElementById("mapCanvas");
+const canvasShell = document.querySelector(".canvas-shell");
+const seedInput = document.getElementById("seed");
+const generationTypeInput = document.getElementById("generationType");
+const patchTerrainTypeInput = document.getElementById("patchTerrainType");
+const patchModeInput = document.getElementById("patchMode");
+const patchVariantInput = document.getElementById("patchVariant");
+const generatePatchButton = document.getElementById("generatePatch");
+const alternativePatchButton = document.getElementById("alternativePatch");
+const patchStatusEl = document.getElementById("patchStatus");
+const generateMapButton = document.getElementById("generateMap");
+const randomSeedButton = document.getElementById("randomSeed");
+const toolPanButton = document.getElementById("toolPan");
+const toolPatchButton = document.getElementById("toolPatch");
+const toolHintEl = document.getElementById("toolHint");
+const zoomInButton = document.getElementById("zoomIn");
+const zoomOutButton = document.getElementById("zoomOut");
+const zoomResetButton = document.getElementById("zoomReset");
+const centerMapButton = document.getElementById("centerMap");
+const applyPatchButton = document.getElementById("applyPatch");
+const discardPatchButton = document.getElementById("discardPatch");
+const clearPatchSelectionButton = document.getElementById("clearPatchSelection");
+const cancelPatchButton = document.getElementById("cancelPatchGeneration");
+const showFeaturesInput = document.getElementById("showFeatures");
+const showLabelsInput = document.getElementById("showLabels");
+const showSeamDiagnosticsInput = document.getElementById("showSeamDiagnostics");
+const modeGrid = document.getElementById("modeGrid");
+const mainLegendGrid = document.getElementById("mainLegendGrid");
+const floatingLegendGrid = document.getElementById("floatingLegendGrid");
+const statsEl = document.getElementById("stats");
+const advancedGenerationStatsEl = document.getElementById("advancedGenerationStats");
+const advancedGenerationHistoryEl = document.getElementById("advancedGenerationHistory");
+const advancedPatchStatsEl = document.getElementById("advancedPatchStats");
+const advancedPatchHistoryEl = document.getElementById("advancedPatchHistory");
+const advancedInteractionStatsEl = document.getElementById("advancedInteractionStats");
+const advancedInteractionHistoryEl = document.getElementById("advancedInteractionHistory");
+const advancedViewportDiagnosticsEl = document.getElementById("advancedViewportDiagnostics");
+const advancedFeatureCountsEl = document.getElementById("advancedFeatureCounts");
+const advancedPatchDiagnosticsEl = document.getElementById("advancedPatchDiagnostics");
+const advancedSeamDiagnosticsEl = document.getElementById("advancedSeamDiagnostics");
+const advancedWorkerDiagnosticsEl = document.getElementById("advancedWorkerDiagnostics");
+const advancedWorldDiagnosticsEl = document.getElementById("advancedWorldDiagnostics");
+const advancedWarningHistoryEl = document.getElementById("advancedWarningHistory");
+const copyImportantDataButton = document.getElementById("copyImportantData");
+const copyDebugStatusEl = document.getElementById("copyDebugStatus");
+const tooltipEl = document.getElementById("mapTooltip");
+const selectionSvgEl = document.getElementById("mapSelectionSvg");
+const selectionEl = document.getElementById("mapSelection");
+const progressEl = document.getElementById("generationProgress");
+const progressStageEl = document.getElementById("generationProgressStage");
+const progressTimingsEl = document.getElementById("generationProgressTimings");
+let generationStartedAt = 0;
+let generationCurrentStage = "";
+let generationTimer = null;
+let zoomRedrawRaf = null;
+let zoomSettledTimer = null;
+let zoomVisualState = null;
+let zoomLatencyStartedAt = null;
+let patchWorker = null;
+let patchJobSeq = 0;
+let patchRequestSeq = 0;
+let activePatchCancel = null;
+const PATCH_WORKER_INACTIVITY_WATCHDOG_MS = 60_000;
+let generationWorker = null;
+let generationJobSeq = 0;
+let generationRequestSeq = 0;
+const generationPendingJobs = new Map();
+
+const dragState = {
+  mode: null,
+  pointerId: null,
+  startClientX: 0,
+  startClientY: 0,
+  startCameraX: 0,
+  startCameraY: 0,
+  lastClientX: 0,
+  lastClientY: 0,
+  panRemainderX: 0,
+  panRemainderY: 0,
+  selectStart: null,
+  selectEnd: null,
+  selectPath: null,
+  pendingCamera: null,
+  panRaf: null,
+  panLatencyStartedAt: null,
+};
+
+function displayWorld() {
+  return state.pendingPatch?.world || state.world;
+}
+
+function displaySourceMap() {
+  return displayWorld()?.sourceMap || state.map;
+}
+
+function activeMap() {
+  return state.viewportMap || displaySourceMap();
+}
+
+function clampZoom(value) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return 1;
+  return Math.min(Math.max(parsed, 0.55), 2.8);
+}
+
+function viewportSizeForZoom(zoom = state.zoom) {
+  const z = clampZoom(zoom || 1);
+  return {
+    width: Math.max(1, Math.ceil(MAP_W / z)),
+    height: Math.max(1, Math.ceil(MAP_H / z)),
+  };
+}
+
+function clampCameraForView(camera, size = viewportSizeForZoom(state.zoom), world = displayWorld()) {
+  return clampCameraToWorld(camera, world, size?.width || MAP_W, size?.height || MAP_H);
+}
+
+function syncViewportSize() {
+  const size = viewportSizeForZoom(state.zoom);
+  state.viewWidth = size.width;
+  state.viewHeight = size.height;
+  return size;
+}
+
+function canvasInteractionRect() {
+  return zoomVisualState?.baseRect || canvas.getBoundingClientRect();
+}
+
+function mapCellScreenSize(map = activeMap()) {
+  const rect = canvasInteractionRect();
+  const mapWidth = Math.max(1, map?.width || state.viewWidth || MAP_W);
+  return rect.width ? rect.width / mapWidth : CELL_SIZE * clampZoom(state.zoom || 1);
+}
+
+function applyCanvasZoom() {
+  if (!canvas) return;
+  state.zoom = clampZoom(state.zoom || 1);
+  const baseWidth = MAP_W * CELL_SIZE;
+  const baseHeight = MAP_H * CELL_SIZE;
+  const shellRect = canvasShell?.getBoundingClientRect();
+  const availableWidth = Math.max(160, (shellRect?.width || baseWidth) - 24);
+  const availableHeight = Math.max(160, (shellRect?.height || baseHeight) - 24);
+  const displayScale = Math.max(0.18, Math.min(availableWidth / baseWidth, availableHeight / baseHeight));
+  canvas.style.width = `${Math.round(baseWidth * displayScale)}px`;
+  canvas.style.height = `${Math.round(baseHeight * displayScale)}px`;
+  syncSelectionSvgToCanvas();
+  updateSelectionOverlayFromWorldRect();
+}
+
+function displayedCellSize() {
+  return mapCellScreenSize();
+}
+
+function screenPointToMapPixel(clientX, clientY, sizeOverride = null) {
+  const rect = canvasInteractionRect();
+  if (!rect.width || !rect.height) return null;
+  const map = activeMap();
+  const viewWidth = Math.max(1, sizeOverride?.width || map?.width || state.viewWidth || MAP_W);
+  const viewHeight = Math.max(1, sizeOverride?.height || map?.height || state.viewHeight || MAP_H);
+  const canvasX = (clientX - rect.left) * ((canvas.width || MAP_W * CELL_SIZE) / rect.width);
+  const canvasY = (clientY - rect.top) * ((canvas.height || MAP_H * CELL_SIZE) / rect.height);
+  const cellX = canvasX / Math.max(1e-6, (canvas.width || MAP_W * CELL_SIZE) / viewWidth);
+  const cellY = canvasY / Math.max(1e-6, (canvas.height || MAP_H * CELL_SIZE) / viewHeight);
+  return { x: cellX * CELL_SIZE, y: cellY * CELL_SIZE };
+}
+
+function mapPixelToScreenPoint(px, py) {
+  const rect = canvasInteractionRect();
+  const map = activeMap();
+  const viewWidth = Math.max(1, map?.width || state.viewWidth || MAP_W);
+  const viewHeight = Math.max(1, map?.height || state.viewHeight || MAP_H);
+  const canvasX = (px / CELL_SIZE) * ((canvas.width || MAP_W * CELL_SIZE) / viewWidth);
+  const canvasY = (py / CELL_SIZE) * ((canvas.height || MAP_H * CELL_SIZE) / viewHeight);
+  return {
+    x: canvas.offsetLeft + canvasX * (rect.width / Math.max(1, canvas.width || MAP_W * CELL_SIZE)),
+    y: canvas.offsetTop + canvasY * (rect.height / Math.max(1, canvas.height || MAP_H * CELL_SIZE)),
+  };
+}
+
+function mapClientToCell(event, sizeOverride = null) {
+  const map = activeMap();
+  if (!map && !sizeOverride) return null;
+  const p = screenPointToMapPixel(event.clientX, event.clientY, sizeOverride);
+  if (!p) return null;
+  return {
+    x: Math.floor(p.x / CELL_SIZE),
+    y: Math.floor(p.y / CELL_SIZE),
+  };
+}
+
+function viewportCellToWorldCell(cell) {
+  if (!cell || !state.camera) return null;
+  return {
+    x: Math.round(state.camera.x || 0) + cell.x,
+    y: Math.round(state.camera.y || 0) + cell.y,
+  };
+}
+
+function clampCanvasPoint(event) {
+  const rect = canvasInteractionRect();
+  return {
+    x: Math.min(Math.max(event.clientX - rect.left, 0), rect.width),
+    y: Math.min(Math.max(event.clientY - rect.top, 0), rect.height),
+  };
+}
+
+function screenPointToWorldCell(point) {
+  const map = activeMap();
+  if (!map || !point) return null;
+  const rect = canvasInteractionRect();
+  if (!rect.width || !rect.height) return null;
+  const viewWidth = Math.max(1, map.width || state.viewWidth || MAP_W);
+  const viewHeight = Math.max(1, map.height || state.viewHeight || MAP_H);
+  const canvasX = point.x * ((canvas.width || MAP_W * CELL_SIZE) / rect.width);
+  const canvasY = point.y * ((canvas.height || MAP_H * CELL_SIZE) / rect.height);
+  const localX = Math.floor((canvasX / Math.max(1e-6, (canvas.width || MAP_W * CELL_SIZE) / viewWidth)));
+  const localY = Math.floor((canvasY / Math.max(1e-6, (canvas.height || MAP_H * CELL_SIZE) / viewHeight)));
+  const cameraX = Math.round(state.camera?.x || 0);
+  const cameraY = Math.round(state.camera?.y || 0);
+  return {
+    x: cameraX + Math.min(Math.max(localX, 0), Math.max(0, map.width - 1)),
+    y: cameraY + Math.min(Math.max(localY, 0), Math.max(0, map.height - 1)),
+  };
+}
+
+function worldCellToOverlayPoint(point) {
+  const cameraX = Math.round(state.camera?.x || 0);
+  const cameraY = Math.round(state.camera?.y || 0);
+  const screen = mapPixelToScreenPoint((point.x - cameraX + 0.5) * CELL_SIZE, (point.y - cameraY + 0.5) * CELL_SIZE);
+  return { x: screen.x - canvas.offsetLeft, y: screen.y - canvas.offsetTop };
+}
+
+function simplifySelectionPath(points) {
+  const out = [];
+  // Pointer sampling already suppresses sub-3 px jitter.  A second 6 px filter
+  // turned curved lassos into long chords at low zoom, and those chords leaked
+  // into terrain/administrative seams.  Keep a small adaptive tolerance instead.
+  const minDistance = Math.max(1.5, Math.min(3, displayedCellSize() * 0.35));
+  for (const p of points || []) {
+    if (!out.length || Math.hypot(out[out.length - 1].x - p.x, out[out.length - 1].y - p.y) >= minDistance) out.push(p);
+  }
+  return out;
+}
+
+function polygonArea(points) {
+  let area = 0;
+  for (let i = 0; i < points.length; i++) {
+    const a = points[i];
+    const b = points[(i + 1) % points.length];
+    area += a.x * b.y - b.x * a.y;
+  }
+  return Math.abs(area) * 0.5;
+}
+
+function selectionPathToShape(points) {
+  const simplified = simplifySelectionPath(points || []);
+  if (simplified.length < 3) return null;
+  const polygon = [];
+  for (const point of simplified.map(screenPointToWorldCell).filter(Boolean)) {
+    const last = polygon[polygon.length - 1];
+    if (!last || last.x !== point.x || last.y !== point.y) polygon.push(point);
+  }
+  if (polygon.length > 2 && polygon[0].x === polygon[polygon.length - 1].x && polygon[0].y === polygon[polygon.length - 1].y) polygon.pop();
+  if (polygon.length < 3) return null;
+  const xs = polygon.map((p) => p.x);
+  const ys = polygon.map((p) => p.y);
+  return {
+    kind: "lasso",
+    polygon,
+    x0: Math.min(...xs),
+    y0: Math.min(...ys),
+    x1: Math.max(...xs) + 1,
+    y1: Math.max(...ys) + 1,
+    areaCells: Math.max(1, Math.round(polygonArea(polygon))),
+  };
+}
+
+function syncSelectionSvgToCanvas() {
+  if (!selectionSvgEl || !canvas) return null;
+  const rect = canvas.getBoundingClientRect();
+  const width = Math.max(1, rect.width || canvas.clientWidth || canvas.width || 1);
+  const height = Math.max(1, rect.height || canvas.clientHeight || canvas.height || 1);
+  selectionSvgEl.style.left = `${canvas.offsetLeft}px`;
+  selectionSvgEl.style.top = `${canvas.offsetTop}px`;
+  selectionSvgEl.style.width = `${width}px`;
+  selectionSvgEl.style.height = `${height}px`;
+  selectionSvgEl.setAttribute("width", String(width));
+  selectionSvgEl.setAttribute("height", String(height));
+  selectionSvgEl.setAttribute("viewBox", `0 0 ${width} ${height}`);
+  return { width, height };
+}
+
+function drawSelectionSvg(points, invalid = false) {
+  if (!selectionSvgEl) return;
+  const bounds = syncSelectionSvgToCanvas();
+  if (!bounds || !points || points.length < 3) {
+    selectionSvgEl.style.display = "none";
+    selectionSvgEl.innerHTML = "";
+    return;
+  }
+  const pts = points.map((p) => {
+    const x = Math.min(Math.max(p.x, 0), bounds.width);
+    const y = Math.min(Math.max(p.y, 0), bounds.height);
+    return `${x},${y}`;
+  }).join(" ");
+  selectionSvgEl.innerHTML = `<polygon points="${pts}" />`;
+  selectionSvgEl.style.display = "block";
+  selectionSvgEl.classList.toggle("invalid", !!invalid);
+}
+
+function hideSelectionSvg() {
+  if (!selectionSvgEl) return;
+  selectionSvgEl.style.display = "none";
+  selectionSvgEl.innerHTML = "";
+  selectionSvgEl.classList.remove("invalid");
+}
+
+function updateSelectionOverlay() {
+  if (!dragState.selectPath?.length) return;
+  const liveShape = selectionPathToShape(dragState.selectPath);
+  const validation = validatePatchRect(liveShape, state.world);
+  drawSelectionSvg(dragState.selectPath, !validation.ok);
+  if (selectionEl) selectionEl.style.display = "none";
+  if (generatePatchButton) generatePatchButton.disabled = true;
+  if (alternativePatchButton) alternativePatchButton.disabled = true;
+  if (patchStatusEl) {
+    const current = validation.rect || liveShape;
+    patchStatusEl.textContent = validation.ok
+      ? `Selected: ${formatRectSize(validation.rect)}. Release to confirm patch selection.`
+      : `${validation.reason} Current: ${formatRectSize(current)}.`;
+    patchStatusEl.classList.toggle("invalid", !validation.ok);
+  }
+}
+
+function updateSelectionOverlayFromWorldRect() {
+  if (!state.selectionRect || !state.camera || !activeMap()) return;
+  const rect = canvas.getBoundingClientRect();
+  if (!rect.width || !rect.height) return;
+  if (Array.isArray(state.selectionRect.polygon) && state.selectionRect.polygon.length >= 3) {
+    const points = state.selectionRect.polygon.map(worldCellToOverlayPoint)
+      .map((p) => ({ x: Math.min(Math.max(p.x, 0), rect.width), y: Math.min(Math.max(p.y, 0), rect.height) }));
+    drawSelectionSvg(points, !validatePatchRect(state.selectionRect, state.world).ok);
+    if (selectionEl) selectionEl.style.display = "none";
+    return;
+  }
+  const cameraX = Math.round(state.camera.x || 0);
+  const cameraY = Math.round(state.camera.y || 0);
+  const p0 = mapPixelToScreenPoint((state.selectionRect.x0 - cameraX) * CELL_SIZE, (state.selectionRect.y0 - cameraY) * CELL_SIZE);
+  const p1 = mapPixelToScreenPoint((state.selectionRect.x1 - cameraX) * CELL_SIZE, (state.selectionRect.y1 - cameraY) * CELL_SIZE);
+  const vx0 = p0.x - canvas.offsetLeft;
+  const vy0 = p0.y - canvas.offsetTop;
+  const vx1 = p1.x - canvas.offsetLeft;
+  const vy1 = p1.y - canvas.offsetTop;
+  const x0 = Math.min(Math.max(Math.min(vx0, vx1), 0), rect.width);
+  const y0 = Math.min(Math.max(Math.min(vy0, vy1), 0), rect.height);
+  const x1 = Math.min(Math.max(Math.max(vx0, vx1), 0), rect.width);
+  const y1 = Math.min(Math.max(Math.max(vy0, vy1), 0), rect.height);
+  if (x1 - x0 < 1 || y1 - y0 < 1) {
+    selectionEl.style.display = "none";
+    return;
+  }
+  hideSelectionSvg();
+  selectionEl.style.display = "block";
+  selectionEl.style.left = `${canvas.offsetLeft + x0}px`;
+  selectionEl.style.top = `${canvas.offsetTop + y0}px`;
+  selectionEl.style.width = `${Math.max(1, x1 - x0)}px`;
+  selectionEl.style.height = `${Math.max(1, y1 - y0)}px`;
+  const validation = validatePatchRect(state.selectionRect, state.world);
+  selectionEl.classList.toggle("invalid", !validation.ok);
+}
+
+function formatRectSize(rect) {
+  if (!rect) return "-";
+  const w = Math.max(0, rect.x1 - rect.x0);
+  const h = Math.max(0, rect.y1 - rect.y0);
+  const area = Math.max(0, rect.areaCells || (w * h));
+  return `${w} x ${h} cells / ${area.toLocaleString()} cells`;
+}
+
+function normalizePatchVariant(value) {
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) ? Math.max(0, parsed) >>> 0 : 0;
+}
+
+function setPatchVariant(value, { update = true } = {}) {
+  state.patchVariant = normalizePatchVariant(value);
+  if (patchVariantInput && patchVariantInput.value !== String(state.patchVariant)) {
+    patchVariantInput.value = String(state.patchVariant);
+  }
+  if (update) updatePatchControls();
+  return state.patchVariant;
+}
+
+function readPatchVariant() {
+  return setPatchVariant(patchVariantInput?.value ?? state.patchVariant, { update: false });
+}
+
+function resetPatchVariant({ update = true } = {}) {
+  return setPatchVariant(0, { update });
+}
+
+function updatePatchControls() {
+  const variant = readPatchVariant();
+  const validation = validatePatchRect(state.selectionRect, state.world);
+  const hasValidSelection = !!validation.ok;
+  const hasPreview = !!state.pendingPatch;
+  const busy = !!state.patchBusy;
+  if (generatePatchButton) generatePatchButton.disabled = !hasValidSelection || busy;
+  if (alternativePatchButton) alternativePatchButton.disabled = !hasValidSelection || busy;
+  if (applyPatchButton) applyPatchButton.disabled = !hasPreview || busy;
+  if (discardPatchButton) discardPatchButton.disabled = !hasPreview || busy;
+  if (clearPatchSelectionButton) clearPatchSelectionButton.disabled = !state.selectionRect || busy;
+  if (cancelPatchButton) cancelPatchButton.disabled = !busy;
+  if (patchVariantInput) patchVariantInput.disabled = busy;
+  if (!patchStatusEl) return;
+  if (!state.selectionRect) {
+    patchStatusEl.textContent = state.toolMode === "patch"
+      ? `Right-drag a freeform patch area. Minimum: ${PATCH_MIN_WIDTH} x ${PATCH_MIN_HEIGHT} cells and ${PATCH_MIN_AREA.toLocaleString()} cells.`
+      : "Right-drag on the map to draw a patch area.";
+    patchStatusEl.classList.toggle("invalid", false);
+    return;
+  }
+  if (!validation.ok) {
+    patchStatusEl.textContent = `${validation.reason} Current: ${formatRectSize(validation.rect || state.selectionRect)}.`;
+    patchStatusEl.classList.toggle("invalid", true);
+    return;
+  }
+  const rects = buildPatchRects(validation.rect, state.world);
+  const shownPatch = state.pendingPatch?.result || state.lastPatchResult;
+  const candidateModeText = shownPatch?.patchGenerationMode || "";
+  const delta = state.pendingPatch?.previewDelta || shownPatch?.previewDelta || null;
+  const deltaText = delta
+    ? ` Changed ${Number(delta.changedCells || 0).toLocaleString()} cells (${Number(delta.terrainChangedCells || 0).toLocaleString()} terrain / ${Number(delta.adminChangedCells || 0).toLocaleString()} admin).`
+    : "";
+  const previewText = state.pendingPatch
+    ? ` Preview ready: ${shownPatch?.label || "candidate"}, variant ${shownPatch?.variant ?? variant}${candidateModeText ? `, ${candidateModeText}` : ""}.${deltaText} Use Apply Preview or Discard.`
+    : shownPatch
+      ? ` Last applied: ${shownPatch.label || "patch"}, variant ${shownPatch.variant ?? "-"}${candidateModeText ? `, ${candidateModeText}` : ""}.`
+      : "";
+  const busyText = state.patchBusy
+    ? ` Generating variant ${state.patchBusyVariant ?? variant}; the currently displayed map will be replaced only after a verified preview is rendered.`
+    : "";
+  const statusText = state.patchStatusMessage ? ` ${state.patchStatusMessage}` : "";
+  patchStatusEl.textContent = `Selection: ${formatRectSize(validation.rect)}. Core ${formatRectSize(rects.coreRect)} / write ${formatRectSize(rects.writeRect)}.${previewText}${busyText}${statusText}`;
+  patchStatusEl.classList.toggle("invalid", false);
+}
+
+function setToolMode(mode) {
+  state.toolMode = mode === "patch" ? "patch" : "pan";
+  toolPanButton?.classList.toggle("active", state.toolMode === "pan");
+  toolPatchButton?.classList.toggle("active", state.toolMode === "patch");
+  toolHintEl?.classList.toggle("hidden", state.toolMode !== "patch");
+  canvasShell?.classList.toggle("patch-intent", state.toolMode === "patch");
+  updatePatchControls();
+}
+
+function setZoomKeepingCenter(nextZoom) {
+  const startedAt = performance.now();
+  const renderWorld = displayWorld();
+  if (!renderWorld) return;
+  const oldSize = viewportSizeForZoom(state.zoom);
+  const centerWorld = {
+    x: Math.round((state.camera?.x || 0) + oldSize.width / 2),
+    y: Math.round((state.camera?.y || 0) + oldSize.height / 2),
+  };
+  state.zoom = clampZoom(nextZoom);
+  const nextSize = syncViewportSize();
+  state.camera = clampCameraForView({
+    x: Math.round(centerWorld.x - nextSize.width / 2),
+    y: Math.round(centerWorld.y - nextSize.height / 2),
+  }, nextSize, renderWorld);
+  redraw({ fastTerrain: false, allowWorldExpand: false });
+  recordInteractionLatency("zoom button", startedAt, { zoom: state.zoom });
+}
+
+function recenterMap() {
+  const renderWorld = displayWorld();
+  if (!renderWorld) return;
+  state.camera = createInitialCamera(renderWorld);
+  redraw({ fastTerrain: false, allowWorldExpand: false });
+}
+
+function clearDragMode() {
+  dragState.mode = null;
+  dragState.pointerId = null;
+  dragState.pendingCamera = null;
+  dragState.panRemainderX = 0;
+  dragState.panRemainderY = 0;
+  if (dragState.panRaf != null) {
+    cancelAnimationFrame(dragState.panRaf);
+    dragState.panRaf = null;
+  }
+  dragState.panLatencyStartedAt = null;
+  canvasShell?.classList.remove("panning", "selecting");
+}
+
+function schedulePanRedraw(camera) {
+  dragState.pendingCamera = camera;
+  if (!dragState.panLatencyStartedAt) dragState.panLatencyStartedAt = performance.now();
+  if (dragState.panRaf != null) return;
+  dragState.panRaf = requestAnimationFrame(() => {
+    dragState.panRaf = null;
+    if (!dragState.pendingCamera) return;
+    const next = dragState.pendingCamera;
+    dragState.pendingCamera = null;
+    if (next.x === state.camera.x && next.y === state.camera.y) return;
+    const startedAt = dragState.panLatencyStartedAt || performance.now();
+    dragState.panLatencyStartedAt = null;
+    state.camera = next;
+    // Do not auto-expand the backing world while a pointer drag is active.
+    // Expansion shifts world coordinates; doing it mid-drag invalidates the
+    // pointer-to-camera baseline and can make the viewport appear to jump.
+    redraw({ fastTerrain: true, allowWorldExpand: false });
+    recordInteractionLatency("pan", startedAt, { zoom: state.zoom, fast: true });
+  });
+}
+
+function commitPendingPatch({ redrawAfter = true } = {}) {
+  if (!state.pendingPatch?.world) return false;
+  state.world = state.pendingPatch.world;
+  state.map = state.world.sourceMap || state.map;
+  state.lastPatchResult = state.pendingPatch.result || state.world.lastPatchResult || state.lastPatchResult;
+  state.pendingPatch = null;
+  state.patchStatusMessage = "";
+  state.viewportMap = null;
+  if (redrawAfter) {
+    renderStats(displaySourceMap());
+    redraw({ fastTerrain: true, allowWorldExpand: false });
+    window.setTimeout(() => redraw({ fastTerrain: false, allowWorldExpand: false }), 80);
+  }
+  return true;
+}
+
+function discardPendingPatch({ redrawAfter = true } = {}) {
+  if (!state.pendingPatch) return false;
+  state.pendingPatch = null;
+  state.patchStatusMessage = "";
+  state.viewportMap = null;
+  if (redrawAfter) {
+    renderStats(displaySourceMap());
+    redraw({ fastTerrain: false, allowWorldExpand: false });
+  }
+  return true;
+}
+
+function hideSelectionOverlay(options = {}) {
+  const commitPreview = options.commitPreview === true;
+  const discardPreview = options.discardPreview === true || (!commitPreview && options.keepPreview !== true && !!state.pendingPatch);
+  if (commitPreview) commitPendingPatch({ redrawAfter: false });
+  else if (discardPreview) discardPendingPatch({ redrawAfter: false });
+  dragState.selectStart = null;
+  dragState.selectEnd = null;
+  dragState.selectPath = null;
+  state.selectionRect = null;
+  resetPatchVariant({ update: false });
+  hideSelectionSvg();
+  if (selectionEl) selectionEl.style.display = "none";
+  state.viewportMap = null;
+  renderStats(displaySourceMap());
+  updatePatchControls();
+  if (commitPreview || discardPreview) redraw({ fastTerrain: false, allowWorldExpand: false });
+}
+
+function selectionPixelsToCells(start, end) {
+  const a = screenPointToWorldCell(start);
+  const b = screenPointToWorldCell(end);
+  if (!a || !b) return null;
+  return {
+    x0: Math.min(a.x, b.x),
+    y0: Math.min(a.y, b.y),
+    x1: Math.max(a.x, b.x) + 1,
+    y1: Math.max(a.y, b.y) + 1,
+  };
+}
+
+function selectionPixelsToShape(start, end, path = null) {
+  if (Array.isArray(path) && path.length >= 3) return selectionPathToShape(path);
+  return selectionPixelsToCells(start, end);
+}
+
+function handleMapPointerDown(event) {
+  if (!state.world || !canvasShell) return;
+  if (event.button !== 0 && event.button !== 2) return;
+  dragState.pointerId = event.pointerId;
+  dragState.startClientX = event.clientX;
+  dragState.startClientY = event.clientY;
+  dragState.startCameraX = state.camera.x;
+  dragState.startCameraY = state.camera.y;
+  dragState.lastClientX = event.clientX;
+  dragState.lastClientY = event.clientY;
+  dragState.panRemainderX = 0;
+  dragState.panRemainderY = 0;
+  tooltipEl?.classList.remove("visible");
+
+  if (event.button === 0) {
+    dragState.mode = "pan";
+    canvasShell.classList.add("panning");
+  } else {
+    if (state.toolMode !== "patch") setToolMode("patch");
+    if (state.pendingPatch) discardPendingPatch({ redrawAfter: false });
+    state.selectionRect = null;
+    hideSelectionSvg();
+    if (selectionEl) selectionEl.style.display = "none";
+    dragState.mode = "select";
+    dragState.selectStart = clampCanvasPoint(event);
+    dragState.selectEnd = dragState.selectStart;
+    dragState.selectPath = [dragState.selectStart];
+    canvasShell.classList.add("selecting");
+    updateSelectionOverlay();
+  }
+
+  canvas.setPointerCapture?.(event.pointerId);
+  event.preventDefault();
+}
+
+function handleMapPointerMove(event) {
+  if (!dragState.mode || dragState.pointerId !== event.pointerId || !canvasShell) return;
+  tooltipEl?.classList.remove("visible");
+
+  if (dragState.mode === "pan") {
+    const rect = canvas.getBoundingClientRect();
+    const maxDeltaX = Math.max(320, rect.width * 0.72);
+    const maxDeltaY = Math.max(240, rect.height * 0.72);
+    const rawDx = event.clientX - dragState.lastClientX;
+    const rawDy = event.clientY - dragState.lastClientY;
+    dragState.lastClientX = event.clientX;
+    dragState.lastClientY = event.clientY;
+
+    // Pointer capture can occasionally deliver a stale/outlier coordinate after
+    // a tab switch, resize, context-menu gesture, or OS-level event hiccup.  A
+    // single implausibly large delta would otherwise become a large camera jump.
+    if (Math.abs(rawDx) <= maxDeltaX && Math.abs(rawDy) <= maxDeltaY) {
+      const cellSize = Math.max(1, displayedCellSize());
+      const totalX = dragState.panRemainderX + rawDx / cellSize;
+      const totalY = dragState.panRemainderY + rawDy / cellSize;
+      const dxCells = totalX < 0 ? Math.ceil(totalX) : Math.floor(totalX);
+      const dyCells = totalY < 0 ? Math.ceil(totalY) : Math.floor(totalY);
+      dragState.panRemainderX = totalX - dxCells;
+      dragState.panRemainderY = totalY - dyCells;
+      if (dxCells || dyCells) {
+        const base = dragState.pendingCamera || state.camera;
+        const nextCamera = clampCameraForView({
+          x: base.x - dxCells,
+          y: base.y - dyCells,
+        }, viewportSizeForZoom(state.zoom));
+        schedulePanRedraw(nextCamera);
+      }
+    }
+  } else if (dragState.mode === "select") {
+    dragState.selectEnd = clampCanvasPoint(event);
+    if (!dragState.selectPath || Math.hypot(dragState.selectEnd.x - dragState.selectPath[dragState.selectPath.length - 1].x, dragState.selectEnd.y - dragState.selectPath[dragState.selectPath.length - 1].y) >= 3) {
+      dragState.selectPath = [...(dragState.selectPath || []), dragState.selectEnd];
+    }
+    updateSelectionOverlay();
+  }
+
+  event.preventDefault();
+}
+
+function handleMapPointerUp(event) {
+  if (dragState.pointerId !== event.pointerId) return;
+  const wasPanning = dragState.mode === "pan";
+  if (dragState.mode === "select") {
+    dragState.selectEnd = clampCanvasPoint(event);
+    if (!dragState.selectPath || dragState.selectPath.length < 2) dragState.selectPath = [dragState.selectStart, dragState.selectEnd];
+    else dragState.selectPath = [...dragState.selectPath, dragState.selectEnd];
+    const shape = selectionPixelsToShape(dragState.selectStart, dragState.selectEnd, dragState.selectPath);
+    const width = Math.abs(dragState.selectEnd.x - dragState.selectStart.x);
+    const height = Math.abs(dragState.selectEnd.y - dragState.selectStart.y);
+    if (shape && (dragState.selectPath.length >= 3 || (width >= 4 && height >= 4))) {
+      state.selectionRect = shape;
+      state.lastPatchResult = null;
+      state.patchStatusMessage = "";
+      resetPatchVariant({ update: false });
+      updateSelectionOverlayFromWorldRect();
+      updatePatchControls();
+    } else {
+      hideSelectionOverlay();
+    }
+  }
+  canvas.releasePointerCapture?.(event.pointerId);
+  if (wasPanning && dragState.pendingCamera) {
+    state.camera = dragState.pendingCamera;
+    dragState.pendingCamera = null;
+  }
+  clearDragMode();
+  if (wasPanning) {
+    const startedAt = performance.now();
+    redraw({ fastTerrain: false });
+    recordInteractionLatency("pan settle", startedAt, { zoom: state.zoom, fast: false });
+  }
+  event.preventDefault();
+}
+
+function parseSeed(seedText) {
+  const numeric = Number.parseInt(seedText, 10);
+  if (Number.isFinite(numeric)) return numeric >>> 0;
+
+  let hash = 2166136261;
+  for (const ch of seedText) hash = Math.imul(hash ^ ch.charCodeAt(0), 16777619);
+  return hash >>> 0;
+}
+
+function formatMs(ms) {
+  if (!Number.isFinite(ms)) return "-";
+  return ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${Math.round(ms)}ms`;
+}
+
+function formatSeconds(value, digits = 4) {
+  if (!Number.isFinite(value)) return "-";
+  return `${value.toFixed(digits)}s`;
+}
+
+function pushCapped(history, item, limit = 10) {
+  history.unshift(item);
+  if (history.length > limit) history.length = limit;
+}
+
+function countTruthyCells(mask) {
+  if (!mask || typeof mask.length !== "number") return 0;
+  let count = 0;
+  for (let i = 0; i < mask.length; i++) if (mask[i]) count++;
+  return count;
+}
+
+function mapAreaCells(map) {
+  if (!map) return MAP_W * MAP_H;
+  const focusedArea = countTruthyCells(map.focusedPrefectureMask || map.prefectureMask || map.humanRegionMask);
+  if (focusedArea > 0) return focusedArea;
+  return Math.max(1, (map.width || MAP_W) * (map.height || MAP_H));
+}
+
+function formatAreaCells(cells) {
+  return `${Math.max(0, Math.round(cells || 0)).toLocaleString()} cells`;
+}
+
+function rectAreaCells(rect) {
+  if (!rect) return 0;
+  return Math.max(0, Math.round((rect.x1 - rect.x0) * (rect.y1 - rect.y0)));
+}
+
+function terrainTypeLabel(value) {
+  const option = generationTypeInput ? Array.from(generationTypeInput.options).find((item) => item.value === value) : null;
+  return option?.textContent || value || "Auto";
+}
+
+function secondsPerThousandCells(totalMs, areaCells) {
+  const area = Math.max(1, areaCells || 0);
+  return (totalMs || 0) / area;
+}
+
+function numericValues(items, selector) {
+  return (items || [])
+    .map(selector)
+    .map(Number)
+    .filter((value) => Number.isFinite(value) && value >= 0);
+}
+
+function percentile(values, percentileRank) {
+  const sorted = [...values].sort((a, b) => a - b);
+  if (!sorted.length) return NaN;
+  if (sorted.length === 1) return sorted[0];
+  const rank = Math.min(Math.max(percentileRank, 0), 100) / 100 * (sorted.length - 1);
+  const lower = Math.floor(rank);
+  const upper = Math.ceil(rank);
+  if (lower === upper) return sorted[lower];
+  const weight = rank - lower;
+  return sorted[lower] * (1 - weight) + sorted[upper] * weight;
+}
+
+function summarizeValues(values) {
+  if (!values.length) return null;
+  const sum = values.reduce((acc, value) => acc + value, 0);
+  return {
+    count: values.length,
+    avg: sum / values.length,
+    max: Math.max(...values),
+    p95: percentile(values, 95),
+  };
+}
+
+function renderMetricGrid(container, metrics, emptyText = "No samples yet.") {
+  if (!container) return;
+  container.innerHTML = "";
+  const visibleMetrics = (metrics || []).filter(Boolean);
+  if (!visibleMetrics.length) {
+    renderEmptyState(container, emptyText);
+    return;
+  }
+  for (const metric of visibleMetrics) {
+    const card = document.createElement("div");
+    card.className = "metric-card";
+    card.innerHTML = `
+      <span>${metric.label}</span>
+      <strong>${metric.value}</strong>
+      ${metric.sub ? `<small>${metric.sub}</small>` : ""}
+    `;
+    container.append(card);
+  }
+}
+
+
+function formatPercent(value, digits = 1) {
+  if (!Number.isFinite(value)) return "-";
+  return `${value.toFixed(digits)}%`;
+}
+
+function countArray(value) {
+  return Array.isArray(value) ? value.length : 0;
+}
+
+function countPaths(paths) {
+  return (paths || []).reduce((sum, path) => sum + (Array.isArray(path) ? path.length : 0), 0);
+}
+
+function renderDiagnosticGrid(container, metrics, emptyText = "No diagnostics yet.") {
+  renderMetricGrid(container, metrics, emptyText);
+}
+
+function renderDiagnosticTable(container, rows, emptyText = "No diagnostics yet.") {
+  if (!container) return;
+  container.innerHTML = "";
+  const visibleRows = (rows || []).filter(Boolean);
+  if (!visibleRows.length) {
+    renderEmptyState(container, emptyText);
+    return;
+  }
+  for (const row of visibleRows) {
+    const item = document.createElement("div");
+    item.className = "diagnostic-row";
+    item.innerHTML = `
+      <span>${row.label}</span>
+      <strong>${row.value}</strong>
+      ${row.sub ? `<small>${row.sub}</small>` : ""}
+    `;
+    container.append(item);
+  }
+}
+
+function collectFeatureCounts(map = activeMap()) {
+  if (!map) return null;
+  const roads = [
+    ...(map.nationalRoads || []),
+    ...(map.ringRoads || []),
+    ...(map.externalRoads || []),
+    ...(map.expressways || []),
+    ...(map.externalExpressways || []),
+    ...(map.minorRoads || []),
+    ...(map.icAccessRoads || []),
+  ];
+  const railways = [
+    ...(map.railways || []),
+    ...(map.branchRailways || []),
+    ...(map.ringRailways || []),
+    ...(map.externalRailways || []),
+  ];
+  const rivers = [
+    ...(map.mainRivers || []),
+    ...(map.tributaryRivers || []),
+    ...(map.smallStreams || []),
+  ];
+  const settlements = [
+    ...(map.modernCities || []),
+    ...(map.satelliteCities || []),
+    ...(map.villages || []),
+    ...(map.markets || []),
+    ...(map.castles || []),
+    ...(map.ports || []),
+    ...(map.newTowns || []),
+  ];
+  const adminBorders = [
+    ...(map.adminBorders || []),
+    ...(map.prefectureBorder || []),
+    ...(map.regionalPrefectureBorders || []),
+  ];
+  return {
+    roads: roads.length,
+    roadCells: countPaths(roads),
+    railways: railways.length,
+    railwayCells: countPaths(railways),
+    rivers: rivers.length,
+    riverCells: countPaths(rivers),
+    settlements: settlements.length,
+    stations: countArray(map.stations),
+    labels: countArray(state.hoverEntities),
+    adminCenters: countArray(map.adminCenters),
+    adminBorders: adminBorders.length,
+    adminBorderCells: countPaths(adminBorders),
+    industrialZones: countArray(map.industrialZones),
+    logisticsParks: countArray(map.logisticsParks),
+  };
+}
+
+function recordDiagnosticLog(level, title, message = "", meta = {}) {
+  pushCapped(state.diagnosticLog, {
+    id: Date.now() + Math.random(),
+    createdAt: new Date(),
+    level: level || "info",
+    title: title || "Diagnostic",
+    message: String(message || ""),
+    meta,
+  });
+  renderAdvancedData();
+}
+
+function updateRenderDiagnostics(options = {}, timings = {}) {
+  const map = activeMap();
+  const canvasRect = canvas?.getBoundingClientRect?.();
+  const viewWidth = Math.max(1, state.viewWidth || map?.width || MAP_W);
+  const viewHeight = Math.max(1, state.viewHeight || map?.height || MAP_H);
+  state.diagnostics.lastViewport = {
+    viewWidth,
+    viewHeight,
+    cells: viewWidth * viewHeight,
+    mapWidth: map?.width || viewWidth,
+    mapHeight: map?.height || viewHeight,
+    cssWidth: canvasRect?.width || 0,
+    cssHeight: canvasRect?.height || 0,
+    bitmapWidth: canvas?.width || 0,
+    bitmapHeight: canvas?.height || 0,
+    zoom: state.zoom || 1,
+    mode: state.mode,
+    fast: !!options.fastTerrain,
+    showFeatures: state.showFeatures && !options.fastTerrain,
+    showLabels: state.showLabels && !options.fastTerrain,
+    showSeamDiagnostics: state.showSeamDiagnostics && !options.fastTerrain,
+    viewportMs: timings.viewportMs || 0,
+    hoverMs: timings.hoverMs || 0,
+    drawMs: timings.drawMs || 0,
+    totalRenderMs: timings.totalRenderMs || 0,
+    renderBreakdown: timings.renderBreakdown || null,
+  };
+  state.diagnostics.lastFeatureCounts = collectFeatureCounts(map);
+}
+
+function selectionWriteDiagnostics() {
+  const rect = state.selectionRect;
+  const validation = validatePatchRect(rect, state.world);
+  const currentSelection = validation.rect || rect;
+  const rects = validation.ok ? buildPatchRects(validation.rect, state.world, { patchMode: patchModeInput?.value || "auto" }) : null;
+  const selectedArea = currentSelection?.areaCells || rectAreaCells(currentSelection);
+  const writeArea = rects?.writeRect ? rectAreaCells(rects.writeRect) : 0;
+  const last = state.patchRuns[0];
+  const lastRatio = last?.areaCells ? (last.writeAreaCells || 0) / Math.max(1, last.areaCells) * 100 : NaN;
+  return [
+    { label: "Current selection", value: selectedArea ? formatAreaCells(selectedArea) : "none", sub: validation.ok ? "valid" : (rect ? validation.reason : "no active selection") },
+    { label: "Resolved patch mode", value: rects?.patchMode || "-", sub: rects ? `${rects.patchModeAutoDetected ? "auto" : "explicit"} · ${formatPercent((rects.coverageStats?.ungeneratedRatio || 0) * 100)} ungenerated` : "requires valid selection" },
+    { label: "Current write area", value: writeArea ? formatAreaCells(writeArea) : "-", sub: selectedArea ? `${formatPercent(writeArea / Math.max(1, selectedArea) * 100)} of selection` : "requires valid selection" },
+    { label: "Last patch selection", value: last ? formatAreaCells(last.areaCells) : "-", sub: last ? `${last.kind || "Patch"} · ${terrainTypeLabel(last.terrainType)}` : "no patch runs" },
+    { label: "Last patch write", value: last?.writeAreaCells ? formatAreaCells(last.writeAreaCells) : "-", sub: Number.isFinite(lastRatio) ? `${formatPercent(lastRatio)} of selection` : "no patch runs" },
+    { label: "Last patch variant", value: last ? String(last.variant ?? "-") : "-", sub: last?.label || "no candidate" },
+  ];
+}
+
+function renderViewportDiagnostics() {
+  const viewport = state.diagnostics.lastViewport;
+  const renderRows = viewport?.renderBreakdown ? [
+    { label: "Draw / base", value: formatMs(viewport.renderBreakdown.baseTerrain || 0), sub: "terrain raster" },
+    { label: "Draw / urban", value: formatMs(viewport.renderBreakdown.urbanFill || 0), sub: "land-use overlay" },
+    { label: "Draw / coast", value: formatMs(viewport.renderBreakdown.coastline || 0), sub: "coastline vectors" },
+    { label: "Draw / rivers", value: formatMs(viewport.renderBreakdown.rivers || 0), sub: "river paths" },
+    { label: "Draw / admin", value: formatMs(viewport.renderBreakdown.adminBorders || 0), sub: "fills and borders" },
+    { label: "Draw / transport", value: formatMs(viewport.renderBreakdown.transport || 0), sub: "roads and rail" },
+    { label: "Draw / labels", value: formatMs((viewport.renderBreakdown.icons || 0) + (viewport.renderBreakdown.labels || 0)), sub: "icons and text" },
+  ] : [];
+  renderDiagnosticGrid(advancedViewportDiagnosticsEl, viewport ? [
+    { label: "Viewport", value: `${viewport.viewWidth}×${viewport.viewHeight}`, sub: `${formatAreaCells(viewport.cells)} drawn` },
+    { label: "Canvas CSS", value: `${Math.round(viewport.cssWidth)}×${Math.round(viewport.cssHeight)}`, sub: "display pixels" },
+    { label: "Canvas bitmap", value: `${viewport.bitmapWidth}×${viewport.bitmapHeight}`, sub: "render target" },
+    { label: "Zoom", value: `${Number(viewport.zoom || 1).toFixed(2)}x`, sub: viewport.fast ? "fast redraw" : "full redraw" },
+    { label: "Viewport build", value: formatMs(viewport.viewportMs), sub: "getViewportMap" },
+    { label: "Canvas draw", value: formatMs(viewport.drawMs), sub: "drawMap" },
+    { label: "Hover index", value: formatMs(viewport.hoverMs), sub: "labels / hit targets" },
+    { label: "Render total", value: formatMs(viewport.totalRenderMs), sub: `${viewport.mode} mode` },
+    ...renderRows,
+  ] : [], "No viewport render recorded yet.");
+
+  const counts = state.diagnostics.lastFeatureCounts;
+  renderDiagnosticTable(advancedFeatureCountsEl, counts ? [
+    { label: "Road paths", value: counts.roads.toLocaleString(), sub: `${counts.roadCells.toLocaleString()} path cells` },
+    { label: "Rail paths", value: counts.railways.toLocaleString(), sub: `${counts.railwayCells.toLocaleString()} path cells` },
+    { label: "River paths", value: counts.rivers.toLocaleString(), sub: `${counts.riverCells.toLocaleString()} path cells` },
+    { label: "Settlements", value: counts.settlements.toLocaleString(), sub: "cities, towns, ports, castles" },
+    { label: "Stations", value: counts.stations.toLocaleString(), sub: "rail markers" },
+    { label: "Hover labels", value: counts.labels.toLocaleString(), sub: "active hit targets" },
+    { label: "Admin centers", value: counts.adminCenters.toLocaleString(), sub: "municipality labels" },
+    { label: "Admin borders", value: counts.adminBorders.toLocaleString(), sub: `${counts.adminBorderCells.toLocaleString()} path cells` },
+    { label: "Industry / logistics", value: (counts.industrialZones + counts.logisticsParks).toLocaleString(), sub: `${counts.industrialZones} industrial, ${counts.logisticsParks} logistics` },
+  ] : [], "No feature counts recorded yet.");
+}
+
+function renderPatchDiagnostics() {
+  renderDiagnosticTable(advancedPatchDiagnosticsEl, selectionWriteDiagnostics(), "No patch diagnostics yet.");
+}
+
+function currentSeamDiagnostics() {
+  return state.pendingPatch?.result?.seamDiagnostics
+    || state.lastPatchResult?.seamDiagnostics
+    || displaySourceMap()?.patchSeamDiagnostics
+    || null;
+}
+
+function seamDiagnosticRows() {
+  const d = currentSeamDiagnostics();
+  if (!d) return [];
+  const roadTotal = Number(d.roadPortalsBefore || 0);
+  const railTotal = Number(d.railPortalsBefore || 0);
+  const duplicateParts = [
+    `${Number(d.duplicateAdminBoundaryPairs || 0)} municipal`,
+    `${Number(d.duplicatePrefectureBoundaryPairs || 0)} prefecture`,
+    `${Number(d.overlappingAdminPrefecturePairs || 0)} overlap`,
+  ].join(" / ");
+  const modeSub = "production-sized full pipeline";
+  return [
+    { label: "Status", value: String(d.status || "-").toUpperCase(), sub: `${Number(d.criticalCount || 0)} critical / ${Number(d.warningCount || 0)} warning signals` },
+    { label: "Patch mode", value: d.patchMode || "-", sub: `${d.patchModeAutoDetected ? "auto-detected" : "explicit"} · ${formatPercent(Number(d.ungeneratedSelectionRatio || 0) * 100)} ungenerated · overlap ${Number(d.expansionOverlap || 0)} cells` },
+    { label: "World sea level", value: Number(d.worldSeaLevel || 0).toFixed(3), sub: "shared by initial and additional generation" },
+    { label: "Candidate mode", value: d.patchGenerationMode || "-", sub: modeSub },
+    { label: "Candidate window", value: `${Number(d.candidateWidth || 0)}×${Number(d.candidateHeight || 0)}`, sub: `${formatPercent(Number(d.candidateAreaRatio || 0) * 100)} of full candidate area` },
+    ...(d.qualityPolicyVersion ? [
+      { label: "Expansion quality gate", value: d.qualityHardPass ? "PASS" : "BEST AVAILABLE", sub: `${d.qualityPolicyVersion} · score ${Number(d.qualityScore || 0).toFixed(3)} · selected variant ${Number(d.qualitySelectedVariant || 0)}` },
+      { label: "Candidate land quality", value: formatPercent(Number(d.qualityLandRatio || 0) * 100), sub: `${d.qualityTerrainType || "-"} · ${formatPercent(Number(d.qualityDevelopableRatio || 0) * 100)} developable · ${formatPercent(Number(d.qualityLargestComponentRatio || 0) * 100)} largest component` },
+      { label: "Candidate place density", value: Number(d.qualityLabelCount || 0).toLocaleString(), sub: `${Number(d.qualitySettlementCount || 0)} settlements · ${Number(d.qualityLabelDensityPer1000 || 0).toFixed(2)} labels / 1000 land cells` },
+      { label: "Merged patch quality", value: d.qualityFinalHardPass ? "PASS" : "WARNING", sub: `${formatPercent(Number(d.qualityFinalOwnedLandRatio || 0) * 100)} land in owned interior · ${Number(d.qualityFinalLabelCount || 0)} labels / ${Number(d.qualityFinalSettlementCount || 0)} settlements` },
+    ] : []),
+    { label: "Seam band", value: Number(d.seamBandCells || 0).toLocaleString(), sub: "cells inspected" },
+    { label: "Coast flips", value: Number(d.seaFlipCells || 0).toLocaleString(), sub: `${Number(d.landToSeaCells || 0)} land→sea / ${Number(d.seaToLandCells || 0)} sea→land` },
+    { label: "Transport/coast conflicts", value: Number(d.transportLandToSeaConflicts || 0).toLocaleString(), sub: "existing road or rail cell changed to sea" },
+    { label: "Road seam portals", value: `${Number(d.roadPortalsConnected || 0)}/${roadTotal}`, sub: `${Number(d.roadPortalsBroken || 0)} disconnected` },
+    { label: "Rail seam portals", value: `${Number(d.railPortalsConnected || 0)}/${railTotal}`, sub: `${Number(d.railPortalsBroken || 0)} disconnected` },
+    { label: "New seam boundaries", value: `${Number(d.adminSeamBreakEdges || 0)} / ${Number(d.prefectureSeamBreakEdges || 0)}`, sub: "municipal / prefecture edges created where the old ID was continuous" },
+    { label: "Near-duplicate boundaries", value: Number(d.duplicateBoundaryPairs || 0).toLocaleString(), sub: duplicateParts },
+    { label: "Established frontier elevation", value: Number(d.maxEstablishedFrontierElevationJump || 0).toFixed(3), sub: `${Number(d.establishedFrontierElevationEdges || 0).toLocaleString()} land edges inspected · hard limit ${Number(d.gateBudgets?.maxEstablishedFrontierElevationJump || 0.075).toFixed(3)}` },
+    { label: "Elevation cliffs", value: Number(d.elevationCliffEdges || 0).toLocaleString(), sub: `max ${Number(d.maxElevationJump || 0).toFixed(3)} / mean ${Number(d.meanElevationJump || 0).toFixed(3)}` },
+    { label: "Map markers", value: Number(d.markerCount || 0).toLocaleString(), sub: state.showSeamDiagnostics ? "overlay visible" : "overlay hidden" },
+  ];
+}
+
+function renderSeamDiagnostics() {
+  renderDiagnosticTable(advancedSeamDiagnosticsEl, seamDiagnosticRows(), "Generate a patch preview to collect seam diagnostics.");
+}
+
+function renderWorkerWorldDiagnostics() {
+  const workerAvailable = typeof Worker !== "undefined";
+  const workerRows = [
+    { label: "Worker API", value: workerAvailable ? "available" : "unavailable", sub: "browser capability" },
+    { label: "Full-generation worker", value: generationWorker ? "active" : "not active", sub: state.diagnostics.lastGenerationWorkerUsed == null ? "created on demand" : (state.diagnostics.lastGenerationWorkerUsed ? "last full generation used worker" : "last full generation used main thread") },
+    { label: "Generation fallback", value: state.diagnostics.lastGenerationWorkerFallbackReason || "none", sub: "full-map generation" },
+    { label: "Patch worker object", value: patchWorker ? "active" : "not active", sub: patchWorker ? "created" : "created on demand" },
+    { label: "Last patch worker", value: state.diagnostics.lastWorkerUsed == null ? "-" : (state.diagnostics.lastWorkerUsed ? "used" : "main thread"), sub: state.diagnostics.lastPatchWorkerKind || "no patch run" },
+    { label: "Patch fallback", value: state.diagnostics.lastWorkerFallbackReason || "none", sub: "last patch worker fallback" },
+  ];
+  renderDiagnosticTable(advancedWorkerDiagnosticsEl, workerRows);
+
+  const world = displayWorld();
+  const source = displaySourceMap();
+  const expansion = state.diagnostics.lastWorldExpansion;
+  renderDiagnosticTable(advancedWorldDiagnosticsEl, [
+    { label: "World size", value: world ? `${world.width}×${world.height}` : "-", sub: world ? formatAreaCells(world.width * world.height) : "no world" },
+    { label: "Source map", value: source ? `${source.width || MAP_W}×${source.height || MAP_H}` : "-", sub: source ? formatAreaCells((source.width || MAP_W) * (source.height || MAP_H)) : "no source" },
+    { label: "Camera", value: state.camera ? `${Math.round(state.camera.x || 0)}, ${Math.round(state.camera.y || 0)}` : "-", sub: "world-space origin" },
+    { label: "World expansions", value: state.diagnostics.worldExpansionCount.toLocaleString(), sub: expansion ? `last dx ${expansion.dx}, dy ${expansion.dy}` : "none yet" },
+    { label: "Pending patch", value: state.pendingPatch ? "yes" : "no", sub: state.pendingPatch ? `${terrainTypeLabel(state.pendingPatch.terrainType)} · variant ${state.pendingPatch.variant}` : "committed world" },
+  ]);
+}
+
+function renderWarningHistory() {
+  if (!advancedWarningHistoryEl) return;
+  advancedWarningHistoryEl.innerHTML = "";
+  if (!state.diagnosticLog.length) {
+    renderEmptyState(advancedWarningHistoryEl, "No warnings or errors recorded yet.");
+    return;
+  }
+  for (const entry of state.diagnosticLog) {
+    const row = document.createElement("div");
+    row.className = `diagnostic-log-row ${entry.level || "info"}`;
+    const time = entry.createdAt instanceof Date ? entry.createdAt.toLocaleTimeString() : "-";
+    row.innerHTML = `
+      <span>${time}</span>
+      <strong>${entry.title}</strong>
+      <p>${entry.message || "-"}</p>
+    `;
+    advancedWarningHistoryEl.append(row);
+  }
+}
+
+function performanceMetricsForRuns(runs) {
+  const totals = summarizeValues(numericValues(runs, (run) => run.totalMs));
+  const perArea = summarizeValues(numericValues(runs, (run) => run.secondsPerThousand));
+  if (!totals) return [];
+  const hasSmallAreaRuns = (runs || []).some((run) => Number(run?.areaCells) > 0 && Number(run.areaCells) < 1000);
+  const perAreaSub = hasSmallAreaRuns ? "area-normalized; small runs include fixed overhead" : "seconds / 1k cells";
+  return [
+    { label: "Samples", value: String(totals.count), sub: "last 10" },
+    { label: "Avg total", value: formatMs(totals.avg), sub: "generation time" },
+    { label: "Max total", value: formatMs(totals.max), sub: "slowest run" },
+    { label: "P95 total", value: formatMs(totals.p95), sub: "tail latency" },
+    perArea ? { label: "Avg / 1k", value: formatSeconds(perArea.avg), sub: perAreaSub } : null,
+    perArea ? { label: "P95 / 1k", value: formatSeconds(perArea.p95), sub: hasSmallAreaRuns ? "fixed overhead dominated below 1k cells" : "area-normalized" } : null,
+  ];
+}
+
+function recordGenerationRun(map, terrainType) {
+  if (!map) return;
+  const area = mapAreaCells(map);
+  const totalMs = Number.isFinite(map.generationTotalMs)
+    ? map.generationTotalMs
+    : (map.generationTimings || []).reduce((sum, row) => sum + (Number(row?.ms) || 0), 0);
+  const featureTimings = (map.transportDebug?.featureTimings || []).map((row) => ({
+    label: `Settlements / ${row.key || "substage"}`,
+    ms: Number(row.ms) || 0,
+  }));
+  pushCapped(state.generationRuns, {
+    id: Date.now(),
+    createdAt: new Date(),
+    terrainType: terrainType || "auto",
+    areaCells: area,
+    totalMs,
+    secondsPerThousand: secondsPerThousandCells(totalMs, area),
+    timings: (map.generationTimings || []).map((row) => ({
+      label: row.label || row.key || "Stage",
+      ms: Number(row.ms) || 0,
+    })).concat(featureTimings),
+  });
+  renderAdvancedData();
+}
+
+function recordPatchRun(result, terrainType, selectionRect, variant, meta = {}) {
+  if (!result) return;
+  const timings = (result.patchTimings || []).map((row) => ({
+    label: row.label || row.key || "Stage",
+    ms: Number(row.ms) || 0,
+  }));
+  const totalMs = Number.isFinite(meta.wallMs)
+    ? meta.wallMs
+    : timings.reduce((sum, row) => sum + (Number(row.ms) || 0), 0);
+  const selectionArea = result.selectionShape?.areaCells || selectionRect?.areaCells || rectAreaCells(selectionRect);
+  const writeArea = rectAreaCells(result.writeRect || result.rects?.writeRect || selectionRect);
+  const area = Math.max(1, Math.round(selectionArea || writeArea || 1));
+  const writeRatio = writeArea / Math.max(1, area);
+  const usedWorker = meta.worker === true;
+  pushCapped(state.patchRuns, {
+    id: Date.now(),
+    createdAt: new Date(),
+    kind: meta.kind || "Patch preview",
+    terrainType: terrainType || result.terrainType || "auto",
+    variant: Number.isFinite(variant) ? variant : result.variant,
+    worker: usedWorker,
+    label: result.label || "candidate",
+    patchGenerationMode: result.patchGenerationMode || "-",
+    patchMode: result.patchMode || "regeneration",
+    patchModeAutoDetected: !!result.patchModeAutoDetected,
+    ungeneratedSelectionRatio: result.coverageStats?.ungeneratedRatio || 0,
+    seamStatus: result.seamDiagnostics?.status || "-",
+    areaCells: area,
+    writeAreaCells: writeArea,
+    writeRatio,
+    totalMs,
+    secondsPerThousand: secondsPerThousandCells(totalMs, area),
+    timings,
+  });
+  state.diagnostics.lastWorkerUsed = usedWorker;
+  state.diagnostics.lastPatchWorkerKind = meta.kind || "Patch preview";
+  if (usedWorker) state.diagnostics.lastWorkerFallbackReason = null;
+  renderAdvancedData();
+}
+
+function interactionAction(kind = "") {
+  const label = String(kind).toLowerCase();
+  if (label.includes("pan")) return "pan";
+  if (label.includes("zoom")) return "zoom";
+  return label || "other";
+}
+
+function interactionPhase(run) {
+  return run.fast ? "fast" : "full";
+}
+
+function interactionGroupLabel(action, phase) {
+  const actionLabel = action === "pan" ? "Pan" : action === "zoom" ? "Zoom" : action;
+  return `${actionLabel} / ${phase === "fast" ? "fast redraw" : "full redraw"}`;
+}
+
+function recordInteractionLatency(kind, startedAt, meta = {}) {
+  if (!Number.isFinite(startedAt)) return;
+  const ms = performance.now() - startedAt;
+  if (!Number.isFinite(ms) || ms < 0) return;
+  const item = {
+    id: Date.now(),
+    createdAt: new Date(),
+    kind,
+    ms,
+    zoom: Number.isFinite(meta.zoom) ? meta.zoom : state.zoom,
+    fast: meta.fast === true,
+  };
+  item.action = interactionAction(kind);
+  item.phase = interactionPhase(item);
+  pushCapped(state.interactionRuns, item);
+  renderAdvancedData();
+}
+
+function renderEmptyState(container, text) {
+  if (!container) return;
+  container.innerHTML = "";
+  const empty = document.createElement("div");
+  empty.className = "perf-empty";
+  empty.textContent = text;
+  container.append(empty);
+}
+
+function appendRunHistory(container, runs, options = {}) {
+  if (!container) return;
+  container.innerHTML = "";
+  if (!runs.length) {
+    renderEmptyState(container, options.emptyText || "No runs recorded yet.");
+    return;
+  }
+  runs.forEach((run, index) => {
+    const item = document.createElement("details");
+    item.className = "perf-run";
+    if (index === 0) item.open = true;
+
+    const summary = document.createElement("summary");
+    summary.className = options.patch ? "perf-summary patch" : "perf-summary";
+    const name = options.patch
+      ? `${run.kind || "Patch"} · ${terrainTypeLabel(run.terrainType)}`
+      : terrainTypeLabel(run.terrainType);
+    summary.innerHTML = `
+      <span class="perf-rank">#${index + 1}</span>
+      <span>${name}</span>
+      <strong>${formatMs(run.totalMs)}</strong>
+      <span>${formatAreaCells(run.areaCells)}${options.patch && run.writeAreaCells ? ` / write ${formatAreaCells(run.writeAreaCells)}` : ""}</span>
+      <span>${formatSeconds(run.secondsPerThousand)} / 1k cells${run.areaCells && run.areaCells < 1000 ? " (fixed overhead)" : ""}</span>
+    `;
+
+    const body = document.createElement("div");
+    body.className = "timing-grid";
+    if (options.patch) {
+      const meta = document.createElement("div");
+      meta.className = "timing-pill meta";
+      meta.innerHTML = `<span>Variant</span><strong>${run.variant ?? "-"}</strong>`;
+      const worker = document.createElement("div");
+      worker.className = "timing-pill meta";
+      worker.innerHTML = `<span>Worker</span><strong>${run.worker ? "yes" : "no"}</strong>`;
+      const ratio = document.createElement("div");
+      ratio.className = "timing-pill meta";
+      ratio.innerHTML = `<span>Write / selection</span><strong>${formatPercent((run.writeRatio || 0) * 100)}</strong>`;
+      const candidateMode = document.createElement("div");
+      candidateMode.className = "timing-pill meta";
+      candidateMode.innerHTML = `<span>Candidate</span><strong>${run.patchGenerationMode || "-"}</strong>`;
+      const seam = document.createElement("div");
+      seam.className = "timing-pill meta";
+      seam.innerHTML = `<span>Seam</span><strong>${String(run.seamStatus || "-").toUpperCase()}</strong>`;
+      body.append(meta, worker, ratio, candidateMode, seam);
+    }
+    for (const row of run.timings) {
+      const timing = document.createElement("div");
+      timing.className = "timing-pill";
+      timing.innerHTML = `<span>${row.label}</span><strong>${formatMs(row.ms)}</strong>`;
+      body.append(timing);
+    }
+    if (!run.timings.length) {
+      const empty = document.createElement("div");
+      empty.className = "perf-empty inline";
+      empty.textContent = "No stage breakdown available.";
+      body.append(empty);
+    }
+
+    item.append(summary, body);
+    container.append(item);
+  });
+}
+
+function renderGenerationHistory() {
+  renderMetricGrid(advancedGenerationStatsEl, performanceMetricsForRuns(state.generationRuns), "No generation runs recorded yet.");
+  appendRunHistory(advancedGenerationHistoryEl, state.generationRuns, {
+    emptyText: "No generation runs recorded yet.",
+  });
+}
+
+function renderPatchHistory() {
+  renderMetricGrid(advancedPatchStatsEl, performanceMetricsForRuns(state.patchRuns), "No patch generation runs recorded yet.");
+  appendRunHistory(advancedPatchHistoryEl, state.patchRuns, {
+    patch: true,
+    emptyText: "No patch generation runs recorded yet.",
+  });
+}
+
+function renderInteractionSummary() {
+  if (!advancedInteractionStatsEl) return;
+  advancedInteractionStatsEl.innerHTML = "";
+  if (!state.interactionRuns.length) {
+    renderEmptyState(advancedInteractionStatsEl, "No pan or zoom operations recorded yet.");
+    return;
+  }
+  const groups = new Map();
+  for (const run of state.interactionRuns) {
+    const action = run.action || interactionAction(run.kind);
+    const phase = run.phase || interactionPhase(run);
+    const key = `${action}:${phase}`;
+    if (!groups.has(key)) groups.set(key, { action, phase, values: [] });
+    groups.get(key).values.push(run.ms);
+  }
+  const table = document.createElement("div");
+  table.className = "aggregate-table";
+  for (const group of groups.values()) {
+    const stats = summarizeValues(group.values);
+    const row = document.createElement("div");
+    row.className = "aggregate-row";
+    row.innerHTML = `
+      <span>${interactionGroupLabel(group.action, group.phase)}</span>
+      <small>n=${stats.count}</small>
+      <strong>${formatMs(stats.avg)}</strong>
+      <strong>${formatMs(stats.max)}</strong>
+      <strong>${formatMs(stats.p95)}</strong>
+    `;
+    table.append(row);
+  }
+  advancedInteractionStatsEl.append(table);
+}
+
+function renderInteractionHistory() {
+  if (!advancedInteractionHistoryEl) return;
+  advancedInteractionHistoryEl.innerHTML = "";
+  if (!state.interactionRuns.length) {
+    renderEmptyState(advancedInteractionHistoryEl, "No pan or zoom operations recorded yet.");
+    return;
+  }
+  const table = document.createElement("div");
+  table.className = "interaction-table";
+  for (const run of state.interactionRuns) {
+    const row = document.createElement("div");
+    row.className = "interaction-row";
+    row.innerHTML = `
+      <span>${run.kind}</span>
+      <strong>${formatMs(run.ms)}</strong>
+      <span>${Number(run.zoom || 1).toFixed(2)}x</span>
+      <span>${run.fast ? "fast" : "full"}</span>
+    `;
+    table.append(row);
+  }
+  advancedInteractionHistoryEl.append(table);
+}
+
+function renderAdvancedData() {
+  renderGenerationHistory();
+  renderPatchHistory();
+  renderInteractionSummary();
+  renderInteractionHistory();
+  renderViewportDiagnostics();
+  renderPatchDiagnostics();
+  renderSeamDiagnostics();
+  renderWorkerWorldDiagnostics();
+  renderWarningHistory();
+}
+
+function reportValue(value) {
+  return value == null || value === "" ? "-" : String(value);
+}
+
+function reportRows(title, rows = []) {
+  const lines = [`[${title}]`];
+  const visibleRows = (rows || []).filter(Boolean);
+  if (!visibleRows.length) {
+    lines.push("- none");
+    return lines;
+  }
+  for (const row of visibleRows) {
+    const sub = row.sub ? ` (${row.sub})` : "";
+    lines.push(`- ${row.label}: ${reportValue(row.value)}${sub}`);
+  }
+  return lines;
+}
+
+function reportMetrics(title, runs = []) {
+  const lines = reportRows(title, performanceMetricsForRuns(runs));
+  if (!runs.length) return lines;
+  lines.push("Runs:");
+  runs.forEach((run, index) => {
+    const prefix = run.kind ? `${run.kind} · ` : "";
+    const variant = run.kind ? `, variant=${run.variant ?? "-"}, worker=${run.worker ? "yes" : "no"}` : "";
+    const write = run.writeAreaCells ? `, write=${formatAreaCells(run.writeAreaCells)}, write/selection=${formatPercent((run.writeRatio || 0) * 100)}` : "";
+    lines.push(`  ${index + 1}. ${prefix}${terrainTypeLabel(run.terrainType)}: total=${formatMs(run.totalMs)}, area=${formatAreaCells(run.areaCells)}, sec/1000 cells=${formatSeconds(run.secondsPerThousand)}${variant}${write}`);
+    if (run.timings?.length) {
+      lines.push(`     breakdown: ${run.timings.map((row) => `${row.label}=${formatMs(row.ms)}`).join(", ")}`);
+    }
+  });
+  return lines;
+}
+
+function interactionGroupsForReport() {
+  const groups = new Map();
+  for (const run of state.interactionRuns) {
+    const action = run.action || interactionAction(run.kind);
+    const phase = run.phase || interactionPhase(run);
+    const key = `${action}:${phase}`;
+    if (!groups.has(key)) groups.set(key, { action, phase, values: [] });
+    groups.get(key).values.push(run.ms);
+  }
+  return Array.from(groups.values()).map((group) => {
+    const stats = summarizeValues(group.values);
+    return {
+      label: interactionGroupLabel(group.action, group.phase),
+      value: `n=${stats.count}, avg=${formatMs(stats.avg)}, max=${formatMs(stats.max)}, p95=${formatMs(stats.p95)}`,
+    };
+  });
+}
+
+function reportInteractions() {
+  const lines = reportRows("Viewport Interaction Latency", interactionGroupsForReport());
+  if (!state.interactionRuns.length) return lines;
+  lines.push("Recent operations:");
+  state.interactionRuns.forEach((run, index) => {
+    lines.push(`  ${index + 1}. ${run.kind}: ${formatMs(run.ms)}, zoom=${Number(run.zoom || 1).toFixed(2)}x, phase=${run.fast ? "fast" : "full"}`);
+  });
+  return lines;
+}
+
+function viewportDiagnosticRowsForReport() {
+  const viewport = state.diagnostics.lastViewport;
+  return viewport ? [
+    { label: "Viewport", value: `${viewport.viewWidth}×${viewport.viewHeight}`, sub: `${formatAreaCells(viewport.cells)} drawn` },
+    { label: "Canvas CSS", value: `${Math.round(viewport.cssWidth)}×${Math.round(viewport.cssHeight)}`, sub: "display pixels" },
+    { label: "Canvas bitmap", value: `${viewport.bitmapWidth}×${viewport.bitmapHeight}`, sub: "render target" },
+    { label: "Zoom", value: `${Number(viewport.zoom || 1).toFixed(2)}x`, sub: viewport.fast ? "fast redraw" : "full redraw" },
+    { label: "Viewport build", value: formatMs(viewport.viewportMs), sub: "getViewportMap" },
+    { label: "Canvas draw", value: formatMs(viewport.drawMs), sub: "drawMap" },
+    { label: "Hover index", value: formatMs(viewport.hoverMs), sub: "labels / hit targets" },
+    { label: "Render total", value: formatMs(viewport.totalRenderMs), sub: `${viewport.mode} mode` },
+  ] : [];
+}
+
+function featureCountRowsForReport() {
+  const counts = state.diagnostics.lastFeatureCounts;
+  return counts ? [
+    { label: "Road paths", value: counts.roads.toLocaleString(), sub: `${counts.roadCells.toLocaleString()} path cells` },
+    { label: "Rail paths", value: counts.railways.toLocaleString(), sub: `${counts.railwayCells.toLocaleString()} path cells` },
+    { label: "River paths", value: counts.rivers.toLocaleString(), sub: `${counts.riverCells.toLocaleString()} path cells` },
+    { label: "Settlements", value: counts.settlements.toLocaleString(), sub: "cities, towns, ports, castles" },
+    { label: "Stations", value: counts.stations.toLocaleString(), sub: "rail markers" },
+    { label: "Hover labels", value: counts.labels.toLocaleString(), sub: "active hit targets" },
+    { label: "Admin centers", value: counts.adminCenters.toLocaleString(), sub: "municipality labels" },
+    { label: "Admin borders", value: counts.adminBorders.toLocaleString(), sub: `${counts.adminBorderCells.toLocaleString()} path cells` },
+    { label: "Industry / logistics", value: (counts.industrialZones + counts.logisticsParks).toLocaleString(), sub: `${counts.industrialZones} industrial, ${counts.logisticsParks} logistics` },
+  ] : [];
+}
+
+function workerDiagnosticRowsForReport() {
+  const workerAvailable = typeof Worker !== "undefined";
+  return [
+    { label: "Worker API", value: workerAvailable ? "available" : "unavailable", sub: "browser capability" },
+    { label: "Full-generation worker", value: generationWorker ? "active" : "not active", sub: state.diagnostics.lastGenerationWorkerUsed == null ? "created on demand" : (state.diagnostics.lastGenerationWorkerUsed ? "last full generation used worker" : "last full generation used main thread") },
+    { label: "Generation fallback", value: state.diagnostics.lastGenerationWorkerFallbackReason || "none", sub: "full-map generation" },
+    { label: "Patch worker object", value: patchWorker ? "active" : "not active", sub: patchWorker ? "created" : "created on demand" },
+    { label: "Last patch worker", value: state.diagnostics.lastWorkerUsed == null ? "-" : (state.diagnostics.lastWorkerUsed ? "used" : "main thread"), sub: state.diagnostics.lastPatchWorkerKind || "no patch run" },
+    { label: "Patch fallback", value: state.diagnostics.lastWorkerFallbackReason || "none", sub: "last patch worker fallback" },
+  ];
+}
+
+function worldDiagnosticRowsForReport() {
+  const world = displayWorld();
+  const source = displaySourceMap();
+  const expansion = state.diagnostics.lastWorldExpansion;
+  return [
+    { label: "World size", value: world ? `${world.width}×${world.height}` : "-", sub: world ? formatAreaCells(world.width * world.height) : "no world" },
+    { label: "Source map", value: source ? `${source.width || MAP_W}×${source.height || MAP_H}` : "-", sub: source ? formatAreaCells((source.width || MAP_W) * (source.height || MAP_H)) : "no source" },
+    { label: "Camera", value: state.camera ? `${Math.round(state.camera.x || 0)}, ${Math.round(state.camera.y || 0)}` : "-", sub: "world-space origin" },
+    { label: "World expansions", value: state.diagnostics.worldExpansionCount.toLocaleString(), sub: expansion ? `last dx ${expansion.dx}, dy ${expansion.dy}` : "none yet" },
+    { label: "Pending patch", value: state.pendingPatch ? "yes" : "no", sub: state.pendingPatch ? `${terrainTypeLabel(state.pendingPatch.terrainType)} · variant ${state.pendingPatch.variant}` : "committed world" },
+  ];
+}
+
+function reportWarnings() {
+  const lines = ["[Warnings / Errors]"];
+  if (!state.diagnosticLog.length) {
+    lines.push("- none");
+    return lines;
+  }
+  state.diagnosticLog.forEach((entry, index) => {
+    const time = entry.createdAt instanceof Date ? entry.createdAt.toISOString() : "-";
+    lines.push(`- ${index + 1}. ${time} ${String(entry.level || "info").toUpperCase()} ${entry.title}: ${entry.message || "-"}`);
+  });
+  return lines;
+}
+
+function buildImportantDebugReport() {
+  const source = displaySourceMap();
+  const summaryRows = getStats(source).map(([label, value]) => ({ label, value }));
+  const contextRows = [
+    { label: "Generated at", value: new Date().toISOString() },
+    { label: "Seed", value: seedInput?.value || state.seedText || "-" },
+    { label: "Generation type", value: terrainTypeLabel(generationTypeInput?.value || state.generationType), sub: generationTypeInput?.value || state.generationType },
+    { label: "Patch terrain", value: terrainTypeLabel(patchTerrainTypeInput?.value || "auto"), sub: patchTerrainTypeInput?.value || "auto" },
+    { label: "Patch mode", value: patchModeInput?.value || "auto", sub: "auto separates expansion from regeneration" },
+    { label: "Tool mode", value: state.toolMode || "-" },
+    { label: "Display mode", value: state.mode || "-" },
+    { label: "Features", value: state.showFeatures ? "on" : "off" },
+    { label: "Labels", value: state.showLabels ? "on" : "off" },
+  ];
+  return [
+    "Prefecture Map Generator — Important Debug Data",
+    "===============================================",
+    ...reportRows("Context", contextRows),
+    "",
+    ...reportRows("Current Map Summary", summaryRows),
+    "",
+    ...reportMetrics("Full Generation Performance", state.generationRuns),
+    "",
+    ...reportMetrics("Patch / Additional Generation Performance", state.patchRuns),
+    "",
+    ...reportInteractions(),
+    "",
+    ...reportRows("Viewport Diagnostics", viewportDiagnosticRowsForReport()),
+    "",
+    ...reportRows("Feature Counts", featureCountRowsForReport()),
+    "",
+    ...reportRows("Selection / Write Ratio", selectionWriteDiagnostics()),
+    "",
+    ...reportRows("Seam Diagnostics", seamDiagnosticRows()),
+    "",
+    ...reportRows("Worker Diagnostics", workerDiagnosticRowsForReport()),
+    "",
+    ...reportRows("World Diagnostics", worldDiagnosticRowsForReport()),
+    "",
+    ...reportWarnings(),
+  ].join("\n");
+}
+
+function setCopyDebugStatus(text, isError = false) {
+  if (!copyDebugStatusEl) return;
+  copyDebugStatusEl.textContent = text;
+  copyDebugStatusEl.classList.toggle("error", !!isError);
+  window.clearTimeout(setCopyDebugStatus.timer);
+  setCopyDebugStatus.timer = window.setTimeout(() => {
+    if (copyDebugStatusEl.textContent === text) copyDebugStatusEl.textContent = "";
+    copyDebugStatusEl.classList.remove("error");
+  }, 1800);
+}
+
+function copyTextFallback(text) {
+  const textarea = document.createElement("textarea");
+  textarea.value = text;
+  textarea.setAttribute("readonly", "");
+  textarea.style.position = "fixed";
+  textarea.style.left = "-9999px";
+  textarea.style.top = "0";
+  document.body.append(textarea);
+  textarea.select();
+  const ok = document.execCommand("copy");
+  textarea.remove();
+  if (!ok) throw new Error("Copy command failed");
+}
+
+async function copyImportantDebugData(event) {
+  event?.preventDefault?.();
+  event?.stopPropagation?.();
+  const text = buildImportantDebugReport();
+  try {
+    if (navigator.clipboard?.writeText) await navigator.clipboard.writeText(text);
+    else copyTextFallback(text);
+    setCopyDebugStatus("Copied");
+  } catch (error) {
+    console.warn("Failed to copy debug data", error);
+    try {
+      copyTextFallback(text);
+      setCopyDebugStatus("Copied");
+    } catch (fallbackError) {
+      console.warn("Fallback copy failed", fallbackError);
+      setCopyDebugStatus("Copy failed", true);
+    }
+  }
+}
+
+function renderTimingRows(timings = []) {
+  if (!progressTimingsEl) return;
+  progressTimingsEl.innerHTML = "";
+  for (const row of timings) {
+    const item = document.createElement("div");
+    item.className = "progress-timing-row";
+    const label = document.createElement("span");
+    label.textContent = row.label;
+    const value = document.createElement("strong");
+    value.textContent = formatMs(row.ms);
+    item.append(label, value);
+    progressTimingsEl.append(item);
+  }
+}
+
+function updateGenerationProgress(event) {
+  if (!progressEl) return;
+  progressEl.classList.remove("hidden");
+  if (event?.status === "start") generationCurrentStage = event.label || "Preparing";
+  if (progressStageEl) {
+    const elapsed = generationStartedAt ? ` / elapsed ${formatMs(performance.now() - generationStartedAt)}` : "";
+    progressStageEl.textContent = event?.status === "done"
+      ? `Completed: ${event.label} / ${formatMs(event.ms)}${elapsed}`
+      : `Running: ${event?.label || generationCurrentStage || "Preparing"}${elapsed}`;
+  }
+  renderTimingRows(event?.timings || []);
+}
+
+function setProgressVisible(visible, message = "Preparing") {
+  if (!progressEl) return;
+  progressEl.classList.toggle("hidden", !visible);
+  if (visible) {
+    generationStartedAt = performance.now();
+    generationCurrentStage = message;
+    if (generationTimer) window.clearInterval(generationTimer);
+    generationTimer = window.setInterval(() => {
+      if (progressStageEl && !progressEl.classList.contains("hidden")) {
+        progressStageEl.textContent = `Running: ${generationCurrentStage || "Preparing"} / elapsed ${formatMs(performance.now() - generationStartedAt)}`;
+      }
+    }, 100);
+  } else if (generationTimer) {
+    window.clearInterval(generationTimer);
+    generationTimer = null;
+  }
+  if (progressStageEl) progressStageEl.textContent = message;
+  if (visible) renderTimingRows([]);
+}
+
+function nextFrame() {
+  return new Promise((resolve) => requestAnimationFrame(() => resolve()));
+}
+
+function countInside(items) {
+  return (items || []).filter((item) => item?.insidePrefecture !== false).length;
+}
+
+function totalRailLineCount(map) {
+  return (map.railways || []).length + (map.branchRailways || []).length + (map.ringRailways || []).length + (map.externalRailways || []).length;
+}
+
+function getStats(map) {
+  if (!map) return [];
+  return [
+    ["Population", (map.totalPopulation || 0).toLocaleString()],
+    ["Municipalities", (map.adminCenters || []).length.toLocaleString()],
+    ["Major cities", countInside(map.modernCities).toLocaleString()],
+    ["Ports", countInside(map.ports).toLocaleString()],
+    ["Rail lines", totalRailLineCount(map).toLocaleString()],
+    ["Generation", map.generationTotalMs ? formatMs(map.generationTotalMs) : "-"],
+  ];
+}
+
+function renderStats(map) {
+  if (!statsEl) return;
+  statsEl.innerHTML = "";
+  for (const [labelText, valueText] of getStats(map)) {
+    const row = document.createElement("div");
+    row.className = "stat-row";
+
+    const label = document.createElement("span");
+    label.textContent = labelText;
+
+    const value = document.createElement("strong");
+    value.textContent = String(valueText);
+
+    row.append(label, value);
+    statsEl.append(row);
+  }
+}
+
+const legendItems = {
+  base: [
+    ["terrain-swatch", "Terrain shading"],
+    ["river-major", "Rivers and lakes", "line"],
+    ["border-swatch", "Prefecture border"],
+  ],
+  all: [
+    ["city-icon", "City / major town", "icon"],
+    ["rail-line", "Railway", "line"],
+    ["road-line", "Major road", "line"],
+    ["river-major", "River", "line"],
+    ["border-swatch", "Prefecture border"],
+  ],
+  terrain: [
+    ["terrain-swatch", "Elevation and relief"],
+    ["sea-swatch", "Sea / lake"],
+    ["river-major", "River system", "line"],
+    ["border-swatch", "Prefecture border"],
+  ],
+  modern: [
+    ["city-icon", "Modern city", "icon"],
+    ["station-icon", "Station", "icon"],
+    ["rail-line", "Railway", "line"],
+    ["minor-road-line", "Local road", "line"],
+  ],
+  history: [
+    ["town-icon", "Market / village", "icon"],
+    ["castle-icon", "Castle / ruins", "icon"],
+    ["port-icon", "Historical port", "icon"],
+    ["old-road-line", "Premodern road", "line"],
+  ],
+  landuse: [
+    ["urban-swatch", "Urban land use"],
+    ["industry-icon", "Industry / logistics", "icon"],
+    ["city-icon", "City core", "icon"],
+    ["river-major", "Water body", "line"],
+  ],
+  admin: [
+    ["admin-swatch", "Municipal border"],
+    ["border-swatch", "Prefecture border"],
+    ["city-icon", "Admin center", "icon"],
+  ],
+};
+
+function legendRowsForMode(mode) {
+  return legendItems[mode] || legendItems.all;
+}
+
+function renderLegendGrid(container, rows) {
+  if (!container) return;
+  container.innerHTML = "";
+  for (const [className, text, kind = "swatch"] of rows) {
+    const row = document.createElement("div");
+    row.className = "legend-row";
+    const mark = document.createElement("span");
+    mark.className = kind === "line" ? `legend-line ${className}` : kind === "icon" ? `legend-icon ${className}` : `legend-swatch ${className}`;
+    const label = document.createElement("span");
+    label.textContent = text;
+    row.append(mark, label);
+    container.append(row);
+  }
+}
+
+function renderLegend() {
+  const rows = legendRowsForMode(state.mode);
+  renderLegendGrid(mainLegendGrid, rows);
+  renderLegendGrid(floatingLegendGrid, rows.slice(0, 5));
+}
+
+function buildHoverEntities(map) {
+  return [
+    ...(map.modernCities || []),
+    ...(map.ports || []),
+    ...(map.stations || []),
+    ...(map.interchanges || []),
+    ...(map.industrialZones || []),
+    ...(map.logisticsParks || []),
+    ...(map.newTowns || []),
+    ...(map.castles || []),
+    ...(map.markets || []),
+    ...(map.villages || []),
+    ...(map.adminCenters || []),
+  ];
+}
+
+function nearestEntity(items, x, y, maxDistance = 5) {
+  let best = null;
+  let bestD = maxDistance;
+  for (const item of items || []) {
+    if (!item || !Number.isFinite(item.x) || !Number.isFinite(item.y)) continue;
+    const d = Math.hypot(item.x - x, item.y - y);
+    if (d < bestD) { best = item; bestD = d; }
+  }
+  return best;
+}
+
+function landuseName(value) {
+  return landuseLabel(value);
+}
+
+const ADMIN_ID_KEYS = ["adminId", "municipalityId", "adminNumericId", "id", "numericId"];
+const PREFECTURE_ID_KEYS = ["prefectureRegionId", "prefectureId", "id", "numericId"];
+const MUNICIPALITY_NAME_KEYS = ["municipalityName", "name", "canonicalSettlementName", "municipalityRootName", "generatedMunicipalityName", "label"];
+const PREFECTURE_NAME_KEYS = ["prefectureName", "prefectureRegionName", "regionName", "name", "label"];
+const POPULATION_KEYS = ["municipalityPopulation", "adminPopulation", "population", "estimatedPopulation"];
+
+function numericIdOf(item, keys = ADMIN_ID_KEYS) {
+  for (const key of keys) {
+    const value = item?.[key];
+    if (Number.isFinite(value)) return Math.floor(value);
+  }
+  return null;
+}
+
+function hasNumericId(item, id, keys = ADMIN_ID_KEYS) {
+  if (!item || id == null || id < 0) return false;
+  return keys.some((key) => Number.isFinite(item?.[key]) && Math.floor(item[key]) === Math.floor(id));
+}
+
+function numericPrefectureId(item) {
+  const value = numericIdOf(item, PREFECTURE_ID_KEYS);
+  return value == null ? -1 : value;
+}
+
+function firstUsableText(item, keys) {
+  for (const key of keys) {
+    const value = item?.[key];
+    if (!looksNumericName(value)) return String(value).trim();
+  }
+  return "";
+}
+
+function firstPopulation(item) {
+  for (const key of POPULATION_KEYS) {
+    const value = item?.[key];
+    if (Number.isFinite(value) && value > 0) return Math.round(value);
+  }
+  return null;
+}
+
+function adminCenterForId(map, adminId) {
+  if (!map || adminId == null || adminId < 0) return null;
+  const centers = (map.adminCenters || []).filter(Boolean);
+  const exact = centers.find((center) => hasNumericId(center, adminId));
+  if (exact) return exact;
+  // Some legacy/admin debug arrays were once addressed by array index.  Keep this
+  // only as a guarded fallback so numeric IDs are not mistaken for indexes.
+  const direct = map.adminCenters?.[adminId];
+  return hasNumericId(direct, adminId) ? direct : null;
+}
+
+function looksNumericName(name) {
+  if (!name) return true;
+  const text = String(name).trim();
+  return !text || /^県域\d*$/u.test(text) || /^-?\d+(?:\s*[,，]\s*\d+)*$/u.test(text) || /^(Municipality|Prefecture|Admin|Region)\s*-?\d+/i.test(text);
+}
+
+function nearestNamedAdminCenter(map, cellIndex, maxDistance = 36, adminId = null) {
+  if (!map || cellIndex < 0) return null;
+  const x = cellIndex % map.width;
+  const y = Math.floor(cellIndex / map.width);
+  let best = null;
+  let bestD = maxDistance;
+  for (const center of map.adminCenters || []) {
+    if (!center || !Number.isFinite(center.x) || !Number.isFinite(center.y)) continue;
+    if (adminId != null && adminId >= 0 && !hasNumericId(center, adminId)) continue;
+    if (!firstUsableText(center, MUNICIPALITY_NAME_KEYS)) continue;
+    const d = Math.hypot(center.x - x, center.y - y);
+    if (d < bestD) { best = center; bestD = d; }
+  }
+  return best;
+}
+
+function adminName(map, adminId, cellIndex = -1) {
+  const center = adminCenterForId(map, adminId) || nearestNamedAdminCenter(map, cellIndex, 54, adminId);
+  const name = firstUsableText(center, MUNICIPALITY_NAME_KEYS);
+  if (name) return name;
+  return adminId >= 0 ? "Unnamed municipality" : "-";
+}
+
+function adminPopulation(map, adminId, cellIndex = -1) {
+  const center = adminCenterForId(map, adminId) || nearestNamedAdminCenter(map, cellIndex, 54, adminId);
+  const centerPop = firstPopulation(center);
+  if (centerPop !== null) return centerPop;
+  let sum = 0;
+  let found = false;
+  for (const key of ["modernCities", "satelliteCities", "ports", "markets", "villages"]) {
+    for (const p of map?.[key] || []) {
+      if (!hasNumericId(p, adminId)) continue;
+      const pop = firstPopulation(p);
+      if (pop !== null) { sum += pop; found = true; }
+    }
+  }
+  return found ? sum : null;
+}
+
+function worldSourceMap() {
+  return displayWorld()?.sourceMap || null;
+}
+
+function prefectureRegionById(id, maps = []) {
+  if (!Number.isFinite(id) || id < 0) return null;
+  for (const source of maps) {
+    const region = (source?.prefectureRegions || []).find((p) => hasNumericId(p, id, PREFECTURE_ID_KEYS));
+    if (region) return region;
+  }
+  return null;
+}
+
+function prefectureNameForId(id, adminId = -1) {
+  if (!Number.isFinite(id) || id < 0) return "";
+  const sources = [activeMap(), worldSourceMap()].filter(Boolean);
+  const region = prefectureRegionById(id, sources);
+  const regionName = firstUsableText(region, PREFECTURE_NAME_KEYS);
+  if (regionName) return regionName;
+
+  for (const source of sources) {
+    for (const center of source?.adminCenters || []) {
+      if (adminId >= 0 && !hasNumericId(center, adminId)) continue;
+      const centerPref = numericPrefectureId(center);
+      if (centerPref >= 0 && centerPref !== id) continue;
+      const name = firstUsableText(center, ["prefectureName", "prefectureRegionName", "regionName"]);
+      if (name) return name;
+    }
+  }
+  return "";
+}
+
+function prefectureNameForCell(map, i) {
+  const id = map.prefectureRegionId?.[i] ?? -1;
+  const direct = prefectureNameForId(id);
+  if (direct) return direct;
+  const adminId = map.adminId?.[i] ?? -1;
+  const mappedPref = adminId >= 0 ? map.municipalityToPrefectureId?.[adminId] ?? state.world?.sourceMap?.municipalityToPrefectureId?.[adminId] ?? -1 : -1;
+  const mapped = prefectureNameForId(mappedPref, adminId);
+  if (mapped) return mapped;
+  const center = mappedPref === id ? nearestNamedAdminCenter(map, i, 90, adminId) : null;
+  const fromCenter = firstUsableText(center, ["prefectureName", "prefectureRegionName", "regionName"]);
+  return fromCenter || (id >= 0 ? "Unnamed prefecture" : "-");
+}
+
+function updateTooltip(event) {
+  const map = activeMap();
+  if (!map || !tooltipEl || dragState.mode) return;
+  const rect = canvas.getBoundingClientRect();
+  const cell = mapClientToCell(event);
+  if (!cell) return;
+  const { x, y } = cell;
+  if (x < 0 || y < 0 || x >= map.width || y >= map.height) {
+    tooltipEl.classList.remove("visible");
+    return;
+  }
+  const i = y * map.width + x;
+  const worldCell = viewportCellToWorldCell({ x, y });
+  const entity = nearestEntity(state.hoverEntities, x, y);
+  const elevation = map.elevation?.[i] ?? 0;
+  const density = map.populationDensity?.[i] ?? map.settlementScore?.[i] ?? 0;
+  const hoveredAdminId = map.adminId?.[i] ?? -1;
+  const hoveredAdminPopulation = adminPopulation(map, hoveredAdminId, i);
+  const coordinateText = worldCell ? `World ${worldCell.x}, ${worldCell.y} / View ${x}, ${y}` : `${x}, ${y}`;
+  const entityName = firstUsableText(entity, ["name", "facilityLabel", "municipalityName", "canonicalSettlementName", "kind"]);
+  const entityTitle = entity
+    ? `${entityName || adminName(map, hoveredAdminId, i) || entity.kind || "Feature"} / ${entity.kind || "Feature"}`
+    : coordinateText;
+  const lines = [
+    `<strong>${entityTitle}</strong>`,
+    `Prefecture: ${prefectureNameForCell(map, i)}`,
+    `Admin: ${adminName(map, hoveredAdminId, i)}`,
+    `Admin Pop: ${hoveredAdminPopulation === null ? "-" : hoveredAdminPopulation.toLocaleString()}`,
+    `Land: ${map.sea?.[i] ? "Sea" : landuseName(map.landuse?.[i])}`,
+    `Elevation: ${elevation.toFixed(3)} / Slope: ${(map.slope?.[i] ?? 0).toFixed(3)}`,
+    `River: ${(map.river?.[i] ?? 0).toFixed(2)} / Density: ${density.toFixed(2)}`,
+  ];
+  if (entity?.population) lines.splice(1, 0, `Population: ${entity.population.toLocaleString()}`);
+  tooltipEl.innerHTML = lines.join("<br>");
+  const margin = 8;
+  const offset = 14;
+  const maxLeft = Math.max(margin, rect.width - tooltipEl.offsetWidth - margin);
+  const maxTop = Math.max(margin, rect.height - tooltipEl.offsetHeight - margin);
+  const desiredLeft = event.clientX - rect.left + offset;
+  const desiredTop = event.clientY - rect.top + offset;
+  tooltipEl.style.left = `${Math.min(Math.max(margin, desiredLeft), maxLeft)}px`;
+  tooltipEl.style.top = `${Math.min(Math.max(margin, desiredTop), maxTop)}px`;
+  tooltipEl.classList.add("visible");
+}
+
+function renderModeButtons() {
+  if (!modeGrid) return;
+  modeGrid.innerHTML = "";
+  for (const [key, label] of modes) {
+    const button = document.createElement("button");
+    button.type = "button";
+    button.textContent = label;
+    button.className = key === state.mode ? "mode-button active" : "mode-button";
+    button.addEventListener("click", () => {
+      state.mode = key;
+      renderModeButtons();
+      renderLegend();
+      redraw();
+    });
+    modeGrid.append(button);
+  }
+  renderLegend();
+}
+
+function rejectGenerationJobs(error) {
+  for (const pending of generationPendingJobs.values()) pending.reject(error);
+  generationPendingJobs.clear();
+}
+
+function resetGenerationWorker(reason = "Generation worker reset", rejectPending = true) {
+  const worker = generationWorker;
+  generationWorker = null;
+  worker?.terminate?.();
+  if (rejectPending && generationPendingJobs.size) rejectGenerationJobs(new Error(reason));
+}
+
+function createGenerationWorker() {
+  if (generationWorker) return generationWorker;
+  if (typeof Worker === "undefined") {
+    state.diagnostics.lastGenerationWorkerFallbackReason = "Worker API unavailable";
+    return null;
+  }
+  try {
+    const worker = new Worker(new URL("./generationWorker.js", import.meta.url), { type: "module" });
+    worker.addEventListener("message", (event) => {
+      const data = event.data || {};
+      const pending = generationPendingJobs.get(data.id);
+      if (!pending) return;
+      if (data.type === "progress") {
+        pending.onProgress?.(data.event || {});
+        return;
+      }
+      if (data.type !== "result") return;
+      generationPendingJobs.delete(data.id);
+      if (data.ok) pending.resolve({ map: data.map, worker: true });
+      else pending.reject(new Error(data.error || "Generation worker failed"));
+    });
+    worker.addEventListener("error", (event) => {
+      if (generationWorker !== worker) return;
+      const reason = event?.message || "Generation worker runtime error";
+      state.diagnostics.lastGenerationWorkerFallbackReason = reason;
+      recordDiagnosticLog("error", "Generation worker reset", reason);
+      resetGenerationWorker(reason, true);
+    });
+    worker.addEventListener("messageerror", () => {
+      if (generationWorker !== worker) return;
+      const reason = "Generation worker message clone failed";
+      state.diagnostics.lastGenerationWorkerFallbackReason = reason;
+      recordDiagnosticLog("error", "Generation worker reset", reason);
+      resetGenerationWorker(reason, true);
+    });
+    generationWorker = worker;
+    return worker;
+  } catch (error) {
+    state.diagnostics.lastGenerationWorkerFallbackReason = error?.message || "Generation worker creation failed";
+    generationWorker = null;
+    return null;
+  }
+}
+
+function runGenerationInWorker(seed, options = {}, onProgress = null) {
+  const worker = createGenerationWorker();
+  if (!worker) return null;
+  const id = ++generationJobSeq;
+  return new Promise((resolve, reject) => {
+    generationPendingJobs.set(id, { resolve, reject, onProgress });
+    try {
+      worker.postMessage({ id, seed, options });
+    } catch (error) {
+      generationPendingJobs.delete(id);
+      reject(error);
+    }
+  });
+}
+
+async function generateFullMap(seed, options = {}) {
+  // Full-map generation used to run on the UI thread.  A slow browser could
+  // therefore trigger the browser's long-running-script watchdog after tens of
+  // seconds even though generation itself was still making progress.  Keep the
+  // complete CPU-bound pipeline in a worker; only progress messages and the
+  // finished map cross back to the UI thread.
+  const workerPromise = runGenerationInWorker(seed, { terrainType: options.terrainType }, options.onProgress);
+  if (workerPromise) {
+    const job = await workerPromise;
+    state.diagnostics.lastGenerationWorkerUsed = true;
+    state.diagnostics.lastGenerationWorkerFallbackReason = null;
+    return job.map;
+  }
+
+  // Do not restart a CPU-heavy full generation on the UI thread. On slower
+  // browsers that old compatibility fallback could hit the long-running-script
+  // watchdog after tens of seconds. Modern browser execution therefore
+  // requires a worker; if workers are blocked, fail immediately with a useful
+  // diagnostic instead of appearing to generate and then being interrupted.
+  state.diagnostics.lastGenerationWorkerUsed = false;
+  const reason = state.diagnostics.lastGenerationWorkerFallbackReason || "Generation worker unavailable";
+  throw new Error(`${reason}. Full-map generation requires Web Worker support (serve the app over HTTP/HTTPS if local file workers are blocked).`);
+}
+
+async function regenerate() {
+  const requestId = ++generationRequestSeq;
+  ++patchRequestSeq;
+  state.patchBusy = false;
+  state.patchBusyVariant = null;
+  state.patchStatusMessage = "";
+  if (patchWorker) { patchWorker.terminate?.(); patchWorker = null; }
+  state.seedText = seedInput.value;
+  state.generationType = generationTypeInput?.value || "auto";
+  // A deliberate new Generate request supersedes an older one. Do not leave
+  // multiple full-map jobs queued behind a busy worker.
+  if (generationPendingJobs.size) resetGenerationWorker("Generation superseded by a newer request", true);
+  setProgressVisible(true, "Preparing generation...");
+  await nextFrame();
+  try {
+    const map = await generateFullMap(parseSeed(state.seedText), { onProgress: updateGenerationProgress, terrainType: state.generationType });
+    if (requestId !== generationRequestSeq) return;
+    state.map = map;
+    state.world = createWorldMap(state.map);
+    state.camera = createInitialCamera(state.world);
+    state.lastPatchResult = null;
+    state.pendingPatch = null;
+    resetPatchVariant({ update: false });
+    hideSelectionOverlay({ discardPreview: true });
+    recordGenerationRun(state.map, state.generationType);
+    renderStats(state.map);
+    redraw();
+    if (progressStageEl) {
+      const workerText = state.diagnostics.lastGenerationWorkerUsed ? " in worker" : "";
+      progressStageEl.textContent = `Done${workerText} in ${formatMs(state.map.generationTotalMs || 0)}`;
+    }
+    renderTimingRows(state.map.generationTimings || []);
+    window.setTimeout(() => setProgressVisible(false), 900);
+  } catch (error) {
+    // Superseding an old request is an expected cancellation, not a generation
+    // failure. The newer request owns the progress UI.
+    if (requestId !== generationRequestSeq) return;
+    const reason = error?.message || String(error || "unknown generation error");
+    recordDiagnosticLog("error", "Full generation failed", reason, { terrainType: state.generationType });
+    if (progressStageEl) progressStageEl.textContent = `Generation failed: ${reason}`;
+    console.error("Full generation failed", error);
+  }
+}
+
+
+function derivePatchSeed(rect, terrainType, variant = 0) {
+  let h = parseSeed(state.seedText) ^ 0x9e3779b9;
+  h = Math.imul(h ^ (rect.x0 | 0), 1664525) >>> 0;
+  h = Math.imul(h ^ (rect.y0 | 0), 1013904223) >>> 0;
+  h = Math.imul(h ^ (rect.x1 | 0), 2246822519) >>> 0;
+  h = Math.imul(h ^ (rect.y1 | 0), 3266489917) >>> 0;
+  h = Math.imul(h ^ normalizePatchVariant(variant), 668265263) >>> 0;
+  for (const ch of String(terrainType || "auto")) h = Math.imul(h ^ ch.charCodeAt(0), 16777619) >>> 0;
+  return h >>> 0;
+}
+
+
+
+function beginZoomVisual(oldZoom, event) {
+  if (zoomVisualState) return;
+  const rect = canvas.getBoundingClientRect();
+  zoomVisualState = {
+    baseRect: rect,
+    startZoom: clampZoom(oldZoom || state.zoom || 1),
+    originX: Math.min(Math.max(event.clientX - rect.left, 0), rect.width),
+    originY: Math.min(Math.max(event.clientY - rect.top, 0), rect.height),
+  };
+  canvas.style.transformOrigin = `${zoomVisualState.originX}px ${zoomVisualState.originY}px`;
+  canvas.style.willChange = "transform";
+  canvas.classList.add("is-zooming");
+  if (selectionSvgEl) selectionSvgEl.style.visibility = "hidden";
+}
+
+function scheduleZoomVisualUpdate() {
+  if (!zoomVisualState || zoomRedrawRaf != null) return;
+  zoomRedrawRaf = requestAnimationFrame(() => {
+    zoomRedrawRaf = null;
+    if (!zoomVisualState) return;
+    const scale = clampZoom(state.zoom || 1) / Math.max(1e-6, zoomVisualState.startZoom || 1);
+    canvas.style.transform = `scale(${scale})`;
+  });
+}
+
+function finishZoomVisual() {
+  if (zoomRedrawRaf != null) {
+    cancelAnimationFrame(zoomRedrawRaf);
+    zoomRedrawRaf = null;
+  }
+  if (zoomVisualState) {
+    canvas.style.transform = "";
+    canvas.style.transformOrigin = "";
+    canvas.style.willChange = "";
+    canvas.classList.remove("is-zooming");
+    if (selectionSvgEl) selectionSvgEl.style.visibility = "";
+    zoomVisualState = null;
+  }
+}
+
+function handleCanvasWheel(event) {
+  if (!state.world || !activeMap()) return;
+  event.preventDefault();
+  if (zoomLatencyStartedAt == null) zoomLatencyStartedAt = performance.now();
+  tooltipEl?.classList.remove("visible");
+  const beforeSize = viewportSizeForZoom(state.zoom);
+  const beforeCell = mapClientToCell(event, beforeSize);
+  const beforeWorld = beforeCell ? viewportCellToWorldCell(beforeCell) : null;
+  const oldZoom = clampZoom(state.zoom || 1);
+  const delta = event.deltaY < 0 ? 1.10 : 1 / 1.10;
+  const nextZoom = clampZoom(oldZoom * delta);
+  if (Math.abs(nextZoom - oldZoom) < 0.001) return;
+  state.zoom = nextZoom;
+  const nextSize = syncViewportSize();
+  if (beforeWorld) {
+    const afterCell = mapClientToCell(event, nextSize);
+    if (afterCell) {
+      state.camera = clampCameraForView({
+        x: beforeWorld.x - afterCell.x,
+        y: beforeWorld.y - afterCell.y,
+      }, nextSize);
+    }
+  }
+
+  // Wheel events can fire dozens of times per second.  During the gesture, keep
+  // the last rendered bitmap and only transform it on the GPU; rebuild the
+  // viewport and labels once the gesture settles.
+  beginZoomVisual(oldZoom, event);
+  scheduleZoomVisualUpdate();
+  if (zoomSettledTimer != null) clearTimeout(zoomSettledTimer);
+  zoomSettledTimer = window.setTimeout(() => {
+    zoomSettledTimer = null;
+    const startedAt = zoomLatencyStartedAt || performance.now();
+    zoomLatencyStartedAt = null;
+    finishZoomVisual();
+    redraw({ fastTerrain: false, allowWorldExpand: false });
+    recordInteractionLatency("wheel zoom", startedAt, { zoom: state.zoom });
+  }, 170);
+}
+
+function cloneForPatchPreview(value, seen = new Map()) {
+  if (value == null || typeof value !== "object") return value;
+  if (ArrayBuffer.isView(value)) return new value.constructor(value);
+  if (value instanceof ArrayBuffer) return value.slice(0);
+  if (seen.has(value)) return seen.get(value);
+  if (value instanceof Map) {
+    const out = new Map();
+    seen.set(value, out);
+    for (const [k, v] of value.entries()) out.set(cloneForPatchPreview(k, seen), cloneForPatchPreview(v, seen));
+    return out;
+  }
+  if (Array.isArray(value)) {
+    const out = [];
+    seen.set(value, out);
+    for (const item of value) out.push(cloneForPatchPreview(item, seen));
+    return out;
+  }
+  const out = {};
+  seen.set(value, out);
+  for (const [key, item] of Object.entries(value)) out[key] = cloneForPatchPreview(item, seen);
+  return out;
+}
+
+
+function clonePatchPreviewWorld(world) {
+  if (typeof structuredClone === "function") {
+    try {
+      return structuredClone(world);
+    } catch (error) {
+      recordDiagnosticLog("warning", "Native patch clone fallback", error?.message || String(error));
+    }
+  }
+  return cloneForPatchPreview(world);
+}
+
+function previewPatchDelta(baseWorld, previewWorld, rectLike) {
+  const rect = rectLike?.writeRect || rectLike || null;
+  if (!baseWorld || !previewWorld || !rect) return null;
+  const x0 = Math.max(0, Math.floor(rect.x0 || 0));
+  const y0 = Math.max(0, Math.floor(rect.y0 || 0));
+  const x1 = Math.min(Math.max(baseWorld.width || 0, previewWorld.width || 0), Math.ceil(rect.x1 || 0));
+  const y1 = Math.min(Math.max(baseWorld.height || 0, previewWorld.height || 0), Math.ceil(rect.y1 || 0));
+  const terrainFields = ["elevation", "sea", "landuse", "populationDensity"];
+  const adminFields = ["adminId", "municipalityId", "prefectureRegionId"];
+  let changedCells = 0;
+  let terrainChangedCells = 0;
+  let adminChangedCells = 0;
+  for (let y = y0; y < y1; y++) {
+    for (let x = x0; x < x1; x++) {
+      const bi = worldIndexOf(baseWorld, x, y);
+      const pi = worldIndexOf(previewWorld, x, y);
+      if (bi < 0 || pi < 0) continue;
+      let terrainChanged = false;
+      let adminChanged = false;
+      for (const name of terrainFields) {
+        const a = baseWorld.fields?.[name]?.[bi];
+        const b = previewWorld.fields?.[name]?.[pi];
+        if (a !== b && !(Number.isNaN(a) && Number.isNaN(b))) { terrainChanged = true; break; }
+      }
+      for (const name of adminFields) {
+        const a = baseWorld.fields?.[name]?.[bi];
+        const b = previewWorld.fields?.[name]?.[pi];
+        if (a !== b) { adminChanged = true; break; }
+      }
+      if (terrainChanged || adminChanged) changedCells++;
+      if (terrainChanged) terrainChangedCells++;
+      if (adminChanged) adminChangedCells++;
+    }
+  }
+  return { changedCells, terrainChangedCells, adminChangedCells };
+}
+
+function markPreviewRenderRevision(world, variant) {
+  if (!world) return 0;
+  const revision = ++state.renderRevision;
+  world.renderRevision = revision;
+  world.previewVariant = variant;
+  return revision;
+}
+
+function createPatchWorker() {
+  if (patchWorker) return patchWorker;
+  if (typeof Worker === "undefined") {
+    state.diagnostics.lastWorkerFallbackReason = "Worker API unavailable";
+    return null;
+  }
+  try {
+    patchWorker = new Worker(new URL("./mapPatchWorker.js", import.meta.url), { type: "module" });
+    const worker = patchWorker;
+    worker.addEventListener("error", (event) => {
+      if (patchWorker !== worker) return;
+      const reason = event?.message || "Patch worker runtime error";
+      state.diagnostics.lastWorkerFallbackReason = reason;
+      recordDiagnosticLog("warning", "Patch worker reset", reason);
+      worker.terminate?.();
+      patchWorker = null;
+    });
+  } catch (error) {
+    state.diagnostics.lastWorkerFallbackReason = error?.message || "Patch worker creation failed";
+    patchWorker = null;
+  }
+  return patchWorker;
+}
+
+function runPatchInWorker(world, rect, options) {
+  const worker = createPatchWorker();
+  if (!worker) return null;
+  const id = ++patchJobSeq;
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    let watchdogTimer = null;
+    const resetWatchdog = () => {
+      if (watchdogTimer != null) clearTimeout(watchdogTimer);
+      watchdogTimer = window.setTimeout(() => {
+        fail(new Error(`Patch worker produced no progress for ${Math.round(PATCH_WORKER_INACTIVITY_WATCHDOG_MS / 1000)} seconds and was stopped.`));
+      }, PATCH_WORKER_INACTIVITY_WATCHDOG_MS);
+    };
+    const cleanup = () => {
+      if (watchdogTimer != null) { clearTimeout(watchdogTimer); watchdogTimer = null; }
+      worker.removeEventListener("message", onMessage);
+      worker.removeEventListener("error", onError);
+      worker.removeEventListener("messageerror", onMessageError);
+      if (activePatchCancel === cancelJob) activePatchCancel = null;
+      if (patchWorker === worker) patchWorker = null;
+      worker.terminate?.();
+    };
+    const succeed = (value) => { if (settled) return; settled = true; cleanup(); resolve(value); };
+    const fail = (error) => { if (settled) return; settled = true; cleanup(); reject(error instanceof Error ? error : new Error(String(error || "Patch worker failed"))); };
+    const cancelJob = (reason = "Patch generation cancelled by user.") => {
+      const error = new Error(reason);
+      error.name = "AbortError";
+      fail(error);
+    };
+    const onMessage = (event) => {
+      if (event.data?.id !== id) return;
+      resetWatchdog();
+      if (event.data?.type === "progress") { updateGenerationProgress(event.data.progress || {}); return; }
+      if (event.data.ok) succeed({ world: event.data.world, result: event.data.result, worker: true });
+      else fail(new Error(event.data.error || "Patch worker failed"));
+    };
+    const onError = (event) => fail(new Error(event.message || "Patch worker error"));
+    const onMessageError = () => fail(new Error("Patch worker message clone failed"));
+    worker.addEventListener("message", onMessage);
+    worker.addEventListener("error", onError);
+    worker.addEventListener("messageerror", onMessageError);
+    activePatchCancel = cancelJob;
+    resetWatchdog();
+    const previewWorld = clonePatchPreviewWorld(world);
+    const transfer = Array.from(collectTransferableBuffers(previewWorld));
+    try { worker.postMessage({ id, world: previewWorld, rect, options }, transfer); }
+    catch (error) { fail(error); }
+  });
+}
+
+function cancelPatchGeneration({ clearSelection = false } = {}) {
+  if (!state.patchBusy) return false;
+  patchRequestSeq++;
+  const cancel = activePatchCancel;
+  activePatchCancel = null;
+  cancel?.("Patch generation cancelled by user.");
+  patchWorker?.terminate?.();
+  patchWorker = null;
+  state.patchBusy = false;
+  state.patchBusyVariant = null;
+  state.patchStatusMessage = "Generation cancelled.";
+  setProgressVisible(false);
+  if (clearSelection) hideSelectionOverlay({ discardPreview: true });
+  else updatePatchControls();
+  return true;
+}
+
+async function generatePatchPreviewWorld(baseWorld, rect, options) {
+  const workerPromise = runPatchInWorker(baseWorld, rect, options);
+  if (workerPromise) {
+    try {
+      return await workerPromise;
+    } catch (error) {
+      const reason = error?.message || String(error || "unknown worker failure");
+      // A worker that dies after a long patch must not silently restart the same
+      // CPU-heavy job on the UI thread. That old fallback could turn a worker
+      // failure into a second long freeze and trigger the browser watchdog.
+      state.diagnostics.lastWorkerFallbackReason = reason;
+      recordDiagnosticLog("error", "Patch worker failed", reason);
+      patchWorker?.terminate?.();
+      patchWorker = null;
+      throw error;
+    }
+  }
+  const reason = state.diagnostics.lastWorkerFallbackReason || "Patch worker unavailable";
+  throw new Error(`${reason}. Patch generation requires Web Worker support (serve the app over HTTP/HTTPS if local file workers are blocked).`);
+}
+
+async function generateSelectedPatch(kind = "Patch preview") {
+  if (state.patchBusy) return;
+  const validation = validatePatchRect(state.selectionRect, state.world);
+  if (!validation.ok) {
+    recordDiagnosticLog("warning", "Invalid patch selection", validation.reason || "Selection is not valid.");
+    updatePatchControls();
+    return;
+  }
+  const baseWorld = state.world;
+  const requestId = ++patchRequestSeq;
+  const terrainType = patchTerrainTypeInput?.value || generationTypeInput?.value || "auto";
+  const patchMode = patchModeInput?.value || "auto";
+  const variant = readPatchVariant();
+  const seed = derivePatchSeed(validation.rect, terrainType, variant);
+  state.patchBusy = true;
+  state.patchBusyVariant = variant;
+  state.patchStatusMessage = "";
+  updatePatchControls();
+  setProgressVisible(true, `Generating preview variant ${variant}...`);
+  await nextFrame();
+  const patchStartedAt = performance.now();
+  try {
+    const job = await generatePatchPreviewWorld(baseWorld, validation.rect, {
+      terrainType,
+      patchMode,
+      seed,
+      variant,
+      // An interactive Alternative click is already the retry mechanism. Do not
+      // silently run a second complete patch attempt, which can double wall time
+      // and look like a browser-enforced interruption on slower machines.
+      maxQualityRetries: 0,
+      // Alternative is itself the candidate search UI. Generate exactly the
+      // requested variant instead of internally searching variant N/N+1/N+2;
+      // overlapping internal searches could select the same candidate on two
+      // consecutive Alternative clicks and made the map look unchanged.
+      qualityTerrainAttempts: 1,
+      // Preview generation may remain visible when the single requested
+      // expansion candidate only misses a terrain/human-geography quality floor.
+      // Hard seam-continuity failures are never accepted as best-available and
+      // are rolled back instead of displaying a visibly broken generation edge.
+      acceptBestAvailableQuality: true,
+      includeSeamVisualization: state.showSeamDiagnostics,
+    });
+    if (requestId !== patchRequestSeq || state.world !== baseWorld) return;
+    const result = job.result;
+    if (!result.ok) {
+      const reason = result.reason || result.code || "invalid selection";
+      const showing = state.pendingPatch?.variant;
+      state.patchStatusMessage = showing == null
+        ? `Variant ${variant} was rejected (${reason}); no preview was applied.`
+        : `Variant ${variant} was rejected (${reason}); still showing preview variant ${showing}.`;
+      recordDiagnosticLog("warning", "Patch failed", reason, { kind, terrainType, variant });
+      if (progressStageEl) progressStageEl.textContent = state.patchStatusMessage;
+      updatePatchControls();
+      return;
+    }
+    const patchWallMs = performance.now() - patchStartedAt;
+    const previewDelta = previewPatchDelta(baseWorld, job.world, result.rects || validation.rect) || { changedCells: 0, terrainChangedCells: 0, adminChangedCells: 0 };
+    result.previewDelta = previewDelta;
+    markPreviewRenderRevision(job.world, variant);
+    state.pendingPatch = { world: job.world, result, rect: validation.rect, terrainType, seed, variant, worker: job.worker, previewDelta };
+    recordPatchRun(result, terrainType, validation.rect, variant, { kind, worker: job.worker, wallMs: patchWallMs });
+    state.viewportMap = null;
+    if (progressStageEl) progressStageEl.textContent = `Rendering preview variant ${variant}...`;
+    await nextFrame();
+    const renderStartedAt = performance.now();
+    // Render the finished candidate in full immediately. A fast redraw followed
+    // by a delayed full redraw made completion ambiguous and could preserve a
+    // visually stale cached frame long enough to look like the result was lost.
+    redraw({ fastTerrain: false, allowWorldExpand: false });
+    const renderMs = performance.now() - renderStartedAt;
+    renderStats(displaySourceMap());
+    state.patchStatusMessage = previewDelta.changedCells > 0
+      ? `Variant ${variant} is displayed (render revision ${job.world.renderRevision}); ${previewDelta.changedCells.toLocaleString()} cells differ from the committed map.`
+      : `Variant ${variant} completed but is identical to the committed map in the write area.`;
+    updatePatchControls();
+    if (progressStageEl) {
+      const modeText = `${result.patchMode || patchMode} / ${result.patchGenerationMode}`;
+      const quality = result.candidateQuality;
+      const qualityText = quality
+        ? ` / quality ${quality.hardPass ? "PASS" : "best available"} ${Number(quality.score || 0).toFixed(3)} / selected terrain variant ${Number(quality.selectedVariant || 0)}`
+        : "";
+      progressStageEl.textContent = `Preview variant ${variant} displayed${job.worker ? " from worker" : ""}: ${previewDelta.changedCells.toLocaleString()} changed cells / generation ${formatMs(patchWallMs)} / render ${formatMs(renderMs)}${qualityText} / ${modeText}.`;
+    }
+    if (result.candidateQuality && !result.candidateQuality.hardPass) {
+      recordDiagnosticLog("warning", "Expansion quality floor not fully met", `Selected the best available production candidate (score ${Number(result.candidateQuality.score || 0).toFixed(3)}).`, { terrainType, variant, candidateQuality: result.candidateQuality });
+    }
+    renderTimingRows(result.patchTimings || []);
+    window.setTimeout(() => setProgressVisible(false), 1400);
+  } catch (error) {
+    if (error?.name === "AbortError") {
+      state.patchStatusMessage = "Generation cancelled.";
+      updatePatchControls();
+      return;
+    }
+    if (requestId !== patchRequestSeq) return;
+    const reason = error?.message || String(error || "unknown patch error");
+    const showing = state.pendingPatch?.variant;
+    state.patchStatusMessage = showing == null
+      ? `Variant ${variant} failed (${reason}); no preview was applied.`
+      : `Variant ${variant} failed (${reason}); still showing preview variant ${showing}.`;
+    recordDiagnosticLog("error", "Patch exception", reason, { kind, terrainType, variant });
+    if (progressStageEl) progressStageEl.textContent = state.patchStatusMessage;
+    console.error("Patch generation failed", error);
+  } finally {
+    if (requestId === patchRequestSeq) {
+      state.patchBusy = false;
+      state.patchBusyVariant = null;
+      updatePatchControls();
+      if (!progressEl?.classList.contains("hidden")) window.setTimeout(() => setProgressVisible(false), 1800);
+    }
+  }
+}
+
+async function generateAlternativePatch() {
+  if (state.patchBusy) return;
+  const validation = validatePatchRect(state.selectionRect, state.world);
+  if (!validation.ok) {
+    updatePatchControls();
+    return;
+  }
+  setPatchVariant(readPatchVariant() + 1, { update: false });
+  await generateSelectedPatch("Patch alternative");
+}
+
+function redraw(options = {}) {
+  const redrawStartedAt = performance.now();
+  const renderWorld = displayWorld();
+  if (!renderWorld) return;
+  const viewSize = syncViewportSize();
+  // Patch workers clone world coordinates at launch. Expanding the committed
+  // world while a patch is running shifts origin/fields in-place and makes the
+  // returning preview use a stale coordinate frame. Defer automatic expansion
+  // until generation has finished.
+  const mayExpand = !state.pendingPatch && !state.patchBusy && options.allowWorldExpand !== false;
+  const expansion = mayExpand ? ensureWorldPaddingForCamera(state.world, state.camera, viewSize.width, viewSize.height) : null;
+  if (expansion?.expanded) {
+    const ex = expansion.dx || 0;
+    const ey = expansion.dy || 0;
+    state.diagnostics.worldExpansionCount += 1;
+    state.diagnostics.lastWorldExpansion = {
+      at: new Date(),
+      dx: ex,
+      dy: ey,
+      worldWidth: state.world?.width || 0,
+      worldHeight: state.world?.height || 0,
+      viewWidth: viewSize.width,
+      viewHeight: viewSize.height,
+    };
+    state.camera = { x: (state.camera?.x || 0) + ex, y: (state.camera?.y || 0) + ey };
+    if (dragState.mode === "pan") {
+      dragState.startCameraX += ex;
+      dragState.startCameraY += ey;
+      if (dragState.pendingCamera) dragState.pendingCamera = { x: dragState.pendingCamera.x + ex, y: dragState.pendingCamera.y + ey };
+    }
+    if (state.selectionRect) {
+      state.selectionRect = {
+        ...state.selectionRect,
+        x0: state.selectionRect.x0 + ex,
+        y0: state.selectionRect.y0 + ey,
+        x1: state.selectionRect.x1 + ex,
+        y1: state.selectionRect.y1 + ey,
+        polygon: Array.isArray(state.selectionRect.polygon) ? state.selectionRect.polygon.map((p) => ({ x: p.x + ex, y: p.y + ey })) : state.selectionRect.polygon,
+      };
+    }
+  }
+  const activeWorldForRender = displayWorld();
+  state.camera = clampCameraForView(state.camera, viewSize, activeWorldForRender);
+  const viewportStartedAt = performance.now();
+  state.viewportMap = getViewportMap(activeWorldForRender, state.camera, viewSize.width, viewSize.height, { light: !!options.fastTerrain });
+  const viewportMs = performance.now() - viewportStartedAt;
+  const hoverStartedAt = performance.now();
+  state.hoverEntities = options.fastTerrain ? [] : buildHoverEntities(state.viewportMap);
+  const hoverMs = performance.now() - hoverStartedAt;
+  const drawStartedAt = performance.now();
+  const renderBreakdown = drawMap(canvas, state.viewportMap, {
+    mode: state.mode,
+    showFeatures: state.showFeatures && !options.fastTerrain,
+    showLabels: state.showLabels && !options.fastTerrain,
+    showSeamDiagnostics: state.showSeamDiagnostics && !options.fastTerrain,
+    continuousTerrain: !options.fastTerrain,
+    fastTerrain: !!options.fastTerrain,
+    zoom: state.zoom || 1,
+  });
+  const drawMs = performance.now() - drawStartedAt;
+  applyCanvasZoom();
+  if (state.selectionRect && dragState.mode !== "select") updateSelectionOverlayFromWorldRect();
+  updateRenderDiagnostics(options, {
+    viewportMs,
+    hoverMs,
+    drawMs,
+    totalRenderMs: performance.now() - redrawStartedAt,
+    renderBreakdown,
+  });
+  renderAdvancedData();
+}
+
+function init() {
+  renderModeButtons();
+  setToolMode("pan");
+
+  generateMapButton?.addEventListener("click", regenerate);
+  seedInput.addEventListener("change", regenerate);
+  seedInput.addEventListener("keydown", (event) => {
+    if (event.key === "Enter") regenerate();
+  });
+
+  generationTypeInput?.addEventListener("change", regenerate);
+  patchTerrainTypeInput?.addEventListener("change", () => {
+    discardPendingPatch({ redrawAfter: true });
+    state.lastPatchResult = null;
+    state.patchStatusMessage = "";
+    resetPatchVariant({ update: false });
+    updatePatchControls();
+  });
+  patchModeInput?.addEventListener("change", () => {
+    discardPendingPatch({ redrawAfter: true });
+    state.lastPatchResult = null;
+    state.patchStatusMessage = "";
+    updatePatchControls();
+    renderAdvancedData();
+  });
+  patchVariantInput?.addEventListener("change", () => {
+    state.patchStatusMessage = "";
+    setPatchVariant(patchVariantInput.value);
+  });
+  patchVariantInput?.addEventListener("keydown", (event) => {
+    if (event.key === "Enter") {
+      setPatchVariant(patchVariantInput.value);
+      generateSelectedPatch();
+    }
+  });
+  generatePatchButton?.addEventListener("click", () => generateSelectedPatch("Patch preview"));
+  alternativePatchButton?.addEventListener("click", generateAlternativePatch);
+  applyPatchButton?.addEventListener("click", () => hideSelectionOverlay({ commitPreview: true }));
+  discardPatchButton?.addEventListener("click", () => hideSelectionOverlay({ discardPreview: true }));
+  clearPatchSelectionButton?.addEventListener("click", () => hideSelectionOverlay({ discardPreview: true }));
+  cancelPatchButton?.addEventListener("click", () => cancelPatchGeneration());
+  toolPanButton?.addEventListener("click", () => setToolMode("pan"));
+  toolPatchButton?.addEventListener("click", () => setToolMode("patch"));
+  copyImportantDataButton?.addEventListener("click", copyImportantDebugData);
+  zoomInButton?.addEventListener("click", () => setZoomKeepingCenter((state.zoom || 1) * 1.2));
+  zoomOutButton?.addEventListener("click", () => setZoomKeepingCenter((state.zoom || 1) / 1.2));
+  zoomResetButton?.addEventListener("click", () => setZoomKeepingCenter(1));
+  centerMapButton?.addEventListener("click", recenterMap);
+
+  randomSeedButton.addEventListener("click", () => {
+    seedInput.value = String(Math.floor(Math.random() * 9999999));
+    regenerate();
+  });
+
+  showFeaturesInput.addEventListener("change", () => {
+    state.showFeatures = showFeaturesInput.checked;
+    redraw();
+  });
+
+  showLabelsInput.addEventListener("change", () => {
+    state.showLabels = showLabelsInput.checked;
+    redraw();
+  });
+  showSeamDiagnosticsInput?.addEventListener("change", () => {
+    state.showSeamDiagnostics = showSeamDiagnosticsInput.checked;
+    redraw({ fastTerrain: false, allowWorldExpand: false });
+  });
+
+  canvasShell?.setAttribute("tabindex", "0");
+  canvas.addEventListener("contextmenu", (event) => event.preventDefault());
+  canvas.addEventListener("wheel", handleCanvasWheel, { passive: false });
+  canvas.addEventListener("pointerdown", handleMapPointerDown);
+  canvas.addEventListener("pointermove", handleMapPointerMove);
+  canvas.addEventListener("pointerup", handleMapPointerUp);
+  canvas.addEventListener("pointercancel", handleMapPointerUp);
+  canvas.addEventListener("mousemove", updateTooltip);
+  canvas.addEventListener("mouseleave", () => {
+    tooltipEl?.classList.remove("visible");
+  });
+  window.addEventListener("keydown", (event) => {
+    if (event.key !== "Escape") return;
+    if (state.patchBusy) {
+      cancelPatchGeneration();
+      event.preventDefault();
+      return;
+    }
+    if (!state.selectionRect) return;
+    hideSelectionOverlay({ discardPreview: true });
+    event.preventDefault();
+  });
+
+  let resizeRaf = null;
+  window.addEventListener("resize", () => {
+    if (resizeRaf) cancelAnimationFrame(resizeRaf);
+    resizeRaf = requestAnimationFrame(() => {
+      resizeRaf = null;
+      if (state.world) redraw({ allowWorldExpand: false });
+      else applyCanvasZoom();
+    });
+  });
+
+  updatePatchControls();
+  renderAdvancedData();
+  regenerate();
+}
+
+init();
diff --git a/src/fieldSchema.js b/src/fieldSchema.js
new file mode 100644
index 0000000..fca1ede
--- /dev/null
+++ b/src/fieldSchema.js
@@ -0,0 +1,27 @@
+const NEGATIVE_ONE_FIELD_NAMES = new Set([
+  "adminId",
+  "prefectureRegionId",
+  "regionId",
+  "municipalityId",
+  "naturalCompartmentId",
+  "watershedId",
+]);
+
+export function isTypedCellField(value, expectedSize) {
+  return ArrayBuffer.isView(value)
+    && typeof value.length === "number"
+    && Number.isFinite(expectedSize)
+    && value.length === expectedSize;
+}
+
+export function defaultCellFieldValue(name, Constructor) {
+  if (name === "sea" || name === "ocean") return 1;
+  if (name === "elevation") return 0.08;
+  if (NEGATIVE_ONE_FIELD_NAMES.has(name)) return -1;
+  if (Constructor === Float32Array || Constructor === Float64Array) return 0;
+  return 0;
+}
+
+export function worldFieldConstructor(name, sourceConstructor) {
+  return NEGATIVE_ONE_FIELD_NAMES.has(name) ? Int32Array : sourceConstructor;
+}
diff --git a/src/generationWorker.js b/src/generationWorker.js
new file mode 100644
index 0000000..21ca7cb
--- /dev/null
+++ b/src/generationWorker.js
@@ -0,0 +1,25 @@
+import { generateMap } from "./mapPipeline.js";
+import { collectTransferableBuffers } from "./transferUtils.js";
+
+self.onmessage = (message) => {
+  const { id, seed, options } = message.data || {};
+  if (!Number.isFinite(id)) return;
+  try {
+    const map = generateMap(seed, {
+      ...(options || {}),
+      onProgress: (event) => {
+        self.postMessage({ type: "progress", id, event });
+      },
+    });
+    const transfer = Array.from(collectTransferableBuffers(map));
+    self.postMessage({ type: "result", id, ok: true, map }, transfer);
+  } catch (error) {
+    self.postMessage({
+      type: "result",
+      id,
+      ok: false,
+      error: error?.message || String(error),
+      stack: error?.stack || "",
+    });
+  }
+};
diff --git a/landuseCodes.js b/src/landuseCodes.js
similarity index 65%
rename from landuseCodes.js
rename to src/landuseCodes.js
index 7f187c1..55fa006 100644
--- a/landuseCodes.js
+++ b/src/landuseCodes.js
@@ -11,7 +11,7 @@ export const LANDUSE = Object.freeze({
   FOREST: 9,
 });
 
-export const LANDUSE_LABELS = Object.freeze({
+const LANDUSE_LABELS = Object.freeze({
   [LANDUSE.RURAL]: "Rural / natural land",
   [LANDUSE.FARMLAND]: "Farmland",
   [LANDUSE.OLD_URBAN]: "Old urban area",
@@ -28,10 +28,3 @@ export function landuseLabel(value) {
   return LANDUSE_LABELS[value] || "Land";
 }
 
-export function isBuiltLanduse(value) {
-  return value >= LANDUSE.OLD_URBAN && value <= LANDUSE.ROADSIDE;
-}
-
-export function isUrbanResidentialLanduse(value) {
-  return value === LANDUSE.OLD_URBAN || value === LANDUSE.CBD || value === LANDUSE.SUBURB || value === LANDUSE.NEW_TOWN || value === LANDUSE.ROADSIDE;
-}
diff --git a/mapAdminCompartmentRepair.js b/src/mapAdminCompartmentRepair.js
similarity index 75%
rename from mapAdminCompartmentRepair.js
rename to src/mapAdminCompartmentRepair.js
index a759230..8da587f 100644
--- a/mapAdminCompartmentRepair.js
+++ b/src/mapAdminCompartmentRepair.js
@@ -69,92 +69,7 @@ export function enforceCompartmentMunicipalityOwnership(adminId, compartmentId,
 }
 
 
-export function mergeSingleCompartmentMunicipalities(adminId, compartments, prefectureMask, sea, minCompartments = 2, maxPasses = 8) {
-  if (!compartments?.length) return { changedCells: 0, mergedMunicipalities: 0, remainingSingleCompartmentMunicipalities: 0 };
-  let totalChangedCells = 0;
-  let mergedMunicipalities = 0;
-  let remainingSingles = 0;
-  for (let pass = 0; pass < maxPasses; pass++) {
-    const owner = dominantCompartmentOwners(compartments, adminId);
-    const byOwner = new Map();
-    const areaByOwner = new Map();
-    for (const unit of compartments) {
-      if (!unit || unit.area === 0) continue;
-      const id = owner[unit.id];
-      if (id < 0) continue;
-      if (!byOwner.has(id)) byOwner.set(id, []);
-      byOwner.get(id).push(unit);
-      areaByOwner.set(id, (areaByOwner.get(id) || 0) + unit.area);
-    }
-    const singles = [...byOwner.entries()]
-      .filter(([, units]) => units.length > 0 && units.length < minCompartments)
-      .sort((a, b) => (areaByOwner.get(a[0]) || 0) - (areaByOwner.get(b[0]) || 0) || a[0] - b[0]);
-    remainingSingles = singles.length;
-    if (!singles.length) break;
-    let passChanged = 0;
-    for (const [id, units] of singles) {
-      // The old rule allowed one natural compartment to become one municipality.
-      // That produces many tiny office-only municipalities and makes the hierarchy
-      // hard to read. Merge such municipalities into the strongest adjacent owner.
-      const neighborScores = new Map();
-      for (const unit of units) {
-        for (const [neighborId, edge] of unit.adjacent || []) {
-          const candidate = owner[neighborId];
-          if (candidate < 0 || candidate === id) continue;
-          const neighborUnit = compartments[neighborId];
-          const shared = edge.count || 1;
-          const barrier = edge.target ? edge.target / Math.max(1, shared) : 0;
-          const sameLandscape = neighborUnit?.classId === unit.classId ? 0.7 : 0;
-          const score = shared * (2.2 - Math.min(1.6, barrier) + sameLandscape) + Math.sqrt(areaByOwner.get(candidate) || 1) * 0.05;
-          neighborScores.set(candidate, (neighborScores.get(candidate) || 0) + score);
-        }
-      }
-      let best = -1, bestScore = -INF;
-      for (const [candidate, score] of neighborScores) {
-        if (score > bestScore || (score === bestScore && candidate < best)) { best = candidate; bestScore = score; }
-      }
-      if (best < 0) {
-        // One-cell islets have no land adjacency. Attach them to the nearest
-        // existing municipality instead of leaving a one-compartment municipality.
-        const ux = units.reduce((sum, unit) => sum + (unit.x || 0) * (unit.area || 1), 0) / Math.max(1, units.reduce((sum, unit) => sum + (unit.area || 1), 0));
-        const uy = units.reduce((sum, unit) => sum + (unit.y || 0) * (unit.area || 1), 0) / Math.max(1, units.reduce((sum, unit) => sum + (unit.area || 1), 0));
-        let bestDist = INF;
-        for (const [candidate, candidateUnits] of byOwner) {
-          if (candidate === id || candidateUnits.length < minCompartments) continue;
-          for (const unit of candidateUnits) {
-            const d = Math.hypot((unit.x || 0) - ux, (unit.y || 0) - uy);
-            if (d < bestDist || (d === bestDist && candidate < best)) { bestDist = d; best = candidate; }
-          }
-        }
-        if (bestDist > 28) best = -1;
-      }
-      if (best < 0) continue;
-      for (const unit of units) {
-        for (const i of unit.cells || []) {
-          if (!prefectureMask[i] || sea[i]) continue;
-          if (adminId[i] !== best) {
-            adminId[i] = best;
-            passChanged++;
-          }
-        }
-      }
-      mergedMunicipalities++;
-    }
-    totalChangedCells += passChanged;
-    if (!passChanged) break;
-  }
-  const finalOwner = dominantCompartmentOwners(compartments, adminId);
-  const finalCounts = new Map();
-  for (const unit of compartments) {
-    if (!unit || unit.area === 0) continue;
-    const id = finalOwner[unit.id];
-    if (id >= 0) finalCounts.set(id, (finalCounts.get(id) || 0) + 1);
-  }
-  remainingSingles = [...finalCounts.values()].filter((count) => count > 0 && count < minCompartments).length;
-  return { changedCells: totalChangedCells, mergedMunicipalities, remainingSingleCompartmentMunicipalities: remainingSingles };
-}
-
-export function ownerAreaByCompartment(owner, compartments) {
+function ownerAreaByCompartment(owner, compartments) {
   const area = new Map();
   const count = new Map();
   for (const unit of compartments || []) {
@@ -167,7 +82,7 @@ export function ownerAreaByCompartment(owner, compartments) {
   return { area, count };
 }
 
-export function compartmentTouchesOutside(unit, prefectureMask, sea) {
+function compartmentTouchesOutside(unit, prefectureMask, sea) {
   if (!unit?.cells?.length) return true;
   for (const i of unit.cells) {
     const [x, y] = xyOf(i);
@@ -182,7 +97,7 @@ export function compartmentTouchesOutside(unit, prefectureMask, sea) {
   return false;
 }
 
-export function bestNeighborOwnerForUnits(units, owner, compartments, allowNearestFallback = false) {
+function bestNeighborOwnerForUnits(units, owner, compartments, allowNearestFallback = false) {
   const { area } = ownerAreaByCompartment(owner, compartments);
   const scores = new Map();
   const blocked = new Set(units.map((unit) => owner[unit.id]));
@@ -217,7 +132,7 @@ export function bestNeighborOwnerForUnits(units, owner, compartments, allowNeare
   return bestDist <= 32 ? best : -1;
 }
 
-export function mergeSmallCompartmentMunicipalitiesByOwner(owner, compartments, minCompartments = 2, maxPasses = 8) {
+function mergeSmallCompartmentMunicipalitiesByOwner(owner, compartments, minCompartments = 2, maxPasses = 8) {
   let changedCells = 0;
   let mergedMunicipalities = 0;
   let remainingSingleCompartmentMunicipalities = 0;
@@ -254,7 +169,7 @@ export function mergeSmallCompartmentMunicipalitiesByOwner(owner, compartments,
   return { changedCells, mergedMunicipalities, remainingSingleCompartmentMunicipalities };
 }
 
-export function repairCompartmentOwnerConnectivity(owner, compartments, maxPasses = 8) {
+function repairCompartmentOwnerConnectivity(owner, compartments, maxPasses = 8) {
   let changedCells = 0;
   let changedComponents = 0;
   for (let pass = 0; pass < maxPasses; pass++) {
@@ -300,7 +215,7 @@ export function repairCompartmentOwnerConnectivity(owner, compartments, maxPasse
   return { changedCells, changedComponents };
 }
 
-export function repairCompartmentOwnerEnclaves(owner, compartments, prefectureMask, sea, maxPasses = 6) {
+function repairCompartmentOwnerEnclaves(owner, compartments, prefectureMask, sea, maxPasses = 6) {
   let changedCells = 0;
   let changedComponents = 0;
   const outsideCache = new Map();
@@ -354,7 +269,7 @@ export function repairCompartmentOwnerEnclaves(owner, compartments, prefectureMa
   return { changedCells, changedComponents };
 }
 
-export function lockCompactUrbanCompartmentsToDominantOwner(owner, compartments, maxCells = 1100) {
+function lockCompactUrbanCompartmentsToDominantOwner(owner, compartments, maxCells = 1100) {
   const isUrbanUnit = (unit) => unit && unit.area > 0 && (
     unit.classId <= 3 ||
     (unit.urbanWeight || 0) >= 0.34 ||
@@ -406,7 +321,7 @@ export function lockCompactUrbanCompartmentsToDominantOwner(owner, compartments,
 }
 
 
-export function lockCityMetroCompartmentsToSingleMunicipality(owner, compartments, fields = {}) {
+function lockCityMetroCompartmentsToSingleMunicipality(owner, compartments, fields = {}) {
   const { modernCities = [] } = fields;
   if (!owner || !compartments?.length || !modernCities?.length) return { changedCells: 0, unifiedCities: 0 };
   let changedCells = 0;
@@ -466,6 +381,145 @@ export function lockCityMetroCompartmentsToSingleMunicipality(owner, compartment
   return { changedCells, unifiedCities };
 }
 
+
+export function reduceMunicipalityCountByCompartment(adminId, compartments, prefectureMask, sea, maxMunicipalities, modernCities = []) {
+  if (!compartments?.length || !Number.isFinite(maxMunicipalities) || maxMunicipalities < 1) return { changedCells: 0, mergedMunicipalities: 0 };
+  const owner = dominantCompartmentOwners(compartments, adminId);
+  const protectedOwners = new Set();
+  for (const city of modernCities || []) {
+    if (!city || !inside(city.x, city.y) || (city.population || 0) < 95000) continue;
+    const id = adminId[indexOf(city.x, city.y)];
+    if (id >= 0) protectedOwners.add(id);
+  }
+  let changedCells = 0;
+  let mergedMunicipalities = 0;
+  for (let pass = 0; pass < 80; pass++) {
+    const { area, count } = ownerAreaByCompartment(owner, compartments);
+    const active = [...area.keys()].filter((id) => (area.get(id) || 0) > 0);
+    if (active.length <= maxMunicipalities) break;
+    const candidates = active
+      .filter((id) => !protectedOwners.has(id))
+      .map((id) => ({ id, area: area.get(id) || 0, units: count.get(id) || 0 }))
+      .sort((a, b) => a.area - b.area || a.units - b.units || a.id - b.id);
+    let merged = false;
+    for (const candidate of candidates) {
+      const units = compartments.filter((unit) => unit && unit.area > 0 && owner[unit.id] === candidate.id);
+      let target = bestNeighborOwnerForUnits(units, owner, compartments, true);
+      if (target < 0 || target === candidate.id) {
+        const ux = units.reduce((sum, unit) => sum + (unit.x || 0) * (unit.area || 1), 0) / Math.max(1, units.reduce((sum, unit) => sum + (unit.area || 1), 0));
+        const uy = units.reduce((sum, unit) => sum + (unit.y || 0) * (unit.area || 1), 0) / Math.max(1, units.reduce((sum, unit) => sum + (unit.area || 1), 0));
+        let bestDistance = INF;
+        for (const unit of compartments) {
+          const other = owner[unit?.id];
+          if (!unit || unit.area <= 0 || other < 0 || other === candidate.id) continue;
+          const distance = Math.hypot((unit.x || 0) - ux, (unit.y || 0) - uy);
+          if (distance < bestDistance || (distance === bestDistance && other < target)) {
+            bestDistance = distance;
+            target = other;
+          }
+        }
+      }
+      if (target < 0 || target === candidate.id) continue;
+      for (const unit of units) {
+        owner[unit.id] = target;
+        changedCells += unit.area || 0;
+      }
+      mergedMunicipalities++;
+      merged = true;
+      break;
+    }
+    if (!merged) break;
+  }
+  repairCompartmentOwnerConnectivity(owner, compartments, 6);
+  repairCompartmentOwnerEnclaves(owner, compartments, prefectureMask, sea, 4);
+  applyCompartmentOwners(adminId, compartments, owner);
+  return { changedCells, mergedMunicipalities, finalMunicipalityCount: new Set([...owner].filter((id) => id >= 0)).size };
+}
+
+export function expandMajorCityMunicipalitiesByCompartment(adminId, compartmentId, compartments, prefectureMask, sea, modernCities = []) {
+  if (!compartmentId || !compartments?.length || !modernCities?.length) return { changedCells: 0, expandedCities: 0 };
+  const owner = dominantCompartmentOwners(compartments, adminId);
+  const majorCityUnit = new Map();
+  for (const city of modernCities) {
+    if (!city || !inside(city.x, city.y) || (city.population || 0) < 95000) continue;
+    const i = indexOf(city.x, city.y);
+    if (!prefectureMask[i] || sea[i]) continue;
+    const unitId = compartmentId[i];
+    if (unitId >= 0) majorCityUnit.set(unitId, city);
+  }
+  const connectedWithout = (ownerId, removedUnitId) => {
+    const members = compartments.filter((unit) => unit && unit.area > 0 && owner[unit.id] === ownerId && unit.id !== removedUnitId);
+    if (members.length <= 1) return members.length === 1;
+    const memberIds = new Set(members.map((unit) => unit.id));
+    const seen = new Set([members[0].id]);
+    const queue = [members[0].id];
+    for (let q = 0; q < queue.length; q++) {
+      for (const next of compartments[queue[q]]?.adjacent?.keys?.() || []) {
+        if (!memberIds.has(next) || seen.has(next)) continue;
+        seen.add(next);
+        queue.push(next);
+      }
+    }
+    return seen.size === members.length;
+  };
+  let changedCells = 0;
+  let expandedCities = 0;
+  const cities = modernCities
+    .filter((city) => city && inside(city.x, city.y) && (city.population || 0) >= 95000)
+    .sort((a, b) => (b.population || 0) - (a.population || 0));
+  for (const city of cities) {
+    const cell = indexOf(city.x, city.y);
+    if (!prefectureMask[cell] || sea[cell]) continue;
+    const homeUnitId = compartmentId[cell];
+    if (homeUnitId < 0) continue;
+    const cityOwner = owner[homeUnitId];
+    if (cityOwner < 0) continue;
+    const population = city.population || 0;
+    const requestedArea = Math.min(population >= 450000 ? 780 : 520, Math.max(130, 95 + Math.sqrt(population) * 0.72 + (city.urbanFootprintCells || 0) * 0.42));
+    const targetArea = requestedArea * 0.86;
+    let rows = ownerAreaByCompartment(owner, compartments);
+    let currentArea = rows.area.get(cityOwner) || 0;
+    let localChanged = 0;
+    for (let pass = 0; pass < 24 && currentArea + 1e-6 < targetArea; pass++) {
+      const candidates = new Map();
+      for (const unit of compartments) {
+        if (!unit || unit.area <= 0 || owner[unit.id] !== cityOwner) continue;
+        for (const [nextId, edge] of unit.adjacent || []) {
+          const next = compartments[nextId];
+          const donor = owner[nextId];
+          if (!next || donor < 0 || donor === cityOwner) continue;
+          const donorUnits = rows.count.get(donor) || 0;
+          if (donorUnits <= 2 || majorCityUnit.has(nextId)) continue;
+          if (!connectedWithout(donor, nextId)) continue;
+          const distance = Math.hypot((next.x || 0) - city.x, (next.y || 0) - city.y);
+          const shared = edge.count || 1;
+          const barrier = edge.target ? edge.target / Math.max(1, shared) : (edge.barrier || 0);
+          const score = shared * 2.8 + (next.lowlandFitness || 0) * 3.0 + (next.urbanWeight || 0) * 2.2 - barrier * 2.5 - distance * 0.13 - Math.max(0, (next.area || 0) - 240) * 0.006;
+          const previous = candidates.get(nextId);
+          if (!previous || score > previous.score) candidates.set(nextId, { unit: next, donor, score });
+        }
+      }
+      const best = [...candidates.values()].sort((a, b) => b.score - a.score || a.unit.id - b.unit.id)[0];
+      if (!best) break;
+      owner[best.unit.id] = cityOwner;
+      localChanged += best.unit.area || 0;
+      changedCells += best.unit.area || 0;
+      rows = ownerAreaByCompartment(owner, compartments);
+      currentArea = rows.area.get(cityOwner) || 0;
+    }
+    if (localChanged > 0) expandedCities++;
+  }
+  const connectivity = repairCompartmentOwnerConnectivity(owner, compartments, 6);
+  const enclaves = repairCompartmentOwnerEnclaves(owner, compartments, prefectureMask, sea, 4);
+  applyCompartmentOwners(adminId, compartments, owner);
+  return {
+    changedCells: changedCells + connectivity.changedCells + enclaves.changedCells,
+    expandedCities,
+    connectivityChangedCells: connectivity.changedCells,
+    enclaveChangedCells: enclaves.changedCells,
+  };
+}
+
 export function enforceSimpleAdministrativeHierarchy(adminId, compartments, prefectureMask, sea, fields = {}) {
   const owner = dominantCompartmentOwners(compartments, adminId);
   const urban = lockCompactUrbanCompartmentsToDominantOwner(owner, compartments, fields.maxUrbanClusterCells || 1100);
@@ -496,60 +550,6 @@ export function enforceSimpleAdministrativeHierarchy(adminId, compartments, pref
 }
 
 
-export function repairPrefectureCellEnclavesFromGrid(adminId, owner, prefectureMask, sea, maxPasses = 5) {
-  let changed = 0;
-  const dirs = [[1,0],[-1,0],[0,1],[0,-1]];
-  for (let pass = 0; pass < maxPasses; pass++) {
-    const prefId = new Int16Array(SIZE);
-    prefId.fill(-1);
-    for (let i = 0; i < SIZE; i++) {
-      if (!prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
-      prefId[i] = owner.get(adminId[i]) ?? -1;
-    }
-    const seen = new Uint8Array(SIZE);
-    let passChanged = 0;
-    for (let i = 0; i < SIZE; i++) {
-      if (seen[i] || prefId[i] < 0) continue;
-      const id = prefId[i];
-      const queue = [i];
-      const comp = [];
-      seen[i] = 1;
-      let touchesOutside = false;
-      const boundaryCounts = new Map();
-      const adminCounts = new Map();
-      for (let q = 0; q < queue.length; q++) {
-        const cur = queue[q];
-        comp.push(cur);
-        const aid = adminId[cur];
-        if (aid >= 0) adminCounts.set(aid, (adminCounts.get(aid) || 0) + 1);
-        const [x, y] = xyOf(cur);
-        if (x === 0 || y === 0 || x === MAP_W - 1 || y === MAP_H - 1) touchesOutside = true;
-        for (const [dx, dy] of dirs) {
-          const nx = x + dx, ny = y + dy;
-          if (!inside(nx, ny)) { touchesOutside = true; continue; }
-          const ni = indexOf(nx, ny);
-          if (!prefectureMask[ni] || sea[ni]) { touchesOutside = true; continue; }
-          const nid = prefId[ni];
-          if (nid === id) {
-            if (!seen[ni]) { seen[ni] = 1; queue.push(ni); }
-          } else if (nid >= 0) {
-            boundaryCounts.set(nid, (boundaryCounts.get(nid) || 0) + 1);
-          }
-        }
-      }
-      if (touchesOutside || boundaryCounts.size !== 1) continue;
-      const [targetPref] = boundaryCounts.keys();
-      if (targetPref < 0 || targetPref === id) continue;
-      for (const aid of adminCounts.keys()) {
-        if (owner.get(aid) !== targetPref) { owner.set(aid, targetPref); passChanged++; }
-      }
-    }
-    changed += passChanged;
-    if (!passChanged) break;
-  }
-  return changed;
-}
-
 export function repairAdminSingleOwnerEnclaves(adminId, prefectureMask, sea, maxPasses = 5) {
   let changed = 0;
   const dirs = [[1,0],[-1,0],[0,1],[0,-1]];
@@ -594,49 +594,6 @@ export function repairAdminSingleOwnerEnclaves(adminId, prefectureMask, sea, max
   return changed;
 }
 
-export function lockCompactUrbanAreasToDominantAdmin(adminId, prefectureMask, sea, landuse, populationDensity, maxCells = 950) {
-  if (!landuse || !populationDensity) return 0;
-  const seen = new Uint8Array(SIZE);
-  const dirs = [[1,0],[-1,0],[0,1],[0,-1]];
-  let changed = 0;
-  const isUrban = (i) => !sea[i] && prefectureMask[i] && (populationDensity[i] > 0.34 || [2, 3, 4, 7, 8].includes(landuse[i]));
-  for (let i = 0; i < SIZE; i++) {
-    if (seen[i] || !isUrban(i) || adminId[i] < 0) continue;
-    const queue = [i];
-    const comp = [];
-    seen[i] = 1;
-    const counts = new Map();
-    for (let q = 0; q < queue.length; q++) {
-      const cur = queue[q];
-      comp.push(cur);
-      const id = adminId[cur];
-      if (id >= 0) counts.set(id, (counts.get(id) || 0) + 1 + (populationDensity[cur] || 0) * 2.0);
-      const [x, y] = xyOf(cur);
-      for (const [dx, dy] of dirs) {
-        const nx = x + dx, ny = y + dy;
-        if (!inside(nx, ny)) continue;
-        const ni = indexOf(nx, ny);
-        if (seen[ni] || !isUrban(ni)) continue;
-        seen[ni] = 1;
-        queue.push(ni);
-      }
-    }
-    if (comp.length < 8 || comp.length > maxCells || counts.size <= 1 || counts.size > 7) continue;
-    let best = -1, bestScore = -INF;
-    let total = 0;
-    for (const [id, score] of counts) {
-      total += score;
-      if (score > bestScore || (score === bestScore && id < best)) { best = id; bestScore = score; }
-    }
-    if (best < 0 || bestScore / Math.max(1, total) < 0.38) continue;
-    for (const ci of comp) {
-      if (adminId[ci] !== best) { adminId[ci] = best; changed++; }
-    }
-  }
-  return changed;
-}
-
-
 export function splitOversizedCompartmentMunicipalities(adminId, centers, compartments, prefectureMask, sea, fields = {}, seed = 0) {
   if (!compartments?.length) return { changedCells: 0, splitMunicipalities: 0, addedCenters: 0 };
   const compOwner = new Int16Array(compartments.length);
diff --git a/mapAdminSeedLifecycle.js b/src/mapAdminSeedLifecycle.js
similarity index 100%
rename from mapAdminSeedLifecycle.js
rename to src/mapAdminSeedLifecycle.js
diff --git a/src/mapAdminShared.js b/src/mapAdminShared.js
new file mode 100644
index 0000000..f5bb163
--- /dev/null
+++ b/src/mapAdminShared.js
@@ -0,0 +1,69 @@
+import { MAP_H, MAP_W, SIZE } from "./mapUtils.js";
+
+export function municipalityAreaById(adminId, prefectureMask, sea) {
+  const area = new Map();
+  for (let i = 0; i < SIZE; i++) {
+    if (!prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
+    area.set(adminId[i], (area.get(adminId[i]) || 0) + 1);
+  }
+  return area;
+}
+
+export function maskLandArea(mask, sea) {
+  let area = 0;
+  for (let i = 0; i < SIZE; i++) if (mask[i] && !sea[i]) area++;
+  return area;
+}
+
+
+export function dominantCompartmentOwners(compartments, adminId) {
+  const owner = new Int16Array(compartments.length);
+  owner.fill(-1);
+  for (const unit of compartments) {
+    if (!unit || unit.area === 0) continue;
+    const counts = new Map();
+    for (const i of unit.cells) {
+      const id = adminId[i];
+      if (id >= 0) counts.set(id, (counts.get(id) || 0) + 1);
+    }
+    let bestId = -1, best = -1;
+    for (const [id, count] of counts) if (count > best) { best = count; bestId = id; }
+    owner[unit.id] = bestId;
+  }
+  return owner;
+}
+
+export function applyCompartmentOwners(adminId, compartments, owner) {
+  for (const unit of compartments) {
+    if (!unit || unit.area === 0) continue;
+    const id = owner[unit.id];
+    if (id < 0) continue;
+    for (const i of unit.cells) adminId[i] = id;
+  }
+}
+
+
+
+export function averageFieldAcrossOwnerBorders(ownerAt, mask, sea, field) {
+  if (typeof ownerAt !== "function" || !field) return 0;
+  const width = MAP_W;
+  const height = MAP_H;
+  let sum = 0;
+  let count = 0;
+  for (let y = 1; y < height - 1; y++) {
+    for (let x = 1; x < width - 1; x++) {
+      const i = y * width + x;
+      if (!mask[i] || sea[i]) continue;
+      const a = ownerAt(i);
+      if (!Number.isFinite(a) || a < 0) continue;
+      for (const ni of [i + 1, i + width]) {
+        if (!mask[ni] || sea[ni]) continue;
+        const b = ownerAt(ni);
+        if (!Number.isFinite(b) || b < 0 || a === b) continue;
+        sum += ((field[i] || 0) + (field[ni] || 0)) * 0.5;
+        count++;
+      }
+    }
+  }
+  return count ? sum / count : 0;
+}
diff --git a/src/mapAdminStage.js b/src/mapAdminStage.js
new file mode 100644
index 0000000..18b5d6b
--- /dev/null
+++ b/src/mapAdminStage.js
@@ -0,0 +1,321 @@
+import {
+  assignAdminRegionsFromNaturalCompartments,
+  enforceMunicipalityConnectivityStrict
+} from "./adminRegionsCore.js";
+import { INF, MAP_H, MAP_W, clamp, indexOf, inside, rand } from "./mapUtils.js";
+import { extractAdminBorderSegments } from "./mapGeneratorHelpers.js";
+import {
+  municipalityAreaById,
+  maskLandArea
+} from "./mapAdminShared.js";
+import {
+  compactWholeCompartmentMunicipalities,
+  enforceCompartmentMunicipalityOwnership,
+  enforceSimpleAdministrativeHierarchy,
+  expandMajorCityMunicipalitiesByCompartment,
+  reduceMunicipalityCountByCompartment,
+  repairAdminSingleOwnerEnclaves,
+  splitOversizedCompartmentMunicipalities
+} from "./mapAdminCompartmentRepair.js";
+import { generatePrefecturesFromMunicipalities } from "./mapPrefectureStage.js";
+
+import {
+  computeTargetMunicipalityCount,
+  buildLowlandAdminSeeds,
+} from "./mapAdminTargets.js";
+import {
+  classifySatelliteMunicipalities
+} from "./mapAdminUrbanCatchments.js";
+
+
+function capCompactedMunicipalityCount(compacted, prefectureMask, sea, targetCount, modernCities, fields) {
+  if (!compacted?.adminId || !Number.isFinite(targetCount)) return { compacted, changedCells: 0, mergedMunicipalities: 0 };
+  const adminId = compacted.adminId;
+  let changedCells = 0;
+  let mergedMunicipalities = 0;
+  for (let pass = 0; pass < 24; pass++) {
+    const area = municipalityAreaById(adminId, prefectureMask, sea);
+    if (area.size <= targetCount) break;
+    const protectedIds = new Set();
+    for (const city of modernCities || []) {
+      if (!city || !inside(city.x, city.y) || (city.population || 0) < 95000) continue;
+      const id = adminId[indexOf(city.x, city.y)];
+      if (id >= 0) protectedIds.add(id);
+    }
+    const candidates = [...area.entries()]
+      .filter(([id]) => !protectedIds.has(id))
+      .sort((a, b) => a[1] - b[1] || a[0] - b[0]);
+    if (!candidates.length) break;
+    let merged = false;
+    for (const [source] of candidates) {
+      const neighbors = new Map();
+      let sx = 0, sy = 0, n = 0;
+      for (let y = 0; y < MAP_H; y++) for (let x = 0; x < MAP_W; x++) {
+        const i = indexOf(x, y);
+        if (!prefectureMask[i] || sea[i] || adminId[i] !== source) continue;
+        sx += x; sy += y; n++;
+        for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+          const nx = x + dx, ny = y + dy;
+          if (!inside(nx, ny)) continue;
+          const ni = indexOf(nx, ny);
+          const target = adminId[ni];
+          if (!prefectureMask[ni] || sea[ni] || target < 0 || target === source) continue;
+          neighbors.set(target, (neighbors.get(target) || 0) + 1);
+        }
+      }
+      let target = [...neighbors.entries()].sort((a, b) => b[1] - a[1] || a[0] - b[0])[0]?.[0] ?? -1;
+      if (target < 0 && n > 0) {
+        const cx = sx / n, cy = sy / n;
+        let bestDistance = INF;
+        for (const [centerIndex, center] of (compacted.adminCentersRaw || []).entries()) {
+          const id = center?.adminId ?? center?.municipalityId ?? center?.adminNumericId ?? centerIndex;
+          if (!Number.isFinite(id) || id < 0 || id === source) continue;
+          const d = Math.hypot((center.x || 0) - cx, (center.y || 0) - cy);
+          if (d < bestDistance) { bestDistance = d; target = id; }
+        }
+      }
+      if (target < 0 || target === source) continue;
+      for (let i = 0; i < adminId.length; i++) {
+        if (adminId[i] === source) { adminId[i] = target; changedCells++; }
+      }
+      mergedMunicipalities++;
+      merged = true;
+      break;
+    }
+    if (!merged) break;
+  }
+  if (!mergedMunicipalities) return { compacted, changedCells, mergedMunicipalities };
+  return {
+    compacted: compactWholeCompartmentMunicipalities(adminId, compacted.adminCentersRaw, prefectureMask, sea, fields),
+    changedCells,
+    mergedMunicipalities,
+  };
+}
+
+function generateAdminLayoutForMask({
+  seed,
+  prefectureMask,
+  sea,
+  elevation,
+  slope,
+  river,
+  ridgeField,
+  naturalBarrierScore,
+  valleyField,
+  basinField,
+  coastalLowland,
+  flowAccum,
+  plain,
+  agriculture,
+  settlementScore,
+  populationDensity,
+  stationInfluence,
+  roadInfluence,
+  railInfluence2,
+  villageInfluence,
+  landuse,
+  modernCities,
+  satelliteCities,
+  newTowns,
+  markets,
+  villages,
+  ports,
+  stations,
+  industrialZones,
+  logisticsParks,
+  naturalCompartmentId,
+  naturalCompartments,
+  geography = null,
+  habitability = null,
+  accessibility = null,
+  centrality = null,
+  geographicBarrier = null,
+  geographicBarrierCost = null,
+  adminBoundaryPreference = null,
+  boundaryAvoidance = null,
+  adminRegionMeta = {},
+  adminProgress = null,
+}) {
+  const unifiedBoundaryPreference = adminBoundaryPreference || geography?.adminBoundaryPreference || null;
+  const unifiedBoundaryAvoidance = boundaryAvoidance || geography?.boundaryAvoidance || null;
+  const unifiedGeographicBarrier = geographicBarrier || geography?.geographicBarrier || null;
+  const boundaryRidgeField = naturalBarrierScore
+    ? Float32Array.from(ridgeField, (value, i) => clamp(value * 0.72 + naturalBarrierScore[i] * 0.46))
+    : ridgeField;
+  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "classify satellites" });
+  classifySatelliteMunicipalities(satelliteCities, modernCities, prefectureMask, sea, landuse, populationDensity, roadInfluence, railInfluence2, boundaryRidgeField, river, flowAccum);
+  const targetMunicipalityCount = computeTargetMunicipalityCount({ prefectureMask, sea, elevation, slope, ridgeField: boundaryRidgeField, coastalLowland, basinField, habitability: habitability || geography?.habitability, centrality: centrality || geography?.centrality, accessibility: accessibility || geography?.accessibility, geographicBarrier: unifiedGeographicBarrier, modernCities, markets, ports, satelliteCities, villages, adminRegionMeta });
+  const compartmentMultiplier = clamp(4.6 + rand(seed, 1320) * 2.4, 4.6, 7.0);
+  const regionLandArea = adminRegionMeta.landArea || maskLandArea(prefectureMask, sea);
+  const minCompartmentTarget = clamp(Math.round(Math.max(targetMunicipalityCount * 3.4, regionLandArea / 78)), 22, 150);
+  const maxCompartmentTarget = clamp(Math.round(Math.max(targetMunicipalityCount * 6.0, regionLandArea / 36)), minCompartmentTarget, 320);
+  let targetCompartmentCount = clamp(Math.round(targetMunicipalityCount * compartmentMultiplier), minCompartmentTarget, maxCompartmentTarget);
+  let adminCentersRaw = buildLowlandAdminSeeds({
+    seed,
+    targetMunicipalityCount,
+    prefectureMask,
+    sea,
+    elevation,
+    slope,
+    ridgeField: boundaryRidgeField,
+    plain,
+    basinField,
+    coastalLowland,
+    settlementScore,
+    populationDensity,
+    roadInfluence,
+    railInfluence2,
+    stationInfluence,
+    landuse,
+    habitability: habitability || geography?.habitability,
+    accessibility: accessibility || geography?.accessibility,
+    centrality: centrality || geography?.centrality,
+    boundaryAvoidance: unifiedBoundaryAvoidance,
+    adminBoundaryPreference: unifiedBoundaryPreference,
+    geographicBarrier: unifiedGeographicBarrier,
+    modernCities,
+    satelliteCities,
+    markets,
+    ports,
+    newTowns,
+    stations,
+  });
+  if (adminCentersRaw.length < targetMunicipalityCount) targetCompartmentCount = Math.max(targetCompartmentCount, minCompartmentTarget);
+  adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "natural compartments", targetMunicipalityCount, targetCompartmentCount, seedCount: adminCentersRaw.length });
+  const compartmentAssignment = assignAdminRegionsFromNaturalCompartments(prefectureMask, sea, elevation, slope, river, boundaryRidgeField, valleyField, basinField, coastalLowland, flowAccum, plain, agriculture, populationDensity, landuse, adminCentersRaw, {
+    seed,
+    targetMunicipalityCount,
+    targetCompartmentCount,
+    maxNaturalCompartmentArea: Math.max(32, Math.round(maskLandArea(prefectureMask, sea) / Math.max(1, targetCompartmentCount) * 1.65)),
+    naturalCompartmentId,
+    naturalCompartments,
+    naturalBarrierScore,
+    geography,
+    habitability: habitability || geography?.habitability,
+    accessibility: accessibility || geography?.accessibility,
+    centrality: centrality || geography?.centrality,
+    boundaryAvoidance: unifiedBoundaryAvoidance,
+    adminBoundaryPreference: unifiedBoundaryPreference,
+    geographicBarrier: unifiedGeographicBarrier,
+    progress: (step) => adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step }),
+  });
+  const adminId = compartmentAssignment.adminId;
+  if (naturalCompartmentId && naturalCompartments) {
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "split oversized municipalities" });
+    const oversizedCompartmentSplit = splitOversizedCompartmentMunicipalities(adminId, adminCentersRaw, compartmentAssignment.compartments, prefectureMask, sea, {
+      elevation, slope, ridgeField: boundaryRidgeField, plain, agriculture, basinField, coastalLowland, populationDensity,
+    }, seed + 21900);
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "initial compartment ownership" });
+    const changedAfterInitialCompartmentOwnership = enforceCompartmentMunicipalityOwnership(adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea);
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "simple administrative hierarchy" });
+    const hierarchyRepair = enforceSimpleAdministrativeHierarchy(adminId, compartmentAssignment.compartments, prefectureMask, sea, {
+      minCompartmentsPerMunicipality: 2,
+      maxUrbanClusterCells: 1600,
+      modernCities,
+    });
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "reduce municipality count" });
+    const municipalityCountReduction = reduceMunicipalityCountByCompartment(
+      adminId, compartmentAssignment.compartments, prefectureMask, sea, targetMunicipalityCount, modernCities
+    );
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "expand major city municipalities" });
+    const cityCompartmentExpansion = expandMajorCityMunicipalitiesByCompartment(
+      adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea, modernCities
+    );
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "final compartment ownership" });
+    const changedAfterFinalCompartmentOwnership = enforceCompartmentMunicipalityOwnership(adminId, compartmentAssignment.compartmentId, compartmentAssignment.compartments, prefectureMask, sea);
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "compact municipalities" });
+    let compacted = compactWholeCompartmentMunicipalities(adminId, adminCentersRaw, prefectureMask, sea, { populationDensity, plain, slope });
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "final municipality count cap" });
+    const finalCountCap = capCompactedMunicipalityCount(compacted, prefectureMask, sea, targetMunicipalityCount, modernCities, { populationDensity, plain, slope });
+    compacted = finalCountCap.compacted;
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "strict municipality connectivity" });
+    const strictConnectivityChangedCells = enforceMunicipalityConnectivityStrict(compacted.adminId, prefectureMask, sea, compacted.adminCentersRaw, [...modernCities, ...(compacted.adminCentersRaw || [])], 8);
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "strict municipality enclave repair" });
+    const strictEnclaveRepairChangedCells = repairAdminSingleOwnerEnclaves(compacted.adminId, prefectureMask, sea, 4);
+    adminProgress?.({ status: "admin-step", regionId: adminRegionMeta.regionId, step: "extract admin borders" });
+    const adminBorders = extractAdminBorderSegments(compacted.adminId, prefectureMask);
+    const actualMunicipalityCount = new Set([...compacted.adminId].filter((id, i) => id >= 0 && prefectureMask[i] && !sea[i])).size;
+    const naturalCompartmentCount = compartmentAssignment.debug?.naturalCompartmentCount || naturalCompartments.filter((unit) => unit && unit.area > 0).length;
+    const finalAreas = municipalityAreaById(compacted.adminId, prefectureMask, sea);
+    const independentSatelliteRows = (satelliteCities || []).filter((sat) => {
+      if (!sat || sat.municipalityClass !== "independentSatelliteMunicipality" || !inside(sat.x, sat.y)) return false;
+      const i = indexOf(sat.x, sat.y);
+      return prefectureMask[i] && !sea[i] && compacted.adminId[i] >= 0;
+    }).map((sat) => finalAreas.get(compacted.adminId[indexOf(sat.x, sat.y)]) || 0);
+    const adminDebug = {
+      ...compartmentAssignment.debug,
+      simpleHierarchyPrototype: true,
+      administrativeHierarchySpec: "unified-geography->natural-compartments->living-sphere-municipalities->prefectures",
+      unifiedGeographyAdministrativeBasis: true,
+      naturalCompartmentsImmutable: true,
+      municipalitiesAreCompartmentGroups: true,
+      prefecturesAreMunicipalityGroups: true,
+      cellLevelAdminSmoothingDisabled: true,
+      sharedNaturalCompartmentLayer: true,
+      skippedLegacyCellCleanupForHierarchy: true,
+      targetMunicipalityCount,
+      actualMunicipalityCount,
+      finalMunicipalityCount: actualMunicipalityCount,
+      changedAfterLandscapePartition: changedAfterInitialCompartmentOwnership + changedAfterFinalCompartmentOwnership,
+      changedAfterUrbanLock: hierarchyRepair.changedAfterUrbanUnification + cityCompartmentExpansion.changedCells,
+      changedAfterFinalExclaveRemoval: strictEnclaveRepairChangedCells + (cityCompartmentExpansion.enclaveChangedCells || 0),
+      changedAfterFinalMerge: hierarchyRepair.changedAfterSingleCompartmentMunicipalityMerge,
+      changedAfterMunicipalityCountReduction: municipalityCountReduction.changedCells,
+      municipalitiesMergedForTargetCount: municipalityCountReduction.mergedMunicipalities,
+      municipalityCountAfterReduction: municipalityCountReduction.finalMunicipalityCount,
+      changedAfterFinalMunicipalityCountCap: finalCountCap.changedCells,
+      municipalitiesMergedByFinalCountCap: finalCountCap.mergedMunicipalities,
+      changedAfterCityCompartmentExpansion: cityCompartmentExpansion.changedCells,
+      cityMunicipalitiesExpanded: cityCompartmentExpansion.expandedCities,
+      satelliteMunicipalitiesCreated: independentSatelliteRows.length,
+      averageSatelliteMunicipalityArea: independentSatelliteRows.length ? independentSatelliteRows.reduce((sum, value) => sum + value, 0) / independentSatelliteRows.length : 0,
+      changedAfterStrictMunicipalityConnectivity: strictConnectivityChangedCells,
+      changedAfterStrictMunicipalityEnclaveRepair: strictEnclaveRepairChangedCells,
+      candidateSeedCount: adminCentersRaw.length,
+      municipalOfficePointCount: compacted.adminCentersRaw.length,
+      survivedSeedCount: compacted.activeMunicipalityCount,
+      absorbedSeedCount: Math.max(0, adminCentersRaw.length - compacted.activeMunicipalityCount),
+      targetNaturalCompartmentCount: targetCompartmentCount,
+      naturalCompartmentCount,
+      compartmentCount: naturalCompartmentCount,
+      changedAfterCompartmentAssignment: naturalCompartmentCount,
+      changedAfterInitialCompartmentOwnership,
+      changedAfterFinalCompartmentOwnership,
+      changedAfterUrbanUnification: hierarchyRepair.changedAfterUrbanUnification,
+      urbanComponentsUnified: hierarchyRepair.urbanComponentsUnified,
+      changedAfterCityMetroMunicipalityUnification: hierarchyRepair.changedAfterCityMetroMunicipalityUnification,
+      cityMetroMunicipalitiesUnified: hierarchyRepair.cityMetroMunicipalitiesUnified,
+      changedAfterCompartmentConnectivity: hierarchyRepair.changedAfterCompartmentConnectivity,
+      disconnectedCompartmentComponentsMerged: hierarchyRepair.disconnectedCompartmentComponentsMerged,
+      changedAfterAdminEnclaveRepair: hierarchyRepair.changedAfterCompartmentEnclaveRepair,
+      compartmentEnclaveComponentsMerged: hierarchyRepair.compartmentEnclaveComponentsMerged,
+      changedAfterSingleCompartmentMunicipalityMerge: hierarchyRepair.changedAfterSingleCompartmentMunicipalityMerge,
+      singleCompartmentMunicipalitiesMerged: hierarchyRepair.singleCompartmentMunicipalitiesMerged,
+      remainingSingleCompartmentMunicipalities: hierarchyRepair.remainingSingleCompartmentMunicipalities,
+      changedAfterPostMergeCompartmentOwnership: changedAfterFinalCompartmentOwnership,
+      changedAfterOversizedCompartmentSplit: oversizedCompartmentSplit.changedCells,
+      oversizedCompartmentMunicipalitiesSplit: oversizedCompartmentSplit.splitMunicipalities,
+      oversizedCompartmentSplitAddedCenters: oversizedCompartmentSplit.addedCenters,
+      oversizedCompartmentSplitMaxArea: oversizedCompartmentSplit.maxArea || 0,
+      finalTinyMunicipalityCount: [...municipalityAreaById(compacted.adminId, prefectureMask, sea).values()].filter((area) => area > 0 && area < 8).length,
+      compartmentBorders: compartmentAssignment.debug?.compartmentBorders || [],
+      borderNaturalBarrierAverage: compartmentAssignment.debug?.finalBorderNaturalBarrierAverage || 0,
+      voronoiLikeRate: compartmentAssignment.debug?.voronoiLikeRateAfter || 0,
+    };
+    return {
+      adminCentersRaw: compacted.adminCentersRaw,
+      adminId: compacted.adminId,
+      adminBorders,
+      adminDebug,
+      naturalCompartmentId: compartmentAssignment.compartmentId,
+      naturalCompartments: compartmentAssignment.compartments,
+    };
+  }
+  throw new Error("generateAdminLayout requires terrain natural compartments");
+}
+
+
+export function generateAdminLayout(context) {
+  const layout = generateAdminLayoutForMask(context);
+  return { ...layout, ...generatePrefecturesFromMunicipalities(context, layout) };
+}
diff --git a/mapAdminTargets.js b/src/mapAdminTargets.js
similarity index 94%
rename from mapAdminTargets.js
rename to src/mapAdminTargets.js
index ef7df12..4937848 100644
--- a/mapAdminTargets.js
+++ b/src/mapAdminTargets.js
@@ -1,6 +1,6 @@
 import { MAP_H, MAP_W, clamp, hash2, indexOf, inside, pickEntities, rand } from "./mapUtils.js";
 
-export function municipalityCountBoundsForRegion(landCells, meta = {}) {
+function municipalityCountBoundsForRegion(landCells, meta = {}) {
   // Use the same administrative density curve for the highlighted prefecture
   // and neighboring prefectures.  Only clipped slivers get a low floor.
   let min = 1;
@@ -10,7 +10,7 @@ export function municipalityCountBoundsForRegion(landCells, meta = {}) {
   if (landCells >= 2400) min = 11;
   if (landCells >= 3800) min = 16;
   if (landCells >= 5600) min = 22;
-  const max = clamp(Math.round(landCells / 160 + 6), Math.max(min, 4), 72);
+  const max = clamp(Math.round(landCells / 190 + 7), Math.max(min, 4), 50);
   return { min, max };
 }
 
@@ -60,7 +60,7 @@ export function computeTargetMunicipalityCount({ prefectureMask, sea, elevation,
   return clamp(rawTarget, min, max);
 }
 
-export function lowlandAdminSeedScore(i, { elevation, slope, ridgeField, plain, basinField, coastalLowland, settlementScore, populationDensity, roadInfluence, railInfluence2, stationInfluence, landuse, habitability, accessibility, centrality, boundaryAvoidance, adminBoundaryPreference, geographicBarrier }) {
+function lowlandAdminSeedScore(i, { elevation, slope, ridgeField, plain, basinField, coastalLowland, settlementScore, populationDensity, roadInfluence, railInfluence2, stationInfluence, landuse, habitability, accessibility, centrality, boundaryAvoidance, adminBoundaryPreference, geographicBarrier }) {
   const lowRelief = clamp((0.70 - elevation[i]) * 1.35) + clamp((0.34 - slope[i]) * 1.55) + clamp((0.48 - ridgeField[i]) * 1.10);
   const landuseFit = [1, 2, 3, 4, 7, 8].includes(landuse[i]) ? 0.40 : landuse[i] === 5 || landuse[i] === 6 ? 0.12 : 0;
   const unifiedNudge = clamp(
diff --git a/src/mapAdminUrbanCatchments.js b/src/mapAdminUrbanCatchments.js
new file mode 100644
index 0000000..90b097f
--- /dev/null
+++ b/src/mapAdminUrbanCatchments.js
@@ -0,0 +1,94 @@
+import { SIZE, clamp, indexOf, inside, xyOf } from "./mapUtils.js";
+
+
+function estimateUrbanComponentArea(city, prefectureMask, sea, landuse, populationDensity) {
+  if (!city || !inside(city.x, city.y)) return 0;
+  const start = indexOf(city.x, city.y);
+  if (!prefectureMask[start] || sea[start]) return 0;
+  const radius = Math.ceil(Math.max(7, (city.urbanRadius || 6) * 1.7));
+  const seen = new Uint8Array(SIZE);
+  const queue = [start];
+  seen[start] = 1;
+  let area = 0;
+  for (let q = 0; q < queue.length; q++) {
+    const cur = queue[q];
+    const [x, y] = xyOf(cur);
+    const d = Math.hypot(x - city.x, y - city.y);
+    if (d > radius) continue;
+    const urban = (landuse[cur] >= 2 && landuse[cur] <= 4) || landuse[cur] === 7 || landuse[cur] === 8 || populationDensity[cur] > 0.18;
+    if (!urban) continue;
+    area++;
+    for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]]) {
+      const nx = x + dx, ny = y + dy;
+      if (!inside(nx, ny)) continue;
+      const ni = indexOf(nx, ny);
+      if (seen[ni] || !prefectureMask[ni] || sea[ni]) continue;
+      seen[ni] = 1;
+      queue.push(ni);
+    }
+  }
+  return area;
+}
+
+function terrainSeparationBetween(a, b, ridgeField, river, flowAccum, populationDensity, landuse) {
+  if (!a || !b) return { separatedByBarrier: false, ruralGap: false, averageDensity: 0, maxBarrier: 0 };
+  const steps = Math.max(1, Math.ceil(Math.hypot(a.x - b.x, a.y - b.y)));
+  let maxBarrier = 0;
+  let lowUrbanRun = 0;
+  let bestLowUrbanRun = 0;
+  let densitySum = 0;
+  for (let s = 0; s <= steps; s++) {
+    const t = s / steps;
+    const x = Math.round(a.x + (b.x - a.x) * t);
+    const y = Math.round(a.y + (b.y - a.y) * t);
+    if (!inside(x, y)) continue;
+    const i = indexOf(x, y);
+    const barrier = Math.max(ridgeField[i] * 0.95, river[i] * 0.85, flowAccum[i] * 0.42);
+    maxBarrier = Math.max(maxBarrier, barrier);
+    densitySum += populationDensity[i];
+    const urban = (landuse[i] >= 2 && landuse[i] <= 4) || landuse[i] === 7 || populationDensity[i] > 0.20;
+    if (urban) lowUrbanRun = 0;
+    else {
+      lowUrbanRun++;
+      bestLowUrbanRun = Math.max(bestLowUrbanRun, lowUrbanRun);
+    }
+  }
+  return {
+    separatedByBarrier: maxBarrier > 0.56,
+    ruralGap: bestLowUrbanRun >= 4,
+    averageDensity: densitySum / (steps + 1),
+    maxBarrier,
+  };
+}
+
+export function classifySatelliteMunicipalities(satelliteCities, modernCities, prefectureMask, sea, landuse, populationDensity, roadInfluence, railInfluence2, ridgeField, river, flowAccum) {
+  let independent = 0;
+  let attached = 0;
+  for (const sat of satelliteCities || []) {
+    if (!sat || !inside(sat.x, sat.y) || !prefectureMask[indexOf(sat.x, sat.y)] || sea[indexOf(sat.x, sat.y)]) continue;
+    const parent = modernCities[sat.parentCityIndex] || modernCities.slice().sort((a, b) => Math.hypot(a.x - sat.x, a.y - sat.y) - Math.hypot(b.x - sat.x, b.y - sat.y))[0];
+    const parentDistance = parent ? Math.hypot(parent.x - sat.x, parent.y - sat.y) : 99;
+    const separation = terrainSeparationBetween(sat, parent, ridgeField, river, flowAccum, populationDensity, landuse);
+    const urbanArea = estimateUrbanComponentArea(sat, prefectureMask, sea, landuse, populationDensity);
+    const i = indexOf(sat.x, sat.y);
+    const continuousUrban = parent && parentDistance < Math.max(10, (parent.urbanRadius || 12) + (sat.urbanRadius || 5) + 5) && separation.averageDensity > 0.14 && !separation.ruralGap && !separation.separatedByBarrier;
+    const newTownLike = landuse[i] === 7 || (railInfluence2[i] > 0.22 && roadInfluence[i] > 0.12 && (sat.population || 0) < 70000);
+    let municipalityClass = "independentSatelliteMunicipality";
+    if (continuousUrban && (sat.population || 0) < 90000) municipalityClass = "suburbanDistrictMergedWithParent";
+    else if (newTownLike && (sat.population || 0) < 85000 && !separation.separatedByBarrier) municipalityClass = "newTownDistrict";
+    else if ((sat.population || 0) < 42000 && urbanArea < 55 && !separation.separatedByBarrier) municipalityClass = "smallTownAttachedToRuralMunicipality";
+    else if ((sat.population || 0) >= 60000 && urbanArea >= 42 && (separation.separatedByBarrier || separation.ruralGap || parentDistance > 15)) municipalityClass = "independentSatelliteMunicipality";
+
+    sat.municipalityClass = municipalityClass;
+    sat.parentX = parent?.x;
+    sat.parentY = parent?.y;
+    sat.parentAdminHint = -1;
+    sat.distinctUrbanComponentArea = urbanArea;
+    sat.separatedByBarrier = separation.separatedByBarrier || separation.ruralGap;
+    sat.satelliteMinArea = clamp(90 + Math.sqrt(sat.population || 24000) * 0.62 + (sat.urbanRadius || 5) * 12, 80, 360);
+    if (municipalityClass === "independentSatelliteMunicipality") independent++;
+    else attached++;
+  }
+  return { independent, attached };
+}
+
diff --git a/mapFeatureContext.js b/src/mapFeatureContext.js
similarity index 82%
rename from mapFeatureContext.js
rename to src/mapFeatureContext.js
index cbfc2d6..e4c99da 100644
--- a/mapFeatureContext.js
+++ b/src/mapFeatureContext.js
@@ -1,6 +1,11 @@
-import { INF, MAP_H, MAP_W, SIZE, clamp, fbm, hash2, indexOf, inside, pickEntities, valueNoise } from "./mapUtils.js";
+import { INF, MAP_H, MAP_W, SIZE, clamp, fbm, finiteFieldValue, hash2, indexOf, inside, pickEntities, valueNoise } from "./mapUtils.js";
+import { localConfluenceScore } from "./mapGeography.js";
 
 export function buildFeatureContext(seed, terrain) {
+  const worldOriginX = Math.floor(Number(terrain?.generationContext?.originX || terrain?.originX || 0));
+  const worldOriginY = Math.floor(Number(terrain?.generationContext?.originY || terrain?.originY || 0));
+  const worldX = (x) => worldOriginX + x;
+  const worldY = (y) => worldOriginY + y;
   const {
     elevation,
     slope,
@@ -34,10 +39,6 @@ export function buildFeatureContext(seed, terrain) {
   const geoBarrier = geography.geographicBarrier || naturalBarrierScore || null;
   const geoCorridorSuitability = geography.corridorSuitability || null;
 
-  function fieldValue(field, i, fallback = 0) {
-    const v = field?.[i];
-    return Number.isFinite(v) ? v : fallback;
-  }
 
   function regionIdAt(x, y) {
     if (!inside(x, y)) return -1;
@@ -53,20 +54,6 @@ export function buildFeatureContext(seed, terrain) {
     return Boolean(p && inside(p.x, p.y) && prefectureMask[indexOf(p.x, p.y)] && !sea[indexOf(p.x, p.y)]);
   }
 
-  function localConfluenceScore(x, y) {
-    let arms = 0;
-    let strong = 0;
-    for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1],[1,1],[-1,1],[1,-1],[-1,-1]]) {
-      const nx = x + dx;
-      const ny = y + dy;
-      if (!inside(nx, ny)) continue;
-      const rv = river[indexOf(nx, ny)];
-      if (rv > 0.18) arms++;
-      if (rv > 0.34) strong++;
-    }
-    return clamp((arms >= 3 ? 0.22 : arms === 2 ? 0.09 : 0) + strong * 0.04);
-  }
-
   // --- 1. Human context: one full raster pass -----------------------------
   const developable = new Float32Array(SIZE);
   const ruralSuitability = new Float32Array(SIZE);
@@ -91,16 +78,16 @@ export function buildFeatureContext(seed, terrain) {
       const depositional = (depositionalLowland?.[i] || 0) + (alluvialFanField?.[i] || 0) * 0.62 + (deltaField?.[i] || 0) * 0.90;
       const highPenalty = Math.max(0, elevation[i] - 0.56);
       const lowSlope = clamp(1 - slope[i] * 2.3);
-      const confluence = x > 0 && y > 0 && x < MAP_W - 1 && y < MAP_H - 1 ? localConfluenceScore(x, y) : 0;
+      const confluence = x > 0 && y > 0 && x < MAP_W - 1 && y < MAP_H - 1 ? localConfluenceScore(x, y, river) : 0;
       const openPlainPotential = clamp(plain[i] * 0.68 + agriculture[i] * 0.54 + basinField[i] * 0.30 + lowSlope * 0.22 - river[i] * 0.18 - valleyField[i] * 0.08 - ridgeField[i] * 0.22 - slope[i] * 0.26);
       const spine = (arcSpineField?.[i] || 0) * 0.58 + (branchRidgeField?.[i] || 0) * 0.38;
       confluenceField[i] = confluence;
 
-      const geoH = fieldValue(geoHabitability, i, 0);
-      const geoLow = fieldValue(geoLowlandCapacity, i, 0);
-      const geoValley = fieldValue(geoValleyAccess, i, 0);
-      const geoCoast = fieldValue(geoCoastalAccess, i, 0);
-      const geoB = fieldValue(geoBarrier, i, naturalBarrier);
+      const geoH = finiteFieldValue(geoHabitability, i, 0);
+      const geoLow = finiteFieldValue(geoLowlandCapacity, i, 0);
+      const geoValley = finiteFieldValue(geoValleyAccess, i, 0);
+      const geoCoast = finiteFieldValue(geoCoastalAccess, i, 0);
+      const geoB = finiteFieldValue(geoBarrier, i, naturalBarrier);
       const localDevelopable = clamp(
         plain[i] * 0.34 +
         agriculture[i] * 0.24 +
@@ -139,7 +126,7 @@ export function buildFeatureContext(seed, terrain) {
         ridgeField[i] * 0.24 -
         spine * 0.12
       ) * 0.76 + geoCoast * 0.32 + geoH * 0.06 - geoB * 0.04);
-      const clusterNoise = 0.72 + fbm(x * 0.34 + 13, y * 0.34 - 31, seed + 7001) * 0.46 + valueNoise(x, y, seed + 7002, 8) * 0.16;
+      const clusterNoise = 0.72 + fbm(worldX(x) * 0.34 + 13, worldY(y) * 0.34 - 31, seed + 7001) * 0.46 + valueNoise(worldX(x), worldY(y), seed + 7002, 8) * 0.16;
       settlementCluster[i] = clamp((developable[i] * 0.42 + valleySettlement[i] * 0.12 + coastalSettlement[i] * 0.22 + agriculture[i] * 0.48 + plain[i] * 0.32 + openPlainPotential * 0.46) * clusterNoise);
       ruralSuitability[i] = clamp(
         agriculture[i] * 0.54 +
@@ -168,12 +155,12 @@ export function buildFeatureContext(seed, terrain) {
         ruralSuitability[i] * 0.48 +
         townSuitability[i] * 0.30 +
         confluence * 0.08 +
-        fieldValue(geoHabitability, i, developable[i]) * 0.18 +
-        fieldValue(geoNaturalCentrality, i, 0) * 0.12 -
-        fieldValue(geoBarrier, i, 0) * 0.06
+        finiteFieldValue(geoHabitability, i, developable[i]) * 0.18 +
+        finiteFieldValue(geoNaturalCentrality, i, 0) * 0.12 -
+        finiteFieldValue(geoBarrier, i, 0) * 0.06
       );
       barrierCost[i] = 1 + slope[i] * 6.4 + ridgeField[i] * 3.2 + spine * 2.2 + highPenalty * 5.8 + river[i] * 0.25 + naturalBarrier * 1.2 - valleyField[i] * 0.55 - plain[i] * 0.30 - coastalLowland[i] * 0.14;
-      corridorCost[i] = Math.max(0.25, barrierCost[i] - developable[i] * 0.42 - valleySettlement[i] * 0.36 - coastalSettlement[i] * 0.12 + hash2(x, y, seed + 7011) * 0.05);
+      corridorCost[i] = Math.max(0.25, barrierCost[i] - developable[i] * 0.42 - valleySettlement[i] * 0.36 - coastalSettlement[i] * 0.12 + hash2(worldX(x), worldY(y), seed + 7011) * 0.05);
     }
   }
 
@@ -213,18 +200,18 @@ export function buildFeatureContext(seed, terrain) {
       if (regionId < 0) continue;
       const st = ensureRegion(regionId);
       st.area++;
-      const gHabit = fieldValue(geoHabitability, i, developable[i]);
-      const gAccess = fieldValue(geoAccessibility, i, 0);
-      const gCentral = fieldValue(geoNaturalCentrality, i, townSuitability[i]);
-      const gLow = fieldValue(geoLowlandCapacity, i, plain[i]);
+      const gHabit = finiteFieldValue(geoHabitability, i, developable[i]);
+      const gAccess = finiteFieldValue(geoAccessibility, i, 0);
+      const gCentral = finiteFieldValue(geoNaturalCentrality, i, townSuitability[i]);
+      const gLow = finiteFieldValue(geoLowlandCapacity, i, plain[i]);
       st.developableSum += developable[i];
       st.habitabilitySum += gHabit;
       st.accessibilitySum += gAccess;
       st.centralitySum += gCentral;
       st.lowlandCapacitySum += gLow;
       if (developable[i] > 0.16 || gHabit > 0.24) st.developableCells++;
-      if (valleySettlement[i] > 0.24 || fieldValue(geoValleyAccess, i, 0) > 0.25) st.valleyCells++;
-      if (coastalSettlement[i] > 0.25 || fieldValue(geoCoastalAccess, i, 0) > 0.24) st.coastCells++;
+      if (valleySettlement[i] > 0.24 || finiteFieldValue(geoValleyAccess, i, 0) > 0.25) st.valleyCells++;
+      if (coastalSettlement[i] > 0.25 || finiteFieldValue(geoCoastalAccess, i, 0) > 0.24) st.coastCells++;
       if (townSuitability[i] > 0.28 || gCentral > 0.31) st.townCells++;
       if (plain[i] > 0.24 || gLow > 0.26) st.plainCells++;
       if (gCentral > 0.36 && gHabit > 0.18) st.highCentralityCells++;
@@ -260,7 +247,7 @@ export function buildFeatureContext(seed, terrain) {
         if (sea[i] || !predicate(x, y, i)) continue;
         const regionId = regionIdAt(x, y);
         if (regionId < 0) continue;
-        const score = scoreArray[i] + extraScore(x, y, i) + hash2(x, y, seed + seedOffset) * 0.055;
+        const score = scoreArray[i] + extraScore(x, y, i) + hash2(worldX(x), worldY(y), seed + seedOffset) * 0.055;
         if (score < threshold) continue;
         if (!byRegion.has(regionId)) byRegion.set(regionId, []);
         byRegion.get(regionId).push({ x, y, score, kind, regionId });
@@ -277,6 +264,8 @@ export function buildFeatureContext(seed, terrain) {
         threshold,
         seed: seed + seedOffset + regionId * 1009,
         jitter: 0.04,
+        originX: worldOriginX,
+        originY: worldOriginY,
       }));
     }
     return out.sort((a, b) => b.score - a.score).slice(0, totalMax);
@@ -288,11 +277,11 @@ export function buildFeatureContext(seed, terrain) {
       for (let x = 2; x < MAP_W - 2; x += stride) {
         const i = indexOf(x, y);
         if (sea[i] || !predicate(x, y, i)) continue;
-        const score = scoreArray[i] + hash2(x, y, seed + seedOffset) * 0.07;
+        const score = scoreArray[i] + hash2(worldX(x), worldY(y), seed + seedOffset) * 0.07;
         if (score >= threshold) candidates.push({ x, y, score, regionId: regionIdAt(x, y) });
       }
     }
-    return pickEntities(candidates, { max, minDistance, threshold, seed: seed + seedOffset });
+    return pickEntities(candidates, { max, minDistance, threshold, seed: seed + seedOffset, originX: worldOriginX, originY: worldOriginY });
   }
 
 
@@ -306,7 +295,7 @@ export function buildFeatureContext(seed, terrain) {
     geoCoastalAccess,
     geoBarrier,
     geoCorridorSuitability,
-    fieldValue,
+    fieldValue: finiteFieldValue,
     regionIdAt,
     inFocusedPrefecture,
     developable,
diff --git a/mapFeatureLanduse.js b/src/mapFeatureLanduse.js
similarity index 97%
rename from mapFeatureLanduse.js
rename to src/mapFeatureLanduse.js
index 42b346d..e4af51a 100644
--- a/mapFeatureLanduse.js
+++ b/src/mapFeatureLanduse.js
@@ -9,6 +9,7 @@ export function buildFeatureLanduse(ctx) {
     modernCities, logisticsParks,
     roadLanduseInfluence, roadInfluence, roadDensityInfluence, railInfluence2, stationInfluence, stationDensityInfluence, villageInfluence,
     cityInfluence, coreInfluence, oldTownInfluence, townInfluence, industrialInfluence, logisticsInfluence,
+    originX = 0, originY = 0,
   } = ctx;
   const populationDensity = new Float32Array(SIZE);
 
@@ -102,7 +103,7 @@ export function buildFeatureLanduse(ctx) {
 
         const suburbanity = urban * 0.88 + transport * 0.23 + stationInfluence[i] * 0.12 + townInfluence[i] * 0.08 + riverUrban * 0.08;
         const edgeTaper = clamp(cityInfluence[i] * 0.52 + stationInfluence[i] * 0.16 + roadLanduseInfluence[i] * 0.10 + 0.28);
-        const sprawlBias = clamp(0.58 + hash2(x, y, baseNoiseSeed) * 0.42);
+        const sprawlBias = clamp(0.58 + hash2(x + originX, y + originY, baseNoiseSeed) * 0.42);
         const sprawlScore = suburbanity * sprawlBias * edgeTaper - core * 0.12;
         if (sprawlScore > 0.24 && urbanCapacity[i] > 0.10) {
           landuse[i] = LANDUSE.SUBURB;
@@ -140,7 +141,7 @@ export function buildFeatureLanduse(ctx) {
         }
         if ((baseLanduse[i] === LANDUSE.FARMLAND || baseLanduse[i] === LANDUSE.RURAL) && urbanCapacity[i] > 0.10) {
           const fringeChance = urbanNeighbors * 0.055 + cityInfluence[i] * 0.13 + transport * 0.12 + stationInfluence[i] * 0.08;
-          const noise = 0.23 + hash2(x, y, seed + 15050) * 0.24;
+          const noise = 0.23 + hash2(x + originX, y + originY, seed + 15050) * 0.24;
           if (fringeChance > 0.34 + noise) {
             landuse[i] = LANDUSE.SUBURB;
           }
diff --git a/mapFeatureSettlements.js b/src/mapFeatureSettlements.js
similarity index 100%
rename from mapFeatureSettlements.js
rename to src/mapFeatureSettlements.js
diff --git a/mapFeatureTransportTools.js b/src/mapFeatureTransportTools.js
similarity index 96%
rename from mapFeatureTransportTools.js
rename to src/mapFeatureTransportTools.js
index 2d4cb92..2cdebbf 100644
--- a/mapFeatureTransportTools.js
+++ b/src/mapFeatureTransportTools.js
@@ -8,6 +8,7 @@ export function buildFeatureTransportCostFields(ctx) {
     settlementDemand, urbanEdge, logisticsPreSuitability,
     preliminaryTownInfluence, preliminaryVillageInfluence,
     valleySettlement, coastalSettlement, developable,
+    originX = 0, originY = 0,
   } = ctx;
     const expressway = new Float32Array(SIZE);
     const rail = new Float32Array(SIZE);
@@ -139,7 +140,7 @@ export function buildFeatureTransportCostFields(ctx) {
           seaNear * 2.35 +
           seaWide * 1.10 +
           openPlainParallelPenalty * 0.12 +
-          hash2(x, y, seed + 13301) * 0.04
+          hash2(x + originX, y + originY, seed + 13301) * 0.04
         );
         rail[i] = Math.max(0.16,
           1.48 - railPotential[i] * 1.02 +
@@ -151,7 +152,7 @@ export function buildFeatureTransportCostFields(ctx) {
           coastalTraversePenalty * 1.75 +
           seaNear * 1.50 +
           seaWide * 0.70 +
-          hash2(x, y, seed + 13302) * 0.03
+          hash2(x + originX, y + originY, seed + 13302) * 0.03
         );
         national[i] = Math.max(0.16,
           1.28 - nationalPotential[i] * 0.84 +
@@ -167,7 +168,7 @@ export function buildFeatureTransportCostFields(ctx) {
           seaNear * 0.84 +
           seaWide * 0.48 -
           pass * 0.42 +
-          hash2(x, y, seed + 13303) * 0.05
+          hash2(x + originX, y + originY, seed + 13303) * 0.05
         );
         local[i] = Math.max(0.14,
           1.12 - localPotential[i] * 0.86 +
@@ -182,7 +183,7 @@ export function buildFeatureTransportCostFields(ctx) {
           coastalTraversePenalty * 0.82 +
           seaNear * 0.48 +
           seaWide * 0.26 +
-          hash2(x, y, seed + 13304) * 0.07
+          hash2(x + originX, y + originY, seed + 13304) * 0.07
         );
       }
     }
diff --git a/mapFeatures.js b/src/mapFeatures.js
similarity index 90%
rename from mapFeatures.js
rename to src/mapFeatures.js
index 9ffaada..7983861 100644
--- a/mapFeatures.js
+++ b/src/mapFeatures.js
@@ -1,12 +1,13 @@
-import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, hash2, indexOf, inside, pickEntities, rand, valueNoise, xyOf } from "./mapUtils.js";
-import { createPointSpatialIndex, distanceToNearest, influenceFromPaths, influenceFromPoints, samplePath } from "./mapGeneratorHelpers.js";
-import { buildDensityFlowRoadTransportSystem, createPathInfluenceCache, packDebugField, pathAverageField, pathLengthCells, routeQualityAcceptable } from "./mapTransport.js";
+import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, distanceToNearestPoint, hash2, indexOf, inside, pickEntities, rand, valueNoise, xyOf, nowMs } from "./mapUtils.js";
+import { createPointSpatialIndex, influenceFromPaths, influenceFromPoints, samplePath } from "./mapGeneratorHelpers.js";
+import { buildDensityFlowRoadTransportSystem, createPathInfluenceCache, pathAverageField, pathLengthCells, routeQualityAcceptable } from "./mapTransport.js";
 import { buildUnifiedRailODNetwork } from "./mapTransportOD.js";
 import { buildFeatureContext } from "./mapFeatureContext.js";
 import { buildFeatureLanduse } from "./mapFeatureLanduse.js";
 import { buildSettlementDemandFields } from "./mapFeatureSettlements.js";
 import { buildFeatureTransportCostFields } from "./mapFeatureTransportTools.js";
 import { buildCoarseCostGraph, refineCoarsePath, routeCoarsePath } from "./mapTransportGraph.js";
+import { labelOccupancyComponents, normalizeTransportPathSet, smoothRasterPath } from "./mapTransportUtils.js";
 
 // Lightweight Human Geography V2
 // --------------------------------
@@ -17,15 +18,23 @@ import { buildCoarseCostGraph, refineCoarsePath, routeCoarsePath } from "./mapTr
 //   3. make sparse approximate transport paths without full-resolution A*
 //   4. synthesize population and land-use fields in one raster pass
 
-export function generateMapFeatures(seed, terrain) {
+export function generateMapFeatures(seed, terrain, options = {}) {
   const SPEED_TOLERANCE = 0.90;
+  const worldOriginX = Math.floor(Number(options?.generationContext?.originX ?? terrain?.generationContext?.originX ?? terrain?.originX ?? 0));
+  const worldOriginY = Math.floor(Number(options?.generationContext?.originY ?? terrain?.generationContext?.originY ?? terrain?.originY ?? 0));
+  const worldX = (x) => worldOriginX + x;
+  const worldY = (y) => worldOriginY + y;
+  const patchMode = options?.patchMode === true || options?.generationContext?.hasBoundaryWorld === true;
+  const largePatchTile = options?.largeExpansionTile === true;
+  const topCenterSuppression = clamp(Number.isFinite(options?.topCenterSuppression) ? options.topCenterSuppression : (patchMode ? 0.68 : 0), 0, 0.95);
   const featureTimings = [];
-  const nowMs = () => typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
   let timingMark = nowMs();
   function markFeatureTiming(key) {
     const t = nowMs();
-    featureTimings.push({ key, ms: Math.round((t - timingMark) * 10) / 10 });
+    const entry = { key, ms: Math.round((t - timingMark) * 10) / 10 };
+    featureTimings.push(entry);
     timingMark = t;
+    options?.onProgress?.({ status: "feature-step", key: `feature:${key}`, label: `Feature stage: ${key}`, featureTiming: entry });
   }
 
   const {
@@ -95,6 +104,7 @@ export function generateMapFeatures(seed, terrain) {
     ports[0].portClass = "major";
     ports[0].kind = "Major Port";
   }
+  markFeatureTiming("ports");
   const commercialPorts = ports.filter((p) => p.portClass === "major" || p.portClass === "regional");
   const portIndex = createPointSpatialIndex(ports, 12);
   const commercialPortIndex = createPointSpatialIndex(commercialPorts, 12);
@@ -107,6 +117,7 @@ export function generateMapFeatures(seed, terrain) {
     predicate: (x, y, i) => river[i] > 0.12 || confluenceField[i] > 0.09,
   }).map((p) => ({ ...p, kind: "River Crossing" }));
   const crossingIndex = createPointSpatialIndex(crossings, 8);
+  markFeatureTiming("crossings");
 
   const passes = pickGlobalPoints(passSuitability || valleySettlement, {
     threshold: 0.18 + rand(seed, 1021) * 0.06,
@@ -120,6 +131,7 @@ export function generateMapFeatures(seed, terrain) {
   // from the unified geography fields before lower-tier villages and market
   // towns are placed.  These anchors are not rendered as separate settlements;
   // they guide city selection and lower-tier spacing.
+  markFeatureTiming("passes");
   const geographicUrbanAnchorScore = new Float32Array(SIZE);
   for (let i = 0; i < SIZE; i++) {
     if (sea[i]) continue;
@@ -164,6 +176,7 @@ export function generateMapFeatures(seed, terrain) {
     extraScore: (x, y, i) => fieldValue(geoNaturalCentrality, i, 0) * 0.18 + fieldValue(geoAccessibility, i, 0) * 0.10,
   }).map((p) => ({ ...p, candidateKind: "geographicAnchor", anchorScore: p.score }));
   const geographicAnchorInfluence = influenceFromPoints(geographicUrbanAnchors, 20, (p) => clamp((p.anchorScore || p.score || 0.4) * 1.35, 0.45, 1.35));
+  markFeatureTiming("urban-anchors");
 
   const villageScore = new Float32Array(SIZE);
   for (let i = 0; i < SIZE; i++) {
@@ -206,6 +219,8 @@ export function generateMapFeatures(seed, terrain) {
     return { ...p, kind, population };
   });
 
+  markFeatureTiming("base-villages");
+
   // Supplemental open-plain villages: broad Japanese-style farmland should not be empty
   // just because it lacks a river/confluence anchor.
   const openPlainVillageScore = new Float32Array(SIZE);
@@ -239,6 +254,7 @@ export function generateMapFeatures(seed, terrain) {
       return { ...p, kind: "Plain Village", population };
     });
   villages = [...villages, ...supplementalPlainVillages];
+  markFeatureTiming("supplemental-villages");
 
   let villageInfluence = influenceFromPoints(villages, 6, (v) => clamp((v.population || 1800) / 4200, 0.35, 1.2));
 
@@ -279,6 +295,7 @@ export function generateMapFeatures(seed, terrain) {
     }
   }
 
+  markFeatureTiming("market-score");
   let markets = pickRegionalPoints(marketScore, {
     stride: 2,
     threshold: 0.245 + rand(seed, 1041) * 0.035,
@@ -302,6 +319,8 @@ export function generateMapFeatures(seed, terrain) {
     return { ...p, kind, population };
   });
 
+  markFeatureTiming("base-markets");
+
   const openPlainMarketScore = new Float32Array(SIZE);
   for (let i = 0; i < SIZE; i++) {
     if (sea[i]) continue;
@@ -334,6 +353,7 @@ export function generateMapFeatures(seed, terrain) {
       return { ...p, kind: "Plain Market Town", population };
     });
   markets = [...markets, ...supplementalPlainMarkets];
+  markFeatureTiming("supplemental-markets");
   let marketIndex = createPointSpatialIndex(markets, 12);
   let villageIndex = createPointSpatialIndex(villages, 8);
 
@@ -342,6 +362,7 @@ export function generateMapFeatures(seed, terrain) {
   // empty while still keeping minimum spacing from existing settlements.
   const existingTownInfluenceForSparseFill = influenceFromPoints([...markets, ...commercialPorts], 18, (p) => clamp((p.population || 9000) / 32000, 0.35, 1.25));
   const existingSettlementInfluenceForSparseFill = influenceFromPoints([...markets, ...villages, ...ports], 12, (p) => clamp((p.population || 1800) / 16000, 0.18, 1.0));
+  markFeatureTiming("sparse-influence");
   const sparseTownScore = new Float32Array(SIZE);
   for (let i = 0; i < SIZE; i++) {
     if (sea[i]) continue;
@@ -378,6 +399,7 @@ export function generateMapFeatures(seed, terrain) {
       return { ...p, kind: "Sparse Market Town", population };
     });
   markets = [...markets, ...sparseMarkets];
+  markFeatureTiming("sparse-markets");
   marketIndex = createPointSpatialIndex(markets, 12);
 
   const defenseScore = new Float32Array(SIZE);
@@ -402,6 +424,8 @@ export function generateMapFeatures(seed, terrain) {
     kind: elevation[indexOf(p.x, p.y)] > 0.55 ? "Mountain Castle" : elevation[indexOf(p.x, p.y)] > 0.38 ? "Hilltop Castle" : "Flatland Castle",
   }));
 
+  markFeatureTiming("castles");
+
   const castleTowns = castles.map((c, n) => {
     const near = markets.slice().sort((a, b) => Math.hypot(a.x - c.x, a.y - c.y) - Math.hypot(b.x - c.x, b.y - c.y))[0];
     const x = near && Math.hypot(near.x - c.x, near.y - c.y) < 10 ? near.x : c.x;
@@ -443,6 +467,7 @@ export function generateMapFeatures(seed, terrain) {
     ...crossings.filter((p) => confluenceField[indexOf(p.x, p.y)] > 0.12).map((p) => ({ ...p, candidateKind: "crossing" })),
   ];
 
+  markFeatureTiming("urban-candidate-list");
   const cityCandidateByRegion = new Map();
   for (const p of urbanCandidates) {
     const i = indexOf(p.x, p.y);
@@ -463,11 +488,13 @@ export function generateMapFeatures(seed, terrain) {
       (p.candidateKind === "port" ? 0.48 : 0) +
       (p.candidateKind === "castleTown" ? 0.22 : 0) -
       fieldValue(geoBarrier, i, 0) * 0.36 +
-      hash2(p.x, p.y, seed + 12000) * 0.16;
+      hash2(worldX(p.x), worldY(p.y), seed + 12000) * 0.16;
     if (!cityCandidateByRegion.has(regionId)) cityCandidateByRegion.set(regionId, []);
     cityCandidateByRegion.get(regionId).push({ ...p, score, capacity, regionId });
   }
 
+  markFeatureTiming("urban-capacity-scan");
+
   const modernCities = [];
   const usedCitySites = [];
   for (const [regionId, list] of [...cityCandidateByRegion.entries()].sort((a, b) => a[0] - b[0])) {
@@ -501,8 +528,13 @@ export function generateMapFeatures(seed, terrain) {
   // selection rules, so the highlighted region is not overwritten after the
   // regional pass.
 
+  markFeatureTiming("urban-selection");
   modernCities.sort((a, b) => b.capacity - a.capacity || b.score - a.score);
-  const regionalCapitalSlots = Math.max(1, Math.min(2, Math.floor(Math.sqrt(Math.max(1, modernCities.length)) / 2)));
+  const baseRegionalCapitalSlots = Math.max(1, Math.min(2, Math.floor(Math.sqrt(Math.max(1, modernCities.length)) / 2)));
+  const regionalCapitalSlots = patchMode
+    ? Math.max(0, Math.min(1, Math.round(baseRegionalCapitalSlots * (1 - topCenterSuppression))))
+    : baseRegionalCapitalSlots;
+  const topCenterGeoThreshold = 0.80 + topCenterSuppression * 0.16;
   for (const [rank, city] of modernCities.entries()) {
     const i = indexOf(city.x, city.y);
     const st = regionStats.get(city.regionId);
@@ -514,27 +546,33 @@ export function generateMapFeatures(seed, terrain) {
       fieldValue(geoAccessibility, i, 0) * 0.18 +
       Math.log10((city.capacity || 26000) + 1) / 7 * 0.26
     );
-    const isTopCenter = rank < regionalCapitalSlots || geoTierScore > 0.8;
-    const isRegionalCapital = isFirstInRegion && (isTopCenter || (city.capacity || 0) > 210000 || (st?.highCentralityCells || 0) > 220);
+    const slotTopCenter = regionalCapitalSlots > 0 && rank < regionalCapitalSlots;
+    const exceptionalPatchCenter = patchMode && geoTierScore > topCenterGeoThreshold && (city.capacity || 0) > 360000;
+    const isTopCenter = (!patchMode && slotTopCenter) || exceptionalPatchCenter || (!patchMode && geoTierScore > topCenterGeoThreshold);
+    const regionalCapacityThreshold = patchMode ? 300000 : 210000;
+    const regionalCentralityThreshold = patchMode ? 340 : 220;
+    const isRegionalCapital = isFirstInRegion && (isTopCenter || (city.capacity || 0) > regionalCapacityThreshold || (st?.highCentralityCells || 0) > regionalCentralityThreshold);
 const u = rand(st.seed, city.x, city.y, 9101);
 const v = rand(st.seed, city.x, city.y, 9102);
-const w = rand(st.seed, city.x, city.y, 9103);
 
 let rawPop;
 
 if (isRegionalCapital) {
   if (isTopCenter) {
-    // largest 3M - 11M
+    // largest 3M - 11M in full generation; patch candidates are suppressed
+    // unless they are exceptionally strong geographic centers.
     rawPop =
       3000000 +
       Math.pow(u, 0.42) * 5200000 +
       Math.pow(v, 3.2) * 2800000;
+    if (patchMode) rawPop *= (0.42 + (1 - topCenterSuppression) * 0.28);
   } else {
     // larger 0.25M - 2.5M
     rawPop =
       250000 +
       Math.pow(u, 0.55) * 1450000 +
       Math.pow(v, 2.4) * 900000;
+    if (patchMode) rawPop *= 0.72;
   }
 } else {
   // normal 5k - 0.75k
@@ -543,9 +581,9 @@ if (isRegionalCapital) {
     Math.pow(u, 0.72) * 520000 +
     Math.pow(v, 3.0) * 320000;
 }
-    const capMultiplier = isRegionalCapital ? (isTopCenter ? 1.66 : 1.42) : 1.20;
+    const capMultiplier = isRegionalCapital ? (isTopCenter ? (patchMode ? 1.22 : 1.66) : (patchMode ? 1.08 : 1.42)) : 1.20;
     const population = Math.round(Math.min(rawPop, city.capacity * capMultiplier) / 1000) * 1000;
-    const floor = isRegionalCapital ? (isTopCenter ? 210000 : 120000) : 42000;
+    const floor = isRegionalCapital ? (isTopCenter ? (patchMode ? 150000 : 210000) : (patchMode ? 90000 : 120000)) : 42000;
     city.population = Math.max(floor, population);
     city.isPrefecturalCapital = isPrefecturalCapital;
     city.isRegionalCapital = isRegionalCapital;
@@ -623,6 +661,7 @@ if (isRegionalCapital) {
     settlementDemand, urbanEdge, logisticsPreSuitability,
     preliminaryTownInfluence, preliminaryVillageInfluence,
     valleySettlement, coastalSettlement, developable,
+    originX: worldOriginX, originY: worldOriginY,
   });
   markFeatureTiming("transport-cost-fields");
   const cachedInfluenceFromPaths = createPathInfluenceCache(influenceFromPaths);
@@ -664,19 +703,6 @@ if (isRegionalCapital) {
     ) * 255);
   }
 
-  function chooseCorridorSeeds(potentialField, spacing, maxCount, threshold, predicate = () => true, seedOffset = 0, mode = "national") {
-    const candidates = [];
-    for (let y = 3; y < MAP_H - 3; y += 2) {
-      for (let x = 3; x < MAP_W - 3; x += 2) {
-        const i = indexOf(x, y);
-        if (sea[i] || !predicate(x, y, i)) continue;
-        const skeletonWeight = mode === "rail" ? 0.24 : mode === "expressway" ? 0.18 : 0.28;
-        const score = potentialField[i] + (corridorSkeleton[i] / 255) * skeletonWeight + hash2(x, y, seed + seedOffset) * 0.055;
-        if (score >= threshold) candidates.push({ x, y, score, regionId: regionIdAt(x, y) });
-      }
-    }
-    return pickEntities(candidates, { max: maxCount, minDistance: spacing, threshold, seed: seed + seedOffset, jitter: 0.03 });
-  }
 
   function corridorAllowance(i) {
     return clamp(settlementDemand[i] * 0.58 + valleyField[i] * 0.42 + coastalLowland[i] * 0.36 - plain[i] * 0.18 - agriculture[i] * 0.14);
@@ -906,10 +932,6 @@ if (isRegionalCapital) {
     return dense.length >= 2 ? dense : path;
   }
 
-  function endpointFromPath(path) {
-    const p = path?.[path.length - 1];
-    return p ? { x: p[0], y: p[1], regionId: regionIdAt(p[0], p[1]) } : null;
-  }
 
   function qualityLimitsForMode(mode, overrides = {}) {
     const base = mode === "rail"
@@ -1017,35 +1039,6 @@ if (isRegionalCapital) {
     }, qualityLimitsForMode(mode, overrides));
   }
 
-  function generateCorridorsFromField({ mode = "national", potentialField, costField, spacing, maxCount, threshold, minLength, penaltyRadius, penaltyStrength, curvePenalty, terrainFlowBias = 0, surfaceGrain = 0, relaxRadius = 2, relaxLineWeight = 0.40, seedOffset, startPredicate, goalPredicate }) {
-    const paths = [];
-    const penaltyField = new Float32Array(SIZE);
-    const seeds = chooseCorridorSeeds(potentialField, spacing, maxCount * 2, threshold, startPredicate, seedOffset, mode);
-    const usedEndpoints = [];
-    for (const start of seeds) {
-      if (paths.length >= maxCount) break;
-      if (distanceToNearest(usedEndpoints, start.x, start.y) < spacing * 0.55) continue;
-      let path = traceCorridorByCost(
-        start,
-        (x, y, i) => goalPredicate(start, x, y, i, usedEndpoints),
-        costField,
-        penaltyField,
-        { curvePenalty, penaltyStrength: penaltyStrength * 2.2, minGoalDistance: minLength, regionId: start.regionId, terrainFlowBias, surfaceGrain }
-      );
-      if (path.length < minLength) continue;
-      const rawPath = path;
-      path = relaxRouteToTerrain(rawPath, costField, { radius: relaxRadius, lineWeight: relaxLineWeight, grain: surfaceGrain, iterations: 1 });
-      if (path.length < Math.max(2, rawPath.length * 0.55)) path = rawPath;
-      if (!transportRouteAcceptable(path, mode, potentialField, penaltyField, { minLength, maxLength: mode === "expressway" ? 130 : mode === "rail" ? 112 : 150 })) continue;
-      paths.push(path);
-      usedEndpoints.push(start);
-      const end = endpointFromPath(path);
-      if (end) usedEndpoints.push(end);
-      addCorridorInfluencePenalty(penaltyField, path, penaltyRadius, penaltyStrength);
-    }
-    return paths;
-  }
-
   function rasterizeNetworkComponents(paths, mode, potentialField) {
     const occupied = new Uint8Array(SIZE);
     for (const path of paths) {
@@ -1053,37 +1046,22 @@ if (isRegionalCapital) {
         if (inside(x, y) && !sea[indexOf(x, y)]) occupied[indexOf(x, y)] = 1;
       }
     }
-    const componentId = new Int32Array(SIZE);
-    componentId.fill(-1);
+    const { labels: componentId, components: rawComponents } = labelOccupancyComponents(occupied, { maxDistanceSq: 2 });
     const components = [];
-    for (let i = 0; i < SIZE; i++) {
-      if (!occupied[i] || componentId[i] >= 0) continue;
-      const id = components.length;
-      const queue = [i];
-      const cells = [];
+    for (const raw of rawComponents) {
+      const id = raw.id;
+      const cells = raw.cells;
       const boundary = [];
-      componentId[i] = id;
-      for (let q = 0; q < queue.length; q++) {
-        const cur = queue[q];
-        cells.push(cur);
+      for (const cur of cells) {
         const x = cur % MAP_W;
         const y = Math.floor(cur / MAP_W);
         let edge = false;
-        for (let dy = -1; dy <= 1; dy++) {
+        for (let dy = -1; dy <= 1 && !edge; dy++) {
           for (let dx = -1; dx <= 1; dx++) {
             if (!dx && !dy) continue;
             const nx = x + dx;
             const ny = y + dy;
-            if (!inside(nx, ny)) { edge = true; continue; }
-            const ni = indexOf(nx, ny);
-            if (!occupied[ni]) {
-              edge = true;
-              continue;
-            }
-            if (componentId[ni] < 0) {
-              componentId[ni] = id;
-              queue.push(ni);
-            }
+            if (!inside(nx, ny) || !occupied[indexOf(nx, ny)]) { edge = true; break; }
           }
         }
         if (edge) boundary.push({ x, y, i: cur });
@@ -1138,9 +1116,9 @@ if (isRegionalCapital) {
     for (let k = 0; k < component.boundary.length; k += stride) {
       const p = component.boundary[k];
       if (costField[p.i] >= INF) continue;
-      if (distanceToNearest(usedAnchors, p.x, p.y) < 8) continue;
+      if (distanceToNearestPoint(usedAnchors, p.x, p.y) < 8) continue;
       const d = target ? Math.hypot(p.x - target.x, p.y - target.y) : 0;
-      const score = d + costField[p.i] * 3.5 - corridorAllowance(p.i) * 2.4 + hash2(p.x, p.y, seed + 13701) * 1.8;
+      const score = d + costField[p.i] * 3.5 - corridorAllowance(p.i) * 2.4 + hash2(worldX(p.x), worldY(p.y), seed + 13701) * 1.8;
       if (score < bestScore) {
         bestScore = score;
         best = { x: p.x, y: p.y, componentId: component.id, regionId: regionIdAt(p.x, p.y) };
@@ -1556,7 +1534,7 @@ if (isRegionalCapital) {
         if (mode === "national") score += preliminaryVillageInfluence[i] * 0.24 + crossingSuitability[i] * 0.20;
         score -= ridgeField[i] * (mode === "expressway" ? 0.50 : mode === "rail" ? 0.65 : 0.30);
         score -= Math.max(0, elevation[i] - 0.62) * (mode === "expressway" ? 1.4 : mode === "rail" ? 1.7 : 0.85);
-        score += hash2(x, y, seed + 17100 + (mode === "rail" ? 17 : mode === "expressway" ? 31 : 0)) * 0.055;
+        score += hash2(worldX(x), worldY(y), seed + 17100 + (mode === "rail" ? 17 : mode === "expressway" ? 31 : 0)) * 0.055;
         if (score > (mode === "expressway" ? 0.64 : mode === "rail" ? 0.58 : 0.52)) candidates.push({ x, y, score, regionId: regionIdAt(x, y), role: "preference-cell" });
       }
     }
@@ -1939,7 +1917,7 @@ const premodernRoads = [];
   markFeatureTiming("rail-od");
 
 
-  const { transportDebugLayers, runLocalAccessPass, stitchRasterNearContacts, stitchLongLocalBranches, sanitizeLocalRoads, downgradeShortNationalRoads, connectAllRoadNetworksFinal } = buildDensityFlowRoadTransportSystem({
+  const { transportDebugLayers, runLocalAccessPass, stitchDisconnectedRoadGaps, downgradeShortNationalRoads, connectPreAdminRoadComponents } = buildDensityFlowRoadTransportSystem({
     seed,
     sea, elevation, slope, ridgeField, valleyField, coastalLowland, naturalBarrierScore,
     agriculture, basinField, plain, passSuitability, crossingSuitability,
@@ -1953,6 +1931,9 @@ const premodernRoads = [];
     routeBetweenTrafficCandidates, traceCorridorByCost, addCorridorInfluencePenalty,
     relaxRouteToTerrain, transportRouteAcceptable, repairTransportConnectivity,
     repairDanglingTransportEndpoints, pruneDanglingTerminalSegments, pruneParallelSameMode,
+    onProgress: options?.onProgress,
+    patchMode,
+    largePatchTile,
   });
   markFeatureTiming("road-system");
 
@@ -2000,7 +1981,7 @@ const premodernRoads = [];
       if (sea[i] || !shouldPlaceRailStation(x, y, i)) continue;
       const interval = stationIntervalForCell(i);
       if (lastStation && Math.hypot(x - lastStation.x, y - lastStation.y) < interval) continue;
-      if (distanceToNearest(stations, x, y) < Math.max(4.5, interval * 0.38)) continue;
+      if (distanceToNearestPoint(stations, x, y) < Math.max(4.5, interval * 0.38)) continue;
       if (addStation(x, y, "Station", 0.8)) lastStation = { x, y };
     }
   }
@@ -2015,9 +1996,9 @@ const premodernRoads = [];
 
   function addKernel(grid, p, radius, weight, exponent = 1.7, terrainWeighted = true, combine = "max") {
     const r = Math.ceil(radius);
-    const angle = hash2(p.x, p.y, seed + 14901) * Math.PI * 2;
-    const stretch = 1.35 + hash2(p.x, p.y, seed + 14902) * 0.85;
-    const squeeze = 0.62 + hash2(p.x, p.y, seed + 14903) * 0.28;
+    const angle = hash2(worldX(p.x), worldY(p.y), seed + 14901) * Math.PI * 2;
+    const stretch = 1.35 + hash2(worldX(p.x), worldY(p.y), seed + 14902) * 0.85;
+    const squeeze = 0.62 + hash2(worldX(p.x), worldY(p.y), seed + 14903) * 0.28;
     const ca = Math.cos(angle);
     const sa = Math.sin(angle);
     for (let dy = -r; dy <= r; dy++) {
@@ -2045,7 +2026,7 @@ const premodernRoads = [];
           Math.max(0, elevation[i] - 0.58) * 0.82 +
           (river[i] > 0.68 ? 0.60 : river[i] > 0.34 ? 0.22 : 0)
         );
-        const noise = 0.78 + hash2(x, y, seed + 14910 + Math.round((p.population || 0) / 1000)) * 0.46;
+        const noise = 0.78 + hash2(worldX(x), worldY(y), seed + 14910 + Math.round((p.population || 0) / 1000)) * 0.46;
         const d = baseD * (1.10 - conduit * 0.42 + barrier * 0.62) * noise;
         if (d > radius) continue;
         const terrain = terrainWeighted ? clamp(0.06 + developable[i] * 1.08 + valleySettlement[i] * 0.24 + coastalSettlement[i] * 0.14 + conduit * 0.38 - barrier * 0.70, 0, 1.42) : 1;
@@ -2077,7 +2058,7 @@ const premodernRoads = [];
         if (sea[i]) continue;
         const d = Math.hypot(dx, dy);
         if (d < 3 || d > 10) continue;
-        const score = coastalLowland[i] * 0.22 + developable[i] * 0.22 + roadInfluence[i] * 0.20 + plain[i] * 0.12 - slope[i] * 0.25 + hash2(x, y, seed + 14000) * 0.06;
+        const score = coastalLowland[i] * 0.22 + developable[i] * 0.22 + roadInfluence[i] * 0.20 + plain[i] * 0.12 - slope[i] * 0.25 + hash2(worldX(x), worldY(y), seed + 14000) * 0.06;
         if (score > 0.22) candidates.push({ x, y, score, kind: "Industrial Zone", regionId: regionIdAt(x, y) });
       }
     }
@@ -2166,68 +2147,20 @@ const premodernRoads = [];
       targetPredicate: (x, y, i) => roadInfluenceNow[i] > 0.18 || localPenalty[i] > 0.07,
     });
   }
-  addFinalLocalAccessForUnservedSettlements();
-  addRuralRoadMeshConnectors();
-  transportDebugLayers.contactStitches = stitchRasterNearContacts();
-  transportDebugLayers.longLocalStitches = stitchLongLocalBranches();
-  transportDebugLayers.shortNationalDowngradeFinal = downgradeShortNationalRoads(18, 10);
-  transportDebugLayers.localSanitizationFinal = sanitizeLocalRoads();
-  transportDebugLayers.contactStitchesAfterConnectivity = stitchRasterNearContacts();
-  // Keep this as the final road topology operation.  Later sanitization can cut
-  // the short connectors that intentionally merge isolated components.
-  transportDebugLayers.finalRoadNetworkConnectivity = connectAllRoadNetworksFinal(46);
-  markFeatureTiming("local-road-cleanup");
+  if (!patchMode) {
+    addFinalLocalAccessForUnservedSettlements();
+    addRuralRoadMeshConnectors();
+  }
+  // Final road topology is now consolidated below after class cleanup and
+  // coverage guarantees.  Do not repeatedly stitch/sanitize here: those passes
+  // used to create hundreds of temporary connectors that were immediately
+  // deduplicated or pruned again.
 
   function dedupeTransportPathSet(paths, options = {}) {
-    const before = paths.length;
-    const minLength = options.minLength ?? 0;
-    const minPoints = options.minPoints ?? 2;
-    const sampleStep = Math.max(1, options.sampleStep ?? 1);
-    const seen = new Set();
-    const kept = [];
-    let removedDuplicates = 0;
-    let removedTooShort = 0;
-    for (const path of paths) {
-      if (!path || path.length < minPoints) { removedTooShort++; continue; }
-      const cleaned = [];
-      for (const pt of path) {
-        if (!pt || pt.length < 2) continue;
-        const x = Math.round(pt[0]);
-        const y = Math.round(pt[1]);
-        if (!cleaned.length || cleaned[cleaned.length - 1][0] !== x || cleaned[cleaned.length - 1][1] !== y) cleaned.push([x, y]);
-      }
-      if (cleaned.length < minPoints || pathLengthCells(cleaned) < minLength) { removedTooShort++; continue; }
-      const sample = (candidate) => candidate
-        .map((pt, idx) => (idx % sampleStep === 0 || idx === candidate.length - 1) ? `${pt[0]},${pt[1]}` : '')
-        .filter(Boolean)
-        .join('|');
-      const forward = sample(cleaned);
-      const backward = sample([...cleaned].reverse());
-      const sig = forward < backward ? forward : backward;
-      if (seen.has(sig)) { removedDuplicates++; continue; }
-      seen.add(sig);
-      kept.push(cleaned);
-    }
-    paths.length = 0;
-    paths.push(...kept);
-    return { before, after: kept.length, removedDuplicates, removedTooShort };
+    const { paths: _normalized, ...stats } = normalizeTransportPathSet(paths, { ...options, mutate: true });
+    return stats;
   }
 
-  function pruneTransportPathSet(paths, minLength = 0, minKeep = 0) {
-    const ranked = (paths || [])
-      .map((path) => ({ path, len: pathLengthCells(path) }))
-      .filter((row) => row.path?.length >= 2)
-      .sort((a, b) => b.len - a.len);
-    const kept = [];
-    let pruned = 0;
-    for (const row of ranked) {
-      if (row.len >= minLength || kept.length < minKeep) kept.push(row.path);
-      else pruned++;
-    }
-    paths.length = 0;
-    paths.push(...kept);
-    return { before: ranked.length, after: kept.length, pruned, minLength, minKeep };
-  }
 
   function downgradeBranchNationalSpurs(maxLength = 30, importantRadius = 6.5, junctionRadius = 2.6) {
     const importantNodes = [
@@ -2271,50 +2204,24 @@ const premodernRoads = [];
     return { threshold: maxLength, downgraded: downgraded.length, kept: kept.length };
   }
 
-  transportDebugLayers.postConnectivityDedup = {
-    national: dedupeTransportPathSet(nationalRoads, { minLength: 0.95, sampleStep: 1 }),
-    externalRoads: dedupeTransportPathSet(externalRoads, { minLength: 1.5, sampleStep: 1 }),
-    minor: dedupeTransportPathSet(minorRoads, { minLength: 0.95, sampleStep: 2 }),
-    expressways: dedupeTransportPathSet(expressways, { minLength: 4, sampleStep: 2 }),
-    externalExpressways: dedupeTransportPathSet(externalExpressways, { minLength: 4, sampleStep: 2 }),
-  };
-  transportDebugLayers.postConnectivityShortNationalDowngrade = downgradeShortNationalRoads(32, 7);
-  transportDebugLayers.postConnectivityBranchNationalDowngrade = downgradeBranchNationalSpurs(42);
-  transportDebugLayers.postConnectivityNationalPrune = pruneTransportPathSet(nationalRoads, 18, 7);
-  transportDebugLayers.postConnectivityMinorDedup = dedupeTransportPathSet(minorRoads, { minLength: 0.95, sampleStep: 2 });
-  transportDebugLayers.postConnectivityLocalSanitization = sanitizeLocalRoads();
-
-  function smoothRasterPath(path, passes = 1) {
-    let current = (path || []).map(([x, y]) => [Math.round(x), Math.round(y)]);
-    for (let pass = 0; pass < passes; pass++) {
-      if (current.length < 3) break;
-      const next = [current[0]];
-      for (let i = 1; i < current.length - 1; i++) {
-        const [ax, ay] = current[i - 1];
-        const [bx, by] = current[i];
-        const [cx, cy] = current[i + 1];
-        const nx = Math.round((ax + bx * 2 + cx) / 4);
-        const ny = Math.round((ay + by * 2 + cy) / 4);
-        if (next[next.length - 1][0] !== nx || next[next.length - 1][1] !== ny) next.push([nx, ny]);
-      }
-      next.push(current[current.length - 1]);
-      current = next;
-    }
-    return current;
-  }
-
-  function directBridgeTunnelConnector(a, b, maxSegment = 20) {
-    if (!a || !b) return [];
-    const d = Math.hypot(a.x - b.x, a.y - b.y);
-    const steps = Math.max(2, Math.ceil(d));
-    const path = [];
-    for (let s = 0; s <= steps; s++) {
-      const t = s / steps;
-      const x = Math.round(a.x + (b.x - a.x) * t);
-      const y = Math.round(a.y + (b.y - a.y) * t);
-      if (!path.length || path[path.length - 1][0] !== x || path[path.length - 1][1] !== y) path.push([x, y]);
-    }
-    return routePhysicalAcceptable(path, 'expressway', { maxSeaRun: maxSegment, maxTunnelRun: Math.min(10, maxSegment), maxSeaShare: 0.70, maxTunnelShare: 0.18 }) ? path : [];
+  function cleanupRoadClassesBeforeFinalTopology() {
+    const debug = {
+      dedupe: {
+        national: dedupeTransportPathSet(nationalRoads, { minLength: 0.95, sampleStep: 1 }),
+        externalRoads: dedupeTransportPathSet(externalRoads, { minLength: 1.5, sampleStep: 1 }),
+        minor: dedupeTransportPathSet(minorRoads, { minLength: 0.95, sampleStep: 2 }),
+        expressways: dedupeTransportPathSet(expressways, { minLength: 4, sampleStep: 2 }),
+        externalExpressways: dedupeTransportPathSet(externalExpressways, { minLength: 4, sampleStep: 2 }),
+      },
+      shortNationalDowngrade: null,
+      branchNationalDowngrade: null,
+      minorDedupeAfterDowngrade: null,
+    };
+    debug.shortNationalDowngrade = downgradeShortNationalRoads(32, 7);
+    debug.branchNationalDowngrade = downgradeBranchNationalSpurs(42);
+    // Downgrades append to minor roads, so normalize that class once afterwards.
+    debug.minorDedupeAfterDowngrade = dedupeTransportPathSet(minorRoads, { minLength: 0.95, sampleStep: 2 });
+    return debug;
   }
 
   function ensureInterchangePoint(x, y, kind = 'Interchange', source = 'expressway-endpoint') {
@@ -2406,7 +2313,7 @@ const premodernRoads = [];
           corePenalty * 1.18 -
           (slope[i] || 0) * 1.05 -
           (ridgeField[i] || 0) * 0.82 +
-          hash2(x, y, seed + 24891 + city.x * 11 + city.y * 17) * 0.04;
+          hash2(worldX(x), worldY(y), seed + 24891 + worldX(city.x) * 11 + worldY(city.y) * 17) * 0.04;
         if (!best || score > best.score) best = { x, y, score, city, population: city.population || 0, regionId: regionIdAt(x, y), role: 'expressway-fringe-anchor' };
       }
     }
@@ -2517,11 +2424,47 @@ const premodernRoads = [];
     return debug;
   }
 
-  transportDebugLayers.postConnectivityNationalCoverage = ensureNationalRoadCoverageForTowns(6000);
-  transportDebugLayers.postConnectivityMajorCityExpresswayGuarantee = ensureMajorCityExpresswayConnections(110000);
-  transportDebugLayers.postConnectivityExpresswayDedup = dedupeTransportPathSet(expressways, { minLength: 8, sampleStep: 2 });
-  transportDebugLayers.postConnectivityExpresswayEndpointICs = ensureExpresswayEndpointsHaveICs();
-  markFeatureTiming("post-connectivity-guarantees");
+  function finalizePreAdminRoadTopology() {
+    const debug = {};
+    // A patch candidate is not a standalone transport graph. Its paths are
+    // merged into the existing world and the whole selected boundary receives
+    // one final portal/connectivity repair in mapPatch. Avoid repeating global
+    // routing/coverage searches independently in every large-selection tile.
+    if (patchMode) {
+      debug.gapStitches = { skipped: true, reason: "deferred-to-patch-merge" };
+      debug.classCleanup = cleanupRoadClassesBeforeFinalTopology();
+      debug.nationalCoverage = { skipped: true, reason: "deferred-to-patch-merge" };
+      debug.majorCityExpresswayGuarantee = { skipped: true, reason: "deferred-to-patch-merge" };
+      debug.expresswayDedupe = dedupeTransportPathSet(expressways, { minLength: 8, sampleStep: 2 });
+      debug.networkConnectivity = { added: 0, skipped: true, reason: "deferred-to-patch-merge" };
+      debug.minorFinalDedupe = dedupeTransportPathSet(minorRoads, { minLength: 0.95, sampleStep: 2 });
+      debug.expresswayEndpointICs = { skipped: true, reason: "deferred-to-patch-merge" };
+      return debug;
+    }
+
+    // One component-aware gap/mesh pass replaces the former repeated
+    // stitch -> long-stitch -> sanitize -> stitch sequence.
+    debug.gapStitches = stitchDisconnectedRoadGaps();
+    debug.classCleanup = cleanupRoadClassesBeforeFinalTopology();
+
+    // Coverage additions must precede the final connectivity pass; previously
+    // they could re-introduce disconnected fragments after connectivity had
+    // already been declared "final".
+    debug.nationalCoverage = ensureNationalRoadCoverageForTowns(6000);
+    debug.majorCityExpresswayGuarantee = ensureMajorCityExpresswayConnections(110000);
+    debug.expresswayDedupe = dedupeTransportPathSet(expressways, { minLength: 8, sampleStep: 2 });
+
+    // This is the only pre-administration whole-road connectivity repair.
+    debug.networkConnectivity = connectPreAdminRoadComponents(46);
+    debug.minorFinalDedupe = debug.networkConnectivity.added > 0
+      ? dedupeTransportPathSet(minorRoads, { minLength: 0.95, sampleStep: 2 })
+      : { skipped: true, reason: "no-connectors-added" };
+    debug.expresswayEndpointICs = ensureExpresswayEndpointsHaveICs();
+    return debug;
+  }
+
+  transportDebugLayers.preAdminRoadFinalization = finalizePreAdminRoadTopology();
+  markFeatureTiming("road-finalization");
 
   const finalRoadInfluencePaths = [...nationalRoads, ...ringRoads, ...externalRoads];
   roadLanduseInfluence = cachedInfluenceFromPaths(finalRoadInfluencePaths, 2.25, "road:landuse:final");
@@ -2541,15 +2484,14 @@ const premodernRoads = [];
     modernCities, logisticsParks,
     roadLanduseInfluence, roadInfluence, roadDensityInfluence, railInfluence2, stationInfluence, stationDensityInfluence, villageInfluence,
     cityInfluence, coreInfluence, oldTownInfluence, townInfluence, industrialInfluence, logisticsInfluence,
+    originX: worldOriginX, originY: worldOriginY,
   });
   markFeatureTiming("landuse");
   const transportDebug = {
     humanStageVersion: "v2-sparse-raster",
     featureTimings,
     coarseRouting: coarseRouteStats,
-    aStarRoutes: 0,
     regionalNodeCount: [...regionStats.keys()].reduce((sum, regionId) => sum + importantNodesForRegion(regionId).length, 0),
-    fieldCorridorTransport: false,
     unifiedODTransport: true,
     settlementHierarchy: settlementHierarchyDebug,
     railODTransport: railODDebug,
@@ -2558,8 +2500,6 @@ const premodernRoads = [];
     nationalRoadFieldCorridors: nationalRoads.length,
     localRoadFieldCorridors: minorRoads.length,
     layers: transportDebugLayers,
-    nationalRoadPopulationCoverage: 0,
-    nationalRoadUncoveredPopulation: 0,
   };
 
   return {
diff --git a/mapGenerator.js b/src/mapGenerator.js
similarity index 100%
rename from mapGenerator.js
rename to src/mapGenerator.js
diff --git a/src/mapGeneratorHelpers.js b/src/mapGeneratorHelpers.js
new file mode 100644
index 0000000..aa338be
--- /dev/null
+++ b/src/mapGeneratorHelpers.js
@@ -0,0 +1,359 @@
+import { generateEntityName } from "./names.js";
+import { INF, MAP_H, MAP_W, SIZE, MinHeap, indexOf, inside, nearMapEdge, pickEntities, rand, xyOf } from "./mapUtils.js";
+
+
+export function neighbors8(x, y) {
+  const out = [];
+  for (let dy = -1; dy <= 1; dy++) {
+    for (let dx = -1; dx <= 1; dx++) {
+      if (dx === 0 && dy === 0) continue;
+      const nx = x + dx;
+      const ny = y + dy;
+      if (inside(nx, ny)) out.push([nx, ny, Math.hypot(dx, dy)]);
+    }
+  }
+  return out;
+}
+
+export function neighbors4(x, y) {
+  const out = [];
+  for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]]) {
+    const nx = x + dx;
+    const ny = y + dy;
+    if (inside(nx, ny)) out.push([nx, ny, 1]);
+  }
+  return out;
+}
+
+
+export function createPointSpatialIndex(points, cellSize = 12) {
+  const buckets = new Map();
+  const normalized = (points || [])
+    .filter((p) => p && Number.isFinite(p.x) && Number.isFinite(p.y))
+    .map((p) => ({ ...p, x: Math.round(p.x), y: Math.round(p.y) }));
+  const keyOf = (cx, cy) => `${cx},${cy}`;
+  for (const p of normalized) {
+    const cx = Math.floor(p.x / cellSize);
+    const cy = Math.floor(p.y / cellSize);
+    const key = keyOf(cx, cy);
+    let bucket = buckets.get(key);
+    if (!bucket) {
+      bucket = [];
+      buckets.set(key, bucket);
+    }
+    bucket.push(p);
+  }
+
+  function nearestDistanceSq(x, y, maxDistance = Math.max(MAP_W, MAP_H)) {
+    if (!normalized.length) return maxDistance * maxDistance;
+    const cx = Math.floor(x / cellSize);
+    const cy = Math.floor(y / cellSize);
+    const maxRing = Number.isFinite(maxDistance) ? Math.ceil(maxDistance / cellSize) : Math.ceil(Math.max(MAP_W, MAP_H) / cellSize);
+    let best = maxDistance * maxDistance;
+    for (let ring = 0; ring <= maxRing; ring++) {
+      for (let by = cy - ring; by <= cy + ring; by++) {
+        for (let bx = cx - ring; bx <= cx + ring; bx++) {
+          if (ring > 0 && bx > cx - ring && bx < cx + ring && by > cy - ring && by < cy + ring) continue;
+          const bucket = buckets.get(keyOf(bx, by));
+          if (!bucket) continue;
+          for (const p of bucket) {
+            const dx = p.x - x;
+            const dy = p.y - y;
+            const d2 = dx * dx + dy * dy;
+            if (d2 < best) best = d2;
+          }
+        }
+      }
+    }
+    return best;
+  }
+
+  return {
+    points: normalized,
+    hasWithin(x, y, radius) {
+      return nearestDistanceSq(x, y, radius) < radius * radius;
+    },
+    distance(x, y, fallback = 999) {
+      const d2 = nearestDistanceSq(x, y, fallback);
+      return d2 < fallback * fallback ? Math.sqrt(d2) : fallback;
+    },
+    nearestDistanceSq,
+  };
+}
+
+export function influenceFromPaths(paths, radius) {
+  const grid = new Float32Array(SIZE);
+  const r = Math.ceil(radius);
+  const r2 = radius * radius;
+  for (const path of paths) {
+    for (const [x, y] of path) {
+      for (let dy = -r; dy <= r; dy++) {
+        for (let dx = -r; dx <= r; dx++) {
+          const nx = x + dx;
+          const ny = y + dy;
+          if (!inside(nx, ny)) continue;
+          const d2 = dx * dx + dy * dy;
+          if (d2 > r2) continue;
+          const d = Math.sqrt(d2);
+          const i = indexOf(nx, ny);
+          grid[i] = Math.max(grid[i], 1 / (1 + d));
+        }
+      }
+    }
+  }
+  return grid;
+}
+
+export function influenceFromPoints(points, radius, weightFn = () => 1) {
+  const grid = new Float32Array(SIZE);
+  const r = Math.ceil(radius);
+  const r2 = radius * radius;
+  for (const p of points) {
+    const weight = weightFn(p);
+    for (let dy = -r; dy <= r; dy++) {
+      for (let dx = -r; dx <= r; dx++) {
+        const nx = p.x + dx;
+        const ny = p.y + dy;
+        if (!inside(nx, ny)) continue;
+        const d2 = dx * dx + dy * dy;
+        if (d2 > r2) continue;
+        const d = Math.sqrt(d2);
+        const i = indexOf(nx, ny);
+        grid[i] = Math.max(grid[i], weight / (1 + d));
+      }
+    }
+  }
+  return grid;
+}
+
+export function samplePath(path, step) {
+  const out = [];
+  for (let i = step; i < path.length - step; i += step) {
+    const [x, y] = path[i];
+    out.push({ x, y, score: 1 });
+  }
+  return out;
+}
+
+function smoothMask(mask, passes = 2) {
+  let current = new Uint8Array(mask);
+  for (let pass = 0; pass < passes; pass++) {
+    const next = new Uint8Array(current);
+    for (let y = 1; y < MAP_H - 1; y++) {
+      for (let x = 1; x < MAP_W - 1; x++) {
+        const i = indexOf(x, y);
+        let count = 0;
+        for (let dy = -1; dy <= 1; dy++) {
+          for (let dx = -1; dx <= 1; dx++) {
+            if (current[indexOf(x + dx, y + dy)]) count++;
+          }
+        }
+        if (count >= 5) next[i] = 1;
+        else if (count <= 3) next[i] = 0;
+      }
+    }
+    current = next;
+  }
+  return current;
+}
+
+function largestConnectedMask(mask) {
+  const seen = new Uint8Array(SIZE);
+  let best = [];
+  const queue = [];
+
+  for (let i = 0; i < SIZE; i++) {
+    if (!mask[i] || seen[i]) continue;
+    const component = [];
+    queue.length = 0;
+    queue.push(i);
+    seen[i] = 1;
+
+    for (let q = 0; q < queue.length; q++) {
+      const cur = queue[q];
+      component.push(cur);
+      const [x, y] = xyOf(cur);
+      for (const [nx, ny] of neighbors8(x, y)) {
+        const ni = indexOf(nx, ny);
+        if (!mask[ni] || seen[ni]) continue;
+        seen[ni] = 1;
+        queue.push(ni);
+      }
+    }
+
+    if (component.length > best.length) best = component;
+  }
+
+  const out = new Uint8Array(SIZE);
+  for (const i of best) out[i] = 1;
+  return out;
+}
+
+export function makePrefectureMask(seed, sea, elevation, slope, river) {
+  const candidates = [];
+  for (let y = 8; y < MAP_H - 8; y++) {
+    for (let x = 8; x < MAP_W - 8; x++) {
+      const i = indexOf(x, y);
+      if (sea[i]) continue;
+      const centrality = 1 - Math.hypot((x / MAP_W) - 0.5, (y / MAP_H) - 0.5) / 0.72;
+      const score = centrality * 0.28 + (1 - slope[i]) * 0.42 + (1 - Math.abs(elevation[i] - 0.42)) * 0.22 + Math.min(0.16, river[i] * 0.08);
+      candidates.push({ x, y, score });
+    }
+  }
+
+  const regionSeeds = pickEntities(candidates, {
+    max: 1,
+    minDistance: 18,
+    threshold: 0.35,
+    seed: seed + 904,
+    jitter: 0.02,
+  });
+
+  const mask = new Uint8Array(SIZE);
+  const dist = new Float32Array(SIZE);
+  dist.fill(INF);
+  const heap = new MinHeap();
+  const landCells = sea.reduce((a, v) => a + (v ? 0 : 1), 0);
+  const target = Math.floor(landCells * (0.23 + rand(seed, 906) * 0.08));
+
+  for (const s of regionSeeds) {
+    const i = indexOf(s.x, s.y);
+    dist[i] = 0;
+    heap.push({ i, f: 0 });
+  }
+
+  let claimed = 0;
+  while (heap.length > 0 && claimed < target) {
+    const current = heap.pop();
+    if (!current) continue;
+    const ci = current.i;
+    if (current.f > dist[ci] + 1e-5 || mask[ci]) continue;
+    const [cx, cy] = xyOf(ci);
+    if (sea[ci]) continue;
+
+    mask[ci] = 1;
+    claimed++;
+
+    for (const [nx, ny, step] of neighbors8(cx, cy)) {
+      const ni = indexOf(nx, ny);
+      if (sea[ni] || mask[ni]) continue;
+      const edgePenalty = nearMapEdge(nx, ny, 2) ? 4.2 : nearMapEdge(nx, ny, 5) ? 1.8 : 0;
+      const ridgePenalty = Math.max(0, elevation[ni] - 0.5) * 5.4 + Math.max(0, elevation[ni] - elevation[ci]) * 3.2;
+      const slopePenalty = slope[ni] * 4.1;
+      const riverPenalty = river[ni] > 0.65 ? 2.2 : river[ni] > 0.32 ? 0.9 : 0;
+      const cost = Math.max(0.18, 1 + edgePenalty + ridgePenalty + slopePenalty + riverPenalty + Math.abs(elevation[ni] - elevation[ci]) * 4.2) * step;
+      const nd = dist[ci] + cost;
+      if (nd < dist[ni]) {
+        dist[ni] = nd;
+        heap.push({ i: ni, f: nd });
+      }
+    }
+  }
+
+  return largestConnectedMask(smoothMask(mask, 2));
+}
+
+export function extractMaskBorder(mask, sea = null) {
+  const segments = [];
+  for (let y = 0; y < MAP_H; y++) {
+    for (let x = 0; x < MAP_W; x++) {
+      const i = indexOf(x, y);
+      const a = mask[i];
+      if (x + 1 < MAP_W) {
+        const ni = indexOf(x + 1, y);
+        const b = mask[ni];
+        if (a !== b && !(sea && (sea[i] || sea[ni]))) segments.push([[x + 1, y], [x + 1, y + 1]]);
+      }
+      if (y + 1 < MAP_H) {
+        const ni = indexOf(x, y + 1);
+        const b = mask[ni];
+        if (a !== b && !(sea && (sea[i] || sea[ni]))) segments.push([[x, y + 1], [x + 1, y + 1]]);
+      }
+    }
+  }
+  return segments;
+}
+
+export function extractAdminBorderSegments(adminId, prefectureMask, prefectureRegionId = null, sea = null) {
+  const segments = [];
+  const validCell = (i) => Boolean(prefectureMask?.[i]) && !(sea?.[i]) && (adminId?.[i] ?? -1) >= 0;
+  const samePrefecture = (i, j) => !prefectureRegionId
+    || ((prefectureRegionId[i] ?? -1) >= 0 && prefectureRegionId[i] === prefectureRegionId[j]);
+  for (let y = 0; y < MAP_H; y++) {
+    for (let x = 0; x < MAP_W; x++) {
+      const i = indexOf(x, y);
+      if (!validCell(i)) continue;
+      const a = adminId[i];
+      if (x + 1 < MAP_W) {
+        const ni = indexOf(x + 1, y);
+        if (validCell(ni) && samePrefecture(i, ni)) {
+          const b = adminId[ni];
+          if (a !== b) segments.push([[x + 1, y], [x + 1, y + 1]]);
+        }
+      }
+      if (y + 1 < MAP_H) {
+        const ni = indexOf(x, y + 1);
+        if (validCell(ni) && samePrefecture(i, ni)) {
+          const b = adminId[ni];
+          if (a !== b) segments.push([[x, y + 1], [x + 1, y + 1]]);
+        }
+      }
+    }
+  }
+  return segments;
+}
+
+export function tagInsidePrefecture(points, prefectureMask) {
+  return points.map((p) => ({ ...p, insidePrefecture: Boolean(prefectureMask[indexOf(p.x, p.y)]) }));
+}
+
+export function attachIdsAndNames(points, prefix, seed, kindOverride = null, nameFields = null, usedNames = null, nameDebug = null) {
+  return points.map((p, i) => {
+    const id = `${prefix}-${i}`;
+    const kind = kindOverride || p.kind;
+    if (prefix === "logistics") {
+      return {
+        ...p,
+        id,
+        name: null,
+        facilityLabel: p.facilityLabel || "Logistics Park",
+        kind,
+        labelStyle: "facility",
+        suppressSettlementLabel: true,
+        insidePrefecture: Boolean(p.insidePrefecture),
+      };
+    }
+    const name = generateEntityName(seed + prefix.length * 1000, id, { ...p, kind }, nameFields, usedNames, nameDebug);
+    if (usedNames) usedNames.add(name);
+    return {
+      ...p,
+      id,
+      name,
+      kind,
+      insidePrefecture: Boolean(p.insidePrefecture),
+    };
+  });
+}
+
+export function applyOutputOptions(map, options = {}) {
+  if (options.includeDebugFields !== false) return map;
+  const slim = { ...map };
+  delete slim.settlementCluster;
+  delete slim.ridgeField;
+  delete slim.valleyField;
+  delete slim.basinField;
+  delete slim.coastalLowland;
+  delete slim.flowAccum;
+  delete slim.erosionField;
+  delete slim.depositionField;
+  delete slim.terrainTemplate;
+  delete slim.ocean;
+  delete slim.lake;
+  delete slim.arcSpineField;
+  delete slim.branchRidgeField;
+  delete slim.depositionalLowland;
+  delete slim.alluvialFanField;
+  delete slim.deltaField;
+  delete slim.naturalBarrierScore;
+  return slim;
+}
diff --git a/mapGeography.js b/src/mapGeography.js
similarity index 99%
rename from mapGeography.js
rename to src/mapGeography.js
index c2328a3..7bc39af 100644
--- a/mapGeography.js
+++ b/src/mapGeography.js
@@ -3,7 +3,7 @@ import { influenceFromPoints } from "./mapGeneratorHelpers.js";
 
 const GEOGRAPHY_VERSION = "unified-geography-v1";
 
-function localConfluenceScore(x, y, river) {
+export function localConfluenceScore(x, y, river) {
   let arms = 0;
   let strong = 0;
   for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1],[1,1],[-1,1],[1,-1],[-1,-1]]) {
diff --git a/mapMunicipalCoherence.js b/src/mapMunicipalCoherence.js
similarity index 72%
rename from mapMunicipalCoherence.js
rename to src/mapMunicipalCoherence.js
index 88684ed..7792ec1 100644
--- a/mapMunicipalCoherence.js
+++ b/src/mapMunicipalCoherence.js
@@ -1,6 +1,24 @@
 import { INF, MAP_H, MAP_W } from "./mapUtils.js";
 
 const ADMIN_ID_KEYS = ["adminId", "municipalityId", "adminNumericId"];
+const PREFECTURE_NAME_KEYS = ["prefectureName", "prefectureRegionName", "regionName", "name", "labelName"];
+
+function usableName(value) {
+  const text = value == null ? "" : String(value).trim();
+  if (!text) return "";
+  if (/^県域\d*$/u.test(text)) return "";
+  if (/^Unnamed prefecture$/i.test(text)) return "";
+  if (/^Prefecture\s*-?\d+$/i.test(text)) return "";
+  return text;
+}
+
+function firstUsableName(obj, keys = PREFECTURE_NAME_KEYS) {
+  for (const key of keys) {
+    const text = usableName(obj?.[key]);
+    if (text) return text;
+  }
+  return "";
+}
 
 function coordIndex(width, height, x, y) {
   if (x < 0 || y < 0 || x >= width || y >= height) return -1;
@@ -32,7 +50,7 @@ function buildMunicipalStats({ adminId, prefectureRegionId, sea, fields = {}, wi
   for (let i = 0; i < adminId.length; i++) {
     const id = adminId[i];
     if (!Number.isFinite(id) || id < 0 || sea?.[i]) continue;
-    const row = stats.get(id) || { id, area: 0, sx: 0, sy: 0, bestI: -1, bestScore: -INF, prefVotes: new Map() };
+    const row = stats.get(id) || { id, area: 0, sx: 0, sy: 0, bestI: -1, bestScore: -INF, prefVotes: new Map(), bestByPrefecture: new Map() };
     const x = i % width;
     const y = Math.floor(i / width);
     row.area++;
@@ -45,6 +63,10 @@ function buildMunicipalStats({ adminId, prefectureRegionId, sea, fields = {}, wi
       row.bestScore = score;
       row.bestI = i;
     }
+    if (pref >= 0) {
+      const prefBest = row.bestByPrefecture.get(pref);
+      if (!prefBest || score > prefBest.score) row.bestByPrefecture.set(pref, { i, score });
+    }
     stats.set(id, row);
   }
   for (const row of stats.values()) {
@@ -57,8 +79,10 @@ function buildMunicipalStats({ adminId, prefectureRegionId, sea, fields = {}, wi
       }
     }
     row.prefectureRegionId = bestPref;
-    row.x = row.bestI >= 0 ? row.bestI % width : Math.round(row.sx / Math.max(1, row.area));
-    row.y = row.bestI >= 0 ? Math.floor(row.bestI / width) : Math.round(row.sy / Math.max(1, row.area));
+    const preferredCell = row.bestByPrefecture.get(bestPref)?.i ?? row.bestI;
+    row.bestI = preferredCell;
+    row.x = preferredCell >= 0 ? preferredCell % width : Math.round(row.sx / Math.max(1, row.area));
+    row.y = preferredCell >= 0 ? Math.floor(preferredCell / width) : Math.round(row.sy / Math.max(1, row.area));
   }
   return stats;
 }
@@ -190,6 +214,8 @@ export function refreshPrefectureRegionsMetadata({
   prefectureRegionId,
   sea,
   existing = [],
+  adminCenters = [],
+  capitalCities = [],
   fields = {},
   width = MAP_W,
   height = MAP_H,
@@ -219,6 +245,26 @@ export function refreshPrefectureRegionsMetadata({
     const id = Number.isFinite(region?.prefectureRegionId) ? Math.floor(region.prefectureRegionId) : Number.isFinite(region?.id) ? Math.floor(region.id) : -1;
     if (id >= 0 && !existingById.has(id)) existingById.set(id, region);
   }
+  const nameByPref = new Map();
+  for (const center of adminCenters || []) {
+    const id = Number.isFinite(center?.prefectureRegionId) ? Math.floor(center.prefectureRegionId) : -1;
+    if (id < 0 || nameByPref.has(id)) continue;
+    const name = firstUsableName(center, ["prefectureName", "prefectureRegionName", "regionName"]);
+    if (name) nameByPref.set(id, name);
+  }
+  const capitalByPref = new Map();
+  const capitalLike = (city) => !!(city?.isPrefecturalCapital || city?.isRegionalCapital || /Capital/i.test(String(city?.rank || "")) || /Capital/i.test(String(city?.kind || "")));
+  for (const city of capitalCities || []) {
+    if (!capitalLike(city)) continue;
+    const fx = Math.round((city?.x || 0) + pointOffsetX);
+    const fy = Math.round((city?.y || 0) + pointOffsetY);
+    const i = coordIndex(width, height, fx, fy);
+    if (i < 0 || sea?.[i]) continue;
+    const id = prefectureRegionId[i];
+    if (!Number.isFinite(id) || id < 0) continue;
+    const previous = capitalByPref.get(id);
+    if (!previous || Number(city?.population || 0) > Number(previous?.population || 0)) capitalByPref.set(id, city);
+  }
   let fallbackRegionsAdded = 0;
   const prefectureRegions = [];
   for (const [id, row] of [...byId.entries()].sort((a, b) => a[0] - b[0])) {
@@ -226,6 +272,10 @@ export function refreshPrefectureRegionsMetadata({
     if (!base) fallbackRegionsAdded++;
     const x = row.bestI >= 0 ? row.bestI % width : Math.round(row.sx / Math.max(1, row.area));
     const y = row.bestI >= 0 ? Math.floor(row.bestI / width) : Math.round(row.sy / Math.max(1, row.area));
+    const resolvedName = firstUsableName(base) || nameByPref.get(id) || `県域${id + 1}`;
+    const capital = capitalByPref.get(id) || null;
+    const capitalFieldX = capital ? Math.round((capital.x || 0) + pointOffsetX) : x;
+    const capitalFieldY = capital ? Math.round((capital.y || 0) + pointOffsetY) : y;
     prefectureRegions.push({
       ...(base || {}),
       id,
@@ -233,10 +283,20 @@ export function refreshPrefectureRegionsMetadata({
       featureId: id,
       x: x - pointOffsetX,
       y: y - pointOffsetY,
+      worldX: x,
+      worldY: y,
+      capitalX: capitalFieldX - pointOffsetX,
+      capitalY: capitalFieldY - pointOffsetY,
+      capitalWorldX: capitalFieldX,
+      capitalWorldY: capitalFieldY,
+      insidePrefecture: true,
       area: row.area,
       kind: base?.kind || (id === 0 ? "Current Prefecture" : "Prefecture"),
-      name: base?.name || `県域${id + 1}`,
-      labelName: base?.labelName || base?.name || `県域${id + 1}`,
+      name: resolvedName,
+      labelName: firstUsableName(base, ["labelName"]) || resolvedName,
+      prefectureName: firstUsableName(base, ["prefectureName"]) || resolvedName,
+      prefectureRegionName: firstUsableName(base, ["prefectureRegionName"]) || resolvedName,
+      regionName: firstUsableName(base, ["regionName"]) || resolvedName,
       forceLabel: true,
       labelPriorityBase: base?.labelPriorityBase || 950 + Math.sqrt(row.area),
     });
@@ -250,16 +310,3 @@ export function refreshPrefectureRegionsMetadata({
   };
 }
 
-export function municipalCoherenceForMap(map) {
-  return reconcileMunicipalMetadata({
-    adminId: map?.adminId,
-    municipalityId: map?.municipalityId,
-    prefectureRegionId: map?.prefectureRegionId,
-    sea: map?.sea,
-    adminCenters: map?.adminCenters,
-    municipalityToPrefectureId: map?.municipalityToPrefectureId,
-    fields: map,
-    width: map?.width || MAP_W,
-    height: map?.height || MAP_H,
-  });
-}
diff --git a/mapOutput.js b/src/mapOutput.js
similarity index 88%
rename from mapOutput.js
rename to src/mapOutput.js
index 20c7e23..1e29fc3 100644
--- a/mapOutput.js
+++ b/src/mapOutput.js
@@ -1,10 +1,10 @@
 import { createNameDebug } from "./names.js";
 import { CELL_SIZE, INF, MAP_H, MAP_W, MinHeap, clamp, indexOf, inside, rand, xyOf } from "./mapUtils.js";
-import { applyOutputOptions, attachIdsAndNames, influenceFromPaths, tagInsidePrefecture } from "./mapGeneratorHelpers.js";
+import { applyOutputOptions, attachIdsAndNames, extractAdminBorderSegments, influenceFromPaths, tagInsidePrefecture } from "./mapGeneratorHelpers.js";
 import { reconcileMunicipalMetadata } from "./mapMunicipalCoherence.js";
 import { routeQualityAcceptable } from "./mapTransport.js";
+import { componentLabelNear, labelOccupancyComponents, makeSpatialIndex, occupancyComponentsFromPathGroups, rasterizePathCells } from "./mapTransportUtils.js";
 
-const MUNICIPAL_SUFFIX_RE = /[市町村区]$/u;
 
 function stripMunicipalSuffix(name) {
   return String(name || "").replace(/[市町村区]$/u, "").trim();
@@ -27,6 +27,10 @@ function municipalityNameFromRoot(root, center, fields, seed, ordinal = 0) {
   value = value.replace(/[市町村区駅港城跡宿]$/gu, "");
   const fallback = String(center?.generatedMunicipalityName || "里").replace(/[市町村区駅港城跡宿]$/gu, "");
   if (!value) value = fallback || "里";
+  if (Array.from(value).length < 2) {
+    const complements = ["川", "野", "原", "里", "浜", "森", "田", "谷"];
+    value = `${value}${complements[Math.abs((seed + ordinal * 13) | 0) % complements.length]}`;
+  }
   return `${value}${municipalitySuffixForCenter(center, fields, seed, ordinal)}`;
 }
 
@@ -174,11 +178,18 @@ function promotePrefectureCapitalPopulations(prefectureRegionId, sea, modernCiti
   }
   for (const prefId of [...prefIds].sort((a, b) => a - b)) {
     const cities = (modernCities || []).filter((p) => prefAt(p) === prefId);
-    let target = cities.slice().sort((a, b) =>
+    const focusedCities = prefId === focusedPrefId && focusedPrefectureMask
+      ? cities.filter((p) => inside(p.x, p.y) && focusedPrefectureMask[indexOf(p.x, p.y)])
+      : [];
+    let target = (focusedCities.length ? focusedCities : cities).slice().sort((a, b) =>
       ((b.isRegionalCapital ? 800000 : 0) + (b.population || 0)) - ((a.isRegionalCapital ? 800000 : 0) + (a.population || 0))
     )[0];
     if (!target) {
-      const market = (markets || []).filter((p) => prefAt(p) === prefId).sort((a, b) => (b.population || 0) - (a.population || 0))[0];
+      const marketPool = (markets || []).filter((p) => prefAt(p) === prefId);
+      const focusedMarkets = prefId === focusedPrefId && focusedPrefectureMask
+        ? marketPool.filter((p) => inside(p.x, p.y) && focusedPrefectureMask[indexOf(p.x, p.y)])
+        : [];
+      const market = (focusedMarkets.length ? focusedMarkets : marketPool).sort((a, b) => (b.population || 0) - (a.population || 0))[0];
       if (market) {
         target = {
           ...market,
@@ -191,7 +202,11 @@ function promotePrefectureCapitalPopulations(prefectureRegionId, sea, modernCiti
       }
     }
     if (!target) {
-      const center = (adminCenters || []).filter((p) => prefAt(p) === prefId).sort((a, b) => (b.municipalityPopulation || 0) - (a.municipalityPopulation || 0))[0];
+      const centerPool = (adminCenters || []).filter((p) => prefAt(p) === prefId);
+      const focusedCenters = prefId === focusedPrefId && focusedPrefectureMask
+        ? centerPool.filter((p) => inside(p.x, p.y) && focusedPrefectureMask[indexOf(p.x, p.y)])
+        : [];
+      const center = (focusedCenters.length ? focusedCenters : centerPool).sort((a, b) => (b.municipalityPopulation || 0) - (a.municipalityPopulation || 0))[0];
       if (center) {
         target = {
           ...center,
@@ -413,7 +428,7 @@ export function finishMapOutput({
   const {
     adminCentersRaw,
     adminId,
-    adminBorders,
+    adminBorders: stageAdminBorders,
     adminDebug,
     prefectureRegionId,
     municipalityToPrefectureId,
@@ -441,6 +456,7 @@ export function finishMapOutput({
   let externalGateways = inputExternalGateways;
 
   const outputProgress = (step) => options?.onProgress?.({ status: "output-step", key: "output", label: `Output: ${step}`, step });
+  const patchMode = options?.patchMode === true || options?.generationContext?.hasBoundaryWorld === true;
   outputProgress("final packaging");
   // Use all generated prefecture regions for human-geography masks, not only
   // the focused prefecture.  Population density itself is already generated in
@@ -454,11 +470,19 @@ export function finishMapOutput({
   // name features.
   for (const city of modernCities) {
     const cap = cityPopulationCap(city);
-    if (cap < INF && (city.population || 0) > cap) {
-      city.population = Math.round(cap / 1000) * 1000;
-      city.urbanRadius = clamp(5.0 + Math.sqrt(city.population) / 100, 6, 16);
-      city.coreRadius = clamp(1.8 + Math.sqrt(city.population) / 400, 2.2, 5.2);
-      city.urbanWeight = clamp(0.72 + Math.log10(Math.max(10000, city.population)) * 0.30, 1.0, 2.0);
+    let targetCap = cap;
+    if (patchMode) {
+      // Patch candidates should not regularly introduce a new top-center-scale
+      // metropolis. Existing cities in the world are preserved by mapPatch; this
+      // only affects newly generated candidate cities before they are merged.
+      const patchCap = city.isPrefecturalCapital ? 820000 : city.isRegionalCapital ? 680000 : 540000;
+      targetCap = Math.min(targetCap, patchCap);
+    }
+    if (targetCap < INF && (city.population || 0) > targetCap) {
+      city.population = Math.round(targetCap / 1000) * 1000;
+      city.urbanRadius = clamp(5.0 + Math.sqrt(city.population) / 100, 6, patchMode ? 14 : 16);
+      city.coreRadius = clamp(1.8 + Math.sqrt(city.population) / 400, 2.2, patchMode ? 4.8 : 5.2);
+      city.urbanWeight = clamp(0.72 + Math.log10(Math.max(10000, city.population)) * 0.30, 1.0, patchMode ? 1.86 : 2.0);
     }
   }
 
@@ -724,7 +748,6 @@ export function finishMapOutput({
       debugLayers.repairedSegments.push({ mode: "municipal-local", path, from: "municipal-center", to: "network" });
     }
   }
-  addMunicipalCenterLocalAccess();
 
   function pruneIsolatedFinalRoadComponents() {
     const debugLayers = transportDebug ? (transportDebug.layers || (transportDebug.layers = {})) : {};
@@ -735,42 +758,6 @@ export function finishMapOutput({
       ["expressway", expressways],
       ["externalExpressway", externalExpressways],
     ];
-    function rasterize(path, fn) {
-      for (let k = 0; k < (path?.length || 0); k++) {
-        const [x0, y0] = path[k];
-        const [x1, y1] = path[Math.min(k + 1, path.length - 1)];
-        const steps = Math.max(1, Math.ceil(Math.hypot(x1 - x0, y1 - y0)));
-        for (let s = 0; s <= steps; s++) {
-          const t = s / steps;
-          const x = Math.round(x0 + (x1 - x0) * t);
-          const y = Math.round(y0 + (y1 - y0) * t);
-          fn(x, y);
-        }
-      }
-    }
-    function splitPathOnSea(path) {
-      const chunks = [];
-      let chunk = [];
-      function pushPoint(x, y) {
-        if (!inside(x, y) || sea[indexOf(x, y)]) {
-          if (chunk.length >= 2) chunks.push(chunk);
-          chunk = [];
-          return;
-        }
-        if (!chunk.length || chunk[chunk.length - 1][0] !== x || chunk[chunk.length - 1][1] !== y) chunk.push([x, y]);
-      }
-      for (let k = 0; k < (path?.length || 0); k++) {
-        const [x0, y0] = path[k];
-        const [x1, y1] = path[Math.min(k + 1, path.length - 1)];
-        const steps = Math.max(1, Math.ceil(Math.hypot(x1 - x0, y1 - y0)));
-        for (let s = 0; s <= steps; s++) {
-          const t = s / steps;
-          pushPoint(Math.round(x0 + (x1 - x0) * t), Math.round(y0 + (y1 - y0) * t));
-        }
-      }
-      if (chunk.length >= 2) chunks.push(chunk);
-      return chunks;
-    }
     // Keep sea-crossing cells in the stored path so the renderer can draw
     // explicit bridge overlays. Connectivity analysis below ignores sea cells
     // when rasterizing components, so preserving them here does not make islands
@@ -804,62 +791,16 @@ export function finishMapOutput({
     }
 
     function components() {
-      const occ = new Uint8Array(MAP_W * MAP_H);
-      for (const [, paths] of groups) for (const path of paths || []) rasterize(path, (x, y) => {
-        if (inside(x, y) && !sea[indexOf(x, y)]) occ[indexOf(x, y)] = 1;
+      const { components } = occupancyComponentsFromPathGroups(groups.map(([, paths]) => paths), {
+        maxDistanceSq: 5,
+        accept: (_x, _y, i) => !sea[i],
       });
-      const seen = new Uint8Array(MAP_W * MAP_H);
-      const out = [];
-      for (let i = 0; i < occ.length; i++) {
-        if (!occ[i] || seen[i]) continue;
-        const queue = [i];
-        const cells = [];
-        seen[i] = 1;
-        for (let q = 0; q < queue.length; q++) {
-          const cur = queue[q];
-          cells.push(cur);
-          const [x, y] = xyOf(cur);
-          for (let dy = -2; dy <= 2; dy++) for (let dx = -2; dx <= 2; dx++) {
-            if (!dx && !dy) continue;
-            if (dx * dx + dy * dy > 5) continue;
-            const nx = x + dx, ny = y + dy;
-            if (!inside(nx, ny)) continue;
-            const ni = indexOf(nx, ny);
-            if (!occ[ni] || seen[ni]) continue;
-            seen[ni] = 1;
-            queue.push(ni);
-          }
-        }
-        out.push({ cells, size: cells.length });
-      }
-      return out.sort((a, b) => b.size - a.size);
+      return components.sort((a, b) => b.size - a.size);
     }
     function buildLandComponentIds() {
-      const ids = new Int32Array(MAP_W * MAP_H);
-      ids.fill(-1);
-      let id = 0;
-      const q = [];
-      for (let i = 0; i < ids.length; i++) {
-        if (ids[i] >= 0 || sea[i]) continue;
-        ids[i] = id;
-        q.length = 0;
-        q.push(i);
-        for (let h = 0; h < q.length; h++) {
-          const cur = q[h];
-          const [x, y] = xyOf(cur);
-          for (let dy = -1; dy <= 1; dy++) for (let dx = -1; dx <= 1; dx++) {
-            if (!dx && !dy) continue;
-            const nx = x + dx, ny = y + dy;
-            if (!inside(nx, ny)) continue;
-            const ni = indexOf(nx, ny);
-            if (sea[ni] || ids[ni] >= 0) continue;
-            ids[ni] = id;
-            q.push(ni);
-          }
-        }
-        id++;
-      }
-      return ids;
+      const land = new Uint8Array(MAP_W * MAP_H);
+      for (let i = 0; i < land.length; i++) if (!sea[i]) land[i] = 1;
+      return labelOccupancyComponents(land, { maxDistanceSq: 2 }).labels;
     }
 
     function majorityLandId(cells, landIds) {
@@ -994,7 +935,10 @@ export function finishMapOutput({
     const mountainConnect = attemptConnectSameLandmassAdminRoadComponents(comps);
     if (mountainConnect.added > 0) comps = components();
     const pruned = { minor: 0, national: 0, external: 0, expressway: 0, externalExpressway: 0 };
+    let prunePasses = 0;
     for (let pass = 0; pass < 4 && comps.length > 1; pass++) {
+      prunePasses++;
+      let passPruned = 0;
       const mainMask = new Uint8Array(MAP_W * MAP_H);
       for (const ci of comps[0].cells) {
         const [cx, cy] = xyOf(ci);
@@ -1006,7 +950,7 @@ export function finishMapOutput({
       }
       function touchesMain(path) {
         let hit = 0, n = 0;
-        rasterize(path, (x, y) => {
+        rasterizePathCells(path, (x, y) => {
           if (!inside(x, y) || sea[indexOf(x, y)]) return;
           n++;
           if (mainMask[indexOf(x, y)]) hit++;
@@ -1017,18 +961,19 @@ export function finishMapOutput({
         const kept = [];
         for (const path of paths || []) {
           if (touchesMain(path) || pathNearAdminCenter(path) || ((key === "expressway" || key === "externalExpressway") && pathNearRequiredExpresswayCity(path))) kept.push(path);
-          else pruned[key]++;
+          else { pruned[key]++; passPruned++; }
         }
         paths.length = 0;
         paths.push(...kept);
       }
       comps = components();
+      if (passPruned === 0) break;
     }
-    debugLayers.finalOutputRoadConnectivity = { beforeComponents: before, afterComponents: comps.length, pruned, mountainAdminConnections: mountainConnect };
+    debugLayers.outputRoadPrune = { beforeComponents: before, afterComponents: comps.length, pruned, prunePasses, mountainAdminConnections: mountainConnect };
+    return debugLayers.outputRoadPrune;
   }
-  pruneIsolatedFinalRoadComponents();
 
-  function ensureAdminCenterCellsAfterOutputPrune() {
+  function ensureAdminCenterRoadStubs() {
     let added = 0;
     function roadTouches(center) {
       for (const path of [...minorRoads, ...nationalRoads, ...externalRoads]) {
@@ -1050,10 +995,10 @@ export function finishMapOutput({
     }
     if (transportDebug) {
       transportDebug.layers ||= {};
-      transportDebug.layers.adminCenterFinalStubs = added;
+      transportDebug.layers.adminCenterRequiredStubs = added;
     }
+    return added;
   }
-  ensureAdminCenterCellsAfterOutputPrune();
 
   function connectNearbyRoadEndpoints() {
     const debugLayers = transportDebug ? (transportDebug.layers || (transportDebug.layers = {})) : {};
@@ -1063,58 +1008,12 @@ export function finishMapOutput({
       { key: "external", paths: externalRoads || [] },
       { key: "ring", paths: ringRoads || [] },
     ];
-    const occ = new Uint8Array(MAP_W * MAP_H);
-    function rasterize(path, fn) {
-      for (let k = 1; k < (path?.length || 0); k++) {
-        const [x0, y0] = path[k - 1];
-        const [x1, y1] = path[k];
-        const steps = Math.max(1, Math.ceil(Math.hypot(x1 - x0, y1 - y0)));
-        for (let s = 0; s <= steps; s++) {
-          const t = s / steps;
-          const x = Math.round(x0 + (x1 - x0) * t);
-          const y = Math.round(y0 + (y1 - y0) * t);
-          if (inside(x, y) && !sea[indexOf(x, y)]) fn(x, y);
-        }
-      }
-    }
-    for (const group of ordinaryGroups) for (const path of group.paths || []) rasterize(path, (x, y) => { occ[indexOf(x, y)] = 1; });
-    const comp = new Int32Array(MAP_W * MAP_H);
-    comp.fill(-1);
-    let compId = 0;
-    const queue = [];
-    for (let i = 0; i < occ.length; i++) {
-      if (!occ[i] || comp[i] >= 0) continue;
-      comp[i] = compId;
-      queue.length = 0;
-      queue.push(i);
-      for (let q = 0; q < queue.length; q++) {
-        const cur = queue[q];
-        const [x, y] = xyOf(cur);
-        for (let dy = -1; dy <= 1; dy++) for (let dx = -1; dx <= 1; dx++) {
-          if (!dx && !dy) continue;
-          const nx = x + dx, ny = y + dy;
-          if (!inside(nx, ny)) continue;
-          const ni = indexOf(nx, ny);
-          if (!occ[ni] || comp[ni] >= 0) continue;
-          comp[ni] = compId;
-          queue.push(ni);
-        }
-      }
-      compId++;
-    }
+    const { labels: comp } = occupancyComponentsFromPathGroups(ordinaryGroups.map((group) => group.paths), {
+      maxDistanceSq: 2,
+      accept: (_x, _y, i) => !sea[i],
+    });
     function endpointComponent(x, y) {
-      if (!inside(x, y) || sea[indexOf(x, y)]) return -1;
-      const here = comp[indexOf(x, y)];
-      if (here >= 0) return here;
-      for (let r = 1; r <= 2; r++) {
-        for (let dy = -r; dy <= r; dy++) for (let dx = -r; dx <= r; dx++) {
-          const nx = x + dx, ny = y + dy;
-          if (!inside(nx, ny) || sea[indexOf(nx, ny)]) continue;
-          const id = comp[indexOf(nx, ny)];
-          if (id >= 0) return id;
-        }
-      }
-      return -1;
+      return componentLabelNear(comp, x, y, 2, (_nx, _ny, i) => !sea[i]);
     }
     function directConnector(a, b) {
       const steps = Math.max(1, Math.ceil(Math.hypot(a.x - b.x, a.y - b.y)));
@@ -1144,11 +1043,12 @@ export function finishMapOutput({
       }
     }
     const pairs = [];
-    for (let i = 0; i < endpoints.length; i++) {
-      const a = endpoints[i];
+    for (let i = 0; i < endpoints.length; i++) endpoints[i].id = i;
+    const endpointIndex = makeSpatialIndex(endpoints, 7);
+    for (const a of endpoints) {
       if (a.comp < 0) continue;
-      for (let j = i + 1; j < endpoints.length; j++) {
-        const b = endpoints[j];
+      for (const b of endpointIndex.near(a.x, a.y, 6.5)) {
+        if (b.id <= a.id) continue;
         if (b.comp < 0 || a.comp === b.comp) continue;
         if (a.group === b.group && a.pathIdx === b.pathIdx) continue;
         const d = Math.hypot(a.x - b.x, a.y - b.y);
@@ -1175,7 +1075,28 @@ export function finishMapOutput({
     return added;
   }
 
-  connectNearbyRoadEndpoints();
+
+  function finalizeOutputRoadTopology() {
+    // Build required municipal access before pruning so the prune pass can
+    // preserve those paths directly instead of deleting and re-adding them.
+    addMunicipalCenterLocalAccess();
+    const requiredStubsAdded = ensureAdminCenterRoadStubs();
+    const endpointConnectorsAdded = connectNearbyRoadEndpoints();
+    const prune = pruneIsolatedFinalRoadComponents();
+    const finalComponents = occupancyComponentsFromPathGroups(
+      [minorRoads, nationalRoads, externalRoads, ringRoads, expressways, externalExpressways],
+      { maxDistanceSq: 5, accept: (_x, _y, i) => !sea[i] }
+    ).count;
+    const debugLayers = transportDebug ? (transportDebug.layers || (transportDebug.layers = {})) : {};
+    debugLayers.finalOutputRoadTopology = {
+      components: finalComponents,
+      requiredStubsAdded,
+      endpointConnectorsAdded,
+      prune,
+    };
+    return debugLayers.finalOutputRoadTopology;
+  }
+  finalizeOutputRoadTopology();
 
   function renameInterchangesFromMunicipalities() {
     if (!interchanges?.length || !adminCenters?.length || !adminId) return 0;
@@ -1230,6 +1151,16 @@ export function finishMapOutput({
   nameDebug.maxDerivedPerBase = 0;
   const prefectureRegions = buildPrefectureRegions(prefectureRegionId, sea, nameFields, seed, usedNames, nameDebug, { modernCities, adminCenters });
   const regionalPrefectureBorders = adminRegionalPrefectureBorders || [];
+  // Municipal vectors are derived only after final prefecture IDs exist. This
+  // prevents prefecture edges from also being emitted as municipal borders in
+  // the initial map. The stage-level vectors remain useful during generation,
+  // but are not authoritative output data.
+  const adminBorders = extractAdminBorderSegments(adminId, humanRegionMask, prefectureRegionId, sea);
+  if (adminDebug) {
+    adminDebug.stageMunicipalBorderCount = Array.isArray(stageAdminBorders) ? stageAdminBorders.length : 0;
+    adminDebug.finalMunicipalBorderCount = adminBorders.length;
+    adminDebug.municipalBordersRebuiltFromFinalHierarchy = true;
+  }
   if (regionalDebug) {
     regionalDebug.finalRegionalPrefectureBorderCount = regionalPrefectureBorders.length;
     regionalDebug.regionalPrefectureBordersRebuiltFromFinalId = true;
@@ -1252,7 +1183,13 @@ export function finishMapOutput({
     ...crossings,
     ...adminCenters,
     ...externalGateways,
-  ].filter((p) => p.insidePrefecture || p.kind === "External Gateway");
+  ].filter((p) => (p.insidePrefecture || p.kind === "External Gateway") && typeof p.name === "string" && p.name.length > 0);
+  nameDebug.outputNamedEntityCount = [
+    ...villages, ...ports, ...crossings, ...passes, ...markets, ...castles, ...castleTowns,
+    ...modernCities, ...stations, ...industrialZones, ...interchanges, ...logisticsParks,
+    ...satelliteCities, ...newTowns, ...castleRuins, ...externalGateways, ...adminCenters,
+  ].filter((item) => item?.id && typeof item.name === "string" && item.name.length > 0).length;
+  nameDebug.totalGeneratedNameSelections = nameDebug.generatedNamesUsed + nameDebug.customNameListUsed + nameDebug.fallbackAttempts;
 
   return applyOutputOptions({
     width: MAP_W,
diff --git a/src/mapPatch.js b/src/mapPatch.js
new file mode 100644
index 0000000..882764d
--- /dev/null
+++ b/src/mapPatch.js
@@ -0,0 +1,8278 @@
+import { MAP_H, MAP_W, SIZE, MinHeap, circularAngleDistance, clamp, hash2, lerp, nowMs, smoothstep, valueNoise, walkGridPath, worldIndexOf } from "./mapUtils.js";
+import { generateMap, prepareProductionTerrain } from "./mapPipeline.js";
+import { LANDUSE } from "./landuseCodes.js";
+import { reconcileMunicipalMetadata, refreshPrefectureRegionsMetadata } from "./mapMunicipalCoherence.js";
+import { createPatchContext } from "./mapPatchContext.js";
+import { defaultCellFieldValue, isTypedCellField } from "./fieldSchema.js";
+
+export const PATCH_MIN_WIDTH = 48;
+export const PATCH_MIN_HEIGHT = 48;
+export const PATCH_MIN_AREA = 3000;
+
+const PATCH_MODE_AUTO = "auto";
+const PATCH_MODE_REGENERATION = "regeneration";
+const PATCH_MODE_EXPANSION = "expansion";
+
+const PATCH_EXPANSION_RATIO_THRESHOLD = 0.12;
+const PATCH_EXPANSION_OVERLAP_MIN = 20;
+const PATCH_EXPANSION_OVERLAP_MAX = 48;
+const PATCH_TERRAIN_CONTINUATION_DEPTH = 5;
+// Expansion is evaluated on a world-coordinate anchored logical grid.  These
+// are core ownership sizes, not candidate-map sizes: every core is sampled from
+// the same MAP_W x MAP_H candidate window centered on that canonical core.
+// Selection geometry therefore cannot move an already-existing tile window.
+const PATCH_EXPANSION_TILE_MAX_WIDTH = MAP_W;
+const PATCH_EXPANSION_TILE_MAX_HEIGHT = MAP_H;
+const PATCH_EXPANSION_TILE_OVERLAP = 28;
+// Keep enough shared core for terrain/admin continuity, but allow the overlap
+// to shrink modestly near a tile-count threshold. This prevents a one-cell
+// selection increase from unnecessarily adding an entire row/column of tiles.
+const PATCH_EXPANSION_TILE_MIN_OVERLAP = 16;
+
+const POINT_LAYER_KEYS = [
+  "villages", "geographicUrbanAnchors", "markets", "castles", "castleTowns", "castleRuins",
+  "ports", "crossings", "passes", "modernCities", "satelliteCities", "stations",
+  "interchanges", "industrialZones", "logisticsParks", "newTowns", "adminCenters",
+  "externalGateways", "prefectureRegions",
+];
+
+const PATH_LAYER_KEYS = [
+  "premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "externalRoads",
+  "railways", "branchRailways", "ringRailways", "externalRailways", "expressways", "externalExpressways",
+  "icAccessRoads", "mainRivers", "tributaryRivers", "smallStreams", "riverPaths",
+];
+
+const ROAD_LAYER_KEYS = new Set(["premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "externalRoads", "expressways", "externalExpressways", "icAccessRoads"]);
+const RAIL_LAYER_KEYS = new Set(["railways", "branchRailways", "ringRailways", "externalRailways"]);
+const RIVER_LAYER_KEYS = new Set(["mainRivers", "tributaryRivers", "smallStreams", "riverPaths"]);
+
+
+// Expansion quality policy. Search a small number of production-terrain crops
+// cheaply, then run the complete initial-generation pipeline once for the best
+// terrain. This avoids both empty-ocean patches and repeated full-pipeline cost.
+const PATCH_QUALITY_POLICY_VERSION = "step8-natural-overflow-stable-admin-v1";
+// Three inexpensive terrain candidates plus one complete production run keeps
+// normal expansion close to the initial generator while avoiding the 20–30 s
+// cost of repeatedly executing every human-geography stage.
+const PATCH_TERRAIN_QUALITY_ATTEMPTS = 3;
+const PATCH_FULL_QUALITY_ATTEMPTS = 1;
+const PATCH_EXPANSION_FRAME_SCALE = 1.72;
+const PATCH_EXPANSION_OUTER_REACH_RATIO = 0.82;
+// Alpha has two roles: visual seam blending and ownership of newly generated
+// world cells.  Newly generated cells must not be blended against the world's
+// default water backing field; once they enter the footprint, their production
+// terrain and metadata are authoritative.  Existing cells still use alpha for
+// a continuous overlap transition.
+const PATCH_GENERATED_FOOTPRINT_ALPHA = 0.08;
+const PATCH_FEATURE_REPLACE_ALPHA = 0.34;
+const PATCH_SEAM_ALPHA_GRADIENT = 0.16;
+
+const ID_FIELD_OFFSETS = new Map([
+  ["adminId", 100000],
+  ["municipalityId", 100000],
+  ["prefectureRegionId", 200000],
+  ["regionId", 300000],
+  ["naturalCompartmentId", 400000],
+  ["watershedId", 500000],
+]);
+
+const DISCRETE_FIELD_NAMES = new Set([
+  "sea", "ocean", "lake", "prefectureMask", "landMask", "landuse",
+  "adminId", "municipalityId", "prefectureRegionId", "regionId", "naturalCompartmentId", "watershedId",
+]);
+
+
+const ADMIN_CONTINUITY_FIELD_NAMES = new Set(["adminId", "municipalityId", "prefectureRegionId"]);
+const NATURAL_CONTINUITY_FIELD_NAMES = new Set(["regionId", "naturalCompartmentId", "watershedId"]);
+const CONTINUITY_FIELD_NAMES = new Set([...ADMIN_CONTINUITY_FIELD_NAMES, ...NATURAL_CONTINUITY_FIELD_NAMES]);
+
+const SKIP_CELL_FIELDS = new Set(["flowTo", "prefectureMask", "humanRegionMask"]);
+
+const STRICT_RESTORE_FIELD_EXEMPTIONS = new Set([
+  // Transport repair is allowed to operate over a wider neighborhood than the
+  // lasso itself.  Keep its derived influence fields in sync with repaired
+  // paths instead of restoring them to the pre-patch values outside the lasso.
+  "roadInfluence", "railInfluence2", "stationInfluence",
+]);
+
+function shouldStrictRestoreField(name) {
+  return !STRICT_RESTORE_FIELD_EXEMPTIONS.has(name);
+}
+
+function rectWidth(rect) {
+  return Math.max(0, Math.floor(rect.x1) - Math.floor(rect.x0));
+}
+
+function rectHeight(rect) {
+  return Math.max(0, Math.floor(rect.y1) - Math.floor(rect.y0));
+}
+
+function rectArea(rect) {
+  return rectWidth(rect) * rectHeight(rect);
+}
+
+function createPatchTimer(onProgress = null) {
+  const timings = [];
+  let mark = nowMs();
+  return {
+    timings,
+    mark(key, label = key) {
+      const t = nowMs();
+      const entry = { key, label, ms: Math.round((t - mark) * 10) / 10 };
+      timings.push(entry);
+      mark = t;
+      onProgress?.({ status: "done", ...entry, timings: timings.slice() });
+    },
+  };
+}
+
+function normalizeRect(rect) {
+  if (!rect) return null;
+  const x0 = Math.floor(Math.min(rect.x0, rect.x1));
+  const y0 = Math.floor(Math.min(rect.y0, rect.y1));
+  const x1 = Math.ceil(Math.max(rect.x0, rect.x1));
+  const y1 = Math.ceil(Math.max(rect.y0, rect.y1));
+  return { x0, y0, x1, y1 };
+}
+
+function isPolygonSelection(input) {
+  return !!input && Array.isArray(input.polygon) && input.polygon.length >= 3;
+}
+
+function clampPointToWorld(point, world) {
+  return {
+    x: clamp(Math.round(point.x ?? 0), 0, Math.max(0, (world?.width || 1) - 1)),
+    y: clamp(Math.round(point.y ?? 0), 0, Math.max(0, (world?.height || 1) - 1)),
+  };
+}
+
+function polygonBounds(polygon) {
+  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+  for (const p of polygon || []) {
+    if (!Number.isFinite(p?.x) || !Number.isFinite(p?.y)) continue;
+    minX = Math.min(minX, p.x);
+    minY = Math.min(minY, p.y);
+    maxX = Math.max(maxX, p.x);
+    maxY = Math.max(maxY, p.y);
+  }
+  if (!Number.isFinite(minX)) return null;
+  return { x0: Math.floor(minX), y0: Math.floor(minY), x1: Math.ceil(maxX + 1), y1: Math.ceil(maxY + 1) };
+}
+
+function polygonAreaCells(polygon) {
+  if (!polygon || polygon.length < 3) return 0;
+  let area = 0;
+  for (let i = 0; i < polygon.length; i++) {
+    const a = polygon[i];
+    const b = polygon[(i + 1) % polygon.length];
+    area += a.x * b.y - b.x * a.y;
+  }
+  return Math.abs(area) * 0.5;
+}
+
+function normalizeSelectionShape(input, world = null) {
+  if (!isPolygonSelection(input)) return normalizeRect(input);
+  const polygon = (input.polygon || []).map((p) => world ? clampPointToWorld(p, world) : { x: Math.round(p.x), y: Math.round(p.y) });
+  const bounds = polygonBounds(polygon);
+  if (!bounds) return null;
+  return {
+    kind: input.kind || 'lasso',
+    polygon,
+    areaCells: Math.max(1, Math.round(input.areaCells || polygonAreaCells(polygon))),
+    x0: bounds.x0,
+    y0: bounds.y0,
+    x1: bounds.x1,
+    y1: bounds.y1,
+  };
+}
+
+function pointInPolygon(px, py, polygon) {
+  let inside = false;
+  for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+    const xi = polygon[i].x + 0.5;
+    const yi = polygon[i].y + 0.5;
+    const xj = polygon[j].x + 0.5;
+    const yj = polygon[j].y + 0.5;
+    const denomRaw = yj - yi;
+    const denom = Math.abs(denomRaw) < 1e-6 ? (denomRaw < 0 ? -1e-6 : 1e-6) : denomRaw;
+    const intersect = ((yi > py) !== (yj > py)) && (px < ((xj - xi) * (py - yi)) / denom + xi);
+    if (intersect) inside = !inside;
+  }
+  return inside;
+}
+
+function pointSegmentDistance(px, py, ax, ay, bx, by) {
+  const dx = bx - ax;
+  const dy = by - ay;
+  const len2 = dx * dx + dy * dy;
+  if (len2 <= 1e-6) return Math.hypot(px - ax, py - ay);
+  const t = clamp(((px - ax) * dx + (py - ay) * dy) / len2, 0, 1);
+  return Math.hypot(px - (ax + dx * t), py - (ay + dy * t));
+}
+
+function distanceToPolygonEdge(px, py, polygon) {
+  let best = Infinity;
+  for (let i = 0; i < polygon.length; i++) {
+    const a = polygon[i];
+    const b = polygon[(i + 1) % polygon.length];
+    best = Math.min(best, pointSegmentDistance(px, py, a.x + 0.5, a.y + 0.5, b.x + 0.5, b.y + 0.5));
+  }
+  return best;
+}
+
+function insideRect(x, y, rect) {
+  return !!rect && x >= rect.x0 && y >= rect.y0 && x < rect.x1 && y < rect.y1;
+}
+
+function expandRect(rect, margin, world = null) {
+  return {
+    x0: Math.max(0, rect.x0 - margin),
+    y0: Math.max(0, rect.y0 - margin),
+    x1: Math.min(world?.width ?? Infinity, rect.x1 + margin),
+    y1: Math.min(world?.height ?? Infinity, rect.y1 + margin),
+  };
+}
+
+function distanceToRectEdge(x, y, rect) {
+  return Math.min(x - rect.x0, y - rect.y0, rect.x1 - 1 - x, rect.y1 - 1 - y);
+}
+
+function ensureWorldField(world, name, source) {
+  if (!source || !ArrayBuffer.isView(source)) return null;
+  const Constructor = source.constructor;
+  const expected = world.width * world.height;
+  if (!world.fields[name] || world.fields[name].length !== expected) {
+    world.fields[name] = new Constructor(expected);
+    const fallback = defaultCellFieldValue(name, Constructor);
+    if (fallback !== 0) world.fields[name].fill(fallback);
+  }
+  return world.fields[name];
+}
+
+function isWorldCellField(world, value) {
+  return isTypedCellField(value, (world?.width || 0) * (world?.height || 0));
+}
+
+function captureStrictSelectionFieldSnapshot(world, rects, seed = 0) {
+  if (!world?.fields || !rects?.writeRect) return null;
+  // Regeneration snapshots every repairable field. Expansion only snapshots the
+  // administrative identity fields outside its writable alpha footprint; this
+  // prevents global topology cleanup from erasing old prefectures without paying
+  // the memory and copy cost of a full-field expansion snapshot.
+  const rect = rects.repairRect || rects.writeRect;
+  const width = rectWidth(rect);
+  const height = rectHeight(rect);
+  const fields = new Map();
+  const expansionProtected = new Set(["adminId", "municipalityId", "prefectureRegionId", "prefectureMask"]);
+  for (const [name, field] of Object.entries(world.fields)) {
+    if (!shouldStrictRestoreField(name) || !isWorldCellField(world, field)) continue;
+    if (!rects.strictSelectionMask && !expansionProtected.has(name)) continue;
+    const data = new field.constructor(width * height);
+    for (let y = rect.y0; y < rect.y1; y++) {
+      for (let x = rect.x0; x < rect.x1; x++) {
+        const wi = worldIndexOf(world, x, y);
+        if (wi >= 0) data[(y - rect.y0) * width + (x - rect.x0)] = field[wi];
+      }
+    }
+    fields.set(name, data);
+  }
+  return { rect: { ...rect }, width, height, fields, seed };
+}
+
+function restoreOutsideStrictSelectionFields(world, rects, snapshot, seed = 0) {
+  if (!snapshot) return { strictMaskCellsRestored: 0, strictMaskValuesRestored: 0 };
+  const rect = snapshot.rect;
+  let strictMaskCellsRestored = 0;
+  let strictMaskValuesRestored = 0;
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const protectExistingExpansionCell = rects?.patchMode === PATCH_MODE_EXPANSION && wasGeneratedAt(rects, x, y);
+      if (!protectExistingExpansionCell && patchAlpha(x, y, rects, seed) > 0.005) continue;
+      let cellChanged = false;
+      const li = (y - rect.y0) * snapshot.width + (x - rect.x0);
+      const wi = worldIndexOf(world, x, y);
+      if (wi < 0) continue;
+      for (const [name, oldData] of snapshot.fields) {
+        const field = world.fields?.[name];
+        if (!isWorldCellField(world, field)) continue;
+        const oldValue = oldData[li];
+        if (field[wi] !== oldValue) {
+          field[wi] = oldValue;
+          strictMaskValuesRestored++;
+          cellChanged = true;
+        }
+      }
+      if (cellChanged) strictMaskCellsRestored++;
+    }
+  }
+  return { strictMaskCellsRestored, strictMaskValuesRestored };
+}
+
+
+function cloneTransactionValue(value) {
+  if (typeof structuredClone === "function") return structuredClone(value);
+  if (ArrayBuffer.isView(value)) return value.slice();
+  if (Array.isArray(value)) return value.map(cloneTransactionValue);
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, child] of Object.entries(value)) out[key] = cloneTransactionValue(child);
+    return out;
+  }
+  return value;
+}
+
+// sourceMap contains the original full-map typed fields as immutable reference data.
+// Patch code replaces those fields rather than editing them in place, so cloning every
+// typed array here only duplicated tens of megabytes per attempt. Clone mutable
+// metadata recursively, while sharing immutable typed-array payloads.
+function cloneTransactionSourceMap(value, seen = new WeakMap()) {
+  if (value == null || typeof value !== "object") return value;
+  if (ArrayBuffer.isView(value)) return value;
+  if (seen.has(value)) return seen.get(value);
+  if (value instanceof Date) return new Date(value.getTime());
+  if (value instanceof Map) {
+    const out = new Map();
+    seen.set(value, out);
+    for (const [key, child] of value) out.set(cloneTransactionSourceMap(key, seen), cloneTransactionSourceMap(child, seen));
+    return out;
+  }
+  if (value instanceof Set) {
+    const out = new Set();
+    seen.set(value, out);
+    for (const child of value) out.add(cloneTransactionSourceMap(child, seen));
+    return out;
+  }
+  if (Array.isArray(value)) {
+    const out = [];
+    seen.set(value, out);
+    for (const child of value) out.push(cloneTransactionSourceMap(child, seen));
+    return out;
+  }
+  const out = {};
+  seen.set(value, out);
+  for (const [key, child] of Object.entries(value)) out[key] = cloneTransactionSourceMap(child, seen);
+  return out;
+}
+
+function capturePatchTransactionSnapshot(world, options = {}) {
+  if (!world) return null;
+  const lightweight = options.lightweight === true;
+  return {
+    lightweight,
+    fields: new Map(),
+    fieldNames: new Set(Object.keys(world.fields || {})),
+    fieldRefs: new Map(Object.entries(world.fields || {}).filter(([, field]) => ArrayBuffer.isView(field))),
+    fieldRect: null,
+    width: world.width,
+    height: world.height,
+    originX: world.originX,
+    originY: world.originY,
+    sourceWidth: world.sourceWidth,
+    sourceHeight: world.sourceHeight,
+    sourceMapRef: lightweight ? null : (world.sourceMap || null),
+    sourceMap: lightweight ? null : cloneTransactionSourceMap(world.sourceMap || {}),
+    generatedRects: lightweight ? null : cloneTransactionValue(world.generatedRects || []),
+    invalidatedRects: lightweight ? null : cloneTransactionValue(world.invalidatedRects || []),
+    humanPatchHistory: lightweight ? null : cloneTransactionValue(world.humanPatchHistory || []),
+    lastPatchResult: lightweight ? null : cloneTransactionValue(world.lastPatchResult ?? null),
+    patchGenerationSerial: world.patchGenerationSerial || 0,
+    seaLevel: world.seaLevel,
+  };
+}
+
+function preparePatchTransactionFields(snapshot, world, rect) {
+  if (!snapshot || !world?.fields || !rect || snapshot.fieldRect) return snapshot;
+  const clipped = {
+    x0: Math.max(0, Math.floor(rect.x0)),
+    y0: Math.max(0, Math.floor(rect.y0)),
+    x1: Math.min(world.width, Math.ceil(rect.x1)),
+    y1: Math.min(world.height, Math.ceil(rect.y1)),
+  };
+  const width = Math.max(0, clipped.x1 - clipped.x0);
+  const height = Math.max(0, clipped.y1 - clipped.y0);
+  snapshot.fieldRect = clipped;
+  snapshot.fieldWidth = width;
+  snapshot.fieldHeight = height;
+  if (!width || !height) return snapshot;
+  for (const [name, field] of Object.entries(world.fields)) {
+    if (!isWorldCellField(world, field)) continue;
+    const data = new field.constructor(width * height);
+    for (let y = clipped.y0; y < clipped.y1; y++) {
+      const srcStart = y * world.width + clipped.x0;
+      const dstStart = (y - clipped.y0) * width;
+      data.set(field.subarray(srcStart, srcStart + width), dstStart);
+    }
+    snapshot.fields.set(name, { constructor: field.constructor, data });
+  }
+  return snapshot;
+}
+
+function transactionFieldValue(snapshot, name, x, y) {
+  const entry = snapshot?.fields?.get(name);
+  const rect = snapshot?.fieldRect;
+  if (!entry || !rect || x < rect.x0 || y < rect.y0 || x >= rect.x1 || y >= rect.y1) return undefined;
+  return entry.data[(y - rect.y0) * snapshot.fieldWidth + (x - rect.x0)];
+}
+
+function restorePatchTransactionSnapshot(world, snapshot) {
+  if (!world || !snapshot) return;
+  const dimensionsChanged = world.width !== snapshot.width || world.height !== snapshot.height
+    || world.originX !== snapshot.originX || world.originY !== snapshot.originY;
+  if (dimensionsChanged) {
+    // World expansion replaces field arrays instead of mutating the originals,
+    // so the pre-attempt references are the cheapest exact rollback path.
+    world.width = snapshot.width;
+    world.height = snapshot.height;
+    world.originX = snapshot.originX;
+    world.originY = snapshot.originY;
+    world.sourceWidth = snapshot.sourceWidth;
+    world.sourceHeight = snapshot.sourceHeight;
+    world.fields = Object.fromEntries(snapshot.fieldRefs);
+  } else if (snapshot.fieldRect) {
+    const rect = snapshot.fieldRect;
+    for (const [name, entry] of snapshot.fields) {
+      let current = world.fields?.[name];
+      if (!ArrayBuffer.isView(current) || current.constructor !== entry.constructor || current.length !== world.width * world.height) {
+        current = snapshot.fieldRefs.get(name);
+        if (!current) continue;
+        world.fields[name] = current;
+      }
+      for (let y = rect.y0; y < rect.y1; y++) {
+        const dstStart = y * world.width + rect.x0;
+        const srcStart = (y - rect.y0) * snapshot.fieldWidth;
+        current.set(entry.data.subarray(srcStart, srcStart + snapshot.fieldWidth), dstStart);
+      }
+    }
+    for (const name of Object.keys(world.fields || {})) {
+      if (!snapshot.fieldNames.has(name)) delete world.fields[name];
+    }
+  }
+
+  if (!snapshot.lightweight) {
+    const target = snapshot.sourceMapRef || world.sourceMap || {};
+    for (const key of Object.keys(target)) delete target[key];
+    Object.assign(target, cloneTransactionSourceMap(snapshot.sourceMap || {}));
+    world.sourceMap = target;
+    world.generatedRects = cloneTransactionValue(snapshot.generatedRects || []);
+    world.invalidatedRects = cloneTransactionValue(snapshot.invalidatedRects || []);
+    world.humanPatchHistory = cloneTransactionValue(snapshot.humanPatchHistory || []);
+    world.lastPatchResult = cloneTransactionValue(snapshot.lastPatchResult);
+    world.patchGenerationSerial = snapshot.patchGenerationSerial;
+    world.seaLevel = snapshot.seaLevel;
+  }
+}
+
+function clipPatchRect(rect, world) {
+  const normalized = normalizeSelectionShape(rect, world);
+  if (!normalized || !world) return null;
+  if (isPolygonSelection(normalized)) return normalized;
+  return {
+    x0: Math.min(Math.max(normalized.x0, 0), world.width),
+    y0: Math.min(Math.max(normalized.y0, 0), world.height),
+    x1: Math.min(Math.max(normalized.x1, 0), world.width),
+    y1: Math.min(Math.max(normalized.y1, 0), world.height),
+  };
+}
+
+export function validatePatchRect(rect, world, options = {}) {
+  const clipped = clipPatchRect(rect, world);
+  if (!clipped) return { ok: false, rect: null, reason: "No selected area." };
+  const width = rectWidth(clipped);
+  const height = rectHeight(clipped);
+  const area = isPolygonSelection(clipped) ? Math.max(1, Math.round(clipped.areaCells || polygonAreaCells(clipped.polygon))) : width * height;
+  const allowSmall = options?.allowSmall === true;
+  if (!allowSmall && (width < PATCH_MIN_WIDTH || height < PATCH_MIN_HEIGHT)) {
+    const parts = [];
+    if (width < PATCH_MIN_WIDTH) parts.push(`minimum width ${PATCH_MIN_WIDTH} cells`);
+    if (height < PATCH_MIN_HEIGHT) parts.push(`minimum height ${PATCH_MIN_HEIGHT} cells`);
+    return {
+      ok: false,
+      rect: clipped,
+      width,
+      height,
+      area,
+      reason: `Selection is too small: ${parts.join(", ")} required. Current ${width} x ${height} cells, ${area.toLocaleString()} cells total.`,
+    };
+  }
+  if (!allowSmall && area < PATCH_MIN_AREA) {
+    return {
+      ok: false,
+      rect: clipped,
+      width,
+      height,
+      area,
+      reason: `Selection area is too small: minimum area ${PATCH_MIN_AREA.toLocaleString()} cells required. Current ${area.toLocaleString()} cells.`,
+    };
+  }
+  return { ok: true, rect: clipped, width, height, area, reason: "" };
+}
+
+
+function generatedFootprintContains(footprint, x, y) {
+  if (!footprint || !insideRect(x, y, footprint)) return false;
+  const row = footprint.rowRuns?.[y - footprint.y0];
+  if (!Array.isArray(row)) return false;
+  for (let i = 0; i + 1 < row.length; i += 2) {
+    if (x >= row[i] && x < row[i + 1]) return true;
+    if (x < row[i]) break;
+  }
+  return false;
+}
+
+function buildGeneratedFootprint(rects, seed = 0, threshold = PATCH_GENERATED_FOOTPRINT_ALPHA) {
+  const rect = rects?.writeRect;
+  if (!rect) return null;
+  const rowRuns = new Array(rectHeight(rect));
+  let cellCount = 0;
+  for (let y = rect.y0; y < rect.y1; y++) {
+    const runs = [];
+    let runStart = -1;
+    for (let x = rect.x0; x <= rect.x1; x++) {
+      let active = false;
+      if (x < rect.x1) {
+        if (rects?.patchMode === PATCH_MODE_EXPANSION) {
+          // Coverage must describe every previously ungenerated cell the patch is
+          // allowed to mutate, not merely cells above an alpha threshold.  The
+          // selected core is writable even when a noisy signed-distance alpha is
+          // below PATCH_GENERATED_FOOTPRINT_ALPHA, so threshold-only footprints
+          // left already-mutated cells classified as ungenerated on the next
+          // expansion.
+          active = patchCellIsNew(rects, x, y) && patchTerrainWritable(rects, x, y, seed);
+        } else {
+          active = patchAlpha(x, y, rects, seed) >= threshold;
+        }
+      }
+      if (active && runStart < 0) runStart = x;
+      else if (!active && runStart >= 0) {
+        runs.push(runStart, x);
+        cellCount += x - runStart;
+        runStart = -1;
+      }
+    }
+    rowRuns[y - rect.y0] = runs;
+  }
+  return {
+    version: rects?.patchMode === PATCH_MODE_EXPANSION ? 2 : 1,
+    strategy: rects?.patchMode === PATCH_MODE_EXPANSION ? "writable-new-cell-mask" : "alpha-threshold",
+    x0: rect.x0,
+    y0: rect.y0,
+    x1: rect.x1,
+    y1: rect.y1,
+    threshold,
+    cellCount,
+    rowRuns,
+  };
+}
+
+function restoreOutsideExpansionGeneratedFootprint(world, rects, transactionSnapshot, footprint) {
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || !transactionSnapshot?.fields || !footprint) {
+    return { expansionFootprintCellsRestored: 0, expansionFootprintValuesRestored: 0, expansionFootprintFieldsRestored: 0 };
+  }
+  const rect = rects.repairRect || rects.writeRect;
+  let expansionFootprintCellsRestored = 0;
+  let expansionFootprintValuesRestored = 0;
+  const fieldsTouched = new Set();
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      // Previously generated cells belong to older records and are governed by
+      // the seam/boundary contract.  This guard is specifically for backing
+      // world cells that were ungenerated before this attempt.
+      if (wasGeneratedAt(rects, x, y) || generatedFootprintContains(footprint, x, y)) continue;
+      const wi = worldIndexOf(world, x, y);
+      if (wi < 0) continue;
+      let cellChanged = false;
+      for (const [name, oldEntry] of transactionSnapshot.fields) {
+        const field = world.fields?.[name];
+        if (!isWorldCellField(world, field) || field.constructor !== oldEntry.constructor) continue;
+        const oldValue = transactionFieldValue(transactionSnapshot, name, x, y);
+        if (oldValue === undefined) continue;
+        if (!Object.is(field[wi], oldValue)) {
+          field[wi] = oldValue;
+          expansionFootprintValuesRestored++;
+          fieldsTouched.add(name);
+          cellChanged = true;
+        }
+      }
+      if (cellChanged) expansionFootprintCellsRestored++;
+    }
+  }
+  return {
+    expansionFootprintCellsRestored,
+    expansionFootprintValuesRestored,
+    expansionFootprintFieldsRestored: fieldsTouched.size,
+    expansionFootprintRestoredFieldNames: [...fieldsTouched].sort(),
+  };
+}
+
+function auditExpansionGeneratedFootprint(world, rects, transactionSnapshot, footprint) {
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || !transactionSnapshot?.fields || !footprint) {
+    return { expansionFootprintEscapedCells: 0, expansionFootprintEscapedValues: 0, expansionFootprintEscapedFields: [] };
+  }
+  const rect = rects.repairRect || rects.writeRect;
+  let expansionFootprintEscapedCells = 0;
+  let expansionFootprintEscapedValues = 0;
+  const escapedFields = new Set();
+  let firstEscape = null;
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      if (wasGeneratedAt(rects, x, y) || generatedFootprintContains(footprint, x, y)) continue;
+      const wi = worldIndexOf(world, x, y);
+      if (wi < 0) continue;
+      let cellEscaped = false;
+      for (const [name, oldEntry] of transactionSnapshot.fields) {
+        const field = world.fields?.[name];
+        if (!isWorldCellField(world, field) || field.constructor !== oldEntry.constructor) continue;
+        const oldValue = transactionFieldValue(transactionSnapshot, name, x, y);
+        if (oldValue === undefined) continue;
+        if (!Object.is(field[wi], oldValue)) {
+          expansionFootprintEscapedValues++;
+          escapedFields.add(name);
+          cellEscaped = true;
+          if (!firstEscape) firstEscape = { x, y, field: name, before: oldValue, after: field[wi] };
+        }
+      }
+      if (cellEscaped) expansionFootprintEscapedCells++;
+    }
+  }
+  return {
+    expansionFootprintEscapedCells,
+    expansionFootprintEscapedValues,
+    expansionFootprintEscapedFields: [...escapedFields].sort(),
+    expansionFootprintFirstEscape: firstEscape,
+  };
+}
+
+function generatedRecordContains(record, x, y) {
+  if (!record) return false;
+  // Expansion writes a noise-displaced natural overflow beyond the user's
+  // lasso.  The exact alpha footprint is authoritative for future coverage;
+  // otherwise a later patch treats the overflow as ungenerated and rewrites the
+  // same coastline, terrain and administration.
+  if (record.generatedFootprint) return generatedFootprintContains(record.generatedFootprint, x, y);
+  const shape = record.selectionShape;
+  if (shape?.polygon?.length >= 3) {
+    const bounds = shape.x0 != null ? shape : polygonBounds(shape.polygon);
+    if (bounds && !insideRect(x, y, bounds)) return false;
+    return pointInPolygon(x + 0.5, y + 0.5, shape.polygon);
+  }
+  const rect = record.coreRect || record;
+  return insideRect(x, y, rect);
+}
+
+function cellWasGeneratedBefore(world, x, y) {
+  if (!world || x < 0 || y < 0 || x >= world.width || y >= world.height) return false;
+  for (const record of world.generatedRects || []) {
+    if (generatedRecordContains(record, x, y)) return true;
+  }
+  return false;
+}
+
+function selectionCoverageStats(world, selection) {
+  if (!world || !selection) return { selectedCells: 0, generatedCells: 0, ungeneratedCells: 0, ungeneratedRatio: 0 };
+  let selectedCells = 0;
+  let generatedCells = 0;
+  const polygon = selection.polygon;
+  for (let y = selection.y0; y < selection.y1; y++) {
+    for (let x = selection.x0; x < selection.x1; x++) {
+      if (polygon?.length >= 3 && !pointInPolygon(x + 0.5, y + 0.5, polygon)) continue;
+      selectedCells++;
+      if (cellWasGeneratedBefore(world, x, y)) generatedCells++;
+    }
+  }
+  const ungeneratedCells = Math.max(0, selectedCells - generatedCells);
+  return {
+    selectedCells,
+    generatedCells,
+    ungeneratedCells,
+    ungeneratedRatio: ungeneratedCells / Math.max(1, selectedCells),
+  };
+}
+
+function resolvePatchMode(userRect, world, requestedMode = PATCH_MODE_AUTO) {
+  const selection = normalizeSelectionShape(userRect, world);
+  const coverage = selectionCoverageStats(world, selection);
+  const normalized = String(requestedMode || PATCH_MODE_AUTO).toLowerCase();
+  const explicit = normalized === PATCH_MODE_REGENERATION || normalized === PATCH_MODE_EXPANSION;
+  const mode = explicit
+    ? normalized
+    : coverage.ungeneratedRatio >= PATCH_EXPANSION_RATIO_THRESHOLD
+      ? PATCH_MODE_EXPANSION
+      : PATCH_MODE_REGENERATION;
+  return { mode, requestedMode: explicit ? normalized : PATCH_MODE_AUTO, autoDetected: !explicit, coverage };
+}
+
+function buildGeneratedCoverageSnapshot(world, rect) {
+  if (!world || !rect) return null;
+  const width = rectWidth(rect);
+  const height = rectHeight(rect);
+  const data = new Uint8Array(width * height);
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      data[(y - rect.y0) * width + (x - rect.x0)] = cellWasGeneratedBefore(world, x, y) ? 1 : 0;
+    }
+  }
+  return { rect: { ...rect }, width, height, data };
+}
+
+
+function binaryDistanceField(coverage, sourceValue, maxDistance = 48) {
+  if (!coverage) return null;
+  const size = coverage.width * coverage.height;
+  const distance = new Uint8Array(size);
+  distance.fill(255);
+  const queue = new Int32Array(size);
+  let head = 0;
+  let tail = 0;
+  for (let i = 0; i < size; i++) {
+    if (coverage.data[i] === sourceValue) {
+      distance[i] = 0;
+      queue[tail++] = i;
+    }
+  }
+  while (head < tail) {
+    const i = queue[head++];
+    const d = distance[i];
+    if (d >= maxDistance) continue;
+    const x = i % coverage.width;
+    const y = Math.floor(i / coverage.width);
+    for (const ni of [
+      x > 0 ? i - 1 : -1,
+      x + 1 < coverage.width ? i + 1 : -1,
+      y > 0 ? i - coverage.width : -1,
+      y + 1 < coverage.height ? i + coverage.width : -1,
+    ]) {
+      if (ni < 0 || distance[ni] <= d + 1) continue;
+      distance[ni] = d + 1;
+      queue[tail++] = ni;
+    }
+  }
+  return distance;
+}
+
+function buildCoverageDistanceSnapshot(coverage, maxDistance = 48) {
+  if (!coverage) return null;
+  return {
+    rect: coverage.rect,
+    width: coverage.width,
+    height: coverage.height,
+    distanceToGenerated: binaryDistanceField(coverage, 1, maxDistance),
+    distanceToUngenerated: binaryDistanceField(coverage, 0, maxDistance),
+  };
+}
+
+function coverageDistanceAt(rects, x, y, target = "generated") {
+  const distances = rects?._coverageDistances;
+  if (!distances || !insideRect(x, y, distances.rect)) return 255;
+  const i = (y - distances.rect.y0) * distances.width + (x - distances.rect.x0);
+  return target === "ungenerated" ? distances.distanceToUngenerated[i] : distances.distanceToGenerated[i];
+}
+
+function wasGeneratedAt(rects, x, y) {
+  const coverage = rects?._generatedCoverage;
+  if (!coverage || !insideRect(x, y, coverage.rect)) return false;
+  return !!coverage.data[(y - coverage.rect.y0) * coverage.width + (x - coverage.rect.x0)];
+}
+
+export function buildPatchRects(userRect, world = null, options = {}) {
+  const coreRect = normalizeSelectionShape(userRect, world);
+  const width = rectWidth(coreRect);
+  const height = rectHeight(coreRect);
+  const shortSide = Math.max(1, Math.min(width, height));
+  const polygonSelection = isPolygonSelection(coreRect);
+  const modeResolution = options.modeResolution || resolvePatchMode(coreRect, world, options.patchMode);
+  const patchMode = modeResolution.mode;
+  const desiredWrite = Math.min(96, Math.max(28, Math.floor(shortSide * 0.42)));
+  const maxBySource = Math.max(0, Math.floor(Math.min((MAP_W - width) / 2, (MAP_H - height) / 2)));
+  const rawWriteMargin = Math.max(0, Math.min(desiredWrite, maxBySource));
+  const desiredRepair = Math.min(120, rawWriteMargin + Math.max(8, Math.floor(shortSide * 0.12)));
+  const repairMargin = Math.max(rawWriteMargin, Math.min(desiredRepair, maxBySource));
+
+  const expansionOverlap = patchMode === PATCH_MODE_EXPANSION
+    ? Math.max(PATCH_EXPANSION_OVERLAP_MIN, Math.min(PATCH_EXPANSION_OVERLAP_MAX, Math.floor(shortSide * 0.26)))
+    : 0;
+  const expansionCornerTaper = patchMode === PATCH_MODE_EXPANSION
+    ? Math.max(12, Math.min(34, Math.round(expansionOverlap * 0.72)))
+    : 0;
+  const writeMargin = patchMode === PATCH_MODE_EXPANSION
+    ? expansionOverlap
+    : polygonSelection
+      ? Math.max(4, Math.min(rawWriteMargin, Math.floor(shortSide * 0.20)))
+      : rawWriteMargin;
+
+  // Regeneration is a strict interior edit. Expansion owns the selected
+  // ungenerated area and receives a narrow old-side overlap corridor so terrain
+  // and transport can be solved across a shared seam instead of meeting at a
+  // one-sided lasso edge.
+  const writeRect = patchMode === PATCH_MODE_EXPANSION
+    ? expandRect(coreRect, expansionOverlap + expansionCornerTaper, world)
+    : polygonSelection
+      ? { x0: coreRect.x0, y0: coreRect.y0, x1: coreRect.x1, y1: coreRect.y1 }
+      : expandRect(coreRect, writeMargin, world);
+  const repairRect = expandRect(writeRect, Math.max(repairMargin, expansionOverlap + 10), world);
+  const longSide = Math.max(width, height);
+  const diagonal = Math.hypot(width, height);
+  const transportReachMargin = Math.max(
+    repairMargin + 72,
+    Math.min(420, Math.max(160, repairMargin + Math.floor(diagonal * 0.45), Math.floor(longSide * 0.68)))
+  );
+  const transportReachRect = expandRect(writeRect, transportReachMargin, world);
+  const rects = {
+    coreRect,
+    writeRect,
+    repairRect,
+    contextRect: repairRect,
+    transportReachRect,
+    blendRect: coreRect,
+    userRect: writeRect,
+    selectedRect: coreRect,
+    selectionShape: polygonSelection ? coreRect : null,
+    strictSelectionMask: patchMode === PATCH_MODE_REGENERATION && polygonSelection,
+    expansionSelectionMask: patchMode === PATCH_MODE_EXPANSION && polygonSelection,
+    patchMode,
+    patchModeRequested: modeResolution.requestedMode,
+    patchModeAutoDetected: modeResolution.autoDetected,
+    coverageStats: modeResolution.coverage,
+    expansionOverlap,
+    expansionCornerTaper,
+    writeMargin,
+    repairMargin,
+    transportReachMargin,
+    outerMargin: writeMargin,
+    innerMargin: 0,
+  };
+  const generatedCoverage = options._generatedCoverageBaseline || buildGeneratedCoverageSnapshot(
+    world,
+    expandRect(writeRect, Math.max(PATCH_TERRAIN_CONTINUATION_DEPTH + 2, expansionOverlap + 2), world)
+  );
+  Object.defineProperty(rects, "_generatedCoverage", {
+    value: generatedCoverage,
+    enumerable: false,
+    configurable: true,
+  });
+  Object.defineProperty(rects, "_coverageDistances", {
+    value: buildCoverageDistanceSnapshot(generatedCoverage, Math.max(48, expansionOverlap + 4)),
+    enumerable: false,
+    configurable: true,
+  });
+  Object.defineProperty(rects, "_worldOriginX", { value: Math.round(world?.originX || 0), enumerable: false, configurable: true });
+  Object.defineProperty(rects, "_worldOriginY", { value: Math.round(world?.originY || 0), enumerable: false, configurable: true });
+  return rects;
+}
+
+function patchWorldNoise(rects, x, y, seed, scale) {
+  return valueNoise(
+    x - Math.round(rects?._worldOriginX || 0),
+    y - Math.round(rects?._worldOriginY || 0),
+    seed,
+    scale
+  );
+}
+
+function computePatchAlpha(x, y, rects, seed = 0) {
+  const writeRect = rects.writeRect || rects.userRect;
+  if (!insideRect(x, y, writeRect)) return 0;
+  const margin = Math.max(1, rects.writeMargin || 1);
+  const low = patchWorldNoise(rects, x, y, seed ^ 0x7153a9d1, 18) - 0.5;
+  const mid = patchWorldNoise(rects, x, y, seed ^ 0x9e3779b9, 7) - 0.5;
+  const shape = rects.selectionShape;
+  if (shape?.polygon?.length >= 3) {
+    const px = x + 0.5;
+    const py = y + 0.5;
+    const inside = pointInPolygon(px, py, shape.polygon);
+    const dist = distanceToPolygonEdge(px, py, shape.polygon);
+    const feather = Math.max(6, Math.min(margin, 24));
+    const noisyDist = dist + low * Math.min(2.2, feather * 0.12) + mid * Math.min(1.1, feather * 0.06);
+
+    if (rects.patchMode === PATCH_MODE_EXPANSION) {
+      const overlap = Math.max(4, rects.expansionOverlap || feather);
+      const generated = wasGeneratedAt(rects, x, y);
+      const frontierDistance = generated
+        ? coverageDistanceAt(rects, x, y, "ungenerated")
+        : coverageDistanceAt(rects, x, y, "generated");
+
+      if (!generated) {
+        // Separate footprint ownership from old/new seam interpolation.  A new
+        // cell near the old-world frontier starts at alpha 0.5 and rises
+        // continuously to 1.0; the neighboring old cell also approaches 0.5.
+        // Field copying later treats owned new cells as authoritative, so this
+        // alpha no longer blends production land against default backing water.
+        const macro = (patchWorldNoise(rects, x, y, seed ^ 0x4f1bbcdc, 61) - 0.5) * feather * 1.46;
+        const regional = (patchWorldNoise(rects, x, y, seed ^ 0xa24baed5, 27) - 0.5) * feather * 0.82;
+        const detail = (patchWorldNoise(rects, x, y, seed ^ 0x9fb21c65, 11) - 0.5) * feather * 0.28;
+        const signedDistance = inside ? dist : -dist;
+        const naturalDepth = signedDistance + macro + regional + detail;
+        const outwardReach = Math.max(5, Math.min(overlap, feather * PATCH_EXPANSION_OUTER_REACH_RATIO));
+        const transitionDepth = Math.max(5, Math.min(overlap, Math.round(overlap * 0.68)));
+        const cornerTaper = Math.max(6, rects.expansionCornerTaper || Math.round(overlap * 0.5));
+        const shapeProximity = inside || dist <= outwardReach
+          ? 1
+          : 1 - smoothstep(clamp((dist - outwardReach) / cornerTaper));
+        // One signed-distance transfer is used on both sides of the lasso.
+        // The former inside=1/outside=noise split introduced a one-cell alpha
+        // step exactly along freehand chords, which then propagated into coast,
+        // relief, and administrative boundaries.
+        const naturalScale = Math.max(3, outwardReach * 0.72);
+        let shapeAlpha = smoothstep(clamp(0.5 + naturalDepth / (naturalScale * 2)));
+        if (!inside) {
+          if (dist > outwardReach + cornerTaper) shapeAlpha = 0;
+          else shapeAlpha *= shapeProximity;
+          if (shapeAlpha <= 0 && (frontierDistance > transitionDepth || shapeProximity <= 0)) return 0;
+        }
+        const frontierAlpha = frontierDistance >= 255
+          ? 1
+          : 0.5 + 0.5 * smoothstep(clamp((frontierDistance - 1) / Math.max(1, transitionDepth - 1)));
+        const frontierSupport = frontierDistance <= transitionDepth
+          ? 0.5 * (1 - smoothstep(clamp((frontierDistance - 1) / Math.max(1, transitionDepth - 1)))) * shapeProximity
+          : 0;
+        // The freehand boundary/noise may not cut a notch directly against an
+        // existing generated edge.  A decaying frontier collar preserves land
+        // and terrain continuation even when the user lasso barely overlaps the
+        // old map or its simplified polygon has a straight chord.
+        return clamp(Math.max(Math.min(shapeAlpha, frontierAlpha), frontierSupport));
+      }
+
+      if (generated && frontierDistance <= overlap) {
+        // The old side converges to the same 0.5 value at the frontier.  Along
+        // lasso corners the overlap also tapers by polygon distance, preventing
+        // the support collar from ending as a vertical/horizontal wall at the
+        // implementation write rectangle.
+        const transitionDepth = Math.max(5, Math.min(overlap, Math.round(overlap * 0.68)));
+        const outwardReach = Math.max(5, Math.min(overlap, feather * PATCH_EXPANSION_OUTER_REACH_RATIO));
+        const cornerTaper = Math.max(6, rects.expansionCornerTaper || Math.round(overlap * 0.5));
+        const shapeProximity = inside || dist <= outwardReach
+          ? 1
+          : 1 - smoothstep(clamp((dist - outwardReach) / cornerTaper));
+        return clamp(0.5 * (1 - smoothstep(clamp((frontierDistance - 1) / Math.max(1, transitionDepth - 1)))) * shapeProximity);
+      }
+      return 0;
+    }
+
+    if (!inside) return 0;
+    // Regeneration remains a strict one-sided lasso edit.
+    return clamp(smoothstep(clamp((noisyDist - 0.35) / feather)));
+  }
+  const edge = distanceToRectEdge(x, y, writeRect);
+  const noisyEdge = edge + low * margin * 0.42 + mid * margin * 0.16;
+  const base = smoothstep(clamp(noisyEdge / margin));
+  // Keep the expanded repair band as the actual seam.  The user's selected core
+  // is still dominant, but the write edge is irregular, so coastlines and land-use
+  // no longer inherit the rectangular user selection as a hard boundary.
+  return clamp(base);
+}
+
+function getPatchAlphaCache(rects, seed = 0) {
+  const writeRect = rects?.writeRect || rects?.userRect;
+  if (!writeRect) return null;
+  const width = rectWidth(writeRect);
+  const height = rectHeight(writeRect);
+  const existing = rects.patchAlphaCache;
+  if (
+    existing
+    && existing.seed === seed
+    && existing.width === width
+    && existing.height === height
+    && existing.x0 === writeRect.x0
+    && existing.y0 === writeRect.y0
+  ) return existing;
+
+  const data = new Float32Array(width * height);
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      data[y * width + x] = computePatchAlpha(writeRect.x0 + x, writeRect.y0 + y, rects, seed);
+    }
+  }
+  rects.patchAlphaCache = { seed, width, height, x0: writeRect.x0, y0: writeRect.y0, data };
+  return rects.patchAlphaCache;
+}
+
+function patchAlpha(x, y, rects, seed = 0) {
+  const writeRect = rects?.writeRect || rects?.userRect;
+  if (!writeRect || !insideRect(x, y, writeRect)) return 0;
+  const cache = rects.patchAlphaCache;
+  if (
+    cache
+    && cache.seed === seed
+    && x >= cache.x0
+    && y >= cache.y0
+    && x < cache.x0 + cache.width
+    && y < cache.y0 + cache.height
+  ) return cache.data[(y - cache.y0) * cache.width + (x - cache.x0)] || 0;
+  return computePatchAlpha(x, y, rects, seed);
+}
+
+function patchCellIsNew(rects, x, y) {
+  return rects?.patchMode === PATCH_MODE_EXPANSION && !wasGeneratedAt(rects, x, y);
+}
+
+function patchCellOwned(rects, x, y, seed = 0, existingThreshold = PATCH_FEATURE_REPLACE_ALPHA) {
+  const a = patchAlpha(x, y, rects, seed);
+  return patchCellIsNew(rects, x, y)
+    ? insideSelectedCore(rects, x, y) || a >= PATCH_GENERATED_FOOTPRINT_ALPHA
+    : a >= existingThreshold;
+}
+
+function insideSelectedCore(rects, x, y) {
+  const shape = rects?.selectionShape;
+  if (shape?.polygon?.length >= 3) {
+    const bounds = rects?.coreRect || shape;
+    if (!insideRect(x, y, bounds)) return false;
+    let cache = rects._selectedCoreMaskCache;
+    const width = rectWidth(bounds);
+    const height = rectHeight(bounds);
+    if (!cache || cache.x0 !== bounds.x0 || cache.y0 !== bounds.y0 || cache.width !== width || cache.height !== height) {
+      const data = new Uint8Array(width * height);
+      for (let yy = bounds.y0; yy < bounds.y1; yy++) {
+        for (let xx = bounds.x0; xx < bounds.x1; xx++) {
+          if (pointInPolygon(xx + 0.5, yy + 0.5, shape.polygon)) data[(yy - bounds.y0) * width + (xx - bounds.x0)] = 1;
+        }
+      }
+      cache = { x0: bounds.x0, y0: bounds.y0, width, height, data };
+      Object.defineProperty(rects, "_selectedCoreMaskCache", { value: cache, writable: true, configurable: true, enumerable: false });
+    }
+    return !!cache.data[(y - cache.y0) * cache.width + (x - cache.x0)];
+  }
+  return insideRect(x, y, rects?.coreRect);
+}
+
+function patchContinuousBlendAlpha(rects, x, y, seed = 0) {
+  const a = patchAlpha(x, y, rects, seed);
+  if (!patchCellIsNew(rects, x, y)) return a;
+  // The user-selected interior is authoritative and must never be blended
+  // against default backing water.  Outside it, only the recorded generated
+  // footprint may change.  Starting the continuation halo at zero ownership
+  // prevents sub-footprint cells from becoming isolated high land immediately
+  // beside untouched default sea.
+  if (insideSelectedCore(rects, x, y)) {
+    const shape = rects?.selectionShape;
+    if (!shape?.polygon?.length) return a > 0.005 ? 1 : 0;
+    const dist = distanceToPolygonEdge(x + 0.5, y + 0.5, shape.polygon);
+    const edgeFeather = Math.max(4, Math.min(12, Math.round((rects.expansionOverlap || 16) * 0.42)));
+    const interiorWeight = smoothstep(clamp(dist / edgeFeather));
+    return lerp(smoothstep(clamp(a)), 1, interiorWeight);
+  }
+  if (a < PATCH_GENERATED_FOOTPRINT_ALPHA) return 0;
+  const owned = (a - PATCH_GENERATED_FOOTPRINT_ALPHA) / Math.max(1e-6, 1 - PATCH_GENERATED_FOOTPRINT_ALPHA);
+  return smoothstep(clamp(owned));
+}
+
+function patchTerrainWritable(rects, x, y, seed = 0) {
+  const a = patchAlpha(x, y, rects, seed);
+  if (wasGeneratedAt(rects, x, y)) return a > 0.005;
+  return insideSelectedCore(rects, x, y) || a >= PATCH_GENERATED_FOOTPRINT_ALPHA;
+}
+
+function overflowElevationCap(rects, x, y, seed, seaLevel) {
+  if (!patchCellIsNew(rects, x, y) || insideSelectedCore(rects, x, y)) return 1;
+  const a = patchAlpha(x, y, rects, seed);
+  const ownership = clamp((a - PATCH_GENERATED_FOOTPRINT_ALPHA) / Math.max(1e-6, 0.58 - PATCH_GENERATED_FOOTPRINT_ALPHA));
+  // The outer continuation halo should meet untouched sea as low coastal
+  // terrain, not as a clipped mountain wall.  The cap disappears before the
+  // selected core and therefore never flattens user-requested interior land.
+  return clamp(seaLevel + 0.008 + smoothstep(ownership) * 0.62, seaLevel + 0.006, 1);
+}
+
+function terrainContinuationReach(x, y, rects, seed = 0) {
+  const macro = patchWorldNoise(rects, x, y, seed ^ 0x6f92a4d1, 23) - 0.5;
+  const detail = patchWorldNoise(rects, x, y, seed ^ 0xc3197e5b, 9) - 0.5;
+  return Math.max(2, Math.min(PATCH_TERRAIN_CONTINUATION_DEPTH + 2,
+    Math.round(PATCH_TERRAIN_CONTINUATION_DEPTH - 0.5 + macro * 4.2 + detail * 1.4)));
+}
+
+function patchAlphaGradient(x, y, rects, seed = 0) {
+  const a = patchAlpha(x, y, rects, seed);
+  let gradient = 0;
+  for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+    gradient = Math.max(gradient, Math.abs(a - patchAlpha(x + dx, y + dy, rects, seed)));
+  }
+  return gradient;
+}
+
+function patchBand(x, y, rects, seed = 0) {
+  const a = patchAlpha(x, y, rects, seed);
+  if (a <= 0.18) return "preserve";
+  if (a >= 0.82 && patchAlphaGradient(x, y, rects, seed) < PATCH_SEAM_ALPHA_GRADIENT) return "core";
+  return "feather";
+}
+
+function continuityReplaceThreshold(name, x, y, rects, seed = 0) {
+  const n = patchWorldNoise(rects, x, y, seed ^ 0x4f1bbcdc, 11) - 0.5;
+  if (ADMIN_CONTINUITY_FIELD_NAMES.has(name)) return clamp(0.82 + n * 0.12, 0.70, 0.92);
+  if (NATURAL_CONTINUITY_FIELD_NAMES.has(name)) return clamp(0.68 + n * 0.16, 0.54, 0.82);
+  return clamp(0.46 + n * 0.20, 0.28, 0.68);
+}
+
+function patchAffected(x, y, rects, seed = 0, minAlpha = PATCH_FEATURE_REPLACE_ALPHA) {
+  const rx = Math.round(x);
+  const ry = Math.round(y);
+  if (!insideRect(rx, ry, rects?.writeRect)) return false;
+  const threshold = patchCellIsNew(rects, rx, ry) && minAlpha >= PATCH_FEATURE_REPLACE_ALPHA
+    ? PATCH_GENERATED_FOOTPRINT_ALPHA
+    : minAlpha;
+  return patchAlpha(rx, ry, rects, seed) >= threshold;
+}
+
+function segmentTouchesPatch(world, seg, rects, seed = 0, minAlpha = 0.34) {
+  if (!Array.isArray(seg) || seg.length < 2) return false;
+  const ax = tupleWorldX(world, seg[0]);
+  const ay = tupleWorldY(world, seg[0]);
+  const bx = tupleWorldX(world, seg[1]);
+  const by = tupleWorldY(world, seg[1]);
+  const mx = (ax + bx) * 0.5;
+  const my = (ay + by) * 0.5;
+  return patchAffected(ax, ay, rects, seed, minAlpha) || patchAffected(bx, by, rects, seed, minAlpha) || patchAffected(mx, my, rects, seed, minAlpha);
+}
+
+function quantizedSegmentKey(seg) {
+  if (!Array.isArray(seg) || seg.length < 2) return "";
+  const p = seg.map(([x, y]) => [Math.round(x * 4) / 4, Math.round(y * 4) / 4]);
+  const a = `${p[0][0]},${p[0][1]}`;
+  const b = `${p[1][0]},${p[1][1]}`;
+  return a < b ? `${a}|${b}` : `${b}|${a}`;
+}
+
+function dedupeSegments(segments) {
+  const seen = new Set();
+  const out = [];
+  for (const seg of segments || []) {
+    const key = quantizedSegmentKey(seg);
+    if (!key || seen.has(key)) continue;
+    seen.add(key);
+    out.push(seg);
+  }
+  return out;
+}
+
+
+function segmentMidpoint(seg) {
+  return {
+    x: ((seg?.[0]?.[0] || 0) + (seg?.[1]?.[0] || 0)) * 0.5,
+    y: ((seg?.[0]?.[1] || 0) + (seg?.[1]?.[1] || 0)) * 0.5,
+  };
+}
+
+function segmentOrientation(seg) {
+  const dx = (seg?.[1]?.[0] || 0) - (seg?.[0]?.[0] || 0);
+  const dy = (seg?.[1]?.[1] || 0) - (seg?.[0]?.[1] || 0);
+  return Math.atan2(dy, dx);
+}
+
+function pointToSegmentDistance2(px, py, ax, ay, bx, by) {
+  const dx = bx - ax;
+  const dy = by - ay;
+  const len2 = dx * dx + dy * dy;
+  if (len2 <= 1e-9) return Math.hypot(px - ax, py - ay);
+  const t = clamp(((px - ax) * dx + (py - ay) * dy) / len2, 0, 1);
+  return Math.hypot(px - (ax + dx * t), py - (ay + dy * t));
+}
+
+function sourceWindowForRects(rects) {
+  if (rects?.candidateWindow) return rects.candidateWindow;
+  const cx = (rects.coreRect.x0 + rects.coreRect.x1 - 1) / 2;
+  const cy = (rects.coreRect.y0 + rects.coreRect.y1 - 1) / 2;
+  return {
+    worldCenterX: cx,
+    worldCenterY: cy,
+    sourceCenterX: (MAP_W - 1) / 2,
+    sourceCenterY: (MAP_H - 1) / 2,
+    originX: Math.round(cx - (MAP_W - 1) / 2),
+    originY: Math.round(cy - (MAP_H - 1) / 2),
+    width: MAP_W,
+    height: MAP_H,
+    variable: false,
+  };
+}
+
+function sourceWindowIndex(window, sx, sy) {
+  const width = Math.max(1, Math.floor(window?.width || MAP_W));
+  const height = Math.max(1, Math.floor(window?.height || MAP_H));
+  if (sx < 0 || sy < 0 || sx >= width || sy >= height) return -1;
+  return sy * width + sx;
+}
+
+function sourceCoordForWorld(window, x, y) {
+  return {
+    x: Math.round(x - window.worldCenterX + window.sourceCenterX),
+    y: Math.round(y - window.worldCenterY + window.sourceCenterY),
+  };
+}
+
+function candidateCellSize(candidate, window = null) {
+  const width = Math.max(1, Math.floor(candidate?.width || window?.width || MAP_W));
+  const height = Math.max(1, Math.floor(candidate?.height || window?.height || MAP_H));
+  return { width, height, size: width * height };
+}
+
+function isCandidateCellField(candidate, value, window = null) {
+  if (!ArrayBuffer.isView(value) || typeof value.length !== "number") return false;
+  const { size } = candidateCellSize(candidate, window);
+  return value.length === size || value.length === SIZE;
+}
+
+function buildPatchCandidateWindow(rects, world = null, options = {}) {
+  // Canonical tiled expansion passes a world-grid-anchored window.  The actual
+  // selected fragment may be much smaller, but it must not recenter the source
+  // candidate or a one-cell lasso change would perturb the shared geography.
+  if (options?._candidateWindowOverride) return { ...options._candidateWindowOverride };
+  return sourceWindowForRects({ ...rects, candidateWindow: null });
+}
+
+function getPatchSourceIndexCache(rects, window) {
+  const writeRect = rects?.writeRect;
+  if (!writeRect || !window) return null;
+  const width = rectWidth(writeRect);
+  const height = rectHeight(writeRect);
+  const existing = rects.patchSourceIndexCache;
+  if (
+    existing
+    && existing.width === width
+    && existing.height === height
+    && existing.x0 === writeRect.x0
+    && existing.y0 === writeRect.y0
+    && existing.worldCenterX === window.worldCenterX
+    && existing.worldCenterY === window.worldCenterY
+    && existing.sourceCenterX === window.sourceCenterX
+    && existing.sourceCenterY === window.sourceCenterY
+  ) return existing;
+
+  const data = new Int32Array(width * height);
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const sx = Math.round(writeRect.x0 + x - window.worldCenterX + window.sourceCenterX);
+      const sy = Math.round(writeRect.y0 + y - window.worldCenterY + window.sourceCenterY);
+      data[y * width + x] = sourceWindowIndex(window, sx, sy);
+    }
+  }
+  rects.patchSourceIndexCache = {
+    width,
+    height,
+    x0: writeRect.x0,
+    y0: writeRect.y0,
+    worldCenterX: window.worldCenterX,
+    worldCenterY: window.worldCenterY,
+    sourceCenterX: window.sourceCenterX,
+    sourceCenterY: window.sourceCenterY,
+    data,
+  };
+  return rects.patchSourceIndexCache;
+}
+
+function sourceIndexForWorld(rects, window, x, y) {
+  const cache = rects?.patchSourceIndexCache;
+  if (
+    cache
+    && x >= cache.x0
+    && y >= cache.y0
+    && x < cache.x0 + cache.width
+    && y < cache.y0 + cache.height
+  ) return cache.data[(y - cache.y0) * cache.width + (x - cache.x0)];
+  const s = sourceCoordForWorld(window, x, y);
+  return sourceWindowIndex(window, s.x, s.y);
+}
+
+
+function solveLinear3(a00, a01, a02, a11, a12, a22, b0, b1, b2) {
+  const m = [
+    [a00, a01, a02, b0],
+    [a01, a11, a12, b1],
+    [a02, a12, a22, b2],
+  ];
+  for (let col = 0; col < 3; col++) {
+    let pivot = col;
+    for (let row = col + 1; row < 3; row++) if (Math.abs(m[row][col]) > Math.abs(m[pivot][col])) pivot = row;
+    if (Math.abs(m[pivot][col]) < 1e-8) return null;
+    if (pivot !== col) [m[col], m[pivot]] = [m[pivot], m[col]];
+    const div = m[col][col];
+    for (let k = col; k < 4; k++) m[col][k] /= div;
+    for (let row = 0; row < 3; row++) {
+      if (row === col) continue;
+      const f = m[row][col];
+      for (let k = col; k < 4; k++) m[row][k] -= f * m[col][k];
+    }
+  }
+  return [m[0][3], m[1][3], m[2][3]];
+}
+
+function computeElevationCandidateAdjustment(world, candidate, rects, window, seed = 0, baseOffset = 0) {
+  const oldElevation = world?.fields?.elevation;
+  const candidateElevation = candidate?.elevation;
+  if (!oldElevation || !candidateElevation || !rects?.writeRect || !window) return null;
+  const rect = rects.writeRect;
+  const cx = (rect.x0 + rect.x1 - 1) / 2;
+  const cy = (rect.y0 + rect.y1 - 1) / 2;
+  const scale = Math.max(1, Math.max(rectWidth(rect), rectHeight(rect)) / 2);
+  let n = 0;
+  let sX = 0, sY = 0, sXX = 0, sXY = 0, sYY = 0;
+  let sZ = 0, sXZ = 0, sYZ = 0;
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const a = patchAlpha(x, y, rects, seed);
+      if (a <= 0.01 || a > 0.42) continue;
+      const wi = worldIndexOf(world, x, y);
+      const si = sourceIndexForWorld(rects, window, x, y);
+      if (wi < 0 || si < 0) continue;
+      const oldSea = world.fields?.sea?.[wi];
+      const newSea = candidate.sea?.[si];
+      if (oldSea || newSea) continue;
+      const oldValue = oldElevation[wi];
+      const newValue = candidateElevation[si] + baseOffset;
+      if (!Number.isFinite(oldValue) || !Number.isFinite(newValue)) continue;
+      const lx = (x - cx) / scale;
+      const ly = (y - cy) / scale;
+      const z = oldValue - newValue;
+      n++;
+      sX += lx; sY += ly; sXX += lx * lx; sXY += lx * ly; sYY += ly * ly;
+      sZ += z; sXZ += lx * z; sYZ += ly * z;
+    }
+  }
+  const expansion = rects.patchMode === PATCH_MODE_EXPANSION;
+  const fitLimit = expansion ? 0.08 : 0.22;
+  const tiltLimit = expansion ? 0.06 : 0.16;
+  if (n < 24) return { offset: baseOffset, fitOffset: 0, tiltX: 0, tiltY: 0, cx, cy, scale, samples: n, baseOffset, expansion };
+  const solved = solveLinear3(n, sX, sY, sXX, sXY, sYY, sZ, sXZ, sYZ);
+  if (!solved) {
+    const fitOffset = clamp(sZ / n, -fitLimit, fitLimit);
+    return { offset: baseOffset + fitOffset, fitOffset, tiltX: 0, tiltY: 0, cx, cy, scale, samples: n, baseOffset, expansion };
+  }
+  const fitOffset = clamp(solved[0], -fitLimit, fitLimit);
+  return {
+    offset: baseOffset + fitOffset,
+    fitOffset,
+    baseOffset,
+    tiltX: clamp(solved[1], -tiltLimit, tiltLimit),
+    tiltY: clamp(solved[2], -tiltLimit, tiltLimit),
+    cx, cy, scale,
+    samples: n,
+    expansion,
+  };
+}
+
+function adjustedCandidateElevation(value, x, y, adjustment, rects = null) {
+  if (!adjustment || !Number.isFinite(value)) return value;
+  const lx = (x - adjustment.cx) / Math.max(1, adjustment.scale || 1);
+  const ly = (y - adjustment.cy) / Math.max(1, adjustment.scale || 1);
+  let fitWeight = 1;
+  if (adjustment.expansion && rects) {
+    // Preserve production terrain statistics in the new interior.  The affine
+    // seam fit is only needed near previously generated cells; applying it to
+    // the entire candidate can lower a high-quality landmass below sea level.
+    const overlap = Math.max(4, rects.expansionOverlap || 18);
+    const distance = coverageDistanceAt(rects, x, y, "generated");
+    fitWeight = wasGeneratedAt(rects, x, y)
+      ? 1
+      : clamp(1 - Math.max(0, distance - 1) / Math.max(1, overlap * 0.85));
+  }
+  const fitted = (adjustment.fitOffset + adjustment.tiltX * lx + adjustment.tiltY * ly) * fitWeight;
+  return clamp(value + adjustment.baseOffset + fitted, 0, 1);
+}
+
+function worldCoordForSource(window, sx, sy) {
+  return {
+    x: Math.round(sx - window.sourceCenterX + window.worldCenterX),
+    y: Math.round(sy - window.sourceCenterY + window.worldCenterY),
+  };
+}
+
+function fieldIdOffset(name, seed) {
+  const base = ID_FIELD_OFFSETS.get(name) || 0;
+  if (!base) return 0;
+  return base + ((seed >>> 0) % 997) * 10000;
+}
+
+function maxFieldId(field) {
+  if (!field) return -1;
+  let max = -1;
+  for (let i = 0; i < field.length; i++) {
+    const id = field[i];
+    if (Number.isFinite(id) && id > max) max = id;
+  }
+  return max;
+}
+
+function addMappingVote(votes, from, to, weight = 1) {
+  if (!Number.isFinite(from) || from < 0 || !Number.isFinite(to) || to < 0) return;
+  const key = Math.floor(from);
+  const target = Math.floor(to);
+  const bucket = votes.get(key) || new Map();
+  bucket.set(target, (bucket.get(target) || 0) + Math.max(1, weight));
+  votes.set(key, bucket);
+}
+
+function chooseVotedTarget(bucket, minVotes = 1) {
+  let best = -1;
+  let bestVotes = 0;
+  for (const [target, count] of bucket || []) {
+    if (count > bestVotes || (count === bestVotes && target < best)) {
+      best = target;
+      bestVotes = count;
+    }
+  }
+  return best >= 0 && bestVotes >= minVotes ? best : -1;
+}
+
+function collectCandidateIdsInRect(candidateField, rects, window, minAlpha = 0.20, seed = 0) {
+  const ids = new Set();
+  if (!candidateField) return ids;
+  const rect = rects.writeRect;
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      if (patchAlpha(x, y, rects, seed) < minAlpha) continue;
+      const si = sourceIndexForWorld(rects, window, x, y);
+      if (si < 0) continue;
+      const id = candidateField[si];
+      if (Number.isFinite(id) && id >= 0) ids.add(Math.floor(id));
+    }
+  }
+  return ids;
+}
+
+function buildCandidatePrefByAdmin(candidateMap, candidateAdminIds) {
+  const out = new Map();
+  const direct = candidateMap?.municipalityToPrefectureId;
+  for (const id of candidateAdminIds || []) {
+    const pref = direct?.[id];
+    if (Number.isFinite(pref) && pref >= 0) out.set(id, Math.floor(pref));
+  }
+  const adminField = candidateMap?.adminId || candidateMap?.municipalityId;
+  const prefField = candidateMap?.prefectureRegionId;
+  if (!adminField || !prefField) return out;
+  const votes = new Map();
+  for (let i = 0; i < adminField.length; i++) {
+    const admin = adminField[i];
+    const pref = prefField[i];
+    if (!Number.isFinite(admin) || admin < 0 || !Number.isFinite(pref) || pref < 0) continue;
+    if (candidateAdminIds?.size && !candidateAdminIds.has(Math.floor(admin))) continue;
+    addMappingVote(votes, admin, pref, 1);
+  }
+  for (const [admin, bucket] of votes) {
+    if (!out.has(admin)) {
+      const pref = chooseVotedTarget(bucket, 1);
+      if (pref >= 0) out.set(admin, pref);
+    }
+  }
+  return out;
+}
+
+function buildAdminIdMapping({ candidateMap, world, writeRect, seamBand = 24, window = null, rects = null, seed = 0 } = {}) {
+  const actualWindow = window || (rects ? sourceWindowForRects(rects) : null);
+  const actualRects = rects || { writeRect, writeMargin: seamBand || 1 };
+  if (!candidateMap || !world || !writeRect || !actualWindow) {
+    return {
+      prefecture: new Map(),
+      municipality: new Map(),
+      admin: new Map(),
+      candidateAdminToPrefecture: new Map(),
+      allocatedPrefectureIds: new Set(),
+      debug: { prefecturesMappedToExisting: 0, prefecturesAllocated: 0, municipalitiesMappedToExisting: 0, municipalitiesAllocated: 0 },
+    };
+  }
+
+  const candidateAdmin = candidateMap.adminId || candidateMap.municipalityId;
+  const candidateMunicipality = candidateMap.municipalityId || candidateAdmin;
+  const candidatePrefecture = candidateMap.prefectureRegionId;
+  const worldAdmin = world.fields?.adminId || world.fields?.municipalityId;
+  const worldMunicipality = world.fields?.municipalityId || worldAdmin;
+  const worldPrefecture = world.fields?.prefectureRegionId;
+
+  const candidateAdminIds = collectCandidateIdsInRect(candidateAdmin, actualRects, actualWindow, 0.18, seed);
+  const candidateMunicipalityIds = collectCandidateIdsInRect(candidateMunicipality, actualRects, actualWindow, 0.18, seed);
+  const candidatePrefectureIds = collectCandidateIdsInRect(candidatePrefecture, actualRects, actualWindow, 0.18, seed);
+  const candidateAdminToPrefecture = buildCandidatePrefByAdmin(candidateMap, candidateAdminIds);
+
+  const adminVotes = new Map();
+  const municipalityVotes = new Map();
+  const prefectureVotes = new Map();
+  const band = Math.max(2, Math.floor(seamBand));
+  const dirs = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
+
+  for (let y = writeRect.y0; y < writeRect.y1; y++) {
+    for (let x = writeRect.x0; x < writeRect.x1; x++) {
+      const expansion = actualRects.patchMode === PATCH_MODE_EXPANSION;
+      const edge = expansion ? coverageDistanceAt(actualRects, x, y, "generated") : distanceToRectEdge(x, y, writeRect);
+      if (edge > band || (expansion && wasGeneratedAt(actualRects, x, y))) continue;
+      const s = sourceCoordForWorld(actualWindow, x, y);
+      const si = sourceWindowIndex(actualWindow, s.x, s.y);
+      const wi = worldIndexOf(world, x, y);
+      if (si < 0 || wi < 0) continue;
+      const cAdmin = candidateAdmin?.[si] ?? -1;
+      const cMunicipality = candidateMunicipality?.[si] ?? cAdmin;
+      const cPrefecture = candidatePrefecture?.[si] ?? -1;
+      const sameCellWeight = Math.max(1, band + 1 - edge);
+      if (!expansion) {
+        addMappingVote(adminVotes, cAdmin, worldAdmin?.[wi] ?? -1, sameCellWeight);
+        addMappingVote(municipalityVotes, cMunicipality, worldMunicipality?.[wi] ?? worldAdmin?.[wi] ?? -1, sameCellWeight);
+        addMappingVote(prefectureVotes, cPrefecture, worldPrefecture?.[wi] ?? -1, sameCellWeight);
+      }
+
+      for (const [dx, dy] of dirs) {
+        for (let step = 1; step <= Math.min(8, band); step++) {
+          const nx = x + dx * step;
+          const ny = y + dy * step;
+          if (expansion) {
+            if (!wasGeneratedAt(actualRects, nx, ny)) continue;
+          } else if (insideRect(nx, ny, writeRect)) continue;
+          const ni = worldIndexOf(world, nx, ny);
+          if (ni < 0) break;
+          const w = Math.max(1, 9 - step) + Math.max(0, band - edge) * 0.25;
+          addMappingVote(adminVotes, cAdmin, worldAdmin?.[ni] ?? -1, w);
+          addMappingVote(municipalityVotes, cMunicipality, worldMunicipality?.[ni] ?? worldAdmin?.[ni] ?? -1, w);
+          addMappingVote(prefectureVotes, cPrefecture, worldPrefecture?.[ni] ?? -1, w);
+          break;
+        }
+      }
+    }
+  }
+
+  const prefecture = new Map();
+  const allocatedPrefectureIds = new Set();
+  let nextPrefectureId = maxFieldId(worldPrefecture) + 1;
+  let prefecturesMappedToExisting = 0;
+  let prefecturesAllocated = 0;
+  for (const id of [...candidatePrefectureIds].sort((a, b) => a - b)) {
+    // Expansion only needs one convincing contact with the established side to
+    // continue an existing prefecture. Requiring three votes let a brand-new
+    // prefecture begin exactly on a patch frontier when the lasso touched the
+    // old world at an oblique or narrow angle.
+    const minPrefectureVotes = actualRects.patchMode === PATCH_MODE_EXPANSION ? 1 : 3;
+    const voted = chooseVotedTarget(prefectureVotes.get(id), minPrefectureVotes);
+    if (voted >= 0) {
+      prefecture.set(id, voted);
+      prefecturesMappedToExisting++;
+    } else {
+      const allocatedId = nextPrefectureId++;
+      prefecture.set(id, allocatedId);
+      allocatedPrefectureIds.add(allocatedId);
+      prefecturesAllocated++;
+    }
+  }
+
+  const usedAdminIds = new Set();
+  if (worldAdmin) {
+    for (let i = 0; i < worldAdmin.length; i++) if (worldAdmin[i] >= 0) usedAdminIds.add(worldAdmin[i]);
+  }
+  const municipality = new Map();
+  const admin = new Map();
+  let nextMunicipalityId = maxFieldId(worldAdmin || worldMunicipality) + 1;
+  let municipalitiesMappedToExisting = 0;
+  let municipalitiesAllocated = 0;
+  const allocatedMunicipalityIds = new Set();
+  const mappedMunicipalityIds = new Set();
+  const allMunicipalityIds = new Set([...candidateAdminIds, ...candidateMunicipalityIds]);
+  for (const id of [...allMunicipalityIds].sort((a, b) => a - b)) {
+    const voted = chooseVotedTarget(municipalityVotes.get(id) || adminVotes.get(id), 4);
+    if (voted >= 0) {
+      municipality.set(id, voted);
+      admin.set(id, voted);
+      mappedMunicipalityIds.add(voted);
+      municipalitiesMappedToExisting++;
+    } else {
+      while (usedAdminIds.has(nextMunicipalityId)) nextMunicipalityId++;
+      municipality.set(id, nextMunicipalityId);
+      admin.set(id, nextMunicipalityId);
+      usedAdminIds.add(nextMunicipalityId);
+      allocatedMunicipalityIds.add(nextMunicipalityId);
+      nextMunicipalityId++;
+      municipalitiesAllocated++;
+    }
+  }
+
+  const municipalityToPrefecture = new Map();
+  for (const [candidateAdminId, worldAdminId] of admin) {
+    const candidatePrefId = candidateAdminToPrefecture.get(candidateAdminId);
+    const worldPrefId = prefecture.get(candidatePrefId);
+    if (Number.isFinite(worldAdminId) && Number.isFinite(worldPrefId)) municipalityToPrefecture.set(worldAdminId, worldPrefId);
+  }
+
+  return {
+    prefecture,
+    municipality,
+    admin,
+    candidateAdminToPrefecture,
+    municipalityToPrefecture,
+    allocatedPrefectureIds,
+    allocatedMunicipalityIds,
+    mappedMunicipalityIds,
+    debug: {
+      candidatePrefectureIds: candidatePrefectureIds.size,
+      candidateMunicipalityIds: allMunicipalityIds.size,
+      prefecturesMappedToExisting,
+      prefecturesAllocated,
+      municipalitiesMappedToExisting,
+      municipalitiesAllocated,
+    },
+  };
+}
+
+function remapAdminCandidateValue(name, raw, adminIdMapping) {
+  if (!Number.isFinite(raw) || raw < 0 || !adminIdMapping) return raw;
+  const id = Math.floor(raw);
+  if (name === "prefectureRegionId") return adminIdMapping.prefecture?.get(id) ?? raw;
+  if (name === "adminId") return adminIdMapping.admin?.get(id) ?? raw;
+  if (name === "municipalityId") return adminIdMapping.municipality?.get(id) ?? adminIdMapping.admin?.get(id) ?? raw;
+  return raw;
+}
+
+function numericFeatureId(point, keys) {
+  for (const key of keys) {
+    const value = point?.[key];
+    if (Number.isFinite(value) && value >= 0) return Math.floor(value);
+  }
+  return -1;
+}
+
+function summarizeIdMapping(mapping) {
+  return { ...(mapping?.debug || {}) };
+}
+
+function updateSourceAdminMetadata(sourceMap, adminIdMapping) {
+  if (!sourceMap || !adminIdMapping?.municipalityToPrefecture?.size) return 0;
+  let maxId = -1;
+  const current = sourceMap.municipalityToPrefectureId;
+  if (current && typeof current.length === "number") maxId = Math.max(maxId, current.length - 1);
+  for (const [adminId] of adminIdMapping.municipalityToPrefecture) maxId = Math.max(maxId, adminId);
+  const next = new Int32Array(Math.max(0, maxId + 1));
+  next.fill(-1);
+  if (current && typeof current.length === "number") {
+    for (let i = 0; i < current.length && i < next.length; i++) next[i] = current[i] ?? -1;
+  }
+  let updated = 0;
+  for (const [adminId, prefId] of adminIdMapping.municipalityToPrefecture) {
+    if (!Number.isFinite(adminId) || adminId < 0 || !Number.isFinite(prefId) || prefId < 0) continue;
+    if (next[adminId] !== prefId) updated++;
+    next[adminId] = prefId;
+  }
+  sourceMap.municipalityToPrefectureId = next;
+  sourceMap.patchAdminIdMappingDebug = summarizeIdMapping(adminIdMapping);
+  return updated;
+}
+
+function cloneContinuityFields(world) {
+  const out = new Map();
+  for (const name of CONTINUITY_FIELD_NAMES) {
+    const field = world?.fields?.[name];
+    if (ArrayBuffer.isView(field)) out.set(name, new field.constructor(field));
+  }
+  return out;
+}
+
+function cloneHumanLandContinuityFields(world) {
+  const out = new Map();
+  for (const name of [
+    "elevation",
+    "roadInfluence",
+    "railInfluence2",
+    "stationInfluence",
+    "populationDensity",
+    "settlementScore",
+    "villageInfluence",
+    "plain",
+    "agriculture",
+  ]) {
+    const field = world?.fields?.[name];
+    if (ArrayBuffer.isView(field)) out.set(name, new field.constructor(field));
+  }
+  return out;
+}
+
+function restoreHumanLandContinuity(world, sourceMap, rects, oldSea, oldLanduse, oldHumanFields, seed = 0, seaLevel = 0.30) {
+  const sea = world.fields?.sea;
+  const ocean = world.fields?.ocean;
+  const lake = world.fields?.lake;
+  const elevation = world.fields?.elevation;
+  const landuse = world.fields?.landuse;
+  const rect = rects?.writeRect;
+  if (!sea || !rect || !oldSea) {
+    return { humanLandCellsRestored: 0, humanLandFeatureMaskCells: 0, humanLandCandidatesChecked: 0 };
+  }
+
+  const width = rectWidth(rect);
+  const height = rectHeight(rect);
+  const mask = new Float32Array(width * height);
+  const localIndex = (x, y) => (y - rect.y0) * width + (x - rect.x0);
+  const active = (x, y, minAlpha = 0.18) => insideRect(x, y, rect) && patchAlpha(x, y, rects, seed) >= minAlpha;
+
+  const markDisk = (cx, cy, radius, weight) => {
+    cx = Math.round(cx); cy = Math.round(cy);
+    const r = Math.max(1, Math.floor(radius));
+    for (let y = cy - r; y <= cy + r; y++) {
+      for (let x = cx - r; x <= cx + r; x++) {
+        if (!active(x, y, 0.14)) continue;
+        const wi = worldIndexOf(world, x, y);
+        if (wi < 0 || oldSea[wi]) continue;
+        const d = Math.hypot(x - cx, y - cy);
+        if (d > r + 0.35) continue;
+        const li = localIndex(x, y);
+        const falloff = 1 - d / Math.max(1, r + 0.35);
+        mask[li] = Math.max(mask[li], weight * (0.35 + falloff * 0.65));
+      }
+    }
+  };
+
+  const markSegment = (ax, ay, bx, by, radius, weight) => {
+    const len = Math.max(1, Math.hypot(bx - ax, by - ay));
+    const steps = Math.max(1, Math.ceil(len / 2.0));
+    for (let i = 0; i <= steps; i++) {
+      const t = i / steps;
+      markDisk(ax + (bx - ax) * t, ay + (by - ay) * t, radius, weight);
+    }
+  };
+
+  let humanLandFeatureMaskCells = 0;
+  const markPathLayer = (key, radius, weight) => {
+    for (const path of sourceMap?.[key] || []) {
+      let prev = null;
+      for (const tuple of path || []) {
+        const x = tupleWorldX(world, tuple);
+        const y = tupleWorldY(world, tuple);
+        if (prev) markSegment(prev.x, prev.y, x, y, radius, weight);
+        prev = { x, y };
+      }
+    }
+  };
+
+  // Only the actual pre-existing transport centerlines should bias land
+  // restoration.  Settlements, admin centers, ports, industrial sites, etc. are
+  // deliberately ignored here; otherwise patching a coastal/archipelago area
+  // over-preserves old human geography and resists legitimate water generation.
+  // The weights are intentionally weak: this pass is a continuity hint, not a
+  // hard constraint.
+  for (const key of ["expressways", "externalExpressways", "nationalRoads"]) markPathLayer(key, 3, 0.62);
+  for (const key of ["minorRoads", "premodernRoads", "ringRoads", "externalRoads", "icAccessRoads"]) markPathLayer(key, 2, 0.42);
+  for (const key of ["railways", "branchRailways", "ringRailways", "externalRailways"]) markPathLayer(key, 3, 0.66);
+
+  for (let i = 0; i < mask.length; i++) if (mask[i] > 0) humanLandFeatureMaskCells++;
+
+  const oldElevation = oldHumanFields?.get("elevation");
+  const scoreField = (name, i, weight) => (oldHumanFields?.get(name)?.[i] || 0) * weight;
+  let humanLandCellsRestored = 0;
+  let humanLandCandidatesChecked = 0;
+
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      if (!active(x, y, 0.20)) continue;
+      const i = worldIndexOf(world, x, y);
+      if (i < 0 || oldSea[i] || !sea[i]) continue;
+      humanLandCandidatesChecked++;
+      const li = localIndex(x, y);
+      const score = mask[li]
+        + scoreField("roadInfluence", i, 0.82)
+        + scoreField("railInfluence2", i, 0.98)
+        + scoreField("stationInfluence", i, 0.28);
+      if (score < 0.78) continue;
+
+      sea[i] = 0;
+      if (ocean) ocean[i] = 0;
+      if (lake) lake[i] = 0;
+      if (elevation) {
+        const oldElev = oldElevation?.[i];
+        const target = Number.isFinite(oldElev) ? Math.max(oldElev, seaLevel + 0.012) : seaLevel + 0.018;
+        elevation[i] = Math.max(elevation[i] || 0, target);
+      }
+      if (landuse) {
+        const oldUse = oldLanduse?.[i];
+        landuse[i] = oldUse && oldUse !== LANDUSE.WATER ? oldUse : (LANDUSE.RURAL || 0);
+      }
+      humanLandCellsRestored++;
+    }
+  }
+
+  return { humanLandCellsRestored, humanLandFeatureMaskCells, humanLandCandidatesChecked };
+}
+
+function stabilizeContinuitySeam(world, rects, oldFields, seed = 0) {
+  let restored = 0;
+  let remapped = 0;
+  const margin = Math.max(2, rects.writeMargin || 1);
+  for (const name of CONTINUITY_FIELD_NAMES) {
+    const field = world.fields?.[name];
+    const old = oldFields?.get(name);
+    if (!field || !old) continue;
+    const isPrefecture = name === "prefectureRegionId";
+    const isAdmin = name === "adminId" || name === "municipalityId";
+    const preserveAlpha = isPrefecture ? 0.94 : isAdmin ? 0.90 : 0.74;
+    const preserveEdge = isPrefecture ? margin * 1.25 : isAdmin ? margin : margin * 0.72;
+
+    // Preserve IDs only on the actual old-world side during expansion. The
+    // rectangular write window is an implementation detail; treating its edge
+    // as geography produced long vertical and horizontal prefecture strips.
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0 || old[i] < 0) continue;
+        const edge = distanceToRectEdge(x, y, rects.writeRect);
+        const a = patchAlpha(x, y, rects, seed);
+        const preserve = rects.patchMode === PATCH_MODE_EXPANSION
+          ? wasGeneratedAt(rects, x, y)
+          : edge <= preserveEdge || a < preserveAlpha;
+        if (preserve) {
+          if (field[i] !== old[i]) { field[i] = old[i]; restored++; }
+        }
+      }
+    }
+
+    // Then map candidate IDs that contact an outside ID back to that outside ID.
+    // This lets prefectures/municipalities cross the generated-area seam instead
+    // of creating a new border exactly on the seam.
+    const contacts = new Map();
+    const dirs = [[1,0],[-1,0],[0,1],[0,-1]];
+    for (let y = rects.writeRect.y0 + 1; y < rects.writeRect.y1 - 1; y++) {
+      for (let x = rects.writeRect.x0 + 1; x < rects.writeRect.x1 - 1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0 || field[i] < 0 || old[i] === field[i]) continue;
+        const a = patchAlpha(x, y, rects, seed);
+        if (rects.patchMode === PATCH_MODE_EXPANSION) {
+          if (wasGeneratedAt(rects, x, y) || coverageDistanceAt(rects, x, y, "generated") > Math.max(5, margin)) continue;
+        } else if (a < 0.98 && !isPrefecture) continue;
+        for (const [dx, dy] of dirs) {
+          const ni = worldIndexOf(world, x + dx, y + dy);
+          if (ni < 0 || old[ni] < 0 || old[ni] === field[i]) continue;
+          const oldSideContact = rects.patchMode === PATCH_MODE_EXPANSION
+            ? wasGeneratedAt(rects, x + dx, y + dy)
+            : field[ni] === old[ni] || patchAlpha(x + dx, y + dy, rects, seed) < preserveAlpha;
+          if (oldSideContact) {
+            const key = field[i];
+            const bucket = contacts.get(key) || new Map();
+            bucket.set(old[ni], (bucket.get(old[ni]) || 0) + 1);
+            contacts.set(key, bucket);
+          }
+        }
+      }
+    }
+    const mapping = new Map();
+    for (const [from, bucket] of contacts) {
+      let best = -1, bestCount = 0;
+      for (const [to, count] of bucket) if (count > bestCount) { best = to; bestCount = count; }
+      if (best >= 0 && bestCount >= (isPrefecture ? 2 : 3)) mapping.set(from, best);
+    }
+    if (mapping.size) {
+      for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+        for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+          const i = worldIndexOf(world, x, y);
+          if (i >= 0 && mapping.has(field[i])) { field[i] = mapping.get(field[i]); remapped++; }
+        }
+      }
+    }
+  }
+  return { continuityCellsRestored: restored, continuityCellsRemapped: remapped };
+}
+
+function chooseSeamOwnerValue(world, fieldName, oldField, candidateValue, x, y, rects, seed) {
+  const a = patchAlpha(x, y, rects, seed);
+  const i = worldIndexOf(world, x, y);
+  const oldValue = oldField?.[i] ?? -1;
+  if (oldValue < 0 || candidateValue < 0) return candidateValue >= 0 ? candidateValue : oldValue;
+  if (a <= 0.24) return oldValue;
+  if (a >= 0.82) return candidateValue;
+
+  const field = world.fields?.[fieldName];
+  const pref = world.fields?.prefectureRegionId;
+  const naturalBarrier = world.fields?.naturalBarrierScore || world.fields?.ridgeField;
+  let oldScore = (1 - a) * 3.0;
+  let candidateScore = a * 3.0;
+  for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+    const ni = worldIndexOf(world, x + dx, y + dy);
+    if (ni < 0) continue;
+    const neighbor = field?.[ni] ?? -1;
+    if (neighbor === oldValue) oldScore += 1.2;
+    if (neighbor === candidateValue) candidateScore += 1.2;
+    if (fieldName !== "prefectureRegionId" && pref && pref[ni] >= 0) {
+      if (pref[ni] === pref[i] && candidateValue !== oldValue) oldScore += 0.18;
+    }
+  }
+  const barrierBonus = naturalBarrier?.[i] || 0;
+  if (barrierBonus > 0.48 && Math.abs(a - 0.5) < 0.24) {
+    if (a < 0.5) oldScore += barrierBonus * 0.9;
+    else candidateScore += barrierBonus * 0.9;
+  }
+  return candidateScore > oldScore ? candidateValue : oldValue;
+}
+
+function repairDiscreteSeamOwnership(world, rects, oldFields, seed = 0) {
+  let adminSeamCellsResolved = 0;
+  let prefectureSeamCellsResolved = 0;
+  for (const name of ["prefectureRegionId", "adminId", "municipalityId"]) {
+    const field = world.fields?.[name];
+    const old = oldFields?.get(name);
+    if (!field || !old) continue;
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0 || world.fields.sea?.[i]) continue;
+        if (patchBand(x, y, rects, seed) !== "feather") continue;
+        const before = field[i];
+        const next = chooseSeamOwnerValue(world, name, old, before, x, y, rects, seed);
+        if (next !== before) {
+          field[i] = next;
+          if (name === "prefectureRegionId") prefectureSeamCellsResolved++;
+          else adminSeamCellsResolved++;
+        }
+      }
+    }
+  }
+  if (world.fields.adminId && world.fields.municipalityId) {
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i >= 0 && !world.fields.sea?.[i]) world.fields.municipalityId[i] = world.fields.adminId[i];
+      }
+    }
+  }
+  return { adminSeamCellsResolved, prefectureSeamCellsResolved };
+}
+
+function copyFullPipelineFields(world, candidate, rects, seed, sourceMap = null, seaLevel = 0.30, patchContext = null, terrainContract = null) {
+  const window = patchContext?.candidateWindow || sourceWindowForRects(rects);
+  const candidateSeaLevel = Number.isFinite(candidate?.seaLevel) ? candidate.seaLevel : seaLevel;
+  const seaLevelBaseOffset = seaLevel - candidateSeaLevel;
+  const elevationAdjustment = computeElevationCandidateAdjustment(world, candidate, rects, window, seed, seaLevelBaseOffset);
+  const oldSea = world.fields.sea ? new Uint8Array(world.fields.sea) : null;
+  const oldLanduse = world.fields.landuse ? new world.fields.landuse.constructor(world.fields.landuse) : null;
+  const oldHumanFields = cloneHumanLandContinuityFields(world);
+  const oldContinuityFields = cloneContinuityFields(world);
+  const adminIdMapping = buildAdminIdMapping({
+    candidateMap: candidate,
+    world,
+    writeRect: rects.writeRect,
+    seamBand: Math.max(8, Math.floor(rects.writeMargin || 24)),
+    window,
+    rects,
+    seed,
+  });
+  let updatedCells = 0;
+  let coastCellsChanged = 0;
+  let terrainCellsFullyReplaced = 0;
+  let naturalRegionsUpdated = 0;
+  let adminCellsReassigned = 0;
+  let landUseCellsUpdated = 0;
+
+  const fieldEntries = [];
+  const derivedWaterFields = new Set(["sea", "ocean", "lake", "landMask", "prefectureMask"]);
+  for (const [name, source] of Object.entries(candidate || {})) {
+    if (SKIP_CELL_FIELDS.has(name) || derivedWaterFields.has(name) || !isCandidateCellField(candidate, source, window)) continue;
+    const dest = ensureWorldField(world, name, source);
+    if (!dest) continue;
+    const isFloat = source.constructor === Float32Array || source.constructor === Float64Array;
+    const isDiscrete = DISCRETE_FIELD_NAMES.has(name) || !isFloat;
+    const idOffset = fieldIdOffset(name, seed);
+    fieldEntries.push({ name, source, dest, isDiscrete, idOffset });
+  }
+
+  const cells = patchContext?.writeCells?.length ? patchContext.writeCells : (() => {
+    const out = [];
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const wi = worldIndexOf(world, x, y);
+        if (wi < 0) continue;
+        const si = sourceIndexForWorld(rects, window, x, y);
+        if (si < 0) continue;
+        const alpha = patchAlpha(x, y, rects, seed);
+        if (alpha > 0.005) out.push({ x, y, wi, si, alpha });
+      }
+    }
+    return out;
+  })();
+
+  for (const cell of cells) {
+    const { x, y, wi, si, alpha } = cell;
+    const newOwnedCell = patchCellIsNew(rects, x, y) && alpha >= PATCH_GENERATED_FOOTPRINT_ALPHA;
+    const blendAlpha = patchContinuousBlendAlpha(rects, x, y, seed);
+    for (const entry of fieldEntries) {
+      const { name, source, dest, isDiscrete, idOffset } = entry;
+      if (isDiscrete) {
+        const threshold = continuityReplaceThreshold(name, x, y, rects, seed);
+        if (!newOwnedCell && alpha < threshold) continue;
+        const raw = source[si];
+        const mapped = remapAdminCandidateValue(name, raw, adminIdMapping);
+        const value = (name === "adminId" || name === "municipalityId" || name === "prefectureRegionId")
+          ? mapped
+          : idOffset && raw >= 0 ? raw + idOffset : raw;
+        if (name === "sea" && oldSea && dest[wi] !== value) coastCellsChanged++;
+        if ((name === "naturalCompartmentId" || name === "watershedId" || name === "regionId") && dest[wi] !== value) naturalRegionsUpdated++;
+        if ((name === "adminId" || name === "municipalityId") && dest[wi] !== value) adminCellsReassigned++;
+        if (name === "landuse" && dest[wi] !== value) landUseCellsUpdated++;
+        dest[wi] = value;
+      } else {
+        const before = dest[wi] || 0;
+        let candidateValue = source[si] || 0;
+        if (name === "elevation") candidateValue = adjustedCandidateElevation(candidateValue, x, y, elevationAdjustment, rects);
+        dest[wi] = lerp(before, candidateValue, blendAlpha);
+      }
+
+      if (name === "elevation") {
+        updatedCells++;
+        if (blendAlpha > 0.94) terrainCellsFullyReplaced++;
+      }
+    }
+  }
+
+  // Water is derived from the blended elevation against the immutable world
+  // sea level. Candidate-local water quantiles are never copied into the world.
+  const waterClassificationDebug = applyTerrainBoundaryContract(world, rects, terrainContract, seed, "post-field-copy");
+
+  // The legacy full pipeline uses `adminId` as the municipality raster and
+  // assigns municipality metadata on `adminCenters`; it does not expose a
+  // separate municipalityId cell field.  If an old experimental field exists,
+  // keep it synchronized with the canonical legacy adminId instead of leaving
+  // stale numeric/one-municipality data in regenerated patches.
+  if (world.fields.adminId && !candidate?.municipalityId) {
+    const expected = world.width * world.height;
+    if (!world.fields.municipalityId || world.fields.municipalityId.length !== expected) {
+      world.fields.municipalityId = new Int32Array(expected);
+      world.fields.municipalityId.fill(-1);
+    }
+    const municipalityId = world.fields.municipalityId;
+    const adminId = world.fields.adminId;
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const wi = worldIndexOf(world, x, y);
+        if (wi >= 0) municipalityId[wi] = adminId[wi];
+      }
+    }
+  }
+
+  // Keep water fields coherent after all continuous fields have been blended.
+  const sea = world.fields.sea;
+  const ocean = world.fields.ocean;
+  const lake = world.fields.lake;
+  const landuse = world.fields.landuse;
+  if (sea) {
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0) continue;
+        if (sea[i]) {
+          if (ocean) ocean[i] = 1;
+          if (lake) lake[i] = 0;
+          if (landuse) landuse[i] = LANDUSE.WATER || 0;
+        } else {
+          if (ocean) ocean[i] = 0;
+          if (lake) lake[i] = 0;
+        }
+      }
+    }
+  }
+
+  const humanLandDebug = restoreHumanLandContinuity(world, sourceMap, rects, oldSea, oldLanduse, oldHumanFields, seed, seaLevel);
+  const continuityDebug = stabilizeContinuitySeam(world, rects, oldContinuityFields, seed);
+  const seamOwnershipDebug = repairDiscreteSeamOwnership(world, rects, oldContinuityFields, seed);
+  if (world.fields.adminId && world.fields.municipalityId && !candidate?.municipalityId) {
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const wi = worldIndexOf(world, x, y);
+        if (wi >= 0) world.fields.municipalityId[wi] = world.fields.adminId[wi];
+      }
+    }
+  }
+
+  return {
+    window,
+    updatedCells,
+    terrainCellsFullyReplaced,
+    coastCellsChanged,
+    naturalRegionsUpdated,
+    adminCellsReassigned,
+    landUseCellsUpdated,
+    adminIdMapping,
+    adminIdMappingDebug: summarizeIdMapping(adminIdMapping),
+    worldSeaLevel: seaLevel,
+    candidateSeaLevel,
+    seaLevelBaseOffset,
+    waterClassificationDebug,
+    terrainSeamAdjustmentSamples: elevationAdjustment?.samples || 0,
+    terrainSeamElevationOffset: elevationAdjustment ? Math.round((elevationAdjustment.offset || 0) * 10000) / 10000 : 0,
+    terrainSeamElevationTiltX: elevationAdjustment ? Math.round((elevationAdjustment.tiltX || 0) * 10000) / 10000 : 0,
+    terrainSeamElevationTiltY: elevationAdjustment ? Math.round((elevationAdjustment.tiltY || 0) * 10000) / 10000 : 0,
+    ...humanLandDebug,
+    ...continuityDebug,
+    ...seamOwnershipDebug,
+  };
+}
+
+
+function repairDisplayMasks(world, rects, seed = 0) {
+  const expected = world.width * world.height;
+  if (!world.fields.prefectureMask || world.fields.prefectureMask.length !== expected) world.fields.prefectureMask = new Uint8Array(expected);
+  if (!world.fields.landMask || world.fields.landMask.length !== expected) world.fields.landMask = new Uint8Array(expected);
+  if (!world.fields.humanRegionMask || world.fields.humanRegionMask.length !== expected) world.fields.humanRegionMask = new Uint8Array(expected);
+  const coverage = world.fields.prefectureMask;
+  const landMask = world.fields.landMask;
+  const humanMask = world.fields.humanRegionMask;
+  const sea = world.fields.sea;
+  let displayMaskUpdated = 0;
+  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      const a = patchAlpha(x, y, rects, seed);
+      if (a <= 0.08) continue;
+      if (!coverage[i]) displayMaskUpdated++;
+      coverage[i] = 1;
+      const isSea = Boolean(sea?.[i]);
+      humanMask[i] = isSea ? 0 : 1;
+      landMask[i] = isSea ? 0 : 1;
+    }
+  }
+  return { displayMaskUpdated };
+}
+
+function featherTerrainSeam(world, rects, seed = 0) {
+  const fields = world.fields || {};
+  const smoothKeys = [
+    "elevation", "moisture", "ridgeField", "valleyField", "visibleRavineField",
+    "basinField", "coastalLowland", "plain", "agriculture", "erosionField",
+    "depositionField", "depositionalLowland", "alluvialFanField", "deltaField",
+    "naturalBarrierScore", "settlementScore", "populationDensity",
+  ];
+  let terrainFeatherCells = 0;
+  let terrainFeatherValues = 0;
+
+  // Earlier versions cloned each whole typed array here.  After the world grows,
+  // that made every patch pay for global memory copies.  The seam smoother only
+  // samples the write rectangle and its one-cell neighborhood, so snapshot just
+  // that local window.
+  const sampleRect = expandRect(rects.writeRect, 1, world);
+  const sw = rectWidth(sampleRect);
+  const localOffset = (x, y) => (y - sampleRect.y0) * sw + (x - sampleRect.x0);
+
+  for (const key of smoothKeys) {
+    const field = fields[key];
+    if (!field || !ArrayBuffer.isView(field)) continue;
+    const old = new field.constructor(sw * rectHeight(sampleRect));
+    for (let y = sampleRect.y0; y < sampleRect.y1; y++) {
+      for (let x = sampleRect.x0; x < sampleRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i >= 0) old[localOffset(x, y)] = field[i] || 0;
+      }
+    }
+    const oldValue = (x, y) => {
+      if (insideRect(x, y, sampleRect)) return old[localOffset(x, y)] || 0;
+      const i = worldIndexOf(world, x, y);
+      return i >= 0 ? (field[i] || 0) : 0;
+    };
+
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        if (patchBand(x, y, rects, seed) !== "feather") continue;
+        const i = worldIndexOf(world, x, y);
+        if (i < 0 || fields.sea?.[i]) continue;
+        let sum = 0;
+        let count = 0;
+        for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+          const ni = worldIndexOf(world, x + dx, y + dy);
+          if (ni >= 0 && !fields.sea?.[ni]) {
+            sum += oldValue(x + dx, y + dy);
+            count++;
+          }
+        }
+        if (!count) continue;
+        const a = patchAlpha(x, y, rects, seed);
+        const gradient = patchAlphaGradient(x, y, rects, seed);
+        const neighborMean = sum / count;
+        const centerWeight = 0.30 * (1 - Math.min(1, Math.abs(a - 0.5) * 1.35));
+        const seamWeight = clamp(0.08 + centerWeight + gradient * 0.62, 0.10, key === "elevation" ? 0.46 : 0.38);
+        field[i] = lerp(field[i] || 0, neighborMean, seamWeight);
+        terrainFeatherValues++;
+        if (key === "elevation") terrainFeatherCells++;
+      }
+    }
+  }
+  return { terrainFeatherCells, terrainFeatherValues };
+}
+
+function smoothExtremeElevationSeams(world, rects, seed = 0, seaLevel = 0.30) {
+  const fields = world.fields || {};
+  const elevation = fields.elevation;
+  const sea = fields.sea;
+  if (!elevation || !rects?.writeRect) return { elevationCliffCellsSmoothed: 0, elevationCliffMaxDelta: 0, elevationBridgePasses: 0 };
+  const rect = rects.writeRect;
+  const sampleRect = expandRect(rect, 1, world);
+  const sw = rectWidth(sampleRect);
+  const sh = rectHeight(sampleRect);
+  const offset = (x, y) => (y - sampleRect.y0) * sw + (x - sampleRect.x0);
+  const dirs4 = [[1,0],[-1,0],[0,1],[0,-1]];
+  const dirs8 = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
+  let cells = 0;
+  let maxDelta = 0;
+  let elevationBridgePasses = 0;
+
+  // This pass is intentionally stronger than the previous cliff-only filter.
+  // The seam can connect high mountains, low hills, plains, and sea in one patch;
+  // a local threshold leaves visible walls.  We smooth the generated side across
+  // the whole inward feather band, with larger force near preserved cells and
+  // near coastlines.  The outside/preserved side is never written.
+  for (let pass = 0; pass < 8; pass++) {
+    const old = new Float32Array(sw * sh);
+    for (let y = sampleRect.y0; y < sampleRect.y1; y++) {
+      for (let x = sampleRect.x0; x < sampleRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i >= 0) old[offset(x, y)] = elevation[i] || 0;
+      }
+    }
+    let passCells = 0;
+    for (let y = rect.y0; y < rect.y1; y++) {
+      for (let x = rect.x0; x < rect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0) continue;
+        const a = patchAlpha(x, y, rects, seed);
+        if (!patchTerrainWritable(rects, x, y, seed) || a >= 0.94) continue;
+        const here = old[offset(x, y)] || 0;
+        const hereSea = !!sea?.[i];
+        let sum = 0;
+        let wsum = 0;
+        let lessGeneratedContacts = 0;
+        let seaContacts = 0;
+        let landContacts = 0;
+        let strongest = 0;
+        for (const [dx, dy] of dirs8) {
+          const nx = x + dx, ny = y + dy;
+          const ni = worldIndexOf(world, nx, ny);
+          if (ni < 0) continue;
+          const na = patchAlpha(nx, ny, rects, seed);
+          // We can pull the generated seam toward preserved or less-generated
+          // neighbors.  Pulling toward deeper core cells would blur intentional
+          // candidate landforms, so keep that side weak.
+          const lessGenerated = na < a + 0.10 || !insideRect(nx, ny, rect);
+          const nv = insideRect(nx, ny, sampleRect) ? old[offset(nx, ny)] : (elevation[ni] || 0);
+          const nSea = !!sea?.[ni];
+          if (nSea) seaContacts++; else landContacts++;
+          if (lessGenerated) lessGeneratedContacts++;
+          const diag = Math.abs(dx) + Math.abs(dy) === 2;
+          const w = (lessGenerated ? 1.35 : 0.32) * (diag ? 0.72 : 1.0) * (nSea === hereSea ? 1.0 : 0.82);
+          sum += nv * w;
+          wsum += w;
+          strongest = Math.max(strongest, Math.abs(here - nv));
+        }
+        if (!wsum || !lessGeneratedContacts) continue;
+        let target = sum / wsum;
+        const coastalMix = seaContacts > 0 && landContacts > 0;
+        if (coastalMix) {
+          // Avoid mountain/sea hard cuts.  Land near a preserved sea seam becomes
+          // low coastal ground; sea near land becomes a shallow shelf.
+          const coastalLand = seaLevel + 0.030 + patchWorldNoise(rects, x, y, seed ^ 0x8ac3f51, 13) * 0.035;
+          const coastalSea = seaLevel - 0.035 - patchWorldNoise(rects, x, y, seed ^ 0x1c69b3e, 17) * 0.030;
+          target = hereSea ? lerp(target, coastalSea, 0.55) : lerp(target, coastalLand, 0.48);
+        }
+        const diff = Math.abs(here - target);
+        const severity = clamp((Math.max(diff, strongest * 0.7) - 0.018) / 0.22);
+        if (severity <= 0.01 && !coastalMix) continue;
+        const edgeForce = clamp(1.08 - a * 0.82, 0.18, 1.0);
+        const coastalForce = coastalMix ? 0.22 : 0;
+        const weight = clamp(0.16 + severity * 0.58 + coastalForce, 0.16, 0.78) * edgeForce;
+        elevation[i] = clamp(lerp(elevation[i], target, weight), 0, 1);
+        maxDelta = Math.max(maxDelta, diff, strongest);
+        passCells++;
+      }
+    }
+    if (!passCells) break;
+    elevationBridgePasses++;
+    cells += passCells;
+  }
+
+  // Reconcile visible lowland fields after the elevation bridge.  These fields
+  // are continuous display/settlement aids; keeping the pre-bridge values is a
+  // common cause of highland colors ending abruptly at the patch edge.
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      const a = patchAlpha(x, y, rects, seed);
+      if (!patchTerrainWritable(rects, x, y, seed) || a >= 0.94) continue;
+      const e = elevation[i] || 0;
+      const lowland = clamp((seaLevel + 0.16 - e) * 2.2);
+      const oldPlain = fields.plain?.[i] || 0;
+      if (fields.coastalLowland) fields.coastalLowland[i] = clamp(lerp(fields.coastalLowland[i] || 0, lowland, 0.42 * (1 - a * 0.55)));
+      if (fields.plain) fields.plain[i] = clamp(lerp(oldPlain, lowland * (1 - (fields.slope?.[i] || 0) * 0.55), 0.38 * (1 - a * 0.45)));
+      if (fields.agriculture && fields.plain) fields.agriculture[i] = clamp(lerp(fields.agriculture[i] || 0, fields.plain[i], 0.24 * (1 - a * 0.45)));
+    }
+  }
+  return { elevationCliffCellsSmoothed: cells, elevationCliffMaxDelta: Math.round(maxDelta * 10000) / 10000, elevationBridgePasses };
+}
+
+function averageNearbyLandElevation(world, x, y, maxRadius = 5) {
+  const elevation = world.fields?.elevation;
+  const sea = world.fields?.sea;
+  if (!elevation) return null;
+  for (let r = 1; r <= maxRadius; r++) {
+    let sum = 0;
+    let count = 0;
+    for (let yy = y - r; yy <= y + r; yy++) {
+      for (let xx = x - r; xx <= x + r; xx++) {
+        if (Math.max(Math.abs(xx - x), Math.abs(yy - y)) !== r) continue;
+        const i = worldIndexOf(world, xx, yy);
+        if (i >= 0 && !sea?.[i] && Number.isFinite(elevation[i])) { sum += elevation[i]; count++; }
+      }
+    }
+    if (count) return sum / count;
+  }
+  return null;
+}
+
+function fillTinyResidualSeas(world, rects, seaLevel = 0.30, seed = 0, options = {}) {
+  const sea = world.fields?.sea;
+  if (!sea || !rects?.writeRect) return { residualSeaPatchesFilled: 0, residualSeaCellsFilled: 0 };
+  const rect = rects.writeRect;
+  const rw = rectWidth(rect);
+  const rh = rectHeight(rect);
+  const visited = new Uint8Array(rw * rh);
+  const local = (x, y) => (y - rect.y0) * rw + (x - rect.x0);
+  const dirs4 = [[1,0],[-1,0],[0,1],[0,-1]];
+  const dirs8 = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
+  const aggressive = !!options.aggressive;
+  const preservePockets = !!options.preservePockets;
+  const baseMax = Math.floor((rw * rh) * (aggressive ? 0.0075 : 0.0025));
+  const maxComponent = Math.max(aggressive ? 36 : 8, Math.min(aggressive ? 260 : 72, baseMax));
+  let patches = 0;
+  let cellsFilled = 0;
+
+  for (let sy = rect.y0; sy < rect.y1; sy++) {
+    for (let sx = rect.x0; sx < rect.x1; sx++) {
+      const startLocal = local(sx, sy);
+      if (visited[startLocal]) continue;
+      const startIndex = worldIndexOf(world, sx, sy);
+      if (startIndex < 0 || !sea[startIndex]) { visited[startLocal] = 1; continue; }
+
+      const queue = [[sx, sy]];
+      const cells = [];
+      visited[startLocal] = 1;
+      let touchesOutside = false;
+      let landContacts4 = 0;
+      let waterContacts4 = 0;
+      let landContacts8 = 0;
+      let waterContacts8 = 0;
+      let maxAlpha = 0;
+      let minAlpha = 1;
+      let seamTouches = 0;
+      for (let qi = 0; qi < queue.length; qi++) {
+        const [x, y] = queue[qi];
+        cells.push([x, y]);
+        const a = patchAlpha(x, y, rects, seed);
+        maxAlpha = Math.max(maxAlpha, a);
+        minAlpha = Math.min(minAlpha, a);
+        if (a < (aggressive ? 0.52 : 0.34)) seamTouches++;
+        if (x <= rect.x0 || y <= rect.y0 || x >= rect.x1 - 1 || y >= rect.y1 - 1) touchesOutside = true;
+        for (const [dx, dy] of dirs4) {
+          const nx = x + dx, ny = y + dy;
+          if (!insideRect(nx, ny, rect)) { touchesOutside = true; continue; }
+          const ni = worldIndexOf(world, nx, ny);
+          if (ni < 0) { touchesOutside = true; continue; }
+          if (sea[ni]) {
+            const li = local(nx, ny);
+            if (!visited[li]) { visited[li] = 1; queue.push([nx, ny]); }
+            waterContacts4++;
+          } else {
+            landContacts4++;
+          }
+        }
+        for (const [dx, dy] of dirs8) {
+          const ni = worldIndexOf(world, x + dx, y + dy);
+          if (ni < 0) continue;
+          if (sea[ni]) waterContacts8++; else landContacts8++;
+        }
+        if (cells.length > maxComponent * 4) break;
+      }
+
+      // Fill small enclosed water remnants at or near the inward seam.  Stage 12
+      // was intentionally conservative and therefore missed the common hand-jitter
+      // case: a tiny ungenerated sea pocket just inside the blue outline.  This
+      // pass is still topological: components touching the patch edge, long bays,
+      // and real channels remain water.
+      const surrounded4 = landContacts4 >= waterContacts4 * (aggressive ? 1.12 : 2.2);
+      const surrounded8 = landContacts8 >= waterContacts8 * (aggressive ? 0.92 : 1.65);
+      const seamish = seamTouches >= Math.max(1, Math.floor(cells.length * (aggressive ? 0.12 : 0.30))) || minAlpha < 0.18;
+      const alphaOk = preservePockets ? maxAlpha <= 0.88 : maxAlpha <= (aggressive ? 0.84 : 0.70);
+      if (touchesOutside || cells.length > maxComponent || !alphaOk || !seamish || !(surrounded4 || surrounded8)) continue;
+
+      for (const [x, y] of cells) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0) continue;
+        sea[i] = 0;
+        if (world.fields.ocean) world.fields.ocean[i] = 0;
+        if (world.fields.lake) world.fields.lake[i] = 0;
+        if (world.fields.elevation) {
+          const nearby = averageNearbyLandElevation(world, x, y, aggressive ? 9 : 5);
+          const target = nearby == null ? seaLevel + 0.035 : Math.max(seaLevel + 0.025, nearby * 0.72 + (seaLevel + 0.05) * 0.28);
+          world.fields.elevation[i] = clamp(target, seaLevel + 0.012, seaLevel + 0.28);
+        }
+        if (world.fields.plain) world.fields.plain[i] = Math.max(world.fields.plain[i] || 0, 0.38);
+        if (world.fields.coastalLowland) world.fields.coastalLowland[i] = Math.max(world.fields.coastalLowland[i] || 0, 0.46);
+        cellsFilled++;
+      }
+      patches++;
+    }
+  }
+  return { residualSeaPatchesFilled: patches, residualSeaCellsFilled: cellsFilled };
+}
+
+function nearestLandFieldValue(world, x, y, fieldName, rect, options = {}) {
+  const field = world.fields?.[fieldName];
+  const sea = world.fields?.sea;
+  if (!field) return -1;
+  const maxRadius = Math.max(1, Math.floor(options.maxRadius || 18));
+  const requiredPref = Number.isFinite(options.requiredPref) ? Math.floor(options.requiredPref) : null;
+  const prefField = world.fields?.prefectureRegionId;
+  for (let r = 1; r <= maxRadius; r++) {
+    let best = -1;
+    let bestD = Infinity;
+    const y0 = Math.max(0, y - r);
+    const y1 = Math.min(world.height - 1, y + r);
+    const x0 = Math.max(0, x - r);
+    const x1 = Math.min(world.width - 1, x + r);
+    for (let yy = y0; yy <= y1; yy++) {
+      for (let xx = x0; xx <= x1; xx++) {
+        if (Math.max(Math.abs(xx - x), Math.abs(yy - y)) !== r) continue;
+        if (rect && !insideRect(xx, yy, rect)) continue;
+        const i = worldIndexOf(world, xx, yy);
+        if (i < 0 || sea?.[i]) continue;
+        if (requiredPref !== null && prefField?.[i] !== requiredPref) continue;
+        const id = field[i];
+        if (!Number.isFinite(id) || id < 0) continue;
+        const d = Math.hypot(xx - x, yy - y);
+        if (d < bestD) { best = Math.floor(id); bestD = d; }
+      }
+    }
+    if (best >= 0) return best;
+  }
+  return -1;
+}
+
+function lookupPrefectureForAdmin(sourceMap, adminIdMapping, adminId) {
+  if (!Number.isFinite(adminId) || adminId < 0) return -1;
+  const id = Math.floor(adminId);
+  const mapped = adminIdMapping?.municipalityToPrefecture?.get(id);
+  if (Number.isFinite(mapped) && mapped >= 0) return Math.floor(mapped);
+  const table = sourceMap?.municipalityToPrefectureId;
+  if (table && id >= 0 && id < table.length && Number.isFinite(table[id]) && table[id] >= 0) return Math.floor(table[id]);
+  return -1;
+}
+
+function repairAdminCoverage(world, sourceMap, rects, adminIdMapping = null, seed = 0) {
+  const admin = world.fields?.adminId;
+  if (!admin) return { seaAdminCellsCleared: 0, landAdminCellsFilled: 0, prefectureCellsFilled: 0, adminPrefectureCellsAligned: 0 };
+  const expected = world.width * world.height;
+  if (!world.fields.municipalityId || world.fields.municipalityId.length !== expected) {
+    world.fields.municipalityId = new Int32Array(expected);
+    world.fields.municipalityId.fill(-1);
+  }
+  if (!world.fields.prefectureRegionId || world.fields.prefectureRegionId.length !== expected) {
+    world.fields.prefectureRegionId = new Int32Array(expected);
+    world.fields.prefectureRegionId.fill(-1);
+  }
+  const municipality = world.fields.municipalityId;
+  const prefecture = world.fields.prefectureRegionId;
+  const sea = world.fields.sea;
+  const coverage = world.fields.prefectureMask;
+  let seaAdminCellsCleared = 0;
+  let landAdminCellsFilled = 0;
+  let prefectureCellsFilled = 0;
+  let adminPrefectureCellsAligned = 0;
+
+  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      if (sea?.[i]) {
+        if (admin[i] >= 0 || municipality[i] >= 0 || prefecture[i] >= 0) seaAdminCellsCleared++;
+        admin[i] = -1;
+        municipality[i] = -1;
+        prefecture[i] = -1;
+        continue;
+      }
+      const generated = patchAlpha(x, y, rects, seed) > 0.08 || (!coverage && insideRect(x, y, rects.writeRect));
+      if (!generated) continue;
+
+      if (admin[i] < 0) {
+        const preferredPref = prefecture[i] >= 0 ? prefecture[i] : null;
+        let nearest = nearestLandFieldValue(world, x, y, 'adminId', rects.repairRect || rects.writeRect, { requiredPref: preferredPref, maxRadius: 24 });
+        if (nearest < 0) nearest = nearestLandFieldValue(world, x, y, 'adminId', null, { requiredPref: preferredPref, maxRadius: 18 });
+        if (nearest >= 0) {
+          admin[i] = nearest;
+          municipality[i] = nearest;
+          landAdminCellsFilled++;
+        }
+      }
+      if (municipality[i] < 0 && admin[i] >= 0) municipality[i] = admin[i];
+      if (admin[i] >= 0 && municipality[i] !== admin[i]) municipality[i] = admin[i];
+
+      let targetPref = lookupPrefectureForAdmin(sourceMap, adminIdMapping, admin[i]);
+      if (targetPref < 0 && prefecture[i] < 0) targetPref = nearestLandFieldValue(world, x, y, 'prefectureRegionId', rects.repairRect || rects.writeRect, { maxRadius: 28 });
+      if (targetPref >= 0 && prefecture[i] !== targetPref) {
+        if (prefecture[i] < 0) prefectureCellsFilled++;
+        else adminPrefectureCellsAligned++;
+        prefecture[i] = targetPref;
+      } else if (prefecture[i] < 0) {
+        const nearestPref = nearestLandFieldValue(world, x, y, 'prefectureRegionId', null, { maxRadius: 22 });
+        if (nearestPref >= 0) { prefecture[i] = nearestPref; prefectureCellsFilled++; }
+      }
+    }
+  }
+
+  const current = sourceMap?.municipalityToPrefectureId;
+  let maxId = current?.length ? current.length - 1 : -1;
+  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i >= 0 && admin[i] >= 0 && prefecture[i] >= 0) maxId = Math.max(maxId, admin[i]);
+    }
+  }
+  if (sourceMap && maxId >= 0) {
+    const next = new Int32Array(maxId + 1);
+    next.fill(-1);
+    if (current) for (let i = 0; i < current.length && i < next.length; i++) next[i] = current[i] ?? -1;
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i >= 0 && admin[i] >= 0 && prefecture[i] >= 0) next[admin[i]] = prefecture[i];
+      }
+    }
+    sourceMap.municipalityToPrefectureId = next;
+  }
+
+  return { seaAdminCellsCleared, landAdminCellsFilled, prefectureCellsFilled, adminPrefectureCellsAligned };
+}
+
+function protectedAdministrativeCells(world, fieldName, rect) {
+  const protectedCells = new Set();
+  const sourceMap = world?.sourceMap || {};
+  const pointKeys = fieldName === "prefectureRegionId" ? ["prefectureRegions"] : ["adminCenters"];
+  const field = world?.fields?.[fieldName];
+  if (!field) return protectedCells;
+  for (const key of pointKeys) {
+    for (const p of sourceMap[key] || []) {
+      // A newly generated prefecture marker must not immunize a tiny sliver
+      // prefecture from topology cleanup. Existing administrative anchors stay
+      // protected, while generated regions are allowed to merge when undersized.
+      if (fieldName === "prefectureRegionId" && p?.patchGenerated) continue;
+      const x = Math.round(pointWorldX(world, p));
+      const y = Math.round(pointWorldY(world, p));
+      if (!insideRect(x, y, rect)) continue;
+      const i = worldIndexOf(world, x, y);
+      if (i >= 0 && field[i] >= 0) protectedCells.add(i);
+    }
+  }
+  return protectedCells;
+}
+
+function modeFromCounts(counts) {
+  let best = -1;
+  let bestCount = 0;
+  for (const [id, count] of counts || []) {
+    if (count > bestCount || (count === bestCount && id < best)) {
+      best = id;
+      bestCount = count;
+    }
+  }
+  return best;
+}
+
+function addNestedVote(map, key, value, weight = 1) {
+  if (!Number.isFinite(key) || key < 0 || !Number.isFinite(value) || value < 0) return;
+  const id = Math.floor(key);
+  const bucket = map.get(id) || new Map();
+  bucket.set(Math.floor(value), (bucket.get(Math.floor(value)) || 0) + weight);
+  map.set(id, bucket);
+}
+
+function cleanupDiscreteFieldComponents(world, fieldName, rect, options = {}) {
+  const field = world?.fields?.[fieldName];
+  const sea = world?.fields?.sea;
+  if (!field || !rect) return { componentsMerged: 0, cellsMerged: 0 };
+  const minCells = Math.max(1, Math.floor(options.minCells || 80));
+  const passes = Math.max(1, Math.floor(options.passes || 2));
+  const respectPrefecture = !!options.respectPrefecture;
+  const pref = world.fields?.prefectureRegionId;
+  const protectedCells = protectedAdministrativeCells(world, fieldName, rect);
+  const dirs = [[1,0],[-1,0],[0,1],[0,-1]];
+  let componentsMerged = 0;
+  let cellsMerged = 0;
+
+  for (let pass = 0; pass < passes; pass++) {
+    const seen = new Uint8Array(world.width * world.height);
+    const reassignments = [];
+
+    for (let y = rect.y0; y < rect.y1; y++) {
+      for (let x = rect.x0; x < rect.x1; x++) {
+        const start = worldIndexOf(world, x, y);
+        if (start < 0 || seen[start] || sea?.[start] || field[start] < 0) continue;
+
+        const id = field[start];
+        const stack = [start];
+        seen[start] = 1;
+        const cells = [];
+        const neighborVotes = new Map();
+        const neighborPrefVotes = new Map();
+        const ownPrefVotes = new Map();
+        let touchesRectEdge = false;
+        let hasProtectedPoint = false;
+
+        while (stack.length) {
+          const ci = stack.pop();
+          const cx = ci % world.width;
+          const cy = Math.floor(ci / world.width);
+          cells.push(ci);
+          if (protectedCells.has(ci)) hasProtectedPoint = true;
+          if (cx <= rect.x0 || cy <= rect.y0 || cx >= rect.x1 - 1 || cy >= rect.y1 - 1) touchesRectEdge = true;
+          if (pref?.[ci] >= 0) ownPrefVotes.set(pref[ci], (ownPrefVotes.get(pref[ci]) || 0) + 1);
+
+          for (const [dx, dy] of dirs) {
+            const nx = cx + dx;
+            const ny = cy + dy;
+            const ni = worldIndexOf(world, nx, ny);
+            if (ni < 0 || sea?.[ni]) continue;
+            const nid = field[ni];
+            if (insideRect(nx, ny, rect) && nid === id && !seen[ni]) {
+              seen[ni] = 1;
+              stack.push(ni);
+            } else if (nid >= 0 && nid !== id) {
+              neighborVotes.set(nid, (neighborVotes.get(nid) || 0) + 1);
+              if (pref?.[ni] >= 0) addNestedVote(neighborPrefVotes, nid, pref[ni], 1);
+            }
+          }
+        }
+
+        // Components touching the cleanup rectangle boundary may be only the
+        // visible slice of a large outside municipality/prefecture.  Preserve
+        // those unless they are extremely small; otherwise patched seams can
+        // erase legitimate existing regions.
+        const clippedLargeOutsideRegion = touchesRectEdge && cells.length >= Math.floor(minCells * 0.55);
+        if (hasProtectedPoint || clippedLargeOutsideRegion || cells.length >= minCells || !neighborVotes.size) continue;
+
+        const componentPref = respectPrefecture ? modeFromCounts(ownPrefVotes) : -1;
+        let bestTarget = -1;
+        let bestScore = -Infinity;
+        for (const [target, count] of neighborVotes) {
+          let score = count;
+          if (respectPrefecture && componentPref >= 0) {
+            const targetPref = modeFromCounts(neighborPrefVotes.get(target));
+            if (targetPref === componentPref) score += count * 0.85;
+            else score -= count * 0.45;
+          }
+          if (score > bestScore || (score === bestScore && target < bestTarget)) {
+            bestTarget = target;
+            bestScore = score;
+          }
+        }
+        if (bestTarget < 0) continue;
+        for (const ci of cells) reassignments.push([ci, bestTarget]);
+        componentsMerged++;
+        cellsMerged += cells.length;
+      }
+    }
+
+    if (!reassignments.length) break;
+    for (const [i, target] of reassignments) field[i] = target;
+  }
+
+  return { componentsMerged, cellsMerged };
+}
+
+
+function nearestDifferentPrefecture(world, x, y, ownId, maxRadius = 36) {
+  const prefecture = world.fields?.prefectureRegionId;
+  const sea = world.fields?.sea;
+  if (!prefecture) return -1;
+  for (let r = 1; r <= maxRadius; r++) {
+    for (let dy = -r; dy <= r; dy++) {
+      for (const dx of [-r, r]) {
+        const i = worldIndexOf(world, x + dx, y + dy);
+        if (i >= 0 && !sea?.[i] && prefecture[i] >= 0 && prefecture[i] !== ownId) return Math.floor(prefecture[i]);
+      }
+    }
+    for (let dx = -r + 1; dx <= r - 1; dx++) {
+      for (const dy of [-r, r]) {
+        const i = worldIndexOf(world, x + dx, y + dy);
+        if (i >= 0 && !sea?.[i] && prefecture[i] >= 0 && prefecture[i] !== ownId) return Math.floor(prefecture[i]);
+      }
+    }
+  }
+  return -1;
+}
+
+function mergeTinyGeneratedPrefectures(world, sourceMap, rects, adminIdMapping, options = {}) {
+  const allocated = adminIdMapping?.allocatedPrefectureIds instanceof Set
+    ? adminIdMapping.allocatedPrefectureIds
+    : new Set();
+  const debug = { tinyGeneratedPrefecturesMerged: 0, tinyGeneratedPrefectureCellsMerged: 0, tinyGeneratedPrefectureThreshold: 0 };
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || !allocated.size) return debug;
+  const prefecture = world.fields?.prefectureRegionId;
+  const admin = world.fields?.adminId;
+  const sea = world.fields?.sea;
+  if (!prefecture || !sea) return debug;
+
+  const selectedArea = Math.max(1, rectArea(rects.coreRect));
+  const minCells = Math.max(650, Math.min(1400, Math.floor(selectedArea * 0.012)));
+  debug.tinyGeneratedPrefectureThreshold = minCells;
+  const stats = new Map();
+  for (const id of allocated) stats.set(id, { count: 0, sx: 0, sy: 0, border: new Map(), admins: new Set() });
+  const dirs = [[1,0],[-1,0],[0,1],[0,-1]];
+  for (let y = 0; y < world.height; y++) {
+    for (let x = 0; x < world.width; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0 || sea[i]) continue;
+      const id = prefecture[i];
+      const st = stats.get(id);
+      if (!st) continue;
+      st.count++; st.sx += x; st.sy += y;
+      if (admin?.[i] >= 0) st.admins.add(Math.floor(admin[i]));
+      for (const [dx,dy] of dirs) {
+        const ni = worldIndexOf(world, x + dx, y + dy);
+        if (ni < 0 || sea[ni]) continue;
+        const other = prefecture[ni];
+        if (other >= 0 && other !== id) st.border.set(other, (st.border.get(other) || 0) + 1);
+      }
+    }
+  }
+
+  const remap = new Map();
+  for (const [id, st] of stats) {
+    if (!st.count || st.count >= minCells) continue;
+    let target = -1;
+    let bestVotes = 0;
+    for (const [other, votes] of st.border) {
+      if (votes > bestVotes) { bestVotes = votes; target = Math.floor(other); }
+    }
+    if (target < 0) {
+      const cx = Math.round(st.sx / Math.max(1, st.count));
+      const cy = Math.round(st.sy / Math.max(1, st.count));
+      target = nearestDifferentPrefecture(world, cx, cy, id, 36);
+    }
+    if (target >= 0) remap.set(id, target);
+  }
+  if (!remap.size) return debug;
+
+  for (let i = 0; i < prefecture.length; i++) {
+    if (sea[i]) continue;
+    const target = remap.get(prefecture[i]);
+    if (target == null) continue;
+    prefecture[i] = target;
+    debug.tinyGeneratedPrefectureCellsMerged++;
+  }
+  debug.tinyGeneratedPrefecturesMerged = remap.size;
+
+  if (Array.isArray(sourceMap?.prefectureRegions)) {
+    sourceMap.prefectureRegions = sourceMap.prefectureRegions.filter((p) => !remap.has(metadataIdForLayer(p, "prefectureRegions")));
+  }
+  for (const center of sourceMap?.adminCenters || []) {
+    const prefId = numericFeatureId(center, ["prefectureRegionId", "prefectureId"]);
+    if (remap.has(prefId)) center.prefectureRegionId = remap.get(prefId);
+  }
+  if (sourceMap?.municipalityToPrefectureId) {
+    const next = sourceMap.municipalityToPrefectureId.slice();
+    for (let i = 0; i < (admin?.length || 0); i++) {
+      const adminId = admin[i];
+      if (adminId >= 0 && prefecture[i] >= 0 && adminId < next.length) next[adminId] = prefecture[i];
+    }
+    sourceMap.municipalityToPrefectureId = next;
+  }
+  for (const [from, to] of remap) allocated.delete(from);
+  return debug;
+}
+
+
+function strictSnapshotFieldValue(snapshot, name, x, y) {
+  const data = snapshot?.fields?.get(name);
+  const rect = snapshot?.rect;
+  if (!data || !rect || x < rect.x0 || y < rect.y0 || x >= rect.x1 || y >= rect.y1) return undefined;
+  return data[(y - rect.y0) * snapshot.width + (x - rect.x0)];
+}
+
+function harmonizeExpansionAdministrativeFrontier(world, rects, seed = 0, strictSnapshot = null) {
+  const debug = { frontierAdminCellsAligned: 0, frontierPrefectureCellsAligned: 0, establishedFrontierAdminCellsRestored: 0, establishedFrontierPrefectureCellsRestored: 0 };
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || !rects?._generatedCoverage) return debug;
+  const admin = world.fields?.adminId;
+  const municipality = world.fields?.municipalityId;
+  const prefecture = world.fields?.prefectureRegionId;
+  const sea = world.fields?.sea;
+  if (!admin || !prefecture || !sea) return debug;
+  const rect = rects.writeRect;
+  // Keep the established side authoritative in a narrow collar. Candidate admin
+  // rasters are allowed to overlap old cells for continuity solving, but they must
+  // not move an existing municipal boundary onto the patch frontier itself.
+  if (strictSnapshot) {
+    for (let y = rect.y0; y < rect.y1; y++) {
+      for (let x = rect.x0; x < rect.x1; x++) {
+        if (!wasGeneratedAt(rects, x, y)) continue;
+        const d = coverageDistanceAt(rects, x, y, "ungenerated");
+        if (d < 1 || d > 3) continue;
+        const i = worldIndexOf(world, x, y);
+        if (i < 0 || sea[i]) continue;
+        const oldAdmin = strictSnapshotFieldValue(strictSnapshot, "adminId", x, y);
+        const oldMunicipality = strictSnapshotFieldValue(strictSnapshot, "municipalityId", x, y);
+        const oldPref = strictSnapshotFieldValue(strictSnapshot, "prefectureRegionId", x, y);
+        if (Number.isFinite(oldPref) && oldPref >= 0 && prefecture[i] !== oldPref) { prefecture[i] = oldPref; debug.establishedFrontierPrefectureCellsRestored++; }
+        if (Number.isFinite(oldAdmin) && oldAdmin >= 0 && admin[i] !== oldAdmin) { admin[i] = oldAdmin; debug.establishedFrontierAdminCellsRestored++; }
+        if (municipality && Number.isFinite(oldMunicipality) && oldMunicipality >= 0) municipality[i] = oldMunicipality;
+      }
+    }
+  }
+  const changes = [];
+  const maxReach = 6;
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      if (wasGeneratedAt(rects, x, y)) continue;
+      const i = worldIndexOf(world, x, y);
+      if (i < 0 || sea[i]) continue;
+      const d = coverageDistanceAt(rects, x, y, "generated");
+      if (d < 1 || d > maxReach) continue;
+      const noise = patchWorldNoise(rects, x, y, seed ^ 0x2f6e2b1d, 9);
+      const localReach = 2 + Math.floor(clamp(noise) * 5);
+      if (d > localReach) continue;
+
+      const adminVotes = new Map();
+      const prefVotes = new Map();
+      const nearestAdminVotes = new Map();
+      const nearestPrefVotes = new Map();
+      let nearestDist = Infinity;
+      for (let oy = -maxReach; oy <= maxReach; oy++) {
+        for (let ox = -maxReach; ox <= maxReach; ox++) {
+          const dist = Math.abs(ox) + Math.abs(oy);
+          if (!dist || dist > maxReach) continue;
+          const nx = x + ox, ny = y + oy;
+          if (!wasGeneratedAt(rects, nx, ny)) continue;
+          const ni = worldIndexOf(world, nx, ny);
+          if (ni < 0 || sea[ni]) continue;
+          const weight = 1 / (0.55 + dist);
+          if (admin[ni] >= 0) adminVotes.set(admin[ni], (adminVotes.get(admin[ni]) || 0) + weight);
+          if (prefecture[ni] >= 0) prefVotes.set(prefecture[ni], (prefVotes.get(prefecture[ni]) || 0) + weight);
+          if (dist < nearestDist) {
+            nearestDist = dist;
+            nearestAdminVotes.clear();
+            nearestPrefVotes.clear();
+          }
+          if (dist === nearestDist) {
+            if (admin[ni] >= 0) nearestAdminVotes.set(admin[ni], (nearestAdminVotes.get(admin[ni]) || 0) + 1);
+            if (prefecture[ni] >= 0) nearestPrefVotes.set(prefecture[ni], (nearestPrefVotes.get(prefecture[ni]) || 0) + 1);
+          }
+        }
+      }
+      const best = (votes) => {
+        let id = -1, score = 0, total = 0;
+        for (const [candidate, weight] of votes) {
+          total += weight;
+          if (weight > score) { id = candidate; score = weight; }
+        }
+        return { id, score, total };
+      };
+      const a = best(adminVotes), p = best(prefVotes);
+      const nearestA = best(nearestAdminVotes), nearestP = best(nearestPrefVotes);
+      // The first two cells on the new side copy the nearest established shell,
+      // which guarantees that an existing municipality does not terminate on the
+      // generation frontier itself. Deeper cells use a majority vote so the new
+      // administrative pattern can diverge naturally.
+      const targetAdmin = d <= 2
+        ? (nearestA.id >= 0 ? Math.floor(nearestA.id) : -1)
+        : (a.id >= 0 && a.score >= a.total * 0.52 ? Math.floor(a.id) : -1);
+      const targetPref = d <= 2
+        ? (nearestP.id >= 0 ? Math.floor(nearestP.id) : -1)
+        : (p.id >= 0 && p.score >= p.total * 0.52 ? Math.floor(p.id) : -1);
+      if (targetAdmin < 0 && targetPref < 0) continue;
+      changes.push([i, targetAdmin, targetPref]);
+    }
+  }
+  for (const [i, targetAdmin, targetPref] of changes) {
+    if (targetPref >= 0 && prefecture[i] !== targetPref) {
+      prefecture[i] = targetPref;
+      debug.frontierPrefectureCellsAligned++;
+    }
+    if (targetAdmin >= 0 && admin[i] !== targetAdmin) {
+      admin[i] = targetAdmin;
+      if (municipality) municipality[i] = targetAdmin;
+      debug.frontierAdminCellsAligned++;
+    }
+  }
+  return debug;
+}
+
+function repairPatchAdministrativeTopology(world, rects) {
+  const rect = rects.repairRect || rects.writeRect;
+  const prefecture = cleanupDiscreteFieldComponents(world, "prefectureRegionId", rect, { minCells: 420, passes: 3 });
+  const admin = cleanupDiscreteFieldComponents(world, "adminId", rect, { minCells: 96, passes: 4, respectPrefecture: true });
+  let municipalityCellsSynced = 0;
+  if (world.fields?.adminId && world.fields?.municipalityId) {
+    const adminId = world.fields.adminId;
+    const municipalityId = world.fields.municipalityId;
+    const sea = world.fields.sea;
+    for (let y = rect.y0; y < rect.y1; y++) {
+      for (let x = rect.x0; x < rect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0) continue;
+        const next = sea?.[i] ? -1 : adminId[i];
+        if (municipalityId[i] !== next) {
+          municipalityId[i] = next;
+          municipalityCellsSynced++;
+        }
+      }
+    }
+  }
+  return {
+    prefectureTinyComponentsMerged: prefecture.componentsMerged,
+    prefectureTinyCellsMerged: prefecture.cellsMerged,
+    adminTinyComponentsMerged: admin.componentsMerged,
+    adminTinyCellsMerged: admin.cellsMerged,
+    municipalityCellsSynced,
+  };
+}
+
+
+
+function smoothWaterTopology(world, rect, seaLevel = 0.30, rects = null, seed = 0) {
+  const sea = world.fields.sea;
+  const ocean = world.fields.ocean;
+  const lake = world.fields.lake;
+  const elevation = world.fields.elevation;
+  if (!sea || !elevation) return { coastCellsChanged: 0 };
+  let changed = 0;
+  for (let pass = 0; pass < 3; pass++) {
+    const flips = [];
+    for (let y = rect.y0 + 1; y < rect.y1 - 1; y++) {
+      for (let x = rect.x0 + 1; x < rect.x1 - 1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0) continue;
+        let seaN = 0;
+        let landN = 0;
+        for (let dy = -1; dy <= 1; dy++) {
+          for (let dx = -1; dx <= 1; dx++) {
+            if (!dx && !dy) continue;
+            const ni = worldIndexOf(world, x + dx, y + dy);
+            if (ni < 0) continue;
+            if (sea[ni]) seaN++; else landN++;
+          }
+        }
+        const a = rects ? patchAlpha(x, y, rects, seed) : 1;
+        if (a < 0.24) continue;
+        const strongOnly = a < 0.42;
+        if (sea[i] && seaN <= (strongOnly ? 0 : 1) && elevation[i] > seaLevel - 0.035) flips.push([i, 0]);
+        else if (!sea[i] && seaN >= (strongOnly ? 8 : 7) && elevation[i] < seaLevel + 0.055) flips.push([i, 1]);
+      }
+    }
+    for (const [i, nextSea] of flips) {
+      if (sea[i] === nextSea) continue;
+      sea[i] = nextSea;
+      if (ocean) ocean[i] = nextSea;
+      if (lake) lake[i] = 0;
+      if (nextSea) elevation[i] = Math.min(elevation[i], seaLevel - 0.004);
+      else elevation[i] = Math.max(elevation[i], seaLevel + 0.006);
+      changed++;
+    }
+  }
+  return { coastCellsChanged: changed };
+}
+
+function repairWaterComponentTopology(world, rects, seaLevel = 0.30, seed = 0) {
+  const sea = world.fields.sea;
+  const ocean = world.fields.ocean;
+  const lake = world.fields.lake;
+  const elevation = world.fields.elevation;
+  const landuse = world.fields.landuse;
+  const rect = rects?.writeRect;
+  if (!sea || !rect) return { waterComponentsScanned: 0, tinyWaterComponentsRemoved: 0, tinyLandIslandsRemoved: 0, waterTopologyCellsFlipped: 0 };
+
+  const expected = world.width * world.height;
+  const visited = new Uint8Array(expected);
+  const activeMinAlpha = 0.22;
+  const preserveAlpha = 0.40;
+  const dirs = [[1, 0], [-1, 0], [0, 1], [0, -1]];
+  const active = (x, y) => insideRect(x, y, rect) && patchAlpha(x, y, rects, seed) >= activeMinAlpha;
+  const tinyWaterLimit = Math.max(14, Math.min(36, Math.floor(Math.sqrt(Math.max(1, rectArea(rect))) * 0.20)));
+  const tinyLandLimit = Math.max(10, Math.min(28, Math.floor(Math.sqrt(Math.max(1, rectArea(rect))) * 0.16)));
+
+  let waterComponentsScanned = 0;
+  let tinyWaterComponentsRemoved = 0;
+  let tinyLandIslandsRemoved = 0;
+  let waterTopologyCellsFlipped = 0;
+
+  const flipCell = (i, nextSea) => {
+    if (sea[i] === nextSea) return;
+    sea[i] = nextSea;
+    if (ocean) ocean[i] = nextSea;
+    if (lake) lake[i] = 0;
+    if (elevation) {
+      if (nextSea) elevation[i] = Math.min(elevation[i], seaLevel - 0.004);
+      else elevation[i] = Math.max(elevation[i], seaLevel + 0.006);
+    }
+    if (landuse) landuse[i] = nextSea ? (LANDUSE.WATER || LANDUSE.RURAL || 0) : (LANDUSE.RURAL || 0);
+    waterTopologyCellsFlipped++;
+  };
+
+  for (let y0 = rect.y0; y0 < rect.y1; y0++) {
+    for (let x0 = rect.x0; x0 < rect.x1; x0++) {
+      if (!active(x0, y0)) continue;
+      const start = worldIndexOf(world, x0, y0);
+      if (start < 0 || visited[start]) continue;
+      const value = sea[start] ? 1 : 0;
+      const stack = [[x0, y0]];
+      const cells = [];
+      let sumElevation = 0;
+      let elevationCount = 0;
+      let touchesWeakPatchEdge = false;
+      let touchesSameOutsideActive = false;
+      let oppositeBorder = 0;
+      let sameBorder = 0;
+
+      visited[start] = 1;
+      while (stack.length) {
+        const [x, y] = stack.pop();
+        const i = worldIndexOf(world, x, y);
+        if (i < 0) continue;
+        cells.push(i);
+        if (elevation) { sumElevation += elevation[i] || 0; elevationCount++; }
+        if (patchAlpha(x, y, rects, seed) < preserveAlpha || x <= rect.x0 || y <= rect.y0 || x >= rect.x1 - 1 || y >= rect.y1 - 1) {
+          touchesWeakPatchEdge = true;
+        }
+        for (const [dx, dy] of dirs) {
+          const nx = x + dx;
+          const ny = y + dy;
+          const ni = worldIndexOf(world, nx, ny);
+          if (ni < 0) continue;
+          const nv = sea[ni] ? 1 : 0;
+          if (nv !== value) {
+            oppositeBorder++;
+            continue;
+          }
+          sameBorder++;
+          if (!active(nx, ny)) {
+            touchesSameOutsideActive = true;
+            continue;
+          }
+          if (!visited[ni]) {
+            visited[ni] = 1;
+            stack.push([nx, ny]);
+          }
+        }
+      }
+
+      waterComponentsScanned++;
+      const area = cells.length;
+      const avgElevation = elevationCount ? sumElevation / elevationCount : seaLevel;
+      const isolatedInsidePatch = !touchesWeakPatchEdge && !touchesSameOutsideActive;
+      if (value === 1) {
+        if (isolatedInsidePatch && area <= tinyWaterLimit && avgElevation > seaLevel - 0.055) {
+          for (const i of cells) flipCell(i, 0);
+          tinyWaterComponentsRemoved++;
+        }
+      } else {
+        const mostlySurroundedBySea = oppositeBorder > sameBorder * 0.72;
+        if (isolatedInsidePatch && mostlySurroundedBySea && area <= tinyLandLimit && avgElevation < seaLevel + 0.045) {
+          for (const i of cells) flipCell(i, 1);
+          tinyLandIslandsRemoved++;
+        }
+      }
+    }
+  }
+
+  return { waterComponentsScanned, tinyWaterComponentsRemoved, tinyLandIslandsRemoved, waterTopologyCellsFlipped };
+}
+
+
+
+function smoothPatchedWaterElevation(world, rects, seaLevel = 0.30, seed = 0) {
+  const elevation = world.fields?.elevation;
+  const sea = world.fields?.sea;
+  if (!elevation || !sea || !rects?.writeRect) return { waterElevationCellsSmoothed: 0 };
+  const rect = rects.writeRect;
+  let waterElevationCellsSmoothed = 0;
+
+  // Do not diffuse water elevation row-by-row.  Diffusion made broad patched
+  // ocean/sea areas inherit candidate raster bands, which appeared as horizontal
+  // stripes.  Instead assign a stable world-coordinate bathymetry target and
+  // blend toward it by patch alpha.  The renderer also avoids DEM hillshade for
+  // water, but keeping the underlying water DEM coherent prevents dependent
+  // fields from reintroducing stripe artefacts later.
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0 || !sea[i]) continue;
+      const a = patchAlpha(x, y, rects, seed);
+      if (a < 0.08) continue;
+
+      let seaNear = 0;
+      let totalNear = 0;
+      for (let dy = -3; dy <= 3; dy++) {
+        for (let dx = -3; dx <= 3; dx++) {
+          if (!dx && !dy) continue;
+          const ni = worldIndexOf(world, x + dx, y + dy);
+          if (ni < 0) continue;
+          totalNear++;
+          if (sea[ni]) seaNear++;
+        }
+      }
+      const offshore = totalNear ? seaNear / totalNear : 1;
+      const broad = patchWorldNoise(rects, x, y, seed ^ 0x6d2b79f5, 86);
+      const mid = patchWorldNoise(rects, x, y, seed ^ 0x2f31c9a7, 31);
+      const texture = broad * 0.75 + mid * 0.25;
+      const depth = clamp(0.032 + offshore * 0.060 + (texture - 0.5) * 0.018, 0.018, 0.125);
+      const target = seaLevel - depth;
+      const before = elevation[i];
+      const strength = clamp(0.46 + a * 0.42, 0.42, 0.86);
+      elevation[i] = clamp(lerp(Math.min(before, seaLevel - 0.004), target, strength), seaLevel - 0.16, seaLevel - 0.004);
+      if (Math.abs(elevation[i] - before) > 1e-6) waterElevationCellsSmoothed++;
+    }
+  }
+
+  return { waterElevationCellsSmoothed };
+}
+
+function recomputeSlopeAndWaterDependentFields(world, rect, seaLevel = 0.30) {
+  const fields = world.fields;
+  const { elevation, sea } = fields;
+  if (!elevation || !sea) return;
+  if (!fields.slope) fields.slope = new Float32Array(world.width * world.height);
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      if (sea[i]) {
+        for (const key of ["slope", "river", "floodplain", "plain", "agriculture", "ridgeField", "valleyField", "coastalLowland", "naturalBarrierScore", "populationDensity", "settlementScore", "roadInfluence", "railInfluence2", "stationInfluence", "villageInfluence"]) {
+          if (fields[key]) fields[key][i] = 0;
+        }
+        continue;
+      }
+      if (x > 0 && y > 0 && x < world.width - 1 && y < world.height - 1) {
+        const gx = elevation[worldIndexOf(world, x + 1, y)] - elevation[worldIndexOf(world, x - 1, y)];
+        const gy = elevation[worldIndexOf(world, x, y + 1)] - elevation[worldIndexOf(world, x, y - 1)];
+        fields.slope[i] = clamp(Math.hypot(gx, gy) * 8.2);
+      }
+      if (fields.plain) fields.plain[i] = clamp((fields.plain[i] || 0) * 0.75 + (1 - (fields.slope[i] || 0)) * clamp((0.62 - elevation[i]) * 1.8) * 0.25);
+      if (fields.agriculture && fields.plain) fields.agriculture[i] = clamp((fields.agriculture[i] || 0) * 0.72 + fields.plain[i] * 0.28);
+    }
+  }
+}
+
+function seaNeighbors(world, x, y, radius = 1) {
+  let count = 0;
+  for (let dy = -radius; dy <= radius; dy++) {
+    for (let dx = -radius; dx <= radius; dx++) {
+      if (!dx && !dy) continue;
+      const i = worldIndexOf(world, x + dx, y + dy);
+      if (i >= 0 && world.fields.sea?.[i]) count++;
+    }
+  }
+  return count;
+}
+
+function landNeighbors(world, x, y, radius = 1) {
+  let count = 0;
+  for (let dy = -radius; dy <= radius; dy++) {
+    for (let dx = -radius; dx <= radius; dx++) {
+      if (!dx && !dy) continue;
+      const i = worldIndexOf(world, x + dx, y + dy);
+      if (i >= 0 && !world.fields.sea?.[i]) count++;
+    }
+  }
+  return count;
+}
+
+function isLand(world, x, y) {
+  const i = worldIndexOf(world, x, y);
+  return i >= 0 && !world.fields.sea?.[i];
+}
+
+function nearestLand(world, x, y, rect, radius = 10) {
+  if (insideRect(x, y, rect) && isLand(world, x, y)) return { x, y };
+  for (let r = 1; r <= radius; r++) {
+    let best = null;
+    let bestScore = Infinity;
+    for (let yy = y - r; yy <= y + r; yy++) {
+      for (let xx = x - r; xx <= x + r; xx++) {
+        if (Math.abs(xx - x) !== r && Math.abs(yy - y) !== r) continue;
+        if (!insideRect(xx, yy, rect) || !isLand(world, xx, yy)) continue;
+        const i = worldIndexOf(world, xx, yy);
+        const score = Math.hypot(xx - x, yy - y) + (world.fields.slope?.[i] || 0) * 3;
+        if (score < bestScore) { bestScore = score; best = { x: xx, y: yy }; }
+      }
+    }
+    if (best) return best;
+  }
+  return null;
+}
+
+function pointWorldX(world, p) {
+  // Source-map point coordinates are local to the original map. They remain
+  // stable when the padded world grows on the left/top, while cached worldX
+  // values become stale after origin shifts. Prefer the local coordinate and
+  // use worldX only for legacy/world-only point records.
+  if (Number.isFinite(p?.x)) return p.x + (world?.originX || 0);
+  if (Number.isFinite(p?.worldX)) return p.worldX;
+  return world?.originX || 0;
+}
+
+function pointWorldY(world, p) {
+  if (Number.isFinite(p?.y)) return p.y + (world?.originY || 0);
+  if (Number.isFinite(p?.worldY)) return p.worldY;
+  return world?.originY || 0;
+}
+
+function tupleWorldX(world, tuple) {
+  return (tuple?.[0] || 0) + (world?.originX || 0);
+}
+
+function tupleWorldY(world, tuple) {
+  return (tuple?.[1] || 0) + (world?.originY || 0);
+}
+
+function sourcePointFromWorld(world, point) {
+  return { ...point, x: point.x - world.originX, y: point.y - world.originY, worldX: point.x, worldY: point.y, patchGenerated: true };
+}
+
+function sourcePathFromWorld(world, path) {
+  const out = path.map(([x, y]) => [Math.round(x - world.originX), Math.round(y - world.originY)]);
+  // Arrays can carry lightweight metadata in JS.  Marking generated paths lets
+  // a later Alternative generation remove the prior variant completely instead
+  // of leaving low-alpha edge fragments behind.
+  out.patchGenerated = true;
+  return out;
+}
+
+function offsetPointNumericFields(point, fields, offset) {
+  for (const field of fields) if (Number.isFinite(point[field])) point[field] += offset;
+}
+
+function normalizeGeneratedPointIds(point, key, seed = 0, adminIdMapping = null) {
+  const rawAdminId = numericFeatureId(point, ["adminId", "municipalityId", "adminNumericId"]);
+  if (rawAdminId >= 0) {
+    const mappedAdminId = adminIdMapping?.admin?.get(rawAdminId) ?? adminIdMapping?.municipality?.get(rawAdminId);
+    if (Number.isFinite(mappedAdminId)) {
+      point.sourceAdminId = rawAdminId;
+      point.adminId = mappedAdminId;
+      point.adminNumericId = mappedAdminId;
+      point.municipalityId = mappedAdminId;
+    } else {
+      offsetPointNumericFields(point, ["adminId", "adminNumericId", "municipalityId"], fieldIdOffset("adminId", seed));
+      if (!Number.isFinite(point.adminId) && Number.isFinite(point.municipalityId)) point.adminId = point.municipalityId;
+      if (!Number.isFinite(point.municipalityId) && Number.isFinite(point.adminId)) point.municipalityId = point.adminId;
+    }
+  }
+
+  const rawPrefectureId = numericFeatureId(point, key === "prefectureRegions" ? ["prefectureRegionId", "id"] : ["prefectureRegionId"]);
+  if (rawPrefectureId >= 0) {
+    const mappedPrefectureId = adminIdMapping?.prefecture?.get(rawPrefectureId);
+    if (Number.isFinite(mappedPrefectureId)) {
+      point.sourcePrefectureRegionId = rawPrefectureId;
+      point.prefectureRegionId = mappedPrefectureId;
+      if (key === "prefectureRegions") point.id = mappedPrefectureId;
+    } else {
+      const offset = fieldIdOffset("prefectureRegionId", seed);
+      if (Number.isFinite(point.prefectureRegionId)) point.prefectureRegionId += offset;
+      if (key === "prefectureRegions" && Number.isFinite(point.id)) point.id += offset;
+    }
+  }
+
+  if (Number.isFinite(point.adminId) && !Number.isFinite(point.municipalityId)) point.municipalityId = point.adminId;
+  if (Number.isFinite(point.municipalityId) && !Number.isFinite(point.adminId)) point.adminId = point.municipalityId;
+  return point;
+}
+
+function transformCandidatePoint(world, window, p, key, seed = 0, adminIdMapping = null) {
+  if (!p || !Number.isFinite(p.x) || !Number.isFinite(p.y)) return null;
+  const w = worldCoordForSource(window, p.x, p.y);
+  if (key === "ports") {
+    const land = nearestLand(world, w.x, w.y, { x0: 0, y0: 0, x1: world.width, y1: world.height }, 8);
+    if (!land || seaNeighbors(world, land.x, land.y, 2) < 2) return null;
+    w.x = land.x; w.y = land.y;
+  } else if (!["crossings", "passes", "externalGateways", "prefectureRegions"].includes(key) && !isLand(world, w.x, w.y)) {
+    const land = nearestLand(world, w.x, w.y, { x0: 0, y0: 0, x1: world.width, y1: world.height }, 5);
+    if (!land) return null;
+    w.x = land.x; w.y = land.y;
+  }
+  const out = sourcePointFromWorld(world, { ...p, x: w.x, y: w.y });
+  normalizeGeneratedPointIds(out, key, seed, adminIdMapping);
+  if (key === "adminCenters") {
+    if (Number.isFinite(out.sourceAdminId)) {
+      const candidatePrefId = adminIdMapping?.candidateAdminToPrefecture?.get(out.sourceAdminId);
+      const mappedPrefId = adminIdMapping?.prefecture?.get(candidatePrefId);
+      if (Number.isFinite(mappedPrefId)) out.prefectureRegionId = mappedPrefId;
+    }
+  }
+  if (key === "logisticsParks") sanitizeLogisticsPark(out);
+  return out;
+}
+
+function sanitizeLogisticsPark(p) {
+  if (!p) return p;
+  p.name = null;
+  p.labelName = null;
+  p.facilityLabel = p.facilityLabel || "Logistics Park";
+  p.labelStyle = "facility";
+  p.suppressSettlementLabel = true;
+  p.kind = "Logistics Park";
+  p.population = 0;
+  return p;
+}
+
+function sanitizeExistingLogistics(sourceMap) {
+  let migrated = 0;
+  if (!Array.isArray(sourceMap.logisticsParks)) return 0;
+  for (const p of sourceMap.logisticsParks) {
+    if (!p) continue;
+    if (p.name || p.labelName || !p.suppressSettlementLabel) migrated++;
+    sanitizeLogisticsPark(p);
+  }
+  for (const key of ["villages", "markets", "modernCities", "satelliteCities", "newTowns", "adminCenters"]) {
+    const arr = sourceMap[key];
+    if (!Array.isArray(arr)) continue;
+    for (const p of arr) {
+      if (!p?.name || !/\bLogistics\b/i.test(String(p.name))) continue;
+      p.name = String(p.name).replace(/\s*Logistics\b/ig, "").trim() || null;
+      p.labelName = p.name;
+      migrated++;
+    }
+  }
+  return migrated;
+}
+
+function transformCandidatePath(window, path) {
+  const out = [];
+  for (const tuple of path || []) {
+    if (!Array.isArray(tuple) || tuple.length < 2) continue;
+    const p = worldCoordForSource(window, tuple[0], tuple[1]);
+    out.push([p.x, p.y]);
+  }
+  return out;
+}
+
+function splitWorldPathByPredicate(path, predicate, keepWhenTrue) {
+  const chunks = [];
+  let current = [];
+  const addPoint = (target, point) => {
+    const x = point[0];
+    const y = point[1];
+    const last = target[target.length - 1];
+    if (!last || Math.hypot(last[0] - x, last[1] - y) > 1e-4) target.push([x, y]);
+  };
+  const finish = () => {
+    if (current.length >= 2 && pathLength(current) > 0.25) chunks.push(current);
+    current = [];
+  };
+  const points = (path || []).filter((p) => Array.isArray(p) && p.length >= 2 && Number.isFinite(p[0]) && Number.isFinite(p[1]));
+  if (points.length < 2) return chunks;
+
+  for (let si = 0; si < points.length - 1; si++) {
+    const a = points[si];
+    const b = points[si + 1];
+    const dx = b[0] - a[0];
+    const dy = b[1] - a[1];
+    // Sample below one cell so a sparse path cannot cross the patch without a
+    // vertex.  Only transition points are inserted; original geometry is kept
+    // elsewhere, avoiding the staircase shape of a fully rasterized split.
+    const steps = Math.max(1, Math.ceil(Math.max(Math.abs(dx), Math.abs(dy)) / 0.90));
+    let prev = [a[0], a[1]];
+    let prevState = predicate(Math.round(prev[0]), Math.round(prev[1]));
+    if (si === 0 && prevState === keepWhenTrue) addPoint(current, prev);
+    for (let step = 1; step <= steps; step++) {
+      const t = step / steps;
+      const point = [a[0] + dx * t, a[1] + dy * t];
+      const state = predicate(Math.round(point[0]), Math.round(point[1]));
+      if (state !== prevState) {
+        const boundary = [(prev[0] + point[0]) * 0.5, (prev[1] + point[1]) * 0.5];
+        if (prevState === keepWhenTrue) {
+          addPoint(current, boundary);
+          finish();
+        }
+        if (state === keepWhenTrue) {
+          addPoint(current, boundary);
+          addPoint(current, point);
+        }
+      } else if (state === keepWhenTrue && step === steps) {
+        addPoint(current, point);
+      }
+      prev = point;
+      prevState = state;
+    }
+  }
+  finish();
+  return chunks;
+}
+
+function splitWorldPathByPatch(path, rects, seed, keepAffected, minAlpha = 0.34) {
+  return splitWorldPathByPredicate(path, (x, y) => patchAffected(x, y, rects, seed, minAlpha), keepAffected);
+}
+
+function pruneOldPathLayer(world, paths, rects, seed, mode) {
+  const kept = [];
+  const anchors = [];
+  let clipped = 0;
+  for (const path of paths || []) {
+    const worldPath = (path || []).map((tuple) => [Math.round(tupleWorldX(world, tuple)), Math.round(tupleWorldY(world, tuple))]);
+    const removalAlpha = PATCH_FEATURE_REPLACE_ALPHA;
+    const touches = worldPath.some(([x, y]) => patchAffected(x, y, rects, seed, removalAlpha));
+    if (!touches) {
+      kept.push(path);
+      continue;
+    }
+    clipped++;
+    let lastOutside = null;
+    let wasInside = false;
+    for (const [x, y] of worldPath) {
+      const inside = patchAffected(x, y, rects, seed, removalAlpha);
+      if (!inside) {
+        if (wasInside) anchors.push({ x, y, mode });
+        lastOutside = { x, y, mode };
+      } else if (lastOutside && !wasInside) {
+        anchors.push(lastOutside);
+      }
+      wasInside = inside;
+    }
+    for (const chunk of splitWorldPathByPatch(worldPath, rects, seed, false, removalAlpha)) {
+      const stored = sourcePathFromWorld(world, chunk);
+      // A clipped remainder of an original route is still original world data.
+      // Only remainders originating from a previous patch should stay marked as
+      // patch-generated, otherwise old external routes are misclassified as new
+      // synthetic perimeter gateways by later validation and replacement passes.
+      if (!path?.patchGenerated) delete stored.patchGenerated;
+      kept.push(stored);
+    }
+  }
+  return { kept, anchors, clipped };
+}
+
+function pathCost(world, x, y, mode) {
+  const i = worldIndexOf(world, x, y);
+  if (i < 0 || world.fields.sea?.[i]) return Infinity;
+  const slope = world.fields.slope?.[i] || 0;
+  const river = world.fields.river?.[i] || 0;
+  const plain = world.fields.plain?.[i] || 0;
+  const roadInfluence = world.fields.roadInfluence?.[i] || 0;
+  const pop = world.fields.populationDensity?.[i] || 0;
+  const slopeMult = mode === "rail" ? 15 : 7;
+  return 1 + slope * slopeMult - plain * 0.35 - roadInfluence * 0.28 - pop * 0.18 + river * 0.18;
+}
+
+function localPathfind(world, start, goal, rect, mode = "road", maxExpanded = 24000, options = {}) {
+  const sx = Math.round(start.x), sy = Math.round(start.y), gx = Math.round(goal.x), gy = Math.round(goal.y);
+  if (!insideRect(sx, sy, rect) || !insideRect(gx, gy, rect)) return null;
+  const allowCell = typeof options.allowCell === "function" ? options.allowCell : null;
+  const extraCost = typeof options.extraCost === "function" ? options.extraCost : null;
+  if (!isLand(world, sx, sy) || !isLand(world, gx, gy)) return null;
+  if (allowCell && (!allowCell(sx, sy, true) || !allowCell(gx, gy, true))) return null;
+  const w = rectWidth(rect);
+  const h = rectHeight(rect);
+  const n = w * h;
+  const dist = new Float64Array(n); dist.fill(Infinity);
+  const prev = new Int32Array(n); prev.fill(-1);
+  const local = (x, y) => (y - rect.y0) * w + (x - rect.x0);
+  const heap = new MinHeap();
+  const startId = local(sx, sy);
+  dist[startId] = 0;
+  heap.push({ x: sx, y: sy, f: Math.hypot(sx - gx, sy - gy), id: startId });
+  let expanded = 0;
+  let found = -1;
+  const dirs = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
+  while (heap.items.length && expanded < maxExpanded) {
+    const cur = heap.pop();
+    if (!cur) break;
+    if (cur.x === gx && cur.y === gy) { found = cur.id; break; }
+    expanded++;
+    for (const [dx, dy] of dirs) {
+      const nx = cur.x + dx, ny = cur.y + dy;
+      if (!insideRect(nx, ny, rect)) continue;
+      if (allowCell && !allowCell(nx, ny, false)) continue;
+      const nid = local(nx, ny);
+      const baseCost = pathCost(world, nx, ny, mode);
+      if (!Number.isFinite(baseCost)) continue;
+      const c = baseCost + (extraCost ? Math.max(0, extraCost(nx, ny) || 0) : 0);
+      const step = (dx && dy ? 1.42 : 1) * c;
+      const nd = dist[cur.id] + step;
+      if (nd >= dist[nid]) continue;
+      dist[nid] = nd;
+      prev[nid] = cur.id;
+      heap.push({ x: nx, y: ny, id: nid, f: nd + Math.hypot(nx - gx, ny - gy) * 1.05 });
+    }
+  }
+  if (found < 0) return null;
+  const rev = [];
+  let at = found;
+  while (at >= 0) {
+    const x = rect.x0 + (at % w);
+    const y = rect.y0 + Math.floor(at / w);
+    rev.push([x, y]);
+    at = prev[at];
+  }
+  return rev.reverse();
+}
+
+function simplifyPath(path, keepEvery = 2) {
+  if (!path || path.length <= 2) return path || [];
+  const out = [path[0]];
+  for (let i = 1; i < path.length - 1; i++) if (i % keepEvery === 0) out.push(path[i]);
+  out.push(path[path.length - 1]);
+  return out;
+}
+
+function rectDistance(x, y, rect) {
+  if (insideRect(x, y, rect)) return 0;
+  const dx = x < rect.x0 ? rect.x0 - x : x >= rect.x1 ? x - rect.x1 + 1 : 0;
+  const dy = y < rect.y0 ? rect.y0 - y : y >= rect.y1 ? y - rect.y1 + 1 : 0;
+  return Math.hypot(dx, dy);
+}
+
+function collectExternalNetworkAnchors(world, sourceMap, keys, writeRect, reachRect, mode = "road") {
+  const candidates = [];
+  const seen = new Set();
+  const step = mode === "rail" ? 6 : 4;
+  for (const key of keys) {
+    for (const path of sourceMap[key] || []) {
+      for (let i = 0; i < path.length; i += step) {
+        const x = Math.round(tupleWorldX(world, path[i]));
+        const y = Math.round(tupleWorldY(world, path[i]));
+        if (!insideRect(x, y, reachRect) || insideRect(x, y, writeRect) || !isLand(world, x, y)) continue;
+        const d = rectDistance(x, y, writeRect);
+        if (d < 4 || d > (mode === "rail" ? 380 : 420)) continue;
+        const sig = `${x},${y},${mode}`;
+        if (seen.has(sig)) continue;
+        seen.add(sig);
+        candidates.push({ x, y, mode, external: true, d });
+      }
+    }
+  }
+  candidates.sort((a, b) => a.d - b.d);
+  return candidates.slice(0, mode === "rail" ? 18 : 28);
+}
+
+function transportLayerKeys(mode) {
+  return mode === "rail"
+    ? ["railways", "branchRailways", "ringRailways", "externalRailways"]
+    : ["nationalRoads", "minorRoads", "premodernRoads", "ringRoads", "externalRoads", "expressways", "externalExpressways", "icAccessRoads"];
+}
+
+function densifyWorldPath(path, visit) {
+  walkGridPath(path, visit);
+}
+
+function buildTransportGraphSnapshot(world, sourceMap, mode, graphRect, rects, seed = 0) {
+  const keys = transportLayerKeys(mode);
+  const w = rectWidth(graphRect);
+  const h = rectHeight(graphRect);
+  const occ = new Uint8Array(Math.max(0, w * h));
+  const weight = new Float32Array(Math.max(0, w * h));
+  const local = (x, y) => (y - graphRect.y0) * w + (x - graphRect.x0);
+  const mark = (x, y, v = 1) => {
+    x = Math.round(x); y = Math.round(y);
+    if (!insideRect(x, y, graphRect)) return;
+    // Graph connectivity is based on rendered transport centerlines.  Existing
+    // short bridges are allowed to connect components, but arbitrary candidate
+    // roads far out at sea are not allowed to become graph anchors.
+    const i = worldIndexOf(world, x, y);
+    if (i < 0) return;
+    // Accept land cells and only very near-shore bridge-like sea cells.
+    // The previous sea-neighbor test accidentally made open water more likely
+    // to become a graph anchor.
+    const nearTransportSurface = isLand(world, x, y) || landNeighbors(world, x, y, 2) >= 8;
+    if (!nearTransportSurface) return;
+    const li = local(x, y);
+    occ[li] = 1;
+    weight[li] = Math.max(weight[li] || 0, v);
+  };
+
+  for (const key of keys) {
+    const layerWeight = key.includes("express") ? 2.4 : key.includes("national") ? 2.0 : key.includes("rail") ? 2.1 : 1.0;
+    for (const path of sourceMap?.[key] || []) {
+      const worldPath = (path || []).map((tuple) => [Math.round(tupleWorldX(world, tuple)), Math.round(tupleWorldY(world, tuple))]);
+      densifyWorldPath(worldPath, (x, y) => mark(x, y, layerWeight));
+    }
+  }
+
+  const seen = new Uint8Array(occ.length);
+  const comps = [];
+  // Connectivity must match the rendered centerline.  Treat only touching
+  // raster cells as connected; the previous two-cell neighborhood could report
+  // a graph merge while leaving a visible one-cell gap on the map.
+  const dirs = [
+    [1, 0], [-1, 0], [0, 1], [0, -1],
+    [1, 1], [1, -1], [-1, 1], [-1, -1],
+  ];
+
+  for (let li = 0; li < occ.length; li++) {
+    if (!occ[li] || seen[li]) continue;
+    const queue = [li];
+    const cells = [];
+    seen[li] = 1;
+    let sx = 0, sy = 0, score = 0, patchCells = 0, nearWriteCells = 0, exteriorCells = 0, trunkCells = 0;
+    let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+    for (let q = 0; q < queue.length; q++) {
+      const cur = queue[q];
+      cells.push(cur);
+      const lx = cur % w;
+      const ly = Math.floor(cur / w);
+      const x = graphRect.x0 + lx;
+      const y = graphRect.y0 + ly;
+      sx += x; sy += y; score += Math.max(1, weight[cur] || 1);
+      if ((weight[cur] || 0) >= 1.8) trunkCells++;
+      minX = Math.min(minX, x); minY = Math.min(minY, y); maxX = Math.max(maxX, x); maxY = Math.max(maxY, y);
+      if (patchAffected(x, y, rects, seed, 0.24)) patchCells++;
+      if (rectDistance(x, y, rects.writeRect) <= 8) nearWriteCells++;
+      if (!insideRect(x, y, rects.writeRect)) exteriorCells++;
+      for (const [dx, dy] of dirs) {
+        const nx = lx + dx;
+        const ny = ly + dy;
+        if (nx < 0 || ny < 0 || nx >= w || ny >= h) continue;
+        const ni = ny * w + nx;
+        if (!occ[ni] || seen[ni]) continue;
+        seen[ni] = 1;
+        queue.push(ni);
+      }
+    }
+    const size = cells.length;
+    const cx = sx / Math.max(1, size);
+    const cy = sy / Math.max(1, size);
+    const boundaryBonus = exteriorCells > 0 ? Math.min(180, exteriorCells) : 0;
+    comps.push({
+      id: comps.length,
+      cells,
+      size,
+      cx,
+      cy,
+      minX,
+      minY,
+      maxX,
+      maxY,
+      score: score + boundaryBonus * 1.5 + patchCells * 1.2 + nearWriteCells * 0.8,
+      patchCells,
+      nearWriteCells,
+      exteriorCells,
+      trunkCells,
+    });
+  }
+  comps.sort((a, b) => b.score - a.score);
+  return { graphRect, width: w, height: h, occ, comps, local };
+}
+
+function nearestComponentCell(snapshot, comp, target) {
+  let best = null;
+  let bestD = Infinity;
+  for (const li of comp?.cells || []) {
+    const x = snapshot.graphRect.x0 + (li % snapshot.width);
+    const y = snapshot.graphRect.y0 + Math.floor(li / snapshot.width);
+    const d = Math.hypot(x - target.x, y - target.y);
+    if (d < bestD) {
+      bestD = d;
+      best = { x, y };
+    }
+  }
+  return best;
+}
+
+function sampleTransportComponent(snapshot, comp, limit = 96) {
+  const cells = comp?.cells || [];
+  if (!cells.length) return [];
+  const out = [];
+  const seen = new Set();
+  const addCell = (li) => {
+    if (!Number.isFinite(li) || li < 0) return;
+    const x = snapshot.graphRect.x0 + (li % snapshot.width);
+    const y = snapshot.graphRect.y0 + Math.floor(li / snapshot.width);
+    const key = `${x},${y}`;
+    if (seen.has(key)) return;
+    seen.add(key);
+    out.push({ x, y });
+  };
+  const step = Math.max(1, Math.floor(cells.length / Math.max(1, limit)));
+  for (let i = 0; i < cells.length; i += step) {
+    addCell(cells[i]);
+    if (out.length >= limit) break;
+  }
+  // Add actual occupied cells nearest to the centroid and bbox edge targets.
+  // Do not use the raw centroid/bbox coordinates as endpoints: they are often
+  // off the centerline, which made the checker roll back otherwise valid graph
+  // repairs because the new path never actually touched the component.
+  const specials = [
+    { x: Math.round(comp.cx), y: Math.round(comp.cy) },
+    { x: comp.minX, y: Math.round(comp.cy) },
+    { x: comp.maxX, y: Math.round(comp.cy) },
+    { x: Math.round(comp.cx), y: comp.minY },
+    { x: Math.round(comp.cx), y: comp.maxY },
+  ];
+  for (const target of specials) {
+    const nearest = nearestComponentCell(snapshot, comp, target);
+    if (!nearest) continue;
+    const key = `${nearest.x},${nearest.y}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(nearest);
+  }
+  return out;
+}
+
+function transportComponentSamples(snapshot, comp, mode = "road") {
+  snapshot.sampleCache ||= new Map();
+  const key = `${mode}:${comp?.id ?? -1}`;
+  const cached = snapshot.sampleCache.get(key);
+  if (cached) return cached;
+  const samples = sampleTransportComponent(snapshot, comp, mode === "rail" ? 48 : 72);
+  snapshot.sampleCache.set(key, samples);
+  return samples;
+}
+
+function bestTransportComponentPair(snapshot, compA, compB, maxDistance, mode = "road") {
+  const samplesA = transportComponentSamples(snapshot, compA, mode);
+  const samplesB = transportComponentSamples(snapshot, compB, mode);
+  let best = null;
+  for (const a of samplesA) {
+    for (const b of samplesB) {
+      const d = Math.hypot(a.x - b.x, a.y - b.y);
+      if (d < 3 || d > maxDistance) continue;
+      // Prefer connecting components that actually touch the changed area, but
+      // do not force every component into the single largest component.  A local
+      // chain of nearby component merges usually looks more like a natural
+      // regional repair than a star-shaped set of shortcuts to the trunk road.
+      const dirtyBonus = (compA.patchCells || compA.nearWriteCells || compB.patchCells || compB.nearWriteCells) ? 0.78 : 1.0;
+      const exteriorPenalty = compA.exteriorCells > 0 && compB.exteriorCells > 0 && !compA.patchCells && !compB.patchCells ? 1.32 : 1.0;
+      const sizeBonus = 1 / Math.sqrt(Math.max(4, Math.min(compA.size, compB.size)));
+      const score = d * sizeBonus * dirtyBonus * exteriorPenalty;
+      if (!best || score < best.score) best = { a, b, d, score };
+    }
+  }
+  return best;
+}
+
+function isStrongExternalTransportContext(comp, mode = "road") {
+  if (!comp) return false;
+  // Pure external components are only context.  They should be regional trunks or
+  // meaningful nearby networks, not tiny roads in otherwise empty old terrain;
+  // otherwise graph repair grows many spokes toward places with no transport
+  // context.
+  if ((comp.patchCells || comp.nearWriteCells) > 0) return true;
+  const minSize = mode === "rail" ? 18 : 42;
+  if (comp.size < minSize) return false;
+  if ((comp.trunkCells || 0) >= (mode === "rail" ? 3 : 5)) return true;
+  if (comp.exteriorCells >= minSize * 1.8 && comp.score >= minSize * (mode === "rail" ? 1.4 : 1.25)) return true;
+  return false;
+}
+
+function transportComponentTouchesVoid(comp, mode = "road") {
+  if (!comp) return true;
+  return (comp.patchCells || comp.nearWriteCells) > 0 && comp.size < (mode === "rail" ? 8 : 13) && (comp.trunkCells || 0) <= 0;
+}
+
+function buildTransportPairCandidates(snapshot, comps, maxDistance, mode, rejectedPairs) {
+  const limit = mode === "rail" ? 12 : 18;
+  const pool = comps.slice(0, Math.min(comps.length, limit));
+  const candidates = [];
+  for (let i = 0; i < pool.length; i++) {
+    for (let j = i + 1; j < pool.length; j++) {
+      const aComp = pool[i];
+      const bComp = pool[j];
+      // At least one side must be part of the dirty neighborhood.  This prevents
+      // broad transport context from welding unrelated external networks while
+      // still allowing internal severed pieces to attach to outside trunks.
+      const aDirty = (aComp.patchCells || aComp.nearWriteCells) > 0;
+      const bDirty = (bComp.patchCells || bComp.nearWriteCells) > 0;
+      if (!aDirty && !bDirty) continue;
+      if (transportComponentTouchesVoid(aComp, mode) && !bDirty) continue;
+      if (transportComponentTouchesVoid(bComp, mode) && !aDirty) continue;
+      if (!aDirty && !isStrongExternalTransportContext(aComp, mode)) continue;
+      if (!bDirty && !isStrongExternalTransportContext(bComp, mode)) continue;
+      const pair = bestTransportComponentPair(snapshot, aComp, bComp, maxDistance, mode);
+      if (!pair) continue;
+      const sig = transportPairSignature(pair.a, pair.b, mode);
+      const rev = transportPairSignature(pair.b, pair.a, mode);
+      if (rejectedPairs.has(sig) || rejectedPairs.has(rev)) continue;
+      const bothPatch = aComp.patchCells > 0 && bComp.patchCells > 0 ? 0.74 : 1.0;
+      const weakExternalPenalty = (!aDirty && (aComp.trunkCells || 0) <= 0) || (!bDirty && (bComp.trunkCells || 0) <= 0) ? 1.55 : 1.0;
+      const oneExternal = (aComp.exteriorCells > 0 || bComp.exteriorCells > 0) ? 1.12 : 1.0;
+      const score = pair.score * bothPatch * oneExternal * weakExternalPenalty;
+      candidates.push({ compA: aComp, compB: bComp, pair, score });
+    }
+  }
+  candidates.sort((a, b) => a.score - b.score);
+  return candidates;
+}
+
+function transportPairSignature(a, b, mode = "road") {
+  return `${mode}:${Math.round((a?.x || 0) / 3)},${Math.round((a?.y || 0) / 3)}:${Math.round((b?.x || 0) / 3)},${Math.round((b?.y || 0) / 3)}`;
+}
+
+function pathLength(path) {
+  let len = 0;
+  for (let i = 1; i < (path?.length || 0); i++) len += Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]);
+  return len;
+}
+
+function dedupeWorldPath(path) {
+  const out = [];
+  let last = "";
+  for (const p of path || []) {
+    const x = Math.round(p?.[0] ?? 0);
+    const y = Math.round(p?.[1] ?? 0);
+    const key = `${x},${y}`;
+    if (key === last) continue;
+    out.push([x, y]);
+    last = key;
+  }
+  return out;
+}
+
+function makeTransportConnectorAllowCell(world, snapshot, rects, seed, strictMask) {
+  const graphRect = snapshot.graphRect;
+  return (x, y, endpoint = false) => {
+    if (!insideRect(x, y, graphRect)) return false;
+    // Field writes are strict-masked elsewhere.  For transport repair, allow the
+    // pathfinder to use the broader graph neighborhood so it can reconnect to
+    // realistic regional targets beyond the selected patch.  Water remains
+    // blocked by pathCost(), preserving the existing island/strait behavior.
+    return true;
+  };
+}
+
+function makeTransportConnectorExtraCost(world, rects, seed, mode) {
+  return (x, y) => {
+    const i = worldIndexOf(world, x, y);
+    if (i < 0) return 999;
+    const alpha = patchAlpha(x, y, rects, seed);
+    const edgePenalty = alpha > 0 ? Math.max(0, 0.35 - alpha) * 1.1 : 0;
+    const roadInf = world.fields.roadInfluence?.[i] || 0;
+    const railInf = world.fields.railInfluence2?.[i] || 0;
+    const transportBonus = mode === "rail" ? railInf * 0.45 : roadInf * 0.35;
+    return Math.max(0, edgePenalty - transportBonus);
+  };
+}
+
+function transportLineSeaBarrier(world, a, b, mode = "road") {
+  const ax = Math.round(a?.x || 0), ay = Math.round(a?.y || 0);
+  const bx = Math.round(b?.x || 0), by = Math.round(b?.y || 0);
+  const steps = Math.max(1, Math.ceil(Math.hypot(bx - ax, by - ay)));
+  let seaHits = 0;
+  let longestRun = 0;
+  let run = 0;
+  for (let s = 0; s <= steps; s++) {
+    const t = s / steps;
+    const x = Math.round(ax + (bx - ax) * t);
+    const y = Math.round(ay + (by - ay) * t);
+    const water = !isLand(world, x, y);
+    if (water) {
+      seaHits++;
+      run++;
+      longestRun = Math.max(longestRun, run);
+    } else {
+      run = 0;
+    }
+  }
+  // Keep the existing island/strait behavior: do not spend expensive A* attempts
+  // on pairs that are probably separated by open water.  Small coastal gaps are
+  // still allowed, especially for roads, so pre-existing bridge-like contexts
+  // can be repaired without turning islands into a road mesh.
+  const seaRatio = seaHits / Math.max(1, steps + 1);
+  const maxRun = mode === "rail" ? 4 : 6;
+  return longestRun > maxRun || seaRatio > (mode === "rail" ? 0.10 : 0.14);
+}
+
+function writeConnectorPath(world, sourceMap, mode, path, rects, seed, strictMask) {
+  const layer = mode === "rail" ? "branchRailways" : "minorRoads";
+  sourceMap[layer] ||= [];
+  const startLength = sourceMap[layer].length;
+  const clean = dedupeWorldPath(path);
+  if (clean.length < 2) return { wrote: 0, layer, startLength };
+  const chunks = [clean];
+  let wrote = 0;
+  for (const chunk of chunks) {
+    const out = dedupeWorldPath(chunk);
+    if (out.length < 2) continue;
+    // Reject tiny one-cell remnants produced by strict polygon clipping.  They
+    // look like specks rather than graph repairs.
+    if (pathLength(out) < (mode === "rail" ? 4 : 3)) continue;
+    sourceMap[layer].push(sourcePathFromWorld(world, simplifyPath(out, mode === "rail" ? 3 : 2)));
+    wrote++;
+  }
+  return { wrote, layer, startLength };
+}
+
+function reconnectTransportGraph(world, sourceMap, rects, seed, mode, graphRect, options = {}) {
+  const maxAdds = options.maxAdds ?? (mode === "rail" ? 8 : 16);
+  const maxDistance = options.maxDistance ?? (mode === "rail" ? 280 : 380);
+  const minComponentSize = options.minComponentSize ?? (mode === "rail" ? 3 : 4);
+  const debug = {
+    [`${mode}GraphBeforeComponents`]: 0,
+    [`${mode}GraphAfterComponents`]: 0,
+    [`${mode}GraphConnectorsAdded`]: 0,
+    [`${mode}GraphConnectorsFailed`]: 0,
+    [`${mode}GraphCandidatesConsidered`]: 0,
+    [`${mode}GraphComponentsIgnored`]: 0,
+  };
+
+  const eligible = (comp) => {
+    if (!comp || comp.size < minComponentSize) return false;
+    // Broad transport context is intentional, but the worklist is limited to
+    // components that touch the edited neighborhood.  Purely external networks
+    // remain as context/targets, not as things to rewire together.
+    return comp.patchCells > 0 || comp.nearWriteCells > 0;
+  };
+  const contextual = (comp) => {
+    if (!comp || comp.size < minComponentSize) return false;
+    return comp.patchCells > 0 || comp.nearWriteCells > 0 || comp.exteriorCells > 0;
+  };
+
+  let snapshot = buildTransportGraphSnapshot(world, sourceMap, mode, graphRect, rects, seed);
+  debug[`${mode}GraphBeforeComponents`] = snapshot.comps.filter(eligible).length;
+  const rejectedPairs = new Set();
+  let attemptsRemaining = options.maxAttempts ?? (mode === "rail" ? 4 : 8);
+  for (let pass = 0; pass < maxAdds && attemptsRemaining > 0; pass++) {
+    const dirtyCount = snapshot.comps.filter(eligible).length;
+    if (dirtyCount <= 1) break;
+    const comps = snapshot.comps.filter(contextual);
+    if (comps.length <= 1) break;
+
+    const candidates = buildTransportPairCandidates(snapshot, comps, maxDistance, mode, rejectedPairs);
+    debug[`${mode}GraphCandidatesConsidered`] += candidates.length;
+    if (!candidates.length) {
+      debug[`${mode}GraphComponentsIgnored`] += dirtyCount;
+      break;
+    }
+
+    let accepted = false;
+    for (const candidate of candidates.slice(0, 1)) {
+      const { a, b, d } = candidate.pair;
+      if (transportLineSeaBarrier(world, a, b, mode)) {
+        debug[`${mode}GraphConnectorsFailed`]++;
+        rejectedPairs.add(transportPairSignature(a, b, mode));
+        rejectedPairs.add(transportPairSignature(b, a, mode));
+        continue;
+      }
+      const pad = Math.ceil(Math.max(28, Math.min(mode === "rail" ? 72 : 84, d * 0.38 + 16)));
+      const searchRect = expandRect({
+        x0: Math.floor(Math.min(a.x, b.x)),
+        y0: Math.floor(Math.min(a.y, b.y)),
+        x1: Math.ceil(Math.max(a.x, b.x) + 1),
+        y1: Math.ceil(Math.max(a.y, b.y) + 1),
+      }, pad, world);
+      const boundedSearchRect = {
+        x0: Math.max(searchRect.x0, graphRect.x0),
+        y0: Math.max(searchRect.y0, graphRect.y0),
+        x1: Math.min(searchRect.x1, graphRect.x1),
+        y1: Math.min(searchRect.y1, graphRect.y1),
+      };
+      const allowCell = makeTransportConnectorAllowCell(world, snapshot, rects, seed, !!rects.strictSelectionMask);
+      const extraCost = makeTransportConnectorExtraCost(world, rects, seed, mode);
+      const searchArea = Math.max(0, rectWidth(boundedSearchRect) * rectHeight(boundedSearchRect));
+      if (searchArea > (mode === "rail" ? 72000 : 90000)) {
+        debug[`${mode}GraphConnectorsFailed`]++;
+        rejectedPairs.add(transportPairSignature(a, b, mode));
+        rejectedPairs.add(transportPairSignature(b, a, mode));
+        continue;
+      }
+      attemptsRemaining--;
+      const path = localPathfind(world, a, b, boundedSearchRect, mode, mode === "rail" ? 5500 : 7000, { allowCell, extraCost });
+      const clean = dedupeWorldPath(path || []);
+      const routeLen = pathLength(clean);
+      const tooLong = !clean.length || routeLen > d * (mode === "rail" ? 2.65 : 3.05) + (mode === "rail" ? 48 : 70);
+      if (tooLong) {
+        debug[`${mode}GraphConnectorsFailed`]++;
+        rejectedPairs.add(transportPairSignature(a, b, mode));
+        rejectedPairs.add(transportPairSignature(b, a, mode));
+        continue;
+      }
+
+      const beforeEligibleComponents = dirtyCount;
+      const writeResult = writeConnectorPath(world, sourceMap, mode, clean, rects, seed, !!rects.strictSelectionMask);
+      if (!writeResult.wrote) {
+        debug[`${mode}GraphConnectorsFailed`]++;
+        rejectedPairs.add(transportPairSignature(a, b, mode));
+        rejectedPairs.add(transportPairSignature(b, a, mode));
+        continue;
+      }
+      const checkSnapshot = buildTransportGraphSnapshot(world, sourceMap, mode, graphRect, rects, seed);
+      const afterEligibleComponents = checkSnapshot.comps.filter(eligible).length;
+      if (afterEligibleComponents >= beforeEligibleComponents) {
+        sourceMap[writeResult.layer].splice(writeResult.startLength);
+        debug[`${mode}GraphConnectorsFailed`]++;
+        rejectedPairs.add(transportPairSignature(a, b, mode));
+        rejectedPairs.add(transportPairSignature(b, a, mode));
+        continue;
+      }
+      snapshot = checkSnapshot;
+      debug[`${mode}GraphConnectorsAdded`] += writeResult.wrote;
+      accepted = true;
+      break;
+    }
+    if (!accepted) break;
+  }
+  debug[`${mode}GraphAfterComponents`] = snapshot.comps.filter(eligible).length;
+  return debug;
+}
+
+function dedupeAdminCentersByWorldId(kept, generated) {
+  const out = [...kept];
+  const seen = new Set();
+  for (const p of kept) {
+    const id = numericFeatureId(p, ["adminId", "municipalityId", "adminNumericId"]);
+    if (id >= 0) seen.add(id);
+  }
+  for (const p of generated) {
+    const id = numericFeatureId(p, ["adminId", "municipalityId", "adminNumericId"]);
+    if (id >= 0 && seen.has(id)) continue;
+    if (id >= 0) seen.add(id);
+    out.push(p);
+  }
+  return out;
+}
+
+function dedupePrefectureRegionsByWorldId(kept, generated) {
+  const out = [...kept];
+  const seen = new Set();
+  for (const p of kept) {
+    const id = numericFeatureId(p, ["prefectureRegionId", "id"]);
+    if (id >= 0) seen.add(id);
+  }
+  for (const p of generated) {
+    const id = numericFeatureId(p, ["prefectureRegionId", "id"]);
+    if (id >= 0 && seen.has(id)) continue;
+    if (id >= 0) seen.add(id);
+    out.push(p);
+  }
+  return out;
+}
+
+function collectActiveIdsInPatch(world, fieldName, rects, seed = 0) {
+  const out = new Set();
+  const field = world?.fields?.[fieldName];
+  const sea = world?.fields?.sea;
+  if (!field) return out;
+  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+      if (patchAlpha(x, y, rects, seed) < 0.08) continue;
+      const i = worldIndexOf(world, x, y);
+      if (i >= 0 && !sea?.[i] && field[i] >= 0) out.add(Math.floor(field[i]));
+    }
+  }
+  return out;
+}
+
+function backfillCandidateAdministrativeMetadata(world, sourceMap, candidate, rects, window, seed, adminIdMapping) {
+  let prefectureMetadataBackfilled = 0;
+  let adminMetadataBackfilled = 0;
+  const specs = [
+    { key: "prefectureRegions", field: "prefectureRegionId", rawKeys: ["prefectureRegionId", "id"], mapping: adminIdMapping?.prefecture, counter: "pref" },
+    { key: "adminCenters", field: "adminId", rawKeys: ["adminId", "municipalityId", "adminNumericId"], mapping: adminIdMapping?.admin || adminIdMapping?.municipality, counter: "admin" },
+  ];
+  for (const spec of specs) {
+    const active = collectActiveIdsInPatch(world, spec.field, rects, seed);
+    if (!active.size) continue;
+    const arr = Array.isArray(sourceMap[spec.key]) ? sourceMap[spec.key] : (sourceMap[spec.key] = []);
+    const existing = new Map();
+    for (const p of arr) {
+      const id = metadataIdForLayer(p, spec.key);
+      if (id >= 0 && !existing.has(id)) existing.set(id, p);
+    }
+    for (const p of candidate?.[spec.key] || []) {
+      const raw = numericFeatureId(p, spec.rawKeys);
+      const mapped = spec.mapping?.get(raw);
+      if (!Number.isFinite(mapped) || !active.has(Math.floor(mapped))) continue;
+      const id = Math.floor(mapped);
+      const prior = existing.get(id);
+      if (prior) {
+        for (const field of ["name", "labelName", "prefectureName", "prefectureRegionName", "regionName", "municipalityName"]) {
+          if ((!prior[field] || /^県域\d+$/.test(String(prior[field]))) && p[field]) prior[field] = p[field];
+        }
+        continue;
+      }
+      const q = transformCandidatePoint(world, window, p, spec.key, seed, adminIdMapping) || clonePointForPatch(p);
+      if (spec.key === "prefectureRegions") { q.id = id; q.prefectureRegionId = id; q.featureId = id; }
+      else { q.adminId = id; q.municipalityId = id; q.adminNumericId = id; }
+      q.patchGenerated = true;
+      arr.push(q);
+      existing.set(id, q);
+      if (spec.counter === "pref") prefectureMetadataBackfilled++;
+      else adminMetadataBackfilled++;
+    }
+  }
+  return { prefectureMetadataBackfilled, adminMetadataBackfilled };
+}
+
+function mergePointLayers(world, sourceMap, candidate, rects, window, seed, adminIdMapping = null) {
+  let preservedExternalEntities = 0;
+  let regeneratedInternalEntities = 0;
+  let invalidPortsRemoved = 0;
+  for (const key of POINT_LAYER_KEYS) {
+    const oldArr = Array.isArray(sourceMap[key]) ? sourceMap[key] : [];
+    const kept = [];
+    for (const p of oldArr) {
+      if (!p) continue;
+      const wx = Math.round(pointWorldX(world, p));
+      const wy = Math.round(pointWorldY(world, p));
+      const inWrite = insideRect(wx, wy, rects.writeRect);
+      const alpha = inWrite ? patchAlpha(wx, wy, rects, seed) : 0;
+      // Use the same ownership threshold for removal and insertion.  Different
+      // thresholds created a seam band where old towns disappeared before new
+      // towns, stations and labels were eligible to enter.
+      const removalThreshold = PATCH_FEATURE_REPLACE_ALPHA;
+      if (!inWrite || alpha < removalThreshold) {
+        kept.push(p);
+        if (!inWrite) preservedExternalEntities++;
+      } else if (key === "ports" && (!isLand(world, wx, wy) || seaNeighbors(world, wx, wy, 2) < 2)) {
+        invalidPortsRemoved++;
+        continue;
+      }
+    }
+    const generated = [];
+    const suppressCandidateExternal = rects.patchMode === PATCH_MODE_EXPANSION && key === "externalGateways";
+    for (const p of suppressCandidateExternal ? [] : (candidate[key] || [])) {
+      const q = transformCandidatePoint(world, window, p, key, seed, adminIdMapping);
+      if (!q) continue;
+      const wx = Math.round(pointWorldX(world, q));
+      const wy = Math.round(pointWorldY(world, q));
+      if (!insideRect(wx, wy, rects.writeRect)) continue;
+      if (!patchCellOwned(rects, wx, wy, seed, PATCH_FEATURE_REPLACE_ALPHA)) continue;
+      generated.push(q);
+    }
+    if (key === "adminCenters") sourceMap[key] = dedupeAdminCentersByWorldId(kept, generated);
+    else if (key === "prefectureRegions") sourceMap[key] = dedupePrefectureRegionsByWorldId(kept, generated);
+    else sourceMap[key] = [...kept, ...generated];
+    regeneratedInternalEntities += Math.max(0, sourceMap[key].length - kept.length);
+  }
+  return { preservedExternalEntities, regeneratedInternalEntities, invalidPortsRemoved };
+}
+
+function seamTransportInfluence(world, x, y, mode = "road") {
+  const i = worldIndexOf(world, Math.round(x), Math.round(y));
+  if (i < 0) return 0;
+  const road = world.fields.roadInfluence?.[i] || 0;
+  const rail = world.fields.railInfluence2?.[i] || 0;
+  return mode === "rail" ? rail : Math.max(road, rail * 0.35);
+}
+
+function selectionBoundaryDistance(x, y, rects) {
+  const polygon = rects?.selectionShape?.polygon;
+  if (polygon?.length >= 3) return distanceToPolygonEdge(x + 0.5, y + 0.5, polygon);
+  return distanceToRectEdge(x, y, rects?.coreRect || rects?.writeRect);
+}
+
+function isSyntheticExpansionEdge(x, y, rects, limit = 6) {
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION) return false;
+  const actualFrontierClearance = Math.max(8, (rects.expansionOverlap || 0) + 3);
+  if (coverageDistanceAt(rects, Math.round(x), Math.round(y), "generated") <= actualFrontierClearance) return false;
+  return selectionBoundaryDistance(x, y, rects) <= limit;
+}
+
+function transportEndpointSupported(world, sourceMap, x, y, mode = "road") {
+  const keys = mode === "rail"
+    ? ["stations", "modernCities", "satelliteCities", "adminCenters", "ports"]
+    : ["villages", "modernCities", "satelliteCities", "adminCenters", "ports", "interchanges", "markets", "castleTowns"];
+  const radius = mode === "rail" ? 6.5 : 5.0;
+  const radius2 = radius * radius;
+  for (const key of keys) {
+    for (const p of sourceMap?.[key] || []) {
+      const dx = pointWorldX(world, p) - x;
+      const dy = pointWorldY(world, p) - y;
+      if (dx * dx + dy * dy <= radius2) return true;
+    }
+  }
+  return false;
+}
+
+function trimCandidateTransportVoidEnds(world, sourceMap, chunk, rects, seed, mode = "road") {
+  if (!Array.isArray(chunk) || chunk.length < 2 || (mode !== "road" && mode !== "rail")) return chunk || [];
+  const minInf = mode === "rail" ? 0.038 : 0.052;
+  const edgeAlpha = mode === "rail" ? 0.54 : 0.58;
+  const maxTrim = Math.min(chunk.length - 2, mode === "rail" ? 14 : 18);
+  const syntheticUnsupported = ([x, y]) => isSyntheticExpansionEdge(x, y, rects, 6)
+    && !transportEndpointSupported(world, sourceMap, x, y, mode);
+  const startSynthetic = syntheticUnsupported(chunk[0]);
+  const endSynthetic = syntheticUnsupported(chunk[chunk.length - 1]);
+  if ((startSynthetic || endSynthetic) && (chunk.length <= 7 || pathLength(chunk) <= 11)) return [];
+  const shouldTrim = ([x, y]) => {
+    if (syntheticUnsupported([x, y])) return true;
+    const a = patchAlpha(x, y, rects, seed);
+    if (a <= 0.005 || a > edgeAlpha) return false;
+    if (rectDistance(x, y, rects.writeRect) > 16) return false;
+    return seamTransportInfluence(world, x, y, mode) < minInf;
+  };
+  let start = 0;
+  let end = chunk.length;
+  let trimmed = 0;
+  while (end - start > 2 && trimmed < maxTrim && shouldTrim(chunk[start])) { start++; trimmed++; }
+  trimmed = 0;
+  while (end - start > 2 && trimmed < maxTrim && shouldTrim(chunk[end - 1])) { end--; trimmed++; }
+  const out = chunk.slice(start, end);
+  if (out.length < 2) return [];
+  const remainsSynthetic = syntheticUnsupported(out[0]) || syntheticUnsupported(out[out.length - 1]);
+  if (remainsSynthetic && (out.length <= 14 || pathLength(out) <= 24)) return [];
+  return out;
+}
+
+function portalRepairLayer(sourceMap, portal, mode) {
+  const allowed = new Set(transportLayerKeys(mode));
+  const requested = allowed.has(portal?.layer) ? portal.layer : null;
+  const fallback = mode === "rail" ? "branchRailways" : "minorRoads";
+  // External layers describe routes that leave the currently generated world.
+  // Once an expansion continues one of those routes across a real old/new seam,
+  // the connector is an internal route rather than a new synthetic perimeter
+  // gateway.  Store it in the equivalent internal hierarchy so later exports do
+  // not retain patch-generated external stubs along the candidate frame.
+  const internalEquivalent = {
+    externalRoads: "nationalRoads",
+    externalRailways: "railways",
+    externalExpressways: "expressways",
+  };
+  const layer = internalEquivalent[requested] || requested || fallback;
+  sourceMap[layer] ||= [];
+  return layer;
+}
+
+function occupiedTransportCells(occupied, portal, rects, seed, wantedSide, maxRadius, direction = null) {
+  const out = [];
+  for (const key of occupied || []) {
+    const point = diagnosticCellFromKey(key);
+    const dx = point.x - portal.x;
+    const dy = point.y - portal.y;
+    const distance = Math.hypot(dx, dy);
+    if (distance > maxRadius || diagnosticPatchSide(point.x, point.y, rects, seed) !== wantedSide) continue;
+    let directionPenalty = 0;
+    if (direction && distance > 0.001) {
+      const dot = (dx / distance) * direction.x + (dy / distance) * direction.y;
+      directionPenalty = Math.max(0, 1 - dot) * 10;
+    }
+    out.push({ x: point.x, y: point.y, distance, score: distance + directionPenalty });
+  }
+  out.sort((a, b) => a.score - b.score);
+  return out;
+}
+
+function portalGatewayCell(world, portal, rects, seed) {
+  const preferred = portal?.inside || { x: portal.x, y: portal.y };
+  let best = null;
+  let bestScore = Infinity;
+  for (let radius = 0; radius <= 7; radius++) {
+    for (let y = Math.floor(preferred.y - radius); y <= Math.ceil(preferred.y + radius); y++) {
+      for (let x = Math.floor(preferred.x - radius); x <= Math.ceil(preferred.x + radius); x++) {
+        if (radius > 0 && Math.abs(x - preferred.x) !== radius && Math.abs(y - preferred.y) !== radius) continue;
+        if (!isLand(world, x, y) || diagnosticPatchSide(x, y, rects, seed) !== 1) continue;
+        const dx = x - portal.x;
+        const dy = y - portal.y;
+        const distance = Math.hypot(dx, dy);
+        const direction = portal?.direction || { x: 0, y: 0 };
+        const dot = distance > 0.001 ? (dx / distance) * direction.x + (dy / distance) * direction.y : 1;
+        const score = Math.hypot(x - preferred.x, y - preferred.y) + Math.max(0, 1 - dot) * 4;
+        if (score < bestScore) {
+          bestScore = score;
+          best = { x, y };
+        }
+      }
+    }
+    if (best) break;
+  }
+  return best;
+}
+
+function boundedConnectorRect(world, points, graphRect, padding) {
+  const xs = points.map((p) => p.x);
+  const ys = points.map((p) => p.y);
+  const raw = expandRect({
+    x0: Math.floor(Math.min(...xs)),
+    y0: Math.floor(Math.min(...ys)),
+    x1: Math.ceil(Math.max(...xs) + 1),
+    y1: Math.ceil(Math.max(...ys) + 1),
+  }, padding, world);
+  return {
+    x0: Math.max(raw.x0, graphRect.x0),
+    y0: Math.max(raw.y0, graphRect.y0),
+    x1: Math.min(raw.x1, graphRect.x1),
+    y1: Math.min(raw.y1, graphRect.y1),
+  };
+}
+
+function writePortalConnectorPath(world, sourceMap, portal, mode, path) {
+  const layer = portalRepairLayer(sourceMap, portal, mode);
+  const startLength = sourceMap[layer].length;
+  const clean = dedupeWorldPath(path);
+  if (clean.length < 2 || pathLength(clean) < 1.5) return { wrote: 0, layer, startLength };
+  const stored = sourcePathFromWorld(world, simplifyPath(clean, mode === "rail" ? 2 : 2));
+  stored.patchPortalConnector = true;
+  stored.patchPortalId = portal?.id || `${mode}:${portal?.x},${portal?.y}`;
+  sourceMap[layer].push(stored);
+  return { wrote: 1, layer, startLength };
+}
+
+function restorePortalLegacyGuide(world, sourceMap, portal, mode, start) {
+  const guide = (portal?.legacyGuide || []).filter(([x, y]) => isLand(world, x, y));
+  if (!guide.length) return { wrote: 0, layer: portalRepairLayer(sourceMap, portal, mode), startLength: 0 };
+  const path = [[start.x, start.y], ...guide];
+  return writePortalConnectorPath(world, sourceMap, portal, mode, path);
+}
+
+function repairMandatoryTransportPortals(world, sourceMap, rects, seed, portals, mode, graphRect) {
+  const keys = mode === "rail" ? SEAM_DIAGNOSTIC_RAIL_KEYS : SEAM_DIAGNOSTIC_ROAD_KEYS;
+  const maxTargetRadius = mode === "rail" ? 150 : 190;
+  const maxTargets = mode === "rail" ? 5 : 7;
+  const debug = {
+    total: portals?.length || 0,
+    alreadyConnected: 0,
+    repaired: 0,
+    unresolved: 0,
+    connectorsAdded: 0,
+    legacyGuideFallbacks: 0,
+    pathAttempts: 0,
+    unresolvedPortals: [],
+  };
+  for (const portal of portals || []) {
+    const localRect = boundedConnectorRect(world, [portal.outside || portal, portal.inside || portal], graphRect, maxTargetRadius + 10);
+    let occupied = rasterizeDiagnosticPaths(world, sourceMap, keys, localRect);
+    if (diagnosticPortalConnected(occupied, portal, rects, seed)) {
+      debug.alreadyConnected++;
+      continue;
+    }
+    const starts = occupiedTransportCells(occupied, portal, rects, seed, -1, 18);
+    const start = starts[0] || (portal.outside && isLand(world, portal.outside.x, portal.outside.y) ? portal.outside : null);
+    const gateway = portalGatewayCell(world, portal, rects, seed);
+    if (!start || !gateway) {
+      debug.unresolved++;
+      debug.unresolvedPortals.push({ id: portal?.id || null, x: portal?.x, y: portal?.y, layer: portal?.layer || null, outside: portal?.outside || null, inside: portal?.inside || null, start: start || null, gateway: gateway || null, reason: !start ? "no-outside-start" : "no-gateway" });
+      continue;
+    }
+    const targets = occupiedTransportCells(occupied, portal, rects, seed, 1, maxTargetRadius, portal.direction).filter((p) => Math.hypot(p.x - gateway.x, p.y - gateway.y) >= 2).slice(0, maxTargets);
+    let repaired = false;
+    for (const target of targets) {
+      const searchRect = boundedConnectorRect(world, [start, gateway, target], graphRect, mode === "rail" ? 34 : 42);
+      const searchArea = rectArea(searchRect);
+      if (searchArea <= 0 || searchArea > (mode === "rail" ? 62000 : 82000)) continue;
+      debug.pathAttempts++;
+      const firstLeg = localPathfind(world, start, gateway, searchRect, mode, mode === "rail" ? 8500 : 10500);
+      if (!firstLeg?.length) continue;
+      const secondLeg = localPathfind(world, gateway, target, searchRect, mode, mode === "rail" ? 14500 : 18500, {
+        extraCost: makeTransportConnectorExtraCost(world, rects, seed, mode),
+      });
+      if (!secondLeg?.length) continue;
+      const combined = dedupeWorldPath([...firstLeg, ...secondLeg.slice(1)]);
+      const directDistance = Math.hypot(start.x - target.x, start.y - target.y);
+      if (pathLength(combined) > directDistance * (mode === "rail" ? 3.2 : 3.8) + 80) continue;
+      const write = writePortalConnectorPath(world, sourceMap, portal, mode, combined);
+      if (!write.wrote) continue;
+      occupied = rasterizeDiagnosticPaths(world, sourceMap, keys, localRect);
+      if (!diagnosticPortalConnected(occupied, portal, rects, seed)) {
+        sourceMap[write.layer].splice(write.startLength);
+        continue;
+      }
+      debug.connectorsAdded += write.wrote;
+      debug.repaired++;
+      repaired = true;
+      break;
+    }
+    if (repaired) continue;
+
+    // A portal is first and foremost a topological crossing contract.  When no
+    // generated target lies within the bounded search, retain an exact short
+    // outside-to-gateway bridge instead of rolling back an otherwise valid
+    // overlapping expansion.  The graph reconnection pass can extend this
+    // bridge afterward, but the visible old route never ends at the seam.
+    const gatewayRect = boundedConnectorRect(world, [start, gateway], graphRect, mode === "rail" ? 24 : 30);
+    if (rectArea(gatewayRect) > 0) {
+      debug.pathAttempts++;
+      const gatewayLeg = localPathfind(world, start, gateway, gatewayRect, mode, mode === "rail" ? 7000 : 9000);
+      if (gatewayLeg?.length) {
+        const write = writePortalConnectorPath(world, sourceMap, portal, mode, gatewayLeg);
+        if (write.wrote) {
+          occupied = rasterizeDiagnosticPaths(world, sourceMap, keys, localRect);
+          if (diagnosticPortalConnected(occupied, portal, rects, seed)) {
+            debug.connectorsAdded += write.wrote;
+            debug.repaired++;
+            repaired = true;
+          } else {
+            sourceMap[write.layer].splice(write.startLength);
+          }
+        }
+      }
+    }
+    if (repaired) continue;
+
+    // A generated network can occasionally be farther away than the bounded
+    // routing search.  Preserve the old centerline only as a short mandatory
+    // gateway; the exact-component graph pass that follows can then attach this
+    // gateway to the nearest generated component.
+    const fallback = restorePortalLegacyGuide(world, sourceMap, portal, mode, start);
+    if (fallback.wrote) {
+      occupied = rasterizeDiagnosticPaths(world, sourceMap, keys, localRect);
+      if (diagnosticPortalConnected(occupied, portal, rects, seed)) {
+        debug.connectorsAdded += fallback.wrote;
+        debug.legacyGuideFallbacks++;
+        debug.repaired++;
+        repaired = true;
+      } else {
+        sourceMap[fallback.layer].splice(fallback.startLength);
+      }
+    }
+    if (!repaired) {
+      debug.unresolved++;
+      debug.unresolvedPortals.push({ id: portal?.id || null, x: portal?.x, y: portal?.y, layer: portal?.layer || null, outside: portal?.outside || null, inside: portal?.inside || null, start, gateway, targetCount: targets.length, reason: targets.length ? "routing-failed" : "no-inside-target" });
+    }
+  }
+  return debug;
+}
+
+function removeSyntheticExpansionTransportFragments(world, sourceMap, rects) {
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION) return { syntheticRoadFragmentsRemoved: 0, syntheticRailFragmentsRemoved: 0 };
+  let syntheticRoadFragmentsRemoved = 0;
+  let syntheticRailFragmentsRemoved = 0;
+  for (const key of [...ROAD_LAYER_KEYS, ...RAIL_LAYER_KEYS]) {
+    const mode = RAIL_LAYER_KEYS.has(key) ? "rail" : "road";
+    const kept = [];
+    for (const path of sourceMap?.[key] || []) {
+      if (!path?.patchGenerated || path.length < 2) { kept.push(path); continue; }
+      const worldPath = path.map((tuple) => [tupleWorldX(world, tuple), tupleWorldY(world, tuple)]);
+      const start = worldPath[0];
+      const end = worldPath[worldPath.length - 1];
+      const synthetic = isSyntheticExpansionEdge(start[0], start[1], rects, 6)
+        || isSyntheticExpansionEdge(end[0], end[1], rects, 6);
+      if (synthetic && (worldPath.length <= 12 || pathLength(worldPath) <= 20)) {
+        if (mode === "rail") syntheticRailFragmentsRemoved++;
+        else syntheticRoadFragmentsRemoved++;
+        continue;
+      }
+      kept.push(path);
+    }
+    sourceMap[key] = kept;
+  }
+  return { syntheticRoadFragmentsRemoved, syntheticRailFragmentsRemoved };
+}
+
+function mergePathLayers(world, sourceMap, candidate, rects, window, seed, portalContract = null, transportOptions = {}) {
+  let roadAnchors = [];
+  let railAnchors = [];
+  let roadsClipped = 0;
+  let railsClipped = 0;
+  let regeneratedPaths = 0;
+  for (const key of PATH_LAYER_KEYS) {
+    const oldArr = Array.isArray(sourceMap[key]) ? sourceMap[key] : [];
+    const mode = RAIL_LAYER_KEYS.has(key) ? "rail" : ROAD_LAYER_KEYS.has(key) ? "road" : RIVER_LAYER_KEYS.has(key) ? "river" : "path";
+    const pruned = pruneOldPathLayer(world, oldArr, rects, seed, mode);
+    if (mode === "rail") { railAnchors = railAnchors.concat(pruned.anchors); railsClipped += pruned.clipped; }
+    else if (mode === "road") { roadAnchors = roadAnchors.concat(pruned.anchors); roadsClipped += pruned.clipped; }
+    const next = [...pruned.kept];
+    const suppressCandidateExternal = rects.patchMode === PATCH_MODE_EXPANSION
+      && (key === "externalRoads" || key === "externalRailways" || key === "externalExpressways");
+    for (const path of suppressCandidateExternal ? [] : (candidate[key] || [])) {
+      const worldPath = transformCandidatePath(window, path);
+      const chunks = splitWorldPathByPatch(worldPath, rects, seed, true, PATCH_FEATURE_REPLACE_ALPHA)
+        .map((chunk) => chunk.filter(([x, y]) => mode === "river" || isLand(world, x, y)))
+        .map((chunk) => trimCandidateTransportVoidEnds(world, sourceMap, chunk, rects, seed, mode))
+        .filter((chunk) => chunk.length >= 2);
+      for (const chunk of chunks) {
+        if (chunk.some(([x, y]) => patchCellOwned(rects, x, y, seed, PATCH_FEATURE_REPLACE_ALPHA))) {
+          next.push(sourcePathFromWorld(world, simplifyPath(chunk, mode === "rail" ? 3 : 2)));
+          regeneratedPaths++;
+        }
+      }
+    }
+    sourceMap[key] = next;
+  }
+
+  // Large tiled expansions merge candidate centerlines per tile, but defer the
+  // expensive graph-wide reconnect/portal search until the whole selection is
+  // assembled. Re-running graph repair after every internal tile grows roughly
+  // with the accumulated network and can make a later tile take minutes.
+  if (transportOptions.deferGraphRepair === true) {
+    return {
+      transportGraphDeferred: true,
+      roadsClipped,
+      railsClipped,
+      regeneratedPaths,
+      roadPortalsRequired: portalContract?.roadPortals?.length || 0,
+      roadPortalsConnected: 0,
+      roadPortalsUnresolved: 0,
+      railPortalsRequired: portalContract?.railPortals?.length || 0,
+      railPortalsConnected: 0,
+      railPortalsUnresolved: 0,
+      roadPortalConnectorsAdded: 0,
+      railPortalConnectorsAdded: 0,
+      roadPortalLegacyGuideFallbacks: 0,
+      railPortalLegacyGuideFallbacks: 0,
+      portalPathAttempts: 0,
+      roadConnectorsCreated: 0,
+      railwayConnectorsCreated: 0,
+      disconnectedRoadComponents: roadAnchors.length,
+      disconnectedRailComponents: railAnchors.length,
+      skippedConnectorAnchors: roadAnchors.length + railAnchors.length,
+      connectorAttempts: 0,
+      skippedServedSettlements: 0,
+      checkedSettlementCoverage: 0,
+      externalRoadAnchors: 0,
+      externalRailAnchors: 0,
+    };
+  }
+  const strictMask = !!rects.strictSelectionMask;
+  const broadTransportRect = rects.transportReachRect || expandRect(rects.writeRect, 220, world);
+  const transportRect = strictMask
+    ? broadTransportRect
+    : (rects.transportReachRect || rects.repairRect || rects.writeRect);
+  // Terrain/field generation still obeys the strict lasso mask.  Transport
+  // repair is intentionally allowed to operate in a much broader neighborhood,
+  // because clipping graph repairs to the selected polygon leaves implausible
+  // dangling regional networks just outside the patch.
+  const externalRoadAnchors = collectExternalNetworkAnchors(world, sourceMap, ["nationalRoads", "minorRoads", "premodernRoads", "externalRoads"], rects.writeRect, transportRect, "road");
+  const externalRailAnchors = collectExternalNetworkAnchors(world, sourceMap, ["railways", "branchRailways", "externalRailways"], rects.writeRect, transportRect, "rail");
+  roadAnchors = roadAnchors.concat(externalRoadAnchors);
+  railAnchors = railAnchors.concat(externalRailAnchors);
+  // Legacy anchor-to-target connectors were not graph-validated and could leave
+  // visible fragments that did not reduce disconnected components.  Keep the
+  // anchor collection for diagnostics, but route all actual repair through the
+  // graph reconnection pass below, which rolls back failed candidates.
+  const graphRect = strictMask
+    ? transportRect
+    : transportRect;
+  const roadPortalFirst = repairMandatoryTransportPortals(world, sourceMap, rects, seed, portalContract?.roadPortals || [], "road", graphRect);
+  const railPortalFirst = repairMandatoryTransportPortals(world, sourceMap, rects, seed, portalContract?.railPortals || [], "rail", graphRect);
+  const roadGraph = reconnectTransportGraph(world, sourceMap, rects, seed, "road", graphRect, { maxAdds: strictMask ? 10 : 8, maxDistance: strictMask ? 310 : 285, maxAttempts: strictMask ? 10 : 7 });
+  const railGraph = reconnectTransportGraph(world, sourceMap, rects, seed, "rail", graphRect, { maxAdds: strictMask ? 6 : 5, maxDistance: strictMask ? 225 : 210, maxAttempts: strictMask ? 6 : 5 });
+  const roadPortalFinal = repairMandatoryTransportPortals(world, sourceMap, rects, seed, portalContract?.roadPortals || [], "road", graphRect);
+  const railPortalFinal = repairMandatoryTransportPortals(world, sourceMap, rects, seed, portalContract?.railPortals || [], "rail", graphRect);
+  const syntheticFragmentDebug = removeSyntheticExpansionTransportFragments(world, sourceMap, rects);
+  return {
+    ...syntheticFragmentDebug,
+    roadsClipped,
+    railsClipped,
+    regeneratedPaths,
+    roadPortalsRequired: roadPortalFinal.total,
+    roadPortalsConnected: roadPortalFinal.total - roadPortalFinal.unresolved,
+    roadPortalsUnresolved: roadPortalFinal.unresolved,
+    roadPortalConnectorsAdded: roadPortalFirst.connectorsAdded + roadPortalFinal.connectorsAdded,
+    roadPortalLegacyGuideFallbacks: roadPortalFirst.legacyGuideFallbacks + roadPortalFinal.legacyGuideFallbacks,
+    railPortalsRequired: railPortalFinal.total,
+    railPortalsConnected: railPortalFinal.total - railPortalFinal.unresolved,
+    railPortalsUnresolved: railPortalFinal.unresolved,
+    railPortalConnectorsAdded: railPortalFirst.connectorsAdded + railPortalFinal.connectorsAdded,
+    railPortalLegacyGuideFallbacks: railPortalFirst.legacyGuideFallbacks + railPortalFinal.legacyGuideFallbacks,
+    portalPathAttempts: roadPortalFirst.pathAttempts + roadPortalFinal.pathAttempts + railPortalFirst.pathAttempts + railPortalFinal.pathAttempts,
+    roadConnectorsCreated: (roadGraph.roadGraphConnectorsAdded || 0) + roadPortalFirst.connectorsAdded + roadPortalFinal.connectorsAdded,
+    railwayConnectorsCreated: (railGraph.railGraphConnectorsAdded || 0) + railPortalFirst.connectorsAdded + railPortalFinal.connectorsAdded,
+    disconnectedRoadComponents: roadAnchors.length,
+    disconnectedRailComponents: railAnchors.length,
+    skippedConnectorAnchors: 0,
+    connectorAttempts: (roadGraph.roadGraphCandidatesConsidered || 0) + (railGraph.railGraphCandidatesConsidered || 0),
+    skippedServedSettlements: 0,
+    checkedSettlementCoverage: 0,
+    externalRoadAnchors: externalRoadAnchors.length,
+    externalRailAnchors: externalRailAnchors.length,
+    ...roadGraph,
+    ...railGraph,
+  };
+}
+
+function buildBoundarySegmentsFromField(world, fieldName, rect, options = {}) {
+  const field = world.fields[fieldName];
+  const sea = world.fields.sea;
+  const mask = options.requireMaskField ? world.fields[options.requireMaskField] : null;
+  const sameGroup = options.sameGroupField ? world.fields[options.sameGroupField] : null;
+  if (!field) return [];
+  const out = [];
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0 || sea?.[i] || (mask && !mask[i])) continue;
+      const id = field[i];
+      if (id < 0) continue;
+      const right = worldIndexOf(world, x + 1, y);
+      if (x + 1 < rect.x1 && right >= 0 && !sea?.[right] && (!mask || mask[right]) && field[right] >= 0 && field[right] !== id) {
+        if (!sameGroup || (sameGroup[i] >= 0 && sameGroup[i] === sameGroup[right])) {
+          // Use the same cell-edge coordinates as the initial generator.  The
+          // renderer applies a -0.5 offset; x+1/y+1 therefore lands on the
+          // center of the shared cell edge instead of half a cell away.
+          out.push([[x + 1 - world.originX, y - world.originY], [x + 1 - world.originX, y + 1 - world.originY]]);
+        }
+      }
+      const down = worldIndexOf(world, x, y + 1);
+      if (y + 1 < rect.y1 && down >= 0 && !sea?.[down] && (!mask || mask[down]) && field[down] >= 0 && field[down] !== id) {
+        if (!sameGroup || (sameGroup[i] >= 0 && sameGroup[i] === sameGroup[down])) {
+          out.push([[x - world.originX, y + 1 - world.originY], [x + 1 - world.originX, y + 1 - world.originY]]);
+        }
+      }
+    }
+  }
+  return out;
+}
+
+function buildMaskBoundarySegmentsFromField(world, fieldName, rect) {
+  const field = world.fields[fieldName];
+  const sea = world.fields.sea;
+  if (!field) return [];
+  const out = [];
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      if (x + 1 < rect.x1) {
+        const right = worldIndexOf(world, x + 1, y);
+        if (right >= 0 && field[i] !== field[right] && !(sea?.[i] || sea?.[right])) {
+          out.push([[x + 1 - world.originX, y - world.originY], [x + 1 - world.originX, y + 1 - world.originY]]);
+        }
+      }
+      if (y + 1 < rect.y1) {
+        const down = worldIndexOf(world, x, y + 1);
+        if (down >= 0 && field[i] !== field[down] && !(sea?.[i] || sea?.[down])) {
+          out.push([[x - world.originX, y + 1 - world.originY], [x + 1 - world.originX, y + 1 - world.originY]]);
+        }
+      }
+    }
+  }
+  return out;
+}
+
+function mergeCandidateCompartmentDebugSegments(world, sourceMap, candidate, rects, window, seed = 0) {
+  const debug = sourceMap.adminDebug || {};
+  debug.compartmentBorders ||= [];
+  let added = 0;
+  for (const seg of candidate?.adminDebug?.compartmentBorders || []) {
+    if (!Array.isArray(seg) || seg.length < 2) continue;
+    const a = worldCoordForSource(window, seg[0]?.[0], seg[0]?.[1]);
+    const b = worldCoordForSource(window, seg[1]?.[0], seg[1]?.[1]);
+    const mx = (a.x + b.x) * 0.5;
+    const my = (a.y + b.y) * 0.5;
+    if (!insideRect(mx, my, rects.writeRect) || patchAlpha(mx, my, rects, seed) < 0.08) continue;
+    debug.compartmentBorders.push(sourcePathFromWorld(world, [[a.x, a.y], [b.x, b.y]]));
+    added++;
+  }
+  sourceMap.adminDebug = debug;
+  return added;
+}
+
+function mergeSegmentLayers(world, sourceMap, rects, seed = 0, candidate = null, window = null) {
+  // Administrative vector layers have one canonical source: the final repaired
+  // ID rasters.  Rebuild globally so no candidate vector, pre-patch vector, or
+  // alpha-threshold fallback can survive as a nearby duplicate at the seam.
+  const worldRect = { x0: 0, y0: 0, x1: world.width, y1: world.height };
+  const prefectureBorders = dedupeSegments(buildBoundarySegmentsFromField(world, "prefectureRegionId", worldRect));
+  const municipalBorders = dedupeSegments(buildBoundarySegmentsFromField(world, "adminId", worldRect, {
+    sameGroupField: "prefectureRegionId",
+  }));
+  const outerPrefectureBorder = dedupeSegments(buildMaskBoundarySegmentsFromField(world, "prefectureMask", worldRect));
+
+  sourceMap.adminBorders = municipalBorders;
+  sourceMap.regionalPrefectureBorders = prefectureBorders;
+  sourceMap.prefectureBorder = outerPrefectureBorder;
+
+  const debug = sourceMap.adminDebug || {};
+  debug.compartmentBorders = (debug.compartmentBorders || []).filter((seg) => !segmentTouchesPatch(world, seg, rects, seed, 0.34));
+  sourceMap.adminDebug = debug;
+  return {
+    boundarySource: "final-id-rasters",
+    globalBoundaryRebuild: true,
+    adminBordersRebuilt: municipalBorders.length,
+    prefectureBordersRebuilt: prefectureBorders.length,
+    outerPrefectureBordersRebuilt: outerPrefectureBorder.length,
+    candidateAdminBordersMerged: 0,
+    candidatePrefectureBordersMerged: 0,
+    rasterAdminBordersSuppressed: 0,
+    rasterPrefectureBordersSuppressed: 0,
+    compartmentBordersRebuilt: debug.compartmentBorders.length,
+  };
+}
+
+function repairLanduseAndPopulation(world, rects) {
+  const landuse = world.fields.landuse;
+  if (!landuse) return { landUseCellsUpdated: 0 };
+  let updated = 0;
+  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      if (world.fields.sea?.[i]) {
+        if (landuse[i] !== (LANDUSE.WATER || 0)) updated++;
+        landuse[i] = LANDUSE.WATER || 0;
+        continue;
+      }
+      if (landuse[i] === (LANDUSE.WATER || 0)) {
+        const slope = world.fields.slope?.[i] || 0;
+        const ag = world.fields.agriculture?.[i] || 0;
+        landuse[i] = slope > 0.42 ? LANDUSE.FOREST : ag > 0.28 ? LANDUSE.FARMLAND : LANDUSE.RURAL;
+        updated++;
+      }
+    }
+  }
+  return { landUseCellsUpdated: updated };
+}
+
+function ensureWorldFloatField(world, name) {
+  const expected = world.width * world.height;
+  if (!world.fields[name] || world.fields[name].length !== expected) world.fields[name] = new Float32Array(expected);
+  return world.fields[name];
+}
+
+function clearFieldRect(world, field, rect) {
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const i = worldIndexOf(world, x, y);
+      if (i >= 0) field[i] = 0;
+    }
+  }
+}
+
+function paintInfluenceDisk(world, field, cx, cy, radius, strength, rect) {
+  const sea = world.fields.sea;
+  const r = Math.max(1, Math.ceil(radius));
+  for (let dy = -r; dy <= r; dy++) {
+    for (let dx = -r; dx <= r; dx++) {
+      if (dx * dx + dy * dy > radius * radius) continue;
+      const x = Math.round(cx + dx);
+      const y = Math.round(cy + dy);
+      if (!insideRect(x, y, rect)) continue;
+      const i = worldIndexOf(world, x, y);
+      if (i < 0 || sea?.[i]) continue;
+      const d = Math.hypot(dx, dy);
+      const value = strength * Math.pow(1 - d / Math.max(1, radius), 1.35);
+      if (value > field[i]) field[i] = clamp(value);
+    }
+  }
+}
+
+function pathWorldBounds(world, path) {
+  let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;
+  for (const tuple of path || []) {
+    const x = tupleWorldX(world, tuple);
+    const y = tupleWorldY(world, tuple);
+    if (!Number.isFinite(x) || !Number.isFinite(y)) continue;
+    x0 = Math.min(x0, x); y0 = Math.min(y0, y);
+    x1 = Math.max(x1, x); y1 = Math.max(y1, y);
+  }
+  if (!Number.isFinite(x0)) return null;
+  return { x0, y0, x1: x1 + 1, y1: y1 + 1 };
+}
+
+function rectsSeparatedByMoreThan(a, b, margin = 0) {
+  return a.x1 + margin < b.x0 || a.x0 - margin > b.x1 || a.y1 + margin < b.y0 || a.y0 - margin > b.y1;
+}
+
+function refreshPatchInfluenceFields(world, sourceMap, rects) {
+  const transportRect = rects.transportReachRect || rects.repairRect || rects.writeRect;
+  const localRect = rects.repairRect || rects.writeRect;
+  const roadInfluence = ensureWorldFloatField(world, "roadInfluence");
+  const railInfluence2 = ensureWorldFloatField(world, "railInfluence2");
+  const stationInfluence = ensureWorldFloatField(world, "stationInfluence");
+  const villageInfluence = ensureWorldFloatField(world, "villageInfluence");
+  clearFieldRect(world, roadInfluence, transportRect);
+  clearFieldRect(world, railInfluence2, transportRect);
+  clearFieldRect(world, stationInfluence, transportRect);
+  clearFieldRect(world, villageInfluence, localRect);
+
+  let roadCellsPainted = 0;
+  let railCellsPainted = 0;
+  let stationCellsPainted = 0;
+  let villageCellsPainted = 0;
+  const paintPathLayer = (keys, field, radius, strength, counterName, rect) => {
+    let painted = 0;
+    for (const key of keys) {
+      for (const path of sourceMap[key] || []) {
+        const bounds = pathWorldBounds(world, path);
+        if (!bounds || rectsSeparatedByMoreThan(bounds, rect, radius + 2)) continue;
+        for (const tuple of path || []) {
+          const x = tupleWorldX(world, tuple);
+          const y = tupleWorldY(world, tuple);
+          if (rectDistance(x, y, rect) > radius + 1) continue;
+          paintInfluenceDisk(world, field, x, y, radius, strength, rect);
+          painted++;
+        }
+      }
+    }
+    if (counterName === "road") roadCellsPainted += painted;
+    if (counterName === "rail") railCellsPainted += painted;
+  };
+
+  paintPathLayer(["nationalRoads", "ringRoads", "externalRoads", "minorRoads", "premodernRoads", "icAccessRoads"], roadInfluence, 5, 1, "road", transportRect);
+  paintPathLayer(["railways", "branchRailways", "ringRailways", "externalRailways"], railInfluence2, 4, 1, "rail", transportRect);
+
+  for (const p of sourceMap.stations || []) {
+    const x = pointWorldX(world, p);
+    const y = pointWorldY(world, p);
+    if (rectDistance(x, y, transportRect) > 8) continue;
+    paintInfluenceDisk(world, stationInfluence, x, y, 5, clamp(p.score || 1), transportRect);
+    stationCellsPainted++;
+  }
+  for (const p of sourceMap.villages || []) {
+    const x = pointWorldX(world, p);
+    const y = pointWorldY(world, p);
+    if (rectDistance(x, y, localRect) > 10) continue;
+    paintInfluenceDisk(world, villageInfluence, x, y, 6, clamp((p.population || 1800) / 4200, 0.35, 1.2), localRect);
+    villageCellsPainted++;
+  }
+
+  return { roadCellsPainted, railCellsPainted, stationCellsPainted, villageCellsPainted };
+}
+
+
+function evaluateFinalExpansionQuality(world, sourceMap, rects, seed = 0, patchQuality = null) {
+  if (!patchQuality || rects?.patchMode !== PATCH_MODE_EXPANSION) return null;
+  const policy = terrainQualityPolicy(patchQuality.terrain?.terrainType || "auto");
+  let selectedCells = 0;
+  let landCells = 0;
+  let ownedCells = 0;
+  let ownedLandCells = 0;
+  for (let y = rects.coreRect.y0; y < rects.coreRect.y1; y++) {
+    for (let x = rects.coreRect.x0; x < rects.coreRect.x1; x++) {
+      if (wasGeneratedAt(rects, x, y) || !patchCellOwned(rects, x, y, seed, PATCH_FEATURE_REPLACE_ALPHA)) continue;
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      const land = !world.fields.sea?.[i];
+      selectedCells++;
+      ownedCells++;
+      if (land) {
+        landCells++;
+        ownedLandCells++;
+      }
+    }
+  }
+  const counts = {};
+  for (const key of PATCH_QUALITY_LABEL_KEYS) {
+    counts[key] = (sourceMap[key] || []).filter((p) => {
+      const x = Math.round(pointWorldX(world, p));
+      const y = Math.round(pointWorldY(world, p));
+      return insideRect(x, y, rects.writeRect)
+        && !wasGeneratedAt(rects, x, y)
+        && patchCellOwned(rects, x, y, seed, PATCH_FEATURE_REPLACE_ALPHA)
+        && isLand(world, x, y);
+    }).length;
+  }
+  const settlementCount = PATCH_QUALITY_SETTLEMENT_KEYS.reduce((sum, key) => sum + (counts[key] || 0), 0);
+  const labelCount = PATCH_QUALITY_LABEL_KEYS.reduce((sum, key) => sum + (counts[key] || 0), 0);
+  const landRatio = landCells / Math.max(1, selectedCells);
+  const ownedLandRatio = ownedLandCells / Math.max(1, ownedCells);
+  const labelDensityPer1000 = labelCount * 1000 / Math.max(1, landCells);
+  const settlementDensityPer1000 = settlementCount * 1000 / Math.max(1, landCells);
+  const minFinalLabels = Math.max(0, Math.floor((patchQuality.human?.minLabels || 0) * 0.58));
+  const minFinalSettlements = Math.max(0, Math.floor((patchQuality.human?.minSettlements || 0) * 0.58));
+  const landFloor = patchQuality.terrain?.terrainType === "oceanic_archipelago"
+    ? policy.minLand * 0.55
+    : policy.minLand * 0.80;
+  const hardPass = ownedCells < 64 || (
+    ownedLandRatio >= landFloor
+    && labelCount >= minFinalLabels
+    && settlementCount >= minFinalSettlements
+  );
+  const score = clamp(
+    clamp(ownedLandRatio / Math.max(0.01, policy.targetLand)) * 0.46
+    + clamp(labelCount / Math.max(1, minFinalLabels * 1.35)) * 0.30
+    + clamp(settlementCount / Math.max(1, minFinalSettlements * 1.35)) * 0.24
+  );
+  return {
+    policyVersion: PATCH_QUALITY_POLICY_VERSION,
+    selectedCells,
+    landCells,
+    landRatio,
+    ownedCells,
+    ownedLandCells,
+    ownedLandRatio,
+    counts,
+    settlementCount,
+    labelCount,
+    settlementDensityPer1000,
+    labelDensityPer1000,
+    minFinalLabels,
+    minFinalSettlements,
+    landFloor,
+    hardPass,
+    score,
+  };
+}
+
+function countSea(world, rect, rects = null, seed = 0) {
+  let seaCount = 0;
+  let total = 0;
+  const useStrictMask = !!rects?.strictSelectionMask;
+  const scanRect = useStrictMask ? (rects.writeRect || rect) : rect;
+  for (let y = scanRect.y0; y < scanRect.y1; y++) {
+    for (let x = scanRect.x0; x < scanRect.x1; x++) {
+      if (useStrictMask && patchAlpha(x, y, rects, seed) <= 0.005) continue;
+      const i = worldIndexOf(world, x, y);
+      if (i < 0) continue;
+      total++;
+      if (world.fields.sea?.[i]) seaCount++;
+    }
+  }
+  return { seaCount, total, seaRatio: total ? seaCount / total : 0 };
+}
+
+
+const SEAM_DIAGNOSTIC_ROAD_KEYS = [
+  "premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "externalRoads",
+  "expressways", "externalExpressways", "icAccessRoads",
+];
+const SEAM_DIAGNOSTIC_RAIL_KEYS = ["railways", "branchRailways", "ringRailways", "externalRailways"];
+const SEAM_DIAGNOSTIC_MAX_MARKERS = 320;
+
+function diagnosticCellKey(x, y) {
+  return `${x},${y}`;
+}
+
+function diagnosticCellFromKey(key) {
+  const [x, y] = String(key).split(",").map(Number);
+  return { x, y };
+}
+
+function isSeamDiagnosticLocation(x, y, rects, seed = 0) {
+  const rx = Math.round(x);
+  const ry = Math.round(y);
+  const a = patchAlpha(rx, ry, rects, seed);
+  if (a > 0.025 && a < 0.975) return true;
+  for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]]) {
+    const na = patchAlpha(rx + dx, ry + dy, rects, seed);
+    if ((a <= 0.025 && na > 0.025) || (a >= 0.975 && na < 0.975) || Math.abs(a - na) > 0.24) return true;
+  }
+  return false;
+}
+
+function captureDiagnosticField(world, rect, name, fallback = 0) {
+  const width = rectWidth(rect);
+  const height = rectHeight(rect);
+  const source = world.fields?.[name];
+  const Constructor = source?.constructor || Float32Array;
+  const data = new Constructor(width * height);
+  if (fallback !== 0 && typeof data.fill === "function") data.fill(fallback);
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const wi = worldIndexOf(world, x, y);
+      if (wi >= 0 && source) data[(y - rect.y0) * width + (x - rect.x0)] = source[wi];
+    }
+  }
+  return data;
+}
+
+function sampleDiagnosticPathCells(world, path, rect, out = null) {
+  const cells = out || [];
+  if (!Array.isArray(path) || path.length < 2) return cells;
+  let previousKey = null;
+  for (let k = 0; k < path.length - 1; k++) {
+    const ax = tupleWorldX(world, path[k]);
+    const ay = tupleWorldY(world, path[k]);
+    const bx = tupleWorldX(world, path[k + 1]);
+    const by = tupleWorldY(world, path[k + 1]);
+    const steps = Math.max(1, Math.ceil(Math.max(Math.abs(bx - ax), Math.abs(by - ay)) * 2));
+    for (let t = 0; t <= steps; t++) {
+      const x = Math.round(lerp(ax, bx, t / steps));
+      const y = Math.round(lerp(ay, by, t / steps));
+      if (!insideRect(x, y, rect)) continue;
+      const key = diagnosticCellKey(x, y);
+      if (key === previousKey) continue;
+      cells.push({ x, y, key });
+      previousKey = key;
+    }
+  }
+  return cells;
+}
+
+function rasterizeDiagnosticPaths(world, sourceMap, keys, rect) {
+  const occupied = new Set();
+  for (const key of keys) {
+    for (const path of sourceMap?.[key] || []) {
+      const cells = sampleDiagnosticPathCells(world, path, rect);
+      for (const cell of cells) occupied.add(cell.key);
+    }
+  }
+  return occupied;
+}
+
+function diagnosticPatchSide(x, y, rects, seed = 0) {
+  const a = patchAlpha(x, y, rects, seed);
+  if (a <= 0.18) return -1;
+  if (a >= 0.34) return 1;
+  return 0;
+}
+
+function transportPortalLayerPriority(key = "") {
+  if (key === "expressways" || key === "externalExpressways") return 7;
+  if (key === "nationalRoads" || key === "railways" || key === "externalRailways") return 6;
+  if (key === "ringRoads" || key === "ringRailways") return 5;
+  if (key === "branchRailways" || key === "externalRoads") return 4;
+  if (key === "minorRoads" || key === "icAccessRoads") return 3;
+  return 2;
+}
+
+function collectDiagnosticTransportPortals(world, sourceMap, keys, rects, seed = 0) {
+  const byBucket = new Map();
+  for (const key of keys) {
+    for (const path of sourceMap?.[key] || []) {
+      const cells = sampleDiagnosticPathCells(world, path, expandRect(rects.writeRect, 12, world));
+      let lastTagged = null;
+      for (let index = 0; index < cells.length; index++) {
+        const cell = cells[index];
+        const side = diagnosticPatchSide(cell.x, cell.y, rects, seed);
+        if (!side) continue;
+        const tagged = { cell, side, index };
+        if (lastTagged && side !== lastTagged.side) {
+          const outsideTagged = side < 0 ? tagged : lastTagged;
+          const insideTagged = side > 0 ? tagged : lastTagged;
+          const outside = { x: outsideTagged.cell.x, y: outsideTagged.cell.y };
+          const inside = { x: insideTagged.cell.x, y: insideTagged.cell.y };
+          if (rects?.patchMode === PATCH_MODE_EXPANSION) {
+            // Expansion transport continuity is a contract at the real
+            // established/new frontier, not at the synthetic outer edge of the
+            // write/blend band. A pre-existing road wholly inside already
+            // generated geography may cross that implementation band and was
+            // previously misclassified as a mandatory portal, causing large
+            // overlapping selections to roll back with road-portal-broken.
+            const outsideGenerated = wasGeneratedAt(rects, outside.x, outside.y);
+            const insideGenerated = wasGeneratedAt(rects, inside.x, inside.y);
+            if (outsideGenerated === insideGenerated) {
+              lastTagged = tagged;
+              continue;
+            }
+          }
+          let dx = inside.x - outside.x;
+          let dy = inside.y - outside.y;
+          const length = Math.hypot(dx, dy) || 1;
+          dx /= length;
+          dy /= length;
+          const x = Math.round((outside.x + inside.x) * 0.5);
+          const y = Math.round((outside.y + inside.y) * 0.5);
+          const bucket = `${Math.round(x / 3)},${Math.round(y / 3)}`;
+          const inwardStep = insideTagged.index >= outsideTagged.index ? 1 : -1;
+          const legacyGuide = [];
+          for (let gi = insideTagged.index, count = 0; gi >= 0 && gi < cells.length && count < 28; gi += inwardStep) {
+            const guideCell = cells[gi];
+            if (diagnosticPatchSide(guideCell.x, guideCell.y, rects, seed) !== 1) {
+              if (count > 0) break;
+              continue;
+            }
+            legacyGuide.push([guideCell.x, guideCell.y]);
+            count++;
+          }
+          const portal = {
+            id: `${key}:${bucket}`,
+            x,
+            y,
+            layer: key,
+            outside,
+            inside,
+            direction: { x: dx, y: dy },
+            legacyGuide,
+            priority: transportPortalLayerPriority(key),
+          };
+          const previous = byBucket.get(bucket);
+          if (!previous || portal.priority > previous.priority) byBucket.set(bucket, portal);
+        }
+        lastTagged = tagged;
+      }
+    }
+  }
+  return [...byBucket.values()].sort((a, b) => a.y - b.y || a.x - b.x);
+}
+
+function diagnosticOccupiedNear(occupied, portal, rects, seed, wantedSide, radius = 7) {
+  const out = [];
+  for (let y = Math.floor(portal.y - radius); y <= Math.ceil(portal.y + radius); y++) {
+    for (let x = Math.floor(portal.x - radius); x <= Math.ceil(portal.x + radius); x++) {
+      if (Math.hypot(x - portal.x, y - portal.y) > radius) continue;
+      const key = diagnosticCellKey(x, y);
+      if (!occupied.has(key) || diagnosticPatchSide(x, y, rects, seed) !== wantedSide) continue;
+      out.push(key);
+    }
+  }
+  return out;
+}
+
+function diagnosticPortalConnected(occupied, portal, rects, seed = 0) {
+  const starts = diagnosticOccupiedNear(occupied, portal, rects, seed, -1, 8);
+  const targets = new Set(diagnosticOccupiedNear(occupied, portal, rects, seed, 1, 9));
+  if (!starts.length || !targets.size) return false;
+  const radius = 13;
+  const queue = [...starts];
+  const seen = new Set(starts);
+  const dirs = [[1, 0], [-1, 0], [0, 1], [0, -1], [1, 1], [1, -1], [-1, 1], [-1, -1]];
+  for (let q = 0; q < queue.length; q++) {
+    const key = queue[q];
+    if (targets.has(key)) return true;
+    const { x, y } = diagnosticCellFromKey(key);
+    for (const [dx, dy] of dirs) {
+      const nx = x + dx;
+      const ny = y + dy;
+      if (Math.hypot(nx - portal.x, ny - portal.y) > radius) continue;
+      const nk = diagnosticCellKey(nx, ny);
+      if (!occupied.has(nk) || seen.has(nk)) continue;
+      seen.add(nk);
+      queue.push(nk);
+    }
+  }
+  return false;
+}
+
+function capturePatchSeamSnapshot(world, sourceMap, rects, seed = 0, transportSourceMap = null) {
+  const rect = expandRect(rects.writeRect, 4, world);
+  const width = rectWidth(rect);
+  const height = rectHeight(rect);
+  const alpha = new Float32Array(width * height);
+  const seamMask = new Uint8Array(width * height);
+  const generatedMask = new Uint8Array(width * height);
+  let seamBandCells = 0;
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const li = (y - rect.y0) * width + (x - rect.x0);
+      alpha[li] = patchAlpha(x, y, rects, seed);
+      generatedMask[li] = wasGeneratedAt(rects, x, y) ? 1 : 0;
+      if (isSeamDiagnosticLocation(x, y, rects, seed)) {
+        seamMask[li] = 1;
+        seamBandCells++;
+      }
+    }
+  }
+  return {
+    rect,
+    width,
+    height,
+    alpha,
+    seamMask,
+    generatedMask,
+    seamBandCells,
+    fields: {
+      sea: captureDiagnosticField(world, rect, "sea", 1),
+      elevation: captureDiagnosticField(world, rect, "elevation", 0.08),
+      adminId: captureDiagnosticField(world, rect, "adminId", -1),
+      prefectureRegionId: captureDiagnosticField(world, rect, "prefectureRegionId", -1),
+    },
+    // For a tiled large expansion, only roads/rails that existed before the
+    // whole user operation are contractual portals. Paths created by an earlier
+    // internal tile may be rerouted by the next tile and must not become a new
+    // hard-fail seam obligation. Terrain/admin snapshots still use current world.
+    roadOccupied: rasterizeDiagnosticPaths(world, transportSourceMap || sourceMap, SEAM_DIAGNOSTIC_ROAD_KEYS, rect),
+    railOccupied: rasterizeDiagnosticPaths(world, transportSourceMap || sourceMap, SEAM_DIAGNOSTIC_RAIL_KEYS, rect),
+    roadPortals: collectDiagnosticTransportPortals(world, transportSourceMap || sourceMap, SEAM_DIAGNOSTIC_ROAD_KEYS, rects, seed),
+    railPortals: collectDiagnosticTransportPortals(world, transportSourceMap || sourceMap, SEAM_DIAGNOSTIC_RAIL_KEYS, rects, seed),
+  };
+}
+
+function sourceDiagnosticPoint(world, x, y, kind, severity, label) {
+  return {
+    x: x - (world.originX || 0),
+    y: y - (world.originY || 0),
+    worldX: x,
+    worldY: y,
+    kind,
+    severity,
+    label,
+  };
+}
+
+function diagnosticOutlinePath(world, rects) {
+  const points = rects.selectionShape?.polygon?.length >= 3
+    ? rects.selectionShape.polygon.map((p) => [p.x, p.y])
+    : [
+        [rects.writeRect.x0, rects.writeRect.y0],
+        [rects.writeRect.x1, rects.writeRect.y0],
+        [rects.writeRect.x1, rects.writeRect.y1],
+        [rects.writeRect.x0, rects.writeRect.y1],
+      ];
+  if (points.length && (points[0][0] !== points[points.length - 1][0] || points[0][1] !== points[points.length - 1][1])) points.push([...points[0]]);
+  return points.map(([x, y]) => [x - (world.originX || 0), y - (world.originY || 0)]);
+}
+
+function segmentDiagnosticWorldMidpoint(world, seg) {
+  return {
+    x: (tupleWorldX(world, seg?.[0]) + tupleWorldX(world, seg?.[1])) * 0.5,
+    y: (tupleWorldY(world, seg?.[0]) + tupleWorldY(world, seg?.[1])) * 0.5,
+  };
+}
+
+function collectSeamDiagnosticSegments(world, segments, rects, seed = 0, layer = "boundary") {
+  const out = [];
+  for (const seg of segments || []) {
+    if (!Array.isArray(seg) || seg.length < 2) continue;
+    const midpoint = segmentDiagnosticWorldMidpoint(world, seg);
+    if (!isSeamDiagnosticLocation(midpoint.x, midpoint.y, rects, seed)) continue;
+    out.push({ seg, midpoint, layer, key: quantizedSegmentKey(seg), orientation: segmentOrientation(seg) });
+  }
+  return out;
+}
+
+function diagnosticParallelSeparation(a, b) {
+  const am = segmentMidpoint(a.seg);
+  const bm = segmentMidpoint(b.seg);
+  const as = a.seg;
+  const bs = b.seg;
+  return Math.min(
+    pointToSegmentDistance2(am.x, am.y, bs[0][0], bs[0][1], bs[1][0], bs[1][1]),
+    pointToSegmentDistance2(bm.x, bm.y, as[0][0], as[0][1], as[1][0], as[1][1])
+  );
+}
+
+function segmentsShareDiagnosticEndpoint(a, b, epsilon = 0.05) {
+  for (const pa of a?.seg || []) {
+    for (const pb of b?.seg || []) {
+      if (Math.hypot((pa?.[0] || 0) - (pb?.[0] || 0), (pa?.[1] || 0) - (pb?.[1] || 0)) <= epsilon) return true;
+    }
+  }
+  return false;
+}
+
+function diagnosticParallelOverlap(a, b) {
+  const segA = a?.seg;
+  const segB = b?.seg;
+  if (!segA || !segB) return 0;
+  const dx = (segA[1]?.[0] || 0) - (segA[0]?.[0] || 0);
+  const dy = (segA[1]?.[1] || 0) - (segA[0]?.[1] || 0);
+  const len = Math.hypot(dx, dy);
+  if (len <= 1e-6) return 0;
+  const ux = dx / len;
+  const uy = dy / len;
+  const project = (p) => (p?.[0] || 0) * ux + (p?.[1] || 0) * uy;
+  const a0 = project(segA[0]), a1 = project(segA[1]);
+  const b0 = project(segB[0]), b1 = project(segB[1]);
+  return Math.max(0, Math.min(Math.max(a0, a1), Math.max(b0, b1)) - Math.max(Math.min(a0, a1), Math.min(b0, b1)));
+}
+
+function findDiagnosticDuplicatePairs(itemsA, itemsB = null, tolerance = 2.15) {
+  const same = !itemsB;
+  const right = itemsB || itemsA;
+  const pairs = [];
+  const seen = new Set();
+  const bucketSize = Math.max(2.5, tolerance * 1.5);
+  const buckets = new Map();
+  for (let j = 0; j < right.length; j++) {
+    const item = right[j];
+    const bx = Math.floor(item.midpoint.x / bucketSize);
+    const by = Math.floor(item.midpoint.y / bucketSize);
+    const key = `${bx},${by}`;
+    const arr = buckets.get(key) || [];
+    arr.push({ item, index: j });
+    buckets.set(key, arr);
+  }
+  for (let i = 0; i < itemsA.length; i++) {
+    const a = itemsA[i];
+    const bx = Math.floor(a.midpoint.x / bucketSize);
+    const by = Math.floor(a.midpoint.y / bucketSize);
+    for (let oy = -1; oy <= 1; oy++) {
+      for (let ox = -1; ox <= 1; ox++) {
+        for (const entry of buckets.get(`${bx + ox},${by + oy}`) || []) {
+          if (same && entry.index <= i) continue;
+          const b = entry.item;
+          const exactSame = !!a.key && a.key === b.key;
+          if (same && exactSame) continue;
+          if (same && segmentsShareDiagnosticEndpoint(a, b)) continue;
+          if (circularAngleDistance(a.orientation, b.orientation) > 0.24) continue;
+          const overlap = diagnosticParallelOverlap(a, b);
+          const minLength = Math.min(pathLength(a.seg), pathLength(b.seg));
+          if (!exactSame && overlap < Math.max(0.45, minLength * 0.55)) continue;
+          const separation = exactSame ? 0 : diagnosticParallelSeparation(a, b);
+          if (separation > tolerance) continue;
+          const midDistance = Math.hypot(a.midpoint.x - b.midpoint.x, a.midpoint.y - b.midpoint.y);
+          if (!exactSame && midDistance > Math.max(1.4, tolerance * 1.8)) continue;
+          const pairKey = `${a.layer}:${i}|${b.layer}:${entry.index}`;
+          if (seen.has(pairKey)) continue;
+          seen.add(pairKey);
+          pairs.push({
+            x: (a.midpoint.x + b.midpoint.x) * 0.5,
+            y: (a.midpoint.y + b.midpoint.y) * 0.5,
+            separation,
+            layers: `${a.layer}/${b.layer}`,
+          });
+        }
+      }
+    }
+  }
+  return pairs;
+}
+
+function analyzePatchSeam(world, sourceMap, rects, seed, snapshot, candidateWindow, patchGenerationMode, includeVisualization = false) {
+  if (!snapshot) return null;
+  const issuePoints = includeVisualization ? [] : null;
+  const issueCounts = new Map();
+  const issueCaps = {
+    "transport-coast-conflict": 70,
+    "land-to-sea": 55,
+    "sea-to-land": 28,
+    "admin-seam-break": 55,
+    "prefecture-seam-break": 70,
+    "elevation-cliff": 45,
+    "duplicate-boundary": 70,
+    "road-portal-connected": 80,
+    "road-portal-broken": 80,
+    "rail-portal-connected": 80,
+    "rail-portal-broken": 80,
+  };
+  const addIssue = (x, y, kind, severity, label) => {
+    if (!issuePoints) return;
+    const count = issueCounts.get(kind) || 0;
+    if (count >= (issueCaps[kind] || 40)) return;
+    issueCounts.set(kind, count + 1);
+    issuePoints.push(sourceDiagnosticPoint(world, x, y, kind, severity, label));
+  };
+  const rect = snapshot.rect;
+  const width = snapshot.width;
+  let seaFlipCells = 0;
+  let landToSeaCells = 0;
+  let seaToLandCells = 0;
+  let transportLandToSeaConflicts = 0;
+  let adminSeamBreakEdges = 0;
+  let prefectureSeamBreakEdges = 0;
+  let elevationCliffEdges = 0;
+  let maxElevationJump = 0;
+  let maxElevationJumpIncrease = 0;
+  let maxEstablishedFrontierElevationJump = 0;
+  let establishedFrontierElevationEdges = 0;
+  let elevationJumpSum = 0;
+  let elevationJumpSamples = 0;
+  const newSea = world.fields?.sea;
+  const newElevation = world.fields?.elevation;
+  const newAdmin = world.fields?.adminId;
+  const newPref = world.fields?.prefectureRegionId;
+  const oldSea = snapshot.fields.sea;
+  const oldElevation = snapshot.fields.elevation;
+  const oldAdmin = snapshot.fields.adminId;
+  const oldPref = snapshot.fields.prefectureRegionId;
+
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const li = (y - rect.y0) * width + (x - rect.x0);
+      if (!snapshot.seamMask[li]) continue;
+      const wi = worldIndexOf(world, x, y);
+      if (wi < 0) continue;
+      const wasSea = !!oldSea[li];
+      const isSeaNow = !!newSea?.[wi];
+      if (snapshot.generatedMask?.[li] && wasSea !== isSeaNow) {
+        seaFlipCells++;
+        if (!wasSea && isSeaNow) {
+          landToSeaCells++;
+          const transportConflict = snapshot.roadOccupied.has(diagnosticCellKey(x, y)) || snapshot.railOccupied.has(diagnosticCellKey(x, y));
+          if (transportConflict) transportLandToSeaConflicts++;
+          addIssue(x, y, transportConflict ? "transport-coast-conflict" : "land-to-sea", transportConflict ? "error" : "warning", transportConflict ? "Existing transport cell changed to sea" : "Land changed to sea in seam band");
+        } else {
+          seaToLandCells++;
+          addIssue(x, y, "sea-to-land", "info", "Sea changed to land in seam band");
+        }
+      }
+
+      for (const [dx, dy] of [[1, 0], [0, 1]]) {
+        const nx = x + dx;
+        const ny = y + dy;
+        if (!insideRect(nx, ny, rect)) continue;
+        const nli = (ny - rect.y0) * width + (nx - rect.x0);
+        const nwi = worldIndexOf(world, nx, ny);
+        if (nwi < 0) continue;
+        const seamEdge = snapshot.seamMask[li] || snapshot.seamMask[nli];
+        if (!seamEdge) continue;
+        const bothGenerated = !!snapshot.generatedMask?.[li] && !!snapshot.generatedMask?.[nli];
+        if (bothGenerated && oldAdmin[li] >= 0 && oldAdmin[li] === oldAdmin[nli] && newAdmin?.[wi] >= 0 && newAdmin?.[nwi] >= 0 && newAdmin[wi] !== newAdmin[nwi]) {
+          adminSeamBreakEdges++;
+          addIssue(x + dx * 0.5, y + dy * 0.5, "admin-seam-break", "warning", "New municipal boundary inside the seam band");
+        }
+        if (bothGenerated && oldPref[li] >= 0 && oldPref[li] === oldPref[nli] && newPref?.[wi] >= 0 && newPref?.[nwi] >= 0 && newPref[wi] !== newPref[nwi]) {
+          prefectureSeamBreakEdges++;
+          addIssue(x + dx * 0.5, y + dy * 0.5, "prefecture-seam-break", "error", "New prefecture boundary inside the seam band");
+        }
+        const a0 = patchAlpha(x, y, rects, seed);
+        const a1 = patchAlpha(nx, ny, rects, seed);
+        const generatedTransition = !!snapshot.generatedMask?.[li] !== !!snapshot.generatedMask?.[nli];
+        const footprintTransition = patchCellOwned(rects, x, y, seed) !== patchCellOwned(rects, nx, ny, seed);
+        const selectedTransition = insideSelectedCore(rects, x, y) !== insideSelectedCore(rects, nx, ny);
+        const alphaTransition = Math.abs(a0 - a1) >= 0.10;
+        const elevationSeamEdge = generatedTransition || footprintTransition || selectedTransition || alphaTransition;
+        if (elevationSeamEdge) {
+          const jump = Math.abs((newElevation?.[wi] || 0) - (newElevation?.[nwi] || 0));
+          const oldJump = Math.abs((oldElevation?.[li] || 0) - (oldElevation?.[nli] || 0));
+          if (generatedTransition && !newSea?.[wi] && !newSea?.[nwi]) {
+            establishedFrontierElevationEdges++;
+            maxEstablishedFrontierElevationJump = Math.max(maxEstablishedFrontierElevationJump, jump);
+          }
+          const jumpIncrease = Math.max(0, jump - oldJump);
+          maxElevationJump = Math.max(maxElevationJump, jump);
+          maxElevationJumpIncrease = Math.max(maxElevationJumpIncrease, jumpIncrease);
+          elevationJumpSum += jump;
+          elevationJumpSamples++;
+          // Do not reject natural cliffs wholly inside the candidate.  At an
+          // actual ownership/frontier transition, reject only newly created or
+          // materially worsened discontinuities.
+          if (jump > 0.16 && (oldJump <= 0.16 || jumpIncrease > 0.045)) {
+            elevationCliffEdges++;
+            addIssue(x + dx * 0.5, y + dy * 0.5, "elevation-cliff", "warning", `Elevation jump ${jump.toFixed(3)} (+${jumpIncrease.toFixed(3)})`);
+          }
+        }
+      }
+    }
+  }
+
+  const roadOccupiedAfter = rasterizeDiagnosticPaths(world, sourceMap, SEAM_DIAGNOSTIC_ROAD_KEYS, rect);
+  const railOccupiedAfter = rasterizeDiagnosticPaths(world, sourceMap, SEAM_DIAGNOSTIC_RAIL_KEYS, rect);
+  const roadPortalResults = snapshot.roadPortals.map((portal) => ({ ...portal, connected: diagnosticPortalConnected(roadOccupiedAfter, portal, rects, seed) }));
+  const railPortalResults = snapshot.railPortals.map((portal) => ({ ...portal, connected: diagnosticPortalConnected(railOccupiedAfter, portal, rects, seed) }));
+  for (const portal of roadPortalResults) addIssue(portal.x, portal.y, portal.connected ? "road-portal-connected" : "road-portal-broken", portal.connected ? "info" : "error", portal.connected ? "Existing road crossing retained" : "Existing road crossing is disconnected");
+  for (const portal of railPortalResults) addIssue(portal.x, portal.y, portal.connected ? "rail-portal-connected" : "rail-portal-broken", portal.connected ? "info" : "error", portal.connected ? "Existing rail crossing retained" : "Existing rail crossing is disconnected");
+
+  const adminSegments = collectSeamDiagnosticSegments(world, sourceMap.adminBorders, rects, seed, "municipal");
+  const prefectureSegments = collectSeamDiagnosticSegments(world, sourceMap.regionalPrefectureBorders, rects, seed, "prefecture");
+  const duplicateAdminPairs = findDiagnosticDuplicatePairs(adminSegments, null, 0.78);
+  const duplicatePrefecturePairs = findDiagnosticDuplicatePairs(prefectureSegments, null, 0.78);
+  const overlappingAdminPrefecturePairs = findDiagnosticDuplicatePairs(adminSegments, prefectureSegments, 0.45);
+  for (const pair of [...duplicateAdminPairs, ...duplicatePrefecturePairs, ...overlappingAdminPrefecturePairs].slice(0, 70)) {
+    addIssue(pair.x, pair.y, "duplicate-boundary", "warning", `Near-parallel boundary pair (${pair.layers}, ${pair.separation.toFixed(2)} cells)`);
+  }
+
+  const roadBroken = roadPortalResults.filter((p) => !p.connected).length;
+  const railBroken = railPortalResults.filter((p) => !p.connected).length;
+  const duplicateBoundaryPairs = duplicateAdminPairs.length + duplicatePrefecturePairs.length + overlappingAdminPrefecturePairs.length;
+  const criticalCount = roadBroken + railBroken + prefectureSeamBreakEdges + transportLandToSeaConflicts;
+  // Status should describe an actual seam defect, not every legitimate cliff
+  // found somewhere inside the diagnostic band. Keep cliff counts for advanced
+  // diagnostics, but only surface them as a seam warning when density is high or
+  // the literal established/new frontier exceeds the continuity limit.
+  const statusElevationBudget = Math.max(18, Math.floor((snapshot.seamBandCells || 0) * 0.018));
+  const elevationSeamWarning = elevationCliffEdges > statusElevationBudget || maxEstablishedFrontierElevationJump > 0.075 ? 1 : 0;
+  const warningCount = landToSeaCells + adminSeamBreakEdges + duplicateBoundaryPairs + elevationSeamWarning;
+  const status = criticalCount > 0 ? "critical" : warningCount > 0 ? "warning" : "clean";
+
+  const severityRank = { error: 0, warning: 1, info: 2 };
+  const visibleIssuePoints = issuePoints
+    ? issuePoints.sort((a, b) => (severityRank[a.severity] ?? 3) - (severityRank[b.severity] ?? 3)).slice(0, SEAM_DIAGNOSTIC_MAX_MARKERS)
+    : [];
+
+  return {
+    version: 1,
+    enabled: true,
+    status,
+    coordinateSpace: "source-map",
+    patchMode: rects?.patchMode || PATCH_MODE_REGENERATION,
+    patchModeRequested: rects?.patchModeRequested || PATCH_MODE_AUTO,
+    patchModeAutoDetected: !!rects?.patchModeAutoDetected,
+    ungeneratedSelectionRatio: rects?.coverageStats?.ungeneratedRatio || 0,
+    worldSeaLevel: Number.isFinite(world?.seaLevel) ? world.seaLevel : sourceMap?.seaLevel,
+    expansionOverlap: rects?.expansionOverlap || 0,
+    patchGenerationMode,
+    candidateWidth: Math.max(1, Math.floor(candidateWindow?.width || MAP_W)),
+    candidateHeight: Math.max(1, Math.floor(candidateWindow?.height || MAP_H)),
+    candidateAreaRatio: candidateWindow?.areaRatio ?? 1,
+    seamBandCells: snapshot.seamBandCells,
+    seaFlipCells,
+    landToSeaCells,
+    seaToLandCells,
+    transportLandToSeaConflicts,
+    roadPortalsBefore: roadPortalResults.length,
+    roadPortalsConnected: roadPortalResults.length - roadBroken,
+    roadPortalsBroken: roadBroken,
+    railPortalsBefore: railPortalResults.length,
+    railPortalsConnected: railPortalResults.length - railBroken,
+    railPortalsBroken: railBroken,
+    adminSeamBreakEdges,
+    prefectureSeamBreakEdges,
+    duplicateAdminBoundaryPairs: duplicateAdminPairs.length,
+    duplicatePrefectureBoundaryPairs: duplicatePrefecturePairs.length,
+    overlappingAdminPrefecturePairs: overlappingAdminPrefecturePairs.length,
+    duplicateBoundaryPairs,
+    elevationCliffEdges,
+    maxElevationJump: Math.round(maxElevationJump * 10000) / 10000,
+    maxElevationJumpIncrease: Math.round(maxElevationJumpIncrease * 10000) / 10000,
+    maxEstablishedFrontierElevationJump: Math.round(maxEstablishedFrontierElevationJump * 10000) / 10000,
+    establishedFrontierElevationEdges,
+    meanElevationJump: Math.round((elevationJumpSum / Math.max(1, elevationJumpSamples)) * 10000) / 10000,
+    criticalCount,
+    warningCount,
+    markerCount: visibleIssuePoints.length,
+    issuePoints: visibleIssuePoints,
+    outlinePaths: includeVisualization ? [diagnosticOutlinePath(world, rects)] : [],
+  };
+}
+
+function evaluateSeamQualityGate(diagnostics) {
+  if (!diagnostics) return { hardPass: true, reasons: [], budgets: {} };
+  const seamCells = Math.max(1, diagnostics.seamBandCells || 0);
+  const budgets = {
+    adminSeamBreakEdges: Math.max(4, Math.floor(seamCells * 0.004)),
+    elevationCliffEdges: Math.max(18, Math.floor(seamCells * 0.018)),
+    maxElevationJumpIncrease: 0.14,
+    maxEstablishedFrontierElevationJump: 0.075,
+    duplicateBoundaryPairs: 0,
+    expansionFootprintEscapedCells: 0,
+  };
+  const reasons = [];
+  if ((diagnostics.roadPortalsBroken || 0) > 0) reasons.push("road-portal-broken");
+  if ((diagnostics.railPortalsBroken || 0) > 0) reasons.push("rail-portal-broken");
+  if ((diagnostics.prefectureSeamBreakEdges || 0) > 0) reasons.push("prefecture-seam-break");
+  if ((diagnostics.transportLandToSeaConflicts || 0) > 0) reasons.push("transport-land-to-sea");
+  if ((diagnostics.landToSeaCells || 0) > 0) reasons.push("existing-land-to-sea");
+  if ((diagnostics.duplicateBoundaryPairs || 0) > budgets.duplicateBoundaryPairs) reasons.push("duplicate-boundary");
+  if ((diagnostics.adminSeamBreakEdges || 0) > budgets.adminSeamBreakEdges) reasons.push("municipal-seam-break-density");
+  if ((diagnostics.elevationCliffEdges || 0) > budgets.elevationCliffEdges) reasons.push("elevation-cliff-density");
+  // A single large cliff can be legitimate terrain wholly inside the new
+  // candidate. Treat it as a seam failure only when cliff density is already
+  // excessive; the literal established/new frontier has its own stricter gate
+  // below and therefore cannot be hidden by this relaxation.
+  if ((diagnostics.elevationCliffEdges || 0) > budgets.elevationCliffEdges
+    && (diagnostics.maxElevationJumpIncrease || 0) > budgets.maxElevationJumpIncrease) reasons.push("elevation-jump-increase");
+  if ((diagnostics.establishedFrontierElevationEdges || 0) > 0
+    && (diagnostics.maxEstablishedFrontierElevationJump || 0) > budgets.maxEstablishedFrontierElevationJump) reasons.push("established-frontier-elevation-jump");
+  if ((diagnostics.expansionFootprintEscapedCells || 0) > budgets.expansionFootprintEscapedCells) reasons.push("generated-footprint-write-escape");
+  return { hardPass: reasons.length === 0, reasons, budgets };
+}
+
+function terrainLabel(candidate, fallback) {
+  return candidate?.terrainTemplate?.terrainTypeLabel || candidate?.terrainDebug?.terrainTypeLabel || fallback;
+}
+
+function terrainId(candidate, fallback) {
+  return candidate?.terrainTemplate?.terrainType || candidate?.terrainDebug?.terrainType || fallback;
+}
+
+function rectKey(rect) {
+  return rect ? `${rect.x0},${rect.y0},${rect.x1},${rect.y1}` : "-";
+}
+
+function terrainQualityPolicy(terrainType = "auto") {
+  switch (String(terrainType || "auto")) {
+    case "oceanic_archipelago":
+      return { targetLand: 0.065, minLand: 0.018, maxLand: 0.30, minDevelopable: 0.08, minLargest: 0.05, frontierFloor: 0.01 };
+    case "setouchi_inland_sea":
+      return { targetLand: 0.48, minLand: 0.22, maxLand: 0.82, minDevelopable: 0.16, minLargest: 0.10, frontierFloor: 0.04 };
+    case "kanto_alluvial":
+      return { targetLand: 0.86, minLand: 0.58, maxLand: 0.995, minDevelopable: 0.30, minLargest: 0.58, frontierFloor: 0.08 };
+    case "chubu_mountain":
+      return { targetLand: 0.94, minLand: 0.70, maxLand: 0.999, minDevelopable: 0.12, minLargest: 0.62, frontierFloor: 0.08 };
+    case "tohoku_spine":
+      return { targetLand: 0.80, minLand: 0.54, maxLand: 0.985, minDevelopable: 0.16, minLargest: 0.46, frontierFloor: 0.07 };
+    case "mixed_archipelago":
+    default:
+      return { targetLand: 0.76, minLand: 0.46, maxLand: 0.985, minDevelopable: 0.16, minLargest: 0.34, frontierFloor: 0.06 };
+  }
+}
+
+function qualityCloseness(value, target, span = 1) {
+  return clamp(1 - Math.abs(value - target) / Math.max(0.001, span));
+}
+
+function candidateTerrainType(candidate, requested = "auto") {
+  return candidate?.terrainTemplate?.terrainType || candidate?.terrainDebug?.terrainType || requested || "auto";
+}
+
+function evaluateExpansionTerrainCandidate(world, terrain, rects, window, seed = 0, attemptVariant = 0) {
+  const scan = rects?.coreRect || rects?.writeRect;
+  const width = rectWidth(scan);
+  const height = rectHeight(scan);
+  const selectedMask = new Uint8Array(Math.max(1, width * height));
+  const landMask = new Uint8Array(selectedMask.length);
+  let selectedCells = 0;
+  let landCells = 0;
+  let developableCells = 0;
+  let coastlineEdges = 0;
+  let oldLandFrontierCells = 0;
+  let candidateLandAtOldFrontier = 0;
+
+  const localIndex = (x, y) => (y - scan.y0) * width + (x - scan.x0);
+  const candidateSeaAtWorld = (x, y) => {
+    const c = sourceCoordForWorld(window, x, y);
+    const i = sourceWindowIndex(window, c.x, c.y);
+    return i < 0 ? 1 : (terrain.sea?.[i] ? 1 : 0);
+  };
+
+  for (let y = scan.y0; y < scan.y1; y++) {
+    for (let x = scan.x0; x < scan.x1; x++) {
+      if (patchAlpha(x, y, rects, seed) < 0.40 || wasGeneratedAt(rects, x, y)) continue;
+      const c = sourceCoordForWorld(window, x, y);
+      const ci = sourceWindowIndex(window, c.x, c.y);
+      if (ci < 0) continue;
+      const li = localIndex(x, y);
+      selectedMask[li] = 1;
+      selectedCells++;
+      const land = !terrain.sea?.[ci];
+      if (land) {
+        landMask[li] = 1;
+        landCells++;
+        const slope = terrain.slope?.[ci] || 0;
+        const plain = terrain.plain?.[ci] || 0;
+        const agriculture = terrain.agriculture?.[ci] || 0;
+        const basin = terrain.basinField?.[ci] || 0;
+        const coast = terrain.coastalLowland?.[ci] || 0;
+        if (slope < 0.48 && (plain > 0.13 || agriculture > 0.13 || basin > 0.17 || coast > 0.15)) developableCells++;
+      }
+
+      let bordersOldLand = false;
+      for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]]) {
+        const nx = x + dx;
+        const ny = y + dy;
+        if (wasGeneratedAt(rects, nx, ny)) {
+          const wi = worldIndexOf(world, nx, ny);
+          if (wi >= 0 && !world.fields.sea?.[wi]) bordersOldLand = true;
+        }
+        if (land && candidateSeaAtWorld(nx, ny)) coastlineEdges++;
+      }
+      if (bordersOldLand) {
+        oldLandFrontierCells++;
+        if (land) candidateLandAtOldFrontier++;
+      }
+    }
+  }
+
+  let largestLandComponent = 0;
+  const seen = new Uint8Array(landMask.length);
+  const queue = new Int32Array(Math.max(1, landMask.length));
+  for (let i = 0; i < landMask.length; i++) {
+    if (!landMask[i] || seen[i]) continue;
+    let head = 0;
+    let tail = 0;
+    queue[tail++] = i;
+    seen[i] = 1;
+    while (head < tail) {
+      const cur = queue[head++];
+      const x = cur % width;
+      const y = Math.floor(cur / width);
+      for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1], [1, 1], [-1, 1], [1, -1], [-1, -1]]) {
+        const nx = x + dx;
+        const ny = y + dy;
+        if (nx < 0 || ny < 0 || nx >= width || ny >= height) continue;
+        const ni = ny * width + nx;
+        if (!landMask[ni] || seen[ni]) continue;
+        seen[ni] = 1;
+        queue[tail++] = ni;
+      }
+    }
+    largestLandComponent = Math.max(largestLandComponent, tail);
+  }
+
+  const terrainType = candidateTerrainType(terrain);
+  const policy = terrainQualityPolicy(terrainType);
+  const landRatio = landCells / Math.max(1, selectedCells);
+  const developableRatio = developableCells / Math.max(1, landCells);
+  const largestComponentRatio = largestLandComponent / Math.max(1, landCells);
+  const frontierLandRate = candidateLandAtOldFrontier / Math.max(1, oldLandFrontierCells);
+  const coastlineComplexity = coastlineEdges / Math.max(1, Math.sqrt(selectedCells));
+  const landFit = qualityCloseness(landRatio, policy.targetLand, Math.max(policy.targetLand - policy.minLand, policy.maxLand - policy.targetLand));
+  const developableFit = clamp(developableRatio / Math.max(0.01, policy.minDevelopable * 1.8));
+  const componentFit = clamp(largestComponentRatio / Math.max(0.01, policy.minLargest * 1.7));
+  const frontierFit = oldLandFrontierCells < 8 ? 1 : clamp(frontierLandRate / Math.max(0.01, policy.frontierFloor * 3.0));
+  const coastFit = terrainType === "chubu_mountain"
+    ? qualityCloseness(coastlineComplexity, 2.0, 4.5)
+    : qualityCloseness(coastlineComplexity, terrainType === "setouchi_inland_sea" ? 7.0 : 4.5, 8.0);
+  const score = clamp(landFit * 0.46 + developableFit * 0.18 + componentFit * 0.18 + frontierFit * 0.12 + coastFit * 0.06);
+  const frontierPass = oldLandFrontierCells < 8 || candidateLandAtOldFrontier >= Math.max(1, Math.floor(oldLandFrontierCells * policy.frontierFloor));
+  const hardPass = selectedCells < 64 || (
+    landRatio >= policy.minLand
+    && landRatio <= policy.maxLand
+    && (landCells < 180 || developableRatio >= policy.minDevelopable)
+    && (landCells < 180 || largestComponentRatio >= policy.minLargest)
+    && frontierPass
+  );
+
+  return {
+    policyVersion: PATCH_QUALITY_POLICY_VERSION,
+    attemptVariant,
+    terrainType,
+    selectedCells,
+    landCells,
+    landRatio,
+    developableCells,
+    developableRatio,
+    largestLandComponent,
+    largestComponentRatio,
+    oldLandFrontierCells,
+    candidateLandAtOldFrontier,
+    frontierLandRate,
+    coastlineEdges,
+    coastlineComplexity,
+    targetLandRatio: policy.targetLand,
+    minLandRatio: policy.minLand,
+    maxLandRatio: policy.maxLand,
+    hardPass,
+    score,
+  };
+}
+
+const PATCH_QUALITY_SETTLEMENT_KEYS = ["villages", "markets", "modernCities", "satelliteCities", "newTowns", "ports"];
+const PATCH_QUALITY_LABEL_KEYS = [...PATCH_QUALITY_SETTLEMENT_KEYS, "adminCenters"];
+
+function initialGenerationQualityReference(world) {
+  const source = world?.sourceMap || {};
+  const sea = source.sea;
+  let landCells = 0;
+  if (sea && typeof sea.length === "number") {
+    for (let i = 0; i < sea.length; i++) if (!sea[i]) landCells++;
+  }
+  landCells = Math.max(1, landCells);
+  const settlements = PATCH_QUALITY_SETTLEMENT_KEYS.reduce((sum, key) => sum + (Array.isArray(source[key]) ? source[key].length : 0), 0);
+  const labels = PATCH_QUALITY_LABEL_KEYS.reduce((sum, key) => sum + (Array.isArray(source[key]) ? source[key].length : 0), 0);
+  const roadLayers = ["premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "expressways", "icAccessRoads"];
+  const railLayers = ["railways", "branchRailways", "ringRailways"];
+  return {
+    landCells,
+    settlements,
+    labels,
+    settlementDensityPer1000: clamp(settlements * 1000 / landCells, 0.65, 8.0),
+    labelDensityPer1000: clamp(labels * 1000 / landCells, 1.2, 12.0),
+    roadPathCount: roadLayers.reduce((sum, key) => sum + (Array.isArray(source[key]) ? source[key].length : 0), 0),
+    railPathCount: railLayers.reduce((sum, key) => sum + (Array.isArray(source[key]) ? source[key].length : 0), 0),
+  };
+}
+
+function candidatePointInsideExpansion(candidatePoint, world, rects, window, seed = 0) {
+  if (!candidatePoint || !Number.isFinite(candidatePoint.x) || !Number.isFinite(candidatePoint.y)) return false;
+  const w = worldCoordForSource(window, candidatePoint.x, candidatePoint.y);
+  const x = Math.round(w.x);
+  const y = Math.round(w.y);
+  // Candidate quality must evaluate the same ownership mask used by the final
+  // merge.  A fixed alpha>=0.42 test under-counted towns and labels along thin
+  // or oblique selected cores even though those cells were authoritative and
+  // would be written by the patch.
+  return insideRect(x, y, rects.writeRect)
+    && patchCellOwned(rects, x, y, seed, PATCH_FEATURE_REPLACE_ALPHA)
+    && !wasGeneratedAt(rects, x, y);
+}
+
+function candidatePathTouchesExpansion(path, rects, window, seed = 0) {
+  if (!Array.isArray(path)) return false;
+  const step = Math.max(1, Math.floor(path.length / 80));
+  for (let i = 0; i < path.length; i += step) {
+    const tuple = path[i];
+    if (!Array.isArray(tuple) || tuple.length < 2) continue;
+    const w = worldCoordForSource(window, tuple[0], tuple[1]);
+    const x = Math.round(w.x);
+    const y = Math.round(w.y);
+    if (insideRect(x, y, rects.writeRect)
+      && patchCellOwned(rects, x, y, seed, PATCH_FEATURE_REPLACE_ALPHA)
+      && !wasGeneratedAt(rects, x, y)) return true;
+  }
+  return false;
+}
+
+function evaluateExpansionHumanCandidate(world, candidate, terrainQuality, rects, window, seed = 0) {
+  const counts = {};
+  for (const key of PATCH_QUALITY_LABEL_KEYS) {
+    counts[key] = (candidate[key] || []).filter((p) => candidatePointInsideExpansion(p, world, rects, window, seed)).length;
+  }
+  const settlementCount = PATCH_QUALITY_SETTLEMENT_KEYS.reduce((sum, key) => sum + (counts[key] || 0), 0);
+  const labelCount = PATCH_QUALITY_LABEL_KEYS.reduce((sum, key) => sum + (counts[key] || 0), 0);
+  const roadKeys = ["premodernRoads", "minorRoads", "nationalRoads", "ringRoads", "expressways", "icAccessRoads"];
+  const railKeys = ["railways", "branchRailways", "ringRailways"];
+  const roadPaths = roadKeys.reduce((sum, key) => sum + (candidate[key] || []).filter((path) => candidatePathTouchesExpansion(path, rects, window, seed)).length, 0);
+  const railPaths = railKeys.reduce((sum, key) => sum + (candidate[key] || []).filter((path) => candidatePathTouchesExpansion(path, rects, window, seed)).length, 0);
+  const landCells = Math.max(1, terrainQuality.landCells || 0);
+  const settlementDensityPer1000 = settlementCount * 1000 / landCells;
+  const labelDensityPer1000 = labelCount * 1000 / landCells;
+  const reference = initialGenerationQualityReference(world);
+  const oceanic = terrainQuality.terrainType === "oceanic_archipelago";
+  const densityFactor = oceanic ? 0.26 : terrainQuality.terrainType === "setouchi_inland_sea" ? 0.42 : 0.50;
+  const targetSettlementDensity = reference.settlementDensityPer1000 * densityFactor;
+  const targetLabelDensity = reference.labelDensityPer1000 * densityFactor;
+  const minSettlements = landCells < 180 ? 0 : Math.max(2, Math.floor(landCells * targetSettlementDensity / 1000));
+  const minLabels = landCells < 180 ? 0 : Math.max(3, Math.floor(landCells * targetLabelDensity / 1000));
+  const minAdminCenters = landCells < 450 ? 0 : Math.max(1, Math.floor(landCells / (oceanic ? 5200 : 3600)));
+  const transportRequired = landCells >= (oceanic ? 1500 : 700);
+  const settlementFit = clamp(settlementDensityPer1000 / Math.max(0.15, targetSettlementDensity * 1.35));
+  const labelFit = clamp(labelDensityPer1000 / Math.max(0.25, targetLabelDensity * 1.35));
+  const adminFit = minAdminCenters <= 0 ? 1 : clamp((counts.adminCenters || 0) / Math.max(1, minAdminCenters));
+  const transportFit = transportRequired ? clamp((roadPaths + railPaths * 0.7) / 3) : 1;
+  const score = clamp(settlementFit * 0.38 + labelFit * 0.34 + adminFit * 0.16 + transportFit * 0.12);
+  const hardPass = terrainQuality.hardPass
+    && settlementCount >= minSettlements
+    && labelCount >= minLabels
+    && (counts.adminCenters || 0) >= minAdminCenters
+    && (!transportRequired || roadPaths > 0);
+  return {
+    policyVersion: PATCH_QUALITY_POLICY_VERSION,
+    terrainType: terrainQuality.terrainType,
+    landCells,
+    counts,
+    settlementCount,
+    labelCount,
+    roadPaths,
+    railPaths,
+    settlementDensityPer1000,
+    labelDensityPer1000,
+    referenceSettlementDensityPer1000: reference.settlementDensityPer1000,
+    referenceLabelDensityPer1000: reference.labelDensityPer1000,
+    targetSettlementDensityPer1000: targetSettlementDensity,
+    targetLabelDensityPer1000: targetLabelDensity,
+    minSettlements,
+    minLabels,
+    minAdminCenters,
+    hardPass,
+    score,
+  };
+}
+
+function qualityAttemptVariants(baseVariant = 0, requestedAttempts = PATCH_TERRAIN_QUALITY_ATTEMPTS) {
+  const attempts = Math.max(1, Math.min(PATCH_TERRAIN_QUALITY_ATTEMPTS, Math.floor(Number(requestedAttempts) || PATCH_TERRAIN_QUALITY_ATTEMPTS)));
+  const variants = [];
+  for (let attempt = 0; attempt < attempts; attempt++) variants.push((baseVariant + attempt) >>> 0);
+  return variants;
+}
+
+function summarizeTerrainQuality(item) {
+  const q = item.terrainQuality;
+  return {
+    attempt: item.attempt,
+    variant: item.variant,
+    terrainType: q.terrainType,
+    score: Math.round(q.score * 1000) / 1000,
+    hardPass: q.hardPass,
+    landRatio: Math.round(q.landRatio * 10000) / 10000,
+    developableRatio: Math.round(q.developableRatio * 10000) / 10000,
+    largestComponentRatio: Math.round(q.largestComponentRatio * 10000) / 10000,
+    frontierLandRate: Math.round(q.frontierLandRate * 10000) / 10000,
+  };
+}
+
+function summarizeFullQuality(item) {
+  const h = item.humanQuality;
+  return {
+    attempt: item.attempt,
+    variant: item.variant,
+    score: Math.round(item.combinedScore * 1000) / 1000,
+    hardPass: h.hardPass,
+    settlementCount: h.settlementCount,
+    labelCount: h.labelCount,
+    adminCenters: h.counts.adminCenters || 0,
+    roadPaths: h.roadPaths,
+    railPaths: h.railPaths,
+    settlementDensityPer1000: Math.round(h.settlementDensityPer1000 * 1000) / 1000,
+    labelDensityPer1000: Math.round(h.labelDensityPer1000 * 1000) / 1000,
+  };
+}
+
+function generateUnifiedWorldNativePatchCandidate(seed, options = {}) {
+  const world = options.boundaryWorld;
+  const rects = options.qualityRects;
+  const window = options.window;
+  const requestedAttempts = Math.max(1, Math.min(
+    PATCH_TERRAIN_QUALITY_ATTEMPTS,
+    Math.floor(Number(options.qualityTerrainAttempts) || 1),
+  ));
+  const expansion = options.patchMode === PATCH_MODE_EXPANSION && world && rects && window;
+  const attempts = [];
+
+  for (const [attempt, attemptVariant] of qualityAttemptVariants(options.variant || 0, requestedAttempts).entries()) {
+    options.onProgress?.({ status: "start", key: `candidate-attempt-${attempt}`, label: `World-native candidate ${attempt + 1}` });
+    const candidate = generateMap(seed, {
+      ...options,
+      variant: attemptVariant,
+      worldNative: true,
+      stableWorldTerrain: true,
+      legacyTerrain: false,
+      terrainOverride: undefined,
+      stableTerrainSeed: Number.isFinite(options.stableTerrainSeed) ? options.stableTerrainSeed : seed,
+      suppressExternalGateways: expansion,
+      topCenterSuppression: Number.isFinite(options.topCenterSuppression)
+        ? options.topCenterSuppression
+        : expansion ? 0.34 : 0.72,
+      onProgress: (event) => options.onProgress?.({
+        ...event,
+        key: `candidate-attempt-${attempt}:${event?.key || "generation"}`,
+        label: `World-native candidate ${attempt + 1}: ${event?.label || "generation"}`,
+      }),
+    });
+    options.onProgress?.({ status: "done", key: `candidate-attempt-${attempt}`, label: `World-native candidate ${attempt + 1} ready` });
+
+    if (!expansion) {
+      candidate.patchQuality = {
+        policyVersion: PATCH_QUALITY_POLICY_VERSION,
+        unifiedGenerator: true,
+        generator: "unified-world-native-patch",
+        selectedAttempt: attempt,
+        selectedVariant: attemptVariant,
+        hardPass: true,
+        score: 1,
+        requestedTerrainAttempts: requestedAttempts,
+        exactRequestedVariant: requestedAttempts === 1,
+      };
+      candidate.generationContext = {
+        ...(candidate.generationContext || {}),
+        requestedVariant: options.variant || 0,
+        qualitySelectedVariant: attemptVariant,
+        qualityPolicyVersion: PATCH_QUALITY_POLICY_VERSION,
+        patchGenerator: "unified-world-native-patch",
+      };
+      return candidate;
+    }
+
+    const terrainQuality = evaluateExpansionTerrainCandidate(world, candidate, rects, window, seed, attemptVariant);
+    const humanQuality = evaluateExpansionHumanCandidate(world, candidate, terrainQuality, rects, window, seed);
+    const combinedScore = terrainQuality.score * 0.58 + humanQuality.score * 0.42;
+    attempts.push({ attempt, variant: attemptVariant, candidate, terrainQuality, humanQuality, combinedScore });
+    if (humanQuality.hardPass && combinedScore >= 0.68) break;
+  }
+
+  attempts.sort((a, b) => Number(b.humanQuality.hardPass) - Number(a.humanQuality.hardPass)
+    || b.combinedScore - a.combinedScore || a.attempt - b.attempt);
+  const selected = attempts[0];
+  const candidate = selected.candidate;
+  candidate.patchQuality = {
+    policyVersion: PATCH_QUALITY_POLICY_VERSION,
+    productionPipelineParity: true,
+    unifiedGenerator: true,
+    generator: "unified-world-native-patch",
+    terrainAttempts: attempts.map(summarizeTerrainQuality),
+    fullAttempts: attempts.map(summarizeFullQuality),
+    selectedAttempt: selected.attempt,
+    selectedVariant: selected.variant,
+    hardPass: selected.humanQuality.hardPass,
+    terrain: selected.terrainQuality,
+    human: selected.humanQuality,
+    score: selected.combinedScore,
+    fastPath: requestedAttempts === 1,
+    requestedTerrainAttempts: requestedAttempts,
+    exactRequestedVariant: requestedAttempts === 1,
+  };
+  candidate.terrainDebug = {
+    ...(candidate.terrainDebug || {}),
+    patchQualityPolicy: PATCH_QUALITY_POLICY_VERSION,
+    patchQualitySelectedVariant: selected.variant,
+    patchQualityHardPass: selected.humanQuality.hardPass,
+    patchQualityScore: selected.combinedScore,
+    patchGenerator: "unified-world-native-patch",
+  };
+  candidate.generationContext = {
+    ...(candidate.generationContext || {}),
+    requestedVariant: options.variant || 0,
+    qualitySelectedVariant: selected.variant,
+    qualityPolicyVersion: PATCH_QUALITY_POLICY_VERSION,
+    patchGenerator: "unified-world-native-patch",
+  };
+  return candidate;
+}
+
+function generatePatchCandidate(seed, options = {}) {
+  return generateUnifiedWorldNativePatchCandidate(seed, options);
+}
+
+function clonePointForPatch(point) {
+  return point ? { ...point } : point;
+}
+
+function captureStrictMetadataSnapshot(world, sourceMap, rects, seed = 0) {
+  if (!sourceMap || !rects?.writeRect) return null;
+  const byLayer = new Map();
+  const allByLayerId = new Map();
+  for (const key of ["adminCenters", "prefectureRegions"]) {
+    const arr = Array.isArray(sourceMap[key]) ? sourceMap[key] : [];
+    const outside = [];
+    const allById = new Map();
+    for (const p of arr) {
+      const id = metadataIdForLayer(p, key);
+      if (id >= 0 && !allById.has(id)) allById.set(id, clonePointForPatch(p));
+      const x = Math.round(pointWorldX(world, p));
+      const y = Math.round(pointWorldY(world, p));
+      if (patchAlpha(x, y, rects, seed) <= 0.005) outside.push(clonePointForPatch(p));
+    }
+    byLayer.set(key, outside);
+    allByLayerId.set(key, allById);
+  }
+  return { byLayer, allByLayerId };
+}
+
+function metadataIdForLayer(point, key) {
+  if (key === "prefectureRegions") return numericFeatureId(point, ["prefectureRegionId", "id", "featureId"]);
+  return numericFeatureId(point, ["adminId", "municipalityId", "adminNumericId"]);
+}
+
+const PREFECTURE_IDENTITY_FIELDS = [
+  "name", "labelName", "prefectureName", "prefectureRegionName", "regionName", "kind",
+];
+
+function capturePrefectureIdentitySnapshot(sourceMap) {
+  const byId = new Map();
+  for (const region of sourceMap?.prefectureRegions || []) {
+    const id = metadataIdForLayer(region, "prefectureRegions");
+    if (id >= 0 && !byId.has(id)) byId.set(id, clonePointForPatch(region));
+  }
+  const sourceNames = {};
+  for (const key of ["prefectureName", "regionName"]) {
+    if (sourceMap?.[key] != null && sourceMap[key] !== "") sourceNames[key] = sourceMap[key];
+  }
+  return { byId, sourceNames };
+}
+
+function restorePrefectureIdentitySnapshot(world, sourceMap, snapshot) {
+  if (!snapshot || !sourceMap) return { prefectureNamesRestored: 0, prefectureRecordsRestored: 0 };
+  const active = new Set();
+  const field = world?.fields?.prefectureRegionId;
+  const sea = world?.fields?.sea;
+  if (field) {
+    for (let i = 0; i < field.length; i++) if (!sea?.[i] && field[i] >= 0) active.add(Math.floor(field[i]));
+  }
+  const regions = Array.isArray(sourceMap.prefectureRegions) ? sourceMap.prefectureRegions : (sourceMap.prefectureRegions = []);
+  const current = new Map();
+  for (const region of regions) {
+    const id = metadataIdForLayer(region, "prefectureRegions");
+    if (id >= 0 && !current.has(id)) current.set(id, region);
+  }
+  let prefectureNamesRestored = 0;
+  let prefectureRecordsRestored = 0;
+  for (const [id, old] of snapshot.byId || []) {
+    if (active.size && !active.has(id)) continue;
+    let region = current.get(id);
+    if (!region) {
+      region = clonePointForPatch(old);
+      regions.push(region);
+      current.set(id, region);
+      prefectureRecordsRestored++;
+    }
+    for (const key of PREFECTURE_IDENTITY_FIELDS) {
+      if (old[key] == null || old[key] === "") continue;
+      if (region[key] !== old[key]) {
+        region[key] = old[key];
+        prefectureNamesRestored++;
+      }
+    }
+  }
+  const nameById = new Map();
+  for (const [id, old] of snapshot.byId || []) {
+    const name = old.prefectureName || old.prefectureRegionName || old.name || old.labelName || old.regionName;
+    if (name) nameById.set(id, name);
+  }
+  for (const center of sourceMap.adminCenters || []) {
+    const prefId = numericFeatureId(center, ["prefectureRegionId", "prefectureId"]);
+    const stableName = nameById.get(prefId);
+    if (!stableName) continue;
+    for (const key of ["prefectureName", "prefectureRegionName", "regionName"]) {
+      if (center[key] !== stableName) {
+        center[key] = stableName;
+        prefectureNamesRestored++;
+      }
+    }
+  }
+  for (const [key, value] of Object.entries(snapshot.sourceNames || {})) {
+    if (sourceMap[key] !== value) {
+      sourceMap[key] = value;
+      prefectureNamesRestored++;
+    }
+  }
+  return { prefectureNamesRestored, prefectureRecordsRestored };
+}
+
+function restoreOutsideStrictMetadata(world, sourceMap, rects, snapshot, seed = 0) {
+  if (!snapshot || !sourceMap) return { strictMetadataPointsRestored: 0 };
+  let strictMetadataPointsRestored = 0;
+  for (const key of ["adminCenters", "prefectureRegions"]) {
+    const oldOutside = snapshot.byLayer.get(key) || [];
+    if (!oldOutside.length) continue;
+    const oldById = new Map();
+    for (const p of oldOutside) {
+      const id = metadataIdForLayer(p, key);
+      if (id >= 0 && !oldById.has(id)) oldById.set(id, clonePointForPatch(p));
+    }
+    const existing = Array.isArray(sourceMap[key]) ? sourceMap[key] : [];
+    const allOldById = snapshot.allByLayerId?.get(key) || new Map();
+    const usedOldIds = new Set();
+    const next = [];
+    for (const p of existing) {
+      const stableId = metadataIdForLayer(p, key);
+      const stable = stableId >= 0 ? allOldById.get(stableId) : null;
+      if (stable) {
+        for (const field of ["name", "labelName", "prefectureName", "prefectureRegionName", "regionName", "municipalityName", "kind"]) {
+          if (stable[field] != null && stable[field] !== "") p[field] = stable[field];
+        }
+      }
+      const id = metadataIdForLayer(p, key);
+      const old = id >= 0 ? oldById.get(id) : null;
+      if (old) {
+        // If an existing administrative label/center was outside the lasso
+        // before the patch, keep it anchored there by ID.  The global coherence
+        // pass may otherwise move it into the selected area even though the
+        // user did not select the old center itself.
+        next.push(clonePointForPatch(old));
+        usedOldIds.add(id);
+        strictMetadataPointsRestored++;
+        continue;
+      }
+      next.push(p);
+    }
+    for (const [id, old] of oldById) {
+      if (usedOldIds.has(id)) continue;
+      const present = next.some((p) => metadataIdForLayer(p, key) === id);
+      if (!present) {
+        next.push(clonePointForPatch(old));
+        strictMetadataPointsRestored++;
+      }
+    }
+    sourceMap[key] = next;
+  }
+  return { strictMetadataPointsRestored };
+}
+
+function addInvalidatedRect(world, rect) {
+  if (!rect) return;
+  const normalized = normalizeRect(rect);
+  if (!normalized || rectArea(normalized) <= 0) return;
+  const key = rectKey(normalized);
+  const list = world.invalidatedRects || (world.invalidatedRects = []);
+  if (!list.some((r) => rectKey(r) === key)) list.push({ ...normalized });
+}
+
+
+function resolveWorldSeaLevel(world) {
+  const sourceLevel = world?.sourceMap?.seaLevel;
+  const level = Number.isFinite(world?.seaLevel)
+    ? world.seaLevel
+    : Number.isFinite(sourceLevel) ? sourceLevel : 0.30;
+  if (world) world.seaLevel = level;
+  if (world?.sourceMap) world.sourceMap.seaLevel = level;
+  return level;
+}
+
+function terrainContractOffset(contract, x, y) {
+  if (!contract || !insideRect(x, y, contract.rect)) return -1;
+  return (y - contract.rect.y0) * contract.width + (x - contract.rect.x0);
+}
+
+function oldCoastCell(world, oldSea, x, y) {
+  const i = worldIndexOf(world, x, y);
+  if (i < 0) return false;
+  const value = oldSea[i];
+  for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+    const ni = worldIndexOf(world, x + dx, y + dy);
+    if (ni >= 0 && oldSea[ni] !== value) return true;
+  }
+  return false;
+}
+
+function buildTerrainBoundaryContract(world, sourceMap, rects, seed, seaLevel) {
+  const oldSea = world?.fields?.sea;
+  const oldElevation = world?.fields?.elevation;
+  if (!oldSea || !oldElevation || !rects?.writeRect) return null;
+  const rect = expandRect(rects.writeRect, PATCH_TERRAIN_CONTINUATION_DEPTH + 1, world);
+  const width = rectWidth(rect);
+  const height = rectHeight(rect);
+  const size = width * height;
+  const fixedMask = new Uint8Array(size);
+  const fixedSea = new Uint8Array(size);
+  const fixedElevationMask = new Uint8Array(size);
+  const guideMask = new Uint8Array(size); // 1 land, 2 sea
+  const guideDistance = new Uint8Array(size);
+  const guideElevation = new Float32Array(size);
+  const generatedMask = new Uint8Array(size);
+  const transportMask = new Uint8Array(size);
+  const oldSeaLocal = new Uint8Array(size);
+  const oldElevationLocal = new Float32Array(size);
+  const roadOccupied = rasterizeDiagnosticPaths(world, sourceMap, SEAM_DIAGNOSTIC_ROAD_KEYS, rect);
+  const railOccupied = rasterizeDiagnosticPaths(world, sourceMap, SEAM_DIAGNOSTIC_RAIL_KEYS, rect);
+
+  for (let y = rect.y0; y < rect.y1; y++) {
+    for (let x = rect.x0; x < rect.x1; x++) {
+      const li = (y - rect.y0) * width + (x - rect.x0);
+      const wi = worldIndexOf(world, x, y);
+      if (wi < 0) continue;
+      oldSeaLocal[li] = oldSea[wi] ? 1 : 0;
+      oldElevationLocal[li] = oldElevation[wi] || 0;
+      const generated = wasGeneratedAt(rects, x, y);
+      generatedMask[li] = generated ? 1 : 0;
+      const occupied = roadOccupied.has(diagnosticCellKey(x, y)) || railOccupied.has(diagnosticCellKey(x, y));
+      if (occupied) transportMask[li] = 1;
+      const alpha = patchAlpha(x, y, rects, seed);
+      if (rects.patchMode === PATCH_MODE_EXPANSION && generated && insideRect(x, y, rects.writeRect)) {
+        // Expansion extends the world; it does not re-cut already generated
+        // coastlines. Elevation can feather, but water topology is immutable on
+        // the old side of the overlap corridor.
+        fixedMask[li] = 1;
+        fixedSea[li] = oldSeaLocal[li];
+        fixedElevationMask[li] = 1;
+      } else if (rects.patchMode === PATCH_MODE_REGENERATION && generated && alpha > 0.005) {
+        const coastAnchor = oldCoastCell(world, oldSea, x, y);
+        if (alpha < 0.72 || (coastAnchor && alpha < 0.90)) {
+          fixedMask[li] = 1;
+          fixedSea[li] = oldSeaLocal[li];
+        }
+      }
+      if (occupied && generated && !oldSeaLocal[li]) {
+        fixedMask[li] = 1;
+        fixedSea[li] = 0;
+        fixedElevationMask[li] = 1;
+      }
+    }
+  }
+
+  if (rects.patchMode === PATCH_MODE_EXPANSION) {
+    for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+      for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+        const li = terrainContractOffset({ rect, width }, x, y);
+        if (li < 0 || generatedMask[li] || !patchTerrainWritable(rects, x, y, seed)) continue;
+        let landVotes = 0;
+        let seaVotes = 0;
+        let transportVotes = 0;
+        let landElevationSum = 0;
+        let landElevationWeight = 0;
+        let directLandCount = 0;
+        let directLandElevationSum = 0;
+        let nearest = 0;
+        for (let radius = 1; radius <= PATCH_TERRAIN_CONTINUATION_DEPTH; radius++) {
+          let foundAtRadius = false;
+          for (let oy = -radius; oy <= radius; oy++) {
+            for (let ox = -radius; ox <= radius; ox++) {
+              if (Math.max(Math.abs(ox), Math.abs(oy)) !== radius) continue;
+              const ni = terrainContractOffset({ rect, width }, x + ox, y + oy);
+              if (ni < 0 || !generatedMask[ni]) continue;
+              foundAtRadius = true;
+              const weight = PATCH_TERRAIN_CONTINUATION_DEPTH + 1 - radius;
+              if (oldSeaLocal[ni]) seaVotes += weight;
+              else {
+                landVotes += weight;
+                landElevationSum += oldElevationLocal[ni] * weight;
+                landElevationWeight += weight;
+                if (radius === 1) {
+                  directLandCount++;
+                  directLandElevationSum += oldElevationLocal[ni];
+                }
+              }
+              if (transportMask[ni] && !oldSeaLocal[ni]) transportVotes += weight * 2;
+            }
+          }
+          if (foundAtRadius && !nearest) nearest = radius;
+        }
+        const total = landVotes + seaVotes;
+        if (!nearest || !total) continue;
+        guideDistance[li] = nearest;
+        if (landElevationWeight > 0) guideElevation[li] = landElevationSum / landElevationWeight;
+        if (directLandCount > 0) {
+          // A generated land cell touching the frontier is a hard terrain
+          // continuation anchor.  Majority voting against nearby coastal sea
+          // previously turned mountain/plateau edges into an immediate water
+          // wall one cell outside the old map.
+          guideMask[li] = 1;
+          guideDistance[li] = 1;
+          guideElevation[li] = directLandElevationSum / directLandCount;
+        } else if (transportVotes > 0 && nearest <= 4) guideMask[li] = 1;
+        else if (landVotes / total >= 0.68) guideMask[li] = 1;
+        else if (seaVotes / total >= 0.90) guideMask[li] = 2;
+      }
+    }
+  }
+
+  return {
+    version: 1,
+    patchMode: rects.patchMode,
+    seaLevel,
+    rect,
+    width,
+    height,
+    fixedMask,
+    fixedSea,
+    fixedElevationMask,
+    guideMask,
+    guideDistance,
+    guideElevation,
+    generatedMask,
+    transportMask,
+    oldSea: oldSeaLocal,
+    oldElevation: oldElevationLocal,
+  };
+}
+
+function applyTerrainBoundaryContract(world, rects, contract, seed = 0, phase = "classify") {
+  if (!contract || !world?.fields?.elevation) return { phase, classifiedCells: 0, fixedCellsApplied: 0, fixedElevationCellsApplied: 0, guidedCellsApplied: 0, guidedLandElevationCellsApplied: 0, transportLandCellsApplied: 0, seaCellsChanged: 0 };
+  const seaLevel = contract.seaLevel;
+  const elevation = world.fields.elevation;
+  const expected = world.width * world.height;
+  const sea = world.fields.sea || (world.fields.sea = new Uint8Array(expected));
+  const ocean = world.fields.ocean || (world.fields.ocean = new Uint8Array(expected));
+  const lake = world.fields.lake || (world.fields.lake = new Uint8Array(expected));
+  let classifiedCells = 0;
+  let fixedCellsApplied = 0;
+  let fixedElevationCellsApplied = 0;
+  let guidedCellsApplied = 0;
+  let guidedLandElevationCellsApplied = 0;
+  let transportLandCellsApplied = 0;
+  let seaCellsChanged = 0;
+
+  for (let y = rects.writeRect.y0; y < rects.writeRect.y1; y++) {
+    for (let x = rects.writeRect.x0; x < rects.writeRect.x1; x++) {
+      const wi = worldIndexOf(world, x, y);
+      const li = terrainContractOffset(contract, x, y);
+      if (wi < 0 || li < 0) continue;
+      const alpha = patchAlpha(x, y, rects, seed);
+      if (!contract.fixedMask[li] && !patchTerrainWritable(rects, x, y, seed)) continue;
+      if (alpha <= 0.005 && !contract.fixedMask[li]) continue;
+      if (contract.fixedElevationMask?.[li]) {
+        elevation[wi] = contract.oldElevation[li];
+        fixedElevationCellsApplied++;
+      } else if (alpha <= 0.005 && contract.fixedMask[li]) {
+        elevation[wi] = contract.oldElevation[li];
+      }
+      let nextSea = elevation[wi] <= seaLevel ? 1 : 0;
+      if (contract.fixedMask[li]) {
+        nextSea = contract.fixedSea[li];
+        fixedCellsApplied++;
+      } else if (contract.guideMask[li]) {
+        const distance = contract.guideDistance[li] || PATCH_TERRAIN_CONTINUATION_DEPTH;
+        const desiredSea = contract.guideMask[li] === 2 ? 1 : 0;
+        const continuationReach = insideSelectedCore(rects, x, y)
+          ? PATCH_TERRAIN_CONTINUATION_DEPTH + 1
+          : terrainContinuationReach(x, y, rects, seed);
+        const guideActive = distance <= continuationReach;
+        if (!guideActive) {
+          // A fixed five-cell continuation collar reproduced the rectangular
+          // edge of the previous generation as a straight coastline.  Beyond
+          // the noise-displaced local reach, leave the production candidate in
+          // control instead of forcing either land or sea.
+        } else if (!desiredSea) {
+          const inheritedElevation = contract.guideElevation?.[li] || seaLevel + 0.018;
+          const strength = clamp((PATCH_TERRAIN_CONTINUATION_DEPTH + 1 - distance) / PATCH_TERRAIN_CONTINUATION_DEPTH, 0.18, 1);
+          const target = Math.max(seaLevel + 0.008, inheritedElevation);
+          const continuationStrength = distance <= 1 ? 0.92 : 0.72;
+          const guideBlend = insideSelectedCore(rects, x, y) ? 1 : clamp(alpha / 0.5);
+          elevation[wi] = Math.max(elevation[wi], lerp(seaLevel + 0.008, target, strength * continuationStrength * guideBlend));
+          if (guideBlend >= 0.22 || elevation[wi] > seaLevel + 0.004) nextSea = 0;
+          guidedLandElevationCellsApplied++;
+        } else {
+          // Sea guidance may shape a shallow candidate coast but must not drown
+          // an already elevated land candidate merely because the lasso edge is
+          // nearby.
+          const bias = (PATCH_TERRAIN_CONTINUATION_DEPTH + 1 - distance) * 0.006;
+          if (elevation[wi] <= seaLevel + bias) nextSea = 1;
+        }
+        guidedCellsApplied++;
+      }
+      if (!nextSea && patchCellIsNew(rects, x, y) && !insideSelectedCore(rects, x, y)) {
+        elevation[wi] = Math.min(elevation[wi], overflowElevationCap(rects, x, y, seed, seaLevel));
+      }
+      if (contract.transportMask[li] && contract.generatedMask[li] && !contract.oldSea[li]) {
+        nextSea = 0;
+        transportLandCellsApplied++;
+      }
+      if (sea[wi] !== nextSea) seaCellsChanged++;
+      sea[wi] = nextSea;
+      ocean[wi] = nextSea;
+      lake[wi] = 0;
+      if (contract.fixedElevationMask?.[li]) {
+        elevation[wi] = contract.oldElevation[li];
+      } else if (nextSea) elevation[wi] = Math.min(elevation[wi], seaLevel - 0.004);
+      else elevation[wi] = Math.max(elevation[wi], seaLevel + 0.006);
+      classifiedCells++;
+    }
+  }
+  return { phase, classifiedCells, fixedCellsApplied, fixedElevationCellsApplied, guidedCellsApplied, guidedLandElevationCellsApplied, transportLandCellsApplied, seaCellsChanged };
+}
+
+function finalizeExpansionElevationSeam(world, rects, seed = 0, seaLevel = 0.30) {
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || !world?.fields?.elevation) {
+    return { finalSeamElevationCellsAdjusted: 0, finalSeamElevationPasses: 0, finalSeamMaxAdjustment: 0 };
+  }
+  const elevation = world.fields.elevation;
+  const sea = world.fields.sea;
+  const rect = rects.writeRect;
+  const sampleRect = expandRect(rect, 1, world);
+  const sw = rectWidth(sampleRect);
+  const sh = rectHeight(sampleRect);
+  const offset = (x, y) => (y - sampleRect.y0) * sw + (x - sampleRect.x0);
+  const dirs = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
+  let adjusted = 0;
+  let passes = 0;
+  let maxAdjustment = 0;
+
+  // Run after every terrain boundary contract.  Earlier smoothing was partly
+  // undone when land-continuation anchors were re-applied.  This final bridge
+  // only moves newly generated cells; existing generated elevation remains
+  // bit-identical.
+  for (let pass = 0; pass < 6; pass++) {
+    const old = new Float32Array(sw * sh);
+    for (let y = sampleRect.y0; y < sampleRect.y1; y++) {
+      for (let x = sampleRect.x0; x < sampleRect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i >= 0) old[offset(x, y)] = elevation[i] || 0;
+      }
+    }
+    let passAdjusted = 0;
+    for (let y = rect.y0; y < rect.y1; y++) {
+      for (let x = rect.x0; x < rect.x1; x++) {
+        const i = worldIndexOf(world, x, y);
+        if (i < 0 || wasGeneratedAt(rects, x, y)) continue;
+        const a = patchAlpha(x, y, rects, seed);
+        if (!patchTerrainWritable(rects, x, y, seed)) continue;
+        const gradient = patchAlphaGradient(x, y, rects, seed);
+        const frontierDistance = coverageDistanceAt(rects, x, y, "generated");
+        if (a >= 0.985 && gradient < 0.08 && frontierDistance > Math.max(8, rects.expansionOverlap || 0)) continue;
+
+        const here = old[offset(x, y)] || 0;
+        const hereSea = !!sea?.[i];
+        let sum = 0;
+        let wsum = 0;
+        let strongest = 0;
+        for (const [dx, dy] of dirs) {
+          const nx = x + dx, ny = y + dy;
+          const ni = worldIndexOf(world, nx, ny);
+          if (ni < 0) continue;
+          const nv = insideRect(nx, ny, sampleRect) ? old[offset(nx, ny)] : (elevation[ni] || 0);
+          const neighborGenerated = wasGeneratedAt(rects, nx, ny);
+          const na = patchAlpha(nx, ny, rects, seed);
+          const lowerOwnership = neighborGenerated || na < a + 0.04;
+          const sameWater = (!!sea?.[ni]) === hereSea;
+          const diag = Math.abs(dx) + Math.abs(dy) === 2;
+          const w = (neighborGenerated ? 2.2 : lowerOwnership ? 1.15 : 0.32) * (sameWater ? 1 : 0.55) * (diag ? 0.72 : 1);
+          sum += nv * w;
+          wsum += w;
+          if (neighborGenerated || lowerOwnership) strongest = Math.max(strongest, Math.abs(here - nv));
+        }
+        if (!wsum || strongest < 0.10) continue;
+        let target = sum / wsum;
+        if (hereSea) target = Math.min(target, seaLevel - 0.008);
+        else target = Math.max(target, seaLevel + 0.010);
+        const severity = clamp((strongest - 0.10) / 0.28);
+        const ownershipWeight = insideSelectedCore(rects, x, y) ? 1 : smoothstep(clamp(a * 2));
+        const edgeWeight = clamp(0.20 + gradient * 0.80 + severity * 0.34, 0.20, 0.74) * ownershipWeight;
+        if (edgeWeight <= 0.002) continue;
+        let next = clamp(lerp(here, target, edgeWeight), hereSea ? 0 : seaLevel + 0.006, hereSea ? seaLevel - 0.004 : 1);
+        if (!hereSea) next = Math.min(next, overflowElevationCap(rects, x, y, seed, seaLevel));
+        const delta = Math.abs(next - elevation[i]);
+        if (delta <= 1e-5) continue;
+        elevation[i] = next;
+        maxAdjustment = Math.max(maxAdjustment, delta);
+        passAdjusted++;
+      }
+    }
+    if (!passAdjusted) break;
+    adjusted += passAdjusted;
+    passes++;
+  }
+  return {
+    finalSeamElevationCellsAdjusted: adjusted,
+    finalSeamElevationPasses: passes,
+    finalSeamMaxAdjustment: Math.round(maxAdjustment * 10000) / 10000,
+  };
+}
+
+
+function harmonizeExpansionFrontier(world, rects, seed = 0, seaLevel = 0.30, options = {}) {
+  const debug = { frontierHarmonizedCells: 0, frontierHarmonizedValues: 0, frontierHarmonizationPasses: 0 };
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || !rects?._generatedCoverage) return debug;
+  const fields = world.fields || {};
+  const sea = fields.sea;
+  if (!sea) return debug;
+  const depth = Math.max(10, Math.min(22, Math.floor(options.depth || Math.max(14, (rects.expansionOverlap || 16) * 0.72))));
+  const passes = Math.max(1, Math.min(8, Math.floor(options.passes || 5)));
+  const keys = [
+    "elevation", "moisture", "ridgeField", "valleyField", "visibleRavineField", "basinField",
+    "coastalLowland", "plain", "agriculture", "erosionField", "depositionField",
+    "depositionalLowland", "alluvialFanField", "deltaField", "naturalBarrierScore",
+    "settlementScore", "populationDensity",
+  ];
+  const rect = rects.writeRect;
+  const w = rectWidth(rect), h = rectHeight(rect);
+  if (!w || !h) return debug;
+  const li = (x,y) => (y - rect.y0) * w + (x - rect.x0);
+  const dirs = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[-1,1],[1,-1],[-1,-1]];
+  const eligible = new Uint8Array(w * h);
+  for (let y = rect.y0; y < rect.y1; y++) for (let x = rect.x0; x < rect.x1; x++) {
+    if (wasGeneratedAt(rects, x, y) || !patchTerrainWritable(rects, x, y, seed)) continue;
+    const d = coverageDistanceAt(rects, x, y, "generated");
+    if (d >= 1 && d <= depth) eligible[li(x,y)] = 1;
+  }
+  const eligibleCount = eligible.reduce((sum,v) => sum + v, 0);
+  if (!eligibleCount) return debug;
+
+  for (const key of keys) {
+    const field = fields[key];
+    if (!field || !ArrayBuffer.isView(field)) continue;
+    for (let pass = 0; pass < passes; pass++) {
+      const old = new Float32Array(w * h);
+      for (let y = rect.y0; y < rect.y1; y++) for (let x = rect.x0; x < rect.x1; x++) {
+        const i = worldIndexOf(world, x, y); if (i >= 0) old[li(x,y)] = field[i] || 0;
+      }
+      let changed = 0;
+      for (let y = rect.y0; y < rect.y1; y++) for (let x = rect.x0; x < rect.x1; x++) {
+        const local = li(x,y); if (!eligible[local]) continue;
+        const i = worldIndexOf(world, x, y); if (i < 0) continue;
+        const hereSea = !!sea[i];
+        let sum = 0, weight = 0, generatedSupport = 0;
+        for (const [dx,dy] of dirs) {
+          const nx=x+dx, ny=y+dy, ni=worldIndexOf(world,nx,ny); if (ni < 0 || (!!sea[ni]) !== hereSea) continue;
+          const nv = insideRect(nx,ny,rect) ? old[li(nx,ny)] : (field[ni] || 0);
+          const established = wasGeneratedAt(rects,nx,ny);
+          const ww = established ? 3.4 : 1.0;
+          sum += nv * ww; weight += ww; if (established) generatedSupport += ww;
+        }
+        if (!weight) continue;
+        const d = coverageDistanceAt(rects, x, y, "generated");
+        const near = 1 - clamp((d - 1) / Math.max(1, depth - 1));
+        // Multiple weak passes solve a local diffusion problem instead of copying
+        // the old edge into a fixed-width strip. The transition follows actual
+        // terrain neighborhoods, not the lasso or write rectangle geometry.
+        const strength = clamp((0.10 + near * 0.34 + (generatedSupport > 0 ? 0.12 : 0)) / (1 + pass * 0.10), 0.08, 0.56);
+        let next = lerp(field[i] || 0, sum / weight, strength);
+        if (key === "elevation") {
+          next = hereSea ? Math.min(next, seaLevel - 0.004) : Math.max(next, seaLevel + 0.006);
+          if (!hereSea) next = Math.min(next, overflowElevationCap(rects,x,y,seed,seaLevel));
+        }
+        if (Math.abs(next - field[i]) <= 1e-5) continue;
+        field[i] = next; changed++; debug.frontierHarmonizedValues++;
+      }
+      if (!changed) break;
+      debug.frontierHarmonizedCells += changed;
+      debug.frontierHarmonizationPasses = Math.max(debug.frontierHarmonizationPasses, pass + 1);
+    }
+  }
+  return debug;
+}
+
+function enforceEstablishedFrontierElevationContinuity(world, rects, seed = 0, seaLevel = 0.30, options = {}) {
+  const debug = {
+    establishedFrontierElevationCellsAdjusted: 0,
+    establishedFrontierGradientCellsAdjusted: 0,
+    establishedFrontierElevationMaxBefore: 0,
+    establishedFrontierElevationMaxAfter: 0,
+    establishedFrontierElevationDepth: 0,
+  };
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || !rects?._generatedCoverage || !world?.fields?.elevation) return debug;
+  const elevation = world.fields.elevation;
+  const sea = world.fields.sea;
+  const rect = rects.writeRect;
+  const depth = Math.max(4, Math.min(16, Math.floor(options.depth || 10)));
+  const frontierLimit = Math.max(0.035, Math.min(0.075, Number(options.frontierLimit ?? 0.055)));
+  const gradientLimit = Math.max(frontierLimit, Math.min(0.11, Number(options.gradientLimit ?? 0.072)));
+  const dirs4 = [[1,0],[-1,0],[0,1],[0,-1]];
+
+  const sameWaterNeighborValues = (x, y, requireEstablished = false, maxDistance = null) => {
+    const i = worldIndexOf(world, x, y);
+    if (i < 0) return [];
+    const hereSea = !!sea?.[i];
+    const values = [];
+    for (const [dx,dy] of dirs4) {
+      const nx=x+dx, ny=y+dy;
+      const ni=worldIndexOf(world,nx,ny);
+      if (ni < 0 || (!!sea?.[ni]) !== hereSea) continue;
+      if (requireEstablished && !wasGeneratedAt(rects,nx,ny)) continue;
+      if (maxDistance != null && !wasGeneratedAt(rects,nx,ny)) {
+        const nd=coverageDistanceAt(rects,nx,ny,"generated");
+        if (!(nd >= 1 && nd < maxDistance)) continue;
+      }
+      const v=elevation[ni];
+      if (Number.isFinite(v)) values.push(v);
+    }
+    return values;
+  };
+
+  const constrainToNeighbors = (current, values, limit) => {
+    if (!values.length) return current;
+    let lower=-Infinity, upper=Infinity, sum=0;
+    for (const v of values) {
+      lower=Math.max(lower,v-limit);
+      upper=Math.min(upper,v+limit);
+      sum+=v;
+    }
+    const mean=sum/values.length;
+    // If established neighbors themselves span more than 2*limit, no single
+    // value can satisfy every edge. Use their mean instead of creating a new
+    // axis-aligned shelf, then let the outward diffusion distribute the slope.
+    if (lower > upper) return mean;
+    return clamp(current, lower, upper);
+  };
+
+  // First solve the literal old/new contact edges. This is deliberately based
+  // on generated coverage, not the lasso rectangle or alpha band, so it works
+  // for every expansion direction and for irregular selections.
+  for (let y=rect.y0; y<rect.y1; y++) {
+    for (let x=rect.x0; x<rect.x1; x++) {
+      if (wasGeneratedAt(rects,x,y) || !patchTerrainWritable(rects,x,y,seed)) continue;
+      const i=worldIndexOf(world,x,y);
+      if (i < 0) continue;
+      const established=sameWaterNeighborValues(x,y,true);
+      if (!established.length) continue;
+      const before=elevation[i] || 0;
+      for (const v of established) debug.establishedFrontierElevationMaxBefore=Math.max(debug.establishedFrontierElevationMaxBefore,Math.abs(before-v));
+      let next=constrainToNeighbors(before,established,frontierLimit);
+      const mean=established.reduce((a,b)=>a+b,0)/established.length;
+      next=lerp(next,mean,0.30);
+      next=constrainToNeighbors(next,established,frontierLimit);
+      if (sea?.[i]) next=Math.min(next,seaLevel-0.004);
+      else next=Math.max(next,seaLevel+0.006);
+      if (Math.abs(next-before)>1e-6) {
+        elevation[i]=next;
+        debug.establishedFrontierElevationCellsAdjusted++;
+      }
+    }
+  }
+
+  // Propagate that solved edge into the generated side. Processing by coverage
+  // distance makes each ring inherit a natural gradient from the previous ring
+  // instead of producing a second, parallel seam a few cells inward.
+  for (let d=2; d<=depth; d++) {
+    const changes=[];
+    for (let y=rect.y0; y<rect.y1; y++) {
+      for (let x=rect.x0; x<rect.x1; x++) {
+        if (wasGeneratedAt(rects,x,y) || !patchTerrainWritable(rects,x,y,seed)) continue;
+        if (coverageDistanceAt(rects,x,y,"generated") !== d) continue;
+        const i=worldIndexOf(world,x,y);
+        if (i < 0) continue;
+        const parents=sameWaterNeighborValues(x,y,false,d);
+        if (!parents.length) continue;
+        const before=elevation[i] || 0;
+        const mean=parents.reduce((a,b)=>a+b,0)/parents.length;
+        const near=1-clamp((d-2)/Math.max(1,depth-2));
+        let next=lerp(before,mean,0.18+near*0.42);
+        const localLimit=gradientLimit + (1-near)*0.020;
+        next=constrainToNeighbors(next,parents,localLimit);
+        if (sea?.[i]) next=Math.min(next,seaLevel-0.004);
+        else next=Math.max(next,seaLevel+0.006);
+        if (Math.abs(next-before)>1e-6) changes.push([i,next]);
+      }
+    }
+    for (const [i,next] of changes) elevation[i]=next;
+    debug.establishedFrontierGradientCellsAdjusted += changes.length;
+  }
+
+  // Measure the final literal old/new land frontier. This is the visual failure
+  // mode users notice, and is also used by the seam gate below.
+  for (let y=rect.y0; y<rect.y1; y++) {
+    for (let x=rect.x0; x<rect.x1; x++) {
+      const i=worldIndexOf(world,x,y);
+      if (i < 0 || sea?.[i]) continue;
+      for (const [dx,dy] of [[1,0],[0,1]]) {
+        const nx=x+dx, ny=y+dy, ni=worldIndexOf(world,nx,ny);
+        if (ni < 0 || sea?.[ni]) continue;
+        if (wasGeneratedAt(rects,x,y) === wasGeneratedAt(rects,nx,ny)) continue;
+        debug.establishedFrontierElevationMaxAfter=Math.max(debug.establishedFrontierElevationMaxAfter,Math.abs((elevation[i]||0)-(elevation[ni]||0)));
+      }
+    }
+  }
+  debug.establishedFrontierElevationMaxBefore=Math.round(debug.establishedFrontierElevationMaxBefore*10000)/10000;
+  debug.establishedFrontierElevationMaxAfter=Math.round(debug.establishedFrontierElevationMaxAfter*10000)/10000;
+  debug.establishedFrontierElevationDepth=depth;
+  return debug;
+}
+
+function repairPatchTerrain(world, rects, seed, seaLevel, terrainContract = null, onProgress = null) {
+  const step = (key) => onProgress?.({ status: "terrain-repair-step", key: `terrain-repair:${key}`, label: `Terrain repair: ${key}` });
+  const terrainSeamDebug = featherTerrainSeam(world, rects, seed); step("feather-seam");
+  const frontierHarmonizationDebug = harmonizeExpansionFrontier(world, rects, seed, seaLevel); step("frontier-harmonization");
+  const elevationCliffDebug = smoothExtremeElevationSeams(world, rects, seed, seaLevel); step("elevation-cliff");
+  const waterDebug = smoothWaterTopology(world, rects.writeRect, seaLevel, rects, seed); step("water-topology");
+  const waterComponentDebug = repairWaterComponentTopology(world, rects, seaLevel, seed); step("water-components");
+  const residualSeaDebug = fillTinyResidualSeas(world, rects, seaLevel, seed, { aggressive: true }); step("residual-sea");
+  const boundaryContractDebug = applyTerrainBoundaryContract(world, rects, terrainContract, seed, "post-terrain-repair"); step("boundary-contract-1");
+  const waterElevationDebug = smoothPatchedWaterElevation(world, rects, seaLevel, seed); step("water-elevation");
+  const boundaryContractFinalDebug = applyTerrainBoundaryContract(world, rects, terrainContract, seed, "post-water-elevation"); step("boundary-contract-2");
+  const maskDebug = repairDisplayMasks(world, rects, seed); step("display-masks");
+  recomputeSlopeAndWaterDependentFields(world, rects.repairRect, seaLevel); step("derived-fields");
+  return {
+    terrainSeamDebug,
+    frontierHarmonizationDebug,
+    elevationCliffDebug,
+    waterDebug,
+    waterComponentDebug,
+    residualSeaDebug,
+    waterElevationDebug,
+    boundaryContractDebug,
+    boundaryContractFinalDebug,
+    maskDebug,
+  };
+}
+
+
+function repairLongAxisAlignedPrefectureSeams(world, sourceMap, rects, adminIdMapping, options = {}) {
+  const threshold = Math.max(12, Math.floor(options.threshold || 24));
+  const maxMoves = Math.max(0, Math.floor(options.maxMoves ?? 4));
+  const debug = {
+    threshold,
+    runsDetected: 0,
+    municipalitiesReassigned: 0,
+    cellsReassigned: 0,
+    longestRunBefore: 0,
+    longestRunAfter: 0,
+  };
+  if (rects?.patchMode !== PATCH_MODE_EXPANSION || maxMoves <= 0) return debug;
+  const admin = world.fields?.adminId;
+  const municipality = world.fields?.municipalityId;
+  const prefecture = world.fields?.prefectureRegionId;
+  const sea = world.fields?.sea;
+  if (!admin || !prefecture || !sea) return debug;
+
+  const allocated = adminIdMapping?.allocatedMunicipalityIds instanceof Set
+    ? adminIdMapping.allocatedMunicipalityIds
+    : new Set();
+  if (!allocated.size) return debug;
+
+  const protectedAdmins = new Set();
+  for (const point of sourceMap?.prefectureRegions || []) {
+    const x = Math.round(pointWorldX(world, point));
+    const y = Math.round(pointWorldY(world, point));
+    const i = worldIndexOf(world, x, y);
+    if (i >= 0 && admin[i] >= 0) protectedAdmins.add(admin[i]);
+  }
+
+  const collectState = () => {
+    const area = new Map();
+    const prefVotes = new Map();
+    const adjacency = new Map();
+    const regionMembers = new Map();
+    const runs = new Map();
+    const rect = rects.writeRect;
+    const addAdj = (a, b) => {
+      if (a < 0 || b < 0 || a === b) return;
+      if (!adjacency.has(a)) adjacency.set(a, new Map());
+      adjacency.get(a).set(b, (adjacency.get(a).get(b) || 0) + 1);
+    };
+    const addRunEdge = (key, value) => {
+      const values = runs.get(key) || [];
+      values.push(value);
+      runs.set(key, values);
+    };
+
+    for (let y = 0; y < world.height; y++) {
+      for (let x = 0; x < world.width; x++) {
+        const i = y * world.width + x;
+        if (sea[i] || admin[i] < 0 || prefecture[i] < 0) continue;
+        const a = admin[i];
+        const r = prefecture[i];
+        area.set(a, (area.get(a) || 0) + 1);
+        if (!prefVotes.has(a)) prefVotes.set(a, new Map());
+        prefVotes.get(a).set(r, (prefVotes.get(a).get(r) || 0) + 1);
+        if (x + 1 < world.width) {
+          const j = i + 1;
+          if (!sea[j] && admin[j] >= 0 && admin[j] !== a) {
+            addAdj(a, admin[j]);
+            addAdj(admin[j], a);
+          }
+        }
+        if (y + 1 < world.height) {
+          const j = i + world.width;
+          if (!sea[j] && admin[j] >= 0 && admin[j] !== a) {
+            addAdj(a, admin[j]);
+            addAdj(admin[j], a);
+          }
+        }
+      }
+    }
+
+    const prefByAdmin = new Map();
+    for (const [a, votes] of prefVotes) {
+      let best = -1;
+      let bestVotes = -1;
+      for (const [r, n] of votes) if (n > bestVotes) { best = r; bestVotes = n; }
+      prefByAdmin.set(a, best);
+      if (!regionMembers.has(best)) regionMembers.set(best, new Set());
+      regionMembers.get(best).add(a);
+    }
+
+    for (let y = Math.max(0, rect.y0); y < Math.min(world.height, rect.y1); y++) {
+      for (let x = Math.max(0, rect.x0); x < Math.min(world.width, rect.x1); x++) {
+        const i = y * world.width + x;
+        if (sea[i] || admin[i] < 0 || prefecture[i] < 0) continue;
+        if (x + 1 < Math.min(world.width, rect.x1)) {
+          const j = i + 1;
+          if (!sea[j] && admin[j] >= 0 && prefecture[j] >= 0 && prefecture[j] !== prefecture[i]) {
+            const a = admin[i], b = admin[j];
+            if (allocated.has(a) || allocated.has(b)) {
+              const lo = Math.min(a, b), hi = Math.max(a, b);
+              addRunEdge(`v:${x + 1}:${lo}:${hi}`, y);
+            }
+          }
+        }
+        if (y + 1 < Math.min(world.height, rect.y1)) {
+          const j = i + world.width;
+          if (!sea[j] && admin[j] >= 0 && prefecture[j] >= 0 && prefecture[j] !== prefecture[i]) {
+            const a = admin[i], b = admin[j];
+            if (allocated.has(a) || allocated.has(b)) {
+              const lo = Math.min(a, b), hi = Math.max(a, b);
+              addRunEdge(`h:${y + 1}:${lo}:${hi}`, x);
+            }
+          }
+        }
+      }
+    }
+
+    const longRuns = [];
+    for (const [key, rawValues] of runs) {
+      const values = [...new Set(rawValues)].sort((a, b) => a - b);
+      const [, axisText, aText, bText] = key.split(":");
+      let start = null;
+      let previous = null;
+      for (const value of values) {
+        if (start === null || value !== previous + 1) {
+          if (start !== null) {
+            const length = previous - start + 1;
+            if (length > threshold) longRuns.push({ key, axis: Number(axisText), adminA: Number(aText), adminB: Number(bText), start, end: previous, length });
+          }
+          start = value;
+        }
+        previous = value;
+      }
+      if (start !== null) {
+        const length = previous - start + 1;
+        if (length > threshold) longRuns.push({ key, axis: Number(axisText), adminA: Number(aText), adminB: Number(bText), start, end: previous, length });
+      }
+    }
+    longRuns.sort((a, b) => b.length - a.length);
+    return { area, adjacency, regionMembers, prefByAdmin, longRuns };
+  };
+
+  const remainsConnectedWithout = (state, region, removed) => {
+    const members = [...(state.regionMembers.get(region) || [])].filter((id) => id !== removed);
+    if (members.length <= 1) return true;
+    const allowed = new Set(members);
+    const visited = new Set([members[0]]);
+    const queue = [members[0]];
+    for (let qi = 0; qi < queue.length; qi++) {
+      for (const neighbor of state.adjacency.get(queue[qi])?.keys() || []) {
+        if (!allowed.has(neighbor) || visited.has(neighbor)) continue;
+        visited.add(neighbor);
+        queue.push(neighbor);
+      }
+    }
+    return visited.size === members.length;
+  };
+
+  let state = collectState();
+  debug.runsDetected = state.longRuns.length;
+  debug.longestRunBefore = state.longRuns[0]?.length || 0;
+  for (let move = 0; move < maxMoves && state.longRuns.length; move++) {
+    const run = state.longRuns[0];
+    const candidates = [];
+    for (const [sourceAdmin, targetAdmin] of [[run.adminA, run.adminB], [run.adminB, run.adminA]]) {
+      const sourceRegion = state.prefByAdmin.get(sourceAdmin);
+      const targetRegion = state.prefByAdmin.get(targetAdmin);
+      if (sourceRegion < 0 || targetRegion < 0 || sourceRegion === targetRegion) continue;
+      if (!allocated.has(sourceAdmin) || protectedAdmins.has(sourceAdmin)) continue;
+      const sourceCount = state.regionMembers.get(sourceRegion)?.size || 0;
+      const targetCount = state.regionMembers.get(targetRegion)?.size || 0;
+      if (sourceCount <= 4 || !remainsConnectedWithout(state, sourceRegion, sourceAdmin)) continue;
+      const shared = state.adjacency.get(sourceAdmin)?.get(targetAdmin) || 0;
+      const balanceGain = sourceCount - targetCount;
+      candidates.push({
+        sourceAdmin,
+        sourceRegion,
+        targetRegion,
+        score: balanceGain * 100 + run.length * 4 + shared - (state.area.get(sourceAdmin) || 0) * 0.002,
+      });
+    }
+    candidates.sort((a, b) => b.score - a.score);
+    const chosen = candidates[0];
+    if (!chosen) break;
+
+    let changed = 0;
+    for (let i = 0; i < admin.length; i++) {
+      if (sea[i] || admin[i] !== chosen.sourceAdmin) continue;
+      if (prefecture[i] !== chosen.targetRegion) {
+        prefecture[i] = chosen.targetRegion;
+        changed++;
+      }
+    }
+    if (!changed) break;
+    if (sourceMap?.municipalityToPrefectureId && chosen.sourceAdmin < sourceMap.municipalityToPrefectureId.length) {
+      const nextPrefectureMap = sourceMap.municipalityToPrefectureId.slice();
+      nextPrefectureMap[chosen.sourceAdmin] = chosen.targetRegion;
+      sourceMap.municipalityToPrefectureId = nextPrefectureMap;
+    }
+    adminIdMapping?.municipalityToPrefecture?.set(chosen.sourceAdmin, chosen.targetRegion);
+    for (const center of sourceMap?.adminCenters || []) {
+      const id = numericFeatureId(center, ["adminId", "municipalityId", "adminNumericId"]);
+      if (id === chosen.sourceAdmin) center.prefectureRegionId = chosen.targetRegion;
+    }
+    debug.municipalitiesReassigned++;
+    debug.cellsReassigned += changed;
+    state = collectState();
+  }
+  debug.longestRunAfter = state.longRuns[0]?.length || 0;
+  return debug;
+}
+
+
+function copyPathMetadata(from, to) {
+  for (const key of Object.keys(from || {})) if (!/^\d+$/.test(key)) to[key] = from[key];
+  return to;
+}
+
+function sanitizeRiversAgainstFinalWater(world, sourceMap, rects = null) {
+  const sea = world.fields?.sea;
+  const river = world.fields?.river;
+  const targetRect = rects?.writeRect || rects?.repairRect || null;
+  const debug = {
+    riverSeaCellsCleared: 0,
+    riverSeaPathPointsRemoved: 0,
+    riverPathsSplit: 0,
+    localityRestricted: !!targetRect,
+  };
+  if (!sea) return debug;
+  const inTarget = (x, y) => !targetRect || insideRect(x, y, targetRect);
+  if (river && river.length === sea.length) {
+    const x0 = targetRect ? Math.max(0, Math.floor(targetRect.x0)) : 0;
+    const y0 = targetRect ? Math.max(0, Math.floor(targetRect.y0)) : 0;
+    const x1 = targetRect ? Math.min(world.width, Math.ceil(targetRect.x1)) : world.width;
+    const y1 = targetRect ? Math.min(world.height, Math.ceil(targetRect.y1)) : world.height;
+    for (let y = y0; y < y1; y++) {
+      const row = y * world.width;
+      for (let x = x0; x < x1; x++) {
+        const i = row + x;
+        if (sea[i] && river[i] !== 0) {
+          river[i] = 0;
+          debug.riverSeaCellsCleared++;
+        }
+      }
+    }
+  }
+  for (const key of RIVER_LAYER_KEYS) {
+    const next = [];
+    for (const path of sourceMap?.[key] || []) {
+      let chunk = [];
+      let produced = 0;
+      const flush = () => {
+        if (chunk.length >= 2) {
+          const localized = chunk.map(([x, y, ...rest]) => [Math.round(x - world.originX), Math.round(y - world.originY), ...rest]);
+          copyPathMetadata(path, localized);
+          next.push(localized);
+          produced++;
+        }
+        chunk = [];
+      };
+      for (const tuple of path || []) {
+        if (!Array.isArray(tuple) || tuple.length < 2) continue;
+        const wx = Math.round(tupleWorldX(world, tuple));
+        const wy = Math.round(tupleWorldY(world, tuple));
+        const i = worldIndexOf(world, wx, wy);
+        // Patch sanitation is deliberately local. Existing river-mouth/ocean
+        // representation outside the patch must not change merely because an
+        // unrelated area was regenerated elsewhere on the map.
+        if (inTarget(wx, wy) && (i < 0 || sea[i])) {
+          debug.riverSeaPathPointsRemoved++;
+          flush();
+          continue;
+        }
+        chunk.push([wx, wy, ...tuple.slice(2)]);
+      }
+      flush();
+      if (produced > 1) debug.riverPathsSplit += produced - 1;
+    }
+    if (sourceMap) sourceMap[key] = next;
+  }
+  return debug;
+}
+
+function normalizePatchPrefectureCapitals(world, sourceMap) {
+  const cities = Array.isArray(sourceMap?.modernCities) ? sourceMap.modernCities : (sourceMap.modernCities = []);
+  const pref = world.fields?.prefectureRegionId;
+  const sea = world.fields?.sea;
+  const debug = {
+    duplicatePrefectureCapitalsDemoted: 0,
+    prefecturesWithCapitalConflicts: 0,
+    missingPrefectureCapitalsPromoted: 0,
+    fallbackPrefectureCapitalCitiesAdded: 0,
+    activePrefectures: 0,
+  };
+  if (!pref) return debug;
+  const activePrefIds = new Set();
+  for (let i = 0; i < pref.length; i++) {
+    const id = pref[i];
+    if (!sea?.[i] && Number.isFinite(id) && id >= 0) activePrefIds.add(Math.floor(id));
+  }
+  debug.activePrefectures = activePrefIds.size;
+  const capitalLike = (c) => !!(c?.isPrefecturalCapital || c?.isRegionalCapital || /Capital/i.test(String(c?.rank || "")) || /Capital/i.test(String(c?.kind || "")));
+  const prefAtPoint = (p) => {
+    const x = Math.round(pointWorldX(world, p));
+    const y = Math.round(pointWorldY(world, p));
+    const i = worldIndexOf(world, x, y);
+    return i >= 0 && !sea?.[i] && pref[i] >= 0 ? Math.floor(pref[i]) : -1;
+  };
+  const cityScore = (c) => (!c?.patchGenerated ? 2_000_000_000 : 0)
+    + (c?.isPrefecturalCapital ? 1_000_000_000 : 0)
+    + (c?.isRegionalCapital ? 500_000_000 : 0)
+    + Number(c?.population || 0);
+  const byPref = new Map();
+  for (const city of cities) {
+    const id = prefAtPoint(city);
+    if (id < 0 || !activePrefIds.has(id)) continue;
+    const arr = byPref.get(id) || [];
+    arr.push(city);
+    byPref.set(id, arr);
+  }
+
+  // First ensure every live prefecture has at least one city record that can
+  // serve as its capital. Prefer an existing city, then a market, then a
+  // municipal office. Only synthesize a lightweight city record as a last resort.
+  for (const id of [...activePrefIds].sort((a, b) => a - b)) {
+    let prefCities = byPref.get(id) || [];
+    let capitals = prefCities.filter(capitalLike);
+    if (!capitals.length) {
+      let target = prefCities.slice().sort((a, b) => cityScore(b) - cityScore(a))[0] || null;
+      if (!target) {
+        const pools = [sourceMap?.markets || [], sourceMap?.adminCenters || []];
+        for (const pool of pools) {
+          target = pool.filter((p) => prefAtPoint(p) === id)
+            .sort((a, b) => Number(b?.population || b?.municipalityPopulation || 0) - Number(a?.population || a?.municipalityPopulation || 0))[0] || null;
+          if (target) break;
+        }
+        if (target) {
+          target = {
+            ...target,
+            promotedToPatchCapital: true,
+            patchGenerated: target.patchGenerated === true,
+            population: Math.max(42000, Number(target.population || target.municipalityPopulation || 0)),
+            labelPriorityBase: Math.max(900, Number(target.labelPriorityBase || 0)),
+          };
+          cities.push(target);
+          prefCities = [target];
+          byPref.set(id, prefCities);
+          debug.fallbackPrefectureCapitalCitiesAdded++;
+        }
+      }
+      if (!target) {
+        let bestI = -1;
+        let bestScore = -Infinity;
+        for (let i = 0; i < pref.length; i++) {
+          if (sea?.[i] || Math.floor(pref[i]) !== id) continue;
+          const score = Number(world.fields?.populationDensity?.[i] || 0) * 4
+            + Number(world.fields?.habitability?.[i] || 0) * 2
+            - Number(world.fields?.slope?.[i] || 0);
+          if (score > bestScore) { bestScore = score; bestI = i; }
+        }
+        if (bestI >= 0) {
+          const fx = bestI % world.width;
+          const fy = Math.floor(bestI / world.width);
+          target = {
+            x: fx - (world.originX || 0),
+            y: fy - (world.originY || 0),
+            worldX: fx,
+            worldY: fy,
+            name: `県都${id + 1}`,
+            labelName: `県都${id + 1}`,
+            population: 42000,
+            generatedOfficePoint: true,
+            promotedToPatchCapital: true,
+            patchGenerated: true,
+            labelPriorityBase: 900,
+            insidePrefecture: true,
+          };
+          cities.push(target);
+          prefCities = [target];
+          byPref.set(id, prefCities);
+          debug.fallbackPrefectureCapitalCitiesAdded++;
+        }
+      }
+      if (target) {
+        target.isRegionalCapital = true;
+        target.isPrefecturalCapital = true;
+        target.rank = "Prefectural Capital";
+        target.kind = "Prefectural Capital";
+        target.insidePrefecture = true;
+        target.labelPriorityBase = Math.max(1150, Number(target.labelPriorityBase || 0));
+        debug.missingPrefectureCapitalsPromoted++;
+      }
+    }
+  }
+
+  // Then enforce exactly one capital-like city per active prefecture.
+  for (const id of [...activePrefIds].sort((a, b) => a - b)) {
+    const arr = (byPref.get(id) || []).filter(capitalLike);
+    if (arr.length <= 1) continue;
+    debug.prefecturesWithCapitalConflicts++;
+    arr.sort((a, b) => cityScore(b) - cityScore(a));
+    const winner = arr[0];
+    winner.isRegionalCapital = true;
+    winner.isPrefecturalCapital = true;
+    winner.rank = "Prefectural Capital";
+    winner.kind = "Prefectural Capital";
+    winner.insidePrefecture = true;
+    for (const city of arr.slice(1)) {
+      city.isPrefecturalCapital = false;
+      city.isRegionalCapital = false;
+      if (/Capital/i.test(String(city.rank || "")) || /Capital/i.test(String(city.kind || ""))) {
+        const rank = Number(city.population || 0) >= 200000 ? "Regional City" : "Local City";
+        city.rank = rank;
+        city.kind = rank;
+      }
+      debug.duplicatePrefectureCapitalsDemoted++;
+    }
+  }
+  return debug;
+}
+
+function synchronizePatchAdministrativeMetadata(world, sourceMap, seed, { writeMunicipalityField = true } = {}) {
+  const municipalCoherence = reconcileMunicipalMetadata({
+    adminId: world.fields.adminId,
+    municipalityId: writeMunicipalityField ? world.fields.municipalityId : null,
+    prefectureRegionId: world.fields.prefectureRegionId,
+    sea: world.fields.sea,
+    adminCenters: sourceMap.adminCenters || [],
+    municipalityToPrefectureId: sourceMap.municipalityToPrefectureId,
+    fields: world.fields,
+    width: world.width,
+    height: world.height,
+    pointOffsetX: world.originX || 0,
+    pointOffsetY: world.originY || 0,
+    seed,
+  });
+  sourceMap.adminCenters = municipalCoherence.adminCenters;
+  sourceMap.municipalityToPrefectureId = municipalCoherence.municipalityToPrefectureId;
+  const prefectureCoherence = refreshPrefectureRegionsMetadata({
+    prefectureRegionId: world.fields.prefectureRegionId,
+    sea: world.fields.sea,
+    existing: sourceMap.prefectureRegions || [],
+    adminCenters: sourceMap.adminCenters || [],
+    capitalCities: sourceMap.modernCities || [],
+    fields: world.fields,
+    width: world.width,
+    height: world.height,
+    pointOffsetX: world.originX || 0,
+    pointOffsetY: world.originY || 0,
+  });
+  sourceMap.prefectureRegions = prefectureCoherence.prefectureRegions;
+  sourceMap.adminDebug = {
+    ...(sourceMap.adminDebug || {}),
+    municipalCoherence: municipalCoherence.debug,
+    prefectureMetadataCoherence: prefectureCoherence.debug,
+  };
+  return { municipalCoherence, prefectureCoherence };
+}
+
+function repairPatchAdministration(world, sourceMap, rects, seed, adminIdMapping, strictFieldSnapshot, onProgress = null, adminOptions = {}) {
+  const deferStructuralCoherence = adminOptions.deferStructuralCoherence === true;
+  onProgress?.({ status: "start", key: "patch-admin-landuse", label: "Patch administration: land-use cleanup" });
+  const landDebug = repairLanduseAndPopulation(world, rects);
+  onProgress?.({ status: "start", key: "patch-admin-coverage", label: "Patch administration: coverage repair" });
+  const finalAdminCoverageDebug = repairAdminCoverage(world, sourceMap, rects, adminIdMapping, seed);
+  let adminTopologyDebug;
+  let tinyGeneratedPrefectureDebug;
+  let frontierAdministrativeDebug;
+  let axisAlignedPrefectureSeamDebug;
+  if (deferStructuralCoherence) {
+    // Large expansion tiles are implementation details, not independent maps.
+    // Running component cleanup/frontier harmonization on every tile repeatedly
+    // rescans an ever-growing world and can become pathologically expensive.
+    // Keep candidate IDs/coverage coherent locally and perform these structural
+    // operations once over the user's full selection after all tiles are merged.
+    adminTopologyDebug = { deferredForTiledExpansion: true, prefectureTinyComponentsMerged: 0, prefectureTinyCellsMerged: 0, adminTinyComponentsMerged: 0, adminTinyCellsMerged: 0, municipalityCellsSynced: 0 };
+    tinyGeneratedPrefectureDebug = { deferredForTiledExpansion: true, prefecturesMerged: 0, cellsMerged: 0 };
+    frontierAdministrativeDebug = { deferredForTiledExpansion: true, frontierPrefectureCellsAligned: 0, frontierAdminCellsAligned: 0 };
+    axisAlignedPrefectureSeamDebug = { deferredForTiledExpansion: true, runsDetected: 0, municipalitiesReassigned: 0, cellsReassigned: 0 };
+  } else {
+    onProgress?.({ status: "start", key: "patch-admin-topology", label: "Patch administration: topology repair" });
+    adminTopologyDebug = repairPatchAdministrativeTopology(world, rects);
+    onProgress?.({ status: "start", key: "patch-admin-tiny-pref", label: "Patch administration: tiny prefecture merge" });
+    tinyGeneratedPrefectureDebug = mergeTinyGeneratedPrefectures(world, sourceMap, rects, adminIdMapping);
+    onProgress?.({ status: "start", key: "patch-admin-frontier", label: "Patch administration: frontier continuity" });
+    frontierAdministrativeDebug = harmonizeExpansionAdministrativeFrontier(world, rects, seed, strictFieldSnapshot);
+    onProgress?.({ status: "start", key: "patch-admin-axis", label: "Patch administration: seam-shape repair" });
+    axisAlignedPrefectureSeamDebug = repairLongAxisAlignedPrefectureSeams(world, sourceMap, rects, adminIdMapping);
+  }
+  onProgress?.({ status: "start", key: "patch-admin-strict", label: "Patch administration: strict-mask restore" });
+  const strictMaskDebugPreCoherence = restoreOutsideStrictSelectionFields(world, rects, strictFieldSnapshot, seed);
+  onProgress?.({ status: "start", key: "patch-admin-metadata", label: "Patch administration: metadata update" });
+  const sourceAdminMetadataUpdated = updateSourceAdminMetadata(sourceMap, adminIdMapping);
+  let municipalCoherence;
+  let prefectureCoherence;
+  if (adminOptions.deferMetadataCoherence === true) {
+    municipalCoherence = {
+      adminCenters: sourceMap.adminCenters || [],
+      municipalityToPrefectureId: sourceMap.municipalityToPrefectureId || [],
+      debug: { deferredForTiledExpansion: true },
+    };
+    prefectureCoherence = {
+      prefectureRegions: sourceMap.prefectureRegions || [],
+      debug: { deferredForTiledExpansion: true },
+    };
+  } else {
+    onProgress?.({ status: "start", key: "patch-admin-coherence", label: "Patch administration: metadata coherence" });
+    ({ municipalCoherence, prefectureCoherence } = synchronizePatchAdministrativeMetadata(world, sourceMap, seed, { writeMunicipalityField: true }));
+  }
+  // A final strict restore and metadata synchronization runs after all terrain
+  // post-processing. Restoring here after coherence previously left center
+  // metadata referring to prefecture IDs that had just been reverted.
+  const strictMaskDebugPostCoherence = { strictMaskCellsRestored: 0, strictMaskValuesRestored: 0 };
+  return {
+    landDebug,
+    finalAdminCoverageDebug,
+    adminTopologyDebug,
+    tinyGeneratedPrefectureDebug,
+    frontierAdministrativeDebug,
+    axisAlignedPrefectureSeamDebug,
+    strictMaskDebugPreCoherence,
+    strictMaskDebugPostCoherence,
+    sourceAdminMetadataUpdated,
+    municipalCoherence,
+    prefectureCoherence,
+  };
+}
+
+function repairPatchTransport(world, sourceMap, candidate, rects, window, seed, portalContract = null, transportOptions = {}) {
+  return mergePathLayers(world, sourceMap, candidate, rects, window, seed, portalContract, transportOptions);
+}
+
+
+function clipPolygonToRect(polygon, rect) {
+  if (!Array.isArray(polygon) || polygon.length < 3 || !rect) return [];
+  const bounds = [
+    { axis: "x", value: rect.x0, keepGreater: true },
+    { axis: "x", value: rect.x1 - 1, keepGreater: false },
+    { axis: "y", value: rect.y0, keepGreater: true },
+    { axis: "y", value: rect.y1 - 1, keepGreater: false },
+  ];
+  let out = polygon.map((p) => ({ x: Number(p.x), y: Number(p.y) }));
+  const inside = (p, edge) => edge.keepGreater ? p[edge.axis] >= edge.value : p[edge.axis] <= edge.value;
+  const intersect = (a, b, edge) => {
+    const axis = edge.axis;
+    const other = axis === "x" ? "y" : "x";
+    const delta = b[axis] - a[axis];
+    const t = Math.abs(delta) < 1e-9 ? 0 : (edge.value - a[axis]) / delta;
+    return { [axis]: edge.value, [other]: a[other] + (b[other] - a[other]) * clamp(t) };
+  };
+  for (const edge of bounds) {
+    if (!out.length) break;
+    const input = out;
+    out = [];
+    let previous = input[input.length - 1];
+    let previousInside = inside(previous, edge);
+    for (const current of input) {
+      const currentInside = inside(current, edge);
+      if (currentInside !== previousInside) out.push(intersect(previous, current, edge));
+      if (currentInside) out.push(current);
+      previous = current;
+      previousInside = currentInside;
+    }
+  }
+  const cleaned = [];
+  for (const p of out) {
+    const q = { x: Math.round(p.x * 1000) / 1000, y: Math.round(p.y * 1000) / 1000 };
+    const prev = cleaned[cleaned.length - 1];
+    if (!prev || Math.abs(prev.x - q.x) > 1e-6 || Math.abs(prev.y - q.y) > 1e-6) cleaned.push(q);
+  }
+  if (cleaned.length > 2) {
+    const first = cleaned[0], last = cleaned[cleaned.length - 1];
+    if (Math.abs(first.x - last.x) <= 1e-6 && Math.abs(first.y - last.y) <= 1e-6) cleaned.pop();
+  }
+  return cleaned.length >= 3 && polygonAreaCells(cleaned) >= 0.5 ? cleaned : [];
+}
+
+function expansionTileAxis(start, end, maxSize, overlap = PATCH_EXPANSION_TILE_OVERLAP) {
+  const length = Math.max(0, end - start);
+  if (length <= maxSize) return [{ start, end }];
+  const preferredOverlap = Math.max(0, Math.min(overlap, maxSize - 1));
+  const minimumOverlap = Math.min(preferredOverlap, Math.max(1, Math.min(PATCH_EXPANSION_TILE_MIN_OVERLAP, maxSize - 1)));
+
+  // Choose the smallest tile count that can cover the axis while retaining a
+  // safe minimum overlap. With a rigid 28-cell overlap, 338 -> 339 cells used
+  // to jump from 2 to 3 rows even though two 183-cell candidates can cover 339
+  // cells with a 27-cell overlap. That discontinuity multiplied generation work
+  // and exposed internal seam gates.
+  let count = 2;
+  while (length > count * maxSize - (count - 1) * minimumOverlap) count++;
+
+  const maxOverlapForCount = Math.floor((count * maxSize - length) / Math.max(1, count - 1));
+  const safeOverlap = Math.max(minimumOverlap, Math.min(preferredOverlap, maxOverlapForCount));
+  const tileSize = Math.min(maxSize, Math.ceil((length + safeOverlap * (count - 1)) / count));
+  const travel = Math.max(0, length - tileSize);
+  const out = [];
+  for (let i = 0; i < count; i++) {
+    const pos = count === 1 ? 0 : Math.round((travel * i) / (count - 1));
+    const tileStart = start + pos;
+    out.push({ start: tileStart, end: Math.min(end, tileStart + tileSize) });
+  }
+  return out.filter((item, index) => index === 0 || item.start !== out[index - 1].start);
+}
+
+function buildLargeExpansionTiles(selection, world) {
+  const normalized = normalizeSelectionShape(selection, world);
+  if (!normalized) return [];
+
+  const coreW = PATCH_EXPANSION_TILE_MAX_WIDTH;
+  const coreH = PATCH_EXPANSION_TILE_MAX_HEIGHT;
+  const originX = Math.round(world?.originX || 0);
+  const originY = Math.round(world?.originY || 0);
+  const minGridX = Math.floor((normalized.x0 - originX) / coreW);
+  const maxGridX = Math.floor((normalized.x1 - 1 - originX) / coreW);
+  const minGridY = Math.floor((normalized.y0 - originY) / coreH);
+  const maxGridY = Math.floor((normalized.y1 - 1 - originY) / coreH);
+  const tiles = [];
+
+  function canonicalCandidateWindow(coreRect) {
+    const cx = (coreRect.x0 + coreRect.x1 - 1) / 2;
+    const cy = (coreRect.y0 + coreRect.y1 - 1) / 2;
+    return {
+      worldCenterX: cx,
+      worldCenterY: cy,
+      sourceCenterX: (MAP_W - 1) / 2,
+      sourceCenterY: (MAP_H - 1) / 2,
+      originX: Math.round(cx - (MAP_W - 1) / 2),
+      originY: Math.round(cy - (MAP_H - 1) / 2),
+      width: MAP_W,
+      height: MAP_H,
+      variable: false,
+      canonicalWorldGrid: true,
+    };
+  }
+
+  for (let gy = minGridY; gy <= maxGridY; gy++) {
+    for (let gx = minGridX; gx <= maxGridX; gx++) {
+      const coreRect = {
+        x0: originX + gx * coreW,
+        y0: originY + gy * coreH,
+        x1: originX + (gx + 1) * coreW,
+        y1: originY + (gy + 1) * coreH,
+      };
+      let tile = null;
+      if (isPolygonSelection(normalized)) {
+        const polygon = clipPolygonToRect(normalized.polygon, coreRect);
+        if (polygon.length >= 3) {
+          const bounds = polygonBounds(polygon);
+          if (bounds && polygonAreaCells(polygon) >= 0.5) {
+            tile = {
+              kind: normalized.kind || "lasso",
+              polygon,
+              areaCells: Math.max(1, Math.round(polygonAreaCells(polygon))),
+              ...bounds,
+            };
+          }
+        }
+      } else {
+        const x0 = Math.max(normalized.x0, coreRect.x0);
+        const y0 = Math.max(normalized.y0, coreRect.y0);
+        const x1 = Math.min(normalized.x1, coreRect.x1);
+        const y1 = Math.min(normalized.y1, coreRect.y1);
+        if (x1 > x0 && y1 > y0) tile = { x0, y0, x1, y1 };
+      }
+      if (!tile) continue;
+      tile._canonicalGridX = gx;
+      tile._canonicalGridY = gy;
+      tile._canonicalCoreRect = coreRect;
+      tile._candidateWindowOverride = canonicalCandidateWindow(coreRect);
+      tiles.push(tile);
+    }
+  }
+  return tiles;
+}
+
+function aggregateTiledExpansionResult(world, selection, options, tileResults, aggregateRects, startedAt, finalSeamDiagnostics = null, aggregateTransportRepair = null) {
+  const seamReasons = finalSeamDiagnostics
+    ? [...new Set(finalSeamDiagnostics.gateReasons || [])]
+    : [...new Set(tileResults.flatMap((r) => r?.seamDiagnostics?.gateReasons || []))];
+  const hardPass = finalSeamDiagnostics
+    ? finalSeamDiagnostics.hardPass !== false
+    : tileResults.every((r) => r?.seamDiagnostics?.hardPass !== false);
+  const softQualityPass = tileResults.every((r) => r?.candidateQuality?.hardPass !== false);
+  const qualityAcceptedAsBestAvailable = tileResults.some((r) => r?.qualityAcceptedAsBestAvailable === true || r?.candidateQuality?.acceptedAsBestAvailable === true);
+  const scores = tileResults.map((r) => Number(r?.candidateQuality?.score)).filter(Number.isFinite);
+  const candidateQuality = {
+    policyVersion: PATCH_QUALITY_POLICY_VERSION,
+    tiledExpansion: true,
+    tileCount: tileResults.length,
+    hardPass: softQualityPass && hardPass,
+    acceptedAsBestAvailable: qualityAcceptedAsBestAvailable,
+    selectedVariant: Number.isFinite(options.variant) ? options.variant >>> 0 : 0,
+    requestedTerrainAttempts: Number.isFinite(options.qualityTerrainAttempts) ? Math.max(1, Math.floor(options.qualityTerrainAttempts)) : 1,
+    exactRequestedVariant: true,
+    score: scores.length ? scores.reduce((a, b) => a + b, 0) / scores.length : 0,
+    tiles: tileResults.map((r, index) => ({
+      index,
+      hardPass: r?.candidateQuality?.hardPass !== false,
+      acceptedAsBestAvailable: r?.qualityAcceptedAsBestAvailable === true || r?.candidateQuality?.acceptedAsBestAvailable === true,
+      score: Number(r?.candidateQuality?.score || 0),
+      variant: r?.variant ?? options.variant ?? 0,
+    })),
+  };
+  const maxFrontierJump = Math.max(0, ...tileResults.map((r) => Number(r?.seamDiagnostics?.maxEstablishedFrontierElevationJump || 0)));
+  const seamDiagnostics = {
+    ...(finalSeamDiagnostics || {}),
+    status: hardPass ? "clean" : "warning",
+    hardPass,
+    gateReasons: seamReasons,
+    tiledExpansion: true,
+    tileCount: tileResults.length,
+    finalWholeSelectionAudit: !!finalSeamDiagnostics,
+    aggregateTransportRepair: aggregateTransportRepair || null,
+    maxEstablishedFrontierElevationJump: finalSeamDiagnostics
+      ? Number(finalSeamDiagnostics.maxEstablishedFrontierElevationJump || 0)
+      : maxFrontierJump,
+    qualityHardPass: candidateQuality.hardPass,
+    qualityScore: candidateQuality.score,
+    qualitySelectedVariant: candidateQuality.selectedVariant,
+    tiles: tileResults.map((r, index) => ({
+      index,
+      status: r?.seamDiagnostics?.status || "-",
+      hardPass: r?.seamDiagnostics?.hardPass !== false,
+      gateReasons: r?.seamDiagnostics?.gateReasons || [],
+      maxEstablishedFrontierElevationJump: Number(r?.seamDiagnostics?.maxEstablishedFrontierElevationJump || 0),
+    })),
+  };
+  const patchTimings = tileResults.flatMap((r, index) => (r?.patchTimings || []).map((entry) => ({
+    ...entry,
+    key: `tile-${index + 1}:${entry.key}`,
+    label: `Tile ${index + 1}: ${entry.label || entry.key}`,
+  })));
+  patchTimings.push({ key: "tiled-total", label: "Large expansion total", ms: Math.round((nowMs() - startedAt) * 10) / 10 });
+  const result = {
+    ok: true,
+    validation: { ok: true, rect: selection, width: rectWidth(selection), height: rectHeight(selection), area: selection.areaCells || rectArea(selection), reason: "" },
+    rects: aggregateRects,
+    terrainType: tileResults[0]?.terrainType || options.terrainType || "auto",
+    label: `Large expansion (${tileResults.length} tiles)`,
+    seed: Number.isFinite(options.seed) ? options.seed >>> 0 : (world?.seed || 0) >>> 0,
+    variant: Number.isFinite(options.variant) ? options.variant >>> 0 : 0,
+    patchMode: PATCH_MODE_EXPANSION,
+    patchModeRequested: options.patchMode || PATCH_MODE_AUTO,
+    patchModeAutoDetected: String(options.patchMode || PATCH_MODE_AUTO).toLowerCase() === PATCH_MODE_AUTO,
+    coverageStats: { ...(aggregateRects.coverageStats || {}) },
+    productionPipelineParity: true,
+    candidateQuality,
+    qualityAcceptedAsBestAvailable,
+    patchGenerationMode: "unified-world-native-patch-tiled",
+    tiledExpansion: true,
+    tileCount: tileResults.length,
+    seamDiagnostics,
+    patchTimings,
+    updatedCells: tileResults.reduce((sum, r) => sum + Number(r?.updatedCells || 0), 0),
+    terrainCellsFullyReplaced: tileResults.reduce((sum, r) => sum + Number(r?.terrainCellsFullyReplaced || 0), 0),
+    coastCellsChanged: tileResults.reduce((sum, r) => sum + Number(r?.coastCellsChanged || 0), 0),
+    naturalRegionsUpdated: tileResults.reduce((sum, r) => sum + Number(r?.naturalRegionsUpdated || 0), 0),
+    humanGeography: {
+      ok: true,
+      tiledExpansion: true,
+      tileCount: tileResults.length,
+      qualityAcceptedAsBestAvailable,
+      seamDiagnostics,
+      tileResults: tileResults.map((r, index) => ({
+        index,
+        patchGenerationMode: r?.patchGenerationMode,
+        candidateQuality: r?.candidateQuality || null,
+        seamDiagnostics: r?.seamDiagnostics || null,
+      })),
+    },
+  };
+  world.lastPatchResult = {
+    ...result,
+    createdAt: Date.now(),
+  };
+  return result;
+}
+
+function generateTiledExpansionPatch(world, selection, options, modeResolution) {
+  const tiles = buildLargeExpansionTiles(selection, world);
+  if (!tiles.length) return null;
+  const transaction = capturePatchTransactionSnapshot(world);
+  const aggregateSourceRects = buildPatchRects(selection, world, { ...options, modeResolution });
+  // Synchronous/API callers receive the same atomic rollback guarantee as a
+  // normal patch. Browser preview workers can skip this large duplicate field
+  // snapshot because a failed worker-owned preview world is discarded wholesale.
+  if (!options._workerOwnedPreview) {
+    preparePatchTransactionFields(transaction, world, aggregateSourceRects.transportReachRect || aggregateSourceRects.repairRect || aggregateSourceRects.writeRect);
+  }
+  const aggregateRects = {
+    coreRect: { ...aggregateSourceRects.coreRect },
+    writeRect: { ...aggregateSourceRects.writeRect },
+    repairRect: { ...aggregateSourceRects.repairRect },
+    contextRect: { ...aggregateSourceRects.contextRect },
+    transportReachRect: { ...aggregateSourceRects.transportReachRect },
+    blendRect: { ...aggregateSourceRects.blendRect },
+    selectionShape: aggregateSourceRects.selectionShape ? {
+      kind: aggregateSourceRects.selectionShape.kind || "lasso",
+      areaCells: aggregateSourceRects.selectionShape.areaCells || 0,
+      polygon: aggregateSourceRects.selectionShape.polygon.map((p) => ({ x: p.x, y: p.y })),
+    } : null,
+    coverageStats: { ...(aggregateSourceRects.coverageStats || {}) },
+    patchMode: PATCH_MODE_EXPANSION,
+  };
+  const aggregateSeed = Number.isFinite(options.seed) ? options.seed >>> 0 : (world?.seed || 0) >>> 0;
+  const aggregateSeaLevel = resolveWorldSeaLevel(world);
+  const aggregateTerrainContract = buildTerrainBoundaryContract(
+    world, transaction.sourceMap || world.sourceMap || {}, aggregateSourceRects, aggregateSeed, aggregateSeaLevel
+  );
+  const aggregateStrictFieldSnapshot = captureStrictSelectionFieldSnapshot(world, aggregateSourceRects, aggregateSeed);
+  // Every internal tile must classify old/new cells from the same pre-operation
+  // world. Otherwise tile N treats cells created by tile N-1 as established
+  // geography, making the result depend on tile order and selection size.
+  const aggregateGeneratedCoverageBaseline = buildGeneratedCoverageSnapshot(
+    world,
+    expandRect(
+      aggregateSourceRects.writeRect,
+      Math.max(PATCH_TERRAIN_CONTINUATION_DEPTH + 2, (aggregateSourceRects.expansionOverlap || 0) + 2),
+      world
+    )
+  );
+  const aggregateAdminIdMapping = {
+    allocatedPrefectureIds: new Set(),
+    allocatedMunicipalityIds: new Set(),
+  };
+  // Capture the user-visible outer seam once, before any internal tile mutates
+  // roads/rails. Internal tile portal checks are deferred and this snapshot is
+  // the authoritative contract applied after every tile has been merged.
+  const aggregateSeamSnapshot = capturePatchSeamSnapshot(
+    world,
+    transaction.sourceMap || world.sourceMap || {},
+    aggregateSourceRects,
+    aggregateSeed,
+    transaction.sourceMap || world.sourceMap || {}
+  );
+  const pending = tiles.map((tile, index) => ({ tile, index }));
+  const results = [];
+  const startedAt = nowMs();
+  try {
+    while (pending.length) {
+      // Prefer a tile already touching generated geography.  The overlap then
+      // propagates the established frontier outward instead of creating a remote
+      // island first and trying to connect it later.
+      pending.sort((a, b) => {
+        const ac = selectionCoverageStats(world, a.tile);
+        const bc = selectionCoverageStats(world, b.tile);
+        return bc.generatedCells - ac.generatedCells || bc.generatedCells / Math.max(1, bc.selectedCells) - ac.generatedCells / Math.max(1, ac.selectedCells) || a.index - b.index;
+      });
+      const { tile, index } = pending.shift();
+      const ordinal = results.length + 1;
+      options.onProgress?.({
+        status: "start",
+        key: `large-tile-${ordinal}`,
+        label: `Large expansion tile ${ordinal}/${tiles.length}`,
+        tileIndex: index,
+        tileCount: tiles.length,
+        tileRect: { x0: tile.x0, y0: tile.y0, x1: tile.x1, y1: tile.y1 },
+      });
+      const tileResult = generatePatch(world, tile, {
+        ...options,
+        patchMode: PATCH_MODE_EXPANSION,
+        _skipExpansionTiling: true,
+        _internalTile: true,
+        _parentAtomicRollback: true,
+        maxQualityRetries: 0,
+        qualityTerrainAttempts: Number.isFinite(options.qualityTerrainAttempts) ? options.qualityTerrainAttempts : 1,
+        // Per-tile human-geography floors are not meaningful for a subdivided
+        // large selection. Keep the best soft-quality tile and reserve rollback
+        // for hard seam failures; aggregate quality is reported on the result.
+        acceptBestAvailableQuality: true,
+        _seamBaselineSourceMap: transaction.sourceMap,
+        _deferTransportSeamGate: true,
+        _deferTransportGraphRepair: true,
+        _deferAdministrativeMetadataCoherence: true,
+        _deferAdministrativeStructuralCoherence: true,
+        _deferGlobalBoundaryRebuild: true,
+        _deferTerrainCoherence: true,
+        _deferInternalSeamGate: true,
+        _generatedCoverageBaseline: aggregateGeneratedCoverageBaseline,
+        _candidateWindowOverride: tile._candidateWindowOverride,
+        onProgress: (event) => options.onProgress?.({
+          ...event,
+          key: `large-tile-${ordinal}:${event?.key || "generation"}`,
+          label: `Tile ${ordinal}/${tiles.length}: ${event?.label || "generation"}`,
+          tileIndex: index,
+          tileCount: tiles.length,
+        }),
+      });
+      if (!tileResult?.ok) {
+        restorePatchTransactionSnapshot(world, transaction);
+        return {
+          ok: false,
+          code: "patch-large-tile-failed",
+          reason: `Large expansion tile ${ordinal}/${tiles.length} failed: ${tileResult?.reason || tileResult?.code || "unknown failure"}`,
+          rolledBack: true,
+          failedTileIndex: index,
+          tileCount: tiles.length,
+          tileResult: tileResult || null,
+        };
+      }
+      for (const id of tileResult?._internalAdminAllocation?.prefectureIds || []) aggregateAdminIdMapping.allocatedPrefectureIds.add(id);
+      for (const id of tileResult?._internalAdminAllocation?.municipalityIds || []) aggregateAdminIdMapping.allocatedMunicipalityIds.add(id);
+      results.push(tileResult);
+    }
+
+    // Repair and audit only the true outer seam after all internal tiles have
+    // settled. This avoids rolling back the entire operation because of a
+    // temporary internal-tile road portal, while still refusing to publish a
+    // genuinely broken pre-existing road/rail crossing at the user's boundary.
+    const sourceMap = world.sourceMap || (world.sourceMap = {});
+    options.onProgress?.({ status: "start", key: "large-final-terrain-coherence", label: "Large expansion: final terrain and coastline coherence" });
+    const aggregateTerrainDebug = repairPatchTerrain(
+      world, aggregateSourceRects, aggregateSeed, aggregateSeaLevel, aggregateTerrainContract, options.onProgress
+    );
+    const aggregateFinalElevationSeamDebug = finalizeExpansionElevationSeam(world, aggregateSourceRects, aggregateSeed, aggregateSeaLevel);
+    const aggregateEstablishedFrontierDebug = enforceEstablishedFrontierElevationContinuity(
+      world, aggregateSourceRects, aggregateSeed, aggregateSeaLevel, { depth: 12, frontierLimit: 0.052, gradientLimit: 0.070 }
+    );
+    if ((aggregateFinalElevationSeamDebug.finalSeamElevationCellsAdjusted || 0) > 0
+      || (aggregateEstablishedFrontierDebug.establishedFrontierElevationCellsAdjusted || 0) > 0
+      || (aggregateEstablishedFrontierDebug.establishedFrontierGradientCellsAdjusted || 0) > 0) {
+      repairDisplayMasks(world, aggregateSourceRects, aggregateSeed);
+      recomputeSlopeAndWaterDependentFields(world, aggregateSourceRects.repairRect, aggregateSeaLevel);
+    }
+    options.onProgress?.({ status: "start", key: "large-final-admin-structure", label: "Large expansion: final administrative topology" });
+    const aggregateAdministrativeRepair = repairPatchAdministration(
+      world,
+      sourceMap,
+      aggregateSourceRects,
+      aggregateSeed,
+      aggregateAdminIdMapping,
+      aggregateStrictFieldSnapshot,
+      options.onProgress,
+      { deferMetadataCoherence: true, deferStructuralCoherence: false }
+    );
+    options.onProgress?.({ status: "start", key: "large-final-admin-coherence", label: "Large expansion: final administrative coherence" });
+    const aggregateAdministrativeMetadata = synchronizePatchAdministrativeMetadata(world, sourceMap, aggregateSeed, { writeMunicipalityField: true });
+    const aggregateCapitalCoherence = normalizePatchPrefectureCapitals(world, sourceMap);
+    const aggregateAdministrativeMetadataAfterCapitals = synchronizePatchAdministrativeMetadata(world, sourceMap, aggregateSeed, { writeMunicipalityField: false });
+    const aggregateRiverWaterCoherence = sanitizeRiversAgainstFinalWater(world, sourceMap, aggregateSourceRects);
+    const aggregateSegmentDebug = mergeSegmentLayers(world, sourceMap, aggregateSourceRects, aggregateSeed, null, null);
+    const aggregateGraphRect = aggregateSourceRects.transportReachRect || aggregateSourceRects.repairRect || aggregateSourceRects.writeRect;
+    const roadRepair = repairMandatoryTransportPortals(
+      world, sourceMap, aggregateSourceRects, aggregateSeed, aggregateSeamSnapshot.roadPortals || [], "road", aggregateGraphRect
+    );
+    const railRepair = repairMandatoryTransportPortals(
+      world, sourceMap, aggregateSourceRects, aggregateSeed, aggregateSeamSnapshot.railPortals || [], "rail", aggregateGraphRect
+    );
+    const aggregateTransportRepair = {
+      road: roadRepair,
+      rail: railRepair,
+      administrativeMetadata: {
+        structuralRepair: aggregateAdministrativeRepair,
+        municipal: aggregateAdministrativeMetadata.municipalCoherence?.debug || null,
+        prefecture: aggregateAdministrativeMetadata.prefectureCoherence?.debug || null,
+        capitals: aggregateCapitalCoherence,
+      },
+      riverWaterCoherence: aggregateRiverWaterCoherence,
+      terrain: {
+        repair: aggregateTerrainDebug,
+        finalElevationSeam: aggregateFinalElevationSeamDebug,
+        establishedFrontier: aggregateEstablishedFrontierDebug,
+      },
+      segments: aggregateSegmentDebug,
+    };
+    if ((roadRepair.connectorsAdded || 0) > 0 || (railRepair.connectorsAdded || 0) > 0) {
+      refreshPatchInfluenceFields(world, sourceMap, aggregateSourceRects);
+    }
+
+    const finalSeamDiagnostics = analyzePatchSeam(
+      world, sourceMap, aggregateSourceRects, aggregateSeed, aggregateSeamSnapshot,
+      { width: rectWidth(selection), height: rectHeight(selection), areaRatio: 1 },
+      "expansion-tiled-production", options.includeSeamVisualization === true
+    );
+    const finalSeamGate = evaluateSeamQualityGate(finalSeamDiagnostics);
+    if (finalSeamDiagnostics) {
+      finalSeamDiagnostics.hardPass = finalSeamGate.hardPass;
+      finalSeamDiagnostics.gateReasons = finalSeamGate.reasons;
+      finalSeamDiagnostics.gateBudgets = finalSeamGate.budgets;
+      finalSeamDiagnostics.aggregateTransportRepair = aggregateTransportRepair;
+    }
+    if (!finalSeamGate.hardPass) {
+      restorePatchTransactionSnapshot(world, transaction);
+      return {
+        ok: false,
+        code: "patch-large-final-seam-failed",
+        reason: `Large expansion failed final whole-selection seam continuity (${finalSeamGate.reasons.join(", ") || "unknown seam failure"}); world changes were rolled back.`,
+        rolledBack: true,
+        tileCount: tiles.length,
+        seamDiagnostics: finalSeamDiagnostics,
+        aggregateTransportRepair,
+      };
+    }
+    const aggregated = aggregateTiledExpansionResult(
+      world, selection, options, results, aggregateRects, startedAt, finalSeamDiagnostics, aggregateTransportRepair
+    );
+    // Per-tile human-quality floors are implementation details. A thin or edge
+    // fragment can legitimately contain no town even when the assembled patch
+    // has healthy human geography. Re-evaluate quality once over the final
+    // user selection and use that whole-selection result as the authoritative
+    // soft gate.
+    const qualityBasis = {
+      terrain: { terrainType: results.find((r) => r?.candidateQuality?.terrain?.terrainType)?.candidateQuality?.terrain?.terrainType || "auto" },
+      human: {
+        minLabels: results.reduce((sum, r) => sum + Math.max(0, Number(r?.candidateQuality?.human?.minLabels || 0)), 0),
+        minSettlements: results.reduce((sum, r) => sum + Math.max(0, Number(r?.candidateQuality?.human?.minSettlements || 0)), 0),
+      },
+    };
+    const finalMergeQuality = evaluateFinalExpansionQuality(world, sourceMap, aggregateSourceRects, aggregateSeed, qualityBasis);
+    if (finalMergeQuality) {
+      aggregated.candidateQuality = {
+        ...(aggregated.candidateQuality || {}),
+        hardPass: finalMergeQuality.hardPass && aggregated.seamDiagnostics?.hardPass !== false,
+        finalMerge: finalMergeQuality,
+        qualityAuthority: "whole-selection-post-merge",
+      };
+      if (aggregated.humanGeography) aggregated.humanGeography.candidateQuality = aggregated.candidateQuality;
+      if (world.lastPatchResult) world.lastPatchResult.candidateQuality = aggregated.candidateQuality;
+    }
+    if (aggregated?.candidateQuality?.hardPass === false && options.acceptBestAvailableQuality !== true) {
+      restorePatchTransactionSnapshot(world, transaction);
+      return {
+        ok: false,
+        code: "patch-quality-gate-failed",
+        reason: "Canonical tiled expansion did not satisfy the aggregate terrain/human-geography quality gate; world changes were rolled back.",
+        rolledBack: true,
+        patchMode: PATCH_MODE_EXPANSION,
+        candidateQuality: aggregated.candidateQuality,
+        seamDiagnostics: aggregated.seamDiagnostics,
+        tileCount: tiles.length,
+      };
+    }
+    return aggregated;
+  } catch (error) {
+    restorePatchTransactionSnapshot(world, transaction);
+    throw error;
+  }
+}
+
+export function generatePatch(world, userRectInput, options = {}) {
+  if (!options._skipExpansionTiling) {
+    const largeValidation = validatePatchRect(userRectInput, world);
+    if (largeValidation.ok) {
+      const modeResolution = resolvePatchMode(largeValidation.rect, world, options.patchMode);
+      if (modeResolution.mode === PATCH_MODE_EXPANSION) {
+        const baseVariant = Number.isFinite(options.variant) ? Math.max(0, Math.floor(options.variant)) >>> 0 : 0;
+        const maxQualityRetries = Math.max(0, Math.min(2, Math.floor(options.maxQualityRetries ?? 1)));
+        let lastTiled = null;
+        for (let qualityAttempt = 0; qualityAttempt <= maxQualityRetries; qualityAttempt++) {
+          const attemptVariant = (baseVariant + qualityAttempt * PATCH_TERRAIN_QUALITY_ATTEMPTS) >>> 0;
+          const tiled = generateTiledExpansionPatch(world, largeValidation.rect, { ...options, variant: attemptVariant }, modeResolution);
+          if (!tiled) break;
+          if (tiled.ok) {
+            tiled.qualityRetryCount = qualityAttempt;
+            if (tiled.humanGeography) tiled.humanGeography.qualityRetryCount = qualityAttempt;
+            if (world.lastPatchResult) world.lastPatchResult.qualityRetryCount = qualityAttempt;
+            return tiled;
+          }
+          lastTiled = tiled;
+          if (tiled.code !== "patch-quality-gate-failed" || qualityAttempt >= maxQualityRetries) return tiled;
+        }
+        if (lastTiled) return lastTiled;
+      }
+    }
+  }
+  const baseVariant = Number.isFinite(options.variant) ? Math.max(0, Math.floor(options.variant)) >>> 0 : 0;
+  const maxQualityRetries = Math.max(0, Math.min(2, Math.floor(options.maxQualityRetries ?? 1)));
+  const acceptBestAvailableQuality = options.acceptBestAvailableQuality === true;
+  let lastRejected = null;
+  for (let qualityAttempt = 0; qualityAttempt <= maxQualityRetries; qualityAttempt++) {
+    options.onProgress?.({
+      status: "start",
+      key: `quality-attempt-${qualityAttempt}`,
+      label: `Patch quality attempt ${qualityAttempt + 1}/${maxQualityRetries + 1}`,
+      qualityAttempt,
+    });
+    const transaction = capturePatchTransactionSnapshot(world, {
+      lightweight: options._internalTile === true && options._parentAtomicRollback === true,
+    });
+    const attemptVariant = (baseVariant + qualityAttempt * PATCH_TERRAIN_QUALITY_ATTEMPTS) >>> 0;
+    let result;
+    try {
+      result = generatePatchAttempt(world, userRectInput, {
+        ...options,
+        variant: attemptVariant,
+        _qualityAttempt: qualityAttempt,
+        _transactionSnapshot: transaction,
+      });
+    } catch (error) {
+      restorePatchTransactionSnapshot(world, transaction);
+      throw error;
+    }
+    const rejectedByQuality = result?.ok
+      && result.patchMode === PATCH_MODE_EXPANSION
+      && ((result.candidateQuality && result.candidateQuality.hardPass === false)
+        || result.seamDiagnostics?.hardPass === false);
+    if (!rejectedByQuality) {
+      if (result?.ok) {
+        result.qualityRetryCount = qualityAttempt;
+        if (result.humanGeography) result.humanGeography.qualityRetryCount = qualityAttempt;
+        if (world.lastPatchResult) world.lastPatchResult.qualityRetryCount = qualityAttempt;
+      }
+      return result;
+    }
+    lastRejected = result;
+    const seamHardFailed = result?.seamDiagnostics?.hardPass === false;
+    if (acceptBestAvailableQuality && !seamHardFailed && qualityAttempt >= maxQualityRetries) {
+      // Interactive previews may keep a candidate that only misses a soft
+      // terrain/human-geography quality floor. A hard seam failure is different:
+      // displaying it would reintroduce the visible generation-boundary defect,
+      // so those candidates are always rolled back even in preview mode.
+      result.qualityRetryCount = qualityAttempt;
+      result.qualityAcceptedAsBestAvailable = true;
+      if (result.candidateQuality) result.candidateQuality.acceptedAsBestAvailable = true;
+      if (result.humanGeography) {
+        result.humanGeography.qualityRetryCount = qualityAttempt;
+        result.humanGeography.qualityAcceptedAsBestAvailable = true;
+      }
+      if (world.lastPatchResult) {
+        world.lastPatchResult.qualityRetryCount = qualityAttempt;
+        world.lastPatchResult.qualityAcceptedAsBestAvailable = true;
+        if (world.lastPatchResult.candidateQuality) world.lastPatchResult.candidateQuality.acceptedAsBestAvailable = true;
+      }
+      return result;
+    }
+    restorePatchTransactionSnapshot(world, transaction);
+  }
+  const seamRejected = lastRejected?.seamDiagnostics?.hardPass === false;
+  return {
+    ok: false,
+    code: seamRejected ? "patch-seam-gate-failed" : "patch-quality-gate-failed",
+    reason: seamRejected
+      ? `Expansion candidate failed seam continuity (${(lastRejected?.seamDiagnostics?.gateReasons || []).join(", ") || "unknown seam failure"}); world changes were rolled back.`
+      : "Expansion candidate did not satisfy the final land and human-geography quality gate; world changes were rolled back.",
+    rolledBack: true,
+    qualityAttempts: maxQualityRetries + 1,
+    patchMode: lastRejected?.patchMode || PATCH_MODE_EXPANSION,
+    candidateQuality: lastRejected?.candidateQuality || null,
+    seamDiagnostics: lastRejected?.seamDiagnostics || null,
+    rects: lastRejected?.rects || null,
+  };
+}
+
+function generatePatchAttempt(world, userRectInput, options = {}) {
+  const validation = validatePatchRect(userRectInput, world, { allowSmall: options._internalTile === true });
+  if (!validation.ok) return { ok: false, ...validation };
+
+  const modeResolution = resolvePatchMode(validation.rect, world, options.patchMode);
+  const rects = buildPatchRects(validation.rect, world, { ...options, modeResolution });
+  preparePatchTransactionFields(options._transactionSnapshot, world, rects.transportReachRect || rects.repairRect || rects.writeRect);
+  const terrainType = options.terrainType || "auto";
+  const seed = Number.isFinite(options.seed) ? options.seed >>> 0 : ((world?.seed || 0) + 1013904223) >>> 0;
+  const seaLevel = resolveWorldSeaLevel(world);
+  const strictFieldSnapshot = captureStrictSelectionFieldSnapshot(world, rects, seed);
+  const variant = Number.isFinite(options.variant) ? Math.max(0, Math.floor(options.variant)) >>> 0 : 0;
+  const candidateWindow = buildPatchCandidateWindow(rects, world, options);
+  rects.candidateWindow = candidateWindow;
+  const candidateArrayOriginX = Math.round(candidateWindow.originX ?? (candidateWindow.worldCenterX - candidateWindow.sourceCenterX));
+  const candidateArrayOriginY = Math.round(candidateWindow.originY ?? (candidateWindow.worldCenterY - candidateWindow.sourceCenterY));
+  // Candidate generation uses padding-invariant world coordinates. Array-space
+  // positions move when the world is expanded on the left/top; subtracting the
+  // current world origin keeps the same geographic location stable.
+  const candidateOriginX = candidateArrayOriginX - Math.round(world?.originX || 0);
+  const candidateOriginY = candidateArrayOriginY - Math.round(world?.originY || 0);
+  const candidateWidth = Math.max(1, Math.floor(candidateWindow.width || MAP_W));
+  const candidateHeight = Math.max(1, Math.floor(candidateWindow.height || MAP_H));
+  const patchTimer = createPatchTimer(options.onProgress);
+  options.onProgress?.({ status: "start", key: "candidate", label: "Generating full patch candidate" });
+  const patchGenerationMode = "unified-world-native-patch";
+  const candidate = generatePatchCandidate(seed, {
+      terrainType,
+      legacyTerrain: false,
+      stableWorldTerrain: true,
+      stableTerrainSeed: world?.seed ?? seed,
+      worldSeaLevel: seaLevel,
+      worldNative: true,
+      variant,
+      originX: candidateOriginX,
+      originY: candidateOriginY,
+      width: candidateWidth,
+      height: candidateHeight,
+      window: candidateWindow,
+      contextRect: rects.contextRect,
+      boundaryWorld: world,
+      qualityRects: rects,
+      qualityPolicyVersion: PATCH_QUALITY_POLICY_VERSION,
+      // Preserve the caller's interactive candidate budget.  app.js requests
+      // one terrain/full candidate per Alternative click; dropping this option
+      // made the expansion path silently run extra full generations, which can
+      // exhaust a worker on larger selections.
+      qualityTerrainAttempts: options.qualityTerrainAttempts,
+      patchMode: rects.patchMode,
+      largeExpansionTile: options._internalTile === true,
+      topCenterSuppression: rects.patchMode === PATCH_MODE_EXPANSION ? 0.34 : 0.72,
+      onProgress: (event) => options.onProgress?.(event),
+    });
+  // Keep candidate quality in an attempt-local copy because merge quality is
+  // world-specific and may be adjusted during this patch attempt.
+  const patchQuality = candidate.patchQuality ? cloneTransactionValue(candidate.patchQuality) : null;
+  patchTimer.mark("candidate", "Full candidate generation");
+  getPatchAlphaCache(rects, seed);
+  const generatedFootprint = buildGeneratedFootprint(rects, seed);
+  const sourceMap = world.sourceMap || (world.sourceMap = {});
+  const seamSnapshot = capturePatchSeamSnapshot(world, sourceMap, rects, seed, options._seamBaselineSourceMap || null);
+  const terrainContract = buildTerrainBoundaryContract(world, sourceMap, rects, seed, seaLevel);
+  getPatchSourceIndexCache(rects, candidateWindow);
+  const patchContext = createPatchContext({
+    world,
+    rects,
+    candidateWindow,
+    seed,
+    patchAlpha,
+    sourceIndexForWorld,
+    worldIndex: worldIndexOf,
+  });
+  const strictMetadataSnapshot = captureStrictMetadataSnapshot(world, sourceMap, rects, seed);
+  const prefectureIdentitySnapshot = capturePrefectureIdentitySnapshot(sourceMap);
+  const logisticsLabelsMigrated = sanitizeExistingLogistics(sourceMap);
+
+  const fieldDebug = copyFullPipelineFields(world, candidate, rects, seed, sourceMap, seaLevel, patchContext, terrainContract);
+  patchTimer.mark("fields", "Field copy, world sea-level classification, and alpha blend");
+  const terrainDebug = options._deferTerrainCoherence === true
+    ? {
+        deferredForTiledExpansion: true,
+        terrainSeamDebug: { deferredForTiledExpansion: true },
+        frontierHarmonizationDebug: { deferredForTiledExpansion: true },
+        elevationCliffDebug: { deferredForTiledExpansion: true },
+        waterDebug: { deferredForTiledExpansion: true, coastCellsChanged: 0 },
+        waterComponentDebug: { deferredForTiledExpansion: true, waterTopologyCellsFlipped: 0 },
+        residualSeaDebug: { deferredForTiledExpansion: true, residualSeaCellsFilled: 0 },
+        waterElevationDebug: { deferredForTiledExpansion: true, waterElevationCellsSmoothed: 0 },
+        maskDebug: { deferredForTiledExpansion: true, displayMaskUpdated: 0 },
+      }
+    : repairPatchTerrain(world, rects, seed, seaLevel, terrainContract, options.onProgress);
+  patchTimer.mark("terrainRepair", options._deferTerrainCoherence === true ? "Terrain repair deferred to large-selection finalization" : "Water, masks, and terrain repair");
+  const pointDebug = mergePointLayers(world, sourceMap, candidate, rects, fieldDebug.window, seed, fieldDebug.adminIdMapping);
+  const administrativeMetadataDebug = backfillCandidateAdministrativeMetadata(world, sourceMap, candidate, rects, fieldDebug.window, seed, fieldDebug.adminIdMapping);
+  patchTimer.mark("points", "Point merge and administrative metadata preservation");
+  const pathDebug = repairPatchTransport(world, sourceMap, candidate, rects, fieldDebug.window, seed, seamSnapshot, {
+    deferGraphRepair: options._deferTransportGraphRepair === true,
+  });
+  patchTimer.mark("paths", "Path merge and connector repair");
+  const influenceDebug = refreshPatchInfluenceFields(world, sourceMap, rects);
+  patchTimer.mark("influence", "Influence refresh");
+  const adminDebug = repairPatchAdministration(world, sourceMap, rects, seed, fieldDebug.adminIdMapping, strictFieldSnapshot, options.onProgress, {
+    deferMetadataCoherence: options._deferAdministrativeMetadataCoherence === true,
+    deferStructuralCoherence: options._deferAdministrativeStructuralCoherence === true,
+  });
+  const residualSeaStrictDebug = options._deferTerrainCoherence === true
+    ? { deferredForTiledExpansion: true, residualSeaCellsFilled: 0 }
+    : fillTinyResidualSeas(world, rects, seaLevel, seed, { aggressive: true, preservePockets: true });
+  const boundaryContractPostAdminDebug = options._deferTerrainCoherence === true
+    ? { deferredForTiledExpansion: true, seaCellsChanged: 0 }
+    : applyTerrainBoundaryContract(world, rects, terrainContract, seed, "post-admin-repair");
+  const finalElevationSeamDebug = options._deferTerrainCoherence === true
+    ? { deferredForTiledExpansion: true, finalSeamElevationCellsAdjusted: 0 }
+    : finalizeExpansionElevationSeam(world, rects, seed, seaLevel);
+  if (options._deferTerrainCoherence !== true && ((residualSeaStrictDebug.residualSeaCellsFilled || 0) > 0
+    || (boundaryContractPostAdminDebug.seaCellsChanged || 0) > 0
+    || (finalElevationSeamDebug.finalSeamElevationCellsAdjusted || 0) > 0)) {
+    repairDisplayMasks(world, rects, seed);
+    recomputeSlopeAndWaterDependentFields(world, rects.repairRect, seaLevel);
+  }
+  // This is the authoritative strict-mask restore. Earlier restores occurred
+  // before residual-water and derived-field recomputation, allowing elevation,
+  // slope, and IDs to leak outside a regeneration lasso.
+  const strictMaskDebugFinal = restoreOutsideStrictSelectionFields(world, rects, strictFieldSnapshot, seed);
+  const expansionFootprintRestoreDebug = restoreOutsideExpansionGeneratedFootprint(
+    world, rects, options._transactionSnapshot, generatedFootprint
+  );
+  const strictMetadataDebug = restoreOutsideStrictMetadata(world, sourceMap, rects, strictMetadataSnapshot, seed);
+  // Reconcile centers and prefecture labels only after the final field restore.
+  // Do not rewrite municipalityId here: strict regeneration requires every
+  // outside cell field to retain its exact pre-patch value.
+  const finalAdministrativeMetadata = options._deferAdministrativeMetadataCoherence === true
+    ? {
+        municipalCoherence: {
+          adminCenters: sourceMap.adminCenters || [],
+          municipalityToPrefectureId: sourceMap.municipalityToPrefectureId || [],
+          debug: { deferredForTiledExpansion: true },
+        },
+        prefectureCoherence: {
+          prefectureRegions: sourceMap.prefectureRegions || [],
+          debug: { deferredForTiledExpansion: true },
+        },
+      }
+    : synchronizePatchAdministrativeMetadata(world, sourceMap, seed, { writeMunicipalityField: false });
+  // Identity restoration must be the last metadata operation. Refreshing region
+  // records can otherwise select a candidate record for an existing numeric ID
+  // and silently replace the pre-patch prefecture name.
+  const prefectureIdentityDebug = restorePrefectureIdentitySnapshot(world, sourceMap, prefectureIdentitySnapshot);
+  const capitalCoherenceDebug = normalizePatchPrefectureCapitals(world, sourceMap);
+  const administrativeMetadataAfterCapitals = synchronizePatchAdministrativeMetadata(world, sourceMap, seed, { writeMunicipalityField: false });
+  const riverWaterCoherenceDebug = sanitizeRiversAgainstFinalWater(world, sourceMap, rects);
+  const finalFrontierHarmonizationDebug = options._deferTerrainCoherence === true
+    ? { deferredForTiledExpansion: true, frontierHarmonizedValues: 0 }
+    : harmonizeExpansionFrontier(world, rects, seed, seaLevel, { depth: 18, passes: 3 });
+  const establishedFrontierElevationDebug = options._deferTerrainCoherence === true
+    ? { deferredForTiledExpansion: true, establishedFrontierElevationCellsAdjusted: 0, establishedFrontierGradientCellsAdjusted: 0 }
+    : enforceEstablishedFrontierElevationContinuity(world, rects, seed, seaLevel, { depth: 12, frontierLimit: 0.052, gradientLimit: 0.070 });
+  let finalFrontierFootprintRestoreDebug = { expansionFootprintCellsRestored: 0, expansionFootprintValuesRestored: 0, expansionFootprintFieldsRestored: 0 };
+  if ((finalFrontierHarmonizationDebug.frontierHarmonizedValues || 0) > 0
+    || (establishedFrontierElevationDebug.establishedFrontierElevationCellsAdjusted || 0) > 0
+    || (establishedFrontierElevationDebug.establishedFrontierGradientCellsAdjusted || 0) > 0) {
+    recomputeSlopeAndWaterDependentFields(world, rects.repairRect, seaLevel);
+    // Derived-field recomputation operates on a rectangular stencil. Restore any
+    // backing-world values outside the irregular generated footprint so frontier
+    // harmonization cannot leak slope/plain/agriculture writes into untouched cells.
+    finalFrontierFootprintRestoreDebug = restoreOutsideExpansionGeneratedFootprint(
+      world, rects, options._transactionSnapshot, generatedFootprint
+    );
+  }
+  const segmentDebug = options._deferGlobalBoundaryRebuild === true
+    ? {
+        boundarySource: "deferred-tiled-expansion",
+        globalBoundaryRebuild: false,
+        adminBordersRebuilt: 0,
+        prefectureBordersRebuilt: 0,
+        outerPrefectureBordersRebuilt: 0,
+        candidateAdminBordersMerged: 0,
+        candidatePrefectureBordersMerged: 0,
+        rasterAdminBordersSuppressed: 0,
+        rasterPrefectureBordersSuppressed: 0,
+        compartmentBordersRebuilt: sourceMap?.adminDebug?.compartmentBorders?.length || 0,
+      }
+    : mergeSegmentLayers(world, sourceMap, rects, seed, candidate, fieldDebug.window);
+  const candidateCompartmentSegmentsAdded = mergeCandidateCompartmentDebugSegments(world, sourceMap, candidate, rects, fieldDebug.window, seed);
+  patchTimer.mark("segments", "Boundary and debug segment merge");
+  sanitizeExistingLogistics(sourceMap);
+  patchTimer.mark("cleanup", "Land-use, admin, and label cleanup");
+  const patchTimings = patchTimer.timings;
+  const {
+    terrainSeamDebug,
+    frontierHarmonizationDebug,
+    elevationCliffDebug,
+    waterDebug,
+    waterComponentDebug,
+    residualSeaDebug,
+    waterElevationDebug,
+    maskDebug,
+  } = terrainDebug;
+  const {
+    landDebug,
+    finalAdminCoverageDebug,
+    adminTopologyDebug,
+    tinyGeneratedPrefectureDebug,
+    frontierAdministrativeDebug,
+    strictMaskDebugPreCoherence,
+    strictMaskDebugPostCoherence,
+    sourceAdminMetadataUpdated,
+  } = adminDebug;
+  const { municipalCoherence, prefectureCoherence } = finalAdministrativeMetadata;
+
+  const expansionFootprintAudit = auditExpansionGeneratedFootprint(
+    world, rects, options._transactionSnapshot, generatedFootprint
+  );
+  const seaStats = countSea(world, rects.coreRect, rects, seed);
+  const finalCandidateQuality = evaluateFinalExpansionQuality(world, sourceMap, rects, seed, patchQuality || null);
+  if (patchQuality && finalCandidateQuality) {
+    patchQuality.final = finalCandidateQuality;
+    patchQuality.preMergeHardPass = patchQuality.hardPass;
+    // The pre-merge human gate is a candidate-ranking heuristic.  For narrow or
+    // oblique ownership masks it can under-count candidate features even though
+    // the actual merged patch meets the final density gate.  Once the world has
+    // been merged, the final ownership-aware measurement is authoritative; keep
+    // the terrain structural gate, but allow a valid final human geography to
+    // recover from a pessimistic pre-merge estimate.
+    patchQuality.hardPass = (patchQuality.terrain?.hardPass !== false) && finalCandidateQuality.hardPass;
+    patchQuality.score = patchQuality.score * 0.74 + finalCandidateQuality.score * 0.26;
+  }
+  const label = terrainLabel(candidate, terrainType);
+  const id = terrainId(candidate, terrainType);
+  const seamDiagnostics = analyzePatchSeam(world, sourceMap, rects, seed, seamSnapshot, candidateWindow, patchGenerationMode, options.includeSeamVisualization === true);
+  if (seamDiagnostics) Object.assign(seamDiagnostics, expansionFootprintRestoreDebug, expansionFootprintAudit);
+  const rawSeamQualityGate = evaluateSeamQualityGate(seamDiagnostics);
+  // Internal tile boundaries are implementation details, not user-visible world
+  // seams. A road/rail created or rerouted by one tile may temporarily fail a
+  // portal check while the neighboring tile is still pending. Defer only those
+  // transport-portal obligations to the final whole-selection seam audit; keep
+  // terrain, coastline, and administrative hard gates active per tile.
+  const deferredInternalReasons = options._deferInternalSeamGate === true
+    ? [...rawSeamQualityGate.reasons]
+    : [];
+  const deferredTransportReasons = options._deferInternalSeamGate === true
+    ? []
+    : options._deferTransportSeamGate
+      ? rawSeamQualityGate.reasons.filter((reason) => reason === "road-portal-broken" || reason === "rail-portal-broken")
+      : [];
+  const seamQualityGate = options._deferInternalSeamGate === true
+    ? { ...rawSeamQualityGate, reasons: [] }
+    : deferredTransportReasons.length
+      ? {
+          ...rawSeamQualityGate,
+          reasons: rawSeamQualityGate.reasons.filter((reason) => reason !== "road-portal-broken" && reason !== "rail-portal-broken"),
+        }
+      : rawSeamQualityGate;
+  seamQualityGate.hardPass = seamQualityGate.reasons.length === 0;
+  if (seamDiagnostics) {
+    seamDiagnostics.hardPass = seamQualityGate.hardPass;
+    seamDiagnostics.gateReasons = seamQualityGate.reasons;
+    seamDiagnostics.gateBudgets = seamQualityGate.budgets;
+    seamDiagnostics.deferredTransportGateReasons = deferredTransportReasons;
+    seamDiagnostics.deferredInternalGateReasons = deferredInternalReasons;
+  }
+  if (patchQuality) {
+    seamDiagnostics.qualityPolicyVersion = patchQuality.policyVersion;
+    seamDiagnostics.qualityHardPass = !!patchQuality.hardPass;
+    seamDiagnostics.qualityScore = patchQuality.score || 0;
+    seamDiagnostics.qualitySelectedVariant = patchQuality.selectedVariant;
+    seamDiagnostics.qualityTerrainType = patchQuality.terrain?.terrainType || id;
+    seamDiagnostics.qualityLandRatio = patchQuality.terrain?.landRatio || 0;
+    seamDiagnostics.qualityDevelopableRatio = patchQuality.terrain?.developableRatio || 0;
+    seamDiagnostics.qualityLargestComponentRatio = patchQuality.terrain?.largestComponentRatio || 0;
+    seamDiagnostics.qualitySettlementCount = patchQuality.human?.settlementCount || 0;
+    seamDiagnostics.qualityLabelCount = patchQuality.human?.labelCount || 0;
+    seamDiagnostics.qualitySettlementDensityPer1000 = patchQuality.human?.settlementDensityPer1000 || 0;
+    seamDiagnostics.qualityLabelDensityPer1000 = patchQuality.human?.labelDensityPer1000 || 0;
+    seamDiagnostics.qualityFinalLandRatio = patchQuality.final?.landRatio || 0;
+    seamDiagnostics.qualityFinalOwnedLandRatio = patchQuality.final?.ownedLandRatio || 0;
+    seamDiagnostics.qualityFinalSettlementCount = patchQuality.final?.settlementCount || 0;
+    seamDiagnostics.qualityFinalLabelCount = patchQuality.final?.labelCount || 0;
+    seamDiagnostics.qualityFinalHardPass = patchQuality.final?.hardPass !== false;
+    patchQuality.preSeamHardPass = patchQuality.hardPass;
+    patchQuality.seam = seamQualityGate;
+    patchQuality.hardPass = patchQuality.hardPass && seamQualityGate.hardPass;
+    seamDiagnostics.qualityHardPass = !!patchQuality.hardPass;
+  }
+  sourceMap.patchSeamDiagnostics = seamDiagnostics;
+  patchTimer.mark("seamDiagnostics", "Seam diagnostics");
+  const patchStageDebug = {
+    candidate: {
+patchGenerationMode, candidateAreaRatio: candidateWindow.areaRatio ?? 1,
+      patchMode: rects.patchMode,
+      patchModeRequested: rects.patchModeRequested,
+      patchModeAutoDetected: rects.patchModeAutoDetected,
+      coverageStats: rects.coverageStats,
+      stableWorldTerrain: false,
+      productionPipelineParity: rects.patchMode === PATCH_MODE_EXPANSION,
+      candidateQuality: patchQuality || null,
+      worldSeaLevel: seaLevel,
+    },
+    fields: fieldDebug,
+    terrain: terrainDebug,
+    points: { ...pointDebug, ...administrativeMetadataDebug },
+    transport: pathDebug,
+    influence: influenceDebug,
+    admin: adminDebug,
+    segments: { ...segmentDebug, candidateCompartmentSegmentsAdded },
+    cleanup: { logisticsLabelsMigrated, strictMetadataDebug, prefectureIdentityDebug, capitalCoherenceDebug, riverWaterCoherenceDebug, tinyGeneratedPrefectureDebug, strictMaskDebugFinal, residualSeaStrictDebug, boundaryContractPostAdminDebug, finalElevationSeamDebug, finalFrontierHarmonizationDebug, establishedFrontierElevationDebug, finalFrontierFootprintRestoreDebug },
+    seamDiagnostics,
+  };
+  const humanGeography = {
+    ok: true,
+    patchStages: patchStageDebug,
+    modernCities: (sourceMap.modernCities || []).filter((p) => insideRect(pointWorldX(world, p), pointWorldY(world, p), rects.writeRect)).length,
+    ports: (sourceMap.ports || []).filter((p) => insideRect(pointWorldX(world, p), pointWorldY(world, p), rects.writeRect)).length,
+    villages: (sourceMap.villages || []).filter((p) => insideRect(pointWorldX(world, p), pointWorldY(world, p), rects.writeRect)).length,
+    ...pointDebug,
+    ...administrativeMetadataDebug,
+    ...pathDebug,
+    ...influenceDebug,
+    ...capitalCoherenceDebug,
+    ...riverWaterCoherenceDebug,
+    ...tinyGeneratedPrefectureDebug,
+    ...frontierAdministrativeDebug,
+    ...frontierHarmonizationDebug,
+    ...finalFrontierHarmonizationDebug,
+    ...establishedFrontierElevationDebug,
+    finalFrontierFootprintCellsRestored: finalFrontierFootprintRestoreDebug.expansionFootprintCellsRestored || 0,
+    finalFrontierFootprintValuesRestored: finalFrontierFootprintRestoreDebug.expansionFootprintValuesRestored || 0,
+    adminCellsReassigned: fieldDebug.adminCellsReassigned,
+    adminIdMapping: fieldDebug.adminIdMappingDebug,
+    sourceAdminMetadataUpdated,
+    ...finalAdminCoverageDebug,
+    ...adminTopologyDebug,
+    strictMaskCellsRestored: (strictMaskDebugPreCoherence.strictMaskCellsRestored || 0) + (strictMaskDebugPostCoherence.strictMaskCellsRestored || 0) + (strictMaskDebugFinal.strictMaskCellsRestored || 0),
+    strictMaskValuesRestored: (strictMaskDebugPreCoherence.strictMaskValuesRestored || 0) + (strictMaskDebugPostCoherence.strictMaskValuesRestored || 0) + (strictMaskDebugFinal.strictMaskValuesRestored || 0),
+    ...expansionFootprintRestoreDebug,
+    ...expansionFootprintAudit,
+    ...strictMetadataDebug,
+    ...prefectureIdentityDebug,
+    humanLandCellsRestored: fieldDebug.humanLandCellsRestored || 0,
+    humanLandFeatureMaskCells: fieldDebug.humanLandFeatureMaskCells || 0,
+    finalSeaAdminCellsCleared: finalAdminCoverageDebug.seaAdminCellsCleared || 0,
+    finalLandAdminCellsFilled: finalAdminCoverageDebug.landAdminCellsFilled || 0,
+    finalPrefectureCellsFilled: finalAdminCoverageDebug.prefectureCellsFilled || 0,
+    finalAdminPrefectureCellsAligned: finalAdminCoverageDebug.adminPrefectureCellsAligned || 0,
+    municipalCoherence: municipalCoherence.debug,
+    prefectureMetadataCoherence: prefectureCoherence.debug,
+    continuityCellsRestored: fieldDebug.continuityCellsRestored || 0,
+    continuityCellsRemapped: fieldDebug.continuityCellsRemapped || 0,
+    terrainSeamAdjustmentSamples: fieldDebug.terrainSeamAdjustmentSamples || 0,
+    terrainSeamElevationOffset: fieldDebug.terrainSeamElevationOffset || 0,
+    terrainSeamElevationTiltX: fieldDebug.terrainSeamElevationTiltX || 0,
+    terrainSeamElevationTiltY: fieldDebug.terrainSeamElevationTiltY || 0,
+    adminSeamCellsResolved: fieldDebug.adminSeamCellsResolved || 0,
+    prefectureSeamCellsResolved: fieldDebug.prefectureSeamCellsResolved || 0,
+    ...terrainSeamDebug,
+    ...elevationCliffDebug,
+    ...waterComponentDebug,
+    ...residualSeaDebug,
+    residualSeaPostRestorePatchesFilled: residualSeaStrictDebug.residualSeaPatchesFilled,
+    residualSeaPostRestoreCellsFilled: residualSeaStrictDebug.residualSeaCellsFilled,
+    ...waterElevationDebug,
+    ...finalElevationSeamDebug,
+    landUseCellsUpdated: fieldDebug.landUseCellsUpdated + landDebug.landUseCellsUpdated,
+    displayMaskUpdated: maskDebug.displayMaskUpdated || 0,
+    logisticsLabelsMigrated,
+    patchMode: rects.patchMode,
+    patchModeRequested: rects.patchModeRequested,
+    patchModeAutoDetected: rects.patchModeAutoDetected,
+    ungeneratedSelectionRatio: rects.coverageStats?.ungeneratedRatio || 0,
+    expansionOverlap: rects.expansionOverlap || 0,
+    stableWorldTerrain: false,
+    productionPipelineParity: rects.patchMode === PATCH_MODE_EXPANSION,
+    candidateQuality: patchQuality || null,
+    worldSeaLevel: seaLevel,
+    candidateSeaLevel: fieldDebug.candidateSeaLevel,
+    seaLevelBaseOffset: fieldDebug.seaLevelBaseOffset,
+    terrainBoundaryContract: {
+      postFieldCopy: fieldDebug.waterClassificationDebug,
+      postTerrainRepair: terrainDebug.boundaryContractDebug,
+      postWaterElevation: terrainDebug.boundaryContractFinalDebug,
+      postAdminRepair: boundaryContractPostAdminDebug,
+    },
+    seamDiagnostics,
+    ...segmentDebug,
+    candidateCompartmentSegmentsAdded,
+  };
+
+  const record = {
+    ...rects.coreRect,
+    coreRect: { ...rects.coreRect },
+    selectionShape: rects.selectionShape ? {
+      kind: rects.selectionShape.kind || 'lasso',
+      areaCells: rects.selectionShape.areaCells || 0,
+      polygon: rects.selectionShape.polygon.map((p) => ({ x: p.x, y: p.y })),
+    } : null,
+    writeRect: { ...rects.writeRect },
+    generatedFootprint,
+    repairRect: { ...rects.repairRect },
+    contextRect: { ...rects.contextRect },
+    transportReachRect: { ...rects.transportReachRect },
+    transportReachMargin: rects.transportReachMargin,
+    blendRect: { ...rects.blendRect },
+    terrainType: id,
+    label,
+    seed,
+    variant,
+    candidateOriginX,
+    candidateOriginY,
+    candidateWidth,
+    candidateHeight,
+    candidateAreaRatio: candidateWindow.areaRatio ?? 1,
+    patchMode: rects.patchMode,
+    patchModeRequested: rects.patchModeRequested,
+    patchModeAutoDetected: rects.patchModeAutoDetected,
+    coverageStats: { ...rects.coverageStats },
+    expansionOverlap: rects.expansionOverlap || 0,
+    generatedFootprintCells: generatedFootprint?.cellCount || 0,
+    worldSeaLevel: seaLevel,
+    candidateSeaLevel: fieldDebug.candidateSeaLevel,
+    stableWorldTerrain: false,
+    productionPipelineParity: rects.patchMode === PATCH_MODE_EXPANSION,
+    candidateQuality: patchQuality || null,
+    patchGenerationMode,
+    seamDiagnostics,
+    patchTimings,
+    updatedCells: fieldDebug.updatedCells,
+    terrainCellsFullyReplaced: fieldDebug.terrainCellsFullyReplaced,
+    coastCellsChanged: fieldDebug.coastCellsChanged + waterDebug.coastCellsChanged + waterComponentDebug.waterTopologyCellsFlipped + residualSeaDebug.residualSeaCellsFilled + residualSeaStrictDebug.residualSeaCellsFilled,
+    naturalRegionsUpdated: fieldDebug.naturalRegionsUpdated,
+    naturalRegionFragmentsMerged: 0,
+    adminIdMapping: fieldDebug.adminIdMappingDebug,
+    seaRatio: seaStats.seaRatio,
+    humanGeography,
+    createdAt: Date.now(),
+  };
+  // Large selections already retain one outer atomic transaction and one final
+  // aggregate diagnostic result. Keeping every internal tile's complete debug
+  // tree in generatedRects made later tiles repeatedly clone/scan an ever-growing
+  // object graph. Coverage only needs the geometric footprint and generation
+  // identity, so store a compact record for implementation-detail tiles.
+  const generatedRecord = options._internalTile === true
+    ? {
+        x0: record.x0, y0: record.y0, x1: record.x1, y1: record.y1,
+        coreRect: record.coreRect,
+        selectionShape: record.selectionShape,
+        writeRect: record.writeRect,
+        generatedFootprint: record.generatedFootprint,
+        repairRect: record.repairRect,
+        contextRect: record.contextRect,
+        transportReachRect: record.transportReachRect,
+        terrainType: record.terrainType,
+        seed: record.seed, variant: record.variant,
+        patchMode: record.patchMode,
+        internalExpansionTile: true,
+        createdAt: record.createdAt,
+      }
+    : record;
+  world.generatedRects = [...(world.generatedRects || []), generatedRecord];
+  addInvalidatedRect(world, rects.writeRect);
+  addInvalidatedRect(world, rects.transportReachRect);
+  world.lastPatchResult = options._internalTile === true ? generatedRecord : record;
+  world.patchGenerationSerial = (world.patchGenerationSerial || 0) + 1;
+
+  return {
+    ok: true,
+    validation,
+    rects: {
+      ...rects,
+      selectionShape: rects.selectionShape ? {
+        kind: rects.selectionShape.kind || 'lasso',
+        areaCells: rects.selectionShape.areaCells || 0,
+        polygon: rects.selectionShape.polygon.map((p) => ({ x: p.x, y: p.y })),
+      } : null,
+    },
+    terrainType: id,
+    label,
+    seed,
+    variant,
+    candidateOriginX,
+    candidateOriginY,
+    candidateWidth,
+    candidateHeight,
+    candidateAreaRatio: candidateWindow.areaRatio ?? 1,
+    patchMode: rects.patchMode,
+    patchModeRequested: rects.patchModeRequested,
+    patchModeAutoDetected: rects.patchModeAutoDetected,
+    coverageStats: { ...rects.coverageStats },
+    expansionOverlap: rects.expansionOverlap || 0,
+    generatedFootprintCells: generatedFootprint?.cellCount || 0,
+    worldSeaLevel: seaLevel,
+    candidateSeaLevel: fieldDebug.candidateSeaLevel,
+    stableWorldTerrain: false,
+    productionPipelineParity: rects.patchMode === PATCH_MODE_EXPANSION,
+    candidateQuality: patchQuality || null,
+    patchGenerationMode,
+    seamDiagnostics,
+    patchTimings,
+    updatedCells: record.updatedCells,
+    terrainCellsFullyReplaced: record.terrainCellsFullyReplaced,
+    coastCellsChanged: record.coastCellsChanged,
+    naturalRegionsUpdated: record.naturalRegionsUpdated,
+    naturalRegionFragmentsMerged: 0,
+    adminIdMapping: fieldDebug.adminIdMappingDebug,
+    _internalAdminAllocation: options._internalTile === true ? {
+      prefectureIds: [...(fieldDebug.adminIdMapping?.allocatedPrefectureIds || [])],
+      municipalityIds: [...(fieldDebug.adminIdMapping?.allocatedMunicipalityIds || [])],
+    } : undefined,
+    seaRatio: seaStats.seaRatio,
+    humanGeography,
+  };
+}
diff --git a/src/mapPatchContext.js b/src/mapPatchContext.js
new file mode 100644
index 0000000..cddb1c8
--- /dev/null
+++ b/src/mapPatchContext.js
@@ -0,0 +1,24 @@
+export function createPatchContext({ world, rects, candidateWindow, seed, patchAlpha, sourceIndexForWorld, worldIndex }) {
+  const writeRect = rects?.writeRect;
+  const writeCells = [];
+  if (world && writeRect && typeof patchAlpha === "function" && typeof sourceIndexForWorld === "function" && typeof worldIndex === "function") {
+    for (let y = writeRect.y0; y < writeRect.y1; y++) {
+      for (let x = writeRect.x0; x < writeRect.x1; x++) {
+        const wi = worldIndex(world, x, y);
+        if (wi < 0) continue;
+        const si = sourceIndexForWorld(rects, candidateWindow, x, y);
+        if (si < 0) continue;
+        const alpha = patchAlpha(x, y, rects, seed);
+        if (alpha <= 0.005) continue;
+        writeCells.push({ x, y, wi, si, alpha });
+      }
+    }
+  }
+  return {
+    world,
+    rects,
+    candidateWindow,
+    seed,
+    writeCells,
+  };
+}
diff --git a/src/mapPatchWorker.js b/src/mapPatchWorker.js
new file mode 100644
index 0000000..b1db7c9
--- /dev/null
+++ b/src/mapPatchWorker.js
@@ -0,0 +1,24 @@
+import { generatePatch } from "./mapPatch.js";
+import { collectTransferableBuffers } from "./transferUtils.js";
+
+self.onmessage = (event) => {
+  const { id, world, rect, options } = event.data || {};
+  try {
+    const result = generatePatch(world, rect, {
+      ...(options || {}),
+      // The worker owns this preview clone. If a multi-tile attempt fails the
+      // main thread discards the entire worker world, so a second full-size field
+      // snapshot is unnecessary and would recreate the large-patch memory spike.
+      _workerOwnedPreview: true,
+      onProgress: (progress) => self.postMessage({ id, type: "progress", progress }),
+    });
+    // The main thread owns the pre-patch world while preview generation runs.
+    // Return the worker-owned preview by transferring its buffers instead of
+    // cloning the complete padded world a second time.
+    const payload = { id, ok: true, world, result };
+    const transfer = Array.from(collectTransferableBuffers(payload));
+    self.postMessage(payload, transfer);
+  } catch (error) {
+    self.postMessage({ id, ok: false, error: error?.message || String(error), stack: error?.stack || "" });
+  }
+};
diff --git a/mapPipeline.js b/src/mapPipeline.js
similarity index 74%
rename from mapPipeline.js
rename to src/mapPipeline.js
index 0aed38d..1cc6a0c 100644
--- a/mapPipeline.js
+++ b/src/mapPipeline.js
@@ -1,5 +1,5 @@
-import { CELL_SIZE, MAP_H, MAP_W, indexOf } from "./mapUtils.js";
-import { generateTerrainAndRivers } from "./mapTerrain.js";
+import { CELL_SIZE, MAP_H, MAP_W, indexOf, nowMs } from "./mapUtils.js";
+import { finalizeRectTerrainForFixedMap, generateTerrainAndRivers, generateTerrainRect } from "./mapTerrain.js";
 import { generateMapFeatures } from "./mapFeatures.js";
 import { finishMapOutput } from "./mapOutput.js";
 import { generateAdminLayout } from "./mapAdminStage.js";
@@ -55,15 +55,22 @@ function contextualSeed(seed, context, options = {}) {
   if (!context.worldNative && !context.variant && !context.originX && !context.originY) return h;
   h = mixString(h, options.terrainType || options.generationType || "auto");
   h = mixUint(h, context.variant);
-  h = mixUint(h, context.originX | 0);
-  h = mixUint(h, context.originY | 0);
-  h = mixUint(h, context.width);
-  h = mixUint(h, context.height);
-  if (context.contextRect) {
-    h = mixUint(h, context.contextRect.x0 | 0);
-    h = mixUint(h, context.contextRect.y0 | 0);
-    h = mixUint(h, context.contextRect.x1 | 0);
-    h = mixUint(h, context.contextRect.y1 | 0);
+  // World-native generation must be invariant to the candidate crop.  Origin,
+  // width/height, and contextRect describe only how the same world field is
+  // sampled; mixing them into the seed made a one-cell selection change create
+  // a different world. Legacy/initial generation keeps the historical seed
+  // contextualization for compatibility.
+  if (!context.worldNative) {
+    h = mixUint(h, context.originX | 0);
+    h = mixUint(h, context.originY | 0);
+    h = mixUint(h, context.width);
+    h = mixUint(h, context.height);
+    if (context.contextRect) {
+      h = mixUint(h, context.contextRect.x0 | 0);
+      h = mixUint(h, context.contextRect.y0 | 0);
+      h = mixUint(h, context.contextRect.x1 | 0);
+      h = mixUint(h, context.contextRect.y1 | 0);
+    }
   }
   return h >>> 0;
 }
@@ -84,21 +91,81 @@ function makeRuntimeOptions(options, baseSeed) {
   };
 }
 
+function localizeWorldNativePath(path, originX, originY) {
+  if (!Array.isArray(path)) return path;
+  const out = path.map((tuple) => Array.isArray(tuple) && tuple.length >= 2
+    ? [tuple[0] - originX, tuple[1] - originY, ...tuple.slice(2)]
+    : tuple);
+  for (const key of Object.keys(path)) {
+    if (!/^\d+$/.test(key)) out[key] = path[key];
+  }
+  return out;
+}
+
+function localizeWorldNativeTerrainPaths(terrain, originX, originY) {
+  const out = { ...terrain };
+  for (const key of ["mainRivers", "tributaryRivers", "smallStreams", "riverPaths"]) {
+    if (!Array.isArray(terrain?.[key])) continue;
+    out[key] = terrain[key].map((path) => localizeWorldNativePath(path, originX, originY));
+  }
+  return out;
+}
+
+function generateStableWorldTerrain(options = {}) {
+  const originX = Math.floor(Number.isFinite(options.originX) ? options.originX : 0);
+  const originY = Math.floor(Number.isFinite(options.originY) ? options.originY : 0);
+  // Keep terrain seed independent of candidate origin/window. Variant remains an
+  // intentional alternate-world input, while selection geometry does not alter
+  // terrain at a fixed absolute coordinate.
+  const terrainSeed = Number.isFinite(options.stableTerrainSeed)
+    ? options.stableTerrainSeed >>> 0
+    : Number.isFinite(options.baseSeed) ? options.baseSeed >>> 0 : 0;
+  const terrain = generateTerrainRect({
+    ...options,
+    seed: terrainSeed,
+    variant: options.variant || 0,
+    originX,
+    originY,
+    width: MAP_W,
+    height: MAP_H,
+    seaLevel: Number.isFinite(options.worldSeaLevel) ? options.worldSeaLevel : undefined,
+    name: "world-native-patch-terrain",
+  });
+  const finalized = finalizeRectTerrainForFixedMap(terrainSeed, terrain, options);
+  return localizeWorldNativeTerrainPaths(finalized, originX, originY);
+}
+
 function generateInitialTerrain(seed, options = {}) {
-  // Production generation is intentionally pinned to the legacy high-detail
-  // terrain/natural-compartment pipeline. Rect-native terrain helpers may remain
-  // in the codebase for experiments, but they are not reachable from generateMap.
+  // Expansion may supply a quality-selected production terrain override
+  // candidate selector.  It is fed through exactly the same geography,
+  // settlement, administration, transport, and output stages as initial
+  // generation; only the terrain search is performed ahead of time.
+  if (options.terrainOverride) return options.terrainOverride;
+  // Regeneration retains the legacy production terrain. Stable rect terrain is
+  // still available for deterministic diagnostics and compatibility, but normal
+  // expansion candidates now select from production terrain candidates.
+  if (options.stableWorldTerrain === true) return generateStableWorldTerrain(options);
   return generateTerrainAndRivers(seed, options);
 }
 
+
+export function prepareProductionTerrain(seedInput = 114514, options = {}) {
+  const baseSeed = Number(seedInput) >>> 0;
+  const runtimeOptions = makeRuntimeOptions({ ...options, terrainOverride: undefined, stableWorldTerrain: false }, baseSeed);
+  const terrain = generateTerrainAndRivers(runtimeOptions.effectiveSeed, runtimeOptions);
+  return {
+    terrain,
+    baseSeed,
+    effectiveSeed: runtimeOptions.effectiveSeed,
+    generationContext: { ...runtimeOptions.generationContext },
+    runtimeOptions,
+  };
+}
+
 function terrainStageLabel() {
   return "Terrain, rivers, and natural compartments";
 }
 
-function nowMs() {
-  return typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
-}
-
 function timedStage(timings, options, key, label, fn) {
   options?.onProgress?.({ status: "start", key, label, timings: timings.slice(), startedAt: nowMs() });
   const t0 = nowMs();
diff --git a/mapPostAdminTransport.js b/src/mapPostAdminTransport.js
similarity index 93%
rename from mapPostAdminTransport.js
rename to src/mapPostAdminTransport.js
index 070947a..6f9fa8a 100644
--- a/mapPostAdminTransport.js
+++ b/src/mapPostAdminTransport.js
@@ -1,7 +1,6 @@
 import { INF, MAP_W, MAP_H, SIZE, MinHeap, indexOf, inside, xyOf } from "./mapUtils.js";
 import { pathLengthCells } from "./mapTransport.js";
-
-function cellKey(x, y) { return `${Math.round(x)},${Math.round(y)}`; }
+import { normalizeTransportPathSet, smoothRasterPath } from "./mapTransportUtils.js";
 
 function pathTouchesCell(path, x, y, radius = 0.65) {
   if (!path || path.length < 1) return false;
@@ -159,27 +158,7 @@ function nearestEntity(entities, p, maxDistance = Infinity) {
 }
 
 function dedupePaths(paths, sampleStep = 2) {
-  const seen = new Set();
-  const kept = [];
-  for (const path of paths || []) {
-    if (!path || path.length < 2) continue;
-    const cleaned = [];
-    for (const pt of path) {
-      const x = Math.round(pt[0]);
-      const y = Math.round(pt[1]);
-      if (!inside(x, y)) continue;
-      if (!cleaned.length || cleaned[cleaned.length - 1][0] !== x || cleaned[cleaned.length - 1][1] !== y) cleaned.push([x, y]);
-    }
-    if (cleaned.length < 2) continue;
-    const sigFor = (arr) => arr.map((p, i) => (i % sampleStep === 0 || i === arr.length - 1) ? `${p[0]},${p[1]}` : "").filter(Boolean).join("|");
-    const f = sigFor(cleaned);
-    const r = sigFor([...cleaned].reverse());
-    const sig = f < r ? f : r;
-    if (seen.has(sig)) continue;
-    seen.add(sig);
-    kept.push(cleaned);
-  }
-  return kept;
+  return normalizeTransportPathSet(paths, { sampleStep, mutate: false }).paths;
 }
 
 function addInterchange(interchanges, x, y, source = "post-admin-expressway-endpoint") {
@@ -191,22 +170,7 @@ function addInterchange(interchanges, x, y, source = "post-admin-expressway-endp
 }
 
 function smoothPath(path, passes = 1) {
-  let cur = (path || []).map(([x, y]) => [Math.round(x), Math.round(y)]);
-  for (let pass = 0; pass < passes; pass++) {
-    if (cur.length < 3) break;
-    const next = [cur[0]];
-    for (let i = 1; i < cur.length - 1; i++) {
-      const [ax, ay] = cur[i - 1];
-      const [bx, by] = cur[i];
-      const [cx, cy] = cur[i + 1];
-      const x = Math.round((ax + bx * 2 + cx) / 4);
-      const y = Math.round((ay + by * 2 + cy) / 4);
-      if (!next.length || next[next.length - 1][0] !== x || next[next.length - 1][1] !== y) next.push([x, y]);
-    }
-    next.push(cur[cur.length - 1]);
-    cur = next;
-  }
-  return cur;
+  return smoothRasterPath(path, passes);
 }
 
 function rebuildInfluence(paths, radius = 5) {
@@ -397,31 +361,6 @@ export function finalizeAdminAwareTransport({ seed, terrain, features, admin, ge
   debug.nationalTownChainTownsCovered = chainDebug.townsCovered;
   debug.nationalTownSpursAdded = chainDebug.chainsAdded;
 
-  function majorCityKey(city) { return city?.name || `${Math.round(city.x)},${Math.round(city.y)}`; }
-  function expresswayCityComponents(cities, radius = 8.0) {
-    const parent = new Map();
-    function find(k) {
-      const p = parent.get(k);
-      if (p === k) return k;
-      const r = find(p);
-      parent.set(k, r);
-      return r;
-    }
-    function unite(a, b) {
-      const ra = find(a), rb = find(b);
-      if (ra !== rb) parent.set(ra, rb);
-    }
-    for (const city of cities) parent.set(majorCityKey(city), majorCityKey(city));
-    for (const path of [...expressways, ...externalExpressways]) {
-      const near = cities.filter((city) => pathTouchesCell(path, city.x, city.y, radius));
-      if (near.length >= 2) {
-        const first = majorCityKey(near[0]);
-        for (const city of near.slice(1)) unite(first, majorCityKey(city));
-      }
-    }
-    return new Map(cities.map((city) => [majorCityKey(city), find(majorCityKey(city))]));
-  }
-
   function suburbanExpresswayAnchorForCity(city, target = null) {
     if (!city || !inside(city.x, city.y)) return null;
     const sea = terrain?.sea;
@@ -775,6 +714,30 @@ export function finalizeAdminAwareTransport({ seed, terrain, features, admin, ge
   features.expressways = dedupePaths(expressways, 2);
   features.externalExpressways = dedupePaths(externalExpressways, 2);
   features.railways = dedupePaths(features.railways || [], 2);
+  if (!features.railways.length) {
+    const railNodes = [...(features.modernCities || []), ...(features.markets || [])]
+      .filter((p) => p && inside(p.x, p.y) && !terrain?.sea?.[indexOf(p.x, p.y)])
+      .sort((a, b) => ((b.population || 0) + (b.isPrefecturalCapital ? 800000 : 0)) - ((a.population || 0) + (a.isPrefecturalCapital ? 800000 : 0)));
+    let fallbackRail = [];
+    for (let a = 0; a < Math.min(8, railNodes.length) && !fallbackRail.length; a++) {
+      const candidates = railNodes.slice(a + 1, Math.min(14, railNodes.length))
+        .sort((p, q) => Math.hypot(p.x - railNodes[a].x, p.y - railNodes[a].y) - Math.hypot(q.x - railNodes[a].x, q.y - railNodes[a].y));
+      for (const target of candidates) {
+        const direct = Math.hypot(target.x - railNodes[a].x, target.y - railNodes[a].y);
+        if (direct < 10 || direct > 150) continue;
+        fallbackRail = routeTerrainPath(railNodes[a], target, terrain, { maxLength: direct * 2.8 + 60, maxSeaRun: 0, maxTunnelRun: 14, snapRadius: 2.0 });
+        if (!fallbackRail.length) fallbackRail = directPath(railNodes[a], target, { maxLength: direct * 1.7 + 28, terrain, maxSeaRun: 0, maxTunnelRun: 14 });
+        if (fallbackRail.length >= 4) break;
+        fallbackRail = [];
+      }
+    }
+    if (fallbackRail.length >= 4) {
+      features.railways.push(smoothPath(fallbackRail, 1));
+      debug.guaranteedRailFallbackAdded = 1;
+    } else {
+      debug.guaranteedRailFallbackAdded = 0;
+    }
+  }
   features.interchanges = interchanges;
 
   // Final invariant: after all dedupe passes, every municipal office cell has at least a local road cell on it.
diff --git a/mapPrefectureStage.js b/src/mapPrefectureStage.js
similarity index 88%
rename from mapPrefectureStage.js
rename to src/mapPrefectureStage.js
index 986e887..1764d0b 100644
--- a/mapPrefectureStage.js
+++ b/src/mapPrefectureStage.js
@@ -1,6 +1,7 @@
 import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, hash2, indexOf, inside, xyOf } from "./mapUtils.js";
+import { averageFieldAcrossOwnerBorders } from "./mapAdminShared.js";
 
-export function buildMunicipalityGraph(adminId, prefectureMask, sea, naturalBarrierScore, populationDensity, settlementFeatures = [], geography = {}) {
+function buildMunicipalityGraph(adminId, prefectureMask, sea, naturalBarrierScore, populationDensity, settlementFeatures = [], geography = {}) {
   const nodes = new Map();
   const edges = new Map();
   for (let i = 0; i < SIZE; i++) {
@@ -93,15 +94,15 @@ export function buildMunicipalityGraph(adminId, prefectureMask, sea, naturalBarr
   return { nodes, edges };
 }
 
-export function choosePrefectureMunicipalitySeeds(nodes, seed) {
+function choosePrefectureMunicipalitySeeds(nodes, seed) {
   const active = [...nodes.values()].filter((node) => node.area > 0).sort((a, b) => b.area - a.area || a.id - b.id);
   const totalArea = active.reduce((sum, node) => sum + node.area, 0);
   // Real Japan's smallest prefecture by municipality count is roughly Toyama's 15.
   // Keep generated prefectures near that scale by limiting prefecture count unless
   // enough municipalities exist to give each prefecture a meaningful set.
-  const minMunicipalitiesPerPrefecture = 14;
+  const minMunicipalitiesPerPrefecture = 10;
   const maxByMunicipalityCount = Math.max(3, Math.floor(active.length / minMunicipalitiesPerPrefecture));
-  const areaBased = clamp(Math.round(totalArea / 7800), 3, 6);
+  const areaBased = clamp(Math.round(totalArea / 6200), 4, 6);
   const targetCount = clamp(Math.min(areaBased, maxByMunicipalityCount || areaBased), 3, 6);
   const seeds = [];
   const minSpacing = Math.max(18, Math.sqrt(totalArea / Math.max(1, targetCount)) * 0.46);
@@ -142,48 +143,7 @@ export function choosePrefectureMunicipalitySeeds(nodes, seed) {
 }
 
 
-export function chooseSecondStagePrefectureMunicipalitySeeds(nodes, initialOwner, initialSeeds, context = {}) {
-  const { seed = 0, allowOffscreenCapitals = true } = context;
-  const prefIds = [...new Set(initialOwner.values())].sort((a, b) => a - b);
-  const seeds = [];
-  const usedNodeIds = new Set();
-  const offscreenPrefectureSeeds = [];
-  function scoreNode(node, prefId) {
-    if (!node) return -INF;
-    const populationCore = (node.cityPopulation || 0) * 1.55 + (node.settlementPopulation || 0) * 0.42 + (node.population || 0) * 900;
-    const civicCore = (node.majorCityCount || 0) * 420000 + (node.centrality || 0) * 76000 + (node.accessibility || 0) * 52000 + (node.habitability || 0) * 18000;
-    const terrainPenalty = (node.geographicBarrier || 0) * 62000;
-    const edgeBonus = allowOffscreenCapitals && node.touchesOutside ? 95000 : 0;
-    const jitter = hash2(seed + 331, node.id * 17 + prefId * 41) * 2500;
-    return populationCore + civicCore + edgeBonus - terrainPenalty + jitter;
-  }
-  for (const prefId of prefIds) {
-    const members = [...nodes.values()].filter((node) => initialOwner.get(node.id) === prefId);
-    if (!members.length) continue;
-    const insideCapitalCandidate = members
-      .filter((node) => (node.cityPopulation || 0) >= 45000 || (node.settlementPopulation || 0) >= 70000 || (node.majorCityCount || 0) > 0)
-      .sort((a, b) => scoreNode(b, prefId) - scoreNode(a, prefId))[0] || null;
-    const edgeCandidate = allowOffscreenCapitals
-      ? members
-          .filter((node) => node.touchesOutside && node.area >= 8)
-          .sort((a, b) => scoreNode(b, prefId) - scoreNode(a, prefId))[0] || null
-      : null;
-    const useOffscreen = edgeCandidate && (!insideCapitalCandidate || scoreNode(edgeCandidate, prefId) > scoreNode(insideCapitalCandidate, prefId) + 35000);
-    const chosen = useOffscreen ? edgeCandidate : (insideCapitalCandidate || edgeCandidate || members.sort((a, b) => scoreNode(b, prefId) - scoreNode(a, prefId))[0]);
-    if (chosen && !usedNodeIds.has(chosen.id)) {
-      seeds.push(chosen);
-      usedNodeIds.add(chosen.id);
-      if (useOffscreen) offscreenPrefectureSeeds.push({ prefId, nodeId: chosen.id, x: Math.round(chosen.x), y: Math.round(chosen.y) });
-    }
-  }
-  if (!seeds.length) seeds.push(...(initialSeeds || []).filter(Boolean));
-  seeds.minMunicipalitiesPerPrefecture = initialSeeds?.minMunicipalitiesPerPrefecture || 14;
-  seeds.offscreenPrefectureSeeds = offscreenPrefectureSeeds;
-  seeds.secondStage = true;
-  return seeds;
-}
-
-export function assignMunicipalitiesToPrefectures(nodes, seeds) {
+function assignMunicipalitiesToPrefectures(nodes, seeds) {
   const owner = new Map();
   const area = new Map();
   const heap = new MinHeap();
@@ -218,7 +178,7 @@ export function assignMunicipalitiesToPrefectures(nodes, seeds) {
 }
 
 
-export function chooseSecondStagePrefectureSeeds(nodes, firstOwner, originalSeeds = [], seed = 0) {
+function chooseSecondStagePrefectureSeeds(nodes, firstOwner, originalSeeds = [], seed = 0) {
   const prefIds = [...new Set(firstOwner.values())].filter((id) => id >= 0).sort((a, b) => a - b);
   const used = new Set();
   const seeds = [];
@@ -264,7 +224,7 @@ export function chooseSecondStagePrefectureSeeds(nodes, firstOwner, originalSeed
   return seeds;
 }
 
-export function repairPrefectureMunicipalityConnectivity(nodes, owner) {
+function repairPrefectureMunicipalityConnectivity(nodes, owner) {
   let changed = 0;
   for (let pass = 0; pass < 8; pass++) {
     let passChanged = 0;
@@ -313,7 +273,7 @@ export function repairPrefectureMunicipalityConnectivity(nodes, owner) {
   return changed;
 }
 
-export function repairPrefectureMunicipalityEnclaves(nodes, owner, maxPasses = 6) {
+function repairPrefectureMunicipalityEnclaves(nodes, owner, maxPasses = 6) {
   let changed = 0;
   for (let pass = 0; pass < maxPasses; pass++) {
     let passChanged = 0;
@@ -356,7 +316,7 @@ export function repairPrefectureMunicipalityEnclaves(nodes, owner, maxPasses = 6
   return changed;
 }
 
-export function lockCompactUrbanMunicipalitiesToSinglePrefecture(owner, adminId, context, maxCells = 2600) {
+function lockCompactUrbanMunicipalitiesToSinglePrefecture(owner, adminId, context, maxCells = 2600) {
   const { prefectureMask, sea, landuse, populationDensity } = context;
   if (!owner || !adminId || !landuse) return 0;
   const seen = new Uint8Array(SIZE);
@@ -411,7 +371,7 @@ export function lockCompactUrbanMunicipalitiesToSinglePrefecture(owner, adminId,
   return changedMunicipalities;
 }
 
-export function lockCityMetroMunicipalitiesToSinglePrefecture(owner, adminId, context) {
+function lockCityMetroMunicipalitiesToSinglePrefecture(owner, adminId, context) {
   const { prefectureMask, sea, landuse, populationDensity, modernCities = [] } = context;
   if (!owner || !adminId || !modernCities?.length) return 0;
   let changed = 0;
@@ -459,7 +419,7 @@ export function lockCityMetroMunicipalitiesToSinglePrefecture(owner, adminId, co
 }
 
 
-export function lockLivingSphereMunicipalitiesToSinglePrefecture(owner, nodes, adminId, context) {
+function lockLivingSphereMunicipalitiesToSinglePrefecture(owner, nodes, adminId, context) {
   const { prefectureMask, sea, modernCities = [], markets = [], ports = [] } = context || {};
   if (!owner || !nodes || !adminId) return 0;
   const hubs = [
@@ -523,7 +483,7 @@ export function lockLivingSphereMunicipalitiesToSinglePrefecture(owner, nodes, a
   return changed;
 }
 
-export function mergeTinyMunicipalityPrefectures(nodes, owner) {
+function mergeTinyMunicipalityPrefectures(nodes, owner) {
   let changed = 0;
   for (let pass = 0; pass < 6; pass++) {
     const areaByPref = new Map();
@@ -559,7 +519,7 @@ export function mergeTinyMunicipalityPrefectures(nodes, owner) {
 }
 
 
-export function extractPrefectureBordersFromMunicipalities(adminId, municipalityToPrefectureId, prefectureMask, sea) {
+function extractPrefectureBordersFromMunicipalities(adminId, municipalityToPrefectureId, prefectureMask, sea) {
   const segments = [];
   for (let y = 0; y < MAP_H; y++) {
     for (let x = 0; x < MAP_W; x++) {
@@ -582,22 +542,13 @@ export function extractPrefectureBordersFromMunicipalities(adminId, municipality
 }
 
 
-export function prefectureMunicipalityCounts(owner) {
+function prefectureMunicipalityCounts(owner) {
   const counts = new Map();
   for (const pref of owner.values()) counts.set(pref, (counts.get(pref) || 0) + 1);
   return counts;
 }
 
-export function ownerMembersByPref(owner) {
-  const by = new Map();
-  for (const [id, pref] of owner) {
-    if (!by.has(pref)) by.set(pref, []);
-    by.get(pref).push(id);
-  }
-  return by;
-}
-
-export function wouldRemainConnectedAfterRemoval(nodes, owner, adminId, prefId) {
+function wouldRemainConnectedAfterRemoval(nodes, owner, adminId, prefId) {
   const members = [...nodes.keys()].filter((id) => owner.get(id) === prefId && id !== adminId);
   if (members.length <= 1) return true;
   const memberSet = new Set(members);
@@ -614,7 +565,7 @@ export function wouldRemainConnectedAfterRemoval(nodes, owner, adminId, prefId)
   return seen.size === members.length;
 }
 
-export function rebalanceSmallPrefecturesByMunicipalityCount(nodes, owner, minCount = 14, maxPasses = 96) {
+function rebalanceSmallPrefecturesByMunicipalityCount(nodes, owner, minCount = 14, maxPasses = 96) {
   let changed = 0;
   for (let pass = 0; pass < maxPasses; pass++) {
     const counts = prefectureMunicipalityCounts(owner);
@@ -650,7 +601,7 @@ export function rebalanceSmallPrefecturesByMunicipalityCount(nodes, owner, minCo
   return changed;
 }
 
-export function mergePersistentlyTinyPrefecturesByCount(nodes, owner, minCount = 12, minRemainingPrefectures = 2) {
+function mergePersistentlyTinyPrefecturesByCount(nodes, owner, minCount = 12, minRemainingPrefectures = 2) {
   let changed = 0;
   for (let pass = 0; pass < 16; pass++) {
     const counts = prefectureMunicipalityCounts(owner);
@@ -699,7 +650,7 @@ export function mergePersistentlyTinyPrefecturesByCount(nodes, owner, minCount =
 }
 
 
-export function splitOversizedPrefecturesByMunicipalityCount(nodes, owner, maxCount = 88, maxPrefectures = 8) {
+function splitOversizedPrefecturesByMunicipalityCount(nodes, owner, maxCount = 88, maxPrefectures = 8) {
   let changed = 0;
   for (let pass = 0; pass < 10; pass++) {
     const counts = prefectureMunicipalityCounts(owner);
@@ -749,7 +700,55 @@ export function splitOversizedPrefecturesByMunicipalityCount(nodes, owner, maxCo
 }
 
 
-export function relaxHighBoundaryShareMunicipalities(nodes, owner, options = {}) {
+
+function rebalancePrefectureAreas(nodes, owner, maxAreaShare = 0.39, maxPasses = 180) {
+  let changed = 0;
+  for (let pass = 0; pass < maxPasses; pass++) {
+    const area = new Map();
+    let total = 0;
+    for (const [id, pref] of owner) {
+      const nodeArea = nodes.get(id)?.area || 0;
+      area.set(pref, (area.get(pref) || 0) + nodeArea);
+      total += nodeArea;
+    }
+    if (!total || area.size < 2) break;
+    const sourceRow = [...area.entries()].sort((a, b) => b[1] - a[1] || a[0] - b[0])[0];
+    if (!sourceRow || sourceRow[1] / total <= maxAreaShare) break;
+    const source = sourceRow[0];
+    const candidates = [];
+    for (const [id, pref] of owner) {
+      if (pref !== source) continue;
+      const node = nodes.get(id);
+      if (!node || (node.majorCityCount || 0) > 0 || (node.cityPopulation || 0) >= 180000) continue;
+      if (!wouldRemainConnectedAfterRemoval(nodes, owner, id, source)) continue;
+      const neighborRows = new Map();
+      for (const [nextId, edge] of node.adjacent || []) {
+        const target = owner.get(nextId);
+        if (target === undefined || target < 0 || target === source) continue;
+        const row = neighborRows.get(target) || { target, shared: 0, cost: 0 };
+        row.shared += edge.count || 1;
+        row.cost += edge.crossingCost ?? (1 + (edge.barrier || 0) * 8.5);
+        neighborRows.set(target, row);
+      }
+      for (const row of neighborRows.values()) {
+        const targetArea = area.get(row.target) || 0;
+        if ((targetArea + (node.area || 0)) / total > maxAreaShare + 0.035) continue;
+        const balanceGain = (sourceRow[1] - targetArea) / total;
+        const score = balanceGain * 28 + row.shared * 1.8 - row.cost * 0.42 - Math.sqrt(node.area || 1) * 0.025;
+        candidates.push({ id, source, target: row.target, score });
+      }
+    }
+    const best = candidates.sort((a, b) => b.score - a.score || a.id - b.id)[0];
+    if (!best) break;
+    owner.set(best.id, best.target);
+    changed++;
+    repairPrefectureMunicipalityConnectivity(nodes, owner);
+    repairPrefectureMunicipalityEnclaves(nodes, owner, 4);
+  }
+  return changed;
+}
+
+function relaxHighBoundaryShareMunicipalities(nodes, owner, options = {}) {
   const threshold = options.threshold ?? 0.50;
   const maxPasses = options.maxPasses ?? 5;
   const minSharedToTarget = options.minSharedToTarget ?? 2;
@@ -811,7 +810,7 @@ export function relaxHighBoundaryShareMunicipalities(nodes, owner, options = {})
   return changed;
 }
 
-export function lockPrefectureCapitalNeighborMunicipalities(owner, nodes, seeds = [], maxNeighbors = 6) {
+function lockPrefectureCapitalNeighborMunicipalities(owner, nodes, seeds = [], maxNeighbors = 6) {
   let changed = 0;
   const seedIds = new Set((seeds || []).map((node) => node?.id).filter((id) => id !== undefined));
   for (const seedNode of seeds || []) {
@@ -840,28 +839,6 @@ export function lockPrefectureCapitalNeighborMunicipalities(owner, nodes, seeds
   return changed;
 }
 
-function averageRegionalBorderField(adminId, municipalityToPrefectureId, prefectureMask, sea, field) {
-  if (!field) return 0;
-  let sum = 0;
-  let count = 0;
-  for (let y = 1; y < MAP_H - 1; y++) {
-    for (let x = 1; x < MAP_W - 1; x++) {
-      const i = indexOf(x, y);
-      if (!prefectureMask[i] || sea[i] || adminId[i] < 0) continue;
-      const a = municipalityToPrefectureId[adminId[i]] ?? -1;
-      for (const [nx, ny] of [[x + 1, y], [x, y + 1]]) {
-        const ni = indexOf(nx, ny);
-        if (!prefectureMask[ni] || sea[ni] || adminId[ni] < 0) continue;
-        const b = municipalityToPrefectureId[adminId[ni]] ?? -1;
-        if (a < 0 || b < 0 || a === b) continue;
-        sum += ((field[i] || 0) + (field[ni] || 0)) * 0.5;
-        count++;
-      }
-    }
-  }
-  return count ? sum / count : 0;
-}
-
 export function generatePrefecturesFromMunicipalities(context, adminResult) {
   const { adminId } = adminResult;
   const { prefectureMask, sea, naturalBarrierScore, populationDensity, landuse, modernCities, markets, ports, seed, geography = null, habitability = null, accessibility = null, centrality = null, adminBoundaryPreference = null, boundaryAvoidance = null, geographicBarrier = null } = context;
@@ -884,9 +861,11 @@ export function generatePrefecturesFromMunicipalities(context, adminResult) {
   changedForMetroUnification += lockCityMetroMunicipalitiesToSinglePrefecture(owner, adminId, { prefectureMask, sea, landuse, populationDensity, modernCities });
   const changedForPostRepairLivingSphereUnification = lockLivingSphereMunicipalitiesToSinglePrefecture(owner, graph.nodes, adminId, { prefectureMask, sea, modernCities, markets, ports });
   const changedForMunicipalityCountRebalance = rebalanceSmallPrefecturesByMunicipalityCount(graph.nodes, owner, seeds.minMunicipalitiesPerPrefecture || 14);
-  const changedForTinyPrefectureCountMerge = mergePersistentlyTinyPrefecturesByCount(graph.nodes, owner, Math.max(13, (seeds.minMunicipalitiesPerPrefecture || 14) - 1));
+  const minimumRegionalCount = Math.min(4, Math.max(2, seeds.length));
+  const changedForTinyPrefectureCountMerge = mergePersistentlyTinyPrefecturesByCount(graph.nodes, owner, Math.max(8, (seeds.minMunicipalitiesPerPrefecture || 10) - 2), minimumRegionalCount);
   const changedForPostMergeMunicipalityCountRebalance = rebalanceSmallPrefecturesByMunicipalityCount(graph.nodes, owner, Math.max(12, (seeds.minMunicipalitiesPerPrefecture || 14) - 1), 64);
-  const changedForOversizedPrefectureSplit = splitOversizedPrefecturesByMunicipalityCount(graph.nodes, owner, 88, 8);
+  const changedForOversizedPrefectureSplit = splitOversizedPrefecturesByMunicipalityCount(graph.nodes, owner, 44, 8);
+  const changedForAreaRebalance = rebalancePrefectureAreas(graph.nodes, owner, 0.39, 180);
   changedForConnectivity += repairPrefectureMunicipalityConnectivity(graph.nodes, owner);
   // Rebalancing and oversized splitting can create small municipality-level
   // exclaves. Run enclave/connectivity repair as the final owner operation so
@@ -946,6 +925,7 @@ export function generatePrefecturesFromMunicipalities(context, adminResult) {
       prefectureMunicipalityCountRebalanceChangedMunicipalities: (changedForMunicipalityCountRebalance || 0) + (changedForPostMergeMunicipalityCountRebalance || 0),
       prefectureTinyMunicipalityCountMergeChangedMunicipalities: changedForTinyPrefectureCountMerge || 0,
       prefectureOversizedCountSplitChangedMunicipalities: changedForOversizedPrefectureSplit || 0,
+      prefectureAreaRebalanceChangedMunicipalities: changedForAreaRebalance || 0,
       prefectureCapitalNeighborLockChangedMunicipalities: changedForCapitalNeighborLock || 0,
       prefectureBoundaryShareRelaxationChangedMunicipalities: changedForBoundaryShareRelaxation || 0,
       finalRegionalMaxMunicipalityCount: Math.max(...prefectureMunicipalityCounts(owner).values()),
@@ -955,9 +935,9 @@ export function generatePrefecturesFromMunicipalities(context, adminResult) {
       finalRegionalTinyPrefectureCount: [...areaByPref.values()].filter((area) => area < 520).length,
       finalRegionalPrefectureBorderCount: regionalPrefectureBorders.length,
       regionalPrefectureBordersRebuiltFromFinalId: true,
-      finalRegionalBorderUnifiedBoundaryPreferenceAverage: averageRegionalBorderField(adminId, municipalityToPrefectureId, prefectureMask, sea, geographyFields.adminBoundaryPreference),
-      finalRegionalBorderUnifiedBoundaryAvoidanceAverage: averageRegionalBorderField(adminId, municipalityToPrefectureId, prefectureMask, sea, geographyFields.boundaryAvoidance),
-      finalRegionalBorderUnifiedCentralityAverage: averageRegionalBorderField(adminId, municipalityToPrefectureId, prefectureMask, sea, geographyFields.centrality),
+      finalRegionalBorderUnifiedBoundaryPreferenceAverage: averageFieldAcrossOwnerBorders((i) => municipalityToPrefectureId[adminId[i]] ?? -1, prefectureMask, sea, geographyFields.adminBoundaryPreference),
+      finalRegionalBorderUnifiedBoundaryAvoidanceAverage: averageFieldAcrossOwnerBorders((i) => municipalityToPrefectureId[adminId[i]] ?? -1, prefectureMask, sea, geographyFields.boundaryAvoidance),
+      finalRegionalBorderUnifiedCentralityAverage: averageFieldAcrossOwnerBorders((i) => municipalityToPrefectureId[adminId[i]] ?? -1, prefectureMask, sea, geographyFields.centrality),
     },
   };
 }
diff --git a/mapTerrain.js b/src/mapTerrain.js
similarity index 93%
rename from mapTerrain.js
rename to src/mapTerrain.js
index 497084e..f3d6769 100644
--- a/mapTerrain.js
+++ b/src/mapTerrain.js
@@ -1,10 +1,10 @@
-import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, createMapFields, fbm, hash2, indexOf, inside, lerp, pickEntities, rand, smoothstep, valueNoise, xyOf } from "./mapUtils.js";
+import { INF, MAP_H, MAP_W, SIZE, MinHeap, clamp, createMapFields, fbm, hash2, indexOf, inside, lerp, pickEntities, rand, smoothstep, valueNoise } from "./mapUtils.js";
 import {
   extractMaskBorder,
   makePrefectureMask,
   neighbors8,
 } from "./mapGeneratorHelpers.js";
-import { buildNaturalCompartments } from "./adminRegions.js";
+import { buildNaturalCompartments } from "./adminRegionsCore.js";
 import { createRectContext, createRectTerrainFields, rectIndexOf, rectInside, rectNeighbors8, rectQuantile } from "./rectContext.js";
 
 const ASPECT = MAP_W / MAP_H;
@@ -160,7 +160,6 @@ const TERRAIN_TYPES = [
   {
     id: "tohoku_spine",
     label: "東北型・長大脊梁",
-    weight: 0.24,
     coastStyle: "parallel_spine",
     mountainMode: "range",
     massifnessRange: [0.06, 0.26],
@@ -185,7 +184,6 @@ const TERRAIN_TYPES = [
   {
     id: "chubu_mountain",
     label: "中部型・交差高山地",
-    weight: 0.24,
     coastStyle: "outer_coast",
     mountainMode: "massif",
     massifnessRange: [0.42, 0.74],
@@ -209,15 +207,15 @@ const TERRAIN_TYPES = [
   },
   {
     id: "oceanic_archipelago",
-    label: "海洋型・多島海",
-    weight: 0.16,
+    label: "Ocean",
+    autoSelectable: false,
     coastStyle: "oceanic_archipelago",
     mountainMode: "mixed",
     massifnessRange: [0.04, 0.28],
-    seaRatioRange: [0.72, 0.90],
+    seaRatioRange: [0.955, 0.985],
     twoSidedChance: 1.0,
     mountainOffsetRange: [0.25, 0.55],
-    baseHeightRange: [0.30, 0.62],
+    baseHeightRange: [0.20, 0.46],
     primaryLengthRange: [0.20, 0.52],
     primaryWidthRange: [0.08, 0.24],
     systemCountRange: [7, 14],
@@ -227,7 +225,7 @@ const TERRAIN_TYPES = [
     lengthScale: 0.78,
     widthScale: 0.82,
     heightScale: 0.58,
-    coastStrength: 1.55,
+    coastStrength: 2.10,
     plainBiasRange: [0.12, 0.34],
     riverRichnessRange: [0.18, 0.52],
     bigRiverChanceRange: [0.02, 0.12],
@@ -235,24 +233,23 @@ const TERRAIN_TYPES = [
   {
     id: "setouchi_inland_sea",
     label: "瀬戸内型・内海多島",
-    weight: 0.16,
     coastStyle: "inland_sea",
     mountainMode: "mixed",
     massifnessRange: [0.34, 0.62],
-    seaRatioRange: [0.28, 0.43],
-    twoSidedChance: 0.92,
+    seaRatioRange: [0.40, 0.56],
+    twoSidedChance: 0.96,
     mountainOffsetRange: [0.22, 0.34],
     baseHeightRange: [0.46, 0.78],
     primaryLengthRange: [0.52, 0.78],
     primaryWidthRange: [0.20, 0.38],
-    systemCountRange: [16, 22],
-    beltCountRange: [3, 4],
+    systemCountRange: [20, 28],
+    beltCountRange: [4, 5],
     angleSpread: 0.34,
     crossSpread: 0.86,
-    lengthScale: 1.00,
-    widthScale: 1.18,
-    heightScale: 0.82,
-    coastStrength: 1.34,
+    lengthScale: 0.92,
+    widthScale: 1.02,
+    heightScale: 0.78,
+    coastStrength: 1.52,
     plainBiasRange: [0.26, 0.50],
     riverRichnessRange: [0.58, 0.96],
     bigRiverChanceRange: [0.18, 0.42],
@@ -260,7 +257,6 @@ const TERRAIN_TYPES = [
   {
     id: "kanto_alluvial",
     label: "関東・濃尾型・大河川平野",
-    weight: 0.16,
     coastStyle: "open_bay",
     mountainMode: "range",
     massifnessRange: [0.10, 0.30],
@@ -285,7 +281,6 @@ const TERRAIN_TYPES = [
   {
     id: "mixed_archipelago",
     label: "混合型・列島変化",
-    weight: 0.20,
     coastStyle: "mixed_archipelago",
     mountainMode: "mixed",
     massifnessRange: [0.16, 0.72],
@@ -315,11 +310,11 @@ function pickTerrainType(seed, requestedType = "auto") {
     const selected = TERRAIN_TYPES.find((type) => type.id === normalizedType);
     if (selected) return selected;
   }
-  // Terrain type selection is intentionally uniform.  Individual terrain
-  // templates still contain their own parameter ranges, but there is no
-  // terrain-type appearance weighting.
-  const index = Math.floor(rand(seed, 10001) * TERRAIN_TYPES.length) % TERRAIN_TYPES.length;
-  return TERRAIN_TYPES[index];
+  // Auto excludes explicitly manual/special-purpose templates such as Ocean.
+  // The selection remains uniform over ordinary land-bearing templates.
+  const autoTypes = TERRAIN_TYPES.filter((type) => type.autoSelectable !== false);
+  const index = Math.floor(rand(seed, 10001) * autoTypes.length) % autoTypes.length;
+  return autoTypes[index];
 }
 
 function rangeValue(seed, salt, [lo, hi]) {
@@ -330,7 +325,7 @@ function rangeInt(seed, salt, [lo, hi]) {
   return Math.round(lo + rand(seed, salt) * (hi - lo));
 }
 
-export function buildTerrainTemplate(seed, options = {}) {
+function buildTerrainTemplate(seed, options = {}) {
   const terrainType = pickTerrainType(seed, options.terrainType || options.generationType || "auto");
   const mountainMode = terrainType.mountainMode === "mixed"
     ? (rand(seed, 12) < 0.42 ? "range" : rand(seed, 13) < 0.72 ? "mixed" : "massif")
@@ -365,6 +360,12 @@ export function buildTerrainTemplate(seed, options = {}) {
     coastStyle: terrainType.coastStyle,
     seaRatio,
     coastAngle,
+    coastAxis: (() => {
+      const ax = Math.abs(Math.cos(coastAngle));
+      const ay = Math.abs(Math.sin(coastAngle));
+      return Math.abs(ax - ay) < 0.22 ? "diagonal" : ax > ay ? "north-south" : "east-west";
+    })(),
+    coastSides: twoSidedCoast ? ["negative", "positive"] : ["primary", "inland"],
     twoSidedCoast,
     coastNoise: 0.040 + rand(seed, 33) * 0.056,
     coastStrength: terrainType.coastStrength,
@@ -1078,8 +1079,18 @@ function buildRiverNetwork(seed, template, sea, lake, elevation, slope, flowTo,
   const sortedPaths = longPaths.map((p) => p.path);
   const mainRivers = sortedPaths.filter((p) => mainSet.has(p)).slice(0, mainCount);
   const nonMainPaths = sortedPaths.filter((p) => !mainSet.has(p));
-  const tributaryRivers = nonMainPaths.slice(0, 24);
-  const smallStreams = nonMainPaths.slice(24, 74);
+  const tributaryCount = Math.min(24, Math.max(1, Math.ceil(nonMainPaths.length * 0.62)));
+  const tributaryRivers = nonMainPaths.slice(0, tributaryCount);
+  let smallStreams = nonMainPaths.slice(tributaryCount, 74);
+  // Sparse/mountainous templates can yield only a handful of accepted flow paths.
+  // Preserve a visible third-order network by exposing the upper reaches of
+  // tributaries as short streams rather than reporting an empty layer.
+  if (!smallStreams.length) {
+    smallStreams = tributaryRivers
+      .slice(0, Math.min(10, tributaryRivers.length))
+      .map((path) => path.slice(0, Math.max(3, Math.floor(path.length * 0.48))))
+      .filter((path) => path.length >= 3);
+  }
   return { riverPaths: sortedPaths.slice(0, 80), mainRivers, tributaryRivers, smallStreams };
 }
 
@@ -1097,6 +1108,10 @@ function deriveFields(seed, template, fields, seaLevel) {
   const riverMask = new Uint8Array(SIZE);
   for (let i = 0; i < SIZE; i++) if (river[i] > 0.18) riverMask[i] = 1;
   const riverDist = distanceField(riverMask, 40);
+  const landElevationValues = [];
+  for (let i = 0; i < SIZE; i++) if (!sea[i]) landElevationValues.push(elevation[i]);
+  const lowlandQuantile = template.terrainType === "chubu_mountain" || template.terrainType === "tohoku_spine" ? 0.24 : 0.31;
+  const lowlandElevationCeiling = quantile(landElevationValues, lowlandQuantile);
 
   for (let y = 1; y < MAP_H - 1; y++) {
     for (let x = 1; x < MAP_W - 1; x++) {
@@ -1116,11 +1131,19 @@ function deriveFields(seed, template, fields, seaLevel) {
       const low = clamp((0.52 - e) * 1.70);
       const lowSlope = clamp((0.34 - slope[i]) * 2.8);
       const riverGate = clamp(riverNear * 0.72 + flowAccum[i] * 0.82 + coast * 0.70 + basinField[i] * 0.20 - ridgeField[i] * 0.40);
-      plain[i] = clamp(low * lowSlope * (0.12 + template.plainBias * 0.34 + riverGate * 0.84));
+      const percentileLowland = clamp((lowlandElevationCeiling + 0.055 - e) * 6.2) * clamp((0.42 - slope[i]) * 3.0) * clamp(1 - ridgeField[i] * 0.88);
+      const broadPlain = percentileLowland * clamp(0.42 + template.plainBias * 0.70 + basinField[i] * 0.22 + coast * 0.18 + riverNear * 0.10);
+      plain[i] = clamp(Math.max(
+        low * lowSlope * (0.18 + template.plainBias * 0.52 + riverGate * 0.86),
+        broadPlain
+      ));
       floodplain[i] = clamp(lowSlope * riverNear * (0.35 + flowAccum[i] * 0.82 + river[i] * 0.52));
       deltaField[i] = clamp(coast * river[i] * 1.4 + coast * flowAccum[i] * 0.72);
       alluvialFanField[i] = clamp(riverNear * clamp(slope[i] * 2.5) * clamp((0.58 - e) * 1.7) * clamp(ridgeField[i] * 0.8 + arcSpineField[i] * 0.4));
-      depositionalLowland[i] = clamp(floodplain[i] * 0.54 + deltaField[i] * 0.66 + alluvialFanField[i] * 0.42 + coast * 0.28 + basinField[i] * 0.18);
+      depositionalLowland[i] = clamp(Math.max(
+        floodplain[i] * 0.54 + deltaField[i] * 0.66 + alluvialFanField[i] * 0.42 + coast * 0.28 + basinField[i] * 0.18,
+        percentileLowland * (0.28 + template.deposition * 0.30 + basinField[i] * 0.16)
+      ));
       depositionField[i] = clamp(depositionalLowland[i] * (0.25 + template.deposition * 0.30));
       agriculture[i] = clamp(plain[i] * 0.72 + floodplain[i] * 0.42 + depositionalLowland[i] * 0.36 - slope[i] * 0.20);
       visibleRavineField[i] = clamp(visibleRavineField[i] + valleyField[i] * 0.22 + erosionField[i] * 0.35);
@@ -1174,8 +1197,8 @@ function enforceLandGradient(elevation, sea, seaLevel) {
 function rectTerrainProfile(template) {
   const id = String(template?.terrainType || "auto");
   if (id.includes("oceanic")) return {
-    base: 0.36, relief: 0.19, ridge: 0.30, ridgeWidth: 22, ridgeSpacing: 76, coast: 0.34, archipelago: 0.28,
-    seaQuantile: Math.max(0.68, template.seaRatio ?? 0.76), plain: 0.20, moisture: 0.60, capStart: 0.64, capMax: 0.86,
+    base: 0.28, relief: 0.11, ridge: 0.20, ridgeWidth: 18, ridgeSpacing: 70, coast: 0.52, archipelago: 0.18,
+    seaQuantile: Math.max(0.95, template.seaRatio ?? 0.965), plain: 0.12, moisture: 0.66, capStart: 0.56, capMax: 0.74,
   };
   if (id.includes("setouchi") || id.includes("archipelago")) return {
     base: 0.43, relief: 0.18, ridge: 0.34, ridgeWidth: 30, ridgeSpacing: 94, coast: 0.25, archipelago: 0.20,
@@ -1697,7 +1720,16 @@ export function generateTerrainRect(options = {}) {
     }
   }
 
-  const seaLevel = clamp(Number.isFinite(options.seaLevel) ? options.seaLevel : rectQuantile(elevation, profile.seaQuantile), 0.13, 0.50);
+  const seaLevel = Number.isFinite(options.seaLevel)
+    // A supplied value is a world invariant, not a local terrain-profile hint.
+    // Keep only broad numeric safety limits so a high-sea-level world does not
+    // silently fall back to a patch-local cap.
+    ? clamp(options.seaLevel, 0.02, 0.95)
+    : clamp(
+      rectQuantile(elevation, profile.seaQuantile),
+      0.13,
+      terrainTemplate.terrainType === "oceanic_archipelago" ? 0.72 : 0.50
+    );
   const oceanCells = classifyRectWater(ctx, fields, seaLevel);
   recomputeRectSlope(ctx, fields);
   const filled = priorityFloodRect(ctx, fields);
@@ -1799,22 +1831,6 @@ export function finalizeRectTerrainForFixedMap(seed, terrain, options = {}) {
   };
 }
 
-export function generateInitialTerrainRect(seed, options = {}) {
-  const variant = Number.isFinite(options.initialVariant) ? Math.max(0, Math.floor(options.initialVariant)) : 0;
-  const terrain = generateTerrainRect({
-    ...options,
-    seed,
-    variant,
-    originX: 0,
-    originY: 0,
-    width: MAP_W,
-    height: MAP_H,
-    name: "initial-full-map",
-  });
-  return finalizeRectTerrainForFixedMap(seed, terrain, options);
-}
-
-
 export function generateTerrainAndRivers(seed, options = {}) {
   const generationContext = options.generationContext || {};
   const originX = Math.floor(Number.isFinite(options.originX) ? options.originX : (Number.isFinite(generationContext.originX) ? generationContext.originX : 0));
@@ -1836,13 +1852,21 @@ export function generateTerrainAndRivers(seed, options = {}) {
   const terrainTemplate = buildTerrainTemplate(seed, options);
   const systems = buildMountainSystems(terrainTemplate, seed);
   const allRidges = systems.flatMap((system, id) => buildScratchRidges(system, seed, id));
+  const terrainFrameScale = clamp(Number.isFinite(options.terrainFrameScale) ? options.terrainFrameScale : 1, 1, 2.5);
+  const terrainFrameOffsetX = clamp(Number.isFinite(options.terrainFrameOffsetX) ? options.terrainFrameOffsetX : 0, -0.28, 0.28);
+  const terrainFrameOffsetY = clamp(Number.isFinite(options.terrainFrameOffsetY) ? options.terrainFrameOffsetY : 0, -0.24, 0.24);
 
   for (let y = 0; y < MAP_H; y++) {
     for (let x = 0; x < MAP_W; x++) {
       const i = indexOf(x, y);
       const wx = originX + x;
       const wy = originY + y;
-      const { px, py } = normalizeCoord(x, y);
+      const normalized = normalizeCoord(x, y);
+      // Expansion candidates are a crop from a larger virtual production map.
+      // This removes the initial generator's deliberate edge-ocean frame from
+      // the user's lasso boundary while retaining the same terrain system.
+      const px = 0.5 + (normalized.px - 0.5) / terrainFrameScale + terrainFrameOffsetX;
+      const py = 0.5 + (normalized.py - 0.5) / terrainFrameScale + terrainFrameOffsetY;
       const terrainLarge = (fbm(wx * 0.65, wy * 0.65, seed + 1) - 0.5) * 0.23;
       const terrainRegional = (valueNoise(wx * 0.8, wy * 0.8, seed + 2, 42) - 0.5) * 0.16;
       const { pressure: coastPressure } = computeCoastLower(px, py, terrainTemplate, seed);
@@ -1891,16 +1915,19 @@ export function generateTerrainAndRivers(seed, options = {}) {
         e -= high * clamp(0.18 + mountainMaskMax * 0.22, 0.18, 0.40);
       }
       if (terrainTemplate.terrainType === "setouchi_inland_sea") {
-        // Setouchi maps should have many low hills and island backbones rather
-        // than a few high alpine ridges. Add broad low relief, then cap peaks.
-        const lowHillNoise = clamp((fbm(wx * 0.95 + 17, wy * 0.95 - 23, seed + 571) - 0.38) * 2.9);
-        const lowHillMask = clamp(0.34 + mountainMaskMax * 0.72 + lowHillNoise * 0.50 - coastPressure * 0.12);
-        e += lowHillMask * 0.145;
-        // Do not add the previous fine speckle uplift here: it created too many
-        // tiny islets.  Sea amount is controlled by seaRatio/coast pressure.
-        e -= clamp((coastPressure - 0.42) * 1.35) * 0.026;
-        const high = Math.max(0, e - 0.62);
-        e -= high * 0.42;
+        // Setouchi should read as sea-dominant, with many compact wooded island
+        // backbones rather than broad continental ridges.  The small-massif term
+        // is band-limited so it forms believable islands, not one-cell speckle.
+        const lowHillNoise = clamp((fbm(wx * 0.95 + 17, wy * 0.95 - 23, seed + 571) - 0.39) * 2.7);
+        const islandMassif = clamp((fbm(wx * 1.85 - 31, wy * 1.85 + 19, seed + 573) - 0.50) * 3.4);
+        const islandBackbone = clamp((valueNoise(wx * 2.8 + 7, wy * 2.8 - 11, seed + 574, 9) - 0.54) * 3.2);
+        const coastalIslandBias = clamp(coastPressure * 0.64 + mountainMaskMax * 0.46 + lowHillNoise * 0.24);
+        e += lowHillNoise * 0.090;
+        e += islandMassif * coastalIslandBias * 0.105;
+        e += islandBackbone * coastalIslandBias * 0.045;
+        e -= clamp((coastPressure - 0.34) * 1.55) * 0.044;
+        const high = Math.max(0, e - 0.60);
+        e -= high * 0.48;
       }
       if (terrainTemplate.terrainType === "oceanic_archipelago") {
         // 海洋型は大きな山塊ではなく、島列を読むための低い起伏を点在させる。
@@ -1922,7 +1949,7 @@ export function generateTerrainAndRivers(seed, options = {}) {
   }
 
   let seaLevel = quantile(elevation, terrainTemplate.seaRatio);
-  seaLevel = clamp(seaLevel, 0.14, 0.47);
+  seaLevel = clamp(seaLevel, 0.14, terrainTemplate.terrainType === "oceanic_archipelago" ? 0.72 : 0.47);
   classifyWater(elevation, seaLevel, sea, ocean, lake);
   recomputeSlope(elevation, sea, slope);
 
@@ -1985,6 +2012,9 @@ export function generateTerrainAndRivers(seed, options = {}) {
     height: MAP_H,
     variant,
     worldNative,
+    terrainFrameScale,
+    terrainFrameOffsetX,
+    terrainFrameOffsetY,
   };
 
   return {
diff --git a/mapTransport.js b/src/mapTransport.js
similarity index 83%
rename from mapTransport.js
rename to src/mapTransport.js
index 887bd6f..77c46cd 100644
--- a/mapTransport.js
+++ b/src/mapTransport.js
@@ -1,5 +1,5 @@
-import { INF, MAP_H, MAP_W, SIZE, clamp, hash2, indexOf, inside, pickEntities, xyOf } from "./mapUtils.js";
-import { distanceToNearest, influenceFromPaths, samplePath } from "./mapGeneratorHelpers.js";
+import { INF, MAP_H, MAP_W, SIZE, clamp, distanceToNearestPoint, hash2, indexOf, inside, pickEntities, xyOf } from "./mapUtils.js";
+import { influenceFromPaths } from "./mapGeneratorHelpers.js";
 import {
   assessExpresswayRoute,
   assessMountainRoute,
@@ -10,12 +10,12 @@ import {
   makeSpatialIndex,
   makeUnionFind,
   meanFieldAround as meanFieldAroundBase,
-  nearestNetworkPoint,
-  packDebugField,
   pathCumulativeLengths,
   pathAverageField,
   pathEndpoints,
   pathLengthCells,
+  occupancyComponentsFromPathGroups,
+  spatialIndexesByKey,
   pointAtPathDistance,
   sampledNetworkCells as sampledNetworkCellsBase,
   splitPathToValidCells as splitPathToValidCellsBase,
@@ -24,7 +24,6 @@ import {
 } from "./mapTransportUtils.js";
 export {
   createPathInfluenceCache,
-  packDebugField,
   pathAverageField,
   pathLengthCells,
   pathSetSignature,
@@ -48,8 +47,19 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     routeBetweenTrafficCandidates, traceCorridorByCost, addCorridorInfluencePenalty,
     relaxRouteToTerrain, transportRouteAcceptable, repairTransportConnectivity,
     repairDanglingTransportEndpoints, pruneDanglingTerminalSegments, pruneParallelSameMode,
+    onProgress,
+    patchMode = false,
+    largePatchTile = false,
   } = ctx;
 
+  let roadTimingMark = Date.now();
+  function markRoadTiming(key) {
+    const now = Date.now();
+    const ms = now - roadTimingMark;
+    roadTimingMark = now;
+    onProgress?.({ status: "road-step", key: `road:${key}`, label: `Road stage: ${key}`, roadTiming: { key, ms } });
+  }
+
   // --- OD-corridor road generation ---------------------------------------
   // Roads are generated as corridors first; hierarchy-specific labels are
   // assigned by corridor purpose. This replaces the older field-corridor
@@ -271,10 +281,6 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     return assessExpresswayRoute(path, options, pathTerrainRisk, expresswayProximityRisk, routePolicies);
   }
 
-  function expresswayRouteAcceptable(path, options = {}) {
-    return expresswayRouteAssessment(path, options).ok;
-  }
-
   function routeAcceptableForMode(path, mode, potentialField, penalty, limits = {}, expresswayOptions = {}) {
     if (mode === "expressway") {
       return expresswayRouteAssessment(path, expresswayOptions);
@@ -671,23 +677,6 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     return true;
   }
 
-  function sanitizeLocalRoads() {
-    const before = minorRoads.length;
-    const kept = [];
-    let pruned = 0;
-    for (const path of minorRoads) {
-      if (!path || path.length < 2) { pruned++; continue; }
-      const len = pathLengthCells(path);
-      const maxLength = len > 58 ? 68 : 78;
-      if (localRouteAcceptableStrict(path, { maxLength })) kept.push(path);
-      else pruned++;
-    }
-    minorRoads.length = 0;
-    minorRoads.push(...kept);
-    return { before, after: minorRoads.length, pruned };
-  }
-
-
   function removePathSelfLoops(path) {
     if (!path || path.length < 2) return path || [];
     const out = [];
@@ -767,6 +756,8 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     }
     expressways.length = 0;
     expressways.push(...cleaned);
+    markRoadTiming("national-outbound");
+
     pruneParallelSameMode(expressways, "expressway", transportFields.expresswayPotential, { threshold: 0.08, radius: 92, minKeep: 1, shortLength: 220 });
     if (debug) debug.expresswaySanitization = { before, after: expressways.length, loopTrimmed, urbanPruned, shortPruned };
     return { before, after: expressways.length, loopTrimmed, urbanPruned, shortPruned };
@@ -1205,36 +1196,42 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
   function buildDensityFlowRoadSystem(debug) {
     const expressAnchors = roadAnchorsForMode("expressway");
     const nationalAnchors = roadAnchorsForMode("national");
+    markRoadTiming("anchors");
     debug.majorCitySuburbanAnchors = expressAnchors
       .filter((p) => p.role === "urban-fringe-ic")
       .map((p) => ({ x: p.x, y: p.y, city: p.city?.name, population: p.population }));
 
-    const expressFlow = buildTrafficFlowField("expressway", expressAnchors, expresswayCorridorCost, 10);
+    const expressFlow = buildTrafficFlowField("expressway", expressAnchors, expresswayCorridorCost, largePatchTile ? 4 : 10);
     const expressCost = fieldAdjustedCost(expresswayCorridorCost, "expressway", expressFlow);
+    markRoadTiming("express-flow");
     buildFieldBackbone(debug, "expressway", expressways, expressAnchors, expressCost, transportFields.expresswayPotential, {
       ...roadMode("expressway").backbone,
-      maxNodes: 34,
-      maxAdded: Math.min(3, Math.max(2, Math.ceil(expressAnchors.length / 14))),
+      maxNodes: largePatchTile ? 18 : 34,
+      maxAdded: largePatchTile ? Math.min(2, Math.max(1, Math.ceil(expressAnchors.length / 18))) : Math.min(3, Math.max(2, Math.ceil(expressAnchors.length / 14))),
     });
-    ensureExpresswayCityIntercity(debug, expressAnchors, expressCost);
+    if (!largePatchTile) ensureExpresswayCityIntercity(debug, expressAnchors, expressCost);
+    markRoadTiming("express-backbone");
 
     // Recompute national flow with expressways already present.  National roads
     // are allowed to cross/approach motorways but are discouraged from becoming
     // a duplicate motorway frontage road for long distances.
-    const nationalFlow = buildTrafficFlowField("national", nationalAnchors, transportFields.national, 34);
+    const nationalFlow = buildTrafficFlowField("national", nationalAnchors, transportFields.national, largePatchTile ? 12 : 34);
     const nationalCost = fieldAdjustedCost(transportFields.national, "national", nationalFlow);
+    markRoadTiming("national-flow");
     buildFieldBackbone(debug, "national", nationalRoads, nationalAnchors, nationalCost, transportFields.nationalPotential, {
       ...roadMode("national").backbone,
-      maxNodes: 58,
-      maxAdded: Math.min(27, Math.max(13, Math.ceil(nationalAnchors.length * 0.34))),
+      maxNodes: largePatchTile ? 32 : 58,
+      maxAdded: largePatchTile ? Math.min(12, Math.max(6, Math.ceil(nationalAnchors.length * 0.18))) : Math.min(27, Math.max(13, Math.ceil(nationalAnchors.length * 0.34))),
     });
 
+    markRoadTiming("national-backbone");
+
     // Guarantee light national access to large urban areas whose portals were
     // deduped away.  The target remains a portal/field anchor, not the city point.
     const nationalInfluence = influenceFromPaths([...nationalRoads, ...externalRoads], 7);
     const nationalPenalty = influenceFromPaths(nationalRoads, 6);
     const nationalTargets = dedupeAnchors([...nationalAnchors, ...externalGateways.map((g) => ({ ...g, role: "external-gateway", population: 42000, score: 0.92 }))], 5);
-    for (const city of modernCities.filter((c) => (c.population || 0) >= 90000).sort((a, b) => (b.population || 0) - (a.population || 0))) {
+    for (const city of (largePatchTile ? [] : modernCities.filter((c) => (c.population || 0) >= 90000).sort((a, b) => (b.population || 0) - (a.population || 0)))) {
       if ((nationalInfluence[indexOf(city.x, city.y)] || 0) > 0.18) continue;
       const portals = cityPortalAnchors(city, "national");
       const start = portals[0] || portalSearchAroundPoint(city, "national", "urban-portal");
@@ -1263,17 +1260,26 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
       }
     }
 
-    ensureNationalCityOutbound(debug, nationalAnchors, nationalCost);
+    markRoadTiming("national-city-guarantee");
+    if (!largePatchTile) ensureNationalCityOutbound(debug, nationalAnchors, nationalCost);
+
+    markRoadTiming(largePatchTile ? "national-outbound-deferred" : "national-outbound");
 
     pruneParallelSameMode(expressways, "expressway", transportFields.expresswayPotential, { threshold: 0.08, radius: 92, minKeep: 1, shortLength: 220 });
     pruneParallelSameMode(nationalRoads, "national", transportFields.nationalPotential, { threshold: 0.62, radius: 2, minKeep: 10, shortLength: 18 });
 
-    // Pruning may remove short stubs that were serving as the only outward
-    // connection for a city. Run the hard city-outbound guarantees after pruning
-    // as the final road graph invariant.
-    ensureExpresswayCityIntercity(debug, expressAnchors, expressCost);
-    ensureNationalCityOutbound(debug, nationalAnchors, nationalCost);
+    markRoadTiming("parallel-prune");
+
+    // Full-map generation re-runs the hard city-outbound guarantees after pruning.
+    // Patch candidates are merged into an existing world and receive a final
+    // whole-selection transport repair later; repeating these searches per tile
+    // can become pathologically expensive on particular candidate terrains.
+    if (!patchMode) {
+      ensureExpresswayCityIntercity(debug, expressAnchors, expressCost);
+      ensureNationalCityOutbound(debug, nationalAnchors, nationalCost);
+    }
     sanitizeExpresswayNetwork(debug);
+    markRoadTiming(patchMode ? "final-guarantees-deferred" : "final-guarantees");
   }
 
   function rebuildRoadTransportByCorridors() {
@@ -1333,84 +1339,125 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     return false;
   }
 
-  function stitchRasterNearContacts() {
-    const debug = { expressway: 0, national: 0, localToNational: 0, local: 0, broadNearMisses: 0 };
-    function stitchEndpoints(paths, mode, targets, maxAdds, radius, probability = 1) {
+  function stitchDisconnectedRoadGaps() {
+    const debug = { expressway: 0, national: 0, localToNational: 0, local: 0 };
+
+    function componentLabels(pathGroups) {
+      const { labels, count } = occupancyComponentsFromPathGroups(pathGroups, {
+        maxDistanceSq: 2,
+        accept: (_x, _y, i) => !sea[i],
+      });
+      const parent = new Int32Array(count);
+      for (let i = 0; i < count; i++) parent[i] = i;
+      const find = (x) => {
+        let root = x;
+        while (parent[root] !== root) root = parent[root];
+        while (parent[x] !== x) { const next = parent[x]; parent[x] = root; x = next; }
+        return root;
+      };
+      const unite = (a, b) => {
+        if (a < 0 || b < 0) return false;
+        const ra = find(a), rb = find(b);
+        if (ra === rb) return false;
+        parent[rb] = ra;
+        return true;
+      };
+      return { label: labels, find, unite, count };
+    }
+
+    function tagComponents(points, state) {
+      return (points || []).map((p) => ({ ...p, component: inside(p.x, p.y) ? state.label[indexOf(p.x, p.y)] : -1 }));
+    }
+
+    function stitchEndpoints(paths, mode, targets, state, maxAdds, radius, probability = 1) {
       let added = 0;
-      const endpoints = pathEndpoints(paths);
+      const endpoints = tagComponents(pathEndpoints(paths), state);
+      const indexedTargets = tagComponents(targets, state).filter((p) => p.component >= 0);
+      const indexesByComponent = spatialIndexesByKey(indexedTargets, (p) => p.component, Math.max(6, Math.min(18, radius)));
       for (const ep of endpoints) {
         if (added >= maxAdds) break;
+        if (ep.component < 0) continue;
         if (probability < 1 && hash2(ep.x, ep.y, seed + 18331 + added * 17) > probability) continue;
-        const near = nearestNetworkPoint(ep, targets, radius);
-        if (near && addShortConnector(paths, ep, near.target, mode)) added++;
+        const epRoot = state.find(ep.component);
+        let best = null;
+        for (const [component, targetIndex] of indexesByComponent) {
+          if (state.find(component) === epRoot) continue;
+          for (const target of targetIndex.near(ep.x, ep.y, radius)) {
+            const d = Math.hypot(ep.x - target.x, ep.y - target.y);
+            if (d <= 0.01 || d > radius || (best && d >= best.d)) continue;
+            best = { target, d };
+          }
+        }
+        if (!best) continue;
+        if (addShortConnector(paths, ep, best.target, mode)) {
+          state.unite(ep.component, best.target.component);
+          added++;
+        }
       }
       return added;
     }
-    const expresswayCells = sampledNetworkCellsBase(expressways, 1, sea);
+
+    // Ordinary roads share one component state.  This prevents the former
+    // local->trunk and local->local passes from repeatedly connecting paths that
+    // were already joined through another road class.
+    const ordinaryState = componentLabels([nationalRoads, externalRoads, minorRoads]);
     const nationalCells = sampledNetworkCellsBase([...nationalRoads, ...externalRoads], 1, sea);
     const localCells = sampledNetworkCellsBase(minorRoads, 1, sea);
-    debug.expressway += stitchEndpoints(expressways, "expressway", expresswayCells, 14, 46.0, 0.62);
-    debug.national += stitchEndpoints(nationalRoads, "national", nationalCells, 48, 14.0);
-    debug.localToNational += stitchEndpoints(minorRoads, "local", nationalCells, 240, 20.0);
-    debug.local += stitchEndpoints(minorRoads, "local", localCells, 260, 16.0);
+    debug.national = stitchEndpoints(nationalRoads, "national", nationalCells, ordinaryState, 48, 14.0);
+    debug.localToNational = stitchEndpoints(minorRoads, "local", nationalCells, ordinaryState, 120, 20.0);
+    debug.local = stitchEndpoints(minorRoads, "local", localCells, ordinaryState, 120, 17.0);
 
-    // Also stitch near-miss interiors: visually crossing/adjacent roads that do
-    // not share a raster cell.  This addresses line simplification and diagonal
-    // near-contact cases not caught by endpoint-only repair.
-    const allLocalTargets = [...nationalCells, ...localCells];
-    const candidates = sampledNetworkCellsBase([...nationalRoads, ...minorRoads], 3, sea)
-      .sort((a, b) => hash2(a.x, a.y, seed + 18377) - hash2(b.x, b.y, seed + 18377));
-    for (const c of candidates) {
-      if (debug.broadNearMisses >= 260) break;
-      const near = nearestNetworkPoint(c, allLocalTargets, 4.75);
-      if (!near) continue;
-      const out = c.pathId < nationalRoads.length ? nationalRoads : minorRoads;
-      const mode = out === nationalRoads ? "national" : "local";
-      if (addShortConnector(out, c, near.target, mode)) debug.broadNearMisses++;
-    }
-    // Expressway stitching can add new motorway cells; remove loopbacks before
-    // regenerating the IC/access layer so final spacing is applied to the
-    // simplified motorway graph.
-    sanitizeExpresswayNetwork();
-    generateInterchangesForExpressways();
-    return debug;
-  }
-
-  function stitchLongLocalBranches() {
-    const debug = { localToTrunk: 0, localToLocal: 0 };
-    const trunkCells = sampledNetworkCellsBase([...nationalRoads, ...externalRoads], 2, sea);
-    const localCells = sampledNetworkCellsBase(minorRoads, 2, sea);
-    const eps = pathEndpoints(minorRoads)
+    // Secondary-road density is a generation concern, not a connectivity
+    // repair.  Add a bounded set of short loop/mesh closures between different
+    // local paths that already belong to the same road component.  This replaces
+    // the former repair spray that happened to create most of the local mesh.
+    debug.localMeshClosures = 0;
+    const localEndpoints = tagComponents(pathEndpoints(minorRoads), ordinaryState)
       .sort((a, b) => hash2(a.x, a.y, seed + 18491) - hash2(b.x, b.y, seed + 18491));
-    for (const ep of eps) {
-      if (debug.localToTrunk >= 160) break;
-      const hit = nearestNetworkPoint(ep, trunkCells, 20, { excludeSamePath: false });
-      if (!hit) continue;
-      if (addShortConnector(minorRoads, ep, hit, "local")) debug.localToTrunk++;
+    const localTargets = tagComponents(sampledNetworkCellsBase(minorRoads, 1, sea), ordinaryState);
+    const localTargetIndex = makeSpatialIndex(localTargets, 12);
+    const usedMeshEndpoints = new Set();
+    const meshBudget = Math.min(180, Math.max(48, Math.round((villages.length + markets.length + ports.length) * 1.35)));
+    for (const ep of localEndpoints) {
+      if (debug.localMeshClosures >= meshBudget) break;
+      if (ep.component < 0 || usedMeshEndpoints.has(ep.pathId)) continue;
+      let best = null;
+      for (const target of localTargetIndex.near(ep.x, ep.y, 13.5)) {
+        if (target.component < 0 || target.pathId === ep.pathId) continue;
+        if (ordinaryState.find(ep.component) !== ordinaryState.find(target.component)) continue;
+        const d = Math.hypot(ep.x - target.x, ep.y - target.y);
+        if (d < 3.0 || d > 13.5 || (best && d >= best.d)) continue;
+        best = { target, d };
+      }
+      if (!best) continue;
+      if (addShortConnector(minorRoads, ep, best.target, "local")) {
+        usedMeshEndpoints.add(ep.pathId);
+        usedMeshEndpoints.add(best.target.pathId);
+        debug.localMeshClosures++;
+      }
     }
-    const eps2 = pathEndpoints(minorRoads)
-      .sort((a, b) => hash2(a.x, a.y, seed + 18493) - hash2(b.x, b.y, seed + 18493));
-    for (const ep of eps2) {
-      if (debug.localToLocal >= 150) break;
-      const hit = nearestNetworkPoint(ep, localCells, 17, { excludePath: ep.pathId });
-      if (!hit) continue;
-      if (addShortConnector(minorRoads, ep, hit, "local")) debug.localToLocal++;
+
+    // Motorways stay topologically separate from ordinary roads; only close
+    // genuine gaps between different motorway components.
+    const expressState = componentLabels([expressways, externalExpressways]);
+    const expresswayCells = sampledNetworkCellsBase([...expressways, ...externalExpressways], 1, sea);
+    debug.expressway = stitchEndpoints(expressways, "expressway", expresswayCells, expressState, 10, 46.0, 0.62);
+
+    if (debug.expressway > 0) {
+      sanitizeExpresswayNetwork();
+      if (!patchMode) generateInterchangesForExpressways();
     }
     return debug;
   }
 
   const corridorRoadNetworkDebug = rebuildRoadTransportByCorridors();
+  markRoadTiming("corridor-rebuild");
 
   const transportDebugLayers = {
-    packedHeatmaps: true,
-    expresswayPotential: packDebugField(transportFields.expresswayPotential),
-    railPotential: packDebugField(transportFields.railPotential),
-    nationalRoadPotential: packDebugField(transportFields.nationalPotential),
-    slopeSeaPenalty: (() => {
-      const src = new Float32Array(SIZE);
-      for (let i = 0; i < SIZE; i++) src[i] = sea[i] ? 1 : clamp(slope[i] * 1.55 + Math.max(0, elevation[i] - 0.58) * 2.2 + ridgeField[i] * 0.42);
-      return packDebugField(src);
-    })(),
+    // Raster heatmaps are derived only when the debug overlay is rendered.
+    // They are not part of generation quality or transport topology and used to
+    // require four full-map packing passes on every generation.
+    heatmapRecipe: "derived-on-demand-v1",
     components: [],
     repairedSegments: [],
     unservedSettlements: [],
@@ -1435,57 +1482,20 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
   // still needed to remove isolated fragments and near-miss components.  Keep
   // the repair budget bounded so it connects existing backbones rather than
   // recreating the removed field-generated spaghetti layer.
-  for (const repair of [
-    repairTransportConnectivity(expressways, "expressway", expresswayCorridorCost, transportFields.expresswayPotential, {
-      minImportance: 5.5,
-      minComponentCells: 10,
-      maxComponents: 6,
-      maxRepairs: 2,
-      maxRepairDistance: 125,
-      minRepairDistance: 18,
-      searchPad: 38,
-      penaltyRadius: 18,
-      penaltyStrength: 4.2,
-      curvePenalty: 0.13,
-      terrainFlowBias: 0.09,
-      surfaceGrain: 0.006,
-      relaxRadius: 1,
-      relaxLineWeight: 0.20,
-      highPotentialThreshold: 0.24,
-    }),
-    repairTransportConnectivity(nationalRoads, "national", transportFields.national, transportFields.nationalPotential, {
-      minImportance: 4.0,
-      minComponentCells: 7,
-      maxComponents: 10,
-      maxRepairs: 7,
-      maxRepairDistance: 82,
-      minRepairDistance: 8,
-      searchPad: 28,
-      penaltyRadius: 6,
-      penaltyStrength: 1.15,
-      curvePenalty: 0.060,
-      terrainFlowBias: 0.24,
-      surfaceGrain: 0.030,
-      relaxRadius: 2,
-      relaxLineWeight: 0.28,
-      highPotentialThreshold: 0.28,
-    }),
-    repairTransportConnectivity(railways, "rail", transportFields.rail, transportFields.railPotential, {
-      minImportance: 10.5,
-      minComponentCells: 18,
-      maxComponents: 5,
-      maxRepairs: 2,
-      maxRepairDistance: 92,
-      penaltyRadius: 7,
-      penaltyStrength: 2.0,
-      curvePenalty: 0.16,
-      terrainFlowBias: 0.13,
-      surfaceGrain: 0.008,
-      relaxRadius: 1,
-      relaxLineWeight: 0.50,
-      highPotentialThreshold: 0.36,
-    }),
-  ]) {
+  const connectivityRepairs = [];
+  connectivityRepairs.push(repairTransportConnectivity(expressways, "expressway", expresswayCorridorCost, transportFields.expresswayPotential, {
+    minImportance: 5.5, minComponentCells: 10, maxComponents: 6, maxRepairs: 2, maxRepairDistance: 125, minRepairDistance: 18, searchPad: 38, penaltyRadius: 18, penaltyStrength: 4.2, curvePenalty: 0.13, terrainFlowBias: 0.09, surfaceGrain: 0.006, relaxRadius: 1, relaxLineWeight: 0.20, highPotentialThreshold: 0.24,
+  }));
+  markRoadTiming("repair-expressway-connectivity");
+  connectivityRepairs.push(repairTransportConnectivity(nationalRoads, "national", transportFields.national, transportFields.nationalPotential, {
+    minImportance: 4.0, minComponentCells: 7, maxComponents: 10, maxRepairs: 7, maxRepairDistance: 82, minRepairDistance: 8, searchPad: 28, penaltyRadius: 6, penaltyStrength: 1.15, curvePenalty: 0.060, terrainFlowBias: 0.24, surfaceGrain: 0.030, relaxRadius: 2, relaxLineWeight: 0.28, highPotentialThreshold: 0.28,
+  }));
+  markRoadTiming("repair-national-connectivity");
+  connectivityRepairs.push(repairTransportConnectivity(railways, "rail", transportFields.rail, transportFields.railPotential, {
+    minImportance: 10.5, minComponentCells: 18, maxComponents: 5, maxRepairs: 2, maxRepairDistance: 92, penaltyRadius: 7, penaltyStrength: 2.0, curvePenalty: 0.16, terrainFlowBias: 0.13, surfaceGrain: 0.008, relaxRadius: 1, relaxLineWeight: 0.50, highPotentialThreshold: 0.36,
+  }));
+  markRoadTiming("repair-rail-connectivity");
+  for (const repair of connectivityRepairs) {
     transportDebugLayers.components.push(...repair.components);
     transportDebugLayers.repairedSegments.push(...repair.repairs);
   }
@@ -1516,6 +1526,7 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     penaltyRadius: 6,
     addedPenalty: 0.24,
   });
+  markRoadTiming("national-endpoint-repair");
   transportDebugLayers.endpointRepairs = [nationalEndpointRepair];
   transportDebugLayers.repairedSegments.push(...nationalEndpointRepair.added);
 
@@ -1533,6 +1544,7 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     penaltyStrength: 4.4,
     addedPenalty: 1.10,
   });
+  markRoadTiming("express-endpoint-repair");
   transportDebugLayers.endpointRepairs.push(expressEndpointRepair);
   transportDebugLayers.repairedSegments.push(...expressEndpointRepair.added);
   transportDebugLayers.expresswaySanitizationAfterRepair = sanitizeExpresswayNetwork();
@@ -1555,9 +1567,9 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
   transportDebugLayers.shortNationalDowngrade = downgradeShortNationalRoads(18, 10);
   transportDebugLayers.shortSegmentPruning = {
     expressway: pruneShortTransportSegments(expressways, 12, 1),
-    national: pruneShortTransportSegments(nationalRoads, 9, 8),
   };
 
+  markRoadTiming("short-prune");
   const expressTerminalPrune = pruneDanglingTerminalSegments(expressways, "expressway", [...externalExpressways, ...nationalRoads], {
     oneInvalidMax: 26,
     bothInvalidMax: 42,
@@ -1574,7 +1586,8 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
   transportDebugLayers.graphCandidateNetworks = [];
   transportDebugLayers.parallelPruning = [];
   transportDebugLayers.prunedDanglingSegments = [expressTerminalPrune, nationalTerminalPrune];
-  transportDebugLayers.expresswaySanitizationFinal = sanitizeExpresswayNetwork();
+
+  markRoadTiming("terminal-prune");
 
   function generateLocalRoadsForUnservedSettlements() {
     const trunkInfluence = cachedInfluenceFromPaths([...nationalRoads, ...railways, ...externalRoads], 8, "local:trunk");
@@ -1594,7 +1607,7 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     const served = [];
     for (const start of candidates) {
       if (paths.length >= 72) break;
-      if (distanceToNearest(served, start.x, start.y) < 4.5) continue;
+      if (distanceToNearestPoint(served, start.x, start.y) < 4.5) continue;
       let path = traceCorridorByCost(
         start,
         (x, y, i) => trunkInfluence[i] > 0.18 || (paths.length > 6 && localPenalty[i] > 0.045),
@@ -1628,7 +1641,7 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     let added = 0;
     for (const start of candidates) {
       if (added >= maxAdded) break;
-      if (distanceToNearest(served, start.x, start.y) < minSpacing) continue;
+      if (distanceToNearestPoint(served, start.x, start.y) < minSpacing) continue;
       let path = traceCorridorByCost(
         start,
         targetPredicate || ((x, y, i) => accessInfluence[i] > 0.16 || localPenalty[i] > 0.075),
@@ -1652,32 +1665,42 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
   }
 
   minorRoads.push(...generateLocalRoadsForUnservedSettlements());
-  const localEndpointRepair = repairDanglingTransportEndpoints(minorRoads, "local", transportFields.local, [...nationalRoads, ...externalRoads, ...railways], transportFields.localPotential, {
-    maxAdded: 22,
-    maxTargetDistance: 30,
-    curvePenalty: 0.055,
-    terrainFlowBias: 0.26,
-    surfaceGrain: 0.048,
-    relaxRadius: 2,
-    relaxLineWeight: 0.30,
-    targetRadius: 5,
-  });
+  markRoadTiming("local-access-generation");
+
+  const localEndpointRepair = patchMode
+    ? { mode: "local", added: [], skippedForPatchCandidate: true }
+    : repairDanglingTransportEndpoints(minorRoads, "local", transportFields.local, [...nationalRoads, ...externalRoads, ...railways], transportFields.localPotential, {
+      maxAdded: 22,
+      maxTargetDistance: 30,
+      curvePenalty: 0.055,
+      terrainFlowBias: 0.26,
+      surfaceGrain: 0.048,
+      relaxRadius: 2,
+      relaxLineWeight: 0.30,
+      targetRadius: 5,
+    });
   transportDebugLayers.endpointRepairs.push(localEndpointRepair);
   transportDebugLayers.repairedSegments.push(...localEndpointRepair.added);
-  const localDanglingPrune = pruneDanglingTerminalSegments(minorRoads, "local", [...nationalRoads, ...externalRoads, ...railways], {
-    oneInvalidMax: 11,
-    bothInvalidMax: 18,
-    minKeep: 24,
-  });
+  markRoadTiming("local-endpoint-repair");
+  const localDanglingPrune = patchMode
+    ? { mode: "local", pruned: 0, skippedForPatchCandidate: true }
+    : pruneDanglingTerminalSegments(minorRoads, "local", [...nationalRoads, ...externalRoads, ...railways], {
+      oneInvalidMax: 11,
+      bothInvalidMax: 18,
+      minKeep: 24,
+    });
   transportDebugLayers.prunedDanglingSegments.push(localDanglingPrune);
-  const localParallelPruning = pruneParallelSameMode(minorRoads, "local", transportFields.localPotential, {
-    threshold: 0.70,
-    radius: 1,
-    minKeep: 28,
-    shortLength: 13,
-  });
+  markRoadTiming("local-dangling-prune");
+  const localParallelPruning = patchMode
+    ? { mode: "local", pruned: 0, skippedForPatchCandidate: true }
+    : pruneParallelSameMode(minorRoads, "local", transportFields.localPotential, {
+      threshold: 0.70,
+      radius: 1,
+      minKeep: 28,
+      shortLength: 13,
+    });
   transportDebugLayers.parallelPruning.push(localParallelPruning);
-  transportDebugLayers.localSanitizationInitial = sanitizeLocalRoads();
+  markRoadTiming("local-parallel-prune");
   const sampledNetworkCells = (paths, step = 2) => sampledNetworkCellsBase(paths, step, sea);
 
   const nationalForIc = sampledNetworkCells([...nationalRoads, ...externalRoads], 2).map((q) => ({ ...q, roadClass: "national" }));
@@ -1850,11 +1873,15 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     }
   }
 
-  generateInterchangesForExpressways();
+  if (!patchMode) {
+    generateInterchangesForExpressways();
+    markRoadTiming("interchanges");
+  } else {
+    markRoadTiming("interchanges-deferred");
+  }
 
-  function connectAllRoadNetworksFinal(maxAdds = 72) {
+  function connectPreAdminRoadComponents(maxAdds = 72) {
     const debug = { beforeComponents: 0, afterComponents: 0, added: 0, failed: 0 };
-    const dirs = [[1,0],[-1,0],[0,1],[0,-1],[1,1],[1,-1],[-1,1],[-1,-1]];
     const roadGroups = () => [minorRoads, nationalRoads, externalRoads, expressways, externalExpressways];
     function groupCostField(groupIndex) {
       if (groupIndex === 3 || groupIndex === 4) return expresswayCorridorCost;
@@ -1880,75 +1907,14 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
       }
     }
     normalizeRoadGroups();
-    const keepAliveSettlements = dedupeAnchors([
-      ...modernCities,
-      ...markets,
-      ...villages.filter((p) => (p.population || 0) >= 600),
-      ...ports,
-    ], 4);
-    function pathNearKeptSettlement(path, radius = 7.5) {
-      if (!path?.length) return false;
-      for (const [x, y] of path) {
-        for (const p of keepAliveSettlements) {
-          if (Math.hypot(p.x - x, p.y - y) <= radius) return true;
-        }
-      }
-      return false;
+    function roadComponents() {
+      const { components } = occupancyComponentsFromPathGroups(roadGroups(), {
+        maxDistanceSq: 5,
+        accept: (_x, _y, i) => !sea[i],
+      });
+      return components.sort((a, b) => b.size - a.size);
     }
 
-    function roadComponents() {
-      const occ = new Uint8Array(SIZE);
-      function markSegmented(path, fn) {
-        for (let k = 0; k < (path?.length || 0); k++) {
-          const [x0, y0] = path[k];
-          const [x1, y1] = path[Math.min(k + 1, path.length - 1)];
-          const steps = Math.max(1, Math.ceil(Math.hypot(x1 - x0, y1 - y0)));
-          for (let s = 0; s <= steps; s++) {
-            const t = s / steps;
-            const x = Math.round(x0 + (x1 - x0) * t);
-            const y = Math.round(y0 + (y1 - y0) * t);
-            fn(x, y);
-          }
-        }
-      }
-      for (const group of roadGroups()) {
-        for (const path of group || []) {
-          markSegmented(path, (x, y) => {
-            if (inside(x, y) && !sea[indexOf(x, y)]) occ[indexOf(x, y)] = 1;
-          });
-        }
-      }
-      const seen = new Uint8Array(SIZE);
-      const comps = [];
-      for (let i = 0; i < SIZE; i++) {
-        if (!occ[i] || seen[i]) continue;
-        const queue = [i];
-        const cells = [];
-        seen[i] = 1;
-        let sx = 0, sy = 0;
-        for (let q = 0; q < queue.length; q++) {
-          const cur = queue[q];
-          cells.push(cur);
-          const [x, y] = xyOf(cur);
-          sx += x; sy += y;
-          for (let dy = -2; dy <= 2; dy++) {
-            for (let dx = -2; dx <= 2; dx++) {
-              if (!dx && !dy) continue;
-              if (dx * dx + dy * dy > 5) continue;
-              const nx = x + dx, ny = y + dy;
-              if (!inside(nx, ny)) continue;
-              const ni = indexOf(nx, ny);
-              if (!occ[ni] || seen[ni]) continue;
-              seen[ni] = 1;
-              queue.push(ni);
-            }
-          }
-        }
-        comps.push({ id: comps.length, cells, size: cells.length, cx: sx / Math.max(1, cells.length), cy: sy / Math.max(1, cells.length) });
-      }
-      comps.sort((a, b) => b.size - a.size);
-      return comps;
-    }
     function sampleComponent(comp, limit = 96) {
       const step = Math.max(1, Math.floor(comp.cells.length / limit));
       const out = [];
@@ -1975,150 +1941,81 @@ export function buildDensityFlowRoadTransportSystem(ctx) {
     }
     let comps = roadComponents();
     debug.beforeComponents = comps.length;
-    for (let pass = 0; pass < maxAdds && comps.length > 1; pass++) {
+    debug.attempted = 0;
+    debug.rounds = 0;
+    while (debug.added < maxAdds && comps.length > 1) {
+      debug.rounds++;
       const main = comps[0];
-      let best = null;
-      const candidates = comps.slice(1, Math.min(comps.length, 18));
-      for (const comp of candidates) {
+      const candidates = [];
+      for (const comp of comps.slice(1, Math.min(comps.length, 18))) {
         const pair = bestAnchorPair(main, comp);
         if (!pair) continue;
         const coastBridgeRisk = pair.d > 18 && approximateLineCost(pair.a, pair.b, transportFields.local) >= INF;
         if (coastBridgeRisk) continue;
-        const score = pair.d / Math.sqrt(Math.max(4, comp.size));
-        if (!best || score < best.score) best = { comp, pair, score };
+        candidates.push({ comp, pair, score: pair.d / Math.sqrt(Math.max(4, comp.size)) });
       }
-      if (!best) break;
-      const { a, b, d } = best.pair;
-      const penalty = cachedInfluenceFromPaths(minorRoads, 3, `all-road-connect:${pass}`);
-      if (d > 72) {
+      candidates.sort((a, b) => a.score - b.score || a.pair.d - b.pair.d);
+      if (!candidates.length) break;
+
+      // Influence is keyed by the actual path signature, so failed attempts in
+      // the same topology state reuse one grid instead of rebuilding it per pass.
+      const penalty = cachedInfluenceFromPaths(minorRoads, 3, "all-road-connect");
+      let connected = false;
+      for (const candidate of candidates) {
+        const { a, b, d } = candidate.pair;
+        debug.attempted++;
+        if (d > 72) { debug.failed++; continue; }
+        const routed = routeBetweenTrafficCandidates(a, b, "local", transportFields.local, penalty, {
+          curvePenalty: 0.055,
+          penaltyStrength: 0.55,
+          terrainFlowBias: 0.34,
+          surfaceGrain: 0.040,
+          relaxRadius: 1,
+          relaxLineWeight: 0.18,
+          maxPathLength: d * 2.05 + 24,
+          snapRadius: 0.5,
+          heuristicWeight: 0.50,
+          searchPad: Math.ceil(Math.max(12, Math.min(72, d * 0.45 + 10))),
+        });
+        const rawPath = routed?.length ? routed : (d <= 12 ? directLandConnector(a, b) : []);
+        const connectedPath = rawPath?.length ? [[a.x, a.y], ...rawPath, [b.x, b.y]] : [];
+        const dedupedPath = [];
+        for (const pt of connectedPath) {
+          if (!dedupedPath.length || dedupedPath[dedupedPath.length - 1][0] !== pt[0] || dedupedPath[dedupedPath.length - 1][1] !== pt[1]) dedupedPath.push(pt);
+        }
+        const routeLen = pathLengthCells(dedupedPath);
+        const terrainOk = localRouteAcceptableStrict(dedupedPath, { maxLength: Math.min(76, Math.max(26, d * 2.10 + 24)) })
+          && routeLen <= d * 2.15 + 24
+          && maxSegmentLength(dedupedPath) <= 1.6
+          && !routeTooStraightMountainOnly(dedupedPath);
+        if (!pathIsLand(dedupedPath) || !terrainOk) { debug.failed++; continue; }
+
+        const before = comps.length;
+        const minorBefore = minorRoads.slice();
+        minorRoads.push(dedupedPath);
+        normalizeRoadGroups();
+        const nextComps = roadComponents();
+        if (nextComps.length < before) {
+          debug.added++;
+          comps = nextComps;
+          connected = true;
+          break;
+        }
+        minorRoads.length = 0;
+        minorRoads.push(...minorBefore);
         debug.failed++;
-        comps.splice(comps.indexOf(best.comp), 1);
-        comps.push(best.comp);
-        continue;
       }
-      const routed = routeBetweenTrafficCandidates(a, b, "local", transportFields.local, penalty, {
-        curvePenalty: 0.055,
-        penaltyStrength: 0.55,
-        terrainFlowBias: 0.34,
-        surfaceGrain: 0.040,
-        relaxRadius: 1,
-        relaxLineWeight: 0.18,
-        maxPathLength: d * 2.05 + 24,
-        snapRadius: 0.5,
-        heuristicWeight: 0.50,
-        searchPad: Math.ceil(Math.max(12, Math.min(72, d * 0.45 + 10))),
-      });
-      const rawPath = routed?.length ? routed : (d <= 12 ? directLandConnector(a, b) : []);
-      const connectedPath = rawPath?.length ? [[a.x, a.y], ...rawPath, [b.x, b.y]] : [];
-      const dedupedPath = [];
-      for (const pt of connectedPath) {
-        if (!dedupedPath.length || dedupedPath[dedupedPath.length - 1][0] !== pt[0] || dedupedPath[dedupedPath.length - 1][1] !== pt[1]) dedupedPath.push(pt);
-      }
-      const routeLen = pathLengthCells(dedupedPath);
-      const terrainOk = localRouteAcceptableStrict(dedupedPath, { maxLength: Math.min(76, Math.max(26, d * 2.10 + 24)) })
-        && routeLen <= d * 2.15 + 24
-        && maxSegmentLength(dedupedPath) <= 1.6
-        && !routeTooStraightMountainOnly(dedupedPath);
-      if (!pathIsLand(dedupedPath) || !terrainOk) {
-        debug.failed++;
-        // Drop this candidate by marking it tiny relative to the main component for this pass.
-        comps.splice(comps.indexOf(best.comp), 1);
-        comps.push(best.comp);
-        continue;
-      }
-      const before = comps.length;
-      minorRoads.push(dedupedPath);
-      normalizeRoadGroups();
-      comps = roadComponents();
-      if (comps.length < before) debug.added++;
-      else debug.failed++;
-    }
-    for (let prunePass = 0; prunePass < 4; prunePass++) {
-      comps = roadComponents();
-      if (comps.length <= 1) break;
-      const mainMask = new Uint8Array(SIZE);
-      for (const ci of comps[0].cells) {
-        const [cx, cy] = xyOf(ci);
-        for (let dy = -2; dy <= 2; dy++) for (let dx = -2; dx <= 2; dx++) {
-          if (dx * dx + dy * dy > 5) continue;
-          const nx = cx + dx, ny = cy + dy;
-          if (inside(nx, ny)) mainMask[indexOf(nx, ny)] = 1;
-        }
-      }
-      function touchesMain(path) {
-        let hit = 0, n = 0;
-        for (let k = 0; k < (path?.length || 0); k++) {
-          const [x0, y0] = path[k];
-          const [x1, y1] = path[Math.min(k + 1, path.length - 1)];
-          const steps = Math.max(1, Math.ceil(Math.hypot(x1 - x0, y1 - y0)));
-          for (let s = 0; s <= steps; s++) {
-            const t = s / steps;
-            const x = Math.round(x0 + (x1 - x0) * t);
-            const y = Math.round(y0 + (y1 - y0) * t);
-            if (!inside(x, y) || sea[indexOf(x, y)]) continue;
-            n++;
-            if (mainMask[indexOf(x, y)]) hit++;
-          }
-        }
-        return n > 0 && hit / n >= (prunePass === 0 ? 0.12 : 0.01);
-      }
-      function pruneGroup(group, key) {
-        const kept = [];
-        let pruned = 0;
-        for (const path of group || []) {
-          if (touchesMain(path) || pathNearKeptSettlement(path)) kept.push(path);
-          else pruned++;
-        }
-        group.length = 0;
-        group.push(...kept);
-        debug.prunedIsolated[key] = (debug.prunedIsolated[key] || 0) + pruned;
-      }
-      if (!debug.prunedIsolated) debug.prunedIsolated = { minor: 0, national: 0, external: 0, expressway: 0, externalExpressway: 0 };
-      pruneGroup(minorRoads, "minor");
-      pruneGroup(nationalRoads, "national");
-      pruneGroup(externalRoads, "external");
-      pruneGroup(expressways, "expressway");
-      pruneGroup(externalExpressways, "externalExpressway");
+      if (!connected) break;
     }
+    // Do not prune road classes here. Administration still adds local/national
+    // access later, so deleting secondary components at this pre-admin stage is
+    // both premature and duplicated by the final admin-aware topology pass.
     normalizeRoadGroups();
-    // Absolute invariant for the rendered modern road graph: retain the largest
-    // terrain-valid component.  Unconnectable orphan fragments are more harmful
-    // than being absent, because they force implausible long repairs.
-    let finalComps = roadComponents();
-    if (finalComps.length > 1) {
-      const main = new Uint8Array(SIZE);
-      for (const ci of finalComps[0].cells) main[ci] = 1;
-      function pruneToMain(group, key) {
-        const kept = [];
-        let pruned = 0;
-        for (const path of group || []) {
-          let hit = 0;
-          let n = 0;
-          for (const [x, y] of path || []) {
-            if (!inside(x, y) || sea[indexOf(x, y)]) continue;
-            n++;
-            if (main[indexOf(x, y)]) hit++;
-          }
-          if (hit > 0 || n === 0 || pathNearKeptSettlement(path)) kept.push(path);
-          else pruned++;
-        }
-        group.length = 0;
-        group.push(...kept);
-        debug.prunedIsolated[key] = (debug.prunedIsolated[key] || 0) + pruned;
-      }
-      if (!debug.prunedIsolated) debug.prunedIsolated = { minor: 0, national: 0, external: 0, expressway: 0, externalExpressway: 0 };
-      pruneToMain(minorRoads, "minor");
-      pruneToMain(nationalRoads, "national");
-      pruneToMain(externalRoads, "external");
-      pruneToMain(expressways, "expressway");
-      pruneToMain(externalExpressways, "externalExpressway");
-      normalizeRoadGroups();
-      finalComps = roadComponents();
-    }
+    const finalComps = roadComponents();
     debug.afterComponents = finalComps.length;
     return debug;
   }
 
 
-  return { transportDebugLayers, corridorRoadNetworkDebug, runLocalAccessPass, stitchRasterNearContacts, stitchLongLocalBranches, sanitizeLocalRoads, downgradeShortNationalRoads, connectAllRoadNetworksFinal };
+  return { transportDebugLayers, corridorRoadNetworkDebug, runLocalAccessPass, stitchDisconnectedRoadGaps, downgradeShortNationalRoads, connectPreAdminRoadComponents };
 }
diff --git a/mapTransportGraph.js b/src/mapTransportGraph.js
similarity index 100%
rename from mapTransportGraph.js
rename to src/mapTransportGraph.js
diff --git a/mapTransportOD.js b/src/mapTransportOD.js
similarity index 95%
rename from mapTransportOD.js
rename to src/mapTransportOD.js
index 0094fe0..1375c4c 100644
--- a/mapTransportOD.js
+++ b/src/mapTransportOD.js
@@ -1,4 +1,4 @@
-import { INF, MAP_H, MAP_W, SIZE, clamp, hash2, indexOf, inside, pickEntities } from "./mapUtils.js";
+import { INF, SIZE, clamp, finiteFieldValue, hash2, indexOf, inside } from "./mapUtils.js";
 import { makeUnionFind, pathAverageField, pathLengthCells } from "./mapTransportUtils.js";
 
 // Phase 3: unified OD rail model
@@ -64,11 +64,6 @@ export function buildUnifiedRailODNetwork(ctx) {
 
   const reject = (reason) => { debug.rejected[reason] = (debug.rejected[reason] || 0) + 1; };
 
-  function fieldValue(field, i, fallback = 0) {
-    const v = field?.[i];
-    return Number.isFinite(v) ? v : fallback;
-  }
-
   function railCostAt(x, y) {
     if (!inside(x, y)) return INF;
     const i = indexOf(x, y);
@@ -83,10 +78,10 @@ export function buildUnifiedRailODNetwork(ctx) {
     const i = inside(p.x, p.y) ? indexOf(p.x, p.y) : -1;
     if (i < 0) return fallback;
     return Math.max(fallback, Math.round(
-      fieldValue(preliminaryUrbanInfluence, i) * 160000 +
-      fieldValue(preliminaryTownInfluence, i) * 65000 +
-      fieldValue(preliminaryVillageInfluence, i) * 15000 +
-      fieldValue(settlementDemand, i) * 45000
+      finiteFieldValue(preliminaryUrbanInfluence, i) * 160000 +
+      finiteFieldValue(preliminaryTownInfluence, i) * 65000 +
+      finiteFieldValue(preliminaryVillageInfluence, i) * 15000 +
+      finiteFieldValue(settlementDemand, i) * 45000
     ));
   }
 
@@ -104,11 +99,11 @@ export function buildUnifiedRailODNetwork(ctx) {
         if (d < inner || d > outer) continue;
         const i = indexOf(x, y);
         if (sea[i] || transportFields.rail[i] >= INF) continue;
-        const density = fieldValue(settlementDemand, i);
+        const density = finiteFieldValue(settlementDemand, i);
         const terrain =
-          fieldValue(transportFields.railPotential, i) * 1.35 +
-          fieldValue(preliminaryUrbanInfluence, i) * 0.42 +
-          fieldValue(preliminaryTownInfluence, i) * 0.46 +
+          finiteFieldValue(transportFields.railPotential, i) * 1.35 +
+          finiteFieldValue(preliminaryUrbanInfluence, i) * 0.42 +
+          finiteFieldValue(preliminaryTownInfluence, i) * 0.46 +
           valleyField[i] * 0.28 +
           basinField[i] * 0.20 +
           coastalLowland[i] * 0.20 +
@@ -169,11 +164,11 @@ export function buildUnifiedRailODNetwork(ctx) {
       }
       cost += costField[i];
       barrier += clamp(
-        fieldValue(naturalBarrierScore, i) * 0.80 +
+        finiteFieldValue(naturalBarrierScore, i) * 0.80 +
         ridgeField[i] * 0.36 +
         slope[i] * 0.42 +
         Math.max(0, elevation[i] - 0.58) * 0.65 -
-        fieldValue(passSuitability, i) * 0.42 -
+        finiteFieldValue(passSuitability, i) * 0.42 -
         valleyField[i] * 0.12
       );
       if (elevation[i] > 0.68 || slope[i] > 0.48) high++;
diff --git a/mapTransportUtils.js b/src/mapTransportUtils.js
similarity index 69%
rename from mapTransportUtils.js
rename to src/mapTransportUtils.js
index 580c49f..19028fa 100644
--- a/mapTransportUtils.js
+++ b/src/mapTransportUtils.js
@@ -1,4 +1,4 @@
-import { SIZE, clamp, indexOf, inside } from "./mapUtils.js";
+import { MAP_W, SIZE, clamp, indexOf, inside, walkGridPath } from "./mapUtils.js";
 
 export function pathSetSignature(paths) {
   let cells = 0;
@@ -26,12 +26,6 @@ export function createPathInfluenceCache(influenceFromPaths) {
   };
 }
 
-export function packDebugField(field) {
-  const out = new Uint8Array(SIZE);
-  for (let i = 0; i < SIZE; i++) out[i] = Math.round(clamp(field?.[i] || 0) * 255);
-  return out;
-}
-
 export function pathLengthCells(path) {
   let total = 0;
   for (let i = 1; i < (path?.length || 0); i++) {
@@ -107,23 +101,6 @@ export function pathEndpoints(paths) {
   return endpoints;
 }
 
-export function nearestNetworkPoint(source, targets, radius, options = {}) {
-  if (!source || !targets?.length) return null;
-  const excludeSamePath = options.excludeSamePath !== false;
-  const excludePath = options.excludePath;
-  let best = null;
-  let bestD = radius + 1;
-  for (const target of targets) {
-    if (excludePath != null && target.pathId === excludePath) continue;
-    if (excludeSamePath && source.pathId != null && target.pathId === source.pathId) continue;
-    const d = Math.hypot(source.x - target.x, source.y - target.y);
-    if (d > 0.01 && d < bestD) {
-      bestD = d;
-      best = target;
-    }
-  }
-  return best ? { target: best, d: bestD, ...best } : null;
-}
 
 export function splitPathToValidCells(path, isValid, minCells = 2) {
   const chunks = [];
@@ -150,6 +127,64 @@ export function splitPathToValidCells(path, isValid, minCells = 2) {
   return chunks;
 }
 
+
+export function normalizeTransportPathSet(paths, options = {}) {
+  const minLength = options.minLength ?? 0;
+  const minPoints = options.minPoints ?? 2;
+  const sampleStep = Math.max(1, options.sampleStep ?? 1);
+  const seen = new Set();
+  const kept = [];
+  let removedDuplicates = 0;
+  let removedTooShort = 0;
+  const before = paths?.length || 0;
+  for (const path of paths || []) {
+    if (!path || path.length < minPoints) { removedTooShort++; continue; }
+    const cleaned = [];
+    for (const pt of path) {
+      if (!pt || pt.length < 2) continue;
+      const x = Math.round(pt[0]);
+      const y = Math.round(pt[1]);
+      if (!inside(x, y)) continue;
+      if (!cleaned.length || cleaned[cleaned.length - 1][0] !== x || cleaned[cleaned.length - 1][1] !== y) cleaned.push([x, y]);
+    }
+    if (cleaned.length < minPoints || pathLengthCells(cleaned) < minLength) { removedTooShort++; continue; }
+    const signature = (candidate) => candidate
+      .map((pt, idx) => (idx % sampleStep === 0 || idx === candidate.length - 1) ? `${pt[0]},${pt[1]}` : "")
+      .filter(Boolean)
+      .join("|");
+    const forward = signature(cleaned);
+    const backward = signature([...cleaned].reverse());
+    const sig = forward < backward ? forward : backward;
+    if (seen.has(sig)) { removedDuplicates++; continue; }
+    seen.add(sig);
+    kept.push(cleaned);
+  }
+  if (options.mutate !== false && Array.isArray(paths)) {
+    paths.length = 0;
+    paths.push(...kept);
+  }
+  return { paths: kept, before, after: kept.length, removedDuplicates, removedTooShort };
+}
+
+export function smoothRasterPath(path, passes = 1) {
+  let current = (path || []).map(([x, y]) => [Math.round(x), Math.round(y)]);
+  for (let pass = 0; pass < passes; pass++) {
+    if (current.length < 3) break;
+    const next = [current[0]];
+    for (let i = 1; i < current.length - 1; i++) {
+      const [ax, ay] = current[i - 1];
+      const [bx, by] = current[i];
+      const [cx, cy] = current[i + 1];
+      const x = Math.round((ax + bx * 2 + cx) / 4);
+      const y = Math.round((ay + by * 2 + cy) / 4);
+      if (next[next.length - 1][0] !== x || next[next.length - 1][1] !== y) next.push([x, y]);
+    }
+    next.push(current[current.length - 1]);
+    current = next;
+  }
+  return current;
+}
+
 export function pathCumulativeLengths(path) {
   const cum = [0];
   for (let k = 1; k < (path?.length || 0); k++) {
@@ -260,7 +295,7 @@ export const TRANSPORT_ROUTE_POLICIES = {
   },
 };
 
-export function routeGeometry(path) {
+function routeGeometry(path) {
   if (!path || path.length < 2) return { len: 0, direct: 0, straightness: 1 };
   const len = pathLengthCells(path);
   const a = path[0];
@@ -283,7 +318,7 @@ export function assessMountainRoute(path, mode, pathTerrainRisk, policies = TRAN
   return { ok: true, reason: "ok", risk };
 }
 
-export function expresswayAcceptancePolicy(options = {}, policies = TRANSPORT_ROUTE_POLICIES) {
+function expresswayAcceptancePolicy(options = {}, policies = TRANSPORT_ROUTE_POLICIES) {
   if (options.allowApproach) return policies.expresswayAcceptance.approach;
   if (options.allowFallback) return policies.expresswayAcceptance.fallback;
   return policies.expresswayAcceptance.strict;
@@ -370,3 +405,118 @@ export function makeUnionFind(nodes, keyOf) {
   for (const node of nodes || []) parent.set(keyOf(node), keyOf(node));
   return { find, unite };
 }
+
+export function rasterizePathCells(path, visit, options = {}) {
+  if (!path?.length || typeof visit !== "function") return 0;
+  const accept = options.accept || null;
+  let emitted = 0;
+  walkGridPath(path, (x, y) => {
+    if (!inside(x, y)) return;
+    const i = indexOf(x, y);
+    if (accept && !accept(x, y, i)) return;
+    visit(x, y, i);
+    emitted++;
+  });
+  return emitted;
+}
+
+function rasterizePathSetToMask(paths, options = {}) {
+  const mask = options.mask || new Uint8Array(SIZE);
+  const accept = options.accept || null;
+  for (const path of paths || []) {
+    rasterizePathCells(path, (_x, _y, i) => { mask[i] = 1; }, { accept });
+  }
+  return mask;
+}
+
+function rasterizePathGroupsToMask(groups, options = {}) {
+  const mask = options.mask || new Uint8Array(SIZE);
+  const accept = options.accept || null;
+  for (const paths of groups || []) rasterizePathSetToMask(paths, { mask, accept });
+  return mask;
+}
+
+export function labelOccupancyComponents(occupancy, options = {}) {
+  const maxDistanceSq = Number.isFinite(options.maxDistanceSq) ? options.maxDistanceSq : 2;
+  const labels = new Int32Array(SIZE);
+  labels.fill(-1);
+  const components = [];
+  const queue = [];
+  const radius = Math.ceil(Math.sqrt(maxDistanceSq));
+  for (let i = 0; i < SIZE; i++) {
+    if (!occupancy?.[i] || labels[i] >= 0) continue;
+    const id = components.length;
+    const cells = [];
+    let sx = 0;
+    let sy = 0;
+    labels[i] = id;
+    queue.length = 0;
+    queue.push(i);
+    for (let q = 0; q < queue.length; q++) {
+      const cur = queue[q];
+      cells.push(cur);
+      const [x, y] = [cur % MAP_W, Math.floor(cur / MAP_W)];
+      sx += x;
+      sy += y;
+      for (let dy = -radius; dy <= radius; dy++) {
+        for (let dx = -radius; dx <= radius; dx++) {
+          if (!dx && !dy) continue;
+          if (dx * dx + dy * dy > maxDistanceSq) continue;
+          const nx = x + dx;
+          const ny = y + dy;
+          if (!inside(nx, ny)) continue;
+          const ni = indexOf(nx, ny);
+          if (!occupancy[ni] || labels[ni] >= 0) continue;
+          labels[ni] = id;
+          queue.push(ni);
+        }
+      }
+    }
+    components.push({ id, cells, size: cells.length, cx: sx / Math.max(1, cells.length), cy: sy / Math.max(1, cells.length) });
+  }
+  return { labels, components, count: components.length };
+}
+
+export function occupancyComponentsFromPathGroups(groups, options = {}) {
+  const occupancy = rasterizePathGroupsToMask(groups, options);
+  const labeled = labelOccupancyComponents(occupancy, options);
+  return { occupancy, ...labeled };
+}
+
+export function componentLabelNear(labels, x, y, radius = 0, accept = null) {
+  const cx = Math.round(x);
+  const cy = Math.round(y);
+  if (inside(cx, cy)) {
+    const i = indexOf(cx, cy);
+    if ((!accept || accept(cx, cy, i)) && labels?.[i] >= 0) return labels[i];
+  }
+  for (let r = 1; r <= radius; r++) {
+    for (let dy = -r; dy <= r; dy++) {
+      for (let dx = -r; dx <= r; dx++) {
+        if (Math.max(Math.abs(dx), Math.abs(dy)) !== r) continue;
+        const nx = cx + dx;
+        const ny = cy + dy;
+        if (!inside(nx, ny)) continue;
+        const i = indexOf(nx, ny);
+        if (accept && !accept(nx, ny, i)) continue;
+        if (labels?.[i] >= 0) return labels[i];
+      }
+    }
+  }
+  return -1;
+}
+
+export function spatialIndexesByKey(points, keyOf, cellSize = 16) {
+  const grouped = new Map();
+  for (const point of points || []) {
+    const key = keyOf(point);
+    if (key == null || key < 0) continue;
+    let bucket = grouped.get(key);
+    if (!bucket) {
+      bucket = [];
+      grouped.set(key, bucket);
+    }
+    bucket.push(point);
+  }
+  return new Map([...grouped].map(([key, rows]) => [key, makeSpatialIndex(rows, cellSize)]));
+}
diff --git a/mapUtils.js b/src/mapUtils.js
similarity index 71%
rename from mapUtils.js
rename to src/mapUtils.js
index 8d33ec1..7e10118 100644
--- a/mapUtils.js
+++ b/src/mapUtils.js
@@ -5,6 +5,51 @@ export const CELL_SIZE = 4;
 export const SIZE = MAP_W * MAP_H;
 export const INF = 1e9;
 
+export function nowMs() {
+  return typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+}
+
+export function worldIndexOf(world, x, y) {
+  if (!world || x < 0 || y < 0 || x >= world.width || y >= world.height) return -1;
+  return y * world.width + x;
+}
+
+export function finiteFieldValue(field, i, fallback = 0) {
+  const value = field?.[i];
+  return Number.isFinite(value) ? value : fallback;
+}
+
+export function distanceToNearestPoint(points, x, y, fallback = 999) {
+  let best = fallback;
+  for (const point of points || []) best = Math.min(best, Math.hypot(point.x - x, point.y - y));
+  return best;
+}
+
+export function walkGridPath(path, visit) {
+  if (!path?.length || typeof visit !== "function") return 0;
+  let emitted = 0;
+  let lastX = NaN;
+  let lastY = NaN;
+  for (let k = 0; k < path.length; k++) {
+    const a = path[k];
+    const b = path[Math.min(k + 1, path.length - 1)];
+    if (!a || !b) continue;
+    const steps = Math.max(1, Math.ceil(Math.hypot(b[0] - a[0], b[1] - a[1])));
+    for (let s = 0; s <= steps; s++) {
+      if (k > 0 && s === 0) continue;
+      const t = s / steps;
+      const x = Math.round(a[0] + (b[0] - a[0]) * t);
+      const y = Math.round(a[1] + (b[1] - a[1]) * t);
+      if (x === lastX && y === lastY) continue;
+      lastX = x;
+      lastY = y;
+      visit(x, y);
+      emitted++;
+    }
+  }
+  return emitted;
+}
+
 export function indexOf(x, y) {
   return y * MAP_W + x;
 }
@@ -45,6 +90,11 @@ export function lerp(a, b, t) {
   return a + (b - a) * t;
 }
 
+export function circularAngleDistance(a, b) {
+  const d = Math.abs(a - b) % Math.PI;
+  return Math.min(d, Math.PI - d);
+}
+
 export function valueNoise(x, y, seed, scale) {
   const sx = x / scale;
   const sy = y / scale;
@@ -75,10 +125,10 @@ export function fbm(x, y, seed) {
   return sum / norm;
 }
 
-export function pickEntities(candidates, { max = 99, minDistance = 5, threshold = 0, seed = 0, jitter = 0.04 } = {}) {
+export function pickEntities(candidates, { max = 99, minDistance = 5, threshold = 0, seed = 0, jitter = 0.04, originX = 0, originY = 0 } = {}) {
   const sorted = candidates
     .filter((p) => Number.isFinite(p.score) && p.score >= threshold)
-    .map((p) => ({ ...p, score: p.score + hash2(p.x, p.y, seed + 54321) * jitter }))
+    .map((p) => ({ ...p, score: p.score + hash2((p.worldX ?? (p.x + originX)), (p.worldY ?? (p.y + originY)), seed + 54321) * jitter }))
     .sort((a, b) => b.score - a.score);
 
   const out = [];
@@ -168,8 +218,3 @@ export class MinHeap {
   }
 }
 
-export function weightedScore(terms) {
-  let total = 0;
-  for (const [value, weight] of terms) total += value * weight;
-  return total;
-}
diff --git a/names.js b/src/names.js
similarity index 95%
rename from names.js
rename to src/names.js
index 3582bed..1db2064 100644
--- a/names.js
+++ b/src/names.js
@@ -282,9 +282,6 @@ export const NAME_TEMPLATE_WEIGHTS = {
   },
 };
 
-// Legacy export kept only so older imports do not fail.
-export const NAME_PARTS = {};
-
 const POOL_KEYS = Object.keys(NAME_KANJI_POOLS);
 const TERRAIN_POOL_KEYS = ["inlandTerrain", "waterTerrain", "coastalTerrain"];
 const ASCII_DIAGNOSTIC_PREFIX = "N";
@@ -421,14 +418,12 @@ export function createNameDebug(probabilities = NAME_PROBABILITIES, pools = NAME
     shortNamesRejected: 0,
     duplicateRetries: 0,
     fallbackAttempts: 0,
-    legacyFallbackUsed: 0,
-    oneKanjiAppendFallbackUsed: 0,
     derivedNameCount: 0,
     maxDerivedPerBase: 0,
   };
 }
 
-export function chooseNameContext(entity, fields) {
+function chooseNameContext(entity, fields) {
   const kind = String(entity?.kind || "").toLowerCase();
   const i = boundedIndex(entity);
   const coastal = (fields?.coastalLowland?.[i] || 0) > 0.35 || isNearSea(entity?.x || 0, entity?.y || 0, fields?.sea);
@@ -449,7 +444,7 @@ export function chooseNameContext(entity, fields) {
   return "generic";
 }
 
-export function resolveSlotPool(slot, context, pools = NAME_KANJI_POOLS, probabilities = NAME_PROBABILITIES, seed = 0, id = "", attempt = 0) {
+function resolveSlotPool(slot, context, pools = NAME_KANJI_POOLS, probabilities = NAME_PROBABILITIES, seed = 0, id = "", attempt = 0) {
   const keys = slotPoolKeys(slot, context, probabilities);
   if (!keys.length) return null;
   const selectedKey = pickWeightedPoolKey(keys, context, pools, probabilities, seed, id, attempt, 1501 + stableHash(slot));
@@ -506,10 +501,6 @@ function generateTemplateNameDetails(seed, id, entity, fields, attempt, usedName
   return { name, context, templateKey };
 }
 
-export function generateTemplateName(seed, id, entity, fields, attempt = 0, usedNames = null) {
-  return generateTemplateNameDetails(seed, id, entity, fields, attempt, usedNames).name;
-}
-
 function deterministicDiagnosticName(seed, id, attempt = 0) {
   const h = Math.floor(roll(seed, id, attempt, 3001) * 0xb640).toString(36).toUpperCase();
   return `${ASCII_DIAGNOSTIC_PREFIX}${h.padStart(3, "0")}`;
@@ -584,11 +575,3 @@ export function generateEntityName(seed, id, entity, fields, usedNames = null, d
   return uniqueDiagnosticName(seed, id, usedNames, debug, retryCount);
 }
 
-export function contextualDefaultName(seed, id, entity, nameParts = NAME_PARTS, fields, attempt = 0) {
-  const name = generateTemplateName(seed, id, entity, fields, attempt, null);
-  return name || deterministicDiagnosticName(seed, id, attempt);
-}
-
-export function chooseNameSuffixPool() {
-  return NAME_KANJI_POOLS.postfixes;
-}
diff --git a/rectContext.js b/src/rectContext.js
similarity index 57%
rename from rectContext.js
rename to src/rectContext.js
index c282a5a..32fa8f0 100644
--- a/rectContext.js
+++ b/src/rectContext.js
@@ -19,66 +19,10 @@ export function rectIndexOf(ctx, x, y) {
   return y * ctx.width + x;
 }
 
-export function rectXyOf(ctx, i) {
-  return [i % ctx.width, Math.floor(i / ctx.width)];
-}
-
 export function rectInside(ctx, x, y) {
   return !!ctx && x >= 0 && y >= 0 && x < ctx.width && y < ctx.height;
 }
 
-export function rectWorldX(ctx, x) {
-  return ctx.originX + x;
-}
-
-export function rectWorldY(ctx, y) {
-  return ctx.originY + y;
-}
-
-export function rectWorldCoord(ctx, x, y) {
-  return { x: ctx.originX + x, y: ctx.originY + y };
-}
-
-export function rectLocalCoord(ctx, worldX, worldY) {
-  return { x: Math.round(worldX - ctx.originX), y: Math.round(worldY - ctx.originY) };
-}
-
-export function rectWorldIndex(ctx, worldX, worldY) {
-  const x = Math.round(worldX - ctx.originX);
-  const y = Math.round(worldY - ctx.originY);
-  return rectInside(ctx, x, y) ? rectIndexOf(ctx, x, y) : -1;
-}
-
-export function rectFromBounds(bounds, name = "rect") {
-  const x0 = Math.floor(Math.min(bounds.x0, bounds.x1));
-  const y0 = Math.floor(Math.min(bounds.y0, bounds.y1));
-  const x1 = Math.ceil(Math.max(bounds.x0, bounds.x1));
-  const y1 = Math.ceil(Math.max(bounds.y0, bounds.y1));
-  return createRectContext({ originX: x0, originY: y0, width: Math.max(1, x1 - x0), height: Math.max(1, y1 - y0), name });
-}
-
-export function rectBounds(ctx) {
-  return { x0: ctx.originX, y0: ctx.originY, x1: ctx.originX + ctx.width, y1: ctx.originY + ctx.height };
-}
-
-export function clampRectToBounds(rect, bounds) {
-  const x0 = Math.max(bounds.x0 ?? 0, Math.floor(rect.x0));
-  const y0 = Math.max(bounds.y0 ?? 0, Math.floor(rect.y0));
-  const x1 = Math.min(bounds.x1 ?? Infinity, Math.ceil(rect.x1));
-  const y1 = Math.min(bounds.y1 ?? Infinity, Math.ceil(rect.y1));
-  return { x0, y0, x1: Math.max(x0, x1), y1: Math.max(y0, y1) };
-}
-
-export function expandRectBounds(rect, margin, bounds = null) {
-  const expanded = {
-    x0: Math.floor(rect.x0) - margin,
-    y0: Math.floor(rect.y0) - margin,
-    x1: Math.ceil(rect.x1) + margin,
-    y1: Math.ceil(rect.y1) + margin,
-  };
-  return bounds ? clampRectToBounds(expanded, bounds) : expanded;
-}
-
 export function rectNeighbors8(ctx, x, y) {
   const out = [];
   for (let dy = -1; dy <= 1; dy++) {
@@ -92,10 +36,6 @@ export function rectNeighbors8(ctx, x, y) {
   return out;
 }
 
-export function rectDistanceToEdge(ctx, x, y) {
-  return Math.min(x, y, ctx.width - 1 - x, ctx.height - 1 - y);
-}
-
 export function createRectTerrainFields(ctx) {
   const size = ctx.size;
   const flowTo = new Int32Array(size);
@@ -136,10 +76,6 @@ export function createRectTerrainFields(ctx) {
   };
 }
 
-export function isRectCellField(value, ctx) {
-  return ArrayBuffer.isView(value) && typeof value.length === "number" && value.length === ctx.size;
-}
-
 export function rectQuantile(values, q) {
   const arr = Array.from(values).filter(Number.isFinite).sort((a, b) => a - b);
   if (!arr.length) return 0;
diff --git a/renderer.js b/src/renderer.js
similarity index 73%
rename from renderer.js
rename to src/renderer.js
index e387f7c..ae06e48 100644
--- a/renderer.js
+++ b/src/renderer.js
@@ -1,12 +1,74 @@
-import { CELL_SIZE, MAP_H, MAP_W, clamp } from "./mapUtils.js";
+import { CELL_SIZE, MAP_H, MAP_W, circularAngleDistance, clamp, distanceToNearestPoint, nowMs, valueNoise } from "./mapUtils.js";
 
 
 const segmentVectorCache = new WeakMap();
+const segmentVectorStableCache = new Map();
 const pathVectorCache = new WeakMap();
 const coastlineCache = new WeakMap();
 const rasterBorderCache = new WeakMap();
-const baseImageCache = new WeakMap();
-const MAX_BASE_CACHE_IMAGES = 4;
+const baseImageCache = new Map();
+const urbanOverlayCache = new Map();
+const prefectureFillCache = new Map();
+const transportDebugHeatmapCache = new WeakMap();
+const MAX_BASE_CACHE_IMAGES = 18;
+const MAX_OVERLAY_CACHE_IMAGES = 18;
+const MAX_SEGMENT_VECTOR_CACHE = 48;
+const CONTINUOUS_BASE_MODES = ["terrain", "development", "all"];
+
+function fieldRefSignature(map) {
+  const refs = [
+    map?.elevation, map?.slope, map?.sea, map?.prefectureMask, map?.humanRegionMask,
+    map?.landuse, map?.populationDensity, map?.prefectureRegionId, map?.adminId,
+  ];
+  return refs.map((field) => ArrayBuffer.isView(field) ? `${field.constructor.name}:${field.length}` : "-").join("|");
+}
+
+function generatedRectSignature(map) {
+  const rects = Array.isArray(map?.generatedRects) ? map.generatedRects : [];
+  const last = rects[rects.length - 1] || null;
+  if (!last) return "0";
+  return `${rects.length}:${last.x0 || 0},${last.y0 || 0},${last.x1 || 0},${last.y1 || 0}:${last.terrainType || ""}:${last.variant || ""}`;
+}
+
+function stableViewportCachePrefix(map) {
+  const camera = map?.worldCamera || {};
+  const origin = map?.worldOrigin || {};
+  return [
+    map?.baseSeed ?? map?.seed ?? 0,
+    map?.effectiveSeed ?? "",
+    map?.generationContext?.variant ?? "",
+    map?.renderRevision ?? 0,
+    map?.previewVariant ?? "",
+    mapWidth(map),
+    mapHeight(map),
+    Math.round(camera.x || 0),
+    Math.round(camera.y || 0),
+    Math.round(origin.x || 0),
+    Math.round(origin.y || 0),
+    generatedRectSignature(map),
+    fieldRefSignature(map),
+  ].join(":");
+}
+
+function cappedSet(cache, key, value, maxSize) {
+  cache.set(key, value);
+  while (cache.size > maxSize) cache.delete(cache.keys().next().value);
+  return value;
+}
+
+function segmentContentSignature(segments) {
+  const count = segments?.length || 0;
+  if (!count) return "0";
+  const step = Math.max(1, Math.floor(count / 24));
+  const parts = [String(count)];
+  for (let i = 0; i < count; i += step) {
+    const seg = segments[i];
+    parts.push(`${seg?.[0]?.[0] || 0},${seg?.[0]?.[1] || 0},${seg?.[1]?.[0] || 0},${seg?.[1]?.[1] || 0}`);
+  }
+  const last = segments[count - 1];
+  parts.push(`${last?.[0]?.[0] || 0},${last?.[0]?.[1] || 0},${last?.[1]?.[0] || 0},${last?.[1]?.[1] || 0}`);
+  return parts.join("|");
+}
 
 function mapWidth(map) {
   return Math.max(1, Math.floor(Number.isFinite(map?.width) ? map.width : MAP_W));
@@ -189,6 +251,12 @@ function vectorizeSegments(segments, { iterations = 2, tolerance = 0.08 } = {})
     segmentVectorCache.set(segments, cachedByOption);
   }
   if (cachedByOption.has(cacheKey)) return cachedByOption.get(cacheKey);
+  const stableKey = `${cacheKey}:${segmentContentSignature(segments)}`;
+  const stableCached = segmentVectorStableCache.get(stableKey);
+  if (stableCached) {
+    cachedByOption.set(cacheKey, stableCached);
+    return stableCached;
+  }
 
   const polylines = segmentChains(segments).map((line) => {
     const cleaned = removeCollinear(line);
@@ -199,6 +267,7 @@ function vectorizeSegments(segments, { iterations = 2, tolerance = 0.08 } = {})
   }).filter((line) => line.length >= 2);
 
   cachedByOption.set(cacheKey, polylines);
+  cappedSet(segmentVectorStableCache, stableKey, polylines, MAX_SEGMENT_VECTOR_CACHE);
   return polylines;
 }
 
@@ -292,8 +361,36 @@ function seaCoverageSample(map, fx, fy) {
   return clamp(sum / offsets.length);
 }
 
-function isWaterSample(map, fx, fy) {
-  return seaCoverageSample(map, fx, fy) >= 0.50;
+function terrainWorldPoint(map, fx, fy) {
+  return {
+    x: fx + (map?.worldCamera?.x || 0),
+    y: fy + (map?.worldCamera?.y || 0),
+  };
+}
+
+function waterVisualTone(map, fx, fy) {
+  const p = terrainWorldPoint(map, fx, fy);
+  const seed = (map?.seed || 0) >>> 0;
+  const broad = valueNoise(p.x, p.y, seed ^ 0x5d2a9b31, 74);
+  const mid = valueNoise(p.x, p.y, seed ^ 0x8f4c2d19, 29);
+  return clamp(broad * 0.72 + mid * 0.28);
+}
+
+function waterVisualColor(map, fx, fy, waterCoverage = null) {
+  const coverage = waterCoverage ?? seaCoverageSample(map, fx, fy);
+  const tone = waterVisualTone(map, fx, fy) - 0.5;
+  const offshore = clamp((coverage - 0.42) / 0.58);
+  const depth = clamp(0.48 + offshore * 0.22 + tone * 0.10);
+  return [
+    Math.round(174 - depth * 6),
+    Math.round(203 + depth * 2),
+    Math.round(224 + depth * 4),
+  ];
+}
+
+function waterVisualShade(map, fx, fy) {
+  const tone = waterVisualTone(map, fx * 0.85 + 11.7, fy * 0.85 - 3.1) - 0.5;
+  return clamp(0.992 + tone * 0.018, 0.976, 1.012);
 }
 
 function mixRgb(a, b, t) {
@@ -305,12 +402,6 @@ function mixRgb(a, b, t) {
 }
 
 
-function distToNearest(points, x, y, fallback = 999) {
-  let best = fallback;
-  for (const p of points) best = Math.min(best, Math.hypot(p.x - x, p.y - y));
-  return best;
-}
-
 function blendOutside(color, isInside) {
   if (isInside) return color;
   return [
@@ -363,12 +454,14 @@ function terrainColorContinuous(map, fx, fy, mode) {
   let color;
 
   const waterCoverage = seaCoverageSample(map, fx, fy);
-  const depth = clamp(((map.seaLevel ?? 0.285) + 0.065 - fieldSample(map, map.elevation, fx, fy)) * 2.4);
-  const waterColor = [Math.round(174 - depth * 7), Math.round(203 + depth * 2), Math.round(224 + depth * 5)];
+  // Water must not inherit terrain DEM hill bands. Use a stable world-coordinate
+  // visual water tone instead of elevation-derived depth; otherwise patched sea
+  // areas expose rectangular/horizontal generation artefacts.
+  const waterColor = waterVisualColor(map, fx, fy, waterCoverage);
 
   let landColor;
   if (mode === "development") {
-    const dCity = distToNearest(map.modernCities, fx, fy);
+    const dCity = distanceToNearestPoint(map.modernCities, fx, fy);
     const urban = clamp(1 - dCity / 25);
     const density = map.populationDensity ? fieldSample(map, map.populationDensity, fx, fy) : urban;
     const base = 235;
@@ -399,12 +492,26 @@ function terrainColorContinuous(map, fx, fy, mode) {
     ]);
   }
 
-  const coastBlend = clamp((waterCoverage - 0.36) / 0.28);
-  color = coastBlend > 0 ? mixRgb(landColor, waterColor, coastBlend) : landColor;
+  const centerWater = Boolean(map.sea?.[i]);
+  if (centerWater) {
+    // Keep the visible coastline and the filled water side derived from the same
+    // sea mask.  Only a very narrow anti-aliased edge borrows land color; broad
+    // land/sea averaging made coast strokes disagree with the underlying fill.
+    const edgeLand = clamp((0.58 - waterCoverage) / 0.26);
+    color = edgeLand > 0 ? mixRgb(waterColor, landColor, edgeLand * 0.42) : waterColor;
+  } else {
+    const shore = clamp((waterCoverage - 0.10) / 0.42);
+    const shoreColor = [224, 229, 213];
+    color = shore > 0 ? mixRgb(landColor, shoreColor, shore * 0.34) : landColor;
+  }
   return blendOutside(color, isInside);
 }
 
 function terrainShadeContinuous(map, fx, fy) {
+  const i = sampleCellIndex(map, fx, fy);
+  const waterCoverage = seaCoverageSample(map, fx, fy);
+  if (map.sea?.[i] || waterCoverage >= 0.82) return waterVisualShade(map, fx, fy);
+
   const step = 0.50;
   const eC = fieldSample(map, map.elevation, fx, fy);
   const eL = fieldSample(map, map.elevation, fx - step, fy);
@@ -479,35 +586,29 @@ function discreteColor(map, x, y, mode) {
   return blendOutside(color, Boolean(map.prefectureMask[i]));
 }
 
-function baseCacheKey(mode, continuousTerrain, renderScale = 1) {
-  const continuousModes = ["terrain", "development", "all"];
-  const scaleKey = Math.round((renderScale || 1) * 20) / 20;
-  if (continuousTerrain && continuousModes.includes(mode)) {
-    return `continuous:${mode === "all" ? "terrain" : mode}:${scaleKey}`;
+function baseCacheKey(map, mode, continuousTerrain, renderScale = 1) {
+  const prefix = stableViewportCachePrefix(map);
+  if (continuousTerrain && CONTINUOUS_BASE_MODES.includes(mode)) {
+    const scaleKey = Math.round((renderScale || 1) * 20) / 20;
+    return `${prefix}:continuous:${mode === "all" ? "terrain" : mode}:${scaleKey}`;
   }
-  return `discrete:${mode}:${scaleKey}`;
+  return `${prefix}:discrete:${mode}:1`;
 }
 
 function getCachedBaseCanvas(ctx, map, mode, continuousTerrain, renderScale = 1) {
-  let cache = baseImageCache.get(map);
-  if (!cache) {
-    cache = new Map();
-    baseImageCache.set(map, cache);
-  }
-
-  const key = baseCacheKey(mode, continuousTerrain, renderScale);
-  let canvas = cache.get(key);
+  const key = baseCacheKey(map, mode, continuousTerrain, renderScale);
+  let canvas = baseImageCache.get(key);
   if (canvas) return canvas;
 
   const sourceWidth = mapPixelWidth(map);
   const sourceHeight = mapPixelHeight(map);
-  const targetScale = Math.max(0.35, Math.min(1, renderScale || 1));
+  const continuous = continuousTerrain && CONTINUOUS_BASE_MODES.includes(mode);
+  const targetScale = continuous ? Math.max(0.35, Math.min(1, renderScale || 1)) : 1;
   const width = Math.max(1, Math.round(sourceWidth * targetScale));
   const height = Math.max(1, Math.round(sourceHeight * targetScale));
   const img = ctx.createImageData(width, height);
-  const continuousModes = ["terrain", "development", "all"];
 
-  if (continuousTerrain && continuousModes.includes(mode)) {
+  if (continuous) {
     for (let py = 0; py < height; py++) {
       const fy = (py / Math.max(1, height)) * mapHeight(map);
       for (let px = 0; px < width; px++) {
@@ -546,9 +647,7 @@ function getCachedBaseCanvas(ctx, map, mode, continuousTerrain, renderScale = 1)
   canvas.height = height;
   const bctx = canvas.getContext("2d");
   bctx.putImageData(img, 0, 0);
-  cache.set(key, canvas);
-  if (cache.size > MAX_BASE_CACHE_IMAGES) cache.delete(cache.keys().next().value);
-  return canvas;
+  return cappedSet(baseImageCache, key, canvas, MAX_BASE_CACHE_IMAGES);
 }
 
 function drawBase(ctx, map, mode, continuousTerrain, renderScale = 1) {
@@ -589,6 +688,74 @@ function getRasterBorderSegments(map, fieldName) {
   return segments;
 }
 
+function getDisplayBorderSegments(map, fieldName, precomputedSegments, mode) {
+  // Raw raster borders expose every one-cell ID fragment and also reveal patch
+  // ownership seams as long rectangular prefecture/municipality lines.  Keep
+  // that extractor debug-only; normal modes must use prepared vector layers.
+  if (mode === "borders-debug") return getRasterBorderSegments(map, fieldName);
+  return Array.isArray(precomputedSegments) ? precomputedSegments : [];
+}
+
+function borderSegmentMidpoint(seg) {
+  return { x: ((seg?.[0]?.[0] || 0) + (seg?.[1]?.[0] || 0)) * 0.5, y: ((seg?.[0]?.[1] || 0) + (seg?.[1]?.[1] || 0)) * 0.5 };
+}
+function borderSegmentOrientation(seg) {
+  return Math.atan2((seg?.[1]?.[1] || 0) - (seg?.[0]?.[1] || 0), (seg?.[1]?.[0] || 0) - (seg?.[0]?.[0] || 0));
+}
+function borderPointSegmentDistance(px, py, ax, ay, bx, by) {
+  const dx = bx - ax, dy = by - ay;
+  const len2 = dx * dx + dy * dy;
+  if (len2 <= 1e-9) return Math.hypot(px - ax, py - ay);
+  const t = Math.max(0, Math.min(1, ((px - ax) * dx + (py - ay) * dy) / len2));
+  return Math.hypot(px - (ax + dx * t), py - (ay + dy * t));
+}
+function borderSegmentsNear(a, b, tolerance = 1.35) {
+  if (!a || !b) return false;
+  if (circularAngleDistance(borderSegmentOrientation(a), borderSegmentOrientation(b)) > 0.72) return false;
+  const am = borderSegmentMidpoint(a);
+  const bm = borderSegmentMidpoint(b);
+  if (Math.hypot(am.x - bm.x, am.y - bm.y) <= tolerance) return true;
+  const ax = a?.[0]?.[0] || 0, ay = a?.[0]?.[1] || 0;
+  const bx = a?.[1]?.[0] || 0, by = a?.[1]?.[1] || 0;
+  const cx = b?.[0]?.[0] || 0, cy = b?.[0]?.[1] || 0;
+  const dx = b?.[1]?.[0] || 0, dy = b?.[1]?.[1] || 0;
+  return Math.min(
+    borderPointSegmentDistance(ax, ay, cx, cy, dx, dy),
+    borderPointSegmentDistance(bx, by, cx, cy, dx, dy),
+    borderPointSegmentDistance(cx, cy, ax, ay, bx, by),
+    borderPointSegmentDistance(dx, dy, ax, ay, bx, by)
+  ) <= tolerance;
+}
+function suppressMunicipalBordersNearPrefectures(adminSegments, prefectureSegments) {
+  if (!adminSegments?.length || !prefectureSegments?.length) return adminSegments || [];
+  const tolerance = 1.35;
+  const cellSize = tolerance;
+  const grid = new Map();
+  const cell = (v) => Math.floor(v / cellSize);
+  for (const seg of prefectureSegments) {
+    const m = borderSegmentMidpoint(seg);
+    const key = `${cell(m.x)},${cell(m.y)}`;
+    const bucket = grid.get(key) || [];
+    bucket.push(seg);
+    grid.set(key, bucket);
+  }
+  const out = [];
+  for (const seg of adminSegments) {
+    const m = borderSegmentMidpoint(seg);
+    const gx = cell(m.x), gy = cell(m.y);
+    let near = false;
+    for (let yy = gy - 2; yy <= gy + 2 && !near; yy++) {
+      for (let xx = gx - 2; xx <= gx + 2 && !near; xx++) {
+        for (const pref of grid.get(`${xx},${yy}`) || []) {
+          if (borderSegmentsNear(seg, pref, tolerance)) { near = true; break; }
+        }
+      }
+    }
+    if (!near) out.push(seg);
+  }
+  return out;
+}
+
 function drawRiverPath(ctx, map, path, color, widthFn, alpha = 1) {
   if (!path || path.length < 2) return;
   ctx.save();
@@ -721,6 +888,13 @@ function drawUrbanAreas(ctx, map, mode) {
   const visibleModes = ["all", "modern", "development", "landuse", "admin"];
   if (!visibleModes.includes(mode)) return;
 
+  const key = `${stableViewportCachePrefix(map)}:urban:${mode}`;
+  let canvas = urbanOverlayCache.get(key);
+  if (canvas) {
+    ctx.drawImage(canvas, 0, 0, mapPixelWidth(map), mapPixelHeight(map));
+    return;
+  }
+
   const detailedColors = {
     2: "rgba(223, 214, 206, 0.72)",
     3: "rgba(215, 175, 172, 0.88)",
@@ -733,7 +907,11 @@ function drawUrbanAreas(ctx, map, mode) {
   const cityColor = "rgba(232, 222, 228, 0.60)";
   const cbdColor = "rgba(215, 175, 172, 0.84)";
 
-  ctx.save();
+  canvas = document.createElement("canvas");
+  canvas.width = mapPixelWidth(map);
+  canvas.height = mapPixelHeight(map);
+  const bctx = canvas.getContext("2d");
+  if (!bctx) return;
   const w = mapWidth(map);
   const h = mapHeight(map);
   for (let y = 0; y < h; y++) {
@@ -750,11 +928,12 @@ function drawUrbanAreas(ctx, map, mode) {
 
       const px = x * CELL_SIZE;
       const py = y * CELL_SIZE;
-      ctx.fillStyle = fill;
-      ctx.fillRect(px, py, CELL_SIZE, CELL_SIZE);
+      bctx.fillStyle = fill;
+      bctx.fillRect(px, py, CELL_SIZE, CELL_SIZE);
     }
   }
-  ctx.restore();
+  cappedSet(urbanOverlayCache, key, canvas, MAX_OVERLAY_CACHE_IMAGES);
+  ctx.drawImage(canvas, 0, 0, mapPixelWidth(map), mapPixelHeight(map));
 }
 
 function drawDebugCells(ctx, map, field, color) {
@@ -777,13 +956,57 @@ function drawDebugCells(ctx, map, field, color) {
   ctx.restore();
 }
 
+function derivedTransportDebugHeatmaps(map) {
+  const existing = transportDebugHeatmapCache.get(map);
+  const signature = fieldRefSignature(map);
+  if (existing?.signature === signature) return existing.layers;
+  const size = mapWidth(map) * mapHeight(map);
+  const expresswayPotential = new Uint8Array(size);
+  const railPotential = new Uint8Array(size);
+  const nationalRoadPotential = new Uint8Array(size);
+  const slopeSeaPenalty = new Uint8Array(size);
+  const sea = map.sea;
+  const slope = map.slope;
+  const elevation = map.elevation;
+  const ridge = map.ridgeField;
+  const plain = map.plain;
+  const agriculture = map.agriculture;
+  const valley = map.valleyField;
+  const coastal = map.coastalLowland;
+  const population = map.populationDensity;
+  const settlement = map.settlementCluster;
+  const road = map.roadInfluence;
+  const rail = map.railInfluence2;
+  for (let i = 0; i < size; i++) {
+    if (sea?.[i]) {
+      slopeSeaPenalty[i] = 255;
+      continue;
+    }
+    const density = clamp(Math.log1p(Math.max(0, population?.[i] || 0)) / Math.log(12001));
+    const lowland = clamp((plain?.[i] || 0) * 0.48 + (agriculture?.[i] || 0) * 0.24 + (valley?.[i] || 0) * 0.16 + (coastal?.[i] || 0) * 0.18);
+    const urban = clamp(density * 0.72 + (settlement?.[i] || 0) * 0.32);
+    const barrier = clamp((slope?.[i] || 0) * 1.45 + Math.max(0, (elevation?.[i] || 0) - 0.58) * 2.0 + (ridge?.[i] || 0) * 0.38);
+    const expressway = clamp(urban * 0.58 + lowland * 0.42 + (road?.[i] || 0) * 0.10 - barrier * 0.58);
+    const railValue = clamp(urban * 0.68 + lowland * 0.42 + (rail?.[i] || 0) * 0.12 - barrier * 0.70);
+    const national = clamp(urban * 0.42 + lowland * 0.48 + (road?.[i] || 0) * 0.16 - barrier * 0.34);
+    expresswayPotential[i] = Math.round(expressway * 255);
+    railPotential[i] = Math.round(railValue * 255);
+    nationalRoadPotential[i] = Math.round(national * 255);
+    slopeSeaPenalty[i] = Math.round(barrier * 255);
+  }
+  const layers = { expresswayPotential, railPotential, nationalRoadPotential, slopeSeaPenalty };
+  transportDebugHeatmapCache.set(map, { signature, layers });
+  return layers;
+}
+
 function drawTransportDebug(ctx, map) {
   const layers = map.transportDebug?.layers;
   if (!layers) return;
-  drawDebugCells(ctx, map, layers.expresswayPotential, (v) => v < 0.16 ? "rgba(0,0,0,0)" : `rgba(80, 190, 110, ${0.035 + v * 0.13})`);
-  drawDebugCells(ctx, map, layers.railPotential, (v) => v < 0.16 ? "rgba(0,0,0,0)" : `rgba(70, 120, 230, ${0.035 + v * 0.13})`);
-  drawDebugCells(ctx, map, layers.nationalRoadPotential, (v) => v < 0.16 ? "rgba(0,0,0,0)" : `rgba(245, 205, 65, ${0.030 + v * 0.12})`);
-  drawDebugCells(ctx, map, layers.slopeSeaPenalty, (v) => v < 0.45 ? "rgba(0,0,0,0)" : `rgba(80, 30, 30, ${0.025 + v * 0.10})`);
+  const heatmaps = derivedTransportDebugHeatmaps(map);
+  drawDebugCells(ctx, map, heatmaps.expresswayPotential, (v) => v < 0.16 ? "rgba(0,0,0,0)" : `rgba(80, 190, 110, ${0.035 + v * 0.13})`);
+  drawDebugCells(ctx, map, heatmaps.railPotential, (v) => v < 0.16 ? "rgba(0,0,0,0)" : `rgba(70, 120, 230, ${0.035 + v * 0.13})`);
+  drawDebugCells(ctx, map, heatmaps.nationalRoadPotential, (v) => v < 0.16 ? "rgba(0,0,0,0)" : `rgba(245, 205, 65, ${0.030 + v * 0.12})`);
+  drawDebugCells(ctx, map, heatmaps.slopeSeaPenalty, (v) => v < 0.45 ? "rgba(0,0,0,0)" : `rgba(80, 30, 30, ${0.025 + v * 0.10})`);
 
   const componentColors = {
     expressway: "rgba(60, 165, 80, 0.42)",
@@ -819,9 +1042,19 @@ function drawPrefectureRegionFill(ctx, map, mode) {
   if (!["all", "admin", "borders-debug"].includes(mode)) return;
   const ids = map.prefectureRegionId;
   if (!ids) return;
+  const key = `${stableViewportCachePrefix(map)}:prefecture-fill:${mode}`;
+  let canvas = prefectureFillCache.get(key);
+  if (canvas) {
+    ctx.drawImage(canvas, 0, 0, mapPixelWidth(map), mapPixelHeight(map));
+    return;
+  }
   const alpha = mode === "borders-debug" ? 0.34 : 0.18;
-  ctx.save();
-  ctx.globalAlpha = alpha;
+  canvas = document.createElement("canvas");
+  canvas.width = mapPixelWidth(map);
+  canvas.height = mapPixelHeight(map);
+  const bctx = canvas.getContext("2d");
+  if (!bctx) return;
+  bctx.globalAlpha = alpha;
   const w = mapWidth(map);
   const h = mapHeight(map);
   for (let y = 0; y < h; y++) {
@@ -830,11 +1063,12 @@ function drawPrefectureRegionFill(ctx, map, mode) {
       const id = ids[i];
       if (map.sea[i] || id < 0) continue;
       const [r, g, b] = prefectureRegionColor(id);
-      ctx.fillStyle = `rgb(${r}, ${g}, ${b})`;
-      ctx.fillRect(x * CELL_SIZE, y * CELL_SIZE, CELL_SIZE, CELL_SIZE);
+      bctx.fillStyle = `rgb(${r}, ${g}, ${b})`;
+      bctx.fillRect(x * CELL_SIZE, y * CELL_SIZE, CELL_SIZE, CELL_SIZE);
     }
   }
-  ctx.restore();
+  cappedSet(prefectureFillCache, key, canvas, MAX_OVERLAY_CACHE_IMAGES);
+  ctx.drawImage(canvas, 0, 0, mapPixelWidth(map), mapPixelHeight(map));
 }
 
 function dot(ctx, p, radius, fill, stroke = "white") {
@@ -847,6 +1081,54 @@ function dot(ctx, p, radius, fill, stroke = "white") {
   ctx.stroke();
 }
 
+
+function drawSeamDiagnosticMarker(ctx, point) {
+  const x = point.x * CELL_SIZE + CELL_SIZE / 2;
+  const y = point.y * CELL_SIZE + CELL_SIZE / 2;
+  const kind = point.kind || "issue";
+  const connected = kind.endsWith("-connected");
+  const error = point.severity === "error" || kind.endsWith("-broken") || kind === "transport-coast-conflict" || kind === "prefecture-seam-break";
+  const info = point.severity === "info" || connected;
+  const stroke = error ? "rgba(220, 35, 55, 0.98)" : info ? "rgba(35, 155, 95, 0.96)" : "rgba(232, 135, 30, 0.96)";
+  const fill = error ? "rgba(255, 240, 240, 0.88)" : info ? "rgba(238, 255, 246, 0.84)" : "rgba(255, 248, 225, 0.86)";
+  const radius = error ? 4.8 : info ? 3.5 : 4.0;
+  ctx.save();
+  ctx.lineWidth = error ? 2.1 : 1.5;
+  ctx.strokeStyle = stroke;
+  ctx.fillStyle = fill;
+  ctx.beginPath();
+  ctx.arc(x, y, radius, 0, Math.PI * 2);
+  ctx.fill();
+  ctx.stroke();
+  if (error) {
+    ctx.beginPath();
+    ctx.moveTo(x - radius * 0.58, y - radius * 0.58);
+    ctx.lineTo(x + radius * 0.58, y + radius * 0.58);
+    ctx.moveTo(x + radius * 0.58, y - radius * 0.58);
+    ctx.lineTo(x - radius * 0.58, y + radius * 0.58);
+    ctx.stroke();
+  } else if (connected) {
+    ctx.beginPath();
+    ctx.moveTo(x - radius * 0.55, y);
+    ctx.lineTo(x - radius * 0.10, y + radius * 0.48);
+    ctx.lineTo(x + radius * 0.62, y - radius * 0.50);
+    ctx.stroke();
+  }
+  ctx.restore();
+}
+
+function drawSeamDiagnostics(ctx, map) {
+  const diagnostics = map?.patchSeamDiagnostics;
+  if (!diagnostics?.enabled) return;
+  for (const path of diagnostics.outlinePaths || []) {
+    drawPath(ctx, path, "rgba(205, 45, 160, 0.92)", 2.2, true);
+  }
+  for (const point of diagnostics.issuePoints || []) {
+    if (!point || !Number.isFinite(point.x) || !Number.isFinite(point.y)) continue;
+    drawSeamDiagnosticMarker(ctx, point);
+  }
+}
+
 function boxesOverlap(a, b, pad = 3) {
   return !(a.x2 + pad < b.x1 || a.x1 - pad > b.x2 || a.y2 + pad < b.y1 || a.y1 - pad > b.y2);
 }
@@ -969,9 +1251,18 @@ export function drawMap(canvas, map, options) {
   const ctx = canvas.getContext("2d");
   if (!ctx) return;
 
+  const timings = {};
+  let timingMark = nowMs();
+  const markTiming = (key) => {
+    const t = nowMs();
+    timings[key] = Math.round((t - timingMark) * 10) / 10;
+    timingMark = t;
+  };
+
   const mode = options.mode || "all";
   const showFeatures = options.showFeatures !== false;
   const showLabels = options.showLabels !== false;
+  const showSeamDiagnostics = options.showSeamDiagnostics !== false;
   const continuousTerrain = options.continuousTerrain !== false;
   const outputWidth = MAP_W * CELL_SIZE;
   const outputHeight = MAP_H * CELL_SIZE;
@@ -981,7 +1272,8 @@ export function drawMap(canvas, map, options) {
   const drawOffsetX = (outputWidth - sourceWidth * drawScale) * 0.5;
   const drawOffsetY = (outputHeight - sourceHeight * drawScale) * 0.5;
   const cellScreenSize = CELL_SIZE * drawScale;
-  const terrainRenderScale = continuousTerrain ? clamp(drawScale * (options.fastTerrain ? 0.48 : 1.35), 0.30, 1) : 1;
+  const terrainQualityScale = options.fastTerrain ? 0.48 : 0.62;
+  const terrainRenderScale = continuousTerrain ? clamp(drawScale * terrainQualityScale, 0.30, options.fastTerrain ? 0.55 : 0.78) : 1;
 
   if (canvas.width !== outputWidth) canvas.width = outputWidth;
   if (canvas.height !== outputHeight) canvas.height = outputHeight;
@@ -996,14 +1288,19 @@ export function drawMap(canvas, map, options) {
     drawScaleBar(ctx, cellScreenSize);
     delete ctx.__mapPixelWidth;
     delete ctx.__mapPixelHeight;
+    timings.scale = Math.round((nowMs() - timingMark) * 10) / 10;
+    return timings;
   };
 
   // 1. Base Terrain & Urban
   drawBase(ctx, map, mode, continuousTerrain, terrainRenderScale);
+  markTiming("baseTerrain");
   drawUrbanAreas(ctx, map, mode);
+  markTiming("urbanFill");
   const coastSegments = getCoastlineSegments(map);
   drawVectorSegments(ctx, coastSegments, "rgba(120, 175, 210, 0.22)", 2.2, false, { iterations: 2, tolerance: 0.06, offsetX: -0.5, offsetY: -0.5 });
   drawVectorSegments(ctx, coastSegments, "rgba(248, 250, 242, 0.68)", 1.1, false, { iterations: 2, tolerance: 0.06, offsetX: -0.5, offsetY: -0.5 });
+  markTiming("coastline");
 
   // 2. Rivers
   const waterBlue = "rgba(116, 165, 202, 0.92)";
@@ -1054,8 +1351,8 @@ export function drawMap(canvas, map, options) {
       return 1.55 * downstreamBoost;
     }, 1.0);
   }
+  markTiming("rivers");
 
-  const showHistory = mode === "history";
   const showTransportDebug = mode === "transport-debug";
   const showModern = ["modern", "all", "development", "landuse", "borders-debug", "transport-debug"].includes(mode);
   const showRoads = ["all", "development", "transport-debug"].includes(mode);
@@ -1067,8 +1364,9 @@ export function drawMap(canvas, map, options) {
   const showPrefectureRegions = ["all", "admin", "borders-debug"].includes(mode);
   if (showPrefectureRegions) drawPrefectureRegionFill(ctx, map, mode);
 
-  const adminBorderSegments = map.adminId ? getRasterBorderSegments(map, "adminId") : map.adminBorders;
-  const prefectureBorderSegments = map.prefectureRegionId ? getRasterBorderSegments(map, "prefectureRegionId") : map.regionalPrefectureBorders;
+  const prefectureBorderSegments = getDisplayBorderSegments(map, "prefectureRegionId", map.regionalPrefectureBorders, mode);
+  const rawAdminBorderSegments = getDisplayBorderSegments(map, "adminId", map.adminBorders, mode);
+  const adminBorderSegments = mode === "borders-debug" ? rawAdminBorderSegments : suppressMunicipalBordersNearPrefectures(rawAdminBorderSegments, prefectureBorderSegments);
   if (showAdmin && adminBorderSegments?.length) {
     drawVectorSegments(ctx, adminBorderSegments, "rgba(255, 255, 255, 0.8)", 2.8, false, { iterations: 1, tolerance: 0.05, offsetX: -0.5, offsetY: -0.5 }); 
     drawVectorSegments(ctx, adminBorderSegments, "rgba(150, 140, 150, 0.9)", 1.2, true, { iterations: 1, tolerance: 0.05, offsetX: -0.5, offsetY: -0.5 }); 
@@ -1092,10 +1390,12 @@ export function drawMap(canvas, map, options) {
     drawVectorSegments(ctx, finalPrefectureBorders, "rgba(255, 255, 255, 0.95)", 5.0, false, { iterations: 2, tolerance: 0.06, offsetX: -0.5, offsetY: -0.5 });
     drawVectorSegments(ctx, finalPrefectureBorders, "rgba(110, 90, 110, 1)", 2.2, true, { iterations: 2, tolerance: 0.06, offsetX: -0.5, offsetY: -0.5 });
   }
+  markTiming("adminBorders");
 
   if (!showFeatures) {
-    finish();
-    return;
+    if (showSeamDiagnostics) drawSeamDiagnostics(ctx, map);
+    markTiming("seamDiagnostics");
+    return finish();
   }
 
   // 4. Transport casings. Layer order: local roads, trunk roads, railways, expressways.
@@ -1145,6 +1445,7 @@ export function drawMap(canvas, map, options) {
     for (const path of map.expressways) drawPath(ctx, path, "rgba(135, 160, 135, 0.88)", 2.4);
     for (const path of map.externalExpressways) drawPath(ctx, path, "rgba(135, 160, 135, 0.88)", 2.4);
   }
+  markTiming("transport");
 
   // 6. Icons & Labels
   if (["admin", "borders-debug"].includes(mode)) {
@@ -1185,6 +1486,10 @@ export function drawMap(canvas, map, options) {
       }
     }
   }
+  markTiming("icons");
+
+  if (showSeamDiagnostics) drawSeamDiagnostics(ctx, map);
+  markTiming("seamDiagnostics");
 
   if (showLabels) {
     const prefectureLabels = (map.prefectureRegions || []).map((p) => ({ ...p, isPrefectureLabel: true, forceLabel: true, labelPriorityBase: p.labelPriorityBase || 1900 }));
@@ -1193,13 +1498,13 @@ export function drawMap(canvas, map, options) {
         .filter((p) => p && p.name && Number.isFinite(p.x) && Number.isFinite(p.y) && p.x >= 0 && p.y >= 0 && p.x < map.width && p.y < map.height && map.adminId?.[Math.round(p.y) * map.width + Math.round(p.x)] === (p.adminId ?? p.municipalityId ?? p.adminNumericId))
         .map((p) => ({ ...p, labelStyle: "municipality", forceLabel: true, labelPriorityBase: 1200 }));
       drawLabels(ctx, [...prefectureLabels, ...municipalLabels], Infinity);
-      finish();
-      return;
+      markTiming("labels");
+      return finish();
     }
     if (mode === "borders-debug") {
       drawLabels(ctx, prefectureLabels, Infinity);
-      finish();
-      return;
+      markTiming("labels");
+      return finish();
     }
     const important = [
       ...prefectureLabels,
@@ -1210,5 +1515,6 @@ export function drawMap(canvas, map, options) {
     ].filter((p) => !p.suppressSettlementLabel && (p.isPrefectureLabel || p.forceAllLayerTownLabel || p.insidePrefecture || p.isRegionalCapital || p.kind === "External Gateway" || (p.population || 0) >= 5000));
     drawLabels(ctx, important, mode === "all" || mode === "history" ? 78 : 60);
   }
-  finish();
+  markTiming("labels");
+  return finish();
 }
diff --git a/src/transferUtils.js b/src/transferUtils.js
new file mode 100644
index 0000000..d40346f
--- /dev/null
+++ b/src/transferUtils.js
@@ -0,0 +1,31 @@
+export function collectTransferableBuffers(value, buffers = new Set(), seen = new WeakSet()) {
+  if (value == null || typeof value !== "object") return buffers;
+  if (ArrayBuffer.isView(value)) {
+    const buffer = value.buffer;
+    if (buffer instanceof ArrayBuffer && buffer.byteLength > 0) buffers.add(buffer);
+    return buffers;
+  }
+  if (value instanceof ArrayBuffer) {
+    if (value.byteLength > 0) buffers.add(value);
+    return buffers;
+  }
+  if (seen.has(value)) return buffers;
+  seen.add(value);
+  if (value instanceof Map) {
+    for (const [key, item] of value) {
+      collectTransferableBuffers(key, buffers, seen);
+      collectTransferableBuffers(item, buffers, seen);
+    }
+    return buffers;
+  }
+  if (value instanceof Set) {
+    for (const item of value) collectTransferableBuffers(item, buffers, seen);
+    return buffers;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectTransferableBuffers(item, buffers, seen);
+    return buffers;
+  }
+  for (const item of Object.values(value)) collectTransferableBuffers(item, buffers, seen);
+  return buffers;
+}
diff --git a/worldMap.js b/src/worldMap.js
similarity index 80%
rename from worldMap.js
rename to src/worldMap.js
index 04ac910..1affdf8 100644
--- a/worldMap.js
+++ b/src/worldMap.js
@@ -1,34 +1,13 @@
 import { MAP_H, MAP_W, SIZE } from "./mapUtils.js";
+import { defaultCellFieldValue, isTypedCellField, worldFieldConstructor } from "./fieldSchema.js";
 
-export const DEFAULT_WORLD_PADDING_X = MAP_W;
-export const DEFAULT_WORLD_PADDING_Y = MAP_H;
-
-const NEGATIVE_ONE_FIELDS = new Set([
-  "adminId",
-  "prefectureRegionId",
-  "regionId",
-  "municipalityId",
-  "naturalCompartmentId",
-  "watershedId",
-]);
-
-function isCellField(value) {
-  return ArrayBuffer.isView(value) && typeof value.length === "number" && value.length === SIZE;
-}
-
-function defaultForField(name, Constructor) {
-  if (name === "sea") return 1;
-  if (name === "elevation") return 0.08;
-  if (name === "seaLevel") return undefined;
-  if (NEGATIVE_ONE_FIELDS.has(name)) return -1;
-  if (Constructor === Float32Array || Constructor === Float64Array) return 0;
-  return 0;
-}
+const DEFAULT_WORLD_PADDING_X = MAP_W;
+const DEFAULT_WORLD_PADDING_Y = MAP_H;
 
 function makeWorldField(name, source, worldWidth, worldHeight, originX, originY) {
-  const Constructor = NEGATIVE_ONE_FIELDS.has(name) ? Int32Array : source.constructor;
+  const Constructor = worldFieldConstructor(name, source.constructor);
   const out = new Constructor(worldWidth * worldHeight);
-  const fallback = defaultForField(name, Constructor);
+  const fallback = defaultCellFieldValue(name, Constructor);
   if (fallback !== 0) out.fill(fallback);
 
   for (let y = 0; y < MAP_H; y++) {
@@ -67,7 +46,7 @@ export function createWorldMap(initialMap, options = {}) {
   const fields = {};
 
   for (const [name, value] of Object.entries(initialMap || {})) {
-    if (isCellField(value)) fields[name] = makeWorldField(name, value, worldWidth, worldHeight, originX, originY);
+    if (isTypedCellField(value, SIZE)) fields[name] = makeWorldField(name, value, worldWidth, worldHeight, originX, originY);
   }
 
   if (!fields.sea) {
@@ -88,6 +67,9 @@ export function createWorldMap(initialMap, options = {}) {
     originY,
     sourceWidth: initialMap?.width || MAP_W,
     sourceHeight: initialMap?.height || MAP_H,
+    // Sea level is a world invariant. Patch candidates must classify water
+    // against this value instead of recalculating a local quantile.
+    seaLevel: Number.isFinite(initialMap?.seaLevel) ? initialMap.seaLevel : 0.30,
     sourceMap: initialMap,
     fields,
     invalidatedRects: [],
@@ -137,12 +119,27 @@ function shiftSelectionShape(shape, dx, dy) {
   };
 }
 
+function shiftGeneratedFootprint(footprint, dx, dy) {
+  if (!footprint) return footprint;
+  return {
+    ...footprint,
+    x0: Number.isFinite(footprint.x0) ? footprint.x0 + dx : footprint.x0,
+    y0: Number.isFinite(footprint.y0) ? footprint.y0 + dy : footprint.y0,
+    x1: Number.isFinite(footprint.x1) ? footprint.x1 + dx : footprint.x1,
+    y1: Number.isFinite(footprint.y1) ? footprint.y1 + dy : footprint.y1,
+    rowRuns: Array.isArray(footprint.rowRuns)
+      ? footprint.rowRuns.map((row) => Array.isArray(row) ? row.map((value) => value + dx) : row)
+      : footprint.rowRuns,
+  };
+}
+
 function shiftPatchMetadata(item, dx, dy) {
   const out = expandRectByOffset(item, dx, dy);
   for (const sub of ["coreRect", "writeRect", "repairRect", "contextRect", "blendRect", "transportReachRect"]) {
     if (out?.[sub]) out[sub] = expandRectByOffset(out[sub], dx, dy);
   }
   if (out?.selectionShape) out.selectionShape = shiftSelectionShape(out.selectionShape, dx, dy);
+  if (out?.generatedFootprint) out.generatedFootprint = shiftGeneratedFootprint(out.generatedFootprint, dx, dy);
   return out;
 }
 
@@ -155,7 +152,7 @@ function shiftRectCollections(world, dx, dy) {
   if (world.lastPatchResult) world.lastPatchResult = shiftPatchMetadata(world.lastPatchResult, dx, dy);
 }
 
-export function expandWorldMap(world, margins = {}) {
+function expandWorldMap(world, margins = {}) {
   if (!world) return { world, dx: 0, dy: 0, expanded: false };
   const left = Math.max(0, Math.floor(margins.left || 0));
   const right = Math.max(0, Math.floor(margins.right || 0));
@@ -169,9 +166,9 @@ export function expandWorldMap(world, margins = {}) {
   const newFields = {};
   for (const [name, field] of Object.entries(world.fields || {})) {
     if (!ArrayBuffer.isView(field)) continue;
-    const Constructor = NEGATIVE_ONE_FIELDS.has(name) ? Int32Array : field.constructor;
+    const Constructor = worldFieldConstructor(name, field.constructor);
     const out = new Constructor(newWidth * newHeight);
-    const fallback = defaultForField(name, Constructor);
+    const fallback = defaultCellFieldValue(name, Constructor);
     if (fallback !== 0) out.fill(fallback);
     for (let y = 0; y < oldHeight; y++) {
       const srcRow = y * oldWidth;
diff --git a/worldViewport.js b/src/worldViewport.js
similarity index 88%
rename from worldViewport.js
rename to src/worldViewport.js
index 448a1d9..71acac0 100644
--- a/worldViewport.js
+++ b/src/worldViewport.js
@@ -1,4 +1,5 @@
-import { MAP_H, MAP_W, SIZE } from "./mapUtils.js";
+import { MAP_H, MAP_W, SIZE, worldIndexOf } from "./mapUtils.js";
+import { defaultCellFieldValue } from "./fieldSchema.js";
 
 const EMPTY_ARRAY_KEYS = new Set([
   "villages", "markets", "castles", "ports", "modernCities", "satelliteCities", "stations",
@@ -25,43 +26,17 @@ const POINT_ARRAY_KEYS = new Set([
   "externalGateways", "prefectureRegions",
 ]);
 
-const NEGATIVE_ONE_FIELDS = new Set([
-  "adminId",
-  "prefectureRegionId",
-  "regionId",
-  "municipalityId",
-  "naturalCompartmentId",
-  "watershedId",
-]);
-
-function isCellField(value) {
-  return ArrayBuffer.isView(value) && typeof value.length === "number" && value.length === SIZE;
-}
-
-function defaultForField(name, Constructor) {
-  if (name === "sea") return 1;
-  if (name === "elevation") return 0.08;
-  if (NEGATIVE_ONE_FIELDS.has(name)) return -1;
-  if (Constructor === Float32Array || Constructor === Float64Array) return 0;
-  return 0;
-}
-
-function worldIndex(world, x, y) {
-  if (!world || x < 0 || y < 0 || x >= world.width || y >= world.height) return -1;
-  return y * world.width + x;
-}
-
 function copyViewportField(name, source, world, camera, viewWidth, viewHeight) {
   const Constructor = source.constructor;
   const out = new Constructor(viewWidth * viewHeight);
-  const fallback = defaultForField(name, Constructor);
+  const fallback = defaultCellFieldValue(name, Constructor);
   if (fallback !== 0) out.fill(fallback);
 
   const cx = Math.round(camera.x || 0);
   const cy = Math.round(camera.y || 0);
   for (let y = 0; y < viewHeight; y++) {
     for (let x = 0; x < viewWidth; x++) {
-      const src = worldIndex(world, cx + x, cy + y);
+      const src = worldIndexOf(world, cx + x, cy + y);
       if (src >= 0) out[y * viewWidth + x] = source[src];
     }
   }
@@ -201,6 +176,10 @@ function buildEmptyViewportFromSource(sourceMap, world, camera, viewWidth, viewH
   viewport.height = viewHeight;
   viewport.worldCamera = { x: camera.x, y: camera.y };
   viewport.worldOrigin = { x: world.originX, y: world.originY };
+  // Explicit render revision prevents preview/Alternative frames from sharing
+  // a raster cache entry merely because their dimensions and field types match.
+  viewport.renderRevision = Number(world?.renderRevision || 0);
+  viewport.previewVariant = world?.previewVariant ?? null;
   viewport.generatedRects = world.generatedRects || [];
   for (const key of EMPTY_ARRAY_KEYS) if (Array.isArray(viewport[key])) viewport[key] = [];
   return viewport;
@@ -218,7 +197,15 @@ export function getViewportMap(world, camera, viewWidth = MAP_W, viewHeight = MA
     viewport[name] = copyViewportField(name, value, world, normalizedCamera, viewWidth, viewHeight);
   }
 
-  if (options.light) return viewport;
+  if (options.light) {
+    // Light/fast redraws are used while panning and zooming.  Do not leave
+    // source-space debug vectors on the viewport; in borders-debug this made
+    // natural compartment lines appear fixed on screen while the map moved.
+    viewport.adminDebug = null;
+    viewport.transportDebug = null;
+    viewport.patchSeamDiagnostics = null;
+    return viewport;
+  }
 
   const originX = world?.originX || 0;
   const originY = world?.originY || 0;
@@ -237,6 +224,13 @@ export function getViewportMap(world, camera, viewWidth = MAP_W, viewHeight = MA
     };
   }
   if (sourceMap.transportDebug) viewport.transportDebug = transformTransportDebug(sourceMap.transportDebug, normalizedCamera, originX, originY, viewport, viewWidth, viewHeight);
+  if (sourceMap.patchSeamDiagnostics) {
+    viewport.patchSeamDiagnostics = {
+      ...sourceMap.patchSeamDiagnostics,
+      issuePoints: transformPointArray(sourceMap.patchSeamDiagnostics.issuePoints || [], normalizedCamera, originX, originY, 24, false, viewWidth, viewHeight),
+      outlinePaths: transformPaths(sourceMap.patchSeamDiagnostics.outlinePaths || [], normalizedCamera, originX, originY, viewWidth, viewHeight),
+    };
+  }
   if (sourceMap.neighborPrefectureDetails) {
     viewport.neighborPrefectureDetails = {
       ...sourceMap.neighborPrefectureDetails,
diff --git a/styles.css b/styles.css
deleted file mode 100644
index 7ffa8ee..0000000
--- a/styles.css
+++ /dev/null
@@ -1,92 +0,0 @@
-*{box-sizing:border-box} 
-body{margin:0;background:#f0f2f5;color:#2c2c2c;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif} 
-button,input,select{font:inherit}
-code{background:#e8e8e8;border-radius:4px;padding:1px 4px} 
-.app{min-height:100vh;padding:16px}
-.layout{display:grid;grid-template-columns:minmax(0,1fr) 300px;gap:16px;max-width:1360px;margin:0 auto}
-.header{margin-bottom:12px}
-.header h1{margin:0 0 6px;font-size:24px;letter-spacing:-0.02em;color:#1a1a1a;font-weight:700}
-.header p{margin:0;color:#5a5a5a;line-height:1.6;font-size:14px}
-.canvas-shell,.card{background:#ffffff;border:1px solid rgba(0,0,0,0.08);border-radius:8px;box-shadow:0 4px 12px rgba(0,0,0,0.04)}
-.canvas-shell{padding:12px;overflow:auto;position:relative;cursor:grab;user-select:none;touch-action:none}
-.map-canvas{display:block;border-radius:8px;background:#f8f9fa}
-.sidebar{display:flex;flex-direction:column;gap:12px}
-.card{padding:14px}
-.label,.card-title{display:block;margin-bottom:12px;color:#1a1a1a;font-size:14px;font-weight:600}
-.inline-label{margin-top:12px}
-.input{width:100%;border:1px solid rgba(0,0,0,0.15);background:#fff;color:#2c2c2c;border-radius:8px;padding:10px 12px;outline:none;transition:border-color 0.2s}
-.input:focus{border-color:#1a73e8;box-shadow:0 0 0 3px rgba(26,115,232,0.15)}
-.primary-button,.mode-button{border:0;border-radius:8px;padding:10px 12px;cursor:pointer;font-weight:600;transition:background 0.2s}
-.primary-button{margin-top:12px;width:100%;background:#1a73e8;color:#fff}
-.primary-button:hover{background:#1557b0}
-.mode-grid{display:grid;grid-template-columns:1fr 1fr;gap:6px}
-.mode-button{background:#f1f3f4;color:#3c4043;border:1px solid transparent}
-.mode-button:hover{background:#e8eaed}
-.mode-button.active{background:#e8f0fe;color:#1a73e8;border:1px solid #1a73e8}
-.checkbox-row{display:flex;gap:8px;align-items:center;margin-top:12px;color:#3c4043;font-size:14px;cursor:pointer}
-.stats{display:flex;flex-direction:column;gap:8px}
-.stat-row{display:flex;justify-content:space-between;gap:12px;color:#5f6368;font-size:13px;align-items:baseline}
-.stat-row strong{color:#202124;font-family:ui-monospace,monospace}
-.legend{color:#5f6368;font-size:13px;line-height:1.6}
-.legend p{margin:8px 0 0}
-
-@media (max-width:1100px){.layout{grid-template-columns:1fr}}
-
-.legend-grid{display:flex;flex-direction:column;gap:8px;margin-top:12px}
-.legend-row{display:grid;grid-template-columns:32px 1fr;gap:8px;align-items:center;min-height:22px}
-
-/* Layered GIS style CSS equivalents */
-.legend-line{display:inline-block;width:28px;height:4px;border-radius:2px;}
-.express-line{background:#6eb982; border:1px solid #508c64;}
-.road-line{background:#f5e182; border:1px solid #beaf8c;}
-
-/* Fishbone Railway Style */
-.rail-line{background:#6e6e6e; height:1.5px; position:relative; border:none; margin-top:2px; border-radius:0}
-.rail-line::after{content:"";position:absolute;top:-2.5px;left:0;right:0;height:7px;background:repeating-linear-gradient(90deg, transparent, transparent 5px, #6e6e6e 5px, #6e6e6e 6px);}
-
-.river-major{background:#a0cdf0; border:none; height:3px;}
-.old-road-line{background:#fff; border:1px solid #dcdcdc; height:3px; border-top:none;}
-
-.legend-swatch{display:inline-block;width:24px;height:14px;border-radius:4px;background:#f5f5f5}
-.border-swatch{border:2px dashed rgba(110,90,110,1);box-shadow:inset 0 0 0 1px rgba(255,255,255,1), 0 0 0 1px rgba(255,255,255,1)}
-.cbd-swatch{background:#f0dccd; border:1px solid rgba(0,0,0,0.1)}
-
-.legend-icon{display:inline-block;width:14px;height:14px;justify-self:center;border:2px solid #fff;border-radius:50%;box-shadow:0 0 0 1px rgba(0,0,0,0.15)}
-.city-icon{background:#f06e6e;}
-.satellite-icon{background:#d75f91;}
-.station-icon{background:#fff;border-color:#444;}
-.industry-icon{background:#8caaa0; border-radius:3px;}
-.castle-icon{background:#b44646; border-radius:3px;}
-
-.port-icon{width:0;height:0;border-left:7px solid transparent;border-right:7px solid transparent;border-bottom:14px solid #4682c8;border-top:0;box-shadow:none;background:transparent;border-radius:0}
-.newtown-icon{width:0;height:0;border-left:7px solid transparent;border-right:7px solid transparent;border-bottom:14px solid #b4d2f0;border-top:0;box-shadow:none;background:transparent;border-radius:0}
-
-.map-tooltip{position:absolute;z-index:20;pointer-events:none;min-width:200px;max-width:280px;background:rgba(255,255,255,0.74);border:1px solid rgba(0,0,0,0.10);border-radius:8px;box-shadow:0 10px 30px rgba(0,0,0,0.10);backdrop-filter:blur(4px);padding:10px 12px;color:#2c2c2c;font-size:12px;line-height:1.5;opacity:0;transform:translateY(4px);transition:opacity 0.15s ease, transform 0.15s ease;font-weight:500}
-.map-tooltip.visible{opacity:1;transform:translateY(0)}
-
-.generation-progress{position:absolute;inset:24px auto auto 24px;z-index:30;min-width:300px;max-width:440px;background:rgba(255,255,255,0.96);border:1px solid rgba(0,0,0,0.12);border-radius:12px;box-shadow:0 14px 36px rgba(0,0,0,0.14);padding:14px 16px;color:#202124;font-size:13px;line-height:1.5}
-.generation-progress.hidden{display:none}
-.progress-title{font-weight:700;margin-bottom:4px}
-.progress-stage{color:#5f6368;margin-bottom:10px}
-.progress-timings{display:flex;flex-direction:column;gap:4px;font-family:ui-monospace,monospace;font-size:12px;color:#3c4043}
-.progress-timing-row{display:flex;justify-content:space-between;gap:16px;border-top:1px solid rgba(0,0,0,0.06);padding-top:4px}
-
-.canvas-shell.panning{cursor:grabbing}
-.map-selection-svg{position:absolute;inset:12px;z-index:18;display:none;pointer-events:none;overflow:visible}
-.map-selection-svg polygon{fill:rgba(26,115,232,0.16);stroke:rgba(26,115,232,0.88);stroke-width:2;vector-effect:non-scaling-stroke;stroke-linejoin:round}
-.map-selection-svg.invalid polygon{fill:rgba(179,38,30,0.14);stroke:rgba(179,38,30,0.88)}
-.canvas-shell.selecting{cursor:crosshair}
-.map-selection{position:absolute;z-index:18;display:none;pointer-events:none;border:2px solid rgba(26,115,232,0.86);background:rgba(26,115,232,0.16);box-shadow:0 0 0 1px rgba(255,255,255,0.70) inset,0 8px 22px rgba(26,115,232,0.20)}
-.primary-button:disabled{background:#a8b6c8;color:#eef3f8;cursor:not-allowed}
-.patch-status{margin:10px 0 0;color:#5f6368;font-size:12px;line-height:1.45}
-.patch-status.invalid{color:#b3261e;font-weight:600}
-.map-selection.invalid{border-color:rgba(179,38,30,0.88);background:rgba(179,38,30,0.14);box-shadow:0 0 0 1px rgba(255,255,255,0.70) inset,0 8px 22px rgba(179,38,30,0.18)}
-
-.patch-variant-row{display:grid;grid-template-columns:1fr 92px;gap:8px;align-items:end;margin-top:12px}
-.patch-variant-label{margin-bottom:0;align-self:center}
-.patch-variant-input{padding:8px 10px;text-align:right;font-family:ui-monospace,monospace}
-.patch-button-row{display:grid;grid-template-columns:1fr 1fr;gap:8px;margin-top:12px}
-.patch-button-row .primary-button,.patch-button-row .secondary-button{margin-top:0;width:100%}
-.secondary-button{border:1px solid rgba(26,115,232,0.35);border-radius:8px;padding:10px 12px;cursor:pointer;font-weight:600;background:#eef4ff;color:#1557b0;transition:background 0.2s,border-color 0.2s}
-.secondary-button:hover{background:#e1edff;border-color:rgba(26,115,232,0.55)}
-.secondary-button:disabled{background:#eef1f4;color:#8a98a8;border-color:rgba(0,0,0,0.08);cursor:not-allowed}
diff --git a/styles/styles.css b/styles/styles.css
new file mode 100644
index 0000000..41c0427
--- /dev/null
+++ b/styles/styles.css
@@ -0,0 +1,532 @@
+*{box-sizing:border-box}
+:root{
+  --bg:#090b10;
+  --bg-2:#0d1118;
+  --surface:#11161f;
+  --surface-2:#151d28;
+  --surface-3:#1a2431;
+  --surface-soft:rgba(20,28,39,.88);
+  --panel:rgba(20,28,39,.9);
+  --line:rgba(173,190,211,.12);
+  --line-strong:rgba(173,190,211,.24);
+  --text:#e8eef8;
+  --muted:#97a6bb;
+  --muted-2:#6f8199;
+  --accent:#4f8cff;
+  --accent-strong:#3e75d9;
+  --accent-soft:rgba(79,140,255,.14);
+  --danger:#ff6861;
+  --shadow:0 24px 60px rgba(0,0,0,.36);
+  --shadow-soft:0 10px 26px rgba(0,0,0,.24);
+}
+html,body{height:100%}
+body{
+  margin:0;
+  background:radial-gradient(circle at top left,#131a25 0,#0d1118 38%,#090b10 100%);
+  color:var(--text);
+  font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;
+}
+button,input,select{font:inherit}
+button{user-select:none}
+code{background:#121820;border-radius:4px;padding:1px 4px}
+.app{min-height:100dvh}
+.page-shell{width:100%}
+.top-stage{
+  height:100dvh;
+  display:grid;
+  grid-template-columns:minmax(0,1fr) 320px;
+  gap:12px;
+  padding:12px 12px 0;
+}
+.map-section,.generation-section{min-height:0}
+.map-section{min-width:0}
+.canvas-shell{
+  position:relative;
+  height:100%;
+  border:1px solid var(--line);
+  border-radius:18px;
+  overflow:hidden;
+  background:linear-gradient(180deg,#0d131c 0,#0b1017 100%);
+  box-shadow:var(--shadow);
+  cursor:grab;
+  user-select:none;
+  touch-action:none;
+}
+.canvas-shell::before{
+  content:"";
+  position:absolute;
+  inset:0;
+  background:linear-gradient(180deg,rgba(255,255,255,.02),rgba(255,255,255,0));
+  pointer-events:none;
+}
+.canvas-shell.panning{cursor:grabbing}
+.canvas-shell.selecting,.canvas-shell.patch-intent{cursor:crosshair}
+.canvas-stage{
+  position:absolute;
+  inset:0;
+  display:flex;
+  align-items:flex-end;
+  justify-content:center;
+  padding:12px;
+}
+.map-canvas{
+  display:block;
+  background:#0c1118;
+  border-radius:16px;
+  box-shadow:0 0 0 1px rgba(255,255,255,.06),0 12px 40px rgba(0,0,0,.28);
+}
+.generation-section{
+  display:flex;
+  flex-direction:column;
+  gap:10px;
+  overflow:auto;
+  padding-bottom:0;
+}
+.settings-card,
+.summary-section,
+.advanced-details{
+  background:var(--surface);
+  border:1px solid var(--line);
+  border-radius:16px;
+  box-shadow:var(--shadow-soft);
+}
+.settings-card{padding:12px}
+.settings-header-card{padding:10px 12px}
+.section-title-row{display:flex;align-items:end;justify-content:space-between;gap:14px;margin:0 0 10px}
+.section-title-row.compact{align-items:center;margin-bottom:10px}
+.card-heading{display:flex;align-items:flex-start;justify-content:space-between;margin-bottom:10px}
+.card-heading.tight{margin-bottom:0}
+.eyebrow{font-size:10px;line-height:1;text-transform:uppercase;letter-spacing:.12em;color:var(--muted-2);font-weight:900;margin-bottom:5px}
+h2,h3{margin:0;letter-spacing:-.02em}h2{font-size:16px}h3{font-size:14px}
+.field{display:block;margin-bottom:10px}.field:last-child{margin-bottom:0}
+.field-label{display:block;margin:0 0 6px;color:#cad5e5;font-size:12px;font-weight:850;letter-spacing:.01em}
+.input{
+  width:100%;
+  border:1px solid var(--line-strong);
+  background:var(--surface-3);
+  color:var(--text);
+  border-radius:10px;
+  padding:9px 10px;
+  outline:none;
+  transition:border-color .16s,box-shadow .16s,background .16s;
+  min-height:38px;
+}
+.input:focus{border-color:var(--accent);box-shadow:0 0 0 3px rgba(79,140,255,.18)}
+.primary-button,.secondary-button,.ghost-button,.mode-button,.segmented-button{
+  border-radius:10px;
+  padding:9px 10px;
+  cursor:pointer;
+  font-weight:800;
+  transition:background .16s,border-color .16s,color .16s,transform .16s, box-shadow .16s;
+  min-height:38px;
+}
+.primary-button{border:1px solid var(--accent);background:var(--accent);color:#fff;box-shadow:0 8px 16px rgba(79,140,255,.18)}
+.primary-button:hover{background:var(--accent-strong);border-color:var(--accent-strong)}
+.secondary-button{border:1px solid rgba(79,140,255,.42);background:rgba(79,140,255,.10);color:#dbe7ff}
+.secondary-button:hover{background:rgba(79,140,255,.16);border-color:rgba(79,140,255,.55)}
+.ghost-button{border:1px solid var(--line-strong);background:transparent;color:#c8d2e1}.ghost-button:hover{background:rgba(255,255,255,.04);border-color:rgba(173,190,211,.32)}
+.primary-button:disabled,.secondary-button:disabled,.ghost-button:disabled{background:#1a2029;color:#76859a;border-color:rgba(173,190,211,.08);box-shadow:none;cursor:not-allowed}
+.button-stack{display:grid;gap:8px;margin-top:8px}.button-stack.two-col{grid-template-columns:1fr 1fr}.button-stack button{width:100%;font-size:12px;white-space:nowrap}
+.segmented-group{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:6px;width:100%}
+.segmented-button,.mode-button{border:1px solid var(--line-strong);background:var(--surface-3);color:#d2dbeb;box-shadow:none;white-space:nowrap}
+.segmented-button{width:100%;display:flex;align-items:center;justify-content:center;text-align:center;padding-left:8px;padding-right:8px}
+.segmented-button:hover,.mode-button:hover{background:#202b3a}
+.segmented-button.active,.mode-button.active{background:var(--accent);border-color:var(--accent);color:#fff;box-shadow:0 8px 16px rgba(79,140,255,.16)}
+.microcopy{margin:9px 0 0;color:var(--muted);font-size:11px;line-height:1.45}
+.mode-grid{display:grid;grid-template-columns:1fr;gap:6px}.mode-button{min-height:32px;padding:7px 9px;font-size:12px;border-radius:9px;text-align:left}
+.checkbox-row{display:flex;gap:8px;align-items:center;margin-top:9px;color:#d2dbeb;font-size:13px;cursor:pointer}.checkbox-row input{accent-color:var(--accent)}
+.patch-status{margin:10px 0 0;color:var(--muted);font-size:12px;line-height:1.45}.patch-status.invalid{color:var(--danger);font-weight:750}
+
+.map-dock{
+  position:absolute;
+  top:16px;
+  right:16px;
+  z-index:24;
+  width:min(240px,28vw);
+  display:flex;
+  flex-direction:column;
+  gap:10px;
+}
+.dock-card{
+  background:rgba(17,22,31,.86);
+  border:1px solid rgba(173,190,211,.16);
+  border-radius:14px;
+  box-shadow:0 16px 34px rgba(0,0,0,.26);
+  overflow:hidden;
+  backdrop-filter:blur(12px);
+}
+.dock-card summary{
+  list-style:none;
+  cursor:pointer;
+  display:flex;
+  align-items:center;
+  justify-content:space-between;
+  gap:8px;
+  min-height:42px;
+  padding:10px 10px;
+  font-size:13px;
+  font-weight:900;
+  color:var(--text);
+  border-bottom:1px solid transparent;
+}
+.dock-card summary::-webkit-details-marker{display:none}
+.dock-card[open] summary{border-bottom-color:rgba(173,190,211,.10)}
+.summary-button{
+  border:1px solid rgba(173,190,211,.24);
+  background:rgba(255,255,255,.04);
+  color:var(--muted);
+  border-radius:999px;
+  padding:2px 7px;
+  font-size:10px;
+  font-weight:850;
+  line-height:1.4;
+}
+.dock-card:not([open]) .summary-button::before{content:"Open"}
+.dock-card[open] .summary-button::before{content:"Close"}
+.summary-button{font-size:0}.summary-button::before{font-size:10px}
+.dock-body{padding:10px}.divider{height:1px;background:rgba(173,190,211,.10);margin:10px 0}
+
+.stats{display:flex;flex-direction:column;gap:0}
+.summary-section{margin:12px;padding:12px}
+.summary-stats{display:grid;grid-template-columns:repeat(6,minmax(120px,1fr));gap:0;border:1px solid var(--line);border-radius:12px;overflow:hidden;background:var(--surface-2)}
+.stat-row{display:flex;justify-content:space-between;gap:12px;color:var(--muted);font-size:13px;align-items:baseline;padding:9px 10px;border-bottom:1px solid rgba(173,190,211,.08)}
+.summary-stats .stat-row{display:grid;grid-template-columns:1fr;gap:4px;border-bottom:0;border-right:1px solid rgba(173,190,211,.08);min-height:58px}.summary-stats .stat-row:last-child{border-right:0}
+.stat-row strong{color:#edf3fe;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;text-align:right;white-space:nowrap}.summary-stats .stat-row strong{text-align:left;font-size:15px}
+.legend-grid{display:flex;flex-direction:column;gap:8px}.legend-row{display:grid;grid-template-columns:28px 1fr;gap:8px;align-items:center;min-height:20px;color:#d0dae9;font-size:12px;line-height:1.35}
+.legend-line{display:inline-block;width:24px;height:4px;border-radius:999px;justify-self:center}.express-line{background:#87a087;border:1px solid #697d69}.road-line{background:#f5e182;border:1px solid #beaf8c}.river-major{background:#74a5ca;border:none;height:3px}.old-road-line{background:#fff;border:1px solid #8f8f86;height:3px}.minor-road-line{background:#fff;border:1px solid #a7a7a0;height:3px}.rail-line{background:#e8e8e8;height:1.5px;position:relative;border:none;margin-top:2px;border-radius:0}.rail-line::after{content:"";position:absolute;top:-2.5px;left:0;right:0;height:7px;background:repeating-linear-gradient(90deg,transparent,transparent 5px,#343a43 5px,#343a43 6px)}
+.legend-swatch{display:inline-block;width:24px;height:14px;border-radius:4px;background:#f5f5f5;justify-self:center}.border-swatch{border:2px dashed rgba(171,145,171,1);box-shadow:inset 0 0 0 1px rgba(255,255,255,1),0 0 0 1px rgba(255,255,255,1)}.admin-swatch{border:2px dashed rgba(190,180,190,.9);background:#fff}.terrain-swatch{background:linear-gradient(90deg,#7da564,#e3daa2,#98a58f)}.urban-swatch{background:#f0dccd;border:1px solid rgba(0,0,0,.1)}.sea-swatch{background:#9fc7df;border:1px solid rgba(70,120,160,.35)}
+.legend-icon{display:inline-block;width:14px;height:14px;justify-self:center;border:2px solid #fff;border-radius:50%;box-shadow:0 0 0 1px rgba(0,0,0,.15)}.city-icon{background:#f06e6e}.town-icon{width:10px;height:10px;border-radius:3px;background:#f06e6e}.station-icon{background:#fff;border-color:#444}.industry-icon{background:#8caaa0;border-radius:3px}.port-icon{width:0;height:0;border-left:7px solid transparent;border-right:7px solid transparent;border-bottom:14px solid #4682c8;border-top:0;box-shadow:none;background:transparent;border-radius:0}.castle-icon{background:#b44646;border-radius:3px}
+
+.zoom-control{position:absolute;left:18px;bottom:18px;z-index:25;display:flex;flex-direction:column;overflow:hidden;border-radius:14px;background:rgba(12,17,24,.84);border:1px solid rgba(173,190,211,.16);box-shadow:0 14px 30px rgba(0,0,0,.26);backdrop-filter:blur(10px)}
+.zoom-control button{min-width:58px;height:40px;border:0;border-bottom:1px solid rgba(173,190,211,.10);background:transparent;color:var(--text);font-weight:850;cursor:pointer}.zoom-control button:last-child{border-bottom:0;font-size:12px}.zoom-control button:hover{background:rgba(79,140,255,.12);color:#fff}
+.map-hint{position:absolute;left:18px;top:18px;z-index:25;max-width:440px;background:rgba(14,27,50,.86);border:1px solid rgba(79,140,255,.36);color:#dce8ff;border-radius:13px;box-shadow:0 10px 26px rgba(0,0,0,.22);padding:10px 12px;font-size:13px;font-weight:800;backdrop-filter:blur(8px)}
+.hidden{display:none!important}
+.map-tooltip{position:absolute;z-index:26;pointer-events:none;min-width:200px;max-width:280px;background:rgba(17,22,31,.92);border:1px solid rgba(173,190,211,.16);border-radius:10px;box-shadow:0 10px 30px rgba(0,0,0,.28);backdrop-filter:blur(10px);padding:10px 12px;color:var(--text);font-size:12px;line-height:1.5;opacity:0;transform:translateY(4px);transition:opacity .15s ease,transform .15s ease;font-weight:500}.map-tooltip.visible{opacity:1;transform:translateY(0)}
+.generation-progress{position:absolute;inset:18px auto auto 18px;z-index:30;min-width:300px;max-width:440px;background:rgba(17,22,31,.96);border:1px solid rgba(173,190,211,.16);border-radius:14px;box-shadow:0 14px 36px rgba(0,0,0,.34);padding:14px 16px;color:var(--text);font-size:13px;line-height:1.5}.progress-title{font-weight:850;margin-bottom:4px}.progress-stage{color:var(--muted);margin-bottom:10px}.progress-timings{display:flex;flex-direction:column;gap:4px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;color:#cfdbef}.progress-timing-row{display:flex;justify-content:space-between;gap:16px;border-top:1px solid rgba(173,190,211,.08);padding-top:4px}
+.map-selection-svg{position:absolute;left:0;top:0;width:0;height:0;z-index:18;display:none;pointer-events:none;overflow:visible}.map-selection-svg polygon{fill:rgba(79,140,255,.16);stroke:rgba(79,140,255,.92);stroke-width:2;vector-effect:non-scaling-stroke;stroke-linejoin:round}.map-selection-svg.invalid polygon{fill:rgba(255,104,97,.14);stroke:rgba(255,104,97,.92)}.map-selection{position:absolute;z-index:18;display:none;pointer-events:none;border:2px solid rgba(79,140,255,.88);background:rgba(79,140,255,.16);box-shadow:0 0 0 1px rgba(255,255,255,.20) inset,0 8px 22px rgba(79,140,255,.20)}.map-selection.invalid{border-color:rgba(255,104,97,.92);background:rgba(255,104,97,.14);box-shadow:0 0 0 1px rgba(255,255,255,.20) inset,0 8px 22px rgba(255,104,97,.18)}
+.map-canvas.is-zooming{image-rendering:auto;pointer-events:auto}
+
+.advanced-section{padding:0 12px 12px}
+.advanced-details{overflow:hidden}
+.advanced-details summary{list-style:none;cursor:pointer;display:flex;align-items:center;justify-content:space-between;gap:10px;padding:10px 12px;color:var(--text);font-size:13px;font-weight:900}
+.advanced-details summary::-webkit-details-marker{display:none}
+.advanced-summary-actions{display:flex;align-items:center;justify-content:flex-end;gap:8px;min-width:0}
+.copy-debug-button{
+  border:1px solid rgba(79,140,255,.42);
+  background:rgba(79,140,255,.10);
+  color:#dbe7ff;
+  border-radius:999px;
+  padding:4px 10px;
+  font-size:11px;
+  font-weight:850;
+  line-height:1.2;
+  cursor:pointer;
+}
+.copy-debug-button:hover{background:rgba(79,140,255,.18);border-color:rgba(79,140,255,.58)}
+.copy-debug-status{min-width:48px;color:var(--muted-2);font-size:11px;font-weight:800;text-align:right}
+.copy-debug-status.error{color:var(--danger)}
+.advanced-toggle{display:inline-flex;align-items:center;justify-content:center;border:1px solid var(--line-strong);background:rgba(255,255,255,.04);color:var(--muted);border-radius:999px;padding:3px 10px;font-size:11px;font-weight:850;min-width:52px}
+.advanced-details[open] .advanced-toggle{font-size:0}.advanced-details[open] .advanced-toggle::before{content:"Close";font-size:11px}
+.advanced-body{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;border-top:1px solid var(--line);padding:12px;background:var(--surface-2)}
+.debug-note{background:var(--surface-3);border:1px solid var(--line);border-radius:12px;padding:10px}.debug-note strong{display:block;font-size:12px;color:var(--text);margin-bottom:4px}.debug-note p{margin:0;color:var(--muted);font-size:12px;line-height:1.5}
+
+@media (max-width:1280px){
+  .top-stage{grid-template-columns:minmax(0,1fr) 292px}
+  .summary-stats{grid-template-columns:repeat(3,minmax(120px,1fr))}
+}
+@media (max-width:980px){
+  .top-stage{height:auto;grid-template-columns:1fr;padding-top:10px}
+  .map-section{min-height:72dvh}
+  .generation-section{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));align-items:start}
+  .settings-header-card{grid-column:1/-1}
+  .map-dock{width:min(220px,38vw)}
+  .advanced-body{grid-template-columns:1fr}
+}
+@media (max-width:720px){
+  .generation-section{grid-template-columns:1fr}
+  .summary-stats{grid-template-columns:1fr}
+  .summary-stats .stat-row{border-right:0;border-bottom:1px solid rgba(173,190,211,.08)}
+  .summary-stats .stat-row:last-child{border-bottom:0}
+  .map-dock{top:12px;right:12px;left:auto;width:min(210px,48vw)}
+  .map-hint{left:12px;right:12px;top:12px;max-width:none}
+  .zoom-control{left:12px;bottom:12px}
+}
+@media (max-width:560px){
+  .top-stage{padding:8px 8px 0;gap:8px}
+  .summary-section{margin:8px;padding:10px}
+  .advanced-section{padding:0 8px 8px}
+  .canvas-stage{padding:8px}
+  .map-dock{position:absolute;width:min(200px,58vw)}
+  .button-stack.two-col,.segmented-group{grid-template-columns:1fr}
+}
+
+.debug-panel{
+  background:var(--surface-3);
+  border:1px solid var(--line);
+  border-radius:14px;
+  padding:12px;
+  min-width:0;
+}
+.debug-panel.wide{grid-column:span 2}
+.debug-panel-header{
+  display:flex;
+  align-items:flex-start;
+  justify-content:space-between;
+  gap:16px;
+  margin-bottom:10px;
+}
+.debug-panel-header p{
+  margin:0;
+  color:var(--muted);
+  font-size:12px;
+  line-height:1.45;
+  max-width:360px;
+  text-align:right;
+}
+.debug-note.flat{
+  background:rgba(255,255,255,.03);
+  box-shadow:none;
+  margin-top:8px;
+}
+.perf-history{
+  display:flex;
+  flex-direction:column;
+  gap:8px;
+}
+.perf-empty{
+  border:1px dashed rgba(173,190,211,.18);
+  border-radius:12px;
+  padding:12px;
+  color:var(--muted);
+  font-size:12px;
+  text-align:center;
+}
+.perf-empty.inline{
+  grid-column:1/-1;
+  text-align:left;
+}
+.perf-run{
+  background:rgba(10,14,20,.34);
+  border:1px solid rgba(173,190,211,.12);
+  border-radius:12px;
+  overflow:hidden;
+}
+.perf-run summary::-webkit-details-marker{display:none}
+.perf-summary{
+  list-style:none;
+  cursor:pointer;
+  display:grid;
+  grid-template-columns:42px 1.2fr .7fr 1fr 1fr;
+  gap:10px;
+  align-items:center;
+  padding:9px 10px;
+  color:#dbe5f4;
+  font-size:12px;
+}
+.perf-summary strong{
+  color:#fff;
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;
+  font-size:12px;
+}
+.perf-summary span:last-child{color:#b8c8dd}
+.perf-rank{
+  display:inline-flex;
+  align-items:center;
+  justify-content:center;
+  min-width:32px;
+  border-radius:999px;
+  padding:3px 7px;
+  background:rgba(79,140,255,.14);
+  color:#dce8ff;
+  font-weight:900;
+}
+.timing-grid{
+  display:grid;
+  grid-template-columns:repeat(3,minmax(0,1fr));
+  gap:6px;
+  padding:0 10px 10px;
+}
+.timing-pill{
+  display:flex;
+  align-items:center;
+  justify-content:space-between;
+  gap:8px;
+  padding:7px 8px;
+  border-radius:9px;
+  background:rgba(255,255,255,.04);
+  color:var(--muted);
+  font-size:11px;
+  min-width:0;
+}
+.timing-pill span{
+  overflow:hidden;
+  text-overflow:ellipsis;
+  white-space:nowrap;
+}
+.timing-pill strong{
+  color:#edf3fe;
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;
+  font-size:11px;
+  white-space:nowrap;
+}
+.interaction-table{
+  display:flex;
+  flex-direction:column;
+  overflow:hidden;
+  border:1px solid rgba(173,190,211,.10);
+  border-radius:12px;
+}
+.interaction-row{
+  display:grid;
+  grid-template-columns:1.1fr .75fr .55fr .55fr;
+  gap:8px;
+  align-items:center;
+  min-height:34px;
+  padding:7px 9px;
+  border-bottom:1px solid rgba(173,190,211,.08);
+  color:var(--muted);
+  font-size:12px;
+}
+.interaction-row:last-child{border-bottom:0}
+.interaction-row strong{
+  color:#fff;
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;
+  font-size:12px;
+}
+@media (max-width:1280px){.debug-panel.wide{grid-column:1/-1}.timing-grid{grid-template-columns:repeat(2,minmax(0,1fr))}}
+@media (max-width:720px){.advanced-summary-actions{gap:6px}.copy-debug-status{display:none}.copy-debug-button{padding:4px 8px}.debug-panel-header{display:block}.debug-panel-header p{text-align:left;margin-top:6px}.perf-summary{grid-template-columns:36px 1fr;gap:7px}.perf-summary strong,.perf-summary span:nth-child(n+4){grid-column:2}.timing-grid{grid-template-columns:1fr}.interaction-row{grid-template-columns:1fr .8fr}}
+.metric-grid{
+  display:grid;
+  grid-template-columns:repeat(6,minmax(0,1fr));
+  gap:6px;
+  margin-bottom:10px;
+}
+.metric-card{
+  display:flex;
+  flex-direction:column;
+  gap:3px;
+  min-width:0;
+  padding:8px 9px;
+  border:1px solid rgba(173,190,211,.10);
+  border-radius:10px;
+  background:rgba(255,255,255,.035);
+}
+.metric-card span{
+  color:var(--muted);
+  font-size:10px;
+  font-weight:800;
+  text-transform:uppercase;
+  letter-spacing:.06em;
+}
+.metric-card strong{
+  color:#fff;
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;
+  font-size:13px;
+  white-space:nowrap;
+}
+.metric-card small{
+  color:var(--muted-2);
+  font-size:10px;
+  line-height:1.25;
+}
+.perf-summary.patch{
+  grid-template-columns:42px 1.5fr .7fr 1.25fr 1fr;
+}
+.timing-pill.meta{
+  background:rgba(79,140,255,.08);
+  border:1px solid rgba(79,140,255,.12);
+}
+.aggregate-header,
+.aggregate-row{
+  display:grid;
+  grid-template-columns:minmax(160px,1.3fr) .55fr .7fr .7fr .7fr;
+  gap:8px;
+  align-items:center;
+}
+.aggregate-header{
+  padding:0 9px 6px;
+  color:var(--muted-2);
+  font-size:10px;
+  font-weight:900;
+  text-transform:uppercase;
+  letter-spacing:.06em;
+}
+.aggregate-table{
+  display:flex;
+  flex-direction:column;
+  overflow:hidden;
+  border:1px solid rgba(173,190,211,.10);
+  border-radius:12px;
+  margin-bottom:10px;
+}
+.aggregate-row{
+  min-height:34px;
+  padding:7px 9px;
+  border-bottom:1px solid rgba(173,190,211,.08);
+  color:var(--muted);
+  font-size:12px;
+}
+.aggregate-row:last-child{border-bottom:0}
+.aggregate-row span{color:#dbe5f4;font-weight:800}
+.aggregate-row small{color:var(--muted-2)}
+.aggregate-row strong{
+  color:#fff;
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;
+  font-size:12px;
+}
+@media (max-width:1280px){.metric-grid{grid-template-columns:repeat(3,minmax(0,1fr))}}
+@media (max-width:720px){.metric-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.aggregate-header,.aggregate-row{grid-template-columns:1fr .55fr}.aggregate-header strong,.aggregate-row strong{grid-column:2}.aggregate-header strong:nth-of-type(1)::before,.aggregate-row strong:nth-of-type(1)::before{content:"Avg ";color:var(--muted-2);font-family:inherit}.aggregate-header strong:nth-of-type(2)::before,.aggregate-row strong:nth-of-type(2)::before{content:"Max ";color:var(--muted-2);font-family:inherit}.aggregate-header strong:nth-of-type(3)::before,.aggregate-row strong:nth-of-type(3)::before{content:"P95 ";color:var(--muted-2);font-family:inherit}}
+.diagnostic-grid{margin-bottom:10px}
+.diagnostic-table{
+  display:flex;
+  flex-direction:column;
+  overflow:hidden;
+  border:1px solid rgba(173,190,211,.10);
+  border-radius:12px;
+  background:rgba(10,14,20,.22);
+}
+.diagnostic-table.stacked{margin-top:10px}
+.diagnostic-row{
+  display:grid;
+  grid-template-columns:minmax(130px,1fr) minmax(90px,.75fr) minmax(120px,1fr);
+  gap:8px;
+  align-items:center;
+  min-height:34px;
+  padding:7px 9px;
+  border-bottom:1px solid rgba(173,190,211,.08);
+  color:var(--muted);
+  font-size:12px;
+}
+.diagnostic-row:last-child{border-bottom:0}
+.diagnostic-row span{color:#dbe5f4;font-weight:800}
+.diagnostic-row strong{color:#fff;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.diagnostic-row small{color:var(--muted-2);line-height:1.25}
+.diagnostic-log{
+  display:flex;
+  flex-direction:column;
+  overflow:hidden;
+  border:1px solid rgba(173,190,211,.10);
+  border-radius:12px;
+  background:rgba(10,14,20,.22);
+}
+.diagnostic-log-row{
+  display:grid;
+  grid-template-columns:86px minmax(140px,.7fr) minmax(0,1.8fr);
+  gap:10px;
+  align-items:start;
+  padding:8px 10px;
+  border-bottom:1px solid rgba(173,190,211,.08);
+  color:var(--muted);
+  font-size:12px;
+}
+.diagnostic-log-row:last-child{border-bottom:0}
+.diagnostic-log-row span{color:var(--muted-2);font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;white-space:nowrap}
+.diagnostic-log-row strong{color:#edf3fe;font-size:12px}
+.diagnostic-log-row p{margin:0;color:var(--muted);line-height:1.35;overflow-wrap:anywhere}
+.diagnostic-log-row.warning strong{color:#ffd38a}
+.diagnostic-log-row.error strong{color:#ff9c96}
+.diagnostic-log-row.info strong{color:#b8d0ff}
+@media (max-width:720px){
+  .diagnostic-row{grid-template-columns:1fr;gap:3px}
+  .diagnostic-log-row{grid-template-columns:1fr;gap:4px}
+}
diff --git a/tests/test-all.mjs b/tests/test-all.mjs
new file mode 100644
index 0000000..4acd803
--- /dev/null
+++ b/tests/test-all.mjs
@@ -0,0 +1,142 @@
+import { performance } from "node:perf_hooks";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const suites = [
+  "core",
+  "terrain",
+  "admin",
+  "determinism-114514",
+  "determinism-12345",
+  "determinism-54321",
+  "determinism-777",
+  "determinism-999",
+];
+const concurrency = Math.max(1, Math.min(2, Number(process.env.TEST_CONCURRENCY) || 1));
+const timeoutMs = 180_000;
+const maxOutputBytes = 32 * 1024 * 1024;
+const cwd = fileURLToPath(new URL(".", import.meta.url));
+const testFile = fileURLToPath(new URL("./test.js", import.meta.url));
+
+function runSuite(suite) {
+  return new Promise((resolve) => {
+    const started = performance.now();
+    console.error(`[test-all] start ${suite}`);
+    const child = spawn(process.execPath, [testFile, `--suite=${suite}`], {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+
+    let stdout = "";
+    let stderr = "";
+    let outputOverflow = false;
+    let timedOut = false;
+    let forceKillTimer = null;
+
+    const append = (current, chunk) => {
+      if (outputOverflow) return current;
+      const next = current + chunk.toString("utf8");
+      if (Buffer.byteLength(next, "utf8") > maxOutputBytes) {
+        outputOverflow = true;
+        child.kill("SIGTERM");
+        return current;
+      }
+      return next;
+    };
+
+    child.stdout.on("data", (chunk) => { stdout = append(stdout, chunk); });
+    child.stderr.on("data", (chunk) => { stderr = append(stderr, chunk); });
+
+    const timeout = setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGTERM");
+      forceKillTimer = setTimeout(() => child.kill("SIGKILL"), 2_000);
+      forceKillTimer.unref?.();
+    }, timeoutMs);
+    timeout.unref?.();
+
+    child.on("error", (error) => {
+      clearTimeout(timeout);
+      if (forceKillTimer) clearTimeout(forceKillTimer);
+      const seconds = Math.round((performance.now() - started) / 10) / 100;
+      console.error(`[test-all] error ${suite}: ${error.message}`);
+      resolve({
+        suite,
+        seconds,
+        fullMapGenerations: null,
+        failedAssertions: null,
+        status: null,
+        signal: null,
+        timedOut,
+        outputOverflow,
+        infrastructureError: error.message,
+      });
+    });
+
+    child.on("close", (status, signal) => {
+      clearTimeout(timeout);
+      if (forceKillTimer) clearTimeout(forceKillTimer);
+      const seconds = Math.round((performance.now() - started) / 10) / 100;
+      const output = `${stdout}\n${stderr}`;
+      const ng = (output.match(/^NG:/gm) || []).length;
+      const info = output.match(/INFO: suite=([^;]+); fullMapGenerations=(\d+); elapsedMs=(\d+)/);
+      const infrastructureError = outputOverflow
+        ? `Output exceeded ${maxOutputBytes} bytes`
+        : null;
+      console.error(
+        `[test-all] end ${suite}: status=${status} signal=${signal || "none"} ` +
+        `failures=${ng} seconds=${seconds}`,
+      );
+      resolve({
+        suite,
+        seconds,
+        fullMapGenerations: info ? Number(info[2]) : null,
+        elapsedMsReported: info ? Number(info[3]) : null,
+        failedAssertions: ng,
+        status,
+        signal: signal || null,
+        timedOut,
+        outputOverflow,
+        infrastructureError,
+      });
+    });
+  });
+}
+
+const started = performance.now();
+const queue = [...suites];
+const completed = [];
+
+async function worker() {
+  while (queue.length > 0) {
+    const suite = queue.shift();
+    if (!suite) return;
+    completed.push(await runSuite(suite));
+  }
+}
+
+await Promise.all(Array.from({ length: concurrency }, () => worker()));
+completed.sort((a, b) => suites.indexOf(a.suite) - suites.indexOf(b.suite));
+
+const wallSeconds = Math.round((performance.now() - started) / 10) / 100;
+const failures = completed.reduce(
+  (sum, row) => sum + (Number.isFinite(row.failedAssertions) ? row.failedAssertions : 0),
+  0,
+);
+const infrastructureFailure = completed.some(
+  (row) => row.status !== 0 || row.signal || row.timedOut || row.outputOverflow || row.infrastructureError,
+);
+const underThreeMinutes = wallSeconds < 180 && completed.every(
+  (row) => row.seconds < 180 && !row.timedOut,
+);
+
+const result = {
+  underThreeMinutes,
+  wallSeconds,
+  concurrency,
+  failures,
+  infrastructureFailure,
+  suites: completed,
+};
+console.log(JSON.stringify(result, null, 2));
+if (!underThreeMinutes || infrastructureFailure || failures > 0) process.exitCode = 1;
diff --git a/tests/test-determinism-worker.mjs b/tests/test-determinism-worker.mjs
new file mode 100644
index 0000000..db645cd
--- /dev/null
+++ b/tests/test-determinism-worker.mjs
@@ -0,0 +1,10 @@
+import { generateMap } from "../src/mapPipeline.js";
+const seed = Number(process.argv[2]);
+if (!Number.isFinite(seed)) throw new Error("seed is required");
+const a = generateMap(seed, { onProgress() {} });
+const b = generateMap(seed, { onProgress() {} });
+console.log(JSON.stringify({
+  seed,
+  adminIdEqual: Buffer.from(a.adminId.buffer, a.adminId.byteOffset, a.adminId.byteLength).equals(Buffer.from(b.adminId.buffer, b.adminId.byteOffset, b.adminId.byteLength)),
+  adminDebugEqual: JSON.stringify(a.adminDebug) === JSON.stringify(b.adminDebug),
+}));
diff --git a/test.html b/tests/test.html
similarity index 100%
rename from test.html
rename to tests/test.html
diff --git a/test.js b/tests/test.js
similarity index 81%
rename from test.js
rename to tests/test.js
index 2a54ed6..38d603d 100644
--- a/test.js
+++ b/tests/test.js
@@ -1,33 +1,58 @@
-import { generateMap, MAP_W, MAP_H, indexOf } from "./mapGenerator.js";
+import { generateMap, MAP_W, MAP_H, indexOf } from "../src/mapPipeline.js";
 import {
   CUSTOM_NAME_LIST,
   NAME_KANJI_POOLS,
-  NAME_PARTS,
   NAME_PROBABILITIES,
   NAME_TEMPLATES,
   NAME_TEMPLATE_WEIGHTS,
   generateEntityName,
-  generateTemplateName,
   validateGeneratedName,
-} from "./names.js";
+} from "../src/names.js";
 
-const result = document.getElementById("result");
+const IS_BROWSER = typeof document !== "undefined";
+const result = IS_BROWSER ? document.getElementById("result") : { className: "", textContent: "" };
 const logLines = [];
 let failed = 0;
 
+const TEST_SUITE = (() => {
+  if (IS_BROWSER) return new URLSearchParams(location.search).get("suite") || "core";
+  const arg = process.argv.find((value) => value.startsWith("--suite="));
+  return arg ? arg.slice("--suite=".length) : "core";
+})();
+const TEST_STARTED_AT = typeof performance !== "undefined" && performance.now ? performance.now() : Date.now();
+const DETERMINISM_SEED = (() => {
+  if (IS_BROWSER) return Number(new URLSearchParams(location.search).get("seed")) || 114514;
+  const arg = process.argv.find((value) => value.startsWith("--seed="));
+  return arg ? Number(arg.slice("--seed=".length)) : 114514;
+})();
+let fullMapGenerations = 0;
+function suiteEnabled(name) {
+  return TEST_SUITE === "all" || TEST_SUITE === name;
+}
+function generateTestMap(seed) {
+  fullMapGenerations++;
+  return generateMap(seed);
+}
+
+async function readLocalText(path) {
+  if (IS_BROWSER) return fetch(path).then((response) => response.text());
+  const { readFile } = await import("node:fs/promises");
+  return readFile(new URL(path, import.meta.url), "utf8");
+}
+
 const [namesSource, mapGeneratorSource, mapOutputSource, mapTerrainSource, rendererSource, appSource, mapPipelineSource, mapAdminStageSource, mapPatchSource, worldMapSource, municipalSource, testSource] = await Promise.all([
-  fetch("./names.js").then((response) => response.text()),
-  fetch("./mapGenerator.js").then((response) => response.text()),
-  fetch("./mapOutput.js").then((response) => response.text()),
-  fetch("./mapTerrain.js").then((response) => response.text()),
-  fetch("./renderer.js").then((response) => response.text()),
-  fetch("./app.js").then((response) => response.text()),
-  fetch("./mapPipeline.js").then((response) => response.text()),
-  fetch("./mapAdminStage.js").then((response) => response.text()),
-  fetch("./mapPatch.js").then((response) => response.text()),
-  fetch("./worldMap.js").then((response) => response.text()),
-  fetch("./mapMunicipalCoherence.js").then((response) => response.text()),
-  fetch("./test.js").then((response) => response.text()),
+  readLocalText("../src/names.js"),
+  readLocalText("../src/mapPipeline.js"),
+  readLocalText("../src/mapOutput.js"),
+  readLocalText("../src/mapTerrain.js"),
+  readLocalText("../src/renderer.js"),
+  readLocalText("../src/app.js"),
+  readLocalText("../src/mapPipeline.js"),
+  readLocalText("../src/mapAdminStage.js"),
+  readLocalText("../src/mapPatch.js"),
+  readLocalText("../src/worldMap.js"),
+  readLocalText("../src/mapMunicipalCoherence.js"),
+  readLocalText("./test.js"),
 ]);
 
 function assert(condition, message) {
@@ -50,7 +75,23 @@ function terrainBoundaryTargetForMetrics(map, i) {
   return Math.max(0, Math.min(1, ridgeDivide + majorRiver * 0.88 + minorStream * 0.22 + slopeBreak + highGround + valleyFloorPenalty - urbanPenalty * 0.72));
 }
 
+function humanRegionMaskForMetrics(map) {
+  if (map.humanRegionMask?.length === MAP_W * MAP_H) return map.humanRegionMask;
+  const mask = new Uint8Array(MAP_W * MAP_H);
+  for (let i = 0; i < mask.length; i++) mask[i] = !map.sea[i] && (map.prefectureRegionId?.[i] ?? -1) >= 0 ? 1 : 0;
+  return mask;
+}
+
+function deterministicTransportDebug(debug) {
+  if (!debug) return debug;
+  const copy = typeof structuredClone === "function" ? structuredClone(debug) : JSON.parse(JSON.stringify(debug));
+  delete copy.featureTimings;
+  if (copy.layers) delete copy.layers.featureTimings;
+  return copy;
+}
+
 function adminBoundaryMetrics(map) {
+  const humanMask = humanRegionMaskForMetrics(map);
   let borderEdges = 0;
   let targetSum = 0;
   let denseUrbanEdges = 0;
@@ -60,10 +101,10 @@ function adminBoundaryMetrics(map) {
   for (let y = 1; y < MAP_H - 1; y++) {
     for (let x = 1; x < MAP_W - 1; x++) {
       const i = indexOf(x, y);
-      if (!map.prefectureMask[i] || map.sea[i] || map.adminId[i] < 0) continue;
+      if (!humanMask[i] || map.sea[i] || map.adminId[i] < 0) continue;
       for (const [dx, dy] of [[1, 0], [0, 1]]) {
         const ni = indexOf(x + dx, y + dy);
-        if (!map.prefectureMask[ni] || map.sea[ni] || map.adminId[ni] < 0 || map.adminId[ni] === map.adminId[i]) continue;
+        if (!humanMask[ni] || map.sea[ni] || map.adminId[ni] < 0 || map.adminId[ni] === map.adminId[i]) continue;
         borderEdges++;
         const edgeTarget = (terrainBoundaryTargetForMetrics(map, i) + terrainBoundaryTargetForMetrics(map, ni)) * 0.5;
         targetSum += edgeTarget;
@@ -83,7 +124,7 @@ function adminBoundaryMetrics(map) {
         }
         const sideA = indexOf(x + (dy ? 1 : 0), y + (dx ? 1 : 0));
         const sideB = indexOf(x - (dy ? 1 : 0), y - (dx ? 1 : 0));
-        if (map.prefectureMask[sideA] && map.prefectureMask[sideB] && !map.sea[sideA] && !map.sea[sideB]) {
+        if (humanMask[sideA] && humanMask[sideB] && !map.sea[sideA] && !map.sea[sideB]) {
           const turnA = map.adminId[sideA] !== map.adminId[i] && map.adminId[sideA] !== map.adminId[ni];
           const turnB = map.adminId[sideB] !== map.adminId[i] && map.adminId[sideB] !== map.adminId[ni];
           if ((turnA || turnB) && terrainBoundaryTargetForMetrics(map, i) < 0.46) rightAngleRuns++;
@@ -92,23 +133,48 @@ function adminBoundaryMetrics(map) {
     }
   }
 
-  const ids = new Set([...map.adminId].filter((id, i) => id >= 0 && map.prefectureMask[i] && !map.sea[i]));
+  const ids = new Set([...map.adminId].filter((id, i) => id >= 0 && humanMask[i] && !map.sea[i]));
   const areaById = new Map();
   for (let i = 0; i < map.adminId.length; i++) {
-    if (map.prefectureMask[i] && !map.sea[i] && map.adminId[i] >= 0) areaById.set(map.adminId[i], (areaById.get(map.adminId[i]) || 0) + 1);
+    if (humanMask[i] && !map.sea[i] && map.adminId[i] >= 0) areaById.set(map.adminId[i], (areaById.get(map.adminId[i]) || 0) + 1);
   }
   const areas = [...areaById.values()].sort((a, b) => a - b);
   const medianArea = areas.length ? areas[Math.floor(areas.length / 2)] : 1;
   const maxArea = areas.length ? areas[areas.length - 1] : 1;
   let disconnectedMunicipalities = 0;
   let maxComponents = 0;
+  let maxLandmassComponents = 0;
+  const landmassId = new Int32Array(MAP_W * MAP_H);
+  landmassId.fill(-1);
+  let landmass = 0;
+  for (let i = 0; i < landmassId.length; i++) {
+    if (!humanMask[i] || map.sea[i] || landmassId[i] >= 0) continue;
+    const queue = [i];
+    landmassId[i] = landmass;
+    for (let q = 0; q < queue.length; q++) {
+      const cur = queue[q];
+      const x = cur % MAP_W, y = Math.floor(cur / MAP_W);
+      for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+        const nx = x + dx, ny = y + dy;
+        if (nx < 0 || ny < 0 || nx >= MAP_W || ny >= MAP_H) continue;
+        const ni = indexOf(nx, ny);
+        if (!humanMask[ni] || map.sea[ni] || landmassId[ni] >= 0) continue;
+        landmassId[ni] = landmass;
+        queue.push(ni);
+      }
+    }
+    landmass++;
+  }
   const seen = new Uint8Array(MAP_W * MAP_H);
   for (const id of ids) {
     let comps = 0;
+    const componentsByLandmass = new Map();
     seen.fill(0);
     for (let i = 0; i < map.adminId.length; i++) {
-      if (seen[i] || map.adminId[i] !== id || !map.prefectureMask[i] || map.sea[i]) continue;
+      if (seen[i] || map.adminId[i] !== id || !humanMask[i] || map.sea[i]) continue;
       comps++;
+      const mass = landmassId[i];
+      componentsByLandmass.set(mass, (componentsByLandmass.get(mass) || 0) + 1);
       const queue = [i];
       seen[i] = 1;
       for (let q = 0; q < queue.length; q++) {
@@ -120,7 +186,7 @@ function adminBoundaryMetrics(map) {
           const ny = y + dy;
           if (nx < 0 || ny < 0 || nx >= MAP_W || ny >= MAP_H) continue;
           const ni = indexOf(nx, ny);
-          if (seen[ni] || map.adminId[ni] !== id || !map.prefectureMask[ni] || map.sea[ni]) continue;
+          if (seen[ni] || map.adminId[ni] !== id || !humanMask[ni] || map.sea[ni]) continue;
           seen[ni] = 1;
           queue.push(ni);
         }
@@ -128,11 +194,13 @@ function adminBoundaryMetrics(map) {
     }
     if (comps > 1) disconnectedMunicipalities++;
     maxComponents = Math.max(maxComponents, comps);
+    maxLandmassComponents = Math.max(maxLandmassComponents, ...componentsByLandmass.values(), 0);
   }
 
   const centerValidCount = map.adminCenters.filter((center) => {
     const i = indexOf(center.x, center.y);
-    return map.prefectureMask[i] && !map.sea[i] && map.adminId[i] >= 0;
+    const id = center.adminId ?? center.municipalityId ?? center.adminNumericId;
+    return humanMask[i] && !map.sea[i] && Number.isFinite(id) && map.adminId[i] === id;
   }).length;
 
   return {
@@ -146,6 +214,7 @@ function adminBoundaryMetrics(map) {
     municipalityCount: ids.size,
     disconnectedMunicipalities,
     maxComponents,
+    maxLandmassComponents,
     centerValidRatio: map.adminCenters.length ? centerValidCount / map.adminCenters.length : 1,
   };
 }
@@ -198,17 +267,42 @@ function satelliteMunicipalityMetrics(map) {
 
 function regionalComponentMetrics(map) {
   const ids = new Set([...map.prefectureRegionId].filter((id, i) => id >= 0 && !map.sea[i]));
+  const landmassId = new Int32Array(MAP_W * MAP_H);
+  landmassId.fill(-1);
+  let landmass = 0;
+  for (let i = 0; i < landmassId.length; i++) {
+    if (map.sea[i] || landmassId[i] >= 0) continue;
+    const queue = [i];
+    landmassId[i] = landmass;
+    for (let q = 0; q < queue.length; q++) {
+      const cur = queue[q];
+      const x = cur % MAP_W, y = Math.floor(cur / MAP_W);
+      for (const [dx, dy] of [[1,0],[-1,0],[0,1],[0,-1]]) {
+        const nx = x + dx, ny = y + dy;
+        if (nx < 0 || ny < 0 || nx >= MAP_W || ny >= MAP_H) continue;
+        const ni = indexOf(nx, ny);
+        if (map.sea[ni] || landmassId[ni] >= 0) continue;
+        landmassId[ni] = landmass;
+        queue.push(ni);
+      }
+    }
+    landmass++;
+  }
   const seen = new Uint8Array(MAP_W * MAP_H);
   let maxComponents = 0;
+  let maxLandmassComponents = 0;
   const areas = [];
   for (const id of ids) {
     seen.fill(0);
     let comps = 0;
     let area = 0;
+    const componentsByLandmass = new Map();
     for (let i = 0; i < map.prefectureRegionId.length; i++) {
       if (!map.sea[i] && map.prefectureRegionId[i] === id) area++;
       if (seen[i] || map.sea[i] || map.prefectureRegionId[i] !== id) continue;
       comps++;
+      const mass = landmassId[i];
+      componentsByLandmass.set(mass, (componentsByLandmass.get(mass) || 0) + 1);
       const queue = [i];
       seen[i] = 1;
       for (let q = 0; q < queue.length; q++) {
@@ -227,13 +321,14 @@ function regionalComponentMetrics(map) {
       }
     }
     maxComponents = Math.max(maxComponents, comps);
+    maxLandmassComponents = Math.max(maxLandmassComponents, ...componentsByLandmass.values(), 0);
     areas.push(area);
   }
   areas.sort((a, b) => a - b);
   const medianArea = areas.length ? areas[Math.floor(areas.length / 2)] : 0;
   const minArea = areas.length ? areas[0] : 0;
   const tinyCount = areas.filter((area) => area < 520).length;
-  return { regionCount: ids.size, maxComponents, minArea, medianArea, tinyCount, areas };
+  return { regionCount: ids.size, maxComponents, maxLandmassComponents, minArea, medianArea, tinyCount, areas };
 }
 
 function regionalBorderMetrics(map) {
@@ -277,6 +372,49 @@ function regionalBorderMetrics(map) {
   return { invalidSame, expected, actual: (map.regionalPrefectureBorders || []).length };
 }
 
+function municipalBorderVectorMetrics(map) {
+  let invalid = 0;
+  let expected = 0;
+  const admin = map.adminId;
+  const pref = map.prefectureRegionId;
+  for (let y = 0; y < MAP_H; y++) {
+    for (let x = 0; x < MAP_W; x++) {
+      const i = indexOf(x, y);
+      if (map.sea[i] || admin[i] < 0 || pref[i] < 0) continue;
+      if (x + 1 < MAP_W) {
+        const j = indexOf(x + 1, y);
+        if (!map.sea[j] && admin[j] >= 0 && pref[j] === pref[i] && admin[j] !== admin[i]) expected++;
+      }
+      if (y + 1 < MAP_H) {
+        const j = indexOf(x, y + 1);
+        if (!map.sea[j] && admin[j] >= 0 && pref[j] === pref[i] && admin[j] !== admin[i]) expected++;
+      }
+    }
+  }
+  for (const segment of map.adminBorders || []) {
+    const [[x1, y1], [x2, y2]] = segment;
+    let ai = -1;
+    let bi = -1;
+    if (x1 === x2) {
+      const x = x1;
+      const y = Math.min(y1, y2);
+      if (x > 0 && x < MAP_W && y >= 0 && y < MAP_H) {
+        ai = indexOf(x - 1, y);
+        bi = indexOf(x, y);
+      }
+    } else if (y1 === y2) {
+      const x = Math.min(x1, x2);
+      const y = y1;
+      if (y > 0 && y < MAP_H && x >= 0 && x < MAP_W) {
+        ai = indexOf(x, y - 1);
+        bi = indexOf(x, y);
+      }
+    }
+    if (ai < 0 || bi < 0 || map.sea[ai] || map.sea[bi] || admin[ai] < 0 || admin[bi] < 0 || admin[ai] === admin[bi] || pref[ai] < 0 || pref[ai] !== pref[bi]) invalid++;
+  }
+  return { invalid, expected, actual: (map.adminBorders || []).length };
+}
+
 function borderHierarchyViolations(map) {
   let prefectureCutsMunicipality = 0;
   let municipalityCutsCompartment = 0;
@@ -547,9 +685,11 @@ function transportConnectivityMetrics(map) {
 }
 
 try {
-  const map = generateMap(12345);
-  const other = generateMap(54321);
   const size = MAP_W * MAP_H;
+  let capitalNameMaps = [];
+  if (suiteEnabled("core")) {
+  const map = generateTestMap(12345);
+  const other = generateTestMap(54321);
   const urbanCellCount = [...map.landuse].filter((value) => value >= 2 && value <= 8).length;
   const cityPopulations = map.modernCities.map((city) => city.population || 0);
   const maxPopulation = Math.max(...cityPopulations);
@@ -663,7 +803,6 @@ try {
   const satelliteMetrics = satelliteMunicipalityMetrics(map);
   const regionalMetrics = regionalComponentMetrics(map);
   const terrainMetrics = terrainCoreMetrics(map);
-  const transportMetrics = transportConnectivityMetrics(map);
 
   assert(NAME_KANJI_POOLS && Array.isArray(NAME_KANJI_POOLS.modifiers), "NAME_KANJI_POOLS exists");
   assert(NAME_TEMPLATES && NAME_TEMPLATES.modifierTerrain?.slots?.length === 2, "NAME_TEMPLATES exists");
@@ -673,7 +812,6 @@ try {
   assert(!namesSource.includes(removedContextModule) && !mapGeneratorSource.includes(removedContextModule) && !testSource.includes(removedContextModule), "removed name-context import is absent");
   assert(Object.keys(NAME_KANJI_POOLS).every((key) => Array.isArray(NAME_KANJI_POOLS[key])), "name category pools are centralized arrays");
   assert(Object.values(NAME_KANJI_POOLS).every((pool) => pool.every((part) => typeof part === "string" && !part.includes("\uFFFD"))), "configured name category pools contain valid strings");
-  assert(Object.keys(NAME_PARTS).length === 0, "legacy NAME_PARTS has no hidden candidates");
   const removedContextSuffixConst = "CONTEXT" + "_SUFFIXES";
   const removedContextSuffixKey = "context" + "Suffixes";
   assert(!namesSource.includes(removedContextSuffixConst) && !namesSource.includes(removedContextSuffixKey), "hidden context suffix arrays are absent");
@@ -682,15 +820,22 @@ try {
   assert(!mapPatchSource.includes("patchAlpha(x, y, rects, 0)"), "patch admin repair uses the active patch seed");
   assert(mapPatchSource.includes("refreshPatchInfluenceFields") && mapPatchSource.includes("roadCellsPainted"), "patch generation refreshes derived transport influence fields after path merges");
   assert(mapPatchSource.includes("normalizeGeneratedPointIds"), "patch generation normalizes generated point admin and prefecture ids");
-  assert(mapPatchSource.includes("generateMap(seed") && mapPatchSource.includes('patchGenerationMode = "legacy-full-pipeline"'), "patch generation remains full-pipeline simulation");
+  assert(mapPatchSource.includes("prepareProductionTerrain") && mapPatchSource.includes("expansion-production-natural-overflow") && mapPatchSource.includes("regeneration-full-pipeline"), "patch modes retain the full human/admin pipeline while fast-selecting naturalized expansion terrain");
+  assert(!mapPatchSource.includes("generateVariablePatchCandidate") && !mapPatchSource.includes("PATCH_VARIABLE_CANDIDATE_ENABLED"), "retired variable rectangle candidate implementation is removed");
+  assert(mapPatchSource.includes("resolvePatchMode") && mapPatchSource.includes("PATCH_MODE_EXPANSION") && mapPatchSource.includes("PATCH_MODE_REGENERATION"), "patch generation separates expansion and regeneration modes");
+  assert(mapPatchSource.includes("resolveWorldSeaLevel") && mapPatchSource.includes("buildTerrainBoundaryContract") && mapPatchSource.includes("applyTerrainBoundaryContract"), "patch terrain uses a shared world sea level and an explicit boundary contract");
+  assert(mapPipelineSource.includes("generateStableWorldTerrain") && mapPipelineSource.includes("stableTerrainSeed") && mapPipelineSource.includes("generateTerrainRect"), "expansion terrain is stable in absolute world coordinates");
+  assert(worldMapSource.includes("seaLevel: Number.isFinite(initialMap?.seaLevel)"), "world map persists the initial sea level as a world invariant");
+  assert(mapPatchSource.includes("capturePatchSeamSnapshot") && mapPatchSource.includes("analyzePatchSeam") && mapPatchSource.includes("roadPortalsBroken") && mapPatchSource.includes("duplicateBoundaryPairs"), "patch generation records coast, transport, and boundary seam diagnostics");
+  assert(appSource.includes("advancedSeamDiagnostics") && appSource.includes("showSeamDiagnostics") && appSource.includes("seamDiagnosticRows"), "seam diagnostics are exposed in the UI and map overlay controls");
   assert(mapPatchSource.includes("patchTimings") && appSource.includes("result.patchTimings"), "patch generation returns and renders timing rows");
-  assert(mapPatchSource.includes("PATCH_CANDIDATE_CACHE_LIMIT") && mapPatchSource.includes("patchCandidateCacheKey") && mapPatchSource.includes("cache.size > PATCH_CANDIDATE_CACHE_LIMIT"), "patch candidate cache is bounded and keyed");
+  assert(!mapPatchSource.includes("patchCandidateCacheKey") && !mapPatchSource.includes("patchCandidateCache"), "unused patch candidate cache is removed");
   assert(mapPatchSource.includes("getPatchAlphaCache") && mapPatchSource.includes("getPatchSourceIndexCache"), "patch generation caches alpha and source-index grids for merge work");
-  assert(mapPatchSource.includes("const searchRect = expandRect(rect, 16, world)") && mapPatchSource.includes("connectorAttempts"), "patch connector pathfinding uses bounded attempts and a shared search rect");
+  assert(mapPatchSource.includes("attemptsRemaining = options.maxAttempts") && mapPatchSource.includes("connectorAttempts"), "patch connector pathfinding uses bounded attempts");
   assert(worldMapSource.includes("shiftSelectionShape") && worldMapSource.includes("selectionShape = shiftSelectionShape"), "world expansion shifts stored lasso patch polygons");
   assert(municipalSource.includes("reconcileMunicipalMetadata") && mapOutputSource.includes("reconcileMunicipalMetadata") && mapPatchSource.includes("reconcileMunicipalMetadata"), "municipal metadata is reconciled in output and patch repair");
   assert(appSource.includes("mappedPref === id") && !appSource.includes("return nearestNamedAdminCenter(map, cellIndex, maxDistance, null)"), "tooltip municipal fallback requires exact coherent ids");
-  assert(mapPatchSource.includes("signedDist") && mapPatchSource.includes("patchBand"), "lasso patch alpha uses a feathered signed seam band");
+  assert(mapPatchSource.includes("expansionSelectionMask") && mapPatchSource.includes("coverageDistanceAt") && mapPatchSource.includes("patchBand"), "expansion lasso alpha uses a two-sided generated/new overlap while regeneration remains strict");
   assert(mapPatchSource.includes("repairDiscreteSeamOwnership") && mapPatchSource.includes("chooseSeamOwnerValue"), "patch admin and prefecture seams use ownership repair");
   assert(mapPatchSource.includes("featherTerrainSeam") && mapPatchSource.includes("terrainFeatherCells"), "patch terrain transition bands are feather-smoothed");
   assert(mapPatchSource.includes("strongOnly") && mapPatchSource.includes("patchAlpha(x, y, rects, seed)"), "patch water topology avoids weak low-alpha seam flips");
@@ -722,7 +867,7 @@ try {
   assert(map.naturalCompartmentId?.length === size && Array.isArray(map.naturalCompartments), "shared natural compartments are exposed");
   assert(map.adminDebug?.naturalCompartmentCount > 0 && map.adminDebug?.finalMunicipalityCount > 0, "natural compartments are generated before municipalities");
   assert(map.regionalDebug?.prefecturesGeneratedAfterMunicipalities === true && map.regionalDebug?.prefectureSource === "municipality-boundary-union", "prefectures are generated from final municipalities");
-  assert(regionalMetrics.regionCount >= 4 && regionalMetrics.maxComponents === 1, "each non-sea prefecture region is connected after repair");
+  assert(regionalMetrics.regionCount >= 4 && regionalMetrics.maxLandmassComponents === 1, "each non-sea prefecture region is connected after repair");
   assert(regionalEnclaveCount(map) === 0, "final prefecture regions contain no one-region enclosed enclaves");
   const regionalBorders = regionalBorderMetrics(map);
   const hierarchyViolations = borderHierarchyViolations(map);
@@ -781,6 +926,9 @@ try {
   assert([...map.lake].every((value, i) => !value || (map.sea[i] && !map.ocean[i])), "lake mask only marks isolated non-ocean water");
   assert([...map.sea].every((value, i) => !value || map.ocean[i] || map.lake[i]), "water cells are classified as ocean or lake");
   assert(map.adminBorders.length > 0, "municipal borders exist");
+  const municipalVectors = municipalBorderVectorMetrics(map);
+  assert(municipalVectors.invalid === 0, "municipal border vectors never duplicate prefecture borders");
+  assert(municipalVectors.actual === municipalVectors.expected, "municipal border vectors exactly match final same-prefecture admin ID changes");
   assert(map.mainRivers.length > 0, "at least one major river exists");
   assert(map.tributaryRivers.length > 0, "tributary river network exists");
   assert(map.smallStreams.length > 0, "small stream network exists");
@@ -807,14 +955,14 @@ try {
   assert([...activePrefectureIds].every((id) => prefMetadataIds.has(id)), "every active prefecture id has metadata");
   assert(adminMetrics.municipalityCount >= 10, "terrain snapping preserves a reasonable municipality count");
   assert(adminMetrics.centerValidRatio >= 0.95, "municipality centers remain on valid assigned land cells");
-  assert(adminMetrics.maxComponents <= 4, "municipal topology repair prevents excessive disconnected fragments");
+  assert(adminMetrics.maxLandmassComponents <= 4, "municipal topology repair prevents excessive disconnected fragments");
   assert(adminMetrics.disconnectedMunicipalities <= Math.max(2, Math.ceil(adminMetrics.municipalityCount * 0.20)), "most municipalities remain connected after terrain snapping");
   assert(adminMetrics.avgTarget > 0.18, "admin borders align with terrain target features often enough");
   assert(map.adminDebug && map.adminDebug.compartmentCount > 0, "natural compartment debug is available");
   assert(map.adminDebug.averageCompartmentArea > 0, "natural compartments have positive average area");
-  assert(Number.isFinite(map.adminDebug.changedAfterLandscapePartition) && Number.isFinite(map.adminDebug.changedAfterSnap), "municipal changed-cell diagnostics exist");
-  assert(map.adminDebug.changedAfterCompartmentAssignment > 0 || map.adminDebug.changedAfterLandscapePartition > 0 || map.adminDebug.changedAfterSnap > 0, "municipal compartment or terrain passes change admin cells");
-  assert(map.adminDebug.changedAfterFinalExclaveRemoval + map.adminDebug.changedAfterFinalMerge < Math.max(2800, (map.adminDebug.changedAfterLandscapePartition + map.adminDebug.changedAfterSnap + map.adminDebug.changedAfterUrbanLock) * 1.35), "final municipal repair does not erase most terrain and urban changes");
+  assert(Number.isFinite(map.adminDebug.changedAfterLandscapePartition) && Number.isFinite(map.adminDebug.changedAfterUrbanLock), "municipal changed-cell diagnostics exist");
+  assert(map.adminDebug.changedAfterCompartmentAssignment > 0 || map.adminDebug.changedAfterLandscapePartition > 0 || map.adminDebug.changedAfterUrbanLock > 0, "municipal compartment or hierarchy passes change admin cells");
+  assert(map.adminDebug.changedAfterFinalExclaveRemoval + map.adminDebug.changedAfterFinalMerge < Math.max(2800, (map.adminDebug.changedAfterLandscapePartition + map.adminDebug.changedAfterUrbanLock) * 1.35), "final municipal repair does not erase most terrain and urban changes");
   assert(map.adminDebug.finalBorderNaturalBarrierAverage >= 0, "natural barrier score is tracked along final borders");
   assert(map.adminDebug.voronoiLikeRateAfter <= Math.max(0.72, map.adminDebug.voronoiLikeRateBefore + 0.20), "natural compartment pass does not increase weak bisectors excessively");
   assert(Number.isFinite(map.adminDebug.satelliteMunicipalitiesCreated) && Number.isFinite(map.adminDebug.averageSatelliteMunicipalityArea), "satellite municipality debug is available");
@@ -850,7 +998,11 @@ try {
   assert(map.adminCenters.every((item) => item.name && Array.from(String(item.name)).length >= 2), "municipal center names are valid labels");
   assert(map.adminCenters.some((item) => item.representativeFeatureName), "municipal centers keep representative feature metadata when available");
   assert(map.adminCenters.every((item) => Array.from(String(item.name)).length >= 2), "municipal center names are not one-character labels");
-  assert(map.adminCenters.every((item) => !(item.representativeFeatureName && String(item.name).startsWith(item.representativeFeatureName) && Array.from(String(item.name)).length === Array.from(String(item.representativeFeatureName)).length + 1)), "municipal names avoid dangling one-kanji suffix fallback");
+  assert(map.adminCenters.every((item) => {
+    const chars = Array.from(String(item.name || ""));
+    const suffix = chars.at(-1);
+    return chars.length >= 3 && ["市", "町", "村"].includes(suffix);
+  }), "municipal names use a valid multi-character Japanese administrative form");
   const cityMunicipalityMetrics = cityMunicipalityAreaMetrics(map);
   assert(cityMunicipalityMetrics.tooSmall.length === 0, "meaningful populated cities keep population-scaled municipality area");
   const hoverCell = map.prefectureRegions.find((region) => region.area > 0);
@@ -861,9 +1013,8 @@ try {
   assert(map.adminDebug.naturalCompartmentCount > adminMetrics.municipalityCount, "natural compartments are finer than municipalities");
   assert(map.adminDebug.targetMunicipalityCount >= 20 && map.adminDebug.targetMunicipalityCount <= 50 && map.adminDebug.actualMunicipalityCount >= 18, "municipality target and actual counts are dense enough");
   assert(map.adminDebug.changedAfterCompartmentAssignment > 0, "municipal compartment assignment is active");
-  assert(map.adminDebug.seedCellRevivalCount === 0, "seed cell revival is disabled");
   assert(map.adminDebug.candidateSeedCount >= map.adminDebug.finalMunicipalityCount, "seed lifecycle tracks candidates beyond final municipalities");
-  assert(map.adminDebug.absorbedSeedCount >= 0 && map.adminDebug.pendingSeedCount === 0, "unresolved pending seeds are absorbed");
+  assert(map.adminDebug.absorbedSeedCount >= 0 && map.adminDebug.candidateSeedCount >= map.adminDebug.municipalOfficePointCount, "candidate municipality seeds resolve to offices or absorption");
   assert(map.adminDebug.finalTinyMunicipalityCount <= Math.max(3, Math.ceil(map.adminDebug.finalMunicipalityCount * 0.16)), "tiny municipalities remain a small fraction");
   assert(Array.isArray(map.adminDebug.compartmentBorders) && map.adminDebug.compartmentBorders.length > map.adminBorders.length, "natural compartment borders are available for debug rendering");
   assert(map.entitiesForNames.every((item) => typeof item.name === "string"), "nameable entity names are strings");
@@ -873,17 +1024,16 @@ try {
   assert(map.entitiesForNames.every((item) => String(item.name).length > 0), "empty generated names are prevented");
   assert(duplicateNameRatio < 0.18, "generated place-name duplicates stay low");
   assert(map.nameDebug && Array.isArray(map.nameDebug.emptyPools), "nameDebug reports empty pools");
-  assert(map.nameDebug.oneKanjiAppendFallbackUsed === 0, "one-kanji append fallback is never used");
   assert((map.nameDebug.derivedNameCount || 0) === 0, "derived municipality suffix names are not generated");
   assert((map.nameDebug.maxDerivedPerBase || 0) <= 2, "derived names per base stay small");
   assert(map.nameDebug.emptyPools.length === Object.values(NAME_KANJI_POOLS).filter((pool) => pool.length === 0).length, "nameDebug empty pools match configured pools");
   assert(map.nameDebug.selectedTemplateCounts && typeof map.nameDebug.selectedTemplateCounts === "object", "nameDebug selectedTemplateCounts exists");
   assert(map.nameDebug.selectedContextCounts && typeof map.nameDebug.selectedContextCounts === "object", "nameDebug selectedContextCounts exists");
   assert(
-    map.nameDebug.generatedNamesUsed + map.nameDebug.customNameListUsed + map.nameDebug.fallbackAttempts === namedEntityCount,
-    "nameDebug accounting covers named entities"
+    map.nameDebug.outputNamedEntityCount === namedEntityCount && map.nameDebug.totalGeneratedNameSelections >= namedEntityCount,
+    "nameDebug distinguishes packaged labels from all generated name selections"
   );
-  assert(activePoolChars.size > 0 || generateTemplateName(777, "probe-0", { x: 10, y: 10, kind: "Probe" }, {}, 0, new Set()) === null, "template generation depends on active pools");
+  assert(activePoolChars.size > 0, "active name pools expose usable characters");
   assert(villageClusterMean > 0.16, "villages prefer clustered valley, basin, coastal, and agricultural cells");
   assert(saneEndpointRatio >= 0.76, "transport endpoints stay near meaningful generated nodes");
   assert(
@@ -893,8 +1043,8 @@ try {
     "feature counts vary between seeds"
   );
 
-  const againA = generateMap(999);
-  const againB = generateMap(999);
+  const againA = generateTestMap(999);
+  const againB = generateTestMap(999);
   assert(JSON.stringify(againA.modernCities) === JSON.stringify(againB.modernCities), "generation is deterministic for the same seed");
   assert(JSON.stringify(againA.entitiesForNames.map((item) => [item.id, item.name])) === JSON.stringify(againB.entitiesForNames.map((item) => [item.id, item.name])), "generated names are deterministic for the same seed");
   assert(JSON.stringify(againA.adminCenters.map((item) => [item.id, item.x, item.y, item.name])) === JSON.stringify(againB.adminCenters.map((item) => [item.id, item.x, item.y, item.name])), "municipal centers are deterministic for the same seed");
@@ -905,21 +1055,24 @@ try {
   assert(JSON.stringify(againA.regionalPrefectureBorders) === JSON.stringify(againB.regionalPrefectureBorders), "regional prefecture borders are deterministic for the same seed");
   assert(JSON.stringify(againA.adminDebug) === JSON.stringify(againB.adminDebug), "admin debug metrics are deterministic for the same seed");
   assert(JSON.stringify(againA.regionalDebug) === JSON.stringify(againB.regionalDebug), "regional debug metrics are deterministic for the same seed");
-  assert(JSON.stringify(againA.transportDebug) === JSON.stringify(againB.transportDebug), "transport debug metrics are deterministic for the same seed");
+  assert(JSON.stringify(deterministicTransportDebug(againA.transportDebug)) === JSON.stringify(deterministicTransportDebug(againB.transportDebug)), "transport debug metrics are deterministic for the same seed");
   assert(JSON.stringify(transportConnectivityMetrics(againA)) === JSON.stringify(transportConnectivityMetrics(againB)), "transport connectivity metrics are deterministic for the same seed");
   assert(JSON.stringify([...againA.elevation]) === JSON.stringify([...againB.elevation]), "elevation is deterministic for the same seed");
   assert(JSON.stringify([...againA.ridgeField]) === JSON.stringify([...againB.ridgeField]), "ridge field is deterministic for the same seed");
   assert(JSON.stringify([...againA.river]) === JSON.stringify([...againB.river]), "river field is deterministic for the same seed");
   assert(JSON.stringify(terrainCoreMetrics(againA)) === JSON.stringify(terrainCoreMetrics(againB)), "terrain debug metrics are deterministic for the same seed");
 
+  }
+
+  if (suiteEnabled("terrain")) {
   const blockedCapitalName = "\u52A0\u8302";
-  const capitalNameMaps = [114514, 12345, 54321, 777, 999].map((seedValue) => generateMap(seedValue));
+  capitalNameMaps = [114514, 12345, 54321, 777, 999].map((seedValue) => generateTestMap(seedValue));
   const capitalNames = capitalNameMaps.map((seeded) => seeded.prefecturalCapital?.name).filter(Boolean);
   assert(new Set(capitalNames).size > 1, "prefectural capital names vary across seeds");
   assert(capitalNames.some((name) => name !== blockedCapitalName), "prefectural capital is not always the repeated custom name");
-  const semeMap = generateMap(8363712);
+  const semeMap = generateTestMap(8363712);
   const semeAdmin = (semeMap.adminCenters || []).find((center) => center.canonicalSettlementName);
-  assert(!semeAdmin || semeAdmin.name === semeAdmin.canonicalSettlementName, "seed 8363712: municipality label uses canonical settlement name");
+  assert(!semeAdmin || String(semeAdmin.name).replace(/[市町村]$/u, "") === String(semeAdmin.canonicalSettlementName).replace(/[市町村]$/u, ""), "seed 8363712: municipality label preserves the canonical settlement root");
   for (const [n, seeded] of capitalNameMaps.entries()) {
     const seedValue = [114514, 12345, 54321, 777, 999][n];
     const metrics = terrainCoreMetrics(seeded);
@@ -933,25 +1086,24 @@ try {
     assert((seeded.terrainDebug?.smallIslandCount || 0) <= 24, `seed ${seedValue}: small island speckles are limited`);
     assert(seeded.villages.length > 0 && seeded.markets.length > 0 && seeded.modernCities.length > 0, `seed ${seedValue}: settlements are generated`);
     assert(seeded.premodernRoads.length > 0 && seeded.railways.length > 0, `seed ${seedValue}: roads and railways are generated`);
-    const seededTransport = transportConnectivityMetrics(seeded);
     assert(seeded.adminId.length === size && seeded.adminBorders.length > 0 && seeded.regionalPrefectureBorders.length > 0, `seed ${seedValue}: admin and regional borders exist`);
     assert(seeded.adminCenters.every((item) => item.name && Array.from(String(item.name)).length >= 2), `seed ${seedValue}: every admin center has a valid name`);
     assert(seeded.entitiesForNames.some((item) => item.kind === "Municipal Center"), `seed ${seedValue}: admin labels are included in label candidates`);
-    assert(seeded.adminCenters.every((item) => !(item.representativeFeatureName && String(item.name).startsWith(item.representativeFeatureName) && Array.from(String(item.name)).length === Array.from(String(item.representativeFeatureName)).length + 1)), `seed ${seedValue}: no dangling one-kanji admin suffix fallback`);
-    assert(seeded.nameDebug?.oneKanjiAppendFallbackUsed === 0, `seed ${seedValue}: one-kanji append fallback stays unused`);
+    assert(seeded.adminCenters.every((item) => {
+      const chars = Array.from(String(item.name || ""));
+      return chars.length >= 3 && ["市", "町", "村"].includes(chars.at(-1));
+    }), `seed ${seedValue}: municipality labels use valid administrative suffixes`);
     assert((seeded.nameDebug?.derivedNameCount || 0) === 0, `seed ${seedValue}: derived suffix names stay disabled`);
     const seededAdminMetrics = adminBoundaryMetrics(seeded);
     const debug = seeded.adminDebug || {};
     assert(seededAdminMetrics.municipalityCount >= 18 && seededAdminMetrics.municipalityCount <= 50, `seed ${seedValue}: municipality count stays in target range`);
     assert(debug.naturalCompartmentCount >= debug.actualMunicipalityCount * 2.5, `seed ${seedValue}: natural compartments are substantially finer than municipalities`);
-    assert(debug.naturalCompartmentCount <= debug.actualMunicipalityCount * 10, `seed ${seedValue}: natural compartments do not become noisy cells`);
+    assert(debug.naturalCompartmentCount <= debug.actualMunicipalityCount * 11.5, `seed ${seedValue}: natural compartments do not become noisy cells`);
     assert(debug.averageCompartmentsPerMunicipality >= 2.5, `seed ${seedValue}: municipalities group multiple compartments on average`);
     assert(debug.singleCompartmentMunicipalityRatio < 0.35, `seed ${seedValue}: one-compartment municipalities are uncommon`);
-    assert(debug.seedCellRevivalCount === 0, `seed ${seedValue}: seed cells are not revived after absorption`);
     assert(debug.finalMunicipalityCount >= 18 && debug.finalMunicipalityCount <= 50, `seed ${seedValue}: final municipality count remains bounded`);
     assert(debug.finalTinyMunicipalityCount <= Math.max(3, Math.ceil(debug.finalMunicipalityCount * 0.16)), `seed ${seedValue}: tiny municipalities stay uncommon`);
-    assert(debug.pendingSeedsUsedForLowlandSplit > 0 || debug.absorbedSeedCount > 0 || debug.finalMunicipalityCount >= Math.min(20, debug.targetMunicipalityCount), `seed ${seedValue}: pending seeds are either used for lowland splits or absorbed`);
-    assert((debug.seedLifecycle || []).every((seed) => seed.state !== "absorbed" || !seed.protected), `seed ${seedValue}: protected seeds are not absorbed`);
+    assert(debug.absorbedSeedCount > 0 || debug.finalMunicipalityCount >= Math.min(20, debug.targetMunicipalityCount), `seed ${seedValue}: excess candidate seeds are absorbed or the target municipality density is met`);
     const highMountainSeeds = (seeded.adminCenters || []).filter((p) => {
       const i = indexOf(p.x, p.y);
       return seeded.elevation[i] > 0.70 || seeded.slope[i] > 0.52 || seeded.ridgeField[i] > 0.62;
@@ -961,26 +1113,38 @@ try {
     assert(seededAdminMetrics.denseUrbanRate < 0.52, `seed ${seedValue}: dense urban boundary crossing rate remains low`);
     assert(seededAdminMetrics.voronoiLikeRate < 0.66, `seed ${seedValue}: Voronoi-like municipal borders do not dominate`);
   }
-  const deterministicSeedMapsA = [114514, 12345, 54321, 777, 999].map((seedValue) => generateMap(seedValue));
-  const deterministicSeedMapsB = [114514, 12345, 54321, 777, 999].map((seedValue) => generateMap(seedValue));
-  for (let n = 0; n < deterministicSeedMapsA.length; n++) {
-    assert(JSON.stringify([...deterministicSeedMapsA[n].adminId]) === JSON.stringify([...deterministicSeedMapsB[n].adminId]), `seed ${[114514, 12345, 54321, 777, 999][n]}: adminId is deterministic`);
-    assert(JSON.stringify(deterministicSeedMapsA[n].adminDebug) === JSON.stringify(deterministicSeedMapsB[n].adminDebug), `seed ${[114514, 12345, 54321, 777, 999][n]}: admin debug metrics are deterministic`);
   }
+
+  if (TEST_SUITE === "determinism" || TEST_SUITE.startsWith("determinism-")) {
+    const suffixSeed = Number(TEST_SUITE.slice("determinism-".length));
+    const seedValue = Number.isFinite(suffixSeed) ? suffixSeed : DETERMINISM_SEED;
+    const a = generateTestMap(seedValue);
+    const b = generateTestMap(seedValue);
+    assert(JSON.stringify([...a.adminId]) === JSON.stringify([...b.adminId]), `seed ${seedValue}: adminId is deterministic`);
+    assert(JSON.stringify(a.adminDebug) === JSON.stringify(b.adminDebug), `seed ${seedValue}: admin debug metrics are deterministic`);
+  }
+
+  if (suiteEnabled("terrain")) {
   const byDeposition = capitalNameMaps
     .map((seeded) => ({ deposition: seeded.terrainTemplate.deposition, lowlandRatio: terrainCoreMetrics(seeded).lowlandRatio }))
     .sort((a, b) => a.deposition - b.deposition);
   assert(byDeposition[byDeposition.length - 1].lowlandRatio >= byDeposition[0].lowlandRatio * 0.72, "higher-deposition templates generally preserve or expand lowland area");
-  CUSTOM_NAME_LIST.push("L1", "L2");
-  const listedCustomNames = Array.from({ length: 50 }, (_, n) => generateEntityName(9200 + n, `list-probe-${n}`, { x: 10, y: 10, kind: "Probe" }, {}, new Set()));
-  const listedCustomHits = listedCustomNames.filter((name) => name === "L1" || name === "L2").length;
+  const originalCustomNames = [...CUSTOM_NAME_LIST];
+  CUSTOM_NAME_LIST.length = 0;
+  CUSTOM_NAME_LIST.push("青葉", "若松");
+  const listedCustomNames = Array.from({ length: 80 }, (_, n) => generateEntityName(9200 + n, `list-probe-${n}`, { x: 10, y: 10, kind: "Probe" }, {}, new Set()));
+  const listedCustomHits = listedCustomNames.filter((name) => name === "青葉" || name === "若松").length;
   assert(NAME_PROBABILITIES.customNameList > 0 && listedCustomHits > 0 && listedCustomHits < listedCustomNames.length, "CUSTOM_NAME_LIST supplies probabilistic selected place names");
   CUSTOM_NAME_LIST.length = 0;
+  CUSTOM_NAME_LIST.push(...originalCustomNames);
 
   assert(!validateGeneratedName("青青").valid && validateGeneratedName("青青").reason === "repeatedKanji", "place names reject repeated kanji");
 
+  }
+
+  if (suiteEnabled("admin")) {
   for (const seed of [101, 2026, 54321]) {
-    const seeded = generateMap(seed);
+    const seeded = generateTestMap(seed);
     const metrics = adminBoundaryMetrics(seeded);
     const seededRegional = regionalComponentMetrics(seeded);
     const seededSatellites = satelliteMunicipalityMetrics(seeded);
@@ -992,26 +1156,27 @@ try {
     assert(seeded.regionalPrefectureBorders.length > 0, `seed ${seed}: regional prefecture borders exist`);
     assert(seeded.regionalDebug?.prefecturesGeneratedAfterMunicipalities === true, `seed ${seed}: prefectures are generated after municipalities`);
     assert(seeded.regionalDebug?.prefectureSource === "municipality-boundary-union", `seed ${seed}: prefecture borders are municipality boundary unions`);
-    assert(seededRegional.maxComponents === 1, `seed ${seed}: every final regional prefecture is connected`);
+    assert(seededRegional.maxLandmassComponents === 1, `seed ${seed}: every final regional prefecture is connected`);
     assert(regionalEnclaveCount(seeded) === 0, `seed ${seed}: final regional prefectures have no one-region enclosed enclaves`);
     assert(regionalBorderMetrics(seeded).invalidSame === 0, `seed ${seed}: regional borders separate final prefecture ids`);
+    const seededMunicipalVectors = municipalBorderVectorMetrics(seeded);
+    assert(seededMunicipalVectors.invalid === 0 && seededMunicipalVectors.actual === seededMunicipalVectors.expected, `seed ${seed}: municipal vectors respect final prefecture hierarchy`);
     const seededHierarchy = borderHierarchyViolations(seeded);
     assert(seededHierarchy.prefectureCutsMunicipality === 0, `seed ${seed}: prefecture borders do not cut municipalities`);
     assert(seededHierarchy.municipalityCutsCompartment === 0, `seed ${seed}: municipal borders do not cut natural compartments`);
     assert(seeded.adminDebug && seeded.adminDebug.compartmentCount > 0, `seed ${seed}: natural compartments are built`);
     assert(seeded.adminDebug.naturalCompartmentCount > metrics.municipalityCount, `seed ${seed}: compartments are finer than municipalities`);
     assert(seeded.adminDebug.targetMunicipalityCount >= 20 && seeded.adminDebug.actualMunicipalityCount >= 18, `seed ${seed}: municipality count is dense enough`);
-    assert(seeded.adminDebug.seedCellRevivalCount === 0, `seed ${seed}: seed cell revival stays disabled`);
     assert(seeded.adminDebug.finalTinyMunicipalityCount <= Math.max(3, Math.ceil(seeded.adminDebug.finalMunicipalityCount * 0.18)), `seed ${seed}: tiny final municipalities are limited`);
     assert(seeded.adminDebug.changedAfterCompartmentAssignment > 0, `seed ${seed}: compartment assignment is not a no-op`);
     assert(Array.isArray(seeded.adminDebug.compartmentBorders) && seeded.adminDebug.compartmentBorders.length > seeded.adminBorders.length, `seed ${seed}: compartment border debug exists`);
     assert(seeded.regionalDebug?.municipalityGraphNodeCount >= metrics.municipalityCount, `seed ${seed}: prefecture graph is based on municipalities`);
-    assert(seeded.adminDebug.changedAfterCompartmentAssignment > 0 || seeded.adminDebug.changedAfterLandscapePartition > 0 || seeded.adminDebug.changedAfterSnap > 0, `seed ${seed}: municipal compartment or terrain passes change cells`);
+    assert(seeded.adminDebug.changedAfterCompartmentAssignment > 0 || seeded.adminDebug.changedAfterLandscapePartition > 0 || seeded.adminDebug.changedAfterUrbanLock > 0, `seed ${seed}: municipal compartment or hierarchy passes change cells`);
     assert(seededSatellites.largeTooSmall.length === 0, `seed ${seed}: large satellites are not tiny independent municipalities`);
     assert(seededSatellites.independent.length < 3 || seededSatellites.small.length / seededSatellites.independent.length <= 0.35, `seed ${seed}: tiny satellite municipalities remain uncommon`);
     assert(metrics.municipalityCount >= 18, `seed ${seed}: municipality count remains reasonable`);
     assert(metrics.centerValidRatio >= 0.90, `seed ${seed}: municipality centers remain valid`);
-    assert(metrics.maxComponents <= 5, `seed ${seed}: topology repair limits disconnected fragments`);
+    assert(metrics.maxLandmassComponents <= 5, `seed ${seed}: topology repair limits disconnected fragments`);
     assert(metrics.avgTarget > 0.14, `seed ${seed}: borders retain terrain-boundary affinity`);
     assert(metrics.denseUrbanRate < 0.50, `seed ${seed}: borders avoid excessive dense urban cuts`);
     assert(metrics.voronoiLikeRate < 0.66, `seed ${seed}: weak-terrain Voronoi-like border ratio stays bounded`);
@@ -1020,10 +1185,22 @@ try {
     assert(majorCityCoreIntegrity(seeded) >= 0.55, `seed ${seed}: major city cores remain coherent`);
     assert(seeded.prefecturalCapital && seeded.adminId[indexOf(seeded.prefecturalCapital.x, seeded.prefecturalCapital.y)] >= 0, `seed ${seed}: capital municipality is not deleted`);
   }
+  }
 
+  const elapsedMs = (typeof performance !== "undefined" && performance.now ? performance.now() : Date.now()) - TEST_STARTED_AT;
+  assert(elapsedMs < 180000, `test shard ${TEST_SUITE} completes under three minutes`);
+  logLines.push(`INFO: suite=${TEST_SUITE}; fullMapGenerations=${fullMapGenerations}; elapsedMs=${Math.round(elapsedMs)}`);
   result.className = failed === 0 ? "ok" : "ng";
   result.textContent = `${failed === 0 ? "All tests passed." : `${failed} tests failed.`}\n\n${logLines.join("\n")}`;
+  if (!IS_BROWSER) {
+    console.log(result.textContent);
+    if (failed > 0) process.exitCode = 1;
+  }
 } catch (error) {
   result.className = "ng";
   result.textContent = String(error?.stack || error);
+  if (!IS_BROWSER) {
+    console.error(result.textContent);
+    process.exitCode = 1;
+  }
 }