@progamestore/games 0.2.0

package/dist/Leaderboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Leaderboard.d.ts","sourceRoot":"","sources":["../src/Leaderboard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,YAAY,EACZ,OAAO,GACR,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2DtC"}

package/dist/Leaderboard.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+export function Leaderboard({ topScores, recentScores, loading, }) {
+    const [tab, setTab] = useState('top');
+    const scores = tab === 'top' ? topScores : recentScores;
+    if (loading) {
+        return (_jsx("div", { className: "px-4 py-3 text-xs", style: { color: 'var(--muted)' }, children: "Loading scores..." }));
+    }
+    return (_jsxs("div", { className: "flex flex-col gap-2 px-4 py-3", children: [_jsx("div", { className: "flex gap-1", children: ['top', 'recent'].map((t) => (_jsx("button", { onClick: () => setTab(t), className: "px-3 py-1 text-xs font-semibold rounded-lg", style: {
+                        background: tab === t ? 'var(--accent)' : 'transparent',
+                        color: tab === t ? '#fff' : 'var(--muted)',
+                    }, children: t === 'top' ? 'Top' : 'Recent' }, t))) }), scores.length === 0 ? (_jsx("div", { className: "text-xs", style: { color: 'var(--muted)' }, children: "No scores yet. Be the first!" })) : (_jsx("div", { className: "flex flex-col gap-1", children: scores.map((entry, i) => (_jsxs("div", { className: "flex items-center justify-between text-xs py-1", style: { borderBottom: '1px solid var(--line)' }, children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "w-5 text-right font-semibold", style: { color: i < 3 ? 'var(--accent)' : 'var(--muted)' }, children: i + 1 }), _jsx("span", { className: "truncate max-w-[8rem]", children: entry.player_name })] }), _jsx("span", { className: "font-bold", style: { fontFamily: 'Fraunces, serif' }, children: entry.score.toLocaleString() })] }, `${entry.player_name}-${entry.score}-${i}`))) }))] }));
+}
+//# sourceMappingURL=Leaderboard.js.map

package/dist/Leaderboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Leaderboard.js","sourceRoot":"","sources":["../src/Leaderboard.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AASjC,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,YAAY,EACZ,OAAO,GACU;IACjB,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAmB,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAExD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CACL,cAAK,SAAS,EAAC,mBAAmB,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,kCAE7D,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,eAAK,SAAS,EAAC,+BAA+B,aAC5C,cAAK,SAAS,EAAC,YAAY,YACvB,CAAC,KAAK,EAAE,QAAQ,CAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACvC,iBAEE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,SAAS,EAAC,4CAA4C,EACtD,KAAK,EAAE;wBACL,UAAU,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa;wBACvD,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc;qBAC3C,YAEA,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAR1B,CAAC,CASC,CACV,CAAC,GACE,EACL,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACrB,cAAK,SAAS,EAAC,SAAS,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,6CAEnD,CACP,CAAC,CAAC,CAAC,CACF,cAAK,SAAS,EAAC,qBAAqB,YACjC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CACxB,eAEE,SAAS,EAAC,gDAAgD,EAC1D,KAAK,EAAE,EAAE,YAAY,EAAE,uBAAuB,EAAE,aAEhD,eAAK,SAAS,EAAC,yBAAyB,aACtC,eACE,SAAS,EAAC,8BAA8B,EACxC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,EAAE,YAEzD,CAAC,GAAG,CAAC,GACD,EACP,eAAM,SAAS,EAAC,uBAAuB,YAAE,KAAK,CAAC,WAAW,GAAQ,IAC9D,EACN,eAAM,SAAS,EAAC,WAAW,EAAC,KAAK,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,YACjE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,GACxB,KAfF,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAgB3C,CACP,CAAC,GACE,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/SoundContext.d.ts

@@ -0,0 +1,16 @@
+import type * as React from 'react';
+import type { ReactNode } from 'react';
+interface SoundState {
+    muted: boolean;
+    toggle: () => void;
+}
+export declare function SoundProvider({ children }: {
+    children: ReactNode;
+}): React.JSX.Element;
+/**
+ * Read the platform sound state. Muted by default.
+ * Games MUST check `muted` before playing any audio.
+ */
+export declare function useSound(): SoundState;
+export {};
+//# sourceMappingURL=SoundContext.d.ts.map

