DefinitelyTyped/types/d3-timer/index.d.ts
Nathan Shively-Sanders f0ce987bc1 Update project urls to match NPM url
Note that this *trivially* updates project urls by adding the NPM url to
the end, even when the urls are almost identical or the DT one is
outdated. I'll clean up the urls in a later commit.

This PR is unfinished! Please do not merge it yet.
2019-02-11 17:10:55 -08:00

77 lines
3.9 KiB
TypeScript

// Type definitions for d3JS d3-timer module 1.0
// Project: https://github.com/d3/d3-timer/, https://d3js.org/d3-timer
// Definitions by: Tom Wanzek <https://github.com/tomwanzek>
// Alex Ford <https://github.com/gustavderdrache>
// Boris Yankov <https://github.com/borisyankov>
// denisname <https://github.com/denisname>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
// Last module patch version validated against: 1.0.7
/**
* Returns the current time as defined by performance.now if available, and Date.now if not.
* The current time is updated at the start of a frame; it is thus consistent during the frame, and any timers scheduled during the same frame will be synchronized.
* If this method is called outside of a frame, such as in response to a user event, the current time is calculated and then fixed until the next frame,
* again ensuring consistent timing during event handling.
*/
export function now(): number;
export interface Timer {
/**
* Restart a timer with the specified callback and optional delay and time.
* This is equivalent to stopping this timer and creating a new timer with the specified arguments,
* although this timer retains the original invocation priority.
*
* @param callback A callback function to be invoked and passed in the apparent
* elapsed time since the timer became active in milliseconds.
* @param delay An optional numeric delay in milliseconds (default = 0) relative to time.
* @param time An optional time in milliseconds relative to which the delay is calculated (default = now).
*/
restart(callbackFn: (elapsed: number) => void, delay?: number, time?: number): void;
/**
* Stop the timer.
*/
stop(): void;
}
/**
* Schedules and returns a new timer, invoking the specified callback repeatedly until the timer is stopped.
* The callback is passed the (apparent) elapsed time since the timer became active.
*
* @param callback A callback function to be invoked and passed in the apparent
* elapsed time since the timer became active in milliseconds.
* @param delay An optional numeric delay in milliseconds (default = 0) relative to time.
* @param time An optional time in milliseconds relative to which the delay is calculated (default = now).
*/
export function timer(callback: (elapsed: number) => void, delay?: number, time?: number): Timer;
/**
* Immediately invoke any eligible timer callbacks.
*/
export function timerFlush(): void;
/**
* Schedules and returns a new timer, invoking the specified callback. The timer is stopped automatically
* on its first callback. The callback is passed the (apparent) elapsed time since the timer became active.
*
* @param callback A callback function to be invoked and passed in the apparent
* elapsed time since the timer became active in milliseconds.
* @param delay An optional numeric delay in milliseconds (default = 0) relative to time.
* @param time An optional time in milliseconds relative to which the delay is calculated (default = now).
*/
export function timeout(callback: (elapsed: number) => void, delay?: number, time?: number): Timer;
/**
* Schedules and returns a new timer, invoking the specified callback repeatedly every 'delay' milliseconds
* until the timer is stopped.
* The callback is passed the (apparent) elapsed time since the timer became active.
*
* @param callback A callback function to be invoked and passed in the apparent
* elapsed time since the timer became active in milliseconds.
* @param delay An optional numeric delay in milliseconds between repeat invocations of the callback.
* If not specified, the interval timer behaves like the regular timer.
* @param time An optional time in milliseconds relative to which the initial delay is calculated (default = now).
*/
export function interval(callback: (elapsed: number) => void, delay?: number, time?: number): Timer;