@freegamestore/games 0.16.0 → 0.19.0

package/dist/StartScreen.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useState } from 'react';
+import { GameButton } from './GameButton.js';
+import { GameModal } from './GameModal.js';
+/** The numbered steps of a game's rules. */
+function HowToPlaySteps({ steps }) {
+    return (_jsx("ol", { className: "m-0 flex list-none flex-col gap-[0.85rem] p-0", children: steps.map((step, i) => (_jsxs("li", { className: "flex animate-fgs-rise-step items-start gap-3 motion-reduce:animate-none", 
+            // Dynamic: the entrance delay is staggered by the step's index.
+            style: { '--i': i }, children: [_jsx("span", { className: "grid size-7 flex-none place-items-center rounded-lg bg-accent font-display font-extrabold text-white shadow-[inset_0_1px_0_rgb(255_255_255/0.35),0_2px_4px_rgb(0_0_0/0.2)]", "aria-hidden": "true", children: i + 1 }), _jsxs("div", { children: [_jsx("strong", { className: "block font-bold text-ink", children: step.heading }), _jsx("p", { className: "m-0 mt-[0.15rem] text-[0.9rem] leading-[1.4] text-muted", children: step.text })] })] }, step.heading))) }));
+}
+/**
+ * A game's start screen: artwork, title, tagline, then Play and How to play.
+ * Motion is the `animate-fgs-*` utilities from the SDK's `theme.css`, and it
+ * stops under prefers-reduced-motion. The card sits on an opaque `bg-panel`.
+ *
+ * Colours come from the platform tokens through the game's `@theme` mapping.
+ */
+export function StartScreen({ title, tagline, artwork, playLabel = 'Play', onPlay, onHowToPlay, howToPlay, }) {
+    const [helpOpen, setHelpOpen] = useState(false);
+    const titleId = useId();
+    const showsHelp = onHowToPlay !== undefined || howToPlay !== undefined;
+    const openHelp = () => {
+        if (onHowToPlay)
+            onHowToPlay();
+        else
+            setHelpOpen(true);
+    };
+    return (_jsxs("section", { "data-fgs": "start", className: "relative flex h-full flex-col items-center justify-center gap-[clamp(0.75rem,3svh,1.5rem)] overflow-hidden bg-paper bg-[radial-gradient(120%_70%_at_50%_0%,var(--color-accent-soft)_0%,transparent_65%)] p-4", "aria-labelledby": titleId, children: [artwork !== undefined && artwork !== null && (_jsx("div", { "data-fgs": "start-artwork", className: "w-[min(11rem,52vw)] animate-fgs-rise [--delay:0ms] motion-reduce:animate-none", "aria-hidden": "true", children: _jsx("div", { className: "animate-fgs-float motion-reduce:animate-none", children: artwork }) })), _jsxs("div", { className: "flex w-[min(20rem,100%)] animate-fgs-rise flex-col items-center gap-2 rounded-fgs border border-line bg-panel px-5 pb-5 pt-6 text-center shadow-[inset_0_1px_0_rgb(255_255_255/0.4),0_1px_2px_rgb(0_0_0/0.06),0_18px_32px_-18px_rgb(0_0_0/0.35)] [--delay:120ms] motion-reduce:animate-none", children: [_jsx("h1", { id: titleId, className: "m-0 text-balance font-display text-fgs-display font-extrabold leading-[0.95] tracking-[-0.03em] text-ink [font-optical-sizing:auto] [font-variation-settings:'opsz'_144]", children: title }), tagline && (_jsx("p", { className: "m-0 mb-2 max-w-72 text-[0.95rem] leading-[1.4] text-muted", children: tagline })), _jsxs("div", { className: "mt-1 flex w-full flex-col gap-2", children: [_jsx(GameButton, { variant: "primary", size: "lg", block: true, onClick: onPlay, children: playLabel }), showsHelp && (_jsx(GameButton, { variant: "secondary", size: "md", block: true, onClick: openHelp, children: "How to play" }))] })] }), onHowToPlay === undefined && howToPlay !== undefined && (_jsx(GameModal, { open: helpOpen, onClose: () => setHelpOpen(false), title: "How to play", children: _jsx(HowToPlaySteps, { steps: howToPlay }) }))] }));
+}
+//# sourceMappingURL=StartScreen.js.map

