@rb-games/core 0.1.0

package/dist/plugins/service/adapters/RGSAdapter.d.ts

@@ -0,0 +1,82 @@
+/**
+ * RGS Adapter for production use with backend API
+ * @module ServicePlugin/Adapters
+ */
+import { ServiceAdapter } from '../ServiceAdapter';
+import { type SessionResponse, type GameplayRequest, type GameplayResponse, type HistoryEntry, type HistoryResponse, type PlatformResponse } from '../types';
+/**
+ * RGS Adapter configuration
+ */
+export interface RGSAdapterConfig {
+    /** Base URL for the backend API (e.g., 'http://localhost:3000') */
+    baseUrl: string;
+    /** Session ID for authentication */
+    sessionId: string;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+}
+/**
+ * Production RGS adapter for backend API communication
+ *
+ * This adapter handles HTTP communication with the backend API:
+ * - GET /session/{sessionId} - Fetch session and game config
+ * - POST /session/{sessionId}/play - Execute spin action
+ * - GET /session/{sessionId}/history - Fetch game history
+ *
+ * @example
+ * ```typescript
+ * const adapter = new RGSAdapter({
+ *   baseUrl: 'http://localhost:3000',
+ *   sessionId: 'test-session-123',
+ *   debug: true,
+ * });
+ *
+ * const session = await adapter.getSession();
+ * const spin = await adapter.spin({ action: { type: 'spin', totalBet: 2000 } });
+ * ```
+ */
+export declare class RGSAdapter extends ServiceAdapter {
+    private _sessionId;
+    private baseUrl;
+    private requestTimeout;
+    constructor(config: RGSAdapterConfig);
+    /**
+     * Get the current session ID
+     */
+    get sessionId(): string;
+    /**
+     * Get session info and game configuration
+     * GET /session/{sessionId}
+     */
+    getSession(): Promise<SessionResponse>;
+    /**
+     * Execute a gameplay action (spin)
+     * POST /session/{sessionId}/play
+     */
+    spin(request: GameplayRequest): Promise<GameplayResponse>;
+    /**
+     * Get game history
+     * GET /session/{sessionId}/history
+     */
+    getHistory(limit?: number, pointer?: number): Promise<HistoryResponse>;
+    /**
+     * Get a single round summary by round ID
+     * GET /session/{sessionId}/round/{roundId}
+     */
+    getRound(roundId: string): Promise<HistoryEntry>;
+    /**
+     * Get player balance
+     * GET /session/{sessionId}/balance
+     */
+    getBalance(): Promise<PlatformResponse>;
+    /**
+     * Replay a completed spin by nonce
+     * GET /session/{sessionId}/replay/{nonce}
+     */
+    replay(nonce: number): Promise<GameplayResponse>;
+    /**
+     * Make an HTTP request to the backend API
+     */
+    private request;
+}
+//# sourceMappingURL=RGSAdapter.d.ts.map

package/dist/plugins/service/adapters/RGSAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RGSAdapter.d.ts","sourceRoot":"","sources":["../../../../plugins/service/adapters/RGSAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,UAAU,CAAC;AAGlB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,EAAE,gBAAgB;IAcpC;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAanD;;;OAGG;IACU,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYtE;;;OAGG;IACU,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBnF;;;OAGG;IACU,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAc7D;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAYpD;;;OAGG;IACU,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY7D;;OAEG;YACW,OAAO;CAwFtB"}

package/dist/plugins/service/adapters/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Service adapters
+ * @module ServicePlugin/Adapters
+ */
+export * from './RGSAdapter';
+export * from './DevAuthAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/service/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../plugins/service/adapters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/plugins/service/adapters/resolvePublicIp.d.ts

@@ -0,0 +1,10 @@
+export interface ResolvePublicIpOptions {
+    configIp?: string;
+    queryParams?: URLSearchParams;
+}
+/**
+ * Resolves the client's public IP for dev session creation.
+ * Priority: ?clientIP= / ?ip= query param → config override → ipify.org lookup.
+ */
+export declare function resolvePublicIp(options?: ResolvePublicIpOptions): Promise<string>;
+//# sourceMappingURL=resolvePublicIp.d.ts.map

