Fix some jsdoc path types

This commit is contained in:
ahocevar
2018-04-21 00:20:04 +02:00
parent 33ca22a4dc
commit 417dd85f83
36 changed files with 57 additions and 54 deletions

View File

@@ -59,7 +59,7 @@ inherits(CollectionEvent, Event);
* Collection as a whole.
*
* @constructor
* @extends {module:ol/Object~Object}
* @extends {module:ol/Object~BaseObject}
* @fires module:ol/Collection~CollectionEvent
* @param {Array.<T>=} opt_array Array.
* @param {module:ol/Collection~Options=} opt_options Collection options.

View File

@@ -18,7 +18,7 @@ import Style from './style/Style.js';
* Features can be styled individually with `setStyle`; otherwise they use the
* style of their vector layer.
*
* Note that attribute properties are set as {@link module:ol/Object~Object} properties on
* Note that attribute properties are set as {@link module:ol/Object~BaseObject} properties on
* the feature object, so they are observable, and have get/set accessors.
*
* Typically, a feature has a single geometry property. You can set the
@@ -52,7 +52,7 @@ import Style from './style/Style.js';
* ```
*
* @constructor
* @extends {module:ol/Object~Object}
* @extends {module:ol/Object~BaseObject}
* @param {module:ol/geom/Geometry~Geometry|Object.<string, *>=} opt_geometryOrProperties
* You may pass a Geometry object directly, or an object literal containing
* properties. If you pass an object literal, you may include a Geometry

View File

@@ -45,7 +45,7 @@ import {get as getProjection, getTransformFromProjections, identityTransform} fr
*
* @fires error
* @constructor
* @extends {module:ol/Object~Object}
* @extends {module:ol/Object~BaseObject}
* @param {module:ol/Geolocation~Options=} opt_options Options.
* @api
*/

View File

@@ -8,11 +8,17 @@ import {createCanvasContext2D} from './dom.js';
import {listenOnce, unlistenByKey} from './events.js';
import EventType from './events/EventType.js';
/**
* @typedef {function(new: module:ol/ImageTile~ImageTile, module:ol/tilecoord~TileCoord,
* module:ol/TileState, string, ?string, ol.TileLoadFunctionType)} TileClass
* @api
*/
/**
* @constructor
* @extends {module:ol/Tile~Tile}
* @param {module:ol/tilecoord~TileCoord} tileCoord Tile coordinate.
* @param {module:ol/TileState~TileState} state State.
* @param {module:ol/TileState} state State.
* @param {string} src Image source URI.
* @param {?string} crossOrigin Cross origin.
* @param {module:ol/Tile~LoadFunction} tileLoadFunction Tile load function.

View File

@@ -10,7 +10,7 @@ import {assign} from './obj.js';
/**
* @classdesc
* Events emitted by {@link module:ol/Object~Object} instances are instances of
* Events emitted by {@link module:ol/Object~BaseObject} instances are instances of
* this type.
*
* @param {string} type The event type.
@@ -71,7 +71,7 @@ inherits(ObjectEvent, Event);
* `object.set('prop', 'value')`, and retrieve that with `object.get('prop')`.
* You can listen for changes on that property value with
* `object.on('change:prop', listener)`. You can get a list of all
* properties with {@link module:ol/Object~Object#getProperties}.
* properties with {@link module:ol/Object~BaseObject#getProperties}.
*
* Note that the observable properties are separate from standard JS properties.
* You can, for example, give your map object a title with

View File

@@ -94,7 +94,7 @@ const Property = {
* map.addOverlay(popup);
*
* @constructor
* @extends {module:ol/Object~Object}
* @extends {module:ol/Object~BaseObject}
* @param {module:ol/Overlay~Options} options Overlay options.
* @api
*/

View File

@@ -132,7 +132,7 @@ import {create as createTransform, apply as applyTransform} from './transform.js
/**
* @constructor
* @extends {module:ol/Object~Object}
* @extends {module:ol/Object~BaseObject}
* @param {module:ol/PluggableMap~MapOptions} options Map options.
* @fires module:ol/MapBrowserEvent~MapBrowserEvent
* @fires module:ol/MapEvent~MapEvent

View File

@@ -16,7 +16,6 @@ import EventType from './events/EventType.js';
* @api
*/
/**
* {@link module:ol/source/Tile~Tile} sources use a function of this type to get
* the url that provides a tile for a given tile coordinate.
@@ -49,7 +48,7 @@ import EventType from './events/EventType.js';
* @abstract
* @extends {module:ol/events/EventTarget~EventTarget}
* @param {module:ol/tilecoord~TileCoord} tileCoord Tile coordinate.
* @param {module:ol/TileState~TileState} state State.
* @param {module:ol/TileState} state State.
* @param {module:ol/Tile~Options=} opt_options Tile options.
*/
const Tile = function(tileCoord, state, opt_options) {
@@ -64,7 +63,7 @@ const Tile = function(tileCoord, state, opt_options) {
/**
* @protected
* @type {module:ol/TileState~TileState}
* @type {module:ol/TileState}
*/
this.state = state;
@@ -190,14 +189,14 @@ Tile.prototype.getTileCoord = function() {
/**
* @return {module:ol/TileState~TileState} State.
* @return {module:ol/TileState} State.
*/
Tile.prototype.getState = function() {
return this.state;
};
/**
* @param {module:ol/TileState~TileState} state State.
* @param {module:ol/TileState} state State.
*/
Tile.prototype.setState = function(state) {
this.state = state;

View File

@@ -24,7 +24,7 @@ import {loadFeaturesXhr} from './featureloader.js';
* @constructor
* @extends {module:ol/Tile~Tile}
* @param {module:ol/tilecoord~TileCoord} tileCoord Tile coordinate.
* @param {module:ol/TileState~TileState} state State.
* @param {module:ol/TileState} state State.
* @param {number} sourceRevision Source revision.
* @param {module:ol/format/Feature~FeatureFormat} format Feature format.
* @param {module:ol/Tile~LoadFunction} tileLoadFunction Tile load function.
@@ -35,7 +35,7 @@ import {loadFeaturesXhr} from './featureloader.js';
* @param {Object.<string, module:ol/VectorTile~VectorTile>} sourceTiles Source tiles.
* @param {number} pixelRatio Pixel ratio.
* @param {module:ol/proj/Projection~Projection} projection Projection.
* @param {function(new: module:ol/VectorTile~VectorTile, module:ol/tilecoord~TileCoord, module:ol/TileState~TileState, string,
* @param {function(new: module:ol/VectorTile~VectorTile, module:ol/tilecoord~TileCoord, module:ol/TileState, string,
* module:ol/format/Feature~FeatureFormat, module:ol/Tile~LoadFunction)} tileClass Class to
* instantiate for source tiles.
* @param {function(this: module:ol/source/VectorTile~VectorTile, module:ol/events/Event~Event)} handleTileChange

View File

@@ -5,11 +5,17 @@ import {getUid, inherits} from './index.js';
import Tile from './Tile.js';
import TileState from './TileState.js';
/**
* @typedef {function(new: ol.VectorTile, module:ol/tilecoord~TileCoord,
* module:ol/TileState, string, ?string, ol.TileLoadFunctionType)} TileClass
* @api
*/
/**
* @constructor
* @extends {module:ol/Tile~Tile}
* @param {module:ol/tilecoord~TileCoord} tileCoord Tile coordinate.
* @param {module:ol/TileState~TileState} state State.
* @param {module:ol/TileState} state State.
* @param {string} src Data source url.
* @param {module:ol/format/Feature~FeatureFormat} format Feature format.
* @param {module:ol/Tile~LoadFunction} tileLoadFunction Tile load function.

View File

@@ -225,7 +225,7 @@ const DEFAULT_MIN_ZOOM = 0;
* default the center is not constrained at all.
*
* @constructor
* @extends {module:ol/Object~Object}
* @extends {module:ol/Object~BaseObject}
* @param {module:ol/View~ViewOptions=} opt_options View options.
* @api
*/

View File

@@ -106,7 +106,7 @@ inherits(DragBoxEvent, Event);
* This interaction is only supported for mouse devices.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @fires module:ol/interaction/DragBox~DragBoxEvent
* @param {module:ol/interaction/DragBox~Options=} opt_options Options.
* @api

View File

@@ -24,7 +24,7 @@ import PointerInteraction, {centroid as centroidFromPointers} from '../interacti
* Allows the user to pan the map by dragging the map.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @param {module:ol/interaction/DragPan~Options=} opt_options Options.
* @api
*/

View File

@@ -29,7 +29,7 @@ import PointerInteraction from '../interaction/Pointer.js';
* This interaction is only supported for mouse devices.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @param {module:ol/interaction/DragRotate~Options=} opt_options Options.
* @api
*/

View File

@@ -30,7 +30,7 @@ import PointerInteraction from '../interaction/Pointer.js';
* And this interaction is not included in the default interactions.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @param {module:ol/interaction/DragRotateAndZoom~Options=} opt_options Options.
* @api
*/

View File

@@ -156,7 +156,7 @@ inherits(DrawEvent, Event);
* Interaction for drawing feature geometries.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @fires module:ol/interaction/Draw~DrawEvent
* @param {module:ol/interaction/Draw~Options} options Options.
* @api

View File

@@ -78,7 +78,7 @@ inherits(ExtentInteractionEvent, Event);
* This interaction is only supported for mouse devices.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @fires module:ol/interaction/Extent~Event
* @param {module:ol/interaction/Extent~Options=} opt_options Options.
* @api

View File

@@ -33,7 +33,7 @@ import {clamp} from '../math.js';
*
* @constructor
* @param {module:ol/interaction/Interaction~InteractionOptions} options Options.
* @extends {module:ol/Object~Object}
* @extends {module:ol/Object~BaseObject}
* @api
*/
const Interaction = function(options) {

View File

@@ -136,7 +136,7 @@ inherits(ModifyEvent, Event);
* for deletion, use the `deleteCondition` option.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @param {module:ol/interaction/Modify~Options} options Options.
* @fires module:ol/interaction/Modify~ModifyEvent
* @api

View File

@@ -23,7 +23,7 @@ import {disable} from '../rotationconstraint.js';
* on a touch screen.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @param {module:ol/interaction/PinchRotate~Options=} opt_options Options.
* @api
*/

View File

@@ -22,7 +22,7 @@ import PointerInteraction, {centroid as centroidFromPointers} from '../interacti
* on a touch screen.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @param {module:ol/interaction/PinchZoom~Options=} opt_options Options.
* @api
*/

View File

@@ -64,7 +64,7 @@ import RBush from '../structs/RBush.js';
* });
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @param {module:ol/interaction/Snap~Options=} opt_options Options.
* @api
*/

View File

@@ -92,7 +92,7 @@ inherits(TranslateEvent, Event);
* Interaction for translating (moving) features.
*
* @constructor
* @extends {module:ol/interaction/Pointer~Pointer}
* @extends {module:ol/interaction/Pointer~PointerInteraction}
* @fires module:ol/interaction/Translate~TranslateEvent
* @param {module:ol/interaction/Translate~Options=} opt_options Options.
* @api

View File

@@ -28,7 +28,7 @@ import {assign} from '../obj.js';
* Abstract base class; normally only used for creating subclasses and not
* instantiated in apps.
* Note that with `module:ol/layer/Base~BaseLayer` and all its subclasses, any property set in
* the options is set as a {@link module:ol/Object~BaseObject} property on the layer object, so
* the options is set as a {@link module:ol/Object~BaseObject property on the layer object, so
* is observable, and has get/set accessors.
*
* @constructor

View File

@@ -58,7 +58,7 @@ const DEFAULT_GRADIENT = ['#00f', '#0ff', '#0f0', '#ff0', '#f00'];
/**
* @classdesc
* Layer for rendering vector data as a heatmap.
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject}
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject
* property on the layer object; for example, setting `title: 'My Title'` in the
* options means that `title` is observable, and has get/set accessors.
*

View File

@@ -30,7 +30,7 @@ import Layer from '../layer/Layer.js';
* @classdesc
* Server-rendered images that are available for arbitrary extents and
* resolutions.
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject}
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject
* property on the layer object; for example, setting `title: 'My Title'` in the
* options means that `title` is observable, and has get/set accessors.
*

View File

@@ -35,7 +35,7 @@ import {assign} from '../obj.js';
* @classdesc
* For layer sources that provide pre-rendered, tiled images in grids that are
* organized by zoom levels for specific resolutions.
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject}
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject
* property on the layer object; for example, setting `title: 'My Title'` in the
* options means that `title` is observable, and has get/set accessors.
*

View File

@@ -64,7 +64,7 @@ const Property = {
/**
* @classdesc
* Vector data that is rendered client-side.
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject}
* Note that any property set in the options is set as a {@link }
* property on the layer object; for example, setting `title: 'My Title'` in the
* options means that `title` is observable, and has get/set accessors.
*

View File

@@ -71,7 +71,7 @@ import {assign} from '../obj.js';
/**
* @classdesc
* Layer for vector tile data that is rendered client-side.
* Note that any property set in the options is set as a {@link module:ol/Object~BaseObject}
* Note that any property set in the options is set as a {@link }
* property on the layer object; for example, setting `title: 'My Title'` in the
* options means that `title` is observable, and has get/set accessors.
*

View File

@@ -41,7 +41,7 @@ const MapRenderer = function(map) {
/**
* @private
* @type {Array.<module:ol/renderer/Layer~LayerRenderer}
* @type {Array.<module:ol/renderer/Layer~LayerRenderer>}
*/
this.layerRendererConstructors_ = [];

View File

@@ -27,9 +27,7 @@ import {getForProjection as getTileGridForProjection} from '../tilegrid.js';
* @property {boolean} [reprojectionErrorThreshold=0.5] Maximum allowed reprojection error (in pixels).
* Higher values can increase reprojection performance, but decrease precision.
* @property {module:ol/source/State~State} [state] Source state.
* @property {function(new: module:ol/ImageTile~ImageTile, module:ol/tilecoord~TileCoord,
* module:ol/TileState~TileState, string, ?string,
* ol.TileLoadFunctionType)} [tileClass] Class used to instantiate image tiles.
* @property {module:ol/ImageTile~TileClass} [tileClass] Class used to instantiate image tiles.
* Default is {@link module:ol/ImageTile~ImageTile}.
* @property {module:ol/tilegrid/TileGrid~TileGrid} [tileGrid] Tile grid.
* @property {ol.TileLoadFunctionType} [tileLoadFunction] Optional function to load a tile given a URL. The default is
@@ -95,7 +93,7 @@ const TileImage = function(options) {
/**
* @protected
* @type {function(new: module:ol/ImageTile~ImageTile, module:ol/tilecoord~TileCoord, module:ol/TileState~TileState, string,
* @type {function(new: module:ol/ImageTile~ImageTile, module:ol/tilecoord~TileCoord, module:ol/TileState, string,
* ?string, module:ol/Tile~LoadFunction, module:ol/Tile~Options=)}
*/
this.tileClass = options.tileClass !== undefined ?

View File

@@ -21,7 +21,7 @@ import {createXYZ, extentFromProjection} from '../tilegrid.js';
* @constructor
* @extends {module:ol/Tile~Tile}
* @param {module:ol/tilecoord~TileCoord} tileCoord Tile coordinate.
* @param {module:ol/TileState~TileState} state State.
* @param {module:ol/TileState} state State.
* @param {string} src Image source URI.
* @param {module:ol/extent~Extent} extent Extent of the tile.
* @param {boolean} preemptive Load the tile when visible (before it's needed).

View File

@@ -43,10 +43,8 @@ import {appendParams} from '../uri.js';
* @property {module:ol/proj~ProjectionLike} projection Projection.
* @property {boolean} [reprojectionErrorThreshold=0.5] Maximum allowed reprojection error (in pixels).
* Higher values can increase reprojection performance, but decrease precision.
* @property {function(new: module:ol/ImageTile~ImageTile, module:ol/tilecoord~TileCoord,
* module:ol/TileState~TileState, string, ?string,
* ol.TileLoadFunctionType)} [tileClass] Class used to instantiate image tiles.
* Default is {@link module:ol/ImageTile~ImageTile}.
* @property {module:ol/ImageTile~TileClass} [tileClass] Class used to instantiate image tiles.
* Default is {@link module:ol/ImageTile~TileClass}.
* @property {module:ol/tilegrid/TileGrid~TileGrid} [tileGrid] Tile grid. Base this on the resolutions,
* tilesize and extent supported by the server.
* If this is not defined, a default grid will be used: if there is a projection

View File

@@ -21,9 +21,7 @@ import {createXYZ, extentFromProjection, createForProjection} from '../tilegrid.
* stroke operations.
* @property {module:ol/proj~ProjectionLike} projection Projection.
* @property {module:ol/source/State~State} [state] Source state.
* @property {function(new: ol.VectorTile, module:ol/tilecoord~TileCoord,
* module:ol/TileState~TileState, string, ?string,
* ol.TileLoadFunctionType)} [tileClass] Class used to instantiate image tiles.
* @property {module:ol/VectorTile~TileClass} [tileClass] Class used to instantiate image tiles.
* Default is {@link ol.VectorTile}.
* @property {module:ol/tilegrid/TileGrid~TileGrid} [tileGrid] Tile grid.
* @property {ol.TileLoadFunctionType} [tileLoadFunction]
@@ -118,7 +116,7 @@ const VectorTile = function(options) {
/**
* @protected
* @type {function(new: module:ol/VectorTile~VectorTile, module:ol/tilecoord~TileCoord, module:ol/TileState~TileState, string,
* @type {function(new: module:ol/VectorTile~VectorTile, module:ol/tilecoord~TileCoord, module:ol/TileState, string,
* module:ol/format/Feature~FeatureFormat, module:ol/Tile~LoadFunction)}
*/
this.tileClass = options.tileClass ? options.tileClass : Tile;

View File

@@ -27,9 +27,7 @@ import {appendParams} from '../uri.js';
* @property {ol.source.WMTSRequestEncoding|string} [requestEncoding='KVP'] Request encoding.
* @property {string} layer Layer name as advertised in the WMTS capabilities.
* @property {string} style Style name as advertised in the WMTS capabilities.
* @property {function(new: module:ol/ImageTile~ImageTile, module:ol/tilecoord~TileCoord,
* module:ol/TileState~TileState, string, ?string,
* ol.TileLoadFunctionType)} [tileClass] Class used to instantiate image tiles. Default is {@link module:ol/ImageTile~ImageTile}.
* @property {module:ol/ImageTile~TileClass} [tileClass] Class used to instantiate image tiles. Default is {@link module:ol/ImageTile~ImageTile}.
* @property {number} [tilePixelRatio=1] The pixel ratio used by the tile service.
* For example, if the tile service advertizes 256px by 256px tiles but actually sends 512px
* by 512px images (for retina/hidpi devices) then `tilePixelRatio`

View File

@@ -28,7 +28,7 @@ const TierSizeCalculation = {
* @extends {module:ol/ImageTile~ImageTile}
* @param {module:ol/tilegrid/TileGrid~TileGrid} tileGrid TileGrid that the tile belongs to.
* @param {module:ol/tilecoord~TileCoord} tileCoord Tile coordinate.
* @param {module:ol/TileState~TileState} state State.
* @param {module:ol/TileState} state State.
* @param {string} src Image source URI.
* @param {?string} crossOrigin Cross origin.
* @param {module:ol/Tile~LoadFunction} tileLoadFunction Tile load function.