ogcopenapis 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+All notable changes to ogcopenapis are in this file. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Each pull request adds its changes under Unreleased. A release renames Unreleased to its version and date.
+
+## [Unreleased]
+
+## [1.0.1] - 2026-10-27
+
+### Fixed
+- The Features example of the README keeps the feature ids of the server, `new GeoJsonCodec({generateIDs: false})`.
+  `generateIDs: true` replaced them with ids of its own on every query: `get(id)` of the store then requested ids that
+  do not exist, and LuciadRIA re-added every feature on every query. The library is unchanged, the application passes
+  the codec.
+
+## [1.0.0] - 2026-10-27
+
+### Changed
+- **BREAKING:** requires LuciadRIA 2026.1 or higher, as a peer dependency: the application installs its single copy,
+  the package never bundles it.
+- **BREAKING:** the package is native ES modules (`"type": "module"`) with an `exports` map. Import components as
+  `ogcopenapis/OgcOpenApiFeatureStore`, the paths of 0.0.12 with `lib/` still work. TypeScript projects need
+  `moduleResolution` `bundler`, `node16` or `nodenext` for the paths without `lib/`.
+- OgcOpenApiTilesModel uses LuciadRIA's WMTS support: create it with `createFromTileSet`, which handles tile matrix
+  sets that are not quad-trees and `tileMatrixSetLimits`.
+- OgcOpenApiFeatureStore extends LuciadRIA's `Store`. Its requests always settle, and it supports `abortSignal`.
+- `fetchTileSetsInFull` leaves out tile matrix sets whose definition cannot be read, instead of failing, and rejects
+  only when none can be read.
+- OgcOpenApiMapsModel keeps the `f` value of the map link, such as `f=png`, and encodes its query.
+- Tile matrix set definitions are requested by their link as the server gives it, with an `Accept: application/json`
+  header.
+
+### Added
+- Vector tiles (Mapbox Vector Tiles): OgcOpenApiVectorTilesModel, on LuciadRIA's MapboxVectorTileSetModel. It reads
+  the layers from a few tiles when a tileset does not list them (`discoverLayers`).
+- OGC API Styles in the Mapbox GL encoding: OgcOpenApiStyleTools, with a stylesheet or a style per tile matrix set
+  (`pickStylesheet`, `getStylesForTileMatrixSet`) and a generated default style (`createDefaultStyle`).
+- The tilesets of a collection, only the tile matrix sets it is tiled in: `fetchCollectionTileSets`, matched to the
+  tile matrix sets of the server by URI (`matchTileMatrixSet`, `fetchTileMatrixSetOfTileSet`).
+- The tilesets of the dataset, all collections in each tile: `hasDatasetTileSets`, `fetchDatasetTileSets`, and
+  `fetchCollectionTileSet` with collection `null`.
+- A tile matrix set included in a tileset is used as is.
+- A demo, test servers with recorded, live and browser tests, and a check of the package as published.
+
+### Deprecated
+- The constructor `new OgcOpenApiTilesModel(options)`: it supports quad-tree tile matrix sets only.
+
+### Fixed
+- Relative links are resolved against the URL of their document, instead of the host of the server.
+- Tile matrix set URIs match regardless of `http`/`https`, the case of the host and a trailing slash.
+- `orderedAxes` `Y, X` (EPSG:3035) is northing first: `pointOfOrigin` is read in that order.
+- `fromURL` without options no longer hangs.
+
+## 0.0.12 and earlier
+
+See the [git history](https://github.com/felipecarrillo100/ogcopenapis/commits/main).
+
+[Unreleased]: https://github.com/felipecarrillo100/ogcopenapis/compare/v1.0.1...HEAD
+[1.0.1]: https://github.com/felipecarrillo100/ogcopenapis/compare/v1.0.0...v1.0.1
+[1.0.0]: https://github.com/felipecarrillo100/ogcopenapis/releases/tag/v1.0.0

package/README.md

@@ -63,7 +63,7 @@ npm run test:record
 GNOSIS (https://maps.gnosis.earth/ogcapi/) is in the list but not tested: its `/collections` response is 9 MB, and its tiles need a login.
 
 The package check builds and packs the package, and checks it as published: only `lib/`, the sources of its source
-maps, README, LICENSE and package.json are in it, nothing of LuciadRIA; `lib/` imports only its own modules and
+maps, README, CHANGELOG, LICENSE and package.json are in it, nothing of LuciadRIA; `lib/` imports only its own modules and
 `@luciad/ria`; [publint](https://publint.dev) and [Are the Types Wrong](https://arethetypeswrong.github.io) find no
 problems; and every module loads through the package exports, installed in a `node_modules` folder, by Node's own
 ES module loader, as in the tests of an application:
@@ -130,7 +130,7 @@ const items = OgcOpenApiGetCapabilities.filterCollectionLinks(collection.links,
 const store = new OgcOpenApiFeatureStore({
     dataUrl: items.find(l => l.type === "application/geo+json").href,
     outputFormat: "application/geo+json",
-    codec: new GeoJsonCodec({generateIDs: true}),
+    codec: new GeoJsonCodec({generateIDs: false}),
     crs: "http://www.opengis.net/def/crs/OGC/1.3/CRS84",
     extent: collection.extent,
     useCrs84Bounds: true,
@@ -140,6 +140,10 @@ map.layerTree.addChild(new FeatureLayer(model, {label: collection.title, loading
 ```
 The store requests the features in view, a query does not follow the `next` links of a response yet (no paging).
 
+Keep the ids of the server: `generateIDs: false`. Each feature of an OGC API Features collection has an id, `get(id)` of
+the store requests `items/{id}` with it, and LuciadRIA updates only the features that changed when the ids stay the same
+between queries. `generateIDs: true` replaces them with ids of its own on every query.
+
 ### Maps and map tiles
 For maps and map tiles use OgcOpenApiMapsModel and OgcOpenApiTilesModel. OgcOpenApiMapsModel extends WMSTileSetModel
 and OgcOpenApiTilesModel extends WMTSTileSetModel, so you use them in combination with RasterTileSetLayer.
@@ -291,17 +295,8 @@ which MapEvolution uses) do. The WKT of epsg.io that the demo uses has no `AXIS`
   level 0, and does not request tiles outside the `tileMatrixSetLimits` of the tileset.
 * LuciadRIA 2026.1.1 does not paint Mapbox `circle` layers. The default style draws points as a text symbol for that reason.
 
-## Changes in 1.0.0
-Version 1.0.0 is a breaking change from 0.0.12:
-* It requires LuciadRIA 2026.1 or higher, as a peer dependency: the application installs it.
-* The package is native ES modules (`"type": "module"`), with an `exports` map. Import components as
-  `ogcopenapis/OgcOpenApiFeatureStore`, the paths with `lib/` still work.
-* New: vector tiles (OgcOpenApiVectorTilesModel), OGC API Styles (OgcOpenApiStyleTools), the tilesets of a collection
-  (`fetchCollectionTileSets`) and of the dataset (`fetchDatasetTileSets`).
-* OgcOpenApiTilesModel uses LuciadRIA's WMTS support, create it with `createFromTileSet`. The constructor is deprecated.
-* OgcOpenApiFeatureStore extends LuciadRIA's `Store`.
-* `fetchTileSetsInFull` leaves out tile matrix sets whose definition cannot be read, instead of failing.
-* Relative links are resolved against the document that has them, instead of the host of the server.
+## Changes
+See [CHANGELOG.md](CHANGELOG.md) for the changes of each version.
 
 ## Requirements
 * LuciadRIA 2026.1 or higher, a peer dependency that the application installs (place it on a local npm repository,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ogcopenapis",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OGC API Features, Maps, Tiles and Styles for LuciadRIA",
   "type": "module",
   "exports": {
@@ -18,7 +18,8 @@
     "lib/",
     "src/",
     "!src/**/*.test.ts",
-    "!src/fixtures/"
+    "!src/fixtures/",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "scripts": {