/** Serializable state for any bounded named resource. The caller defines what the resource means. */
export interface StatPool {
    current: number;
    max: number;
    min: number;
}
/** Input used to create a normalized pool. `current` defaults to `max`; `min` defaults to zero. */
export interface StatPoolInput {
    current?: number;
    max: number;
    min?: number;
}
/** Partial update applied without mutating the previous pool. */
export interface StatPoolPatch {
    current?: number;
    max?: number;
    min?: number;
}
/**
 * Structural bridge to caller-owned resource state. Implement it over an ECS,
 * Redux/Zustand store, plain object, database-backed model, or JGengine's native
 * entity stats without moving ownership into the SDK.
 */
export interface StatPoolAccess<TOwnerId extends string = string, TStatId extends string = string> {
    get(ownerId: TOwnerId, statId: TStatId): StatPool | null;
    set(ownerId: TOwnerId, statId: TStatId, next: StatPool): unknown;
}
/** Inspectable result of a bounded pool change. */
export interface StatPoolChange {
    previous: StatPool;
    pool: StatPool;
    /** Actual applied amount after clamping. */
    applied: number;
    hitMin: boolean;
    hitMax: boolean;
}
/** Outcome of changing a pool through {@link StatPoolAccess}. */
export type StatPoolAccessResult = ({
    status: "ok";
} & StatPoolChange) | {
    status: "rejected";
    reason: string;
};
/**
 * Normalize caller data into a complete plain-data pool.
 *
 * @capability stat-pool create a serializable current/min/max pool for any caller-named resource
 */
export declare function createStatPool(input: StatPoolInput): StatPool;
/**
 * Apply new bounds/current to a pool, clamping the result and leaving the input untouched.
 *
 * @capability stat-pool-patch immutably retune a bounded resource's current value or bounds
 */
export declare function patchStatPool(pool: StatPool, patch: StatPoolPatch): StatPool;
/**
 * Pure bounded delta transition with the exact applied amount and boundary flags.
 *
 * @capability stat-pool-change immutably increase or decrease any named bounded resource with clamp evidence
 */
export declare function changeStatPool(pool: StatPool, amount: number): StatPoolChange;
/**
 * Read, transition, and write a caller-owned pool through the structural
 * adapter. Positive amounts increase the resource; negative amounts decrease
 * it. The adapter receives a complete replacement value, never a hidden
 * mutation.
 *
 * @capability portable-stat-pool apply deterministic bounded resource changes through a caller-owned stat adapter
 */
export declare function applyStatPoolDelta<TOwnerId extends string, TStatId extends string>(access: StatPoolAccess<TOwnerId, TStatId>, ownerId: TOwnerId, statId: TStatId, amount: number): StatPoolAccessResult;