plinkit 1.0.0-dev.3 → 1.0.0

package/dist/index.d.ts

@@ -47,27 +47,12 @@ export declare class Plinkit {
     private readonly showGuidePegs;
     private balance;
     private lastSpawnAtMs;
-    private readonly audio;
     constructor(options: PlinkitOptions);
     spawnBall(): SpawnResult;
     resize(): void;
     destroy(): void;
     getState(): PlinkitStateSnapshot;
     setBallCost(value: number): void;
-    setMuted(value: boolean): void;
-    /**
-     * Возвращает `true`, если звук выключен или аудио не сконфигурировано
-     * (`options.audio` не передан). Так UI-код может единообразно опираться на
-     * `isMuted()` без проверки наличия аудио.
-     */
-    isMuted(): boolean;
-    setVolume(value: number): void;
-    /**
-     * Проигрывает UI-сэмпл, заданный через `options.audio.uiTapUrl`. Удобно
-     * вызывать из click/pointerup-обработчиков на кнопках продукта, чтобы UI-звук
-     * разделял mute/volume/auto-unlock с физическими звуками поля.
-     */
-    playUiTap(): void;
     private handleCollision;
     private frame;
     private renderSnapshot;
@@ -90,27 +75,20 @@ export declare interface PlinkitAppearanceOptions {
     textureCrossOrigin?: string | null;
 }
 
-export declare interface PlinkitAudioOptions {
-    /** URL короткого сэмпла для столкновения шарика с пегом (peg/guide). */
-    pegHitUrl?: string;
-    /** URL короткого сэмпла для попадания шарика в корзину (момент settle). */
-    bucketHitUrl?: string;
-    /** URL короткого сэмпла UI-клика (для использования через `Plinkit.playUiTap()`). */
-    uiTapUrl?: string;
-    /** Общая громкость 0..1. По умолчанию 1. */
-    masterVolume?: number;
-    /**
-     * Стартовое состояние mute. По умолчанию `false`. Web Audio автоматически
-     * разблокируется на первом user gesture (см. секцию «Звуки» в README).
-     */
-    muted?: boolean;
-}
-
 export declare interface PlinkitCallbacks {
     onBalanceChange?: (state: PlinkitStateSnapshot) => void;
     onBallSettled?: (settlement: BallSettlement, state: PlinkitStateSnapshot) => void;
+    onCollision?: (collision: PlinkitCollisionInfo, state: PlinkitStateSnapshot) => void;
+}
+
+export declare interface PlinkitCollisionInfo {
+    ballId: number;
+    target: PlinkitCollisionTarget;
+    speed: number;
 }
 
+export declare type PlinkitCollisionTarget = "peg" | "guide";
+
 declare interface PlinkitEdgeGuidesOptions {
     radius: number;
     spread: number;
@@ -142,9 +120,9 @@ export declare interface PlinkitOptions {
     showGuidePegs: boolean;
     houseEdge?: number;
     appearance?: PlinkitAppearanceOptions;
-    audio?: PlinkitAudioOptions;
     onBalanceChange?: (state: PlinkitStateSnapshot) => void;
     onBallSettled?: (settlement: BallSettlement, state: PlinkitStateSnapshot) => void;
+    onCollision?: (collision: PlinkitCollisionInfo, state: PlinkitStateSnapshot) => void;
 }
 
 export declare interface PlinkitStateSnapshot {