@nayan-ui/games 1.19.0 → 1.20.0

package/lib/typescript/src/helpers/GamePatternData.d.ts

@@ -0,0 +1,46 @@
+export declare const PATTERN_RAINBOW: readonly ["#E91E63", "#F44336", "#FF5722", "#FF9800", "#FFC107", "#8E24AA", "#CDDC39", "#8BC34A", "#4CAF50", "#009688", "#00BCD4", "#03A9F4", "#2196F3", "#3F51B5", "#9C27B0"];
+/** A linear gradient across the whole pattern: evenly spaced CSS color stops from `start` to `end`. */
+export type PatternGradient = {
+    start: [number, number];
+    end: [number, number];
+    colors: readonly string[];
+};
+export type PatternShape = {
+    kind: 'circle';
+    cx: number;
+    cy: number;
+    r: number;
+    color: string;
+} | {
+    kind: 'rrect';
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    r: number;
+    color: string;
+} | {
+    kind: 'diamond';
+    cx: number;
+    cy: number;
+    size: number;
+    color: string;
+};
+export type PatternLine = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+export type GamePattern = {
+    width: number;
+    height: number;
+    gradients: PatternGradient[];
+    /** Floating shapes, then the large decorations, in drawing order. */
+    shapes: PatternShape[];
+    /** The faint grid, drawn last in `GRID_COLOR`. */
+    grid: PatternLine[];
+};
+export declare const PATTERN_GRID_COLOR = "rgba(0, 0, 0, 0.02)";
+/** The pattern for a window `width` x `height` points. */
+export declare function gamePattern(width: number, height: number): GamePattern;

package/lib/typescript/src/helpers/GameSettingsModal.d.ts

@@ -5,4 +5,4 @@ export interface GameSettingsProps {
     settings: GameSettings;
     onSettingsChange?: (settings: GameSettings) => void;
 }
-export declare const GameSettingsModal: React.FC<GameSettingsProps>;
+export declare const GameSettingsModal: React.NamedExoticComponent<GameSettingsProps>;

package/lib/typescript/src/helpers/GameTheme.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import { StyleSheet } from 'react-native';
+import { type GameTheme } from '../services/ThemeService';
+import type { GameThemeMode } from '../services/UtilsService';
+type NamedStyles = Parameters<typeof StyleSheet.create>[0];
+interface GameThemeProviderProps {
+    theme?: GameThemeMode;
+    children: React.ReactNode;
+}
+/** Wrap a game in this to render its shared chrome (background, scoreboard, controls, modals) in the host's theme. */
+export declare const GameThemeProvider: React.FC<GameThemeProviderProps>;
+export declare const useGameTheme: () => GameTheme;
+/**
+ * Build a StyleSheet per theme, once. There are only three theme objects, so the cache stays tiny
+ * and every render after the first is a Map lookup.
+ */
+export declare const createThemedStyles: <S extends NamedStyles>(factory: (theme: GameTheme) => S & NamedStyles) => (theme: GameTheme) => Readonly<S>;
+export {};

package/lib/typescript/src/helpers/IconPaths.d.ts