package/dist/StartScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartScreen.js","sourceRoot":"","sources":["../src/StartScreen.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAmC3C,4CAA4C;AAC5C,SAAS,cAAc,CAAC,EAAE,KAAK,EAAyC;IACtE,OAAO,CACL,aAAI,SAAS,EAAC,+CAA+C,YAC1D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACtB,cAEE,SAAS,EAAC,yEAAyE;YACnF,gEAAgE;YAChE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAyB,aAE1C,eACE,SAAS,EAAC,4KAA4K,iBAC1K,MAAM,YAEjB,CAAC,GAAG,CAAC,GACD,EACP,0BACE,iBAAQ,SAAS,EAAC,0BAA0B,YAAE,IAAI,CAAC,OAAO,GAAU,EACpE,YAAG,SAAS,EAAC,yDAAyD,YAAE,IAAI,CAAC,IAAI,GAAK,IAClF,KAdD,IAAI,CAAC,OAAO,CAed,CACN,CAAC,GACC,CACN,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,KAAK,EACL,OAAO,EACP,OAAO,EACP,SAAS,GAAG,MAAM,EAClB,MAAM,EACN,WAAW,EACX,SAAS,GACQ;IACjB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,MAAM,SAAS,GAAG,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC;IAEvE,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,WAAW;YAAE,WAAW,EAAE,CAAC;;YAC1B,WAAW,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO,CACL,+BACW,OAAO,EAChB,SAAS,EAAC,8MAA8M,qBACvM,OAAO,aAEvB,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,IAAI,CAC5C,0BACW,eAAe,EACxB,SAAS,EAAC,+EAA+E,iBAC7E,MAAM,YAElB,cAAK,SAAS,EAAC,8CAA8C,YAAE,OAAO,GAAO,GACzE,CACP,EACD,eAAK,SAAS,EAAC,6RAA6R,aAC1S,aACE,EAAE,EAAE,OAAO,EACX,SAAS,EAAC,0KAA0K,YAEnL,KAAK,GACH,EACJ,OAAO,IAAI,CACV,YAAG,SAAS,EAAC,2DAA2D,YAAE,OAAO,GAAK,CACvF,EACD,eAAK,SAAS,EAAC,iCAAiC,aAC9C,KAAC,UAAU,IAAC,OAAO,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,KAAK,QAAC,OAAO,EAAE,MAAM,YAC1D,SAAS,GACC,EACZ,SAAS,IAAI,CACZ,KAAC,UAAU,IAAC,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,IAAI,EAAC,KAAK,QAAC,OAAO,EAAE,QAAQ,4BAEpD,CACd,IACG,IACF,EACL,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,CACvD,KAAC,SAAS,IAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,EAAC,aAAa,YAC/E,KAAC,cAAc,IAAC,KAAK,EAAE,SAAS,GAAI,GAC1B,CACb,IACO,CACX,CAAC;AACJ,CAAC"}

package/dist/feel/ScorePopup.d.ts

@@ -0,0 +1,20 @@
+import type * as React from 'react';
+/** How long a pop-up stays on screen, in ms. */
+export declare const SCORE_POP_MS = 700;
+export interface ScorePopupProps {
+    /** The points to show, as `+N`. */
+    points: number;
+    /** Horizontal centre, in the pixel space of its positioned ancestor. */
+    x: number;
+    /** Vertical centre, in the pixel space of its positioned ancestor. */
+    y: number;
+    /** Called once the pop-up has finished. The parent should remove it. */
+    onDone: () => void;
+}
+/**
+ * A floating `+N` that rises and fades from (x, y), then calls `onDone`.
+ * Under reduced motion it holds still for the same time, so the number is still
+ * seen and `onDone` still fires. Place it inside a `position: relative` container.
+ */
+export declare function ScorePopup({ points, x, y, onDone }: ScorePopupProps): React.JSX.Element;
+//# sourceMappingURL=ScorePopup.d.ts.map

package/dist/feel/ScorePopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScorePopup.d.ts","sourceRoot":"","sources":["../../src/feel/ScorePopup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAMpC,gDAAgD;AAChD,eAAO,MAAM,YAAY,MAAM,CAAC;AAKhC,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,CAAC,EAAE,MAAM,CAAC;IACV,sEAAsE;IACtE,CAAC,EAAE,MAAM,CAAC;IACV,wEAAwE;IACxE,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA8CvF"}

