ol-stac 0.0.0 → 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/events/ErrorEvent.d.ts +17 -0
- package/events/ErrorEvent.d.ts.map +1 -0
- package/{src/ol/events → events}/ErrorEvent.js +9 -11
- package/events/ErrorEvent.js.map +1 -0
- package/layer/STAC.d.ts +422 -0
- package/layer/STAC.d.ts.map +1 -0
- package/layer/STAC.js +698 -0
- package/layer/STAC.js.map +1 -0
- package/layer/stacUtil.d.ts +46 -0
- package/layer/stacUtil.d.ts.map +1 -0
- package/layer/stacUtil.js +154 -0
- package/layer/stacUtil.js.map +1 -0
- package/package.json +3 -85
- package/source/GeoTIFF2.d.ts +35 -0
- package/source/GeoTIFF2.d.ts.map +1 -0
- package/{src/ol/source → source}/GeoTIFF2.js +9 -16
- package/source/GeoTIFF2.js.map +1 -0
- package/.eslintignore +0 -2
- package/.github/workflows/deploy.yml +0 -67
- package/.github/workflows/publish.yml +0 -32
- package/.github/workflows/release.yml +0 -21
- package/.github/workflows/test.yml +0 -85
- package/CHANGELOG.md +0 -14
- package/DEVELOPING.md +0 -104
- package/config/jsdoc/api/conf.json +0 -38
- package/config/jsdoc/api/index.md +0 -1
- package/config/jsdoc/api/readme.md +0 -65
- package/config/jsdoc/api/template/README.md +0 -3
- package/config/jsdoc/api/template/publish.js +0 -743
- package/config/jsdoc/api/template/static/scripts/linenumber.js +0 -11
- package/config/jsdoc/api/template/static/scripts/main.js +0 -305
- package/config/jsdoc/api/template/static/scripts/prettify/Apache-License-2.0.txt +0 -202
- package/config/jsdoc/api/template/static/scripts/prettify/lang-css.js +0 -2
- package/config/jsdoc/api/template/static/scripts/prettify/prettify.js +0 -28
- package/config/jsdoc/api/template/static/styles/carbon.css +0 -65
- package/config/jsdoc/api/template/static/styles/jaguar.css +0 -512
- package/config/jsdoc/api/template/static/styles/prettify-jsdoc.css +0 -111
- package/config/jsdoc/api/template/static/styles/prettify-tomorrow.css +0 -132
- package/config/jsdoc/api/template/static/theme +0 -1
- package/config/jsdoc/api/template/tmpl/container.tmpl +0 -205
- package/config/jsdoc/api/template/tmpl/details.tmpl +0 -84
- package/config/jsdoc/api/template/tmpl/example.tmpl +0 -2
- package/config/jsdoc/api/template/tmpl/examples.tmpl +0 -16
- package/config/jsdoc/api/template/tmpl/exceptions.tmpl +0 -30
- package/config/jsdoc/api/template/tmpl/layout.tmpl +0 -92
- package/config/jsdoc/api/template/tmpl/mainpage.tmpl +0 -14
- package/config/jsdoc/api/template/tmpl/members.tmpl +0 -38
- package/config/jsdoc/api/template/tmpl/method.tmpl +0 -132
- package/config/jsdoc/api/template/tmpl/navigation.tmpl +0 -59
- package/config/jsdoc/api/template/tmpl/observables.tmpl +0 -39
- package/config/jsdoc/api/template/tmpl/params.tmpl +0 -109
- package/config/jsdoc/api/template/tmpl/properties.tmpl +0 -85
- package/config/jsdoc/api/template/tmpl/returns.tmpl +0 -72
- package/config/jsdoc/api/template/tmpl/source.tmpl +0 -8
- package/config/jsdoc/api/template/tmpl/stability.tmpl +0 -7
- package/config/jsdoc/api/template/tmpl/tutorial.tmpl +0 -19
- package/config/jsdoc/api/template/tmpl/type.tmpl +0 -7
- package/config/jsdoc/info/conf.json +0 -22
- package/config/jsdoc/info/publish.js +0 -175
- package/config/jsdoc/package.json +0 -4
- package/config/jsdoc/plugins/api.cjs +0 -181
- package/config/jsdoc/plugins/default-export.cjs +0 -35
- package/config/jsdoc/plugins/define-plugin.cjs +0 -33
- package/config/jsdoc/plugins/events.cjs +0 -39
- package/config/jsdoc/plugins/inline-options.cjs +0 -102
- package/config/jsdoc/plugins/markdown.cjs +0 -119
- package/config/jsdoc/plugins/observable.cjs +0 -69
- package/config/jsdoc/plugins/virtual-plugin.cjs +0 -16
- package/config/rollup-full-build.js +0 -24
- package/config/tsconfig-build.json +0 -25
- package/examples/.eslintrc +0 -29
- package/examples/index.html +0 -100
- package/examples/index.js +0 -109
- package/examples/planetary-computer.html +0 -14
- package/examples/planetary-computer.js +0 -53
- package/examples/resources/Jugl.js +0 -15
- package/examples/resources/common.js +0 -111
- package/examples/stac-collection-webmaplinks.html +0 -9
- package/examples/stac-collection-webmaplinks.js +0 -55
- package/examples/stac-item-from-object.html +0 -9
- package/examples/stac-item-from-object.js +0 -102
- package/examples/stac-item-tileserver.html +0 -9
- package/examples/stac-item-tileserver.js +0 -34
- package/examples/stac-item.html +0 -9
- package/examples/stac-item.js +0 -45
- package/examples/stac-itemcollection.html +0 -11
- package/examples/stac-itemcollection.js +0 -39
- package/examples/templates/example.html +0 -206
- package/examples/templates/readme.md +0 -3
- package/examples/webpack/config.mjs +0 -69
- package/examples/webpack/example-builder.js +0 -410
- package/site/build.js +0 -26
- package/site/layouts/default.hbs +0 -78
- package/site/src/doc/faq.md +0 -8
- package/site/src/doc/index.md +0 -22
- package/site/src/doc/quickstart.md +0 -121
- package/site/src/doc/tutorials/index.md +0 -8
- package/site/src/download/index.hbs +0 -62
- package/site/src/favicon.ico +0 -0
- package/site/src/index.hbs +0 -71
- package/site/src/theme/index.css +0 -26
- package/site/src/theme/site.css +0 -531
- package/src/ol/layer/STAC.js +0 -780
- package/src/ol/layer/stacUtil.js +0 -169
- package/tasks/.eslintrc +0 -5
- package/tasks/build-website.sh +0 -90
- package/tasks/create-release.js +0 -107
- package/tasks/generate-index.js +0 -125
- package/tasks/generate-info.js +0 -189
- package/tasks/get-latest-release.js +0 -36
- package/tasks/newest-tag.js +0 -52
- package/tasks/prepare-package.js +0 -46
- package/tasks/publish.sh +0 -90
- package/test/README.md +0 -56
- package/test/browser/.eslintrc +0 -14
- package/test/browser/karma.config.cjs +0 -94
- package/test/browser/spec/ol/layer/STAC.test.js +0 -18
- package/test/browser/test-extensions.js +0 -419
- package/tsconfig.json +0 -62
package/CHANGELOG.md
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
All notable changes to this project will be documented in this file.
|
|
3
|
-
|
|
4
|
-
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
5
|
-
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
|
-
|
|
7
|
-
## [Unreleased]
|
|
8
|
-
|
|
9
|
-
## [1.0.0-beta.1] - 2023-08-22
|
|
10
|
-
|
|
11
|
-
- First release
|
|
12
|
-
|
|
13
|
-
[Unreleased]: <https://github.com/stac-extensions/contacts/compare/v1.0.0-beta.1...HEAD>
|
|
14
|
-
[1.0.0-beta.1]: <https://github.com/stac-extensions/contacts/tree/v1.0.0-beta.1>
|
package/DEVELOPING.md
DELETED
|
@@ -1,104 +0,0 @@
|
|
|
1
|
-
# Developing
|
|
2
|
-
|
|
3
|
-
## Setting up development environment
|
|
4
|
-
|
|
5
|
-
You will start by [forking](https://github.com/m-mohr/ol-stac/fork) the OL STAC repository.
|
|
6
|
-
|
|
7
|
-
### Installing dependencies
|
|
8
|
-
|
|
9
|
-
The minimum requirements are:
|
|
10
|
-
|
|
11
|
-
* Git
|
|
12
|
-
* [Node.js](https://nodejs.org/) (version 16 and above)
|
|
13
|
-
|
|
14
|
-
The executables `git` and `node` should be in your `PATH`.
|
|
15
|
-
|
|
16
|
-
To install the project dependencies run
|
|
17
|
-
|
|
18
|
-
```shell
|
|
19
|
-
npm install
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
## Style guidelines
|
|
24
|
-
|
|
25
|
-
We use [ESLint](https://eslint.org/) rules to ensure a consistent coding style and catch potential bugs. ESLint and the rules used by the project are installed as part of the development dependencies in the step above – so you don't need to have any additional executables installed globally.
|
|
26
|
-
|
|
27
|
-
When you submit a pull request, the styling rules are enforced by running the `npm run lint` task. This happens as part of an automated workflow, so you don't need to run it yourself. However, it can be useful to run the `npm run lint` task before submitting a pull request so that you can fix any styling issues ahead of time.
|
|
28
|
-
|
|
29
|
-
The best way to conform with the style guidelines is to configure your editor to detect the ESLint configuration from the repository's `package.json` file. See the [ESLint integration documentation](https://eslint.org/docs/latest/use/integrations) for details on configuring your editor. If you don't already have a preferred editor that is capable of running ESLint rules, we recommend using [VS Code](https://code.visualstudio.com/) with the [ESLint plugin](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint).
|
|
30
|
-
|
|
31
|
-
In addition to having your editor warn you when the style guidelines are not being followed, you can set things up so many of the violations are automatically fixed. This saves you from having to think about tedious things like spacing and whitespace while developing. Using the ESLint plugin for VS Code, you can add the following to your settings to automatically fix issues when you save a file:
|
|
32
|
-
|
|
33
|
-
```json
|
|
34
|
-
{
|
|
35
|
-
"editor.codeActionsOnSave": {
|
|
36
|
-
"source.fixAll": true
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
## Running examples
|
|
43
|
-
|
|
44
|
-
To run the examples you first need to start the dev server:
|
|
45
|
-
|
|
46
|
-
```shell
|
|
47
|
-
npm run serve-examples
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Then, load <http://localhost:8080/> in your browser.
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
## Running tests
|
|
54
|
-
|
|
55
|
-
To run the tests once:
|
|
56
|
-
|
|
57
|
-
```shell
|
|
58
|
-
npm test
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
To run the tests continuously during development:
|
|
62
|
-
|
|
63
|
-
```shell
|
|
64
|
-
npm run karma
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
## Adding examples
|
|
69
|
-
|
|
70
|
-
Adding functionality often implies adding one or several examples. This
|
|
71
|
-
section provides explanations related to adding examples.
|
|
72
|
-
|
|
73
|
-
The examples are located in the `examples` directory. Adding a new example
|
|
74
|
-
implies creating two or three files in this directory, an `.html` file, a `.js`
|
|
75
|
-
file, and, optionally, a `.css` file.
|
|
76
|
-
|
|
77
|
-
You can use `simple.js` and `simple.html` as templates for new examples.
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
## Linking Package
|
|
81
|
-
|
|
82
|
-
The `ol-stac` package is published from the `build/ol` folder of the `ol-stac` repo.
|
|
83
|
-
|
|
84
|
-
After you've cloned the `ol-stac` repo locally run the `npm build-package` to prepare the build then use the `npm link` command to connect it your project.
|
|
85
|
-
|
|
86
|
-
Below is an example of how to build and link it to `sample-project`.
|
|
87
|
-
|
|
88
|
-
```shell
|
|
89
|
-
cd ol-stac
|
|
90
|
-
npm run build-package
|
|
91
|
-
cd build/ol
|
|
92
|
-
npm link
|
|
93
|
-
cd /sample-project
|
|
94
|
-
npm link ol-stac
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
To remove the link run the following commands
|
|
98
|
-
|
|
99
|
-
```shell
|
|
100
|
-
cd sample-project
|
|
101
|
-
npm unlink --no-save ol-stac
|
|
102
|
-
cd ../ol-stac
|
|
103
|
-
npm unlink
|
|
104
|
-
```
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"opts": {
|
|
3
|
-
"recurse": true,
|
|
4
|
-
"template": "config/jsdoc/api/template"
|
|
5
|
-
},
|
|
6
|
-
"tags": {
|
|
7
|
-
"allowUnknownTags": true
|
|
8
|
-
},
|
|
9
|
-
"source": {
|
|
10
|
-
"includePattern": ".+\\.js$",
|
|
11
|
-
"excludePattern": "(^|\\/|\\\\)_",
|
|
12
|
-
"include": [
|
|
13
|
-
"src/ol"
|
|
14
|
-
]
|
|
15
|
-
},
|
|
16
|
-
"plugins": [
|
|
17
|
-
"jsdoc-plugin-intersection",
|
|
18
|
-
"config/jsdoc/plugins/markdown.cjs",
|
|
19
|
-
"jsdoc-plugin-typescript",
|
|
20
|
-
"config/jsdoc/plugins/inline-options.cjs",
|
|
21
|
-
"config/jsdoc/plugins/events.cjs",
|
|
22
|
-
"config/jsdoc/plugins/observable.cjs",
|
|
23
|
-
"config/jsdoc/plugins/api.cjs",
|
|
24
|
-
"config/jsdoc/plugins/default-export.cjs"
|
|
25
|
-
],
|
|
26
|
-
"typescript": {
|
|
27
|
-
"moduleRoot": "src"
|
|
28
|
-
},
|
|
29
|
-
"templates": {
|
|
30
|
-
"cleverLinks": true,
|
|
31
|
-
"monospaceLinks": true,
|
|
32
|
-
"default": {
|
|
33
|
-
"outputSourceFiles": false
|
|
34
|
-
},
|
|
35
|
-
"applicationName": "OL STAC"
|
|
36
|
-
},
|
|
37
|
-
"jsVersion": 180
|
|
38
|
-
}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
tbd
|
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
# API Documentation
|
|
2
|
-
|
|
3
|
-
This directory contains configuration (`conf.json`), static content (`index.md`), template (`template/`) and plugins (`plugins/`) for the [JSDoc3](https://jsdoc.app/) API generator.
|
|
4
|
-
|
|
5
|
-
## Documenting the source code
|
|
6
|
-
|
|
7
|
-
JSDoc annotations are used for metadata used by the compiler, for defining the user facing API, and for user documentation.
|
|
8
|
-
|
|
9
|
-
In the simplest case, a JSDoc block can look like this:
|
|
10
|
-
```js
|
|
11
|
-
/**
|
|
12
|
-
* Add the given control to the map.
|
|
13
|
-
* @param {ol.control.Control} control Control.
|
|
14
|
-
* @api
|
|
15
|
-
*/
|
|
16
|
-
ol.Map.prototype.addControl = function(control) {
|
|
17
|
-
// ...
|
|
18
|
-
};
|
|
19
|
-
```
|
|
20
|
-
The first line is text for the user documentation. This can be long, and it can
|
|
21
|
-
contain Markdown.
|
|
22
|
-
|
|
23
|
-
The second line tells the Closure compiler the type of the argument.
|
|
24
|
-
|
|
25
|
-
The third line (`@api`) marks the method as part of the api and thus exportable. Without such an api annotation, the method will not be documented in the generated API documentation. Symbols without an api annotation will also not be exportable.
|
|
26
|
-
|
|
27
|
-
In general, `@api` annotations should never be used on abstract methods (only on their implementations).
|
|
28
|
-
|
|
29
|
-
### Events
|
|
30
|
-
|
|
31
|
-
Events are documented using `@fires` and `@event` annotations:
|
|
32
|
-
```js
|
|
33
|
-
/**
|
|
34
|
-
* Constants for event names.
|
|
35
|
-
* @enum {string}
|
|
36
|
-
*/
|
|
37
|
-
ol.MapBrowserEventType = {
|
|
38
|
-
/**
|
|
39
|
-
* A true single click with no dragging and no double click. Note that this
|
|
40
|
-
* event is delayed by 250 ms to ensure that it is not a double click.
|
|
41
|
-
* @event ol.MapBrowserEvent#singleclick
|
|
42
|
-
* @api
|
|
43
|
-
*/
|
|
44
|
-
SINGLECLICK: 'singleclick',
|
|
45
|
-
// ...
|
|
46
|
-
};
|
|
47
|
-
```
|
|
48
|
-
Note the value of the `@event` annotation. The text before the hash refers to the event class that the event belongs to, and the text after the hash is the type of the event.
|
|
49
|
-
|
|
50
|
-
To document which events are fired by a class or method, the `@fires` annotation is used:
|
|
51
|
-
```js
|
|
52
|
-
/**
|
|
53
|
-
* @fires ol.MapBrowserEvent
|
|
54
|
-
* @fires ol.MapEvent
|
|
55
|
-
* @fires ol.render.Event
|
|
56
|
-
* ...
|
|
57
|
-
*/
|
|
58
|
-
ol.Map = function(options) {
|
|
59
|
-
// ...
|
|
60
|
-
};
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
### Observable Properties
|
|
64
|
-
|
|
65
|
-
Observable properties are documented using the `@observable` annotation. This annotation is added to the getter of an observable property. If an observable property is also settable, the setter is annotated with `@observable` as well.
|
|
@@ -1,3 +0,0 @@
|
|
|
1
|
-
This template is based on the [Jaguar](https://github.com/davidshimjs/jaguarjs/tree/master/docs/templates/jaguar) template. [JaguarJS](https://github.com/davidshimjs/jaguarjs) is licensed under the [LGPL license](https://github.com/davidshimjs/jaguarjs/tree/master/LICENSE).
|
|
2
|
-
|
|
3
|
-
The default template for JSDoc 3 uses: [the Salty Database library](https://www.npmjs.com/package/@jsdoc/salty) and the [Underscore Template library](https://underscorejs.org/#template).
|