@@ -0,0 +1,4 @@
+/** Icon outlines (512 x 512), shared with the engine-drawn HUD. */
+export declare const TROPHY_PATH = "M134.7 33.8Q138.7 32.8 256.7 32.3Q374.7 31.8 378.7 33.8Q391.7 38.8 396.7 51.8Q399.7 57.8 399.7 68.8V79.8H434.7L469.7 80.8L472.7 82.8Q477.7 86.8 479.7 94.8Q482.7 112.8 476.7 143.8Q468.7 178.8 450.2 203.3Q431.7 227.8 406.7 235.8L398.7 238.8L396.7 246.8Q384.7 293.8 329.7 327.8Q303.7 343.8 277.7 348.8L272.7 349.8L271.7 398.8V447.8H305.7Q338.7 447.8 342.7 449.8Q348.7 452.8 350.7 459.8Q352.7 465.8 349.7 471.8Q346.7 477.8 340.7 478.8Q337.7 479.8 255.7 479.8Q173.7 479.8 170.7 478.8Q164.7 477.8 161.7 471.8Q158.7 465.8 160.7 459.8Q162.7 452.8 168.7 449.8Q172.7 447.8 205.7 447.8H239.7V398.8V350.8L236.7 349.8Q192.7 339.8 158.2 310.8Q123.7 281.8 114.7 245.8L112.7 238.8L104.7 235.8Q67.7 223.8 46.7 179.8Q33.7 151.8 31.7 116.8Q30.7 98.8 32.2 92.8Q33.7 86.8 38.7 82.8L41.7 80.8L76.7 79.8H111.7V68.8Q111.7 57.8 113.7 52.8Q119.7 37.8 134.7 33.8ZM367.7 146.8V63.8H255.7H143.7V149.8Q144.7 221.8 145.2 231.8Q145.7 241.8 150.7 252.8Q164.7 280.8 198.7 300.8Q230.7 319.8 255.7 319.8Q283.7 319.8 317.7 297.8Q352.7 274.8 363.7 245.8Q366.7 237.8 367.2 225.3Q367.7 212.8 367.7 146.8ZM111.7 157.8V111.8H87.7H63.7V118.8Q66.7 159.8 89.7 187.8Q97.7 197.8 107.7 202.8L111.7 204.8ZM447.7 118.8Q447.7 118.8 447.7 118.8V111.8H423.7H399.7V157.8V204.8L403.7 202.8Q413.7 197.8 421.7 187.8Q444.7 159.8 447.7 118.8Z";
+export declare const SHARE_PATH = "M376.2 48.8Q406.2 44.8 427.2 64.8Q439.2 75.8 444.2 87.8Q453.2 113.8 441.7 138.8Q430.2 163.8 404.2 172.8Q397.2 174.8 384.2 174.8Q371.2 174.8 364.2 172.8Q353.2 168.8 343.2 160.8L338.2 156.8L264.2 197.8L190.2 238.8L191.2 243.8Q192.2 247.8 192.2 255.8Q192.2 263.8 191.2 267.8L190.2 272.8L264.2 313.8L337.2 355.8L343.2 350.8Q358.2 338.8 376.7 336.3Q395.2 333.8 412.2 342.8Q446.2 358.8 448.2 395.8Q449.2 425.8 428.2 445.8Q417.2 455.8 404.2 460.8Q396.2 463.8 384.2 463.8Q372.2 463.8 364.2 460.8Q356.2 457.8 351.2 454.8Q332.2 442.8 324.2 423.8Q319.2 410.8 320.2 395.8Q321.2 387.8 321.2 385.8L316.2 380.8Q309.2 375.8 251.2 342.8Q180.2 302.8 177.2 301.8L174.2 299.8L169.2 304.8Q159.2 312.8 146.2 317.8Q140.2 319.8 128.2 319.8Q116.2 319.8 110.2 317.8Q77.2 306.8 66.2 273.8Q61.2 255.8 66.2 237.8Q77.2 204.8 110.2 194.8Q116.2 192.8 128.2 192.8Q140.2 192.8 146.2 194.8Q159.2 198.8 169.2 206.8Q174.2 211.8 176.7 210.3Q179.2 208.8 250.2 168.8Q321.2 128.8 321.2 126.3Q321.2 123.8 320.2 115.8Q318.2 85.8 341.2 64.8Q356.2 50.8 376.2 48.8ZM398.2 82.8Q392.2 80.8 385.2 80.3Q378.2 79.8 375.2 80.8Q362.2 85.8 355.2 98.8Q353.2 102.8 353.2 111.8Q353.2 120.8 355.2 124.8Q360.2 134.8 369.7 139.8Q379.2 144.8 389.2 142.8Q406.2 139.8 413.2 124.8Q415.2 120.8 415.2 111.8Q415.2 102.8 413.2 98.8Q408.2 87.8 398.2 82.8ZM142.2 226.8Q137.2 224.8 129.2 224.3Q121.2 223.8 118.2 225.8Q105.2 229.8 99.2 242.8Q97.2 246.8 97.2 255.8Q97.2 264.8 99.2 269.8Q110.2 290.8 133.2 287.8Q149.2 284.8 157.2 269.8Q159.2 264.8 159.2 255.8Q159.2 246.8 157.2 242.8Q152.2 231.8 142.2 226.8ZM389.2 368.8Q389.2 368.8 389.2 368.8Q384.2 367.8 383.7 367.8Q383.2 367.8 378.2 368.8Q362.2 370.8 355.2 386.8Q353.2 390.8 353.2 399.8Q353.2 408.8 355.2 412.8Q360.2 423.8 370.2 428.8Q376.2 430.8 384.2 430.8Q392.2 430.8 398.2 428.8Q408.2 423.8 413.2 412.8Q415.2 408.8 415.2 399.8Q415.2 390.8 413.2 386.8Q408.2 376.8 398.2 371.8Q394.2 369.8 389.2 368.8Z";
+export declare const PLAY_PATH = "M112 111v290c0 17.44 17 28.52 31 20.16l247.9-148.37c12.12-7.25 12.12-26.33 0-33.58L143 90.84c-14-8.36-31 2.72-31 20.16z";