package/dist/feel/ScorePopup.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { easeInQuad, easeOutQuad } from './easing.js';
+import { prefersReducedMotion } from './reducedMotion.js';
+import { tweenProgress, tweenValue } from './tween.js';
+/** How long a pop-up stays on screen, in ms. */
+export const SCORE_POP_MS = 700;
+/** How far a pop-up rises before it fades, in px. */
+const RISE_PX = 40;
+/**
+ * A floating `+N` that rises and fades from (x, y), then calls `onDone`.
+ * Under reduced motion it holds still for the same time, so the number is still
+ * seen and `onDone` still fires. Place it inside a `position: relative` container.
+ */
+export function ScorePopup({ points, x, y, onDone }) {
+    const ref = useRef(null);
+    const onDoneRef = useRef(onDone);
+    useEffect(() => {
+        onDoneRef.current = onDone;
+    }, [onDone]);
+    useEffect(() => {
+        const element = ref.current;
+        if (!element)
+            return;
+        if (prefersReducedMotion()) {
+            const id = setTimeout(() => onDoneRef.current(), SCORE_POP_MS);
+            return () => clearTimeout(id);
+        }
+        let started = null;
+        let frame = 0;
+        const step = (now) => {
+            started ??= now;
+            const elapsed = now - started;
+            const rise = tweenValue(0, -RISE_PX, elapsed, SCORE_POP_MS, easeOutQuad);
+            element.style.transform = `translate(-50%, calc(-50% + ${rise}px))`;
+            element.style.opacity = String(tweenValue(1, 0, elapsed, SCORE_POP_MS, easeInQuad));
+            if (tweenProgress(elapsed, SCORE_POP_MS) < 1) {
+                frame = requestAnimationFrame(step);
+            }
+            else {
+                onDoneRef.current();
+            }
+        };
+        frame = requestAnimationFrame(step);
+        return () => cancelAnimationFrame(frame);
+    }, []);
+    return (_jsx("span", { ref: ref, "data-fgs": "score-popup", className: "pointer-events-none absolute z-[750] whitespace-nowrap font-display text-fgs-stat font-extrabold text-accent-ink will-change-[transform,opacity] [text-shadow:0_1px_2px_rgb(0_0_0/0.55)] [transform:translate(-50%,-50%)]", 
+        // Dynamic: the pop-up is placed at the caller's x and y; the rise and fade are set from script.
+        style: { left: x, top: y }, children: `+${points}` }));
+}
+//# sourceMappingURL=ScorePopup.js.map

package/dist/feel/ScorePopup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScorePopup.js","sourceRoot":"","sources":["../../src/feel/ScorePopup.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAEhC,qDAAqD;AACrD,MAAM,OAAO,GAAG,EAAE,CAAC;AAanB;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAmB;IAClE,MAAM,GAAG,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC7B,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,oBAAoB,EAAE,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;YAC/D,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;YAC3B,OAAO,KAAK,GAAG,CAAC;YAChB,MAAM,OAAO,GAAG,GAAG,GAAG,OAAO,CAAC;YAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;YACzE,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,+BAA+B,IAAI,MAAM,CAAC;YACpE,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;YACpF,IAAI,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,eACE,GAAG,EAAE,GAAG,cACC,aAAa,EACtB,SAAS,EAAC,2NAA2N;QACrO,gGAAgG;QAChG,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,YAEzB,IAAI,MAAM,EAAE,GACR,CACR,CAAC;AACJ,CAAC"}

package/dist/feel/easing.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Easing curves. Each maps progress t in [0, 1] to an eased progress, with
+ * 0 → 0 and 1 → 1. Pure functions, so they can be used anywhere and tree-shaken.
+ */
+export type Easing = (t: number) => number;
+export declare const linear: Easing;
+export declare const easeInQuad: Easing;
+/** Starts fast and settles. The default for entrances and moves. */
+export declare const easeOutQuad: Easing;
+export declare const easeOutCubic: Easing;
+export declare const easeInOutQuad: Easing;
+/** Overshoots its target and settles back, a light spring. Use it for pops, not for long moves. */
+export declare function easeOutBack(overshoot?: number): Easing;
+//# sourceMappingURL=easing.d.ts.map

package/dist/feel/easing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/feel/easing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE3C,eAAO,MAAM,MAAM,EAAE,MAAiB,CAAC;AAEvC,eAAO,MAAM,UAAU,EAAE,MAAqB,CAAC;AAE/C,oEAAoE;AACpE,eAAO,MAAM,WAAW,EAAE,MAAqC,CAAC;AAEhE,eAAO,MAAM,YAAY,EAAE,MAAgC,CAAC;AAE5D,eAAO,MAAM,aAAa,EAAE,MAAiE,CAAC;AAE9F,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,SAAS,SAAU,GAAG,MAAM,CAGvD"}

package/dist/feel/easing.js