package/dist/SoundContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoundContext.d.ts","sourceRoot":"","sources":["../src/SoundContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,UAAU,UAAU;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAID,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAItF;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,UAAU,CAErC"}

package/dist/SoundContext.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useState } from 'react';
+const SoundContext = createContext({ muted: true, toggle: () => { } });
+export function SoundProvider({ children }) {
+    const [muted, setMuted] = useState(true);
+    const toggle = useCallback(() => setMuted((m) => !m), []);
+    return _jsx(SoundContext.Provider, { value: { muted, toggle }, children: children });
+}
+/**
+ * Read the platform sound state. Muted by default.
+ * Games MUST check `muted` before playing any audio.
+ */
+export function useSound() {
+    return useContext(SoundContext);
+}
+//# sourceMappingURL=SoundContext.js.map

package/dist/SoundContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoundContext.js","sourceRoot":"","sources":["../src/SoundContext.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAOzE,MAAM,YAAY,GAAG,aAAa,CAAa,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AAElF,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAA2B;IACjE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAG,QAAQ,GAAyB,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @freeappstore/games — shared React UI primitives for ProGameStore games.
+ *
+ * Why this exists:
+ * - Games on the platform must be **brand-consistent** (no per-game custom
+ *   topbars). The compliance suite enforces brand fonts and CSS tokens; the
+ *   topbar is the next leak.
+ * - Games must **fit the viewport** (no scrolling). GameShell hard-locks
+ *   layout to 100svh and prevents overflow on the wrapper, so a game can't
+ *   accidentally introduce vertical / horizontal scroll.
+ *
+ * What you get:
+ *   <GameShell topbar={<GameTopbar score={42} />}>{your game}</GameShell>
+ */
+export { GameAuth } from './GameAuth.js';
+export { GameButton, type GameButtonProps, type GameButtonSize, type GameButtonVariant, } from './GameButton.js';
+export { GameShell, type GameShellProps } from './GameShell.js';
+export { GameTopbar, type GameTopbarProps, type GameTopbarStat, } from './GameTopbar.js';
+export { Leaderboard, type LeaderboardProps } from './Leaderboard.js';
+export { useSound } from './SoundContext.js';
+export { type User, useAuth } from './useAuth.js';
+export { useGameSounds } from './useGameSounds.js';
+export { type LeaderboardEntry, useLeaderboard, } from './useLeaderboard.js';
+export { type RoomMessage, type RoomStatus, type UseRoomsOptions, type UseRoomsResult, useRooms, } from './useRooms.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,KAAK,gBAAgB,EACrB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,QAAQ,GACT,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * @freeappstore/games — shared React UI primitives for ProGameStore games.
+ *
+ * Why this exists:
+ * - Games on the platform must be **brand-consistent** (no per-game custom
+ *   topbars). The compliance suite enforces brand fonts and CSS tokens; the
+ *   topbar is the next leak.
+ * - Games must **fit the viewport** (no scrolling). GameShell hard-locks
+ *   layout to 100svh and prevents overflow on the wrapper, so a game can't
+ *   accidentally introduce vertical / horizontal scroll.
+ *
+ * What you get:
+ *   <GameShell topbar={<GameTopbar score={42} />}>{your game}</GameShell>
+ */
+export { GameAuth } from './GameAuth.js';
+export { GameButton, } from './GameButton.js';
+export { GameShell } from './GameShell.js';
+export { GameTopbar, } from './GameTopbar.js';
+export { Leaderboard } from './Leaderboard.js';
+export { useSound } from './SoundContext.js';
+export { useAuth } from './useAuth.js';
+export { useGameSounds } from './useGameSounds.js';
+export { useLeaderboard, } from './useLeaderboard.js';
+export { useRooms, } from './useRooms.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,GAIX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,UAAU,GAGX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAa,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAEL,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,QAAQ,GACT,MAAM,eAAe,CAAC"}

package/dist/useAuth.d.ts

@@ -0,0 +1,12 @@
+export interface User {
+    id: string;
+    name: string;
+    avatar: string;
+}
+export declare function useAuth(): {
+    user: User | null;
+    loading: boolean;
+    signIn: () => void;
+    signOut: () => void;
+};
+//# sourceMappingURL=useAuth.d.ts.map

package/dist/useAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../src/useAuth.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,OAAO,IAAI;IACzB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CA4CA"}

package/dist/useAuth.js