package/lib/typescript/src/helpers/index.d.ts

@@ -1,20 +1,2 @@
-export { GameControlButton } from './GameControlButton';
-export type { GameControlButtonProps } from './GameControlButton';
-export { ScoreBoardContainer, scoreBoardStyles, ScoreLives, ScoreTimer, ScoreValue, ScoreColumn } from './ScoreBoardContainer';
-export type { ScoreBoardContainerProps, ScoreLivesProps, ScoreTimerProps, ScoreValueProps, ScoreColumnProps } from './ScoreBoardContainer';
-export { ParticleBlast } from './ParticleBlast';
-export { AnimatedScoreValue, CountUpScore } from './AnimatedScore';
-export type { AnimatedScoreValueProps, CountUpScoreProps } from './AnimatedScore';
-export { GameOverModal } from './GameOverModal';
 export { GameSettingsModal } from './GameSettingsModal';
-export { AnimationTracker, useAnimationTracker, useAnimationTrackers, DEFAULT_ANIMATION_STATE } from './AnimationTracker';
-export type { AnimationState } from './AnimationTracker';
-export { AnimationFrameManager, useAnimationFrame, useAnimationFrameManager } from './AnimationFrame';
-export { useGameTimer, setGameInterval, clearGameInterval } from './GameTimer';
-export type { GameIntervalHandle } from './GameTimer';
-export { GameErrorHandler, useGameErrorHandler, withErrorHandling, ErrorUtils, globalErrorHandler, DEFAULT_ERROR_CONFIG } from './ErrorHandler';
-export { GameErrorType } from './ErrorHandler';
-export type { GameError, ErrorHandlerConfig } from './ErrorHandler';
-export { GameBackground as GameBackgroundPattern } from './GameBackgroundPattern';
-export { TrophyIcon, ShareIcon, PlayIcon, VideoIcon, VolumeIcon, HapticIcon, BookIcon } from './Icons';
-export * from './assets';
+export { GameThemeProvider, useGameTheme, createThemedStyles } from './GameTheme';

package/lib/typescript/src/index.d.ts

@@ -1,3 +1,5 @@
+export * from './games/play-with-tua/PlayWithTua';
+export * from './games/treasure-hunt/TreasureHunt';
 export * from './games/arrows/Arrows';
 export * from './games/balloon-blaster/BalloonBlaster';
 export * from './games/bike-racing/BikeRacing';
@@ -48,6 +50,7 @@ export * from './games/checkers/Checkers';
 export * from './games/memory-match/MemoryMatch';
 export * from './games/falling-sticks/FallingSticks';
 export * from './games/reversi/Reversi';
+export * from './games/penguin-run/PenguinRun';
 export * from './services/GamesService';
 export * from './services/GamesMetadata';
 export * from './services/SoundsService';

package/lib/typescript/src/services/GameAssetLoader.d.ts

@@ -0,0 +1,32 @@
+export type AssetTask = () => unknown;
+export interface AssetStage {
+    label: string;
+    tasks: () => Iterable<AssetTask>;
+}
+export interface LoadTiming {
+    afterPaint(run: () => void): () => void;
+    now?: () => number;
+}
+/** Paint first, then batch small jobs within a frame budget, yielding between expensive builders. */
+export declare class GameAssetLoader {
+    private stages;
+    private changed;
+    private finished;
+    private failed;
+    private clock;
+    private stage;
+    private iterator?;
+    private task?;
+    private cancel?;
+    private active;
+    private busy;
+    private disposed;
+    private done;
+    constructor(stages: readonly AssetStage[], changed: (label: string) => void, finished: () => void, failed: (error: unknown) => void, clock?: LoadTiming);
+    start(): void;
+    pause(): void;
+    dispose(): void;
+    private schedule;
+    private step;
+    private reject;
+}

package/lib/typescript/src/services/GameAssets.d.ts

@@ -0,0 +1,11 @@
+import type { AssetStage, AssetTask } from './GameAssetLoader';
+import { GAME_IDS, type GameThemeMode } from './UtilsService';
+export declare const isHeavyGame: (id: GAME_IDS) => boolean;
+export declare const areGameAssetsReady: (id: GAME_IDS, mode?: GameThemeMode) => boolean;
+/** Nothing here runs until the selected game's loader has painted. */
+export declare function gameAssetStages(id: GAME_IDS, mode?: GameThemeMode): AssetStage[];
+/** Asset audit tooling; production opens only gameAssetStages(selectedId). */
+export declare function gameAssetGroups(): {
+    id: string;
+    tasks(): Generator<AssetTask, void, any>;
+}[];

package/lib/typescript/src/services/GameLoaders.d.ts

