@freegamestore/games 0.15.1 → 0.18.0

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

package/dist/feel/useParticles.js.map

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

package/dist/feel/useShake.d.ts

@@ -0,0 +1,14 @@
+import { type RefObject } from 'react';
+export interface ShakeOptions {
+    /** Peak offset in px. Keep it small: a few pixels reads as impact, more reads as a glitch. */
+    amplitude?: number;
+    /** Length of the shake in ms. */
+    duration?: number;
+}
+/**
+ * A function that shakes the element behind `ref`. It uses the Web Animations API,
+ * so nothing re-renders and the animation runs on the compositor. It does nothing
+ * under reduced motion, or where `element.animate` is missing.
+ */
+export declare function useShake<T extends HTMLElement>(ref: RefObject<T | null>, { amplitude, duration }?: ShakeOptions): () => void;
+//# sourceMappingURL=useShake.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useShake.d.ts","sourceRoot":"","sources":["../../src/feel/useShake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,OAAO,CAAC;AAIpD,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EACxB,EAAE,SAAa,EAAE,QAAc,EAAE,GAAE,YAAiB,GACnD,MAAM,IAAI,CAMZ"}

package/dist/feel/useShake.js

@@ -0,0 +1,17 @@
+import { useCallback } from 'react';
+import { prefersReducedMotion } from './reducedMotion.js';
+import { shakeKeyframes } from './shake.js';
+/**
+ * A function that shakes the element behind `ref`. It uses the Web Animations API,
+ * so nothing re-renders and the animation runs on the compositor. It does nothing
+ * under reduced motion, or where `element.animate` is missing.
+ */
+export function useShake(ref, { amplitude = 4, duration = 320 } = {}) {
+    return useCallback(() => {
+        const element = ref.current;
+        if (!element || prefersReducedMotion() || typeof element.animate !== 'function')
+            return;
+        element.animate(shakeKeyframes(amplitude), { duration, easing: 'ease-out' });
+    }, [ref, amplitude, duration]);
+}
+//# sourceMappingURL=useShake.js.map

package/dist/feel/useShake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShake.js","sourceRoot":"","sources":["../../src/feel/useShake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,WAAW,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAS5C;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAwB,EACxB,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,GAAG,KAAmB,EAAE;IAEpD,OAAO,WAAW,CAAC,GAAG,EAAE;QACtB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,oBAAoB,EAAE,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;YAAE,OAAO;QACxF,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/E,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/dist/index.d.ts

@@ -12,18 +12,21 @@
  * What you get:
  *   <GameShell topbar={<GameTopbar score={42} />}>{your game}</GameShell>
  */
+export { CONFETTI_COLOURS, CONFETTI_CSS, Confetti, type ConfettiProps, } from './Confetti.js';
+export * from './feel/index.js';
 export { GameAuth } from './GameAuth.js';
 export { GameButton, type GameButtonProps, type GameButtonSize, type GameButtonVariant, } from './GameButton.js';
 export { GameConfirm, type GameConfirmProps } from './GameConfirm.js';
 export { GameModal, type GameModalProps } from './GameModal.js';
 export { GameOverScreen, type GameOverScreenProps } from './GameOverScreen.js';
+export { GameResultScreen, type GameResultScreenProps, type GameResultStat, RESULT_SCREEN_CSS, } from './GameResultScreen.js';
 export { GameShell, type GameShellProps } from './GameShell.js';
 export { GameTextSizeToggle } from './GameTextSizeToggle.js';
 export { GameThemeToggle } from './GameThemeToggle.js';
 export { GameTopbar, type GameTopbarProps, type GameTopbarStat, } from './GameTopbar.js';
-export { Leaderboard, type LeaderboardProps } from './Leaderboard.js';
 export { useSound } from './SoundContext.js';
+export { START_SCREEN_CSS, StartScreen, type StartScreenProps, type StartScreenStep, } from './StartScreen.js';
+export { type ColourTokens, DARK_COLOUR_OVERRIDES, DARK_COLOURS, GAME_TOKENS_CSS, LIGHT_COLOURS, MOTION_TOKENS, type MotionTokens, REDUCED_MOTION_DURATIONS, SHAPE_TOKENS, type ShapeTokens, TYPOGRAPHY_TOKENS, type TypographyTokens, } from './tokens.js';
 export { type User, useAuth } from './useAuth.js';
 export { useGameSounds } from './useGameSounds.js';
