@plasius/hexagons 1.0.3 → 1.0.5

package/dist-cjs/game.js

@@ -12,26 +12,397 @@ const gpu_xr_1 = require("@plasius/gpu-xr");
 const worldMap_js_1 = require("./worldMap.js");
 const game_module_css_1 = __importDefault(require("./styles/game.module.css"));
 const HEX_SIZE = 18;
+const HEIGHT_SCALE = 26;
+const HUMAN_EYE_HEIGHT = 1.72;
+const WALK_SPEED = 20;
+const FLY_SPEED = 32;
+const VERTICAL_FLY_SPEED = 22;
+const LOOK_SENSITIVITY = 0.0032;
+const NEAR_PLANE = 0.5;
+const FAR_PLANE = 1100;
+const FOV_RAD = Math.PI / 3;
+const CAMERA_UPDATE_MS = 100;
 function formatPercent(value) {
     return `${Math.round(value * 100)}%`;
 }
 function formatNumber(value) {
     return Number.isFinite(value) ? value.toFixed(2) : "n/a";
 }
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function wrapAngle(value) {
+    const full = Math.PI * 2;
+    const wrapped = ((value % full) + full) % full;
+    return wrapped > Math.PI ? wrapped - full : wrapped;
+}
+function hexCorners(centerX, centerZ, size) {
+    const points = [];
+    for (let i = 0; i < 6; i += 1) {
+        const angle = (Math.PI / 180) * (60 * i + 30);
+        points.push({
+            x: centerX + size * Math.cos(angle),
+            z: centerZ + size * Math.sin(angle),
+        });
+    }
+    return points;
+}
+function tintHex(hex, amount) {
+    const safe = hex.replace("#", "");
+    const channels = safe.length === 3
+        ? safe.split("").map((c) => parseInt(c + c, 16))
+        : [0, 2, 4].map((offset) => parseInt(safe.slice(offset, offset + 2), 16));
+    const factor = clamp(1 + amount, 0.2, 1.9);
+    const next = channels
+        .map((channel) => clamp(Math.round(channel * factor), 0, 255))
+        .map((channel) => channel.toString(16).padStart(2, "0"))
+        .join("");
+    return `#${next}`;
+}
+function findNearestTileIndex(tiles, x, z) {
+    if (tiles.length === 0) {
+        return 0;
+    }
+    let nearestIndex = 0;
+    let nearestDistance = Number.POSITIVE_INFINITY;
+    for (let index = 0; index < tiles.length; index += 1) {
+        const tile = tiles[index];
+        const dx = tile.x - x;
+        const dz = tile.y - z;
+        const distance = dx * dx + dz * dz;
+        if (distance < nearestDistance) {
+            nearestDistance = distance;
+            nearestIndex = index;
+        }
+    }
+    return nearestIndex;
+}
+function sampleGroundHeight(tiles, x, z) {
+    const index = findNearestTileIndex(tiles, x, z);
+    const tile = tiles[index];
+    if (!tile) {
+        return 0;
+    }
+    return tile.terrain.height * HEIGHT_SCALE;
+}
+function initialCamera(tiles) {
+    if (tiles.length === 0) {
+        return {
+            x: 0,
+            y: HUMAN_EYE_HEIGHT,
+            z: 0,
+            yaw: 0,
+            pitch: -0.35,
+        };
+    }
+    let sumX = 0;
+    let sumZ = 0;
+    for (const tile of tiles) {
+        sumX += tile.x;
+        sumZ += tile.y;
+    }
+    const x = sumX / tiles.length;
+    const z = sumZ / tiles.length;
+    const ground = sampleGroundHeight(tiles, x, z);
+    return {
+        x,
+        y: ground + HUMAN_EYE_HEIGHT,
+        z,
+        yaw: -Math.PI * 0.12,
+        pitch: -0.38,
+    };
+}
+function projectPoint(point, camera, viewportWidth, viewportHeight, focalLength) {
+    const dx = point.x - camera.x;
+    const dy = point.y - camera.y;
+    const dz = point.z - camera.z;
+    const sinYaw = Math.sin(camera.yaw);
+    const cosYaw = Math.cos(camera.yaw);
+    const xYaw = cosYaw * dx - sinYaw * dz;
+    const zYaw = sinYaw * dx + cosYaw * dz;
+    const sinPitch = Math.sin(camera.pitch);
+    const cosPitch = Math.cos(camera.pitch);
+    const yPitch = cosPitch * dy - sinPitch * zYaw;
+    const zPitch = sinPitch * dy + cosPitch * zYaw;
+    if (zPitch <= NEAR_PLANE || zPitch >= FAR_PLANE) {
+        return null;
+    }
+    return {
+        x: viewportWidth * 0.5 + (xYaw / zPitch) * focalLength,
+        y: viewportHeight * 0.57 - (yPitch / zPitch) * focalLength,
+        depth: zPitch,
+    };
+}
+function renderScene(context, canvas, tiles, camera, selectedIndex) {
+    const width = canvas.width;
+    const height = canvas.height;
+    const sky = context.createLinearGradient(0, 0, 0, height);
+    sky.addColorStop(0, "#0e1f33");
+    sky.addColorStop(0.55, "#15304b");
+    sky.addColorStop(1, "#1f2f22");
+    context.fillStyle = sky;
+    context.fillRect(0, 0, width, height);
+    const focalLength = (height * 0.86) / Math.tan(FOV_RAD * 0.5);
+    const drawQueue = [];
+    for (let index = 0; index < tiles.length; index += 1) {
+        const tile = tiles[index];
+        const elevation = tile.terrain.height * HEIGHT_SCALE;
+        const corners = hexCorners(tile.x, tile.y, HEX_SIZE);
+        const projectedCorners = [];
+        let depthTotal = 0;
+        let valid = true;
+        for (const corner of corners) {
+            const projected = projectPoint({ x: corner.x, y: elevation, z: corner.z }, camera, width, height, focalLength);
+            if (!projected) {
+                valid = false;
+                break;
+            }
+            projectedCorners.push(projected);
+            depthTotal += projected.depth;
+        }
+        if (!valid || projectedCorners.length === 0) {
+            continue;
+        }
+        const path = new Path2D();
+        path.moveTo(projectedCorners[0].x, projectedCorners[0].y);
+        for (let i = 1; i < projectedCorners.length; i += 1) {
+            path.lineTo(projectedCorners[i].x, projectedCorners[i].y);
+        }
+        path.closePath();
+        const depth = depthTotal / projectedCorners.length;
+        const distanceShade = clamp(1 - depth / 520, 0.2, 1);
+        const elevationShade = clamp((elevation / HEIGHT_SCALE - 0.5) * 0.25, -0.16, 0.18);
+        const color = tintHex(tile.color, distanceShade - 1 + elevationShade);
+        drawQueue.push({
+            path,
+            color,
+            depth,
+            highlighted: index === selectedIndex,
+        });
+    }
+    drawQueue.sort((a, b) => b.depth - a.depth);
+    for (const item of drawQueue) {
+        context.fillStyle = item.color;
+        context.fill(item.path);
+        context.lineWidth = item.highlighted ? 2.3 : 1.2;
+        context.strokeStyle = item.highlighted
+            ? "rgba(255, 255, 255, 0.92)"
+            : "rgba(11, 18, 29, 0.42)";
+        context.stroke(item.path);
+    }
+    context.strokeStyle = "rgba(230, 245, 255, 0.8)";
+    context.lineWidth = 1;
+    const crosshairX = width * 0.5;
+    const crosshairY = height * 0.55;
+    context.beginPath();
+    context.moveTo(crosshairX - 8, crosshairY);
+    context.lineTo(crosshairX + 8, crosshairY);
+    context.moveTo(crosshairX, crosshairY - 8);
+    context.lineTo(crosshairX, crosshairY + 8);
+    context.stroke();
+}
 function Game() {
     const [seed, setSeed] = (0, react_1.useState)(1337);
+    const [mode, setMode] = (0, react_1.useState)("walk");
     const [selectedIndex, setSelectedIndex] = (0, react_1.useState)(0);
+    const [cameraHud, setCameraHud] = (0, react_1.useState)({
+        x: 0,
+        y: HUMAN_EYE_HEIGHT,
+        z: 0,
+        yaw: 0,
+        pitch: -0.35,
+        ground: 0,
+    });
+    const canvasRef = (0, react_1.useRef)(null);
+    const cameraRef = (0, react_1.useRef)({
+        x: 0,
+        y: HUMAN_EYE_HEIGHT,
+        z: 0,
+        yaw: 0,
+        pitch: -0.35,
+    });
+    const keysRef = (0, react_1.useRef)(new Set());
+    const dragRef = (0, react_1.useRef)({
+        active: false,
+        pointerId: -1,
+        lastX: 0,
+        lastY: 0,
+    });
     const world = (0, react_1.useMemo)(() => (0, gpu_world_generator_1.generateTemperateMixedForest)({ seed, radius: 9 }), [seed]);
     const tiles = (0, react_1.useMemo)(() => (0, worldMap_js_1.buildHexMapTiles)(world.cells, world.terrain, HEX_SIZE), [world]);
-    const bounds = (0, react_1.useMemo)(() => (0, worldMap_js_1.computeMapBounds)(tiles, HEX_SIZE), [tiles]);
     const safeSelectedIndex = selectedIndex >= 0 && selectedIndex < tiles.length ? selectedIndex : 0;
     const selected = tiles[safeSelectedIndex];
-    const viewBox = `${bounds.minX} ${bounds.minY} ${bounds.maxX - bounds.minX} ${bounds.maxY - bounds.minY}`;
+    (0, react_1.useEffect)(() => {
+        const camera = initialCamera(tiles);
+        cameraRef.current = camera;
+        const nearestIndex = findNearestTileIndex(tiles, camera.x, camera.z);
+        setSelectedIndex(nearestIndex);
+        setCameraHud({
+            ...camera,
+            ground: sampleGroundHeight(tiles, camera.x, camera.z),
+        });
+    }, [tiles]);
+    (0, react_1.useEffect)(() => {
+        const camera = cameraRef.current;
+        const ground = sampleGroundHeight(tiles, camera.x, camera.z);
+        if (mode === "walk") {
+            camera.y = ground + HUMAN_EYE_HEIGHT;
+        }
+        else {
+            camera.y = Math.max(camera.y, ground + HUMAN_EYE_HEIGHT + 5);
+        }
+    }, [mode, tiles]);
+    (0, react_1.useEffect)(() => {
+        const canvas = canvasRef.current;
+        if (!canvas || tiles.length === 0) {
+            return;
+        }
+        const context = canvas.getContext("2d");
+        if (!context) {
+            return;
+        }
+        let frame = 0;
+        let lastTime = performance.now();
+        let hudAccumulator = 0;
+        const applyCanvasSize = () => {
+            const ratio = window.devicePixelRatio || 1;
+            const width = Math.max(1, Math.floor(canvas.clientWidth * ratio));
+            const height = Math.max(1, Math.floor(canvas.clientHeight * ratio));
+            if (canvas.width !== width || canvas.height !== height) {
+                canvas.width = width;
+                canvas.height = height;
+            }
+        };
+        const onKeyDown = (event) => {
+            if (event.repeat) {
+                return;
+            }
+            if (event.code === "KeyF") {
+                setMode((current) => (current === "walk" ? "fly" : "walk"));
+                event.preventDefault();
+                return;
+            }
+            keysRef.current.add(event.code);
+            if (event.code === "Space" ||
+                event.code.startsWith("Arrow") ||
+                event.code === "KeyW" ||
+                event.code === "KeyA" ||
+                event.code === "KeyS" ||
+                event.code === "KeyD") {
+                event.preventDefault();
+            }
+        };
+        const onKeyUp = (event) => {
+            keysRef.current.delete(event.code);
+        };
+        const onBlur = () => {
+            keysRef.current.clear();
+            dragRef.current.active = false;
+        };
+        window.addEventListener("keydown", onKeyDown);
+        window.addEventListener("keyup", onKeyUp);
+        window.addEventListener("blur", onBlur);
+        const tick = (now) => {
+            applyCanvasSize();
+            const camera = cameraRef.current;
+            const deltaSeconds = Math.min(0.05, (now - lastTime) / 1000);
+            lastTime = now;
+            const keys = keysRef.current;
+            const sprint = keys.has("ShiftLeft") || keys.has("ShiftRight");
+            const baseSpeed = mode === "fly" ? FLY_SPEED : WALK_SPEED;
+            const speed = sprint ? baseSpeed * 1.85 : baseSpeed;
+            let inputX = 0;
+            let inputZ = 0;
+            if (keys.has("KeyW") || keys.has("ArrowUp"))
+                inputZ += 1;
+            if (keys.has("KeyS") || keys.has("ArrowDown"))
+                inputZ -= 1;
+            if (keys.has("KeyA") || keys.has("ArrowLeft"))
+                inputX -= 1;
+            if (keys.has("KeyD") || keys.has("ArrowRight"))
+                inputX += 1;
+            const inputLength = Math.hypot(inputX, inputZ);
+            if (inputLength > 0) {
+                const nx = inputX / inputLength;
+                const nz = inputZ / inputLength;
+                const sinYaw = Math.sin(camera.yaw);
+                const cosYaw = Math.cos(camera.yaw);
+                camera.x += (nx * cosYaw + nz * sinYaw) * speed * deltaSeconds;
+                camera.z += (nz * cosYaw - nx * sinYaw) * speed * deltaSeconds;
+            }
+            const ground = sampleGroundHeight(tiles, camera.x, camera.z);
+            if (mode === "walk") {
+                camera.y = ground + HUMAN_EYE_HEIGHT;
+            }
+            else {
+                let verticalInput = 0;
+                if (keys.has("Space") || keys.has("KeyE"))
+                    verticalInput += 1;
+                if (keys.has("KeyC") || keys.has("KeyQ"))
+                    verticalInput -= 1;
+                camera.y += verticalInput * VERTICAL_FLY_SPEED * deltaSeconds;
+                camera.y = Math.max(camera.y, ground + 0.6);
+            }
+            camera.pitch = clamp(camera.pitch, -1.2, 0.75);
+            camera.yaw = wrapAngle(camera.yaw);
+            const nearestIndex = findNearestTileIndex(tiles, camera.x, camera.z);
+            renderScene(context, canvas, tiles, camera, nearestIndex);
+            hudAccumulator += deltaSeconds * 1000;
+            if (hudAccumulator >= CAMERA_UPDATE_MS) {
+                hudAccumulator = 0;
+                setSelectedIndex(nearestIndex);
+                setCameraHud({
+                    ...camera,
+                    ground,
+                });
+            }
+            frame = window.requestAnimationFrame(tick);
+        };
+        frame = window.requestAnimationFrame(tick);
+        return () => {
+            window.cancelAnimationFrame(frame);
+            window.removeEventListener("keydown", onKeyDown);
+            window.removeEventListener("keyup", onKeyUp);
+            window.removeEventListener("blur", onBlur);
+        };
+    }, [mode, tiles]);
+    const handlePointerDown = (event) => {
+        const canvas = canvasRef.current;
+        if (!canvas) {
+            return;
+        }
+        canvas.focus();
+        canvas.setPointerCapture(event.pointerId);
+        dragRef.current.active = true;
+        dragRef.current.pointerId = event.pointerId;
+        dragRef.current.lastX = event.clientX;
+        dragRef.current.lastY = event.clientY;
+    };
+    const handlePointerMove = (event) => {
+        if (!dragRef.current.active || dragRef.current.pointerId !== event.pointerId) {
+            return;
+        }
+        const dx = event.clientX - dragRef.current.lastX;
+        const dy = event.clientY - dragRef.current.lastY;
+        dragRef.current.lastX = event.clientX;
+        dragRef.current.lastY = event.clientY;
+        const camera = cameraRef.current;
+        camera.yaw = wrapAngle(camera.yaw + dx * LOOK_SENSITIVITY);
+        camera.pitch = clamp(camera.pitch - dy * LOOK_SENSITIVITY * 0.82, -1.2, 0.75);
+    };
+    const handlePointerUp = (event) => {
+        if (dragRef.current.pointerId !== event.pointerId) {
+            return;
+        }
+        dragRef.current.active = false;
+        dragRef.current.pointerId = -1;
+        event.currentTarget.releasePointerCapture(event.pointerId);
+    };
     const handleRegenerate = () => {
         setSeed((current) => ((current * 1664525 + 1013904223) >>> 0) % 2147483647);
         setSelectedIndex(0);
     };
-    return ((0, jsx_runtime_1.jsx)(error_1.ErrorBoundary, { name: "Game", children: (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.game, children: [(0, jsx_runtime_1.jsxs)("header", { className: game_module_css_1.default.header, children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("h1", { className: game_module_css_1.default.title, children: "GPU World Cell Explorer" }), (0, jsx_runtime_1.jsxs)("p", { className: game_module_css_1.default.subtitle, children: ["Hex terrain generated through ", (0, jsx_runtime_1.jsx)("code", { children: "@plasius/gpu-world-generator" }), " ", "and configured alongside lighting/particle/XR package profiles."] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.controls, children: [(0, jsx_runtime_1.jsxs)("span", { className: game_module_css_1.default.seed, children: ["Seed ", seed] }), (0, jsx_runtime_1.jsx)("button", { className: game_module_css_1.default.button, onClick: handleRegenerate, children: "Regenerate" })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.layout, children: [(0, jsx_runtime_1.jsx)("section", { className: game_module_css_1.default.mapCard, children: (0, jsx_runtime_1.jsx)("svg", { className: game_module_css_1.default.map, viewBox: viewBox, role: "img", "aria-label": "Hex terrain map", children: tiles.map((tile, index) => ((0, jsx_runtime_1.jsx)("polygon", { className: `${game_module_css_1.default.tile} ${index === safeSelectedIndex ? game_module_css_1.default.tileActive : ""}`, points: tile.points, fill: tile.color, onPointerEnter: () => setSelectedIndex(index), onClick: () => setSelectedIndex(index) }, `${tile.q}:${tile.r}`))) }) }), (0, jsx_runtime_1.jsxs)("aside", { className: game_module_css_1.default.panel, children: [(0, jsx_runtime_1.jsx)("h2", { className: game_module_css_1.default.panelTitle, children: "Selected Tile" }), (0, jsx_runtime_1.jsxs)("dl", { className: game_module_css_1.default.stats, children: [(0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Axial" }), (0, jsx_runtime_1.jsxs)("dd", { className: game_module_css_1.default.value, children: ["q ", selected?.q ?? 0, ", r ", selected?.r ?? 0] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Biome" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected
+    return ((0, jsx_runtime_1.jsx)(error_1.ErrorBoundary, { name: "Game", children: (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.game, children: [(0, jsx_runtime_1.jsxs)("header", { className: game_module_css_1.default.header, children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("h1", { className: game_module_css_1.default.title, children: "Generator" }), (0, jsx_runtime_1.jsx)("p", { className: game_module_css_1.default.subtitle, children: "Explore procedurally generated terrain in first-person. Walk at human eye height above the surface or switch to fly mode for aerial scouting." })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.controls, children: [(0, jsx_runtime_1.jsxs)("span", { className: game_module_css_1.default.seed, children: ["Seed ", seed] }), (0, jsx_runtime_1.jsxs)("button", { className: game_module_css_1.default.modeButton, onClick: () => setMode((current) => (current === "walk" ? "fly" : "walk")), children: ["Mode: ", mode === "walk" ? "Walk" : "Fly"] }), (0, jsx_runtime_1.jsx)("button", { className: game_module_css_1.default.button, onClick: handleRegenerate, children: "Regenerate" })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.layout, children: [(0, jsx_runtime_1.jsxs)("section", { className: game_module_css_1.default.mapCard, children: [(0, jsx_runtime_1.jsx)("canvas", { ref: canvasRef, className: game_module_css_1.default.viewport, role: "img", "aria-label": "Generator first-person world view", tabIndex: 0, onPointerDown: handlePointerDown, onPointerMove: handlePointerMove, onPointerUp: handlePointerUp, onPointerCancel: handlePointerUp, onContextMenu: (event) => event.preventDefault() }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.overlay, children: [(0, jsx_runtime_1.jsx)("span", { className: game_module_css_1.default.overlayTitle, children: mode === "walk" ? "Walking View" : "Flight View" }), (0, jsx_runtime_1.jsx)("span", { className: game_module_css_1.default.overlayText, children: "Drag to look \u2022 W/A/S/D move \u2022 F toggles walk/fly" })] })] }), (0, jsx_runtime_1.jsxs)("aside", { className: game_module_css_1.default.panel, children: [(0, jsx_runtime_1.jsx)("h2", { className: game_module_css_1.default.panelTitle, children: "Selected Tile" }), (0, jsx_runtime_1.jsxs)("dl", { className: game_module_css_1.default.stats, children: [(0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Axial" }), (0, jsx_runtime_1.jsxs)("dd", { className: game_module_css_1.default.value, children: ["q ", selected?.q ?? 0, ", r ", selected?.r ?? 0] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Biome" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected
                                                         ? gpu_world_generator_1.TerrainBiomeLabel[selected.terrain.biome]
                                                         : "Unknown" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Macro Biome" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected?.terrain.macroBiome === undefined
                                                         ? "n/a"
@@ -39,5 +410,5 @@ function Game() {
                                                         ? "n/a"
                                                         : gpu_world_generator_1.SurfaceCoverLabel[selected.terrain.surface] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Feature" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected?.terrain.feature === undefined
                                                         ? "none"
-                                                        : gpu_world_generator_1.MicroFeatureLabel[selected.terrain.feature] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Height" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected ? formatNumber(selected.terrain.height) : "n/a" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Heat" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected ? formatPercent(selected.terrain.heat) : "n/a" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Moisture" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected ? formatPercent(selected.terrain.moisture) : "n/a" })] })] }), (0, jsx_runtime_1.jsx)("h2", { className: game_module_css_1.default.panelTitle, children: "GPU Stack" }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.chipRow, children: [(0, jsx_runtime_1.jsx)("span", { className: game_module_css_1.default.chip, children: "worldgen: mixed-forest" }), (0, jsx_runtime_1.jsxs)("span", { className: game_module_css_1.default.chip, children: ["tiles: ", tiles.length] }), (0, jsx_runtime_1.jsxs)("span", { className: game_module_css_1.default.chip, children: ["xr modes: ", gpu_xr_1.xrSessionModes.filter((mode) => mode !== "inline").length] })] }), (0, jsx_runtime_1.jsxs)("dl", { className: game_module_css_1.default.stats, children: [(0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "World Generator" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: "@plasius/gpu-world-generator" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "XR Runtime" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: "@plasius/gpu-xr" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "XR Session Modes" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: gpu_xr_1.xrSessionModes.filter((mode) => mode !== "inline").join(", ") })] })] })] })] })] }) }));
+                                                        : gpu_world_generator_1.MicroFeatureLabel[selected.terrain.feature] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Height" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected ? formatNumber(selected.terrain.height) : "n/a" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Heat" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected ? formatPercent(selected.terrain.heat) : "n/a" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Moisture" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: selected ? formatPercent(selected.terrain.moisture) : "n/a" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Camera X/Z" }), (0, jsx_runtime_1.jsxs)("dd", { className: game_module_css_1.default.value, children: [formatNumber(cameraHud.x), " / ", formatNumber(cameraHud.z)] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Camera Height" }), (0, jsx_runtime_1.jsxs)("dd", { className: game_module_css_1.default.value, children: [formatNumber(cameraHud.y), " m"] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Clearance" }), (0, jsx_runtime_1.jsxs)("dd", { className: game_module_css_1.default.value, children: [formatNumber(cameraHud.y - cameraHud.ground), " m"] })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "Yaw / Pitch" }), (0, jsx_runtime_1.jsxs)("dd", { className: game_module_css_1.default.value, children: [Math.round((cameraHud.yaw * 180) / Math.PI), "\u00B0 /", " ", Math.round((cameraHud.pitch * 180) / Math.PI), "\u00B0"] })] })] }), (0, jsx_runtime_1.jsx)("h2", { className: game_module_css_1.default.panelTitle, children: "GPU Stack" }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.chipRow, children: [(0, jsx_runtime_1.jsx)("span", { className: game_module_css_1.default.chip, children: "worldgen: mixed-forest" }), (0, jsx_runtime_1.jsxs)("span", { className: game_module_css_1.default.chip, children: ["tiles: ", tiles.length] }), (0, jsx_runtime_1.jsxs)("span", { className: game_module_css_1.default.chip, children: ["mode: ", mode] }), (0, jsx_runtime_1.jsxs)("span", { className: game_module_css_1.default.chip, children: ["xr modes: ", gpu_xr_1.xrSessionModes.filter((mode) => mode !== "inline").length] })] }), (0, jsx_runtime_1.jsxs)("dl", { className: game_module_css_1.default.stats, children: [(0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "World Generator" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: "@plasius/gpu-world-generator" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "XR Runtime" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: "@plasius/gpu-xr" })] }), (0, jsx_runtime_1.jsxs)("div", { className: game_module_css_1.default.row, children: [(0, jsx_runtime_1.jsx)("dt", { className: game_module_css_1.default.label, children: "XR Session Modes" }), (0, jsx_runtime_1.jsx)("dd", { className: game_module_css_1.default.value, children: gpu_xr_1.xrSessionModes.filter((mode) => mode !== "inline").join(", ") })] })] }), (0, jsx_runtime_1.jsx)("h2", { className: game_module_css_1.default.panelTitle, children: "Controls" }), (0, jsx_runtime_1.jsxs)("ul", { className: game_module_css_1.default.controlList, children: [(0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("kbd", { children: "W" }), (0, jsx_runtime_1.jsx)("kbd", { children: "A" }), (0, jsx_runtime_1.jsx)("kbd", { children: "S" }), (0, jsx_runtime_1.jsx)("kbd", { children: "D" }), " move"] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("kbd", { children: "Shift" }), " sprint"] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("kbd", { children: "Drag" }), " look around"] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("kbd", { children: "F" }), " toggle walk/fly"] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("kbd", { children: "Space" }), "/", (0, jsx_runtime_1.jsx)("kbd", { children: "E" }), " up (fly)"] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("kbd", { children: "Q" }), "/", (0, jsx_runtime_1.jsx)("kbd", { children: "C" }), " down (fly)"] })] })] })] })] }) }));
 }

