import { C as Class, M as MixinConstructorArgs, U as UnknownArgs, F as Fun } from '../types-C31Pn_8-.js';

/**
 * # Autobind
 *
 * Automatically binds all class methods to the instance.
 *
 * ```typescript
 * import { autobind } from 'aspectra/utils'
 *
 * @autobind
 * class Greeting {
 *   private readonly name = 'John'
 *
 *   public hello() {
 *     console.log(`Hello from ${this.name}`)
 *   }
 *
 *   public farewell() {
 *     console.log(`Goodbye from ${this.name}`)
 *   }
 * }
 *
 * const { hello, farewell } = new Greeting()
 * hello()
 * farewell()
 * ```
 */
declare function autobind<T extends Class<object, MixinConstructorArgs>>(target: T, _: ClassDecoratorContext<T>): T;

/**
 * # Bound
 *
 * Binds a class method to its instance.
 *
 * ```typescript
 * import { bound } from 'aspectra/utils'
 *
 * class Example {
 *   private readonly name = 'John'
 *
 *   @bound public greet() {
 *     console.log(`Hello from ${this.name}`)
 *   }
 * }
 *
 * const { greet } = new Example()
 * greet()
 * ```
 */
declare function bound<A extends UnknownArgs, R, T>(target: Fun<A, R, T>, context: ClassMethodDecoratorContext<T, typeof target>): void;

type Unit = 'Years' | 'Year' | 'Yrs' | 'Yr' | 'Y' | 'Weeks' | 'Week' | 'W' | 'Days' | 'Day' | 'D' | 'Hours' | 'Hour' | 'Hrs' | 'Hr' | 'H' | 'Minutes' | 'Minute' | 'Mins' | 'Min' | 'M' | 'Seconds' | 'Second' | 'Secs' | 'Sec' | 's' | 'Milliseconds' | 'Millisecond' | 'Msecs' | 'Msec' | 'Ms';
type UnitAnyCase = Unit | Uppercase<Unit> | Lowercase<Unit>;
type TimeString = `${number}` | `${number}${UnitAnyCase}` | `${number} ${UnitAnyCase}`;

type Serializable = string | number | boolean | bigint | null | undefined | {
    [_: string]: Serializable;
} | Serializable[] | Date;

/**
 * # Cached
 *
 * Similar to `memoized`, but with an expiration time.
 *
 * <Callout type='info'>
 *   Duration can be specified in milliseconds or using a human-readable
 *   string, powered by [`ms`](https://github.com/vercel/ms?tab=readme-ov-file#ms).
 * </Callout>
 *
 * ```typescript
 * import { cached } from 'aspectra/utils'
 *
 * class Database {
 *   @cached('2h') public queryAll() {
 *     // sql: SELECT * FROM table
 *   }
 * }
 * ```
 */
declare function cached<T, U extends Serializable[], R>(duration: TimeString | number): (target: Fun<U, R, T>, context: ClassMethodDecoratorContext<T, typeof target>) => void;

/**
 * # Memoized
 *
 * Memoizes the method. Usful for optimizing expensive computations.
 *
 * ```typescript
 * import { memoized } from 'aspectra/utils'
 *
 * class Calculator {
 *   @memoized public square(num: number): number {
 *     console.log('Calculating...')
 *     return num * num
 *   }
 * }
 *
 * const calculator = new Calculator()
 * console.log(calculator.square(2))
 * console.log(calculator.square(2))
 * ```
 */
declare function memoized<T, U extends Serializable[], R>(target: Fun<U, R, T>, context: ClassMethodDecoratorContext<T, typeof target>): void;

/**
 * # Sealed
 *
 * Seals a class, preventing it from being extended.
 *
 * <Callout type='info'>
 *   Error is thrown when attempting to instantiate a derived class.
 * </Callout>
 *
 * ```typescript
 * import { sealed } from 'aspectra/utils'
 *
 * @sealed
 * class Base {}
 *
 * class Derived extends Base {}
 *
 * try {
 *   new Derived()
 * } catch (error) {
 *   console.table(error)
 * }
 * ```
 */
declare function sealed<T extends Class<object, MixinConstructorArgs>>(target: T, _: ClassDecoratorContext<T>): T;

export { autobind, bound, cached, memoized, sealed };