plinkit 1.0.0-dev.0 → 1.0.0-dev.2

package/dist/index.d.ts

@@ -43,15 +43,32 @@ export declare class Plinkit {
     private accumulatorMs;
     private lastFrameTime;
     private readonly callbacks;
-    private readonly ballCost;
+    private ballCost;
     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;
     private emitBalanceChange;
@@ -73,6 +90,22 @@ 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;
@@ -109,6 +142,7 @@ export declare interface PlinkitOptions {
     showGuidePegs: boolean;
     houseEdge?: number;
     appearance?: PlinkitAppearanceOptions;
+    audio?: PlinkitAudioOptions;
     onBalanceChange?: (state: PlinkitStateSnapshot) => void;
     onBallSettled?: (settlement: BallSettlement, state: PlinkitStateSnapshot) => void;
 }