-export { type LeaderboardEntry, useLeaderboard, } from './useLeaderboard.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,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,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,YAAY,EACjB,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,YAAY,EACjB,wBAAwB,EACxB,YAAY,EACZ,KAAK,WAAW,EAChB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -12,18 +12,30 @@
  * What you get:
  *   <GameShell topbar={<GameTopbar score={42} />}>{your game}</GameShell>
  */
+export { CONFETTI_COLOURS, CONFETTI_CSS, Confetti, } from './Confetti.js';
+export * from './feel/index.js';
 export { GameAuth } from './GameAuth.js';
 export { GameButton, } from './GameButton.js';
 export { GameConfirm } from './GameConfirm.js';
 export { GameModal } from './GameModal.js';
 export { GameOverScreen } from './GameOverScreen.js';
+export { GameResultScreen, RESULT_SCREEN_CSS, } from './GameResultScreen.js';
 export { GameShell } from './GameShell.js';
 export { GameTextSizeToggle } from './GameTextSizeToggle.js';
 export { GameThemeToggle } from './GameThemeToggle.js';
 export { GameTopbar, } from './GameTopbar.js';
-export { Leaderboard } from './Leaderboard.js';
+// Hidden: leaderboard not currently surfaced to users (issue #31) — remove the
+// comment markers to re-enable. Leaderboard.tsx and useLeaderboard.ts are left
+// intact on purpose, as is the workers/leaderboard API and its data.
+// export { Leaderboard, type LeaderboardProps } from './Leaderboard.js';
 export { useSound } from './SoundContext.js';
+export { START_SCREEN_CSS, StartScreen, } from './StartScreen.js';
+export { DARK_COLOUR_OVERRIDES, DARK_COLOURS, GAME_TOKENS_CSS, LIGHT_COLOURS, MOTION_TOKENS, REDUCED_MOTION_DURATIONS, SHAPE_TOKENS, TYPOGRAPHY_TOKENS, } from './tokens.js';
 export { useAuth } from './useAuth.js';
 export { useGameSounds } from './useGameSounds.js';
-export { useLeaderboard, } from './useLeaderboard.js';
+// Hidden: see the note on Leaderboard above (issue #31).
+// export {
+//   type LeaderboardEntry,
+//   useLeaderboard,
+// } from './useLeaderboard.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GAET,MAAM,eAAe,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,GAIX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAGhB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,UAAU,GAGX,MAAM,iBAAiB,CAAC;AACzB,+EAA+E;AAC/E,+EAA+E;AAC/E,qEAAqE;AACrE,yEAAyE;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACL,gBAAgB,EAChB,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EAEb,wBAAwB,EACxB,YAAY,EAEZ,iBAAiB,GAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAa,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,yDAAyD;AACzD,WAAW;AACX,2BAA2B;AAC3B,oBAAoB;AACpB,gCAAgC"}