package/dist/plugins/service/adapters/resolvePublicIp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePublicIp.d.ts","sourceRoot":"","sources":["../../../../plugins/service/adapters/resolvePublicIp.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC3F"}

package/dist/plugins/service/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Service plugin for backend API communication
+ * @module ServicePlugin
+ */
+export * from './ServicePlugin';
+export * from './ServiceAdapter';
+export * from './adapters';
+export * from './types';
+export * from './ServicePlugin.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/service/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/plugins/service/types/api.types.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Backend API Type Definitions
+ * Based on Swagger API at /api-json
+ * @module ServicePlugin/Types
+ */
+/**
+ * Session state enum
+ */
+export type SessionState = 'ready' | 'processing' | 'finished';
+/**
+ * Symbol type enum
+ */
+export type SymbolType = 'regular' | 'wild' | 'scatter' | 'bonus' | 'cluster';
+/**
+ * Win model type
+ */
+export type WinModel = 'cluster' | 'line' | 'ways';
+/**
+ * Game state type
+ */
+export type GameStateType = 'basic' | 'bonus';
+/**
+ * Symbol definition
+ */
+export interface SymbolDefinition {
+    id: number;
+    name: string;
+    type: SymbolType;
+}
+/**
+ * Board configuration
+ */
+export interface BoardConfig {
+    reels: number;
+    rows: number;
+}
+/**
+ * Payout entry for a specific count
+ */
+export interface PayoutEntry {
+    count: number;
+    value: number;
+    andMore?: boolean;
+}
+/**
+ * Symbol payout configuration
+ */
+export interface SymbolPayout {
+    symbolId: number;
+    payouts: PayoutEntry[];
+}
+/**
+ * Cluster paytable configuration
+ */
+export interface ClusterPaytable {
+    minCount: number;
+    decimalBase: number;
+    payouts: SymbolPayout[];
+}
+/**
+ * Paytable configuration
+ */
+export interface PaytableConfig {
+    cluster?: ClusterPaytable;
+}
+/**
+ * Free spins award entry
+ */
+export interface FreeSpinsAward {
+    count: number;
+    spins: number;
+    andMore?: boolean;
+}
+/**
+ * Free spins configuration
+ */
+export interface FreeSpinsConfig {
+    awards: FreeSpinsAward[];
+}
+/**
+ * buy bonus configuration
+ */
+export interface GameActions {
+    type: string;
+    totalBetMultiplier: number;
+    count?: number;
+}
+/**
+ * Complete game configuration from backend
+ */
+export interface GameConfig {
+    winModel: WinModel;
+    spinCost: number;
+    betMultipliers: BetMultiplierDefinition[];
+    board: BoardConfig;
+    symbols: SymbolDefinition[];
+    reels: number[][];
+    paytable: PaytableConfig;
+    freeSpins: FreeSpinsConfig;
+    actions: GameActions[];
+}
+/**
+ * Basic game state
+ */
+export interface BasicGameState {
+    state: 'basic';
+    totalWin?: number;
+}
+/**
+ * Bonus game state (active freespin round)
+ */
+export interface BonusGameState {
+    state: 'bonus';
+    bonusOrigin: 'spin' | 'buy-bonus' | 'buy-super-bonus';
+    remainingFreespins: number;
+    usedFreespins: number;
+    totalFreespins: number;
+    bet: number;
+    totalWin: number;
+}
+/**
+ * Bonus ended game state (carries summary until next spin)
+ */
+export interface BonusEndedGameState {
+    state: 'bonus_ended';
+    bonusOrigin: 'spin' | 'buy-bonus' | 'buy-super-bonus';
+    usedFreespins: number;
+    totalFreespins: number;
+    bet: number;
+    totalWin: number;
+}
+/**
+ * Game state union type
+ */
+export type GameState = BasicGameState | BonusGameState | BonusEndedGameState;
+/**
+ * Session response from GET /session
+ */
+export interface SessionResponse {
+    sessionId: string;
+    state: SessionState;
+    nonce: number;
+    serverSeedCommit: string;
+    gameState: GameState;
+    currentRoundId?: string | null;
+    gameConfig: GameConfig;
+    platform: PlatformResponse;
+}
+/**
+ * Spin action request
+ */
+export interface SpinAction {
+    type: string;
+    totalBet: number;
+}
+/**
+ * Gameplay request body
+ */
+export interface GameplayRequest {
+    action: SpinAction;
+    clientSeed?: string;
+}
+/**
+ * Platform response (balance info)
+ */
+export interface PlatformResponse {
+    balanceMinor: number;
+    currency: string;
+}
+/**
+ * Bet multiplier response
+ */
+export type BetMultiplierDefinition = number;
+/**
+ * Cluster win information
+ */
+export interface ClusterWin {
+    id: number;
+    symbol: number;
+    size: number;
+    multiplier: number;
+    payout: number;
+    cells: number[];
+}
+/**
+ * Scatter win information (temporary frontend implementation)
+ */
+export interface ScatterWin {
+    symbol: number;
+    count: number;
+    cells: number[];
+}
+/**
+ * Cluster mutation (one cascade step)
+ */
+export interface ClusterMutation {
+    generationId: number;
+    board: number[];
+    cellMultipliers: number[];
+    hitCounts?: number[];
+    win: number;
+    clusters: ClusterWin[];
+    scatters?: ScatterWin;
+}
+/**
+ * Gameplay action result payload
+ */
+export interface GameplayPayload {
+    type?: 'spin-result';
+    mutations: ClusterMutation[];
+}
+/**
+ * Game state info for basic/bonus transitions
+ */
+export interface GameStateInfo {
+    state: 'basic' | 'bonus' | 'bonus_ended';
+    bonusOrigin?: string;
+    remainingFreespins?: number;
+    usedFreespins?: number;
+    totalFreespins?: number;
+    bet?: number;
+    totalWin?: number;
+}
+/**
+ * Gameplay response from POST /gameplay
+ */
+export interface GameplayResponse {
+    type: 'finished';
+    action: string;
+    sessionId: string;
+    roundId: string;
+    roundStartNonce?: number;
+    totalBet: number;
+    winAmount: number;
+    actionCost: number;
+    actionResult: GameplayPayload;
+    /** @deprecated Prefer `state` / `previousState` — not always present on play responses */
+    gameState?: GameState;
+    previousState?: GameStateInfo;
+    state?: GameStateInfo;
+    usedNonce: number;
+    nextNonce: number;
+    platform: PlatformResponse;
+}
+/**
+ * History entry nonce — single action uses a number; multi-action range uses start/end.
+ */
+export type HistoryNonce = number | {
+    start: number;
+    end: number;
+};
+/**
+ * History entry
+ */
+export interface HistoryEntry {
+    roundId: string;
+    nonce: HistoryNonce;
+    action: string;
+    totalBet: number;
+    winAmount: number;
+    timestamp?: number;
+    nonces?: number[];
+    kind?: 'single' | 'range';
+}
+/**
+ * History response from GET /history
+ */
+export interface HistoryResponse {
+    entries: HistoryEntry[];
+    nextPointer?: number | null;
+}
+/**
+ * Service action event types
+ */
+export declare enum ServiceActions {
+    SESSION = "service:session",
+    GAMEPLAY = "service:gameplay",
+    HISTORY = "service:history",
+    ERROR = "service:error",
+    TIMEOUT = "service:timeout",
+    BALANCE_UPDATE = "service:balance"
+}
+/**
+ * Service event structure
+ */
+export interface ServiceEvent<T = unknown> {
+    target: unknown;
+    data: T;
+    error?: unknown;
+}
+/**
+ * Service error response
+ */
+export interface ServiceError {
+    code?: number;
+    message?: string;
+    error?: string;
+}
+//# sourceMappingURL=api.types.d.ts.map