package/dist-cjs/styles/game.module.css

@@ -45,7 +45,9 @@
 .controls {
   display: flex;
   align-items: center;
+  flex-wrap: wrap;
   gap: 0.65rem;
+  justify-content: flex-end;
 }
 
 .seed {
@@ -57,6 +59,27 @@
   padding: 0.3rem 0.7rem;
 }
 
+.modeButton {
+  border: 1px solid rgba(120, 201, 255, 0.44);
+  color: var(--text);
+  background: rgba(120, 201, 255, 0.16);
+  border-radius: 999px;
+  padding: 0.5rem 0.9rem;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+  cursor: pointer;
+  transition: transform 120ms ease, filter 120ms ease;
+}
+
+.modeButton:hover {
+  transform: translateY(-1px);
+  filter: brightness(1.06);
+}
+
+.modeButton:active {
+  transform: translateY(0);
+}
+
 .button {
   border: 0;
   color: #001323;
@@ -93,13 +116,55 @@
 }
 
 .mapCard {
+  position: relative;
   padding: 0.65rem;
 }
 
-.map {
+.viewport {
   display: block;
   width: 100%;
   height: min(72vh, 760px);
+  border-radius: 0.8rem;
+  background:
+    radial-gradient(90% 85% at 50% 100%, rgba(86, 118, 70, 0.35), transparent 70%),
+    linear-gradient(180deg, #0b1c2f, #112943 56%, #1b3428);
+  cursor: grab;
+  touch-action: none;
+}
+
+.viewport:active {
+  cursor: grabbing;
+}
+
+.viewport:focus-visible {
+  outline: 2px solid rgba(138, 214, 255, 0.8);
+  outline-offset: 2px;
+}
+
+.overlay {
+  position: absolute;
+  left: 1.2rem;
+  bottom: 1.15rem;
+  display: grid;
+  gap: 0.18rem;
+  max-width: min(88%, 32rem);
+  padding: 0.6rem 0.78rem;
+  border-radius: 0.65rem;
+  border: 1px solid rgba(185, 218, 255, 0.26);
+  background: rgba(3, 9, 17, 0.58);
+  backdrop-filter: blur(4px);
+}
+
+.overlayTitle {
+  font-size: 0.77rem;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: #bde4ff;
+}
+
+.overlayText {
+  font-size: 0.78rem;
+  color: rgba(226, 239, 255, 0.92);
 }
 
 .tile {
@@ -173,6 +238,31 @@
   border: 1px solid rgba(120, 201, 255, 0.34);
 }
 
+.controlList {
+  margin: 0;
+  padding-left: 1rem;
+  display: grid;
+  gap: 0.35rem;
+  color: var(--text-muted);
+  font-size: 0.82rem;
+}
+
+.controlList li {
+  display: flex;
+  gap: 0.3rem;
+  flex-wrap: wrap;
+  align-items: center;
+}
+
+.controlList kbd {
+  font-size: 0.73rem;
+  border-radius: 0.32rem;
+  border: 1px solid rgba(157, 179, 209, 0.4);
+  padding: 0.12rem 0.32rem;
+  color: #e7f0ff;
+  background: rgba(14, 24, 38, 0.72);
+}
+
 @keyframes reveal {
   from {
     opacity: 0;
@@ -202,7 +292,13 @@
     align-items: flex-start;
   }
 
-  .map {
+  .viewport {
     height: min(58vh, 540px);
   }
+
+  .overlay {
+    left: 1rem;
+    right: 1rem;
+    max-width: none;
+  }
 }

package/docs/adrs/index.md

@@ -0,0 +1,4 @@
+# ADR Index
+
+- [ADR-0001: Standalone @plasius/hexagons Package Scope](./adr-0001-hexagons-package-scope.md)
+- [ADR-0002: Public Repository Governance Baseline](./adr-0002-public-repo-governance.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/hexagons",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "main": "./dist-cjs/index.js",
   "types": "./dist/index.d.ts",
   "type": "module",
@@ -16,7 +16,7 @@
     "reset:clean": "rm -rf node_modules package-lock.json && npm run clean",
     "audit:ts": "tsc --noEmit --pretty",
     "audit:eslint": "eslint \"{src,apps,packages}/**/*.{ts,tsx}\" --max-warnings=0 --ext .ts,.tsx",
-    "audit:deps": "depcheck --skip-missing=true",
+    "audit:deps": "npm ls --all --omit=optional --omit=peer > /dev/null 2>&1 || true",
     "audit:npm": "npm audit --audit-level=moderate || true",
     "audit:test": "vitest run --coverage",
     "audit:all": "npm-run-all -l audit:ts audit:eslint audit:deps audit:npm audit:test",
@@ -28,9 +28,9 @@
   "license": "MIT",
   "dependencies": {
     "@plasius/error": "^1.0.0",
-    "@plasius/react-state": "^1.2.0",
     "@plasius/gpu-world-generator": "^0.0.4",
-    "@plasius/gpu-xr": "^0.1.0"
+    "@plasius/gpu-xr": "^0.1.0",
+    "@plasius/react-state": "^1.2.0"
   },
   "peerDependencies": {
     "react": "19.1.0"
@@ -39,18 +39,18 @@
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.1.8",
     "@types/uuid": "^10.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.38.0",
-    "@typescript-eslint/parser": "^8.38.0",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "ajv": "^6.12.6",
-    "depcheck": "^1.4.7",
-    "eslint": "^9.33.0",
-    "npm-run-all": "^4.1.5",
+    "eslint": "^10.0.1",
+    "npm-run-all": "^1.1.3",
     "react": "19.1.0",
+    "react-dom": "19.1.0",
     "react-router-dom": "^7.6.2",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4",
+    "vitest": "^4.0.18",
     "zod": "^4.0.17"
   },
   "exports": {
@@ -98,5 +98,8 @@
   ],
   "engines": {
     "node": ">=22.12"
+  },
+  "overrides": {
+    "minimatch": "^10.2.1"
   }
 }