digital-boardgame-framework 0.4.0 → 0.5.0

package/dist/client/index.d.ts

@@ -1,3 +1,7 @@
 export { useGame } from './use-game.js';
 export type { UseGameOpts, UseGameResult, GameClientApi } from './use-game.js';
+export { useVersionCheck } from './use-version-check.js';
+export type { UseVersionCheckOpts, UseVersionCheckResult } from './use-version-check.js';
+export { UpdateBanner } from './update-banner.js';
+export type { UpdateBannerProps } from './update-banner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/client/index.js

@@ -1,2 +1,4 @@
 export { useGame } from './use-game.js';
+export { useVersionCheck } from './use-version-check.js';
+export { UpdateBanner } from './update-banner.js';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/client/update-banner.d.ts

@@ -0,0 +1,20 @@
+import type { CSSProperties } from 'react';
+import { type UseVersionCheckOpts } from './use-version-check.js';
+/**
+ * Drop-in "a new version is available — Reload" banner. Renders nothing until a
+ * newer build is deployed, then shows a dismissible bar. Built on
+ * `useVersionCheck`; pass the same options. Restyle via `className`/`style`, or
+ * skip this component entirely and build your own UI on the hook.
+ *
+ *   <UpdateBanner currentBuild={__DBF_BUILD_ID__} />
+ */
+export interface UpdateBannerProps extends UseVersionCheckOpts {
+    message?: string;
+    reloadLabel?: string;
+    /** Hide the default styling (so `className` fully controls appearance). */
+    unstyled?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function UpdateBanner({ message, reloadLabel, unstyled, className, style, ...opts }: UpdateBannerProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=update-banner.d.ts.map

package/dist/client/update-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-banner.d.ts","sourceRoot":"","sources":["../../src/client/update-banner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEnF;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAiBD,wBAAgB,YAAY,CAAC,EAC3B,OAAuC,EACvC,WAAsB,EACtB,QAAgB,EAChB,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACR,EAAE,iBAAiB,kDAcnB"}

package/dist/client/update-banner.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useVersionCheck } from './use-version-check.js';
+const barStyle = {
+    position: 'fixed', left: 0, right: 0, bottom: 0, zIndex: 9999,
+    display: 'flex', gap: 12, alignItems: 'center', justifyContent: 'center',
+    padding: '10px 14px', background: '#1d1830', color: '#e8e6f2',
+    borderTop: '1px solid #ffffff22', fontFamily: 'system-ui, sans-serif', fontSize: 14,
+};
+const reloadBtn = {
+    background: '#5a3380', color: 'white', border: 'none', borderRadius: 6,
+    padding: '6px 14px', fontSize: 14, cursor: 'pointer',
+};
+const closeBtn = {
+    background: 'transparent', color: '#aab', border: 'none', fontSize: 18,
+    cursor: 'pointer', lineHeight: 1,
+};
+export function UpdateBanner({ message = 'A new version is available.', reloadLabel = 'Reload', unstyled = false, className, style, ...opts }) {
+    const { updateAvailable, reload, dismiss } = useVersionCheck(opts);
+    if (!updateAvailable)
+        return null;
+    return (_jsxs("div", { role: "status", className: className, style: unstyled ? style : { ...barStyle, ...style }, children: [_jsx("span", { children: message }), _jsx("button", { type: "button", onClick: reload, style: unstyled ? undefined : reloadBtn, children: reloadLabel }), _jsx("button", { type: "button", onClick: dismiss, "aria-label": "Dismiss", style: unstyled ? undefined : closeBtn, children: "\u00D7" })] }));
+}
+//# sourceMappingURL=update-banner.js.map

package/dist/client/update-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-banner.js","sourceRoot":"","sources":["../../src/client/update-banner.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAA4B,MAAM,wBAAwB,CAAC;AAmBnF,MAAM,QAAQ,GAAkB;IAC9B,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI;IAC7D,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ;IACxE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS;IAC7D,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,uBAAuB,EAAE,QAAQ,EAAE,EAAE;CACpF,CAAC;AACF,MAAM,SAAS,GAAkB;IAC/B,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACtE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS;CACrD,CAAC;AACF,MAAM,QAAQ,GAAkB;IAC9B,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IACtE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,EAC3B,OAAO,GAAG,6BAA6B,EACvC,WAAW,GAAG,QAAQ,EACtB,QAAQ,GAAG,KAAK,EAChB,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACW;IAClB,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,CACL,eAAK,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,aAC1F,yBAAO,OAAO,GAAQ,EACtB,iBAAQ,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,YAC3E,WAAW,GACL,EACT,iBAAQ,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,OAAO,gBAAa,SAAS,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,uBAE1F,IACL,CACP,CAAC;AACJ,CAAC"}

package/dist/client/use-version-check.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Detects when a newer build of the app has been deployed while a tab is still
+ * running an old one, so the app can prompt the user to reload. Pairs with the
+ * `versionStamp` Vite plugin (digital-boardgame-framework/vite), which injects
+ * the running build id and emits the `version.json` this hook polls.
+ *
+ * Why: a long-lived open tab never re-requests the page, so it keeps running
+ * stale JS after a deploy — users then report already-fixed bugs. This polls a
+ * small uncached `version.json` on tab-refocus (the high-value trigger) and on
+ * an interval, and flips `updateAvailable` when the deployed build differs from
+ * the one this tab is running.
+ */
+export interface UseVersionCheckOpts {
+    /** The build id this running bundle was built with — pass the value the
+     *  `versionStamp` plugin injected (default global `__DBF_BUILD_ID__`). */
+    currentBuild: string;
+    /** URL of the published version manifest. Default `/version.json`. */
+    url?: string;
+    /** Poll interval in ms. Default 5 min. `<= 0` disables interval polling
+     *  (refocus checks still run). */
+    intervalMs?: number;
+    /** Also check whenever the tab becomes visible again. Default true. */
+    checkOnFocus?: boolean;
+    /** Auto-reload on Vite's `vite:preloadError` — a lazy import() hitting a
+     *  now-404'd old chunk after a deploy. Default true. */
+    reloadOnChunkError?: boolean;
+}
+export interface UseVersionCheckResult {
+    /** True when a different build is live and the user hasn't dismissed it. */
+    updateAvailable: boolean;
+    currentBuild: string;
+    /** The latest deployed build id seen, or null before the first successful check. */
+    latestBuild: string | null;
+    /** Hard-reload the page onto the new build. */
+    reload: () => void;
+    /** Hide the prompt for the current `latestBuild` (re-appears if a newer one ships). */
+    dismiss: () => void;
+}
+export declare function useVersionCheck(opts: UseVersionCheckOpts): UseVersionCheckResult;
+//# sourceMappingURL=use-version-check.d.ts.map

package/dist/client/use-version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-version-check.d.ts","sourceRoot":"","sources":["../../src/client/use-version-check.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC;8EAC0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;sCACkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;4DACwD;IACxD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,uFAAuF;IACvF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,qBAAqB,CAiEhF"}

package/dist/client/use-version-check.js

@@ -0,0 +1,63 @@
+import { useEffect, useRef, useState } from 'react';
+export function useVersionCheck(opts) {
+    const { currentBuild, url = '/version.json', intervalMs = 5 * 60 * 1000, checkOnFocus = true, reloadOnChunkError = true, } = opts;
+    const [latestBuild, setLatestBuild] = useState(null);
+    const [dismissed, setDismissed] = useState(null);
+    const currentRef = useRef(currentBuild);
+    currentRef.current = currentBuild;
+    useEffect(() => {
+        if (typeof document === 'undefined')
+            return;
+        let cancelled = false;
+        async function check() {
+            try {
+                // Cache-bust the query AND request no-store so neither the browser nor
+                // an edge CDN serves a stale manifest.
+                const r = await fetch(`${url}?_=${Date.now()}`, { cache: 'no-store' });
+                if (!r.ok)
+                    return;
+                const data = (await r.json().catch(() => null));
+                if (!cancelled && data && typeof data.build === 'string')
+                    setLatestBuild(data.build);
+            }
+            catch {
+                // offline / transient — ignore; we'll try again next tick.
+            }
+        }
+        check();
+        let id;
+        if (intervalMs > 0)
+            id = setInterval(check, intervalMs);
+        const onVisible = () => { if (document.visibilityState === 'visible')
+            check(); };
+        if (checkOnFocus)
+            document.addEventListener('visibilitychange', onVisible);
+        const onPreloadError = () => { if (typeof location !== 'undefined')
+            location.reload(); };
+        if (reloadOnChunkError && typeof window !== 'undefined') {
+            window.addEventListener('vite:preloadError', onPreloadError);
+        }
+        return () => {
+            cancelled = true;
+            if (id)
+                clearInterval(id);
+            if (checkOnFocus)
+                document.removeEventListener('visibilitychange', onVisible);
+            if (reloadOnChunkError && typeof window !== 'undefined') {
+                window.removeEventListener('vite:preloadError', onPreloadError);
+            }
+        };
+    }, [url, intervalMs, checkOnFocus, reloadOnChunkError]);
+    const updateAvailable = latestBuild !== null &&
+        latestBuild !== currentRef.current &&
+        latestBuild !== dismissed;
+    return {
+        updateAvailable,
+        currentBuild,
+        latestBuild,
+        reload: () => { if (typeof location !== 'undefined')
+            location.reload(); },
+        dismiss: () => setDismissed(latestBuild),
+    };
+}
+//# sourceMappingURL=use-version-check.js.map

package/dist/client/use-version-check.js.map

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

package/dist/vite/index.d.ts

@@ -0,0 +1,3 @@
+export { versionStamp } from './version-stamp.js';
+export type { VersionStampOpts, VersionStampPlugin } from './version-stamp.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/vite/index.js

@@ -0,0 +1,2 @@
+export { versionStamp } from './version-stamp.js';
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/vite/version-stamp.d.ts

@@ -0,0 +1,26 @@
+/** Minimal structural subset of Vite's `Plugin` — avoids a `vite` dependency.
+ *  The returned object is structurally a valid Vite plugin. */
+export interface VersionStampPlugin {
+    name: string;
+    config(): {
+        define: Record<string, string>;
+    };
+    configResolved(resolved: {
+        build?: {
+            outDir?: string;
+        };
+    }): void;
+    closeBundle(): void;
+}
+export interface VersionStampOpts {
+    /** Build id to stamp. Default: `git rev-parse --short HEAD`, or `dev-<rand>`. */
+    buildId?: string;
+    /** Global name to define the build id under. Default `__DBF_BUILD_ID__`. */
+    define?: string;
+    /** Manifest filename written into the build output dir. Default `version.json`. */
+    fileName?: string;
+    /** Override the output dir (otherwise taken from Vite's resolved config). */
+    outDir?: string;
+}
+export declare function versionStamp(opts?: VersionStampOpts): VersionStampPlugin;
+//# sourceMappingURL=version-stamp.d.ts.map

package/dist/vite/version-stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-stamp.d.ts","sourceRoot":"","sources":["../../src/vite/version-stamp.ts"],"names":[],"mappings":"AAaA;+DAC+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC7C,cAAc,CAAC,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAChE,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,wBAAgB,YAAY,CAAC,IAAI,GAAE,gBAAqB,GAAG,kBAAkB,CAwB5E"}

package/dist/vite/version-stamp.js

@@ -0,0 +1,46 @@
+// Build-time half of the update-banner feature. Node-only (used in
+// vite.config); never imported by app/runtime code.
+//
+// `versionStamp()` does two things:
+//   1. injects a build id as a global define (default `__DBF_BUILD_ID__`) so the
+//      running bundle knows which build it is, and
+//   2. writes `<outDir>/version.json` = { build, time } at the end of the build,
+//      which `useVersionCheck` polls to detect that a newer build is live.
+import { execSync } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+function defaultBuildId() {
+    try {
+        return execSync('git rev-parse --short HEAD', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch {
+        return 'dev-' + Math.random().toString(36).slice(2, 9);
+    }
+}
+export function versionStamp(opts = {}) {
+    const buildId = opts.buildId ?? defaultBuildId();
+    const defineName = opts.define ?? '__DBF_BUILD_ID__';
+    const fileName = opts.fileName ?? 'version.json';
+    let outDir = opts.outDir ?? 'dist';
+    const builtAt = new Date().toISOString();
+    return {
+        name: 'dbf:version-stamp',
+        config() {
+            return { define: { [defineName]: JSON.stringify(buildId) } };
+        },
+        configResolved(resolved) {
+            if (!opts.outDir && resolved.build?.outDir)
+                outDir = resolved.build.outDir;
+        },
+        closeBundle() {
+            try {
+                mkdirSync(outDir, { recursive: true });
+                writeFileSync(join(outDir, fileName), JSON.stringify({ build: buildId, time: builtAt }));
+            }
+            catch {
+                // best-effort — a failed stamp shouldn't fail the build
+            }
+        },
+    };
+}
+//# sourceMappingURL=version-stamp.js.map

package/dist/vite/version-stamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-stamp.js","sourceRoot":"","sources":["../../src/vite/version-stamp.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oDAAoD;AACpD,EAAE;AACF,oCAAoC;AACpC,iFAAiF;AACjF,mDAAmD;AACnD,iFAAiF;AACjF,2EAA2E;AAE3E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAsBjC,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAyB,EAAE;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,kBAAkB,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,cAAc,CAAC;IACjD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEzC,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,MAAM;YACJ,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAC/D,CAAC;QACD,cAAc,CAAC,QAAQ;YACrB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAE,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7E,CAAC;QACD,WAAW;YACT,IAAI,CAAC;gBACH,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YAC3F,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "digital-boardgame-framework",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Foundation library for turn-based digital boardgames: deterministic engine plumbing, async multiplayer, agent-friendly bug triage.",
   "keywords": ["boardgame", "board-game", "multiplayer", "async-multiplayer", "turn-based", "game-framework", "supabase", "cloudflare-pages"],
   "author": "John Champaign",
@@ -27,6 +27,10 @@
     "./client": {
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js"
     }
   },
   "files": ["dist", "supabase/schema.sql"],