coily 0.13.1 → 0.15.0

package/dist/system-86fsXJN_.d.ts

@@ -1,386 +0,0 @@
-//#region src/config.d.ts
-interface SpringState {
-  readonly position: number;
-  readonly velocity: number;
-}
-interface BaseOptions {
-  /**
-   * Decimal places of the resting threshold: a spring rests once its
-   * remaining motion cannot reach half a unit in the last place,
-   * 0.5 × 10⁻ᵖ. Values are never rounded — precision only decides rest.
-   * @default 2
-   */
-  readonly precision?: number | undefined;
-}
-interface WithMass {
-  /**
-   * Mass of the spring system.
-   * @default 1
-   */
-  readonly mass?: number | undefined;
-}
-interface WithoutMass {
-  /**
-   * Mass is derived from the other parameters in this input shape
-   * and cannot be provided.
-   */
-  readonly mass?: undefined;
-}
-interface WithTension {
-  /**
-   * Spring stiffness coefficient.
-   * Must be greater than 0.
-   */
-  readonly tension: number;
-}
-interface WithDamping {
-  /**
-   * Viscous damping coefficient.
-   * Must be greater than or equal to 0.
-   */
-  readonly damping: number;
-}
-interface WithDampingRatio {
-  /**
-   * Ratio of damping to critical damping (0 = undamped, 1 = critically damped).
-   * Must be greater than or equal to 0.
-   */
-  readonly dampingRatio: number;
-}
-interface WithBounce {
-  /**
-   * Bounciness of the spring. Converted to dampingRatio as `1 - bounce`.
-   * [-1, 1]
-   */
-  readonly bounce: number;
-}
-interface WithDuration {
-  /**
-   * Target settle duration in milliseconds.
-   * Must be greater than 0.
-   */
-  readonly duration: number;
-}
-interface WithDisplacement {
-  /**
-   * Initial displacement used for duration-based envelope calculation.
-   * @default 1
-   */
-  readonly displacement?: number | undefined;
-}
-interface DirectOptions extends BaseOptions, WithMass, WithTension, WithDamping {}
-interface TensionRatioOptions extends BaseOptions, WithMass, WithTension, WithDampingRatio {}
-interface TensionBounceOptions extends BaseOptions, WithMass, WithTension, WithBounce {}
-interface DampingRatioOptions extends BaseOptions, WithMass, WithDamping, WithDampingRatio {}
-interface DampingBounceOptions extends BaseOptions, WithMass, WithDamping, WithBounce {}
-interface TensionDampingRatioOptions extends BaseOptions, WithoutMass, WithTension, WithDamping, WithDampingRatio {}
-interface TensionDampingBounceOptions extends BaseOptions, WithoutMass, WithTension, WithDamping, WithBounce {}
-interface DurationOptions extends BaseOptions, WithMass, WithDampingRatio, WithDuration, WithDisplacement {}
-interface BounceDurationOptions extends BaseOptions, WithMass, WithBounce, WithDuration, WithDisplacement {}
-interface TensionDurationOptions extends BaseOptions, WithoutMass, WithTension, WithDampingRatio, WithDuration, WithDisplacement {}
-interface TensionBounceDurationOptions extends BaseOptions, WithoutMass, WithTension, WithBounce, WithDuration, WithDisplacement {}
-interface DampingDurationOptions extends BaseOptions, WithoutMass, WithDamping, WithDampingRatio, WithDuration, WithDisplacement {}
-interface DampingBounceDurationOptions extends BaseOptions, WithoutMass, WithDamping, WithBounce, WithDuration, WithDisplacement {}
-type SpringOptionKeys = 'mass' | 'tension' | 'damping' | 'dampingRatio' | 'bounce' | 'duration' | 'displacement' | 'precision';
-/**
- * Marks every option key foreign to `T` as "absent or undefined", so mixing
- * properties from different input shapes fails to type-check instead of
- * silently resolving to an unintended shape at runtime.
- */
-type Exact<T> = T & { [K in Exclude<SpringOptionKeys, keyof T>]?: undefined; };
-type SpringOptions = Exact<DirectOptions> | Exact<TensionRatioOptions> | Exact<TensionBounceOptions> | Exact<DampingRatioOptions> | Exact<DampingBounceOptions> | Exact<TensionDampingRatioOptions> | Exact<TensionDampingBounceOptions> | Exact<DurationOptions> | Exact<BounceDurationOptions> | Exact<TensionDurationOptions> | Exact<TensionBounceDurationOptions> | Exact<DampingDurationOptions> | Exact<DampingBounceDurationOptions>;
-/**
- * Immutable spring configuration. Instances are frozen — to change a spring's
- * behavior, assign a new config via `spring.config`.
- */
-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;
-  /** Resting threshold in value units: half a unit in the last `precision` place. */
-  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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<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: Exact<DampingBounceDurationOptions>): SpringConfig;
-//#endregion
-//#region src/flush-queue.d.ts
-declare class FlushQueue {
-  #private;
-  request(callback: () => void): void;
-  batch(fn: () => void): void;
-  enter(): void;
-  exit(): void;
-}
-//#endregion
-//#region src/motion.d.ts
-declare class Motion {
-  #private;
-  _pass: number;
-  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;
-  finish(): void;
-  onUpdate(callback: () => void): () => void;
-  onStart(callback: () => void): () => void;
-  onStop(callback: () => void): () => void;
-  onDispose(callback: () => void): () => void;
-  dispose(): void;
-}
-//#endregion
-//#region src/motion-set.d.ts
-declare class MotionSet {
-  #private;
-  reduced: boolean;
-  onWake: (() => void) | null;
-  readonly flushes: FlushQueue;
-  constructor(debug?: boolean);
-  get size(): number;
-  add(motion: Motion): void;
-  remove(motion: Motion): void;
-  finishAll(): 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;
-  get settled(): Promise<void>;
-  jumpTo(value: number): void;
-  dispose(): void;
-  onUpdate(callback: () => void): () => void;
-  onStart(callback: () => void): () => void;
-  onStop(callback: () => void): () => void;
-  onDispose(callback: () => void): () => void;
-}
-//#endregion
-//#region src/spring-object.d.ts
-/**
- * Compile-time validation of a value shape: every channel must be a `number`,
- * every branch a plain object or array with at least one channel. Used as
- * `value: T & Shape<T>` so an invalid channel errors on that property rather
- * than on the whole argument. Purely structural — interfaces satisfy it
- * without index signatures — and mirrored by the runtime
- * validation for untyped callers. Optional and `undefined`-typed channels
- * are rejected: a channel that may be absent would make two springs of the
- * same declared shape structurally incompatible at runtime.
- */
-type Shape<T> = 0 extends 1 & T ? T : T extends number ? number : T extends ((...args: never) => unknown) | (abstract new (...args: never) => unknown) ? never : T extends readonly never[] ? never : T extends object ? keyof T extends never ? never : { [K in keyof T]-?: 0 extends 1 & T[K] ? T[K] : undefined extends T[K] ? never : Shape<T[K]>; } : never;
-/**
- * A partial view of a value shape: the same nesting with any subset of the
- * numeric channels present. Absent (or `undefined`) channels are left alone.
- */
-type PartialShape<T> = T extends number ? number : { readonly [K in keyof T]?: PartialShape<T[K]> | undefined; };
-/**
- * A deep-readonly view of a value shape. Composite reads (`target`, `value`,
- * `velocity`) return the spring's live mirror objects — refreshed in place
- * on every read — so their channels are typed read-only.
- */
-type ReadonlyShape<T> = T extends number ? number : { readonly [K in keyof T]: ReadonlyShape<T[K]>; };
-/**
- * Configuration for a spring object: a single `SpringConfig` applied to every
- * channel, or an object mirroring the value shape with configs at any level.
- * A config at a subtree applies to every channel below it; deeper configs win.
- * `null` reverts to the default config (or the leader's while following).
- * Configs are always `SpringConfig` instances (from `defineSpring`), so a
- * plain object is unambiguously a config shape and any non-config leaf it
- * reaches is an error.
- */
-type ConfigShape<T> = SpringConfig | null | (T extends number ? never : { readonly [K in keyof T]?: ConfigShape<T[K]> | undefined; });
-interface SpringObjectWithOffset<T extends object> {
-  readonly spring: SpringObject<T>;
-  readonly offset?: PartialShape<T> | undefined;
-}
-type SpringObjectTarget<T extends object> = PartialShape<T> | SpringObject<T> | SpringObjectWithOffset<T>;
-declare class SpringObject<in out T extends object> {
-  #private;
-  constructor(motions: MotionSet, value: T & Shape<T>, config?: ConfigShape<T>);
-  get target(): ReadonlyShape<T>;
-  set target(value: SpringObjectTarget<T>);
-  get value(): ReadonlyShape<T>;
-  set value(value: PartialShape<T>);
-  get velocity(): ReadonlyShape<T>;
-  set velocity(value: PartialShape<T>);
-  get config(): SpringConfig | null;
-  set config(value: ConfigShape<T>);
-  get timeRemaining(): number;
-  get isResting(): boolean;
-  get settled(): Promise<void>;
-  jumpTo(value: PartialShape<T>): void;
-  dispose(): void;
-  onUpdate(callback: () => void): () => void;
-  onStart(callback: () => void): () => void;
-  onStop(callback: () => void): () => void;
-  onDispose(callback: () => void): () => void;
-}
-//#endregion
-//#region src/ticker.d.ts
-interface TickerOptions {
-  readonly fps?: number | undefined;
-  readonly lagThreshold?: number | undefined;
-  readonly adjustedLag?: number | undefined;
-}
-//#endregion
-//#region src/system.d.ts
-interface SpringSystemOptions extends TickerOptions {
-  debug?: boolean | undefined;
-  reducedMotion?: 'user' | 'always' | 'never' | undefined;
-}
-interface SpringSystem {
-  createSpring(position: SpringPosition, config?: SpringConfig): Spring;
-  createSpringObject<T extends object>(value: T & Shape<T>, config?: ConfigShape<T>): SpringObject<T>;
-  advance(dt: number): void;
-  start(): void;
-  stop(): void;
-  readonly running: boolean;
-  readonly reducedMotion: boolean;
-  fps: number;
-  lagThreshold: number;
-  adjustedLag: number;
-}
-declare function createSpringSystem(options?: SpringSystemOptions): SpringSystem;
-//#endregion
-export { SpringOptions as _, ConfigShape as a, Shape as c, SpringObjectWithOffset as d, Spring as f, SpringConfig as g, SpringWithOffset as h, TickerOptions as i, SpringObject as l, SpringTarget as m, SpringSystemOptions as n, PartialShape as o, SpringPosition as p, createSpringSystem as r, ReadonlyShape as s, SpringSystem as t, SpringObjectTarget as u, SpringState as v, defineSpring as y };