package/dist/plugins/service/types/api.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.types.d.ts","sourceRoot":"","sources":["../../../../plugins/service/types/api.types.ts"],"names":[],"mappings":"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"}

package/dist/plugins/service/types/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Service plugin type definitions
+ * @module ServicePlugin/Types
+ */
+export * from './api.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/service/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../plugins/service/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC"}

package/dist/plugins/skin/ISkin.d.ts

@@ -0,0 +1,62 @@
+import { EventEmitter } from 'pixi.js';
+/**
+ * Interface for skin objects.
+ *
+ * ISkin provides a contract for theme-based configuration objects that can
+ * emit events when themes change or data is injected.
+ *
+ * @typeParam T - The type of properties this skin manages
+ *
+ * @public
+ */
+export interface ISkin<T = any> extends EventEmitter<SkinEvents<T>> {
+    getProperties(): Readonly<T>;
+    getProperty<K extends keyof T>(key: K): T[K] | undefined;
+    getId(): string;
+}
+/**
+ * Event data for theme changes.
+ *
+ * @typeParam T - The type of skin properties
+ *
+ * @public
+ */
+export interface SkinChangeEvent<T = any> {
+    /** The skin that changed */
+    skin: ISkin<T>;
+    /** Previous theme name */
+    oldTheme: string;
+    /** New theme name */
+    newTheme: string;
+}
+/**
+ * Event data for data injection.
+ *
+ * Fired when global data is injected into skin properties.
+ *
+ * @public
+ */
+export interface DataInjectionEvent {
+    /** Property path that was injected (e.g., 'ui.button.color') */
+    path: string;
+    /** Previous value */
+    oldValue: any;
+    /** New injected value */
+    newValue: any;
+}
+/**
+ * Events emitted by skin objects.
+ *
+ * @typeParam T - The type of skin properties
+ *
+ * @public
+ */
+export interface SkinEvents<T = any> {
+    /** Fired when theme changes */
+    themeChanged: (event: SkinChangeEvent<T>) => void;
+    /** Fired when global data is injected */
+    dataInjected: (event: DataInjectionEvent) => void;
+    /** Fired when skin is destroyed */
+    destroyed: () => void;
+}
+//# sourceMappingURL=ISkin.d.ts.map

