vhad/DefinitelyTyped
1
0
Fork 0
mirror of https://github.com/gosticks/DefinitelyTyped.git synced 2026-06-28 14:20:12 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #23322 from hasparus/master

Browse Source 
@types/matter-js - Add Matter.use and Matter.Plugin.
This commit is contained in:
Daniel Rosenwasser
2018-02-12 18:13:07 -08:00
committed by GitHub
parent 58ae4289c1 61a6251d03
commit 3dff69f6cc
2 changed files with 158 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

153
types/matter-js/index.d.ts vendored
View File

@@ -1,13 +1,24 @@
// Type definitions for Matter.js - 0.9.1
// Type definitions for Matter.js - 0.10.0
// Project: https://github.com/liabru/matter-js
// Definitions by: Ivane Gegia <https://twitter.com/ivanegegia>,
// David Asmuth <https://github.com/piranha771>
// David Asmuth <https://github.com/piranha771>,
// Piotr Pietrzak <https://github.com/hasparus>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
export = Matter;
export as namespace Matter;
declare namespace Matter {
/**
* Installs the given plugins on the `Matter` namespace.
* This is a short-hand for `Plugin.use`, see it for more information.
* Call this function once at the start of your code, with all of the plugins you wish to install as arguments.
* Avoid calling this function multiple times unless you intend to manually control installation order.
* @method use
* @param ...plugin {Function} The plugin(s) to install on `base` (multi-argument).
*/
export function use(...plugins: (Plugin | string)[]): void;
/**
* The `Matter.Axes` module contains methods for creating and manipulating sets of axes.
*
@@ -3315,4 +3326,142 @@ declare namespace Matter {
static trigger(object: any, eventNames: string, event?: (e: any) => void): void;
}
type Dependency = {name: string, range: string}
| {name: string, version: string}
| string;
export class Plugin {
name: string;
version: string;
install: () => void;
for?: string;
/**
* Registers a plugin object so it can be resolved later by name.
* @method register
* @param plugin {} The plugin to register.
* @return {object} The plugin.
*/
static register(plugin: Plugin): Plugin;
/**
* Resolves a dependency to a plugin object from the registry if it exists.
* The `dependency` may contain a version, but only the name matters when resolving.
* @method resolve
* @param dependency {string} The dependency.
* @return {object} The plugin if resolved, otherwise `undefined`.
*/
static resolve(dependency: string): Plugin | undefined;
/**
* Returns `true` if the object meets the minimum standard to be considered a plugin.
* This means it must define the following properties:
* - `name`
* - `version`
* - `install`
* @method isPlugin
* @param obj {} The obj to test.
* @return {boolean} `true` if the object can be considered a plugin otherwise `false`.
*/
static isPlugin(obj: {}): boolean;
/**
* Returns a pretty printed plugin name and version.
* @method toString
* @param plugin {} The plugin.
* @return {string} Pretty printed plugin name and version.
*/
static toString(plugin: string | Plugin): string;
/**
* Returns `true` if `plugin.for` is applicable to `module` by comparing against `module.name` and `module.version`.
* If `plugin.for` is not specified then it is assumed to be applicable.
* The value of `plugin.for` is a string of the format `'module-name'` or `'module-name@version'`.
* @method isFor
* @param plugin {} The plugin.
* @param module {} The module.
* @return {boolean} `true` if `plugin.for` is applicable to `module`, otherwise `false`.
*/
static isFor(plugin: Plugin, module: {name?: string, [_: string]: any}): boolean;
/**
* Installs the plugins by calling `plugin.install` on each plugin specified in `plugins` if passed, otherwise `module.uses`.
* For installing plugins on `Matter` see the convenience function `Matter.use`.
* Plugins may be specified either by their name or a reference to the plugin object.
* Plugins themselves may specify further dependencies, but each plugin is installed only once.
* Order is important, a topological sort is performed to find the best resulting order of installation.
* This sorting attempts to satisfy every dependency's requested ordering, but may not be exact in all cases.
* This function logs the resulting status of each dependency in the console, along with any warnings.
* - A green tick ✅ indicates a dependency was resolved and installed.
* - An orange diamond 🔶 indicates a dependency was resolved but a warning was thrown for it or one if its dependencies.
* - A red cross ❌ indicates a dependency could not be resolved.
* Avoid calling this function multiple times on the same module unless you intend to manually control installation order.
* @method use
* @param module {} The module install plugins on.
* @param [plugins=module.uses] {} The plugins to install on module (optional, defaults to `module.uses`).
*/
static use(
module: {uses?: (Plugin | string)[]; [_: string]: any},
plugins: (Plugin | string)[]
): void;
/**
* Recursively finds all of a module's dependencies and returns a flat dependency graph.
* @method dependencies
* @param module {} The module.
* @return {object} A dependency graph.
*/
static dependencies(
module: Dependency,
tracked?: {[_: string]: string[]}
): {[_: string]: string[]} | string | undefined
/**
* Parses a dependency string into its components.
* The `dependency` is a string of the format `'module-name'` or `'module-name@version'`.
* See documentation for `Plugin.versionParse` for a description of the format.
* This function can also handle dependencies that are already resolved (e.g. a module object).
* @method dependencyParse
* @param dependency {string} The dependency of the format `'module-name'` or `'module-name@version'`.
* @return {object} The dependency parsed into its components.
*/
static dependencyParse(dependency: Dependency) : {name: string, range: string};
/**
* Parses a version string into its components.
* Versions are strictly of the format `x.y.z` (as in [semver](http://semver.org/)).
* Versions may optionally have a prerelease tag in the format `x.y.z-alpha`.
* Ranges are a strict subset of [npm ranges](https://docs.npmjs.com/misc/semver#advanced-range-syntax).
* Only the following range types are supported:
* - Tilde ranges e.g. `~1.2.3`
* - Caret ranges e.g. `^1.2.3`
* - Exact version e.g. `1.2.3`
* - Any version `*`
* @method versionParse
* @param range {string} The version string.
* @return {object} The version range parsed into its components.
*/
static versionParse(range: string) : {
isRange: boolean,
version: string,
range: string,
operator: string
parts: number[],
prerelease: string,
number: number
};
/**
* Returns `true` if `version` satisfies the given `range`.
* See documentation for `Plugin.versionParse` for a description of the format.
* If a version or range is not specified, then any version (`*`) is assumed to satisfy.
* @method versionSatisfies
* @param version {string} The version string.
* @param range {string} The range string.
* @return {boolean} `true` if `version` satisfies `range`, otherwise `false`.
*/
static versionSatisfies(version: string, range: string): boolean;
}
}

10
types/matter-js/matter-js-tests.ts
View File

@@ -6,9 +6,13 @@ var Engine = Matter.Engine,
Composites = Matter.Composites,
Constraint = Matter.Constraint,
Events = Matter.Events,
Query = Matter.Query;
Query = Matter.Query,
Plugin = Matter.Plugin;
Matter.use('matter-attractors');
Plugin.use(Matter, ["matter-wrap"]);
var engine = Engine.create();
//Bodies