@@ -0,0 +1,18 @@
+import type React from 'react';
+import { GAME_IDS, type GameProps } from './UtilsService';
+/**
+ * Get the React component for a game id, loading its module on first use.
+ */
+export declare const loadGameComponent: (gameId: GAME_IDS | null | undefined) => React.ComponentType<GameProps> | null;
+/** Explicit engine-only warm-up for existing integrations; game assets load on their screen. */
+export declare const warmUpGames: () => (() => void);
+/** @deprecated Games no longer preload from the catalog. */
+export declare const prioritizeGameAssets: (_ids: readonly string[]) => void;
+/** @deprecated Game-screen loaders own their cancellation. */
+export declare const pauseGameAssetWarmup: () => void;
+export declare const getGameAssetWarmupStatus: () => {
+    running: boolean;
+    completed: number;
+    failed: number;
+    complete: boolean;
+};

package/lib/typescript/src/services/GamesConstants.d.ts

@@ -15,6 +15,17 @@ export declare const COLORS: {
     readonly SWITCH_THUMB: "#ffffff";
     readonly SCORE_GOLD: "#facc15";
 };
+export declare const HUD: {
+    readonly SURFACE: "rgba(255, 255, 255, 0.3)";
+    readonly BORDER: "rgba(255, 255, 255, 0.6)";
+    readonly BORDER_WIDTH: 1.5;
+    readonly DIVIDER: "rgba(255, 255, 255, 0.25)";
+    readonly TEXT: "#ffffff";
+    readonly TEXT_MUTED: "rgba(255, 255, 255, 0.85)";
+    readonly TEXT_SHADOW: "rgba(0, 0, 0, 0.35)";
+    readonly SOLID: "#ffffff";
+    readonly ON_SOLID: "#3a3a5e";
+};
 export declare const GAME_NAMES: {
     readonly BALLOON_BLASTER: "balloonBlaster";
     readonly FRUIT_SLICER: "fruitSlicer";

package/lib/typescript/src/services/GamesMetadata.d.ts

@@ -5,6 +5,8 @@ export interface GameMetadata {
     description: string;
     instructions: string[];
     categories: GameCategory[];
+    /** Catalog badge only; this does not restrict gameplay. */
+    isPremium?: boolean;
 }
 export declare const GAMES_METADATA: Record<GAME_IDS, GameMetadata>;
 export declare const GAMES_METADATA_LIST: GameMetadata[];

package/lib/typescript/src/services/HapticsService.d.ts

@@ -8,7 +8,7 @@ export declare enum HapticType {
     SELECTION = "selection"
 }
 /**
- * Play haptic feedback with robust error handling
+ * Play haptic feedback through the engine's native haptics
  * @param type - Type of haptic feedback to play
  * @param hapticEnabled - Whether haptic feedback is enabled in settings
  */

package/lib/typescript/src/services/SfxSources.d.ts

@@ -0,0 +1,79 @@
+export declare const SFX_SOURCES: {
+    balloon_pop: any;
+    blocked: any;
+    boing: any;
+    bonus: any;
+    boom: any;
+    cannon: any;
+    capture: any;
+    card_flip: any;
+    card_place: any;
+    catch: any;
+    chime: any;
+    chomp: any;
+    chomp_alt: any;
+    clack: any;
+    clang: any;
+    clash: any;
+    click: any;
+    coin: any;
+    combo: any;
+    crash: any;
+    crunch: any;
+    dance: any;
+    deselect: any;
+    dice_roll: any;
+    draw: any;
+    drop: any;
+    eat: any;
+    error: any;
+    footstep_walk: any;
+    footstep_run: any;
+    flag: any;
+    flap: any;
+    flip_disc: any;
+    game_over: any;
+    gate: any;
+    hop: any;
+    hurt: any;
+    invalid: any;
+    jump: any;
+    ladder: any;
+    land: any;
+    laugh: any;
+    lose: any;
+    merge: any;
+    miss: any;
+    pew: any;
+    place: any;
+    pling: any;
+    pop: any;
+    pop_soft: any;
+    power_up: any;
+    reveal: any;
+    robot: any;
+    rotate: any;
+    select: any;
+    shuffle: any;
+    six: any;
+    slice: any;
+    slide: any;
+    snake: any;
+    snap: any;
+    splash: any;
+    star: any;
+    start: any;
+    swoosh: any;
+    tap: any;
+    thud: any;
+    thunk: any;
+    tick: any;
+    time_up: any;
+    tock: any;
+    warning: any;
+    whack: any;
+    whoosh: any;
+    win: any;
+    zap: any;
+};
+export type SfxName = keyof typeof SFX_SOURCES;