package/dist/plugins/skin/ISkin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISkin.d.ts","sourceRoot":"","sources":["../../../plugins/skin/ISkin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACjE,aAAa,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7B,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACzD,KAAK,IAAI,MAAM,CAAC;CAyBjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,4BAA4B;IAC5B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACf,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,GAAG,CAAC;IACd,yBAAyB;IACzB,QAAQ,EAAE,GAAG,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG;IACjC,+BAA+B;IAC/B,YAAY,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAClD,yCAAyC;IACzC,YAAY,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAClD,mCAAmC;IACnC,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB"}

package/dist/plugins/skin/Skin.d.ts

@@ -0,0 +1,155 @@
+import { EventEmitter } from 'pixi.js';
+import type { SkinOptions } from './SkinPlugin.types';
+import type { ISkin, SkinEvents } from './ISkin';
+/**
+ * Skin implementation for theme-based configuration.
+ *
+ * Skin manages theme data and provides property access with automatic merging
+ * of default and current theme properties. Supports global data injection.
+ *
+ * ## Features
+ *
+ * - **Multi-Theme Support**: Switch between different themes at runtime
+ * - **Property Merging**: Current theme inherits from default theme
+ * - **Data Injection**: Global data can be injected using template strings
+ * - **Event Emission**: Fires events on theme changes and data injection
+ * - **Fallback Handling**: Falls back to default theme if theme not found
+ *
+ * ## Data Injection
+ *
+ * Skin supports template string injection using `${path}` syntax:
+ *
+ * ```typescript
+ * // Skin data with template strings
+ * const skinData = {
+ *   default: {
+ *     color: '${ui.default.themeColor.default}',
+ *     fontSize: '${ui.default.fontSize.normal}'
+ *   }
+ * };
+ *
+ * // Set global data
+ * skinPlugin.setGlobalData('ui.default.themeColor.default', 0xFFD100);
+ * skinPlugin.setGlobalData('ui.default.fontSize.normal', 24);
+ *
+ * // Properties are automatically injected
+ * const props = skin.getProperties();
+ * // { color: 0xFFD100, fontSize: 24 }
+ * ```
+ *
+ * @typeParam T - The type of properties this skin manages
+ *
+ * @example
+ * ```typescript
+ * // Create skin with multiple themes
+ * const { skin } = skinPlugin.createSkin({
+ *   data: {
+ *     default: {
+ *       background: { color: 0xFF0000 },
+ *       text: { fontSize: 24 }
+ *     },
+ *     dark: {
+ *       background: { color: 0x000000 }
+ *       // text inherits from default
+ *     },
+ *     mobile: {
+ *       text: { fontSize: 18 }
+ *       // background inherits from default
+ *     }
+ *   },
+ *   defaultTheme: 'default'
+ * });
+ *
+ * // Get properties (merges default + current theme)
+ * const props = skin.getProperties();
+ *
+ * // Switch theme
+ * skin.setTheme('dark');
+ *
+ * // Listen to theme changes
+ * skin.on('themeChanged', (event) => {
+ *   console.log(`Theme changed from ${event.oldTheme} to ${event.newTheme}`);
+ *   updateUI(skin.getProperties());
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare class Skin<T = any> extends EventEmitter<SkinEvents<T>> implements ISkin<T> {
+    private data;
+    private currentTheme;
+    private defaultTheme;
+    private id;
+    private plugin;
+    constructor(options: SkinOptions<T>, plugin: any);
+    /**
+     * Sets the current theme.
+     *
+     * If the theme doesn't exist, falls back to default theme.
+     * Emits 'themeChanged' event if theme actually changes.
+     *
+     * @param themeName - Name of the theme to activate
+     *
+     * @example
+     * ```typescript
+     * skin.setTheme('dark');
+     * skin.setTheme('mobile');
+     * ```
+     */
+    setTheme(themeName: string): void;
+    /**
+     * Gets the current theme name.
+     *
+     * @returns Current theme name
+     */
+    getCurrentTheme(): string;
+    /**
+     * Gets all properties for the current theme.
+     *
+     * Merges default theme properties with current theme properties.
+     * Current theme properties override default theme properties.
+     * Applies global data injection if configured.
+     *
+     * @returns Readonly properties object
+     *
+     * @example
+     * ```typescript
+     * const props = skin.getProperties();
+     * button.applyStyle(props);
+     * ```
+     */
+    getProperties(): Readonly<T>;
+    /**
+     * Gets a specific property by key.
+     *
+     * @param key - Property key
+     * @returns Property value or undefined
+     *
+     * @example
+     * ```typescript
+     * const color = skin.getProperty('color');
+     * ```
+     */
+    getProperty<K extends keyof T>(key: K): T[K] | undefined;
+    /**
+     * Gets the unique skin ID.
+     *
+     * @returns Skin ID
+     */
+    getId(): string;
+    getDefaultTheme(): string;
+    /**
+     * Checks if a theme exists.
+     *
+     * @param themeName - Theme name to check
+     * @returns True if theme exists
+     */
+    hasTheme(themeName: string): boolean;
+    /**
+     * Destroys the skin.
+     *
+     * Emits 'destroyed' event, removes all listeners, and unregisters from plugin.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=Skin.d.ts.map

package/dist/plugins/skin/Skin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Skin.d.ts","sourceRoot":"","sources":["../../../plugins/skin/Skin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,qBAAa,IAAI,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAChF,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAM;gBAER,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG;IAShD;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA4BjC;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;;;;;;;;;OAcG;IACH,aAAa,IAAI,QAAQ,CAAC,CAAC,CAAC;IAwB5B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAKxD;;;;OAIG;IACH,KAAK,IAAI,MAAM;IAIf,eAAe,IAAI,MAAM;IAIzB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAUhB"}