@@ -0,0 +1,46 @@
+import { useCallback, useEffect, useState } from 'react';
+export function useAuth() {
+    const [user, setUser] = useState(null);
+    const [loading, setLoading] = useState(true);
+    useEffect(() => {
+        let cancelled = false;
+        fetch('https://auth.progamestore.online/me', { credentials: 'include' })
+            .then((res) => {
+            if (!cancelled && res.ok)
+                return res.json();
+            return null;
+        })
+            .then((data) => {
+            if (!cancelled)
+                setUser(data);
+        })
+            .catch(() => {
+            // 401 or network error — user is not signed in
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, []);
+    const signIn = useCallback(() => {
+        window.location.href = `https://auth.progamestore.online/login?redirect=${encodeURIComponent(window.location.href)}`;
+    }, []);
+    const signOut = useCallback(() => {
+        fetch('https://auth.progamestore.online/logout', {
+            method: 'POST',
+            credentials: 'include',
+        })
+            .catch(() => {
+            // best-effort
+        })
+            .finally(() => {
+            setUser(null);
+            window.location.reload();
+        });
+    }, []);
+    return { user, loading, signIn, signOut };
+}
+//# sourceMappingURL=useAuth.js.map

package/dist/useAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.js","sourceRoot":"","sources":["../src/useAuth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAQzD,MAAM,UAAU,OAAO;IAMrB,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAc,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE7C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,CAAC,qCAAqC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;aACrE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,EAAE;gBAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,IAAiB,EAAE,EAAE;YAC1B,IAAI,CAAC,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,+CAA+C;QACjD,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,SAAS;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,mDAAmD,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACvH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,KAAK,CAAC,yCAAyC,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,SAAS;SACvB,CAAC;aACC,KAAK,CAAC,GAAG,EAAE;YACV,cAAc;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC"}

package/dist/useGameSounds.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Synthesized game sound effects via Web Audio API.
+ * Zero audio files — works offline, no downloads.
+ * All sounds respect the SDK mute toggle automatically.
+ */
+export declare function useGameSounds(): {
+    playMove: () => void;
+    playScore: () => void;
+    playError: () => void;
+    playGameOver: () => void;
+    playLevelUp: () => void;
+    playDrop: () => void;
+    playClear: () => void;
+    playTick: () => void;
+};
+//# sourceMappingURL=useGameSounds.d.ts.map

package/dist/useGameSounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameSounds.d.ts","sourceRoot":"","sources":["../src/useGameSounds.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,aAAa;;;;;;;;;EA+F5B"}

package/dist/useGameSounds.js

@@ -0,0 +1,93 @@
+import { useCallback, useRef } from 'react';
+import { useSound } from './SoundContext.js';
+/**
+ * Synthesized game sound effects via Web Audio API.
+ * Zero audio files — works offline, no downloads.
+ * All sounds respect the SDK mute toggle automatically.
+ */
+export function useGameSounds() {
+    const { muted } = useSound();
+    const ctxRef = useRef(null);
+    const getCtx = useCallback(() => {
+        if (muted)
+            return null;
+        if (!ctxRef.current) {
+            try {
+                ctxRef.current = new AudioContext();
+            }
+            catch {
+                return null;
+            }
+        }
+        if (ctxRef.current.state === 'suspended') {
+            ctxRef.current.resume();
+        }
+        return ctxRef.current;
+    }, [muted]);
+    const tone = useCallback((freq, duration, type = 'sine', volume = 0.15) => {
+        const ctx = getCtx();
+        if (!ctx)
+            return;
+        const osc = ctx.createOscillator();
+        const gain = ctx.createGain();
+        osc.type = type;
+        osc.frequency.value = freq;
+        gain.gain.setValueAtTime(volume, ctx.currentTime);
+        gain.gain.exponentialRampToValueAtTime(0.001, ctx.currentTime + duration);
+        osc.connect(gain);
+        gain.connect(ctx.destination);
+        osc.start(ctx.currentTime);
+        osc.stop(ctx.currentTime + duration);
+    }, [getCtx]);
+    /** Short click/tap — piece moved, card flipped, button pressed */
+    const playMove = useCallback(() => {
+        tone(600, 0.06, 'square', 0.08);
+    }, [tone]);
+    /** Positive ding — scored a point, matched, correct answer */
+    const playScore = useCallback(() => {
+        tone(880, 0.12, 'sine', 0.15);
+        setTimeout(() => tone(1100, 0.15, 'sine', 0.12), 60);
+    }, [tone]);
+    /** Negative buzz — wrong answer, hit obstacle, lost life */
+    const playError = useCallback(() => {
+        tone(200, 0.2, 'sawtooth', 0.1);
+    }, [tone]);
+    /** Game over — descending tones */
+    const playGameOver = useCallback(() => {
+        tone(440, 0.15, 'sine', 0.12);
+        setTimeout(() => tone(350, 0.15, 'sine', 0.1), 100);
+        setTimeout(() => tone(260, 0.3, 'sine', 0.08), 200);
+    }, [tone]);
+    /** Level up / achievement — ascending arpeggio */
+    const playLevelUp = useCallback(() => {
+        tone(523, 0.1, 'sine', 0.12);
+        setTimeout(() => tone(659, 0.1, 'sine', 0.12), 80);
+        setTimeout(() => tone(784, 0.1, 'sine', 0.12), 160);
+        setTimeout(() => tone(1047, 0.2, 'sine', 0.15), 240);
+    }, [tone]);
+    /** Hard drop / thud — Tetris block landing, bowling throw */
+    const playDrop = useCallback(() => {
+        tone(150, 0.12, 'triangle', 0.2);
+    }, [tone]);
+    /** Line clear / combo — satisfying sweep */
+    const playClear = useCallback(() => {
+        tone(700, 0.08, 'sine', 0.1);
+        setTimeout(() => tone(900, 0.08, 'sine', 0.1), 50);
+        setTimeout(() => tone(1200, 0.12, 'sine', 0.12), 100);
+    }, [tone]);
+    /** Countdown tick — timer warning */
+    const playTick = useCallback(() => {
+        tone(1000, 0.03, 'square', 0.06);
+    }, [tone]);
+    return {
+        playMove,
+        playScore,
+        playError,
+        playGameOver,
+        playLevelUp,
+        playDrop,
+        playClear,
+        playTick,
+    };
+}
+//# sourceMappingURL=useGameSounds.js.map

package/dist/useGameSounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameSounds.js","sourceRoot":"","sources":["../src/useGameSounds.ts"],"names":[],"mappings":"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"}

package/dist/useLeaderboard.d.ts

@@ -0,0 +1,18 @@
+export interface LeaderboardEntry {
+    player_name: string;
+    score: number;
+    user_id?: string;
+    avatar_url?: string;
+    created_at: string;
+}
+export declare function useLeaderboard(gameId: string): {
+    topScores: LeaderboardEntry[];
+    recentScores: LeaderboardEntry[];
+    submitScore: (score: number) => Promise<{
+        ok: boolean;
+        rank?: number;
+    }>;
+    loading: boolean;
+    refresh: () => void;
+};
+//# sourceMappingURL=useLeaderboard.d.ts.map

package/dist/useLeaderboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLeaderboard.d.ts","sourceRoot":"","sources":["../src/useLeaderboard.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAC9C,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAiDA"}

package/dist/useLeaderboard.js

@@ -0,0 +1,49 @@
+import { useCallback, useEffect, useState } from 'react';
+const API_BASE = 'https://progamestore-leaderboard.serge-the-dev.workers.dev';
+export function useLeaderboard(gameId) {
+    const [topScores, setTopScores] = useState([]);
+    const [recentScores, setRecentScores] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const load = useCallback(() => {
+        setLoading(true);
+        Promise.all([
+            fetch(`${API_BASE}/scores/${gameId}?sort=top`, { credentials: 'include' })
+                .then((r) => (r.ok ? r.json() : []))
+                .catch(() => []),
+            fetch(`${API_BASE}/scores/${gameId}?sort=recent`, { credentials: 'include' })
+                .then((r) => (r.ok ? r.json() : []))
+                .catch(() => []),
+        ]).then(([top, recent]) => {
+            setTopScores(top);
+            setRecentScores(recent);
+            setLoading(false);
+        });
+    }, [gameId]);
+    useEffect(() => {
+        load();
+    }, [load]);
+    const submitScore = useCallback(async (score) => {
+        try {
+            const res = await fetch(`${API_BASE}/scores/${gameId}`, {
+                method: 'POST',
+                credentials: 'include',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ score }),
+            });
+            if (!res.ok)
+                return { ok: false };
+            const data = (await res.json());
+            // Refresh scores after submission
+            load();
+            const result = { ok: true };
+            if (data.rank !== undefined)
+                result.rank = data.rank;
+            return result;
+        }
+        catch {
+            return { ok: false };
+        }
+    }, [gameId, load]);
+    return { topScores, recentScores, submitScore, loading, refresh: load };
+}
+//# sourceMappingURL=useLeaderboard.js.map

package/dist/useLeaderboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLeaderboard.js","sourceRoot":"","sources":["../src/useLeaderboard.ts"],"names":[],"mappings":"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"}

package/dist/useRooms.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The shape of a message handled by a room. Games narrow this with their
+ * own message types via the generic parameter:
+ *
+ *   type ChessMsg = { type: 'move'; uci: string } | { type: 'state'; fen: string };
+ *   const room = useRooms<ChessMsg>({ ... });
+ *
+ * The only contract is `type: string` — payload fields are entirely up to
+ * the game. Discriminated unions across `type` are the recommended shape.
+ */
+export type RoomMessage = {
+    type: string;
+};
+export type RoomStatus = 'idle' | 'connecting' | 'connected' | 'closed' | 'error';
+export interface UseRoomsOptions<TServer extends RoomMessage> {
+    /**
+     * A namespace identifying the game. Today this is mostly a label for
+     * the URL; the multiplayer Worker is per-game so a single Worker only
+     * serves one `gameId`. Reserved as a hook input so games written
+     * against this API don't break if the platform ever moves to a shared
+     * rooms Worker that namespaces by game.
+     */
+    gameId: string;
+    /**
+     * The room to connect to. `null` keeps the hook idle — useful before
+     * the user has either created a new room or joined an existing one.
+     */
+    roomId: string | null;
+    /**
+     * Base URL of the multiplayer Worker. Defaults to same-origin, which
+     * is the layout the templates ship: one Worker serves the static SPA
+     * AND owns the WebSocket route. Override only if you split the two.
+     */
+    baseUrl?: string;
+    /**
+     * Called for every JSON-parsed message received from the room.
+     * Use the `TServer` type parameter to narrow.
+     */
+    onMessage?: (msg: TServer) => void;
+    /**
+     * Called on transitions of the connection status. Useful for UI
+     * (showing a "reconnecting…" badge, disabling Send while not
+     * connected, etc.).
+     */
+    onStatusChange?: (status: RoomStatus) => void;
+}
+export interface UseRoomsResult<TClient extends RoomMessage> {
+    /** Current connection status. */
+    status: RoomStatus;
+    /**
+     * Send a message to the room. JSON-encoded and pushed to the server.
+     * Messages sent while the socket isn't open are dropped — the hook
+     * does not queue. Most game protocols are stateful enough that
+     * silent retries on a stale connection cause more bugs than they fix.
+     */
+    send: (msg: TClient) => void;
+    /**
+     * POST `/api/rooms/new` against the Worker and return the new room id.
+     * Throws on non-2xx. The hook does not auto-connect to the returned
+     * id — call sites should navigate / set state and let the hook
+     * pick up the new `roomId` prop.
+     */
+    create: () => Promise<string>;
+}
+/**
+ * Connect to a server-authoritative multiplayer room.
+ *
+ * The platform's multiplayer model is "WebSocket to a Durable Object owned
+ * by the game's own Worker". This hook handles the connection lifecycle
+ * (open / message / close) and the `POST /api/rooms/new` call to mint
+ * room ids. Per-game protocol — what messages mean, what state looks like,
+ * how moves get validated — lives in the game's Worker code, not here.
+ *
+ * Why this is a Pro-only API: the Worker + DO + per-GB-second billing
+ * pricing model means hosting rooms isn't free for the platform.
+ */
+export declare function useRooms<TServer extends RoomMessage = RoomMessage, TClient extends RoomMessage = RoomMessage>(opts: UseRoomsOptions<TServer>): UseRoomsResult<TClient>;
+//# sourceMappingURL=useRooms.d.ts.map

package/dist/useRooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRooms.d.ts","sourceRoot":"","sources":["../src/useRooms.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,WAAW;IAC1D;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAEnC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,WAAW;IACzD,iCAAiC;IACjC,MAAM,EAAE,UAAU,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAE7B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,OAAO,SAAS,WAAW,GAAG,WAAW,EACzC,OAAO,SAAS,WAAW,GAAG,WAAW,EACzC,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CA+FzD"}

package/dist/useRooms.js

@@ -0,0 +1,104 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+/**
+ * Connect to a server-authoritative multiplayer room.
+ *
+ * The platform's multiplayer model is "WebSocket to a Durable Object owned
+ * by the game's own Worker". This hook handles the connection lifecycle
+ * (open / message / close) and the `POST /api/rooms/new` call to mint
+ * room ids. Per-game protocol — what messages mean, what state looks like,
+ * how moves get validated — lives in the game's Worker code, not here.
+ *
+ * Why this is a Pro-only API: the Worker + DO + per-GB-second billing
+ * pricing model means hosting rooms isn't free for the platform.
+ */
+export function useRooms(opts) {
+    const { gameId, roomId, baseUrl, onMessage, onStatusChange } = opts;
+    const [status, setStatus] = useState('idle');
+    const wsRef = useRef(null);
+    // Refs so the connect-effect doesn't re-fire when these change.
+    const onMessageRef = useRef(onMessage);
+    const onStatusChangeRef = useRef(onStatusChange);
+    onMessageRef.current = onMessage;
+    onStatusChangeRef.current = onStatusChange;
+    const setStatusAndNotify = useCallback((s) => {
+        setStatus(s);
+        onStatusChangeRef.current?.(s);
+    }, []);
+    // (Re)connect when roomId changes.
+    useEffect(() => {
+        if (roomId === null) {
+            setStatusAndNotify('idle');
+            return;
+        }
+        setStatusAndNotify('connecting');
+        // Build wss:// URL from the page's origin (or the override baseUrl).
+        const base = baseUrl ?? (typeof window !== 'undefined' ? window.location.origin : '');
+        const wsUrl = base.replace(/^http/, 'ws').replace(/\/$/, '') +
+            `/api/rooms/${encodeURIComponent(roomId)}/ws`;
+        const ws = new WebSocket(wsUrl);
+        wsRef.current = ws;
+        let closedCleanly = false;
+        ws.addEventListener('open', () => {
+            setStatusAndNotify('connected');
+        });
+        ws.addEventListener('message', (e) => {
+            let parsed;
+            try {
+                parsed = JSON.parse(e.data);
+            }
+            catch {
+                // Non-JSON message — ignore. The protocol contract is JSON.
+                return;
+            }
+            onMessageRef.current?.(parsed);
+        });
+        ws.addEventListener('close', () => {
+            if (!closedCleanly)
+                setStatusAndNotify('closed');
+        });
+        ws.addEventListener('error', () => {
+            setStatusAndNotify('error');
+        });
+        return () => {
+            closedCleanly = true;
+            wsRef.current = null;
+            // 1000 = normal closure. No reconnect — the next mount or roomId
+            // change will create a fresh socket.
+            try {
+                ws.close(1000);
+            }
+            catch {
+                // Worth a console hint? No — socket may already be closed.
+            }
+        };
+        // gameId is intentionally not in deps — the URL doesn't reference
+        // it today (per-game Worker = the gameId is implicit in the
+        // baseUrl). If/when the platform switches to a shared rooms Worker
+        // that namespaces by gameId in the path, add gameId to deps then.
+    }, [roomId, baseUrl, setStatusAndNotify]);
+    const send = useCallback((msg) => {
+        const ws = wsRef.current;
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        ws.send(JSON.stringify(msg));
+    }, []);
+    const create = useCallback(async () => {
+        const base = baseUrl ?? (typeof window !== 'undefined' ? window.location.origin : '');
+        const res = await fetch(`${base.replace(/\/$/, '')}/api/rooms/new`, {
+            method: 'POST',
+        });
+        if (!res.ok) {
+            throw new Error(`POST /api/rooms/new → ${res.status}`);
+        }
+        const data = (await res.json());
+        // Tolerate either { roomId } or { id } from the Worker — the docs
+        // settle on `roomId`, but some early templates returned `id`.
+        const id = data.roomId ?? data.id;
+        if (!id || typeof id !== 'string') {
+            throw new Error('Worker returned no roomId');
+        }
+        return id;
+    }, [baseUrl]);
+    return { status, send, create };
+}
+//# sourceMappingURL=useRooms.js.map

package/dist/useRooms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRooms.js","sourceRoot":"","sources":["../src/useRooms.ts"],"names":[],"mappings":"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"}