@@ -0,0 +1,12 @@
+export const linear = (t) => t;
+export const easeInQuad = (t) => t * t;
+/** Starts fast and settles. The default for entrances and moves. */
+export const easeOutQuad = (t) => 1 - (1 - t) * (1 - t);
+export const easeOutCubic = (t) => 1 - (1 - t) ** 3;
+export const easeInOutQuad = (t) => (t < 0.5 ? 2 * t * t : 1 - (-2 * t + 2) ** 2 / 2);
+/** Overshoots its target and settles back, a light spring. Use it for pops, not for long moves. */
+export function easeOutBack(overshoot = 1.70158) {
+    const c3 = overshoot + 1;
+    return (t) => 1 + c3 * (t - 1) ** 3 + overshoot * (t - 1) ** 2;
+}
+//# sourceMappingURL=easing.js.map

package/dist/feel/easing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.js","sourceRoot":"","sources":["../../src/feel/easing.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,UAAU,GAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAE/C,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,YAAY,GAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,aAAa,GAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE9F,mGAAmG;AACnG,MAAM,UAAU,WAAW,CAAC,SAAS,GAAG,OAAO;IAC7C,MAAM,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC"}

package/dist/feel/haptics.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Haptic pulses through the Vibration API. Pure except for the one `vibrate` call,
+ * so the patterns can be checked on their own.
+ */
+/** Milliseconds to vibrate, or alternating vibrate and pause durations. */
+export type VibrationPattern = number | readonly number[];
+/** Named pulses for common game events. Each stays short so it reads as feedback, not buzzing. */
+export declare const HAPTICS: {
+    /** A match clears: a crisp double tick. */
+    readonly clear: readonly [12, 40, 18];
+    /** The game ends: a heavier, slower pulse. */
+    readonly gameOver: readonly [60, 80, 120];
+};
+/**
+ * Ask the device to vibrate. Returns false when the Vibration API is missing, which
+ * covers desktop browsers and iOS Safari. Nothing else happens in that case.
+ */
+export declare function vibrate(pattern: VibrationPattern, nav?: Pick<Navigator, 'vibrate'> | undefined): boolean;
+//# sourceMappingURL=haptics.d.ts.map

package/dist/feel/haptics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../../src/feel/haptics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAE1D,kGAAkG;AAClG,eAAO,MAAM,OAAO;IAClB,2CAA2C;;IAE3C,8CAA8C;;CAEK,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,gBAAgB,EACzB,GAAG,GAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,SAA6B,GAC9D,OAAO,CAGT"}

package/dist/feel/haptics.js

@@ -0,0 +1,24 @@
+/**
+ * Haptic pulses through the Vibration API. Pure except for the one `vibrate` call,
+ * so the patterns can be checked on their own.
+ */
+/** Named pulses for common game events. Each stays short so it reads as feedback, not buzzing. */
+export const HAPTICS = {
+    /** A match clears: a crisp double tick. */
+    clear: [12, 40, 18],
+    /** The game ends: a heavier, slower pulse. */
+    gameOver: [60, 80, 120],
+};
+/**
+ * Ask the device to vibrate. Returns false when the Vibration API is missing, which
+ * covers desktop browsers and iOS Safari. Nothing else happens in that case.
+ */
+export function vibrate(pattern, nav = globalNavigator()) {
+    if (typeof nav?.vibrate !== 'function')
+        return false;
+    return nav.vibrate(pattern);
+}
+function globalNavigator() {
+    return typeof navigator === 'undefined' ? undefined : navigator;
+}
+//# sourceMappingURL=haptics.js.map

package/dist/feel/haptics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.js","sourceRoot":"","sources":["../../src/feel/haptics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,kGAAkG;AAClG,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,2CAA2C;IAC3C,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC;CAC4B,CAAC;AAEtD;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,OAAyB,EACzB,MAA8C,eAAe,EAAE;IAE/D,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,GAAG,CAAC,OAAO,CAAC,OAA4B,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC"}

package/dist/feel/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The feel kit: particles, tweens and easing, shake, haptics and score pop-ups.
+ * Every export is a separate module with no side effects on import, so a bundler
+ * keeps only what a game uses. Import it from `@freegamestore/games/feel`, or
+ * from the package root.
+ */
+export { type Easing, easeInOutQuad, easeInQuad, easeOutBack, easeOutCubic, easeOutQuad, linear, } from './easing.js';
+export { HAPTICS, type VibrationPattern, vibrate } from './haptics.js';
+export { type BurstOptions, createBurst, GRAVITY, MAX_PARTICLES, type Particle, particleAlpha, stepParticles, } from './particles.js';
+export { prefersReducedMotion } from './reducedMotion.js';
+export { SCORE_POP_MS, ScorePopup, type ScorePopupProps } from './ScorePopup.js';
+export { shakeKeyframes } from './shake.js';
+export { tweenProgress, tweenValue } from './tween.js';
+export { type Haptics, useHaptics } from './useHaptics.js';
+export { type ParticleEmitter, useParticles } from './useParticles.js';
+export { type ShakeOptions, useShake } from './useShake.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feel/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,MAAM,EACX,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,KAAK,gBAAgB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EACL,KAAK,YAAY,EACjB,WAAW,EACX,OAAO,EACP,aAAa,EACb,KAAK,QAAQ,EACb,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,KAAK,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,KAAK,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,KAAK,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/feel/index.js

