@jgengine/shell 0.6.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jgengine/shell",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Game player shell for JGengine: React Three Fiber canvas, orbit camera, input tracking, HUD mounting, GameUiPreview, and a demo game. Consumers supply a GameRegistry.",
   "license": "AGPL-3.0-only",
   "type": "module",
@@ -12,13 +12,18 @@
   },
   "files": [
     "dist",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "llms.txt"
   ],
   "exports": {
     "./weather": {
       "types": "./dist/weather/index.d.ts",
       "default": "./dist/weather/index.js"
     },
+    "./camera": {
+      "types": "./dist/camera/index.d.ts",
+      "default": "./dist/camera/index.js"
+    },
     "./*": {
       "types": "./dist/*.d.ts",
       "default": "./dist/*.js"
@@ -30,9 +35,9 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@jgengine/core": "^0.6.0",
-    "@jgengine/react": "^0.6.0",
-    "@jgengine/ws": "^0.6.0"
+    "@jgengine/core": "^0.8.0",
+    "@jgengine/react": "^0.8.0",
+    "@jgengine/ws": "^0.8.0"
   },
   "peerDependencies": {
     "@react-three/drei": "^10.0.0",

package/dist/demo/demoGame.d.ts

@@ -1,2 +0,0 @@
-import type { PlayableGame } from "../registry.js";
-export declare const demoGame: PlayableGame;

package/dist/demo/demoGame.js

@@ -1,208 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { defineGame } from "@jgengine/core/game/defineGame";
-import { createAssetCatalog } from "@jgengine/core/scene/assetCatalog";
-import { CurrencyPill, HealthBar, SlotGrid } from "@jgengine/react/components";
-import { useFeed, useGameClock, useGameStore, usePlayer, useTarget } from "@jgengine/react/hooks";
-const HERO = "hero";
-const MOB = "gloomSlime";
-const LOOT_TABLE = "slime-drops";
-const GOLD = "gold";
-const HOTBAR = "hotbar";
-const MELEE_DAMAGE = 6;
-const MELEE_RANGE = 1.9;
-const MELEE_COOLDOWN = 1.2;
-const AGGRO_RADIUS = 11;
-const MOB_SPAWNS = [
-    [7, 0, -6],
-    [-8, 0, 5],
-    [6, 0, 8],
-];
-const entityCatalog = {
-    [HERO]: {
-        stats: { health: { max: 100 }, mana: { max: 60 } },
-        receive: { damage: { order: ["health"] } },
-        movement: { poses: ["standing", "running", "crouch"], walkSpeed: 2.4 },
-    },
-    [MOB]: {
-        stats: { health: { max: 60 } },
-        receive: { damage: { order: ["health"] } },
-        onDeath: { drops: LOOT_TABLE },
-        role: "enemy",
-    },
-};
-const itemCatalog = {
-    sword: { use: "swingSword", weapon: { damage: 22 } },
-    zap: { use: "castZap", weapon: { damage: 35, manaCost: 12, range: 18 } },
-};
-const game = defineGame({
-    name: "gameplayer-demo",
-    assets: createAssetCatalog(),
-    multiplayer: null,
-    inventories: { [HOTBAR]: { slots: 4, hud: "hotbar" } },
-    time: { start: 8 * 3600, speeds: [1, 2, 3, 4] },
-    input: {
-        moveForward: ["KeyW"],
-        moveBack: ["KeyS"],
-        moveLeft: ["KeyA"],
-        moveRight: ["KeyD"],
-        jump: ["Space"],
-        sprint: ["Shift"],
-        turnLeft: ["KeyQ"],
-        turnRight: ["KeyE"],
-        tabTarget: ["Tab"],
-        clearTarget: ["Escape"],
-        slot1: ["Digit1"],
-        slot2: ["Digit2"],
-    },
-});
-let elapsed = 0;
-let nextSpawnIndex = 0;
-const meleeReadyAt = new Map();
-function spawnMob(ctx) {
-    const at = MOB_SPAWNS[nextSpawnIndex % MOB_SPAWNS.length];
-    nextSpawnIndex += 1;
-    ctx.scene.entity.spawn(MOB, { position: at, role: "npc" });
-}
-function spawnHero(ctx) {
-    ctx.scene.entity.spawn(HERO, {
-        id: ctx.player.userId,
-        position: [0, 0, 0],
-        role: "player",
-    });
-}
-function onInit(ctx) {
-    elapsed = 0;
-    nextSpawnIndex = 0;
-    meleeReadyAt.clear();
-    ctx.game.loot.register({ id: LOOT_TABLE, entries: [{ currency: GOLD, count: [2, 5], weight: 1 }] });
-    ctx.game.feed.bind("entity.died");
-    ctx.game.events.on("entity.died", (event) => {
-        if (event.catalogId === MOB) {
-            meleeReadyAt.delete(event.instanceId);
-            spawnMob(ctx);
-        }
-    });
-    ctx.item.use.register({
-        swingSword: {
-            apply(state, input) {
-                const hits = state.scene.entity
-                    .queryArc({ from: input.from, aim: input.aim ?? { yaw: 0, pitch: 0 }, radius: 3.2, halfAngleDeg: 70 })
-                    .filter((id) => state.scene.entity.get(id)?.name === MOB);
-                for (const id of hits) {
-                    state.scene.entity.effect({ from: input.from, to: id, effect: "damage", via: { item: input.itemId } });
-                }
-                return { state };
-            },
-        },
-        castZap: {
-            can(state, input) {
-                const targetId = state.scene.entity.getTarget(input.from);
-                if (targetId === null)
-                    return { reason: "no-target" };
-                const range = state.item.weapon.getStat(input.itemId, "range") ?? Number.POSITIVE_INFINITY;
-                const distance = state.scene.entity.distance(input.from, targetId);
-                if (distance === null || distance > range)
-                    return { reason: "out-of-range" };
-                const cost = state.item.weapon.getStat(input.itemId, "manaCost") ?? 0;
-                const mana = state.scene.entity.stats.get(input.from, "mana");
-                if (mana === null || mana.current < cost)
-                    return { reason: "no-mana" };
-                return null;
-            },
-            apply(state, input) {
-                const targetId = state.scene.entity.getTarget(input.from);
-                if (targetId === null)
-                    return { state, error: "no-target" };
-                const cost = state.item.weapon.getStat(input.itemId, "manaCost") ?? 0;
-                state.scene.entity.stats.delta(input.from, "mana", -cost);
-                state.scene.entity.effect({ from: input.from, to: targetId, effect: "damage", via: { item: input.itemId } });
-                return { state };
-            },
-        },
-    });
-}
-function onNewPlayer(ctx) {
-    spawnHero(ctx);
-    ctx.player.inventory.put(HOTBAR, "sword", 1);
-    ctx.player.inventory.put(HOTBAR, "zap", 1);
-    ctx.game.economy.grant(ctx.player.userId, GOLD, 10);
-    for (let index = 0; index < MOB_SPAWNS.length; index += 1)
-        spawnMob(ctx);
-}
-function onTick(ctx, dt) {
-    elapsed += dt;
-    const playerId = ctx.player.userId;
-    const player = ctx.scene.entity.get(playerId);
-    if (player === null) {
-        spawnHero(ctx);
-        return;
-    }
-    const mana = ctx.scene.entity.stats.get(playerId, "mana");
-    if (mana !== null && mana.current < mana.max)
-        ctx.scene.entity.stats.delta(playerId, "mana", 5 * dt);
-    for (const mob of ctx.scene.entity.list()) {
-        if (mob.name !== MOB)
-            continue;
-        const distance = ctx.scene.entity.distance(mob.id, playerId);
-        if (distance === null || distance > AGGRO_RADIUS)
-            continue;
-        if (distance > MELEE_RANGE) {
-            const next = ctx.scene.entity.moveToward(mob.id, playerId, {
-                speed: 2,
-                stopDistance: MELEE_RANGE * 0.8,
-                dt,
-            });
-            if (next !== null) {
-                ctx.scene.entity.setPose(mob.id, {
-                    position: next,
-                    rotationY: Math.atan2(player.position[0] - next[0], player.position[2] - next[2]),
-                });
-            }
-        }
-        else if ((meleeReadyAt.get(mob.id) ?? 0) <= elapsed) {
-            meleeReadyAt.set(mob.id, elapsed + MELEE_COOLDOWN);
-            ctx.scene.entity.effect({ from: mob.id, to: playerId, effect: "damage", via: { amount: MELEE_DAMAGE } });
-        }
-    }
-}
-function VitalsPanel({ userId }) {
-    return (_jsxs("div", { className: "rounded bg-black/60 p-2", children: [_jsx(HealthBar, { instanceId: userId, statId: "health", className: "h-2.5 overflow-hidden rounded bg-white/15", fillClassName: "bg-emerald-400" }), _jsx(HealthBar, { instanceId: userId, statId: "mana", className: "mt-1 h-1.5 overflow-hidden rounded bg-white/15", fillClassName: "bg-sky-400" })] }));
-}
-function TargetPanel({ userId }) {
-    const targetId = useTarget(userId);
-    const targetName = useGameStore((ctx) => targetId === null ? null : (ctx.scene.entity.get(targetId)?.name ?? null));
-    if (targetId === null || targetName === null) {
-        return _jsx("p", { className: "rounded bg-black/50 px-2 py-1 text-center text-xs text-white/50", children: "Tab: target a mob" });
-    }
-    return (_jsxs("div", { className: "rounded bg-black/60 p-2", children: [_jsx("p", { className: "text-xs uppercase tracking-wide text-red-300", children: targetName }), _jsx(HealthBar, { instanceId: targetId, statId: "health", className: "mt-1 h-2 overflow-hidden rounded bg-white/15", fillClassName: "bg-red-400" })] }));
-}
-function KillFeedPanel() {
-    const kills = useFeed({ action: "entity.died", limit: 5 });
-    return (_jsx("ul", { className: "space-y-0.5 text-right text-xs text-white/70", children: kills
-            .slice()
-            .reverse()
-            .map((entry, index) => (_jsxs("li", { children: [entry.data.catalogId ?? "?", " down"] }, `${entry.at}-${index}`))) }));
-}
-function HotbarPanel() {
-    return (_jsx(SlotGrid, { inventoryId: HOTBAR, className: "flex gap-1.5", renderSlot: (slot, index) => (_jsxs("div", { className: "w-16 rounded border border-white/20 bg-black/60 px-1.5 py-1 text-center text-[11px]", children: [_jsx("span", { className: "text-white/50", children: index + 1 }), _jsx("p", { className: "truncate text-white", children: slot === null ? "—" : slot.itemId })] })) }));
-}
-function ClockPanel() {
-    const { paused, playSpeed, speeds, calendar, controls } = useGameClock();
-    const pad = (value) => value.toString().padStart(2, "0");
-    return (_jsxs("div", { className: "pointer-events-auto flex items-center gap-2 rounded bg-black/60 px-2 py-1 text-xs", children: [_jsxs("span", { className: "tabular-nums text-white", children: ["Day ", calendar.day + 1, " \u00B7 ", pad(calendar.hour), ":", pad(calendar.minute)] }), _jsx("button", { onClick: () => controls.toggle(), className: "rounded border border-white/25 px-1.5 py-0.5 text-white/80 hover:bg-white/10", children: paused ? "▶" : "⏸" }), _jsx("div", { className: "flex gap-0.5", children: speeds.map((speed) => (_jsxs("button", { onClick: () => controls.setSpeed(speed), className: `rounded border px-1.5 py-0.5 ${!paused && speed === playSpeed
-                        ? "border-amber-300 bg-amber-300/20 text-amber-200"
-                        : "border-white/25 text-white/70 hover:bg-white/10"}`, children: [speed, "\u00D7"] }, speed))) })] }));
-}
-function DemoGameUI() {
-    const player = usePlayer();
-    return (_jsxs("div", { className: "pointer-events-none absolute inset-0 font-mono text-white", children: [_jsx("div", { className: "absolute left-4 top-4", children: _jsx(ClockPanel, {}) }), _jsx("div", { className: "absolute left-1/2 top-4 w-56 -translate-x-1/2", children: _jsx(TargetPanel, { userId: player.userId }) }), _jsxs("div", { className: "absolute right-4 top-4 flex flex-col items-end gap-2", children: [_jsx(CurrencyPill, { currencyId: GOLD, className: "rounded bg-black/60 px-2 py-1 text-sm text-amber-300" }), _jsx(KillFeedPanel, {})] }), _jsx("div", { className: "absolute bottom-4 left-4 w-64", children: _jsx(VitalsPanel, { userId: player.userId }) }), _jsx("div", { className: "absolute bottom-4 left-1/2 -translate-x-1/2", children: _jsx(HotbarPanel, {}) }), _jsx("div", { className: "absolute bottom-4 right-4 max-w-[220px] text-right text-[11px] leading-4 text-white/40", children: "WASD move \u00B7 Space jump \u00B7 Shift sprint \u00B7 Q/E turn \u00B7 Tab target \u00B7 Esc clear \u00B7 1 sword \u00B7 2 zap" })] }));
-}
-export const demoGame = {
-    game,
-    content: {
-        itemById: (itemId) => itemCatalog[itemId] ?? null,
-        entityById: (catalogId) => entityCatalog[catalogId] ?? null,
-    },
-    loop: { onInit, onNewPlayer, onTick },
-    GameUI: DemoGameUI,
-};

package/dist/demo/environmentShowcase.d.ts

@@ -1,2 +0,0 @@
-import type { PlayableGame } from "../registry.js";
-export declare const environmentShowcaseGame: PlayableGame;

package/dist/demo/environmentShowcase.js

@@ -1,15 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { building, environment, grass, ocean, rain, terrain, } from "@jgengine/core/world/features";
-import { EnvironmentScene } from "../environment/EnvironmentScene.js";
-import { demoGame } from "./demoGame.js";
-const showcase = environment({
-    terrain: terrain({ bounds: { w: 220, d: 220 }, height: 4, frequency: 0.035, seed: "showcase", waterLevel: -1 }),
-    vegetation: grass({ area: { w: 120, d: 120 }, density: 5, colors: ["#31531f", "#8fbf4a"], seed: "showcase" }),
-    water: ocean({ bounds: { w: 520, d: 520 }, level: -1.4, waveHeight: 0.9, waveSpeed: 0.5, color: "#1f6f92" }),
-    weather: rain({ area: { w: 160, d: 160, h: 70 }, density: 0.5, wind: [1.4, 0.4] }),
-    structures: building({ count: 6, footprint: { w: 12, d: 9 }, stories: [3, 7], storyHeight: 2.8, spacing: 6, seed: "showcase" }),
-});
-export const environmentShowcaseGame = {
-    ...demoGame,
-    environment: () => _jsx(EnvironmentScene, { feature: showcase }),
-};