package/dist/tokens.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Brand, typography and motion design tokens for FreeGameStore games.
+ *
+ * These values are lifted from the Mosaic Rush pilot (`web/src/index.css`),
+ * which is the first game to be built on them. They are the single definition
+ * the SDK documents. See TOKENS.md for the full reference.
+ *
+ * The SDK components read these as CSS custom properties (`var(--paper)` and
+ * so on), with their own fallbacks. This module does not inject anything on
+ * import (the package is `sideEffects: false`). A game that wants the tokens
+ * adds GAME_TOKENS_CSS to its stylesheet, or copies it into index.css.
+ *
+ * Changing a value here changes every game that adopts the tokens, so treat
+ * it as a platform-wide decision.
+ */
+/** Colour tokens. Each key becomes `--<kebab-case>`, for example `lineStrong` becomes `--line-strong`. */
+export interface ColourTokens {
+    /** Page and board background. */
+    paper: string;
+    /** Primary text. */
+    ink: string;
+    /** Secondary text and captions. */
+    muted: string;
+    /** Hairline borders on empty surfaces. */
+    line: string;
+    /** Borders on buttons and toggles. */
+    lineStrong: string;
+    /** Raised cards and overlays. */
+    panel: string;
+    /** Translucent surface, for frosted overlays. */
+    glass: string;
+    /** Bottom dock surface. */
+    dock: string;
+    /** Status: success. */
+    success: string;
+    /** Status: warning. */
+    warning: string;
+    /** Status: error. */
+    error: string;
+    /** Primary actions and highlights. */
+    accent: string;
+    /** Quiet fill behind accent text, for badges and tints. */
+    accentSoft: string;
+    /** Accent used as text (titles, badges). Lighter in dark mode so it passes AA on dark surfaces. */
+    accentInk: string;
+}
+/** Light theme. The default when `data-theme` is absent. */
+export declare const LIGHT_COLOURS: ColourTokens;
+/**
+ * Only the tokens that differ in dark mode. Applied under `:root[data-theme="dark"]`.
+ * `accent` is not listed: it is the same in both themes.
+ */
+export declare const DARK_COLOUR_OVERRIDES: Partial<ColourTokens>;
+/** Dark theme, resolved: the light values with the dark overrides applied. */
+export declare const DARK_COLOURS: ColourTokens;
+/** Typography tokens. Only display headings and score values use the display face. */
+export interface TypographyTokens {
+    /** Display face for titles and score values. */
+    fontDisplay: string;
+    /** Body face for everything else. */
+    fontBody: string;
+    /** Score and stat values. */
+    textStat: string;
+    /** Overlay titles. */
+    textTitle: string;
+    /** The start-screen title. */
+    textDisplay: string;
+}
+export declare const TYPOGRAPHY_TOKENS: TypographyTokens;
+/** Shape tokens. */
+export interface ShapeTokens {
+    /** Corner radius for cards and overlays. */
+    radius: string;
+}
+export declare const SHAPE_TOKENS: ShapeTokens;
+/** Motion tokens. Durations and easings every animation reads. */
+export interface MotionTokens {
+    /** Quick feedback, such as a press or a pop. */
+    fast: string;
+    /** Standard transitions. */
+    base: string;
+    /** Larger entrances and overlays. */
+    slow: string;
+    /** Default ease-out curve. */
+    easeOut: string;
+    /** Overshooting spring curve for pops. */
+    easeSpring: string;
+    /**
+     * The default duration for a control transition, such as a press or a hover.
+     * It follows `fast`, and reduced motion sets it to 0ms.
+     */
+    duration: string;
+    /** The default easing for a control transition. It follows `easeOut`. */
+    easing: string;
+}
+export declare const MOTION_TOKENS: MotionTokens;
+/**
+ * Durations under `prefers-reduced-motion: reduce`. The animations finish at
+ * once and only the final state is shown. Easings are unchanged.
+ */
+export declare const REDUCED_MOTION_DURATIONS: Pick<MotionTokens, 'fast' | 'base' | 'slow' | 'duration'>;
+/**
+ * A stylesheet that defines every token. It has three blocks:
+ *   - `:root`, the light values and the type, shape and motion tokens;
+ *   - `:root[data-theme="dark"]`, the dark colour overrides;
+ *   - `prefers-reduced-motion: reduce`, which zeroes the durations.
+ *
+ * Add it to a game's stylesheet, for example `<style>{GAME_TOKENS_CSS}</style>`
+ * or the top of `index.css`.
+ */
+export declare const GAME_TOKENS_CSS: string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,0GAA0G;AAC1G,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4DAA4D;AAC5D,eAAO,MAAM,aAAa,EAAE,YAe3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,YAAY,CAcvD,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,YAAY,EAAE,YAA6D,CAAC;AAEzF,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAM/B,CAAC;AAEF,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,YAAY,EAAE,WAE1B,CAAC;AAEF,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,aAAa,EAAE,YAQ3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAK9F,CAAC;AASF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,QASd,CAAC"}