@@ -0,0 +1,17 @@
+/**
+ * The feel kit: particles, tweens and easing, shake, haptics and score pop-ups.
+ * Every export is a separate module with no side effects on import, so a bundler
+ * keeps only what a game uses. Import it from `@freegamestore/games/feel`, or
+ * from the package root.
+ */
+export { easeInOutQuad, easeInQuad, easeOutBack, easeOutCubic, easeOutQuad, linear, } from './easing.js';
+export { HAPTICS, vibrate } from './haptics.js';
+export { createBurst, GRAVITY, MAX_PARTICLES, particleAlpha, stepParticles, } from './particles.js';
+export { prefersReducedMotion } from './reducedMotion.js';
+export { SCORE_POP_MS, ScorePopup } from './ScorePopup.js';
+export { shakeKeyframes } from './shake.js';
+export { tweenProgress, tweenValue } from './tween.js';
+export { useHaptics } from './useHaptics.js';
+export { useParticles } from './useParticles.js';
+export { useShake } from './useShake.js';
+//# sourceMappingURL=index.js.map

package/dist/feel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feel/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAyB,OAAO,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAEL,WAAW,EACX,OAAO,EACP,aAAa,EAEb,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAgB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAwB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAqB,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/feel/particles.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Particle bursts: a pure model with no DOM or canvas, so it can be tested on its own
+ * and drawn by any renderer. `useParticles` draws it to a canvas.
+ */
+/** One particle. Positions and sizes are in CSS pixels, times in seconds. */
+export interface Particle {
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    size: number;
+    colour: string;
+    age: number;
+    life: number;
+}
+export interface BurstOptions {
+    /** How many particles to emit. */
+    count: number;
+    /** Launch speed range, in px per second. */
+    speed: readonly [number, number];
+    /** Square size range, in px. */
+    size: readonly [number, number];
+    /** Seconds a particle lives. Each one varies by up to a quarter. */
+    life: number;
+    /** Centre of the launch arc, in radians. 0 points right and π/2 points down. Default 0. */
+    angle?: number;
+    /** Width of the launch arc, in radians. Default 2π, which is a full radial burst. */
+    spread?: number;
+}
+/** Downward pull, in px per second squared. */
+export declare const GRAVITY = 900;
+/** Upper bound on live particles, so a burst on a slow device cannot pile up. */
+export declare const MAX_PARTICLES = 160;
+/**
+ * Emit a burst of `options.count` particles from (x, y). Colours are used in
+ * turn. `random` returns values in [0, 1), and tests can pass a fixed one.
+ */
+export declare function createBurst(x: number, y: number, colours: readonly string[], options: BurstOptions, random?: () => number): Particle[];
+/**
+ * Advance every particle by `dt` seconds, drop the ones past their life, and
+ * return the survivors. Works in place, so a frame allocates nothing.
+ */
+export declare function stepParticles(particles: Particle[], dt: number, gravity?: number): Particle[];
+/** Opacity for a particle: fully opaque when born, fading to nothing at the end of its life. */
+export declare function particleAlpha(particle: Particle): number;
+//# sourceMappingURL=particles.d.ts.map

package/dist/feel/particles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particles.d.ts","sourceRoot":"","sources":["../../src/feel/particles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gCAAgC;IAChC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B,iFAAiF;AACjF,eAAO,MAAM,aAAa,MAAM,CAAC;AAQjC;;;GAGG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,MAAM,MAAoB,GACjC,QAAQ,EAAE,CAqBZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,SAAU,GAAG,QAAQ,EAAE,CAY9F;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD"}

package/dist/feel/particles.js

