@drincs/pixi-vn/dist/storage/index.d.ts

Pixi'VN is a npm package that provides various features for creating visual novels.

import { LRUCache } from 'lru-cache';
import { S as StorageElementType } from '../StorageElementType-DTGcnkzF.js';
export { a as StorageObjectType } from '../StorageElementType-DTGcnkzF.js';
import { S as StorageGameState, a as StorageGameStateItem } from '../StorageGameState-Cnfj75sk.js';
export { S as StoredClassModel } from '../StoredClassModel-CjdhvNgB.js';
import { CachedMap } from '../classes/index.js';

interface StorageManagerInterface {
    /**
     * The internal storage. **Do not modify this directly.**
     *
     * ATTENTION: If you edit this directly, the {@link this.cache} will not be updated.
     *
     * You can use Keyv with Pixi’VN by creating a new instance of Keyv and passing the storage object as a parameter.
     * ```ts
     * import { storage } from '@drincs/pixi-vn'
     * import Keyv from 'keyv';
     *
     * const keyvStorage = new Keyv({ store: storage.storage });
     *
     * keyvStorage.get<string>("myValue").then((value) => {
     *     console.log(value);
     * });
     * ```
     */
    readonly storage: Map<string, StorageElementType>;
    /**
     * The internal cache. **Do not modify this directly.**
     */
    readonly cache: LRUCache<string, any, unknown>;
    /**
     * Set the starting storage. The starting storage that will be used when the game starts.
     * By default, the starting storage is empty.
     */
    set startingStorage(value: {
        [key: string]: StorageElementType;
    });
    /**
     * Set a variable in the storage
     * @param key The key of the variable
     * @param value The value of the variable. If undefined, the variable will be removed
     * @returns
     */
    setVariable(key: string, value: StorageElementType): void;
    /**
     * Get a variable from the storage. If the variable is a temporary variable, it will return the temporary variable
     * @param key The key of the variable
     * @returns The value of the variable. If the variable does not exist, it will return undefined
     */
    getVariable<T extends StorageElementType>(key: string): T | undefined;
    /**
     * Remove a variable from the storage
     * @param key The key of the variable
     * @returns
     */
    removeVariable(key: string): void;
    /**
     * Set a variable in the temporary storage. The lifespan of the variable is the number of opened labels.
     * To get the temporary variable, use {@link getVariable}
     * @param key The key of the temporary variable
     * @param value The value of the temporary variable. If undefined, the variable will be removed
     * @returns
     */
    setTempVariable(key: string, value: StorageElementType): void;
    /**
     * Remove a temporary variable
     * @param key The key of the temporary variable
     */
    removeTempVariable(key: string): void;
    /**
     * Set a flag to true or false.
     * @param key The name of the flag
     * @param value The value of the flag.
     */
    setFlag(key: string, value: boolean): void;
    /**
     * Get the value of a flag
     * @param key The name of the flag
     * @returns The value of the flag
     */
    getFlag(key: string): boolean;
    /**
     * Clear the storage and the oidsUsed
     * @returns
     */
    clear(): void;
    /**
     * Export the storage to an object
     * @returns The object
     */
    export(): StorageGameState;
    /**
     * Restore the storage from an object
     * @param data The object
     */
    restore(data: StorageGameState): void;
}

declare class StorageManagerStatic {
    static storage: CachedMap<string, any>;
    static startingStorage: StorageGameStateItem[];
    static flags: string[];
    static tempStorage: Map<string, StorageElementType>;
    static tempStorageDeadlines: Map<string, number>;
    private constructor();
    static clearOldTempVariables(openedLabelsNumber: number): void;
    static setVariable(key: string, value: StorageElementType): void;
    static getVariable<T extends StorageElementType>(key: string): T | undefined;
    static removeVariable(key: string): void;
    static setFlag(key: string, value: boolean): void;
    static getFlag(key: string): boolean;
}

declare const storage: StorageManagerInterface;

export { StorageElementType, StorageGameState, type StorageManagerInterface, StorageManagerStatic, storage };