coily 0.12.2 → 0.14.0

package/dist/system-coAFNYnb.d.ts

@@ -1,350 +0,0 @@
-//#region src/config.d.ts
-interface SpringState {
-  readonly position: number;
-  readonly velocity: number;
-}
-interface BaseOptions {
-  /**
-   * Mass of the spring system.
-   * @default 1
-   */
-  mass?: number | undefined;
-  /**
-   * Precision for resting threshold.
-   * @default 2
-   */
-  precision?: number | undefined;
-}
-interface WithTension {
-  /**
-   * Spring stiffness coefficient.
-   * Must be greater than 0.
-   */
-  tension: number;
-}
-interface WithDamping {
-  /**
-   * Viscous damping coefficient.
-   * Must be greater than or equal to 0.
-   */
-  damping: number;
-}
-interface WithDampingRatio {
-  /**
-   * Ratio of damping to critical damping (0 = undamped, 1 = critically damped).
-   * Must be greater than or equal to 0.
-   */
-  dampingRatio: number;
-}
-interface WithBounce {
-  /**
-   * Bounciness of the spring. Converted to dampingRatio as `1 - bounce`.
-   * [-1, 1]
-   */
-  bounce: number;
-}
-interface WithDuration {
-  /**
-   * Target settle duration in milliseconds.
-   * Must be greater than 0.
-   */
-  duration: number;
-}
-interface WithDisplacement {
-  /**
-   * Initial displacement used for duration-based envelope calculation.
-   * @default 1
-   */
-  displacement?: number | undefined;
-}
-interface DirectOptions extends BaseOptions, WithTension, WithDamping {}
-interface TensionRatioOptions extends BaseOptions, WithTension, WithDampingRatio {}
-interface TensionBounceOptions extends BaseOptions, WithTension, WithBounce {}
-interface DampingRatioOptions extends BaseOptions, WithDamping, WithDampingRatio {}
-interface DampingBounceOptions extends BaseOptions, WithDamping, WithBounce {}
-interface TensionDampingRatioOptions extends BaseOptions, WithTension, WithDamping, WithDampingRatio {}
-interface TensionDampingBounceOptions extends BaseOptions, WithTension, WithDamping, WithBounce {}
-interface DurationOptions extends BaseOptions, WithDampingRatio, WithDuration, WithDisplacement {}
-interface BounceDurationOptions extends BaseOptions, WithBounce, WithDuration, WithDisplacement {}
-interface TensionDurationOptions extends BaseOptions, WithTension, WithDampingRatio, WithDuration, WithDisplacement {}
-interface TensionBounceDurationOptions extends BaseOptions, WithTension, WithBounce, WithDuration, WithDisplacement {}
-interface DampingDurationOptions extends BaseOptions, WithDamping, WithDampingRatio, WithDuration, WithDisplacement {}
-interface DampingBounceDurationOptions extends BaseOptions, WithDamping, WithBounce, WithDuration, WithDisplacement {}
-type SpringOptions = DirectOptions | TensionRatioOptions | TensionBounceOptions | DampingRatioOptions | DampingBounceOptions | TensionDampingRatioOptions | TensionDampingBounceOptions | DurationOptions | BounceDurationOptions | TensionDurationOptions | TensionBounceDurationOptions | DampingDurationOptions | DampingBounceDurationOptions;
-/**
- * Immutable spring configuration.
- */
-declare class SpringConfig {
-  static readonly default: SpringConfig;
-  readonly mass: number;
-  readonly tension: number;
-  readonly damping: number;
-  readonly precision: number;
-  readonly naturalFrequency: number;
-  readonly criticalDamping: number;
-  readonly dampingRatio: number;
-  readonly precisionMultiplier: number;
-  readonly restingMagnitude: number;
-  constructor(input: SpringOptions);
-  /**
-   * Analytically estimates the time remaining for a spring to come to rest,
-   * given the current displacement and velocity.
-   *
-   * Uses the exponential decay envelope common to all three damping regimes.
-   * The decay rate depends on the regime:
-   * - Underdamped (ζ < 1): σ = ζωₙ
-   * - Critically damped (ζ = 1): σ = ωₙ
-   * - Overdamped (ζ > 1): σ = (ζ - √(ζ²-1))ωₙ  (the slower eigenvalue)
-   *
-   * The effective initial amplitude accounts for both displacement and velocity,
-   * since kinetic energy can convert to additional displacement:
-   *   A₀ = |x₀| + |v₀| / ωₙ
-   *
-   * Settling time: t = ln(A₀ / threshold) / σ, with a 2× safety factor
-   * to account for polynomial terms in the critically damped solution.
-   *
-   * Returns the estimated time in milliseconds.
-   */
-  computeTimeRemaining(state: SpringState): number;
-}
-/**
- * Direct physical parameters. You control stiffness and friction exactly;
- * mass defaults to 1.
- */
-declare function defineSpring(input: DirectOptions): SpringConfig;
-/**
- * Tension sets the stiffness; dampingRatio controls oscillation character
- * (0 = undamped, 1 = critically damped, >1 = overdamped).
- * Damping is derived as `2 * dampingRatio * sqrt(mass * tension)`.
- */
-declare function defineSpring(input: TensionRatioOptions): SpringConfig;
-/**
- * Tension sets the stiffness; bounce controls how oscillatory the spring is,
- * from -1 (overdamped, no oscillation) to 1 (maximum bounce).
- * Damping is derived to match the requested bounciness.
- */
-declare function defineSpring(input: TensionBounceOptions): SpringConfig;
-/**
- * Damping is given directly; dampingRatio is used to derive tension
- * as `damping² / (4 * dampingRatio² * mass)`.
- * dampingRatio must be greater than 0.
- */
-declare function defineSpring(input: DampingRatioOptions): SpringConfig;
-/**
- * Damping is given directly; bounce controls how oscillatory the spring is.
- * Tension is derived to match the requested bounciness.
- * bounce must be less than 1.
- */
-declare function defineSpring(input: DampingBounceOptions): SpringConfig;
-/**
- * All three physical knobs specified — mass is derived
- * as `damping² / (4 * dampingRatio² * tension)`.
- * dampingRatio must be greater than 0.
- */
-declare function defineSpring(input: TensionDampingRatioOptions): SpringConfig;
-/**
- * All three physical knobs specified — mass is derived
- * from tension, damping, and the requested bounciness.
- * bounce must be less than 1.
- */
-declare function defineSpring(input: TensionDampingBounceOptions): SpringConfig;
-/**
- * Duration-based configuration. The spring is tuned so that its envelope
- * decays to the resting threshold within the given duration.
- * Duration assumes a displacement of 1 by default — provide `displacement`
- * to match your actual animation range for accurate timing.
- * Tension and damping are both derived from dampingRatio and duration.
- */
-declare function defineSpring(input: DurationOptions): SpringConfig;
-/**
- * Duration-based configuration. The spring is tuned so that its envelope
- * decays to the resting threshold within the given duration.
- * Duration assumes a displacement of 1 by default — provide `displacement`
- * to match your actual animation range for accurate timing.
- * Bounce controls how oscillatory the motion is while settling.
- * Tension and damping are both derived.
- */
-declare function defineSpring(input: BounceDurationOptions): SpringConfig;
-/**
- * Duration-based with a tension constraint. Mass is derived from tension
- * and the computed natural frequency; damping follows from mass and dampingRatio.
- * Duration assumes a displacement of 1 by default — provide `displacement`
- * to match your actual animation range for accurate timing.
- */
-declare function defineSpring(input: TensionDurationOptions): SpringConfig;
-/**
- * Duration-based with a tension constraint. Bounce controls how oscillatory
- * the motion is while settling. Mass is derived from tension and the
- * computed natural frequency.
- * Duration assumes a displacement of 1 by default — provide `displacement`
- * to match your actual animation range for accurate timing.
- */
-declare function defineSpring(input: TensionBounceDurationOptions): SpringConfig;
-/**
- * Duration-based with a damping constraint. Mass is derived from damping,
- * dampingRatio, and the computed natural frequency; tension follows from mass.
- * Duration assumes a displacement of 1 by default — provide `displacement`
- * to match your actual animation range for accurate timing.
- */
-declare function defineSpring(input: DampingDurationOptions): SpringConfig;
-/**
- * Duration-based with a damping constraint. Bounce controls how oscillatory
- * the motion is while settling. Mass is derived from damping and the
- * computed natural frequency.
- * Duration assumes a displacement of 1 by default — provide `displacement`
- * to match your actual animation range for accurate timing.
- */
-declare function defineSpring(input: DampingBounceDurationOptions): SpringConfig;
-//#endregion
-//#region src/motion.d.ts
-declare class Motion {
-  #private;
-  constructor(config: SpringConfig, position: number, velocity: number);
-  get position(): number;
-  set position(value: number);
-  get velocity(): number;
-  set velocity(value: number);
-  get timeRemaining(): number;
-  get isResting(): boolean;
-  configure(config: SpringConfig): void;
-  tick(dt: number, emit?: boolean): void;
-  onUpdate(callback: () => void): () => void;
-  onStart(callback: () => void): () => void;
-  onStop(callback: () => void): () => void;
-  dispose(): void;
-}
-//#endregion
-//#region src/motion-set.d.ts
-declare class MotionSet {
-  #private;
-  constructor(debug?: boolean);
-  add(motion: Motion): void;
-  remove(motion: Motion): void;
-  tick(dt: number): void;
-}
-//#endregion
-//#region src/spring.d.ts
-interface SpringWithOffset {
-  spring: Spring;
-  offset?: number | undefined;
-}
-type SpringTarget = number | Spring | SpringWithOffset;
-interface DisplacedSpringPosition {
-  target?: SpringTarget | undefined;
-  value?: number | undefined;
-}
-type SpringPosition = number | DisplacedSpringPosition;
-declare class Spring {
-  #private;
-  constructor(motions: MotionSet, position: SpringPosition, config?: SpringConfig);
-  get target(): number;
-  set target(value: SpringTarget);
-  get value(): number;
-  set value(value: number);
-  get velocity(): number;
-  set velocity(value: number);
-  get config(): SpringConfig | null;
-  get mass(): number;
-  get tension(): number;
-  get damping(): number;
-  get dampingRatio(): number;
-  get precision(): number;
-  set config(value: SpringConfig | null);
-  get timeRemaining(): number;
-  get isResting(): boolean;
-  jumpTo(value: number): void;
-  dispose(): void;
-  onUpdate(callback: () => void): () => void;
-  onStart(callback: () => void): () => void;
-  onStop(callback: () => void): () => void;
-}
-//#endregion
-//#region src/vector2.d.ts
-interface Vector2 {
-  x: number;
-  y: number;
-}
-//#endregion
-//#region src/spring2d.d.ts
-interface Spring2DWithOffset {
-  spring: Spring2D;
-  offset?: Vector2 | undefined;
-}
-type Spring2DTarget = Vector2 | Spring2D | Spring2DWithOffset;
-interface DisplacedSpring2DPosition {
-  target?: Spring2DTarget | undefined;
-  value?: Vector2 | undefined;
-}
-type Spring2DPosition = Vector2 | DisplacedSpring2DPosition;
-declare class Spring2D {
-  #private;
-  constructor(motions: MotionSet, position: Spring2DPosition, config?: SpringConfig);
-  get target(): Vector2;
-  set target(value: Spring2DTarget);
-  get value(): Readonly<Vector2>;
-  set value(value: Vector2);
-  get velocity(): Readonly<Vector2>;
-  set velocity(value: Vector2);
-  get config(): SpringConfig | null;
-  get mass(): number;
-  get tension(): number;
-  get damping(): number;
-  get dampingRatio(): number;
-  get precision(): number;
-  set config(value: SpringConfig | null);
-  get timeRemaining(): number;
-  get isResting(): boolean;
-  jumpTo(value: Vector2): void;
-  dispose(): void;
-  onUpdate(callback: () => void): () => void;
-  onStart(callback: () => void): () => void;
-  onStop(callback: () => void): () => void;
-}
-//#endregion
-//#region src/ticker.d.ts
-interface TickerOptions {
-  /**
-   * The target frames per second for the simulation loop
-   *
-   * must be greater than 0, defaults to 60
-   */
-  fps?: number | undefined;
-  /**
-   * The maximum elapsed time (in ms) before a frame is considered a lag spike
-   * (e.g. from a backgrounded tab). When exceeded, `adjustedLag` is used instead
-   * of the real elapsed time. Set to 0 to disable lag detection.
-   *
-   * must be greater than or equal to 0, defaults to 500
-   */
-  lagThreshold?: number | undefined;
-  /**
-   * The substitute elapsed time (in ms) used when a lag spike is detected.
-   * Clamped to be at most `lagThreshold`.
-   *
-   * must be greater than or equal to 0, defaults to 33
-   */
-  adjustedLag?: number | undefined;
-}
-//#endregion
-//#region src/system.d.ts
-interface SpringSystemOptions extends TickerOptions {
-  debug?: boolean | undefined;
-}
-interface SpringSystem {
-  createSpring(position: SpringPosition, config?: SpringConfig): Spring;
-  createSpring2D(position: Spring2DPosition, config?: SpringConfig): Spring2D;
-  /** Advance all springs by `dt` milliseconds, without affecting internal timing. */
-  advance(dt: number): void;
-  /** Start the animation loop. */
-  start(): void;
-  /** Stop the animation loop. */
-  stop(): void;
-  /** Whether the animation loop is currently running. */
-  readonly running: boolean;
-  fps: number;
-  lagThreshold: number;
-  adjustedLag: number;
-}
-declare function createSpringSystem(options?: SpringSystemOptions): SpringSystem;
-//#endregion
-export { defineSpring as _, Spring2D as a, Spring2DWithOffset as c, SpringPosition as d, SpringTarget as f, SpringState as g, SpringOptions as h, TickerOptions as i, Vector2 as l, SpringConfig as m, SpringSystemOptions as n, Spring2DPosition as o, SpringWithOffset as p, createSpringSystem as r, Spring2DTarget as s, SpringSystem as t, Spring as u };