@@ -0,0 +1,61 @@
+/**
+ * Particle bursts: a pure model with no DOM or canvas, so it can be tested on its own
+ * and drawn by any renderer. `useParticles` draws it to a canvas.
+ */
+/** Downward pull, in px per second squared. */
+export const GRAVITY = 900;
+/** Upper bound on live particles, so a burst on a slow device cannot pile up. */
+export const MAX_PARTICLES = 160;
+const FALLBACK_COLOUR = '#888888';
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+/**
+ * Emit a burst of `options.count` particles from (x, y). Colours are used in
+ * turn. `random` returns values in [0, 1), and tests can pass a fixed one.
+ */
+export function createBurst(x, y, colours, options, random = Math.random) {
+    if (colours.length === 0)
+        return [];
+    const angle = options.angle ?? 0;
+    const spread = options.spread ?? Math.PI * 2;
+    const particles = [];
+    for (let i = 0; i < options.count; i++) {
+        const direction = angle + (random() - 0.5) * spread;
+        const speed = lerp(options.speed[0], options.speed[1], random());
+        particles.push({
+            x,
+            y,
+            vx: Math.cos(direction) * speed,
+            vy: Math.sin(direction) * speed,
+            size: lerp(options.size[0], options.size[1], random()),
+            colour: colours[i % colours.length] ?? FALLBACK_COLOUR,
+            age: 0,
+            life: options.life * (0.75 + 0.25 * random()),
+        });
+    }
+    return particles;
+}
+/**
+ * Advance every particle by `dt` seconds, drop the ones past their life, and
+ * return the survivors. Works in place, so a frame allocates nothing.
+ */
+export function stepParticles(particles, dt, gravity = GRAVITY) {
+    let alive = 0;
+    for (const particle of particles) {
+        particle.age += dt;
+        if (particle.age >= particle.life)
+            continue;
+        particle.vy += gravity * dt;
+        particle.x += particle.vx * dt;
+        particle.y += particle.vy * dt;
+        particles[alive++] = particle;
+    }
+    particles.length = alive;
+    return particles;
+}
+/** Opacity for a particle: fully opaque when born, fading to nothing at the end of its life. */
+export function particleAlpha(particle) {
+    return Math.max(0, 1 - particle.age / particle.life);
+}
+//# sourceMappingURL=particles.js.map

package/dist/feel/particles.js.map

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

package/dist/feel/reducedMotion.d.ts

@@ -0,0 +1,6 @@
+/**
+ * True when the player has asked the system for less motion. Safe to call where
+ * `matchMedia` is missing (server render, jsdom, old browsers), where it returns false.
+ */
+export declare function prefersReducedMotion(): boolean;
+//# sourceMappingURL=reducedMotion.d.ts.map

package/dist/feel/reducedMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducedMotion.d.ts","sourceRoot":"","sources":["../../src/feel/reducedMotion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAI9C"}

package/dist/feel/reducedMotion.js

@@ -0,0 +1,10 @@
+/**
+ * True when the player has asked the system for less motion. Safe to call where
+ * `matchMedia` is missing (server render, jsdom, old browsers), where it returns false.
+ */
+export function prefersReducedMotion() {
+    return typeof window !== 'undefined' && typeof window.matchMedia === 'function'
+        ? window.matchMedia('(prefers-reduced-motion: reduce)').matches
+        : false;
+}
+//# sourceMappingURL=reducedMotion.js.map

package/dist/feel/reducedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducedMotion.js","sourceRoot":"","sources":["../../src/feel/reducedMotion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;QAC7E,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO;QAC/D,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC"}

package/dist/feel/shake.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Keyframes for a short, decaying shake: a few side-to-side swings that shrink to rest.
+ * Pure, so the motion can be checked on its own and passed to `element.animate`.
+ */
+export declare function shakeKeyframes(amplitude: number): Keyframe[];
+//# sourceMappingURL=shake.d.ts.map

package/dist/feel/shake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shake.d.ts","sourceRoot":"","sources":["../../src/feel/shake.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAW5D"}

package/dist/feel/shake.js

@@ -0,0 +1,17 @@
+/**
+ * Keyframes for a short, decaying shake: a few side-to-side swings that shrink to rest.
+ * Pure, so the motion can be checked on its own and passed to `element.animate`.
+ */
+export function shakeKeyframes(amplitude) {
+    const a = amplitude;
+    return [
+        { transform: 'translate3d(0, 0, 0)', offset: 0 },
+        { transform: `translate3d(${-a}px, 0, 0)`, offset: 0.15 },
+        { transform: `translate3d(${a * 0.8}px, 0, 0)`, offset: 0.3 },
+        { transform: `translate3d(${-a * 0.6}px, 0, 0)`, offset: 0.45 },
+        { transform: `translate3d(${a * 0.4}px, 0, 0)`, offset: 0.6 },
+        { transform: `translate3d(${-a * 0.2}px, 0, 0)`, offset: 0.8 },
+        { transform: 'translate3d(0, 0, 0)', offset: 1 },
+    ];
+}
+//# sourceMappingURL=shake.js.map

package/dist/feel/shake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shake.js","sourceRoot":"","sources":["../../src/feel/shake.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,CAAC,GAAG,SAAS,CAAC;IACpB,OAAO;QACL,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,EAAE,CAAC,EAAE;QAChD,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;QACzD,EAAE,SAAS,EAAE,eAAe,CAAC,GAAG,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE;QAC7D,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,GAAG,GAAG,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;QAC/D,EAAE,SAAS,EAAE,eAAe,CAAC,GAAG,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE;QAC7D,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,GAAG,GAAG,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE;QAC9D,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,EAAE,CAAC,EAAE;KACjD,CAAC;AACJ,CAAC"}

package/dist/feel/tween.d.ts

@@ -0,0 +1,9 @@
+import { type Easing } from './easing.js';
+/** Progress through a tween, from 0 to 1. Clamped, so a zero duration or a time past the end is safe. */
+export declare function tweenProgress(elapsed: number, duration: number): number;
+/**
+ * The value of a tween `elapsed` ms into a move from `from` to `to` over `duration` ms.
+ * Pure: the caller keeps the clock and decides when to draw the next frame.
+ */
+export declare function tweenValue(from: number, to: number, elapsed: number, duration: number, easing?: Easing): number;
+//# sourceMappingURL=tween.d.ts.map

package/dist/feel/tween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../src/feel/tween.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,aAAa,CAAC;AAEvD,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAoB,GAC3B,MAAM,CAER"}

package/dist/feel/tween.js

@@ -0,0 +1,15 @@
+import { easeOutQuad } from './easing.js';
+/** Progress through a tween, from 0 to 1. Clamped, so a zero duration or a time past the end is safe. */
+export function tweenProgress(elapsed, duration) {
+    if (duration <= 0)
+        return 1;
+    return Math.min(1, Math.max(0, elapsed / duration));
+}
+/**
+ * The value of a tween `elapsed` ms into a move from `from` to `to` over `duration` ms.
+ * Pure: the caller keeps the clock and decides when to draw the next frame.
+ */
+export function tweenValue(from, to, elapsed, duration, easing = easeOutQuad) {
+    return from + (to - from) * easing(tweenProgress(elapsed, duration));
+}
+//# sourceMappingURL=tween.js.map

package/dist/feel/tween.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.js","sourceRoot":"","sources":["../../src/feel/tween.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,yGAAyG;AACzG,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,QAAgB;IAC7D,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,EAAU,EACV,OAAe,EACf,QAAgB,EAChB,SAAiB,WAAW;IAE5B,OAAO,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/feel/useHaptics.d.ts

@@ -0,0 +1,12 @@
+import { type VibrationPattern } from './haptics.js';
+export interface Haptics {
+    /** Vibrate with a pattern. Silent when haptics are off or unsupported. */
+    pulse(pattern: VibrationPattern): void;
+}
+/**
+ * Haptic pulses for a game. Haptics are not visual motion, so reduced motion does
+ * not switch them off. Pass `enabled: false` to mute them, for example from a
+ * settings toggle. The returned object is stable while `enabled` is unchanged.
+ */
+export declare function useHaptics(enabled?: boolean): Haptics;
+//# sourceMappingURL=useHaptics.d.ts.map

package/dist/feel/useHaptics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHaptics.d.ts","sourceRoot":"","sources":["../../src/feel/useHaptics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,OAAO;IACtB,0EAA0E;IAC1E,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,UAAO,GAAG,OAAO,CASlD"}

package/dist/feel/useHaptics.js

@@ -0,0 +1,16 @@
+import { useMemo } from 'react';
+import { vibrate } from './haptics.js';
+/**
+ * Haptic pulses for a game. Haptics are not visual motion, so reduced motion does
+ * not switch them off. Pass `enabled: false` to mute them, for example from a
+ * settings toggle. The returned object is stable while `enabled` is unchanged.
+ */
+export function useHaptics(enabled = true) {
+    return useMemo(() => ({
+        pulse(pattern) {
+            if (enabled)
+                vibrate(pattern);
+        },
+    }), [enabled]);
+}
+//# sourceMappingURL=useHaptics.js.map

package/dist/feel/useHaptics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHaptics.js","sourceRoot":"","sources":["../../src/feel/useHaptics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAyB,OAAO,EAAE,MAAM,cAAc,CAAC;AAO9D;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAO,GAAG,IAAI;IACvC,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,KAAK,CAAC,OAAO;YACX,IAAI,OAAO;gBAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;KACF,CAAC,EACF,CAAC,OAAO,CAAC,CACV,CAAC;AACJ,CAAC"}

package/dist/feel/useParticles.d.ts

@@ -0,0 +1,18 @@
+import { type RefObject } from 'react';
+import { type BurstOptions } from './particles.js';
+export interface ParticleEmitter {
+    /**
+     * Launch a burst from (x, y), in the canvas's own CSS-pixel space. Does nothing
+     * under reduced motion, or before the canvas is mounted.
+     */
+    burst(x: number, y: number, colours: readonly string[], options: BurstOptions): void;
+}
+/**
+ * Particle bursts drawn to a full-size canvas. Pass the ref of an `<canvas>`
+ * that is positioned over the play area and has `pointer-events: none`. The
+ * frame loop runs only while particles are alive, so an idle board costs
+ * nothing. The live count is written to `data-particles`, so tests can read it
+ * without a re-render per frame.
+ */
+export declare function useParticles(canvasRef: RefObject<HTMLCanvasElement | null>): ParticleEmitter;
+//# sourceMappingURL=useParticles.d.ts.map

package/dist/feel/useParticles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParticles.d.ts","sourceRoot":"","sources":["../../src/feel/useParticles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA8B,MAAM,OAAO,CAAC;AACnE,OAAO,EACL,KAAK,YAAY,EAMlB,MAAM,gBAAgB,CAAC;AASxB,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CACtF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,eAAe,CA2C5F"}

package/dist/feel/useParticles.js

@@ -0,0 +1,79 @@
+import { useEffect, useMemo, useRef } from 'react';
+import { createBurst, MAX_PARTICLES, particleAlpha, stepParticles, } from './particles.js';
+import { prefersReducedMotion } from './reducedMotion.js';
+/** Highest device pixel ratio used for the canvas. Higher ratios cost fill time for no visible gain. */
+const MAX_DPR = 2;
+/** Longest step a single frame may take, in seconds, so a tab switch does not fling particles across the screen. */
+const MAX_FRAME_DT = 0.1;
+/**
+ * Particle bursts drawn to a full-size canvas. Pass the ref of an `<canvas>`
+ * that is positioned over the play area and has `pointer-events: none`. The
+ * frame loop runs only while particles are alive, so an idle board costs
+ * nothing. The live count is written to `data-particles`, so tests can read it
+ * without a re-render per frame.
+ */
+export function useParticles(canvasRef) {
+    const particlesRef = useRef([]);
+    const frameRef = useRef(0);
+    const lastRef = useRef(null);
+    const runningRef = useRef(false);
+    useEffect(() => () => {
+        cancelAnimationFrame(frameRef.current);
+        runningRef.current = false;
+    }, []);
+    return useMemo(() => {
+        const frame = (now) => {
+            // The first frame after a burst has no previous time to measure from, so it takes no step.
+            const last = lastRef.current;
+            const dt = last === null ? 0 : Math.min(Math.max((now - last) / 1000, 0), MAX_FRAME_DT);
+            lastRef.current = now;
+            const particles = stepParticles(particlesRef.current, dt);
+            const canvas = canvasRef.current;
+            if (canvas)
+                drawFrame(canvas, particles);
+            if (particles.length === 0) {
+                runningRef.current = false;
+                return;
+            }
+            frameRef.current = requestAnimationFrame(frame);
+        };
+        return {
+            burst(x, y, colours, options) {
+                if (!canvasRef.current || prefersReducedMotion())
+                    return;
+                const particles = particlesRef.current;
+                particles.push(...createBurst(x, y, colours, options));
+                if (particles.length > MAX_PARTICLES)
+                    particles.splice(0, particles.length - MAX_PARTICLES);
+                if (runningRef.current)
+                    return;
+                runningRef.current = true;
+                lastRef.current = null;
+                frameRef.current = requestAnimationFrame(frame);
+            },
+        };
+    }, [canvasRef]);
+}
+/** Match the backing store to the CSS size, scaled for the screen, then draw one frame. */
+function drawFrame(canvas, particles) {
+    canvas.dataset.particles = String(particles.length);
+    const dpr = Math.min(window.devicePixelRatio || 1, MAX_DPR);
+    const width = canvas.clientWidth;
+    const height = canvas.clientHeight;
+    if (canvas.width !== Math.round(width * dpr) || canvas.height !== Math.round(height * dpr)) {
+        canvas.width = Math.round(width * dpr);
+        canvas.height = Math.round(height * dpr);
+    }
+    const ctx = canvas.getContext('2d');
+    if (!ctx)
+        return;
+    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+    ctx.clearRect(0, 0, width, height);
+    for (const particle of particles) {
+        ctx.globalAlpha = particleAlpha(particle);
+        ctx.fillStyle = particle.colour;
+        ctx.fillRect(particle.x - particle.size / 2, particle.y - particle.size / 2, particle.size, particle.size);
+    }
+    ctx.globalAlpha = 1;
+}
+//# sourceMappingURL=useParticles.js.map