@loaders.gl/ogc 0.0.0-stage → 5.0.0-alpha.13

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.
Files changed (382) hide show
  1. package/README.md +10 -2
  2. package/dist/index.cjs +7052 -0
  3. package/dist/index.cjs.map +6 -0
  4. package/dist/index.d.ts +3 -0
  5. package/dist/index.d.ts.map +1 -0
  6. package/dist/index.js +6 -0
  7. package/dist/index.js.map +1 -0
  8. package/dist/stac/index.cjs +1095 -0
  9. package/dist/stac/index.cjs.map +6 -0
  10. package/dist/stac/index.d.ts +4 -0
  11. package/dist/stac/index.d.ts.map +1 -0
  12. package/dist/stac/index.js +5 -0
  13. package/dist/stac/index.js.map +1 -0
  14. package/dist/stac/stac-source-loader-types.d.ts +44 -0
  15. package/dist/stac/stac-source-loader-types.d.ts.map +1 -0
  16. package/dist/stac/stac-source-loader-types.js +43 -0
  17. package/dist/stac/stac-source-loader-types.js.map +1 -0
  18. package/dist/stac/stac-source.cjs +1544 -0
  19. package/dist/stac/stac-source.cjs.map +6 -0
  20. package/dist/stac/stac-source.d.ts +92 -0
  21. package/dist/stac/stac-source.d.ts.map +1 -0
  22. package/dist/stac/stac-source.js +500 -0
  23. package/dist/stac/stac-source.js.map +1 -0
  24. package/dist/stac/stac-types.d.ts +213 -0
  25. package/dist/stac/stac-types.d.ts.map +1 -0
  26. package/dist/stac/stac-types.js +5 -0
  27. package/dist/stac/stac-types.js.map +1 -0
  28. package/dist/wms/bundled.cjs +7295 -0
  29. package/dist/wms/bundled.cjs.map +6 -0
  30. package/dist/wms/bundled.d.ts +24 -0
  31. package/dist/wms/bundled.d.ts.map +1 -0
  32. package/dist/wms/bundled.js +18 -0
  33. package/dist/wms/bundled.js.map +1 -0
  34. package/dist/wms/capability-graph.d.ts +42 -0
  35. package/dist/wms/capability-graph.d.ts.map +1 -0
  36. package/dist/wms/capability-graph.js +118 -0
  37. package/dist/wms/capability-graph.js.map +1 -0
  38. package/dist/wms/crs-utils.d.ts +24 -0
  39. package/dist/wms/crs-utils.d.ts.map +1 -0
  40. package/dist/wms/crs-utils.js +57 -0
  41. package/dist/wms/crs-utils.js.map +1 -0
  42. package/dist/wms/csw-capabilities-loader-with-parser.d.ts +34 -0
  43. package/dist/wms/csw-capabilities-loader-with-parser.d.ts.map +1 -0
  44. package/dist/wms/csw-capabilities-loader-with-parser.js +15 -0
  45. package/dist/wms/csw-capabilities-loader-with-parser.js.map +1 -0
  46. package/dist/wms/csw-capabilities-loader.d.ts +56 -0
  47. package/dist/wms/csw-capabilities-loader.d.ts.map +1 -0
  48. package/dist/wms/csw-capabilities-loader.js +38 -0
  49. package/dist/wms/csw-capabilities-loader.js.map +1 -0
  50. package/dist/wms/csw-domain-loader-with-parser.d.ts +33 -0
  51. package/dist/wms/csw-domain-loader-with-parser.d.ts.map +1 -0
  52. package/dist/wms/csw-domain-loader-with-parser.js +15 -0
  53. package/dist/wms/csw-domain-loader-with-parser.js.map +1 -0
  54. package/dist/wms/csw-domain-loader.d.ts +55 -0
  55. package/dist/wms/csw-domain-loader.d.ts.map +1 -0
  56. package/dist/wms/csw-domain-loader.js +38 -0
  57. package/dist/wms/csw-domain-loader.js.map +1 -0
  58. package/dist/wms/csw-records-loader-with-parser.d.ts +33 -0
  59. package/dist/wms/csw-records-loader-with-parser.d.ts.map +1 -0
  60. package/dist/wms/csw-records-loader-with-parser.js +15 -0
  61. package/dist/wms/csw-records-loader-with-parser.js.map +1 -0
  62. package/dist/wms/csw-records-loader.d.ts +55 -0
  63. package/dist/wms/csw-records-loader.d.ts.map +1 -0
  64. package/dist/wms/csw-records-loader.js +38 -0
  65. package/dist/wms/csw-records-loader.js.map +1 -0
  66. package/dist/wms/csw-source-loader.d.ts +165 -0
  67. package/dist/wms/csw-source-loader.d.ts.map +1 -0
  68. package/dist/wms/csw-source-loader.js +203 -0
  69. package/dist/wms/csw-source-loader.js.map +1 -0
  70. package/dist/wms/feature-pagination.d.ts +34 -0
  71. package/dist/wms/feature-pagination.d.ts.map +1 -0
  72. package/dist/wms/feature-pagination.js +159 -0
  73. package/dist/wms/feature-pagination.js.map +1 -0
  74. package/dist/wms/gml-loader-types.d.ts +68 -0
  75. package/dist/wms/gml-loader-types.d.ts.map +1 -0
  76. package/dist/wms/gml-loader-types.js +38 -0
  77. package/dist/wms/gml-loader-types.js.map +1 -0
  78. package/dist/wms/gml-loader.cjs +5779 -0
  79. package/dist/wms/gml-loader.cjs.map +6 -0
  80. package/dist/wms/gml-loader.d.ts +38 -0
  81. package/dist/wms/gml-loader.d.ts.map +1 -0
  82. package/dist/wms/gml-loader.js +195 -0
  83. package/dist/wms/gml-loader.js.map +1 -0
  84. package/dist/wms/index.cjs +12416 -0
  85. package/dist/wms/index.cjs.map +6 -0
  86. package/dist/wms/index.d.ts +61 -0
  87. package/dist/wms/index.d.ts.map +1 -0
  88. package/dist/wms/index.js +36 -0
  89. package/dist/wms/index.js.map +1 -0
  90. package/dist/wms/lib/deprecated/create-image-source.d.ts +27 -0
  91. package/dist/wms/lib/deprecated/create-image-source.d.ts.map +1 -0
  92. package/dist/wms/lib/deprecated/create-image-source.js +44 -0
  93. package/dist/wms/lib/deprecated/create-image-source.js.map +1 -0
  94. package/dist/wms/lib/deprecated/image-source-compatibility.d.ts +14 -0
  95. package/dist/wms/lib/deprecated/image-source-compatibility.d.ts.map +1 -0
  96. package/dist/wms/lib/deprecated/image-source-compatibility.js +21 -0
  97. package/dist/wms/lib/deprecated/image-source-compatibility.js.map +1 -0
  98. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.d.ts +79 -0
  99. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.d.ts.map +1 -0
  100. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.js +23 -0
  101. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.js.map +1 -0
  102. package/dist/wms/lib/parsers/csw/parse-csw-domain.d.ts +17 -0
  103. package/dist/wms/lib/parsers/csw/parse-csw-domain.d.ts.map +1 -0
  104. package/dist/wms/lib/parsers/csw/parse-csw-domain.js +32 -0
  105. package/dist/wms/lib/parsers/csw/parse-csw-domain.js.map +1 -0
  106. package/dist/wms/lib/parsers/csw/parse-csw-records.d.ts +34 -0
  107. package/dist/wms/lib/parsers/csw/parse-csw-records.d.ts.map +1 -0
  108. package/dist/wms/lib/parsers/csw/parse-csw-records.js +56 -0
  109. package/dist/wms/lib/parsers/csw/parse-csw-records.js.map +1 -0
  110. package/dist/wms/lib/parsers/csw/parse-exception-report.d.ts +6 -0
  111. package/dist/wms/lib/parsers/csw/parse-exception-report.d.ts.map +1 -0
  112. package/dist/wms/lib/parsers/csw/parse-exception-report.js +29 -0
  113. package/dist/wms/lib/parsers/csw/parse-exception-report.js.map +1 -0
  114. package/dist/wms/lib/parsers/gml/deep-strict-equal.d.ts +3 -0
  115. package/dist/wms/lib/parsers/gml/deep-strict-equal.d.ts.map +1 -0
  116. package/dist/wms/lib/parsers/gml/deep-strict-equal.js +118 -0
  117. package/dist/wms/lib/parsers/gml/deep-strict-equal.js.map +1 -0
  118. package/dist/wms/lib/parsers/gml/parse-gml.d.ts +66 -0
  119. package/dist/wms/lib/parsers/gml/parse-gml.d.ts.map +1 -0
  120. package/dist/wms/lib/parsers/gml/parse-gml.js +641 -0
  121. package/dist/wms/lib/parsers/gml/parse-gml.js.map +1 -0
  122. package/dist/wms/lib/parsers/gml/rewind-geometry.d.ts +4 -0
  123. package/dist/wms/lib/parsers/gml/rewind-geometry.d.ts.map +1 -0
  124. package/dist/wms/lib/parsers/gml/rewind-geometry.js +45 -0
  125. package/dist/wms/lib/parsers/gml/rewind-geometry.js.map +1 -0
  126. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.d.ts +19 -0
  127. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.d.ts.map +1 -0
  128. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.js +74 -0
  129. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.js.map +1 -0
  130. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.d.ts +63 -0
  131. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.d.ts.map +1 -0
  132. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.js +82 -0
  133. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.js.map +1 -0
  134. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.d.ts +97 -0
  135. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.d.ts.map +1 -0
  136. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.js +60 -0
  137. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.js.map +1 -0
  138. package/dist/wms/lib/parsers/wfs/parse-wfs.d.ts +7 -0
  139. package/dist/wms/lib/parsers/wfs/parse-wfs.d.ts.map +1 -0
  140. package/dist/wms/lib/parsers/wfs/parse-wfs.js +31 -0
  141. package/dist/wms/lib/parsers/wfs/parse-wfs.js.map +1 -0
  142. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.d.ts +126 -0
  143. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.d.ts.map +1 -0
  144. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.js +232 -0
  145. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.js.map +1 -0
  146. package/dist/wms/lib/parsers/wms/parse-wms-error.d.ts +8 -0
  147. package/dist/wms/lib/parsers/wms/parse-wms-error.d.ts.map +1 -0
  148. package/dist/wms/lib/parsers/wms/parse-wms-error.js +21 -0
  149. package/dist/wms/lib/parsers/wms/parse-wms-error.js.map +1 -0
  150. package/dist/wms/lib/parsers/wms/parse-wms-features.d.ts +20 -0
  151. package/dist/wms/lib/parsers/wms/parse-wms-features.d.ts.map +1 -0
  152. package/dist/wms/lib/parsers/wms/parse-wms-features.js +26 -0
  153. package/dist/wms/lib/parsers/wms/parse-wms-features.js.map +1 -0
  154. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.d.ts +11 -0
  155. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.d.ts.map +1 -0
  156. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.js +14 -0
  157. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.js.map +1 -0
  158. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.d.ts +101 -0
  159. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.d.ts.map +1 -0
  160. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.js +175 -0
  161. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.js.map +1 -0
  162. package/dist/wms/lib/parsers/xml/parse-xml-helpers.d.ts +11 -0
  163. package/dist/wms/lib/parsers/xml/parse-xml-helpers.d.ts.map +1 -0
  164. package/dist/wms/lib/parsers/xml/parse-xml-helpers.js +63 -0
  165. package/dist/wms/lib/parsers/xml/parse-xml-helpers.js.map +1 -0
  166. package/dist/wms/lib/parsers/xml/parse-xml-text.d.ts +4 -0
  167. package/dist/wms/lib/parsers/xml/parse-xml-text.d.ts.map +1 -0
  168. package/dist/wms/lib/parsers/xml/parse-xml-text.js +9 -0
  169. package/dist/wms/lib/parsers/xml/parse-xml-text.js.map +1 -0
  170. package/dist/wms/lib/tile-grid.d.ts +14 -0
  171. package/dist/wms/lib/tile-grid.d.ts.map +1 -0
  172. package/dist/wms/lib/tile-grid.js +28 -0
  173. package/dist/wms/lib/tile-grid.js.map +1 -0
  174. package/dist/wms/managed-vector-source.d.ts +66 -0
  175. package/dist/wms/managed-vector-source.d.ts.map +1 -0
  176. package/dist/wms/managed-vector-source.js +307 -0
  177. package/dist/wms/managed-vector-source.js.map +1 -0
  178. package/dist/wms/ogc-api-coverages-source-loader.d.ts +64 -0
  179. package/dist/wms/ogc-api-coverages-source-loader.d.ts.map +1 -0
  180. package/dist/wms/ogc-api-coverages-source-loader.js +78 -0
  181. package/dist/wms/ogc-api-coverages-source-loader.js.map +1 -0
  182. package/dist/wms/ogc-api-edr-source-loader.d.ts +72 -0
  183. package/dist/wms/ogc-api-edr-source-loader.d.ts.map +1 -0
  184. package/dist/wms/ogc-api-edr-source-loader.js +82 -0
  185. package/dist/wms/ogc-api-edr-source-loader.js.map +1 -0
  186. package/dist/wms/ogc-api-source-loader.d.ts +223 -0
  187. package/dist/wms/ogc-api-source-loader.d.ts.map +1 -0
  188. package/dist/wms/ogc-api-source-loader.js +517 -0
  189. package/dist/wms/ogc-api-source-loader.js.map +1 -0
  190. package/dist/wms/service-capabilities.d.ts +17 -0
  191. package/dist/wms/service-capabilities.d.ts.map +1 -0
  192. package/dist/wms/service-capabilities.js +110 -0
  193. package/dist/wms/service-capabilities.js.map +1 -0
  194. package/dist/wms/service-runtime.d.ts +67 -0
  195. package/dist/wms/service-runtime.d.ts.map +1 -0
  196. package/dist/wms/service-runtime.js +165 -0
  197. package/dist/wms/service-runtime.js.map +1 -0
  198. package/dist/wms/unbundled.cjs +5995 -0
  199. package/dist/wms/unbundled.cjs.map +6 -0
  200. package/dist/wms/unbundled.d.ts +18 -0
  201. package/dist/wms/unbundled.d.ts.map +1 -0
  202. package/dist/wms/unbundled.js +12 -0
  203. package/dist/wms/unbundled.js.map +1 -0
  204. package/dist/wms/wcs-source-loader.d.ts +99 -0
  205. package/dist/wms/wcs-source-loader.d.ts.map +1 -0
  206. package/dist/wms/wcs-source-loader.js +178 -0
  207. package/dist/wms/wcs-source-loader.js.map +1 -0
  208. package/dist/wms/wfs-capabilities-loader-with-parser.d.ts +35 -0
  209. package/dist/wms/wfs-capabilities-loader-with-parser.d.ts.map +1 -0
  210. package/dist/wms/wfs-capabilities-loader-with-parser.js +17 -0
  211. package/dist/wms/wfs-capabilities-loader-with-parser.js.map +1 -0
  212. package/dist/wms/wfs-capabilities-loader.d.ts +59 -0
  213. package/dist/wms/wfs-capabilities-loader.d.ts.map +1 -0
  214. package/dist/wms/wfs-capabilities-loader.js +42 -0
  215. package/dist/wms/wfs-capabilities-loader.js.map +1 -0
  216. package/dist/wms/wfs-source-loader.d.ts +353 -0
  217. package/dist/wms/wfs-source-loader.d.ts.map +1 -0
  218. package/dist/wms/wfs-source-loader.js +606 -0
  219. package/dist/wms/wfs-source-loader.js.map +1 -0
  220. package/dist/wms/wip/data-source.d.ts +54 -0
  221. package/dist/wms/wip/data-source.d.ts.map +1 -0
  222. package/dist/wms/wip/data-source.js +62 -0
  223. package/dist/wms/wip/data-source.js.map +1 -0
  224. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.d.ts +78 -0
  225. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.d.ts.map +1 -0
  226. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.js +14 -0
  227. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.js.map +1 -0
  228. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.d.ts +87 -0
  229. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.d.ts.map +1 -0
  230. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.js +76 -0
  231. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.js.map +1 -0
  232. package/dist/wms/wip/lib/wmts/parse-wmts.d.ts +7 -0
  233. package/dist/wms/wip/lib/wmts/parse-wmts.d.ts.map +1 -0
  234. package/dist/wms/wip/lib/wmts/parse-wmts.js +34 -0
  235. package/dist/wms/wip/lib/wmts/parse-wmts.js.map +1 -0
  236. package/dist/wms/wip/wcs-capabilities-loader-with-parser.d.ts +12 -0
  237. package/dist/wms/wip/wcs-capabilities-loader-with-parser.d.ts.map +1 -0
  238. package/dist/wms/wip/wcs-capabilities-loader-with-parser.js +16 -0
  239. package/dist/wms/wip/wcs-capabilities-loader-with-parser.js.map +1 -0
  240. package/dist/wms/wip/wcs-capabilities-loader.d.ts +12 -0
  241. package/dist/wms/wip/wcs-capabilities-loader.d.ts.map +1 -0
  242. package/dist/wms/wip/wcs-capabilities-loader.js +36 -0
  243. package/dist/wms/wip/wcs-capabilities-loader.js.map +1 -0
  244. package/dist/wms/wip/wms-feature-info-loader-with-parser.d.ts +7 -0
  245. package/dist/wms/wip/wms-feature-info-loader-with-parser.d.ts.map +1 -0
  246. package/dist/wms/wip/wms-feature-info-loader-with-parser.js +15 -0
  247. package/dist/wms/wip/wms-feature-info-loader-with-parser.js.map +1 -0
  248. package/dist/wms/wip/wms-feature-info-loader.d.ts +7 -0
  249. package/dist/wms/wip/wms-feature-info-loader.d.ts.map +1 -0
  250. package/dist/wms/wip/wms-feature-info-loader.js +19 -0
  251. package/dist/wms/wip/wms-feature-info-loader.js.map +1 -0
  252. package/dist/wms/wip/wms-layer-description-loader-with-parser.d.ts +7 -0
  253. package/dist/wms/wip/wms-layer-description-loader-with-parser.d.ts.map +1 -0
  254. package/dist/wms/wip/wms-layer-description-loader-with-parser.js +15 -0
  255. package/dist/wms/wip/wms-layer-description-loader-with-parser.js.map +1 -0
  256. package/dist/wms/wip/wms-layer-description-loader.d.ts +7 -0
  257. package/dist/wms/wip/wms-layer-description-loader.d.ts.map +1 -0
  258. package/dist/wms/wip/wms-layer-description-loader.js +19 -0
  259. package/dist/wms/wip/wms-layer-description-loader.js.map +1 -0
  260. package/dist/wms/wip/wmts-capabilities-loader-with-parser.d.ts +11 -0
  261. package/dist/wms/wip/wmts-capabilities-loader-with-parser.d.ts.map +1 -0
  262. package/dist/wms/wip/wmts-capabilities-loader-with-parser.js +17 -0
  263. package/dist/wms/wip/wmts-capabilities-loader-with-parser.js.map +1 -0
  264. package/dist/wms/wip/wmts-capabilities-loader.d.ts +11 -0
  265. package/dist/wms/wip/wmts-capabilities-loader.d.ts.map +1 -0
  266. package/dist/wms/wip/wmts-capabilities-loader.js +36 -0
  267. package/dist/wms/wip/wmts-capabilities-loader.js.map +1 -0
  268. package/dist/wms/wms-capabilities-loader-with-parser.d.ts +40 -0
  269. package/dist/wms/wms-capabilities-loader-with-parser.d.ts.map +1 -0
  270. package/dist/wms/wms-capabilities-loader-with-parser.js +19 -0
  271. package/dist/wms/wms-capabilities-loader-with-parser.js.map +1 -0
  272. package/dist/wms/wms-capabilities-loader.d.ts +62 -0
  273. package/dist/wms/wms-capabilities-loader.d.ts.map +1 -0
  274. package/dist/wms/wms-capabilities-loader.js +38 -0
  275. package/dist/wms/wms-capabilities-loader.js.map +1 -0
  276. package/dist/wms/wms-error-loader-with-parser.d.ts +39 -0
  277. package/dist/wms/wms-error-loader-with-parser.d.ts.map +1 -0
  278. package/dist/wms/wms-error-loader-with-parser.js +28 -0
  279. package/dist/wms/wms-error-loader-with-parser.js.map +1 -0
  280. package/dist/wms/wms-error-loader.d.ts +64 -0
  281. package/dist/wms/wms-error-loader.d.ts.map +1 -0
  282. package/dist/wms/wms-error-loader.js +40 -0
  283. package/dist/wms/wms-error-loader.js.map +1 -0
  284. package/dist/wms/wms-format.d.ts +13 -0
  285. package/dist/wms/wms-format.d.ts.map +1 -0
  286. package/dist/wms/wms-format.js +25 -0
  287. package/dist/wms/wms-format.js.map +1 -0
  288. package/dist/wms/wms-source-loader.d.ts +226 -0
  289. package/dist/wms/wms-source-loader.d.ts.map +1 -0
  290. package/dist/wms/wms-source-loader.js +397 -0
  291. package/dist/wms/wms-source-loader.js.map +1 -0
  292. package/dist/wms/wmts-capabilities-loader-with-parser.cjs +2189 -0
  293. package/dist/wms/wmts-capabilities-loader-with-parser.cjs.map +6 -0
  294. package/dist/wms/wmts-capabilities-loader-with-parser.d.ts +3 -0
  295. package/dist/wms/wmts-capabilities-loader-with-parser.d.ts.map +1 -0
  296. package/dist/wms/wmts-capabilities-loader-with-parser.js +13 -0
  297. package/dist/wms/wmts-capabilities-loader-with-parser.js.map +1 -0
  298. package/dist/wms/wmts-capabilities-loader.d.ts +7 -0
  299. package/dist/wms/wmts-capabilities-loader.d.ts.map +1 -0
  300. package/dist/wms/wmts-capabilities-loader.js +24 -0
  301. package/dist/wms/wmts-capabilities-loader.js.map +1 -0
  302. package/dist/wms/wmts-source-loader.d.ts +120 -0
  303. package/dist/wms/wmts-source-loader.d.ts.map +1 -0
  304. package/dist/wms/wmts-source-loader.js +472 -0
  305. package/dist/wms/wmts-source-loader.js.map +1 -0
  306. package/package.json +88 -4
  307. package/src/index.ts +6 -0
  308. package/src/stac/index.ts +25 -0
  309. package/src/stac/stac-source-loader-types.ts +65 -0
  310. package/src/stac/stac-source.ts +635 -0
  311. package/src/stac/stac-types.ts +230 -0
  312. package/src/wms/bundled.ts +30 -0
  313. package/src/wms/capability-graph.ts +152 -0
  314. package/src/wms/crs-utils.ts +67 -0
  315. package/src/wms/csw-capabilities-loader-with-parser.ts +30 -0
  316. package/src/wms/csw-capabilities-loader.ts +54 -0
  317. package/src/wms/csw-domain-loader-with-parser.ts +28 -0
  318. package/src/wms/csw-domain-loader.ts +53 -0
  319. package/src/wms/csw-records-loader-with-parser.ts +28 -0
  320. package/src/wms/csw-records-loader.ts +52 -0
  321. package/src/wms/csw-source-loader.ts +330 -0
  322. package/src/wms/feature-pagination.ts +198 -0
  323. package/src/wms/gml-loader-types.ts +62 -0
  324. package/src/wms/gml-loader.ts +228 -0
  325. package/src/wms/index.ts +171 -0
  326. package/src/wms/lib/deprecated/create-image-service.ts.disabled +57 -0
  327. package/src/wms/lib/deprecated/create-image-source.ts +75 -0
  328. package/src/wms/lib/deprecated/image-source-compatibility.ts +28 -0
  329. package/src/wms/lib/deprecated/template-image-service.ts.disabled +68 -0
  330. package/src/wms/lib/parsers/csw/parse-csw-capabilities.ts +105 -0
  331. package/src/wms/lib/parsers/csw/parse-csw-domain.ts +47 -0
  332. package/src/wms/lib/parsers/csw/parse-csw-records.ts +94 -0
  333. package/src/wms/lib/parsers/csw/parse-exception-report.ts +33 -0
  334. package/src/wms/lib/parsers/gml/deep-strict-equal.ts +122 -0
  335. package/src/wms/lib/parsers/gml/parse-gml.ts +849 -0
  336. package/src/wms/lib/parsers/gml/rewind-geometry.ts +45 -0
  337. package/src/wms/lib/parsers/ogc-api/tile-matrix-limits.ts +107 -0
  338. package/src/wms/lib/parsers/ogc-api/tile-matrix-set.ts +167 -0
  339. package/src/wms/lib/parsers/wfs/parse-wfs-capabilities.ts +165 -0
  340. package/src/wms/lib/parsers/wfs/parse-wfs.ts +36 -0
  341. package/src/wms/lib/parsers/wms/parse-wms-capabilities.ts +427 -0
  342. package/src/wms/lib/parsers/wms/parse-wms-error.ts +24 -0
  343. package/src/wms/lib/parsers/wms/parse-wms-features.ts +41 -0
  344. package/src/wms/lib/parsers/wms/parse-wms-layer-description.ts +24 -0
  345. package/src/wms/lib/parsers/wmts/parse-wmts-capabilities.ts +281 -0
  346. package/src/wms/lib/parsers/xml/parse-xml-helpers.ts +67 -0
  347. package/src/wms/lib/parsers/xml/parse-xml-text.ts +11 -0
  348. package/src/wms/lib/tile-grid.ts +47 -0
  349. package/src/wms/managed-vector-source.ts +384 -0
  350. package/src/wms/ogc-api-coverages-source-loader.ts +109 -0
  351. package/src/wms/ogc-api-edr-source-loader.ts +127 -0
  352. package/src/wms/ogc-api-source-loader.ts +742 -0
  353. package/src/wms/service-capabilities.ts +147 -0
  354. package/src/wms/service-runtime.ts +225 -0
  355. package/src/wms/unbundled.ts +24 -0
  356. package/src/wms/wcs-source-loader.ts +260 -0
  357. package/src/wms/wfs-capabilities-loader-with-parser.ts +30 -0
  358. package/src/wms/wfs-capabilities-loader.ts +57 -0
  359. package/src/wms/wfs-source-loader.ts +987 -0
  360. package/src/wms/wip/data-source.ts +64 -0
  361. package/src/wms/wip/lib/wcs/parse-wcs-capabilities.ts +91 -0
  362. package/src/wms/wip/lib/wmts/parse-wmts-capabilities.ts +171 -0
  363. package/src/wms/wip/lib/wmts/parse-wmts.ts +39 -0
  364. package/src/wms/wip/services/wmts-service.ts.disabled +348 -0
  365. package/src/wms/wip/wcs-capabilities-loader-with-parser.ts +29 -0
  366. package/src/wms/wip/wcs-capabilities-loader.ts +50 -0
  367. package/src/wms/wip/wms-feature-info-loader-with-parser.ts +25 -0
  368. package/src/wms/wip/wms-feature-info-loader.ts +28 -0
  369. package/src/wms/wip/wms-layer-description-loader-with-parser.ts +25 -0
  370. package/src/wms/wip/wms-layer-description-loader.md.disabled.md +47 -0
  371. package/src/wms/wip/wms-layer-description-loader.ts +28 -0
  372. package/src/wms/wip/wmts-capabilities-loader-with-parser.ts +30 -0
  373. package/src/wms/wip/wmts-capabilities-loader.ts +52 -0
  374. package/src/wms/wms-capabilities-loader-with-parser.ts +45 -0
  375. package/src/wms/wms-capabilities-loader.ts +68 -0
  376. package/src/wms/wms-error-loader-with-parser.ts +44 -0
  377. package/src/wms/wms-error-loader.ts +56 -0
  378. package/src/wms/wms-format.ts +52 -0
  379. package/src/wms/wms-source-loader.ts +686 -0
  380. package/src/wms/wmts-capabilities-loader-with-parser.ts +17 -0
  381. package/src/wms/wmts-capabilities-loader.ts +30 -0
  382. package/src/wms/wmts-source-loader.ts +649 -0
@@ -0,0 +1,30 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {Loader, LoaderOptions} from '@loaders.gl/core/loader-utils';
6
+ import type {WMTSCapabilities} from './lib/parsers/wmts/parse-wmts-capabilities';
7
+ import {WMTSCapabilitiesFormat} from './wms-format';
8
+
9
+ export type WMTSLoaderOptions = LoaderOptions & {wmts?: Record<string, unknown>};
10
+
11
+ /** Metadata-only loader for WMTS GetCapabilities responses. */
12
+ export const WMTSCapabilitiesLoader = {
13
+ ...WMTSCapabilitiesFormat,
14
+ dataType: null as unknown as WMTSCapabilities,
15
+ batchType: null as never,
16
+ name: 'WMTS Capabilities',
17
+ id: 'wmts-capabilities',
18
+ module: 'ogc',
19
+ version: '0.0.0',
20
+ worker: false,
21
+ encoding: 'xml',
22
+ format: 'wmts-capabilities',
23
+ text: true,
24
+ extensions: ['xml'],
25
+ mimeTypes: ['application/vnd.ogc.wmts_xml', 'application/xml', 'text/xml'],
26
+ options: {wmts: {}},
27
+ preload: async () =>
28
+ (await import('@loaders.gl/ogc/wms/wmts-capabilities-loader-with-parser'))
29
+ .WMTSCapabilitiesLoaderWithParser
30
+ } as const satisfies Loader<WMTSCapabilities, never, WMTSLoaderOptions>;
@@ -0,0 +1,649 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {ImageType, ImageLoaderOptions} from '@loaders.gl/images';
6
+ import {ImageLoader} from '@loaders.gl/images';
7
+ import type {
8
+ CoreAPI,
9
+ DataSourceOptions,
10
+ GetTileDataParameters,
11
+ GetTileParameters,
12
+ SourceLoader,
13
+ TileGrid,
14
+ TileGridMatrix,
15
+ TileSource,
16
+ TileSourceMetadata
17
+ } from '@loaders.gl/core/loader-utils';
18
+ import {DataSource} from '@loaders.gl/core/loader-utils';
19
+ import {parseXMLTextSync} from './lib/parsers/xml/parse-xml-text';
20
+ import type {
21
+ WMTSCapabilities,
22
+ WMTSTileMatrixSet,
23
+ WMTSTileMatrix,
24
+ WMTSLayer
25
+ } from './lib/parsers/wmts/parse-wmts-capabilities';
26
+ import {
27
+ parseWMTSCapabilities,
28
+ validateTileMatrixLimits
29
+ } from './lib/parsers/wmts/parse-wmts-capabilities';
30
+ import {areServiceCRSEquivalent, getServiceCRSAxisOrder, type ServiceCRS} from './crs-utils';
31
+ import {
32
+ createTileGrid,
33
+ createTileGridMatrix,
34
+ getMetersPerUnit,
35
+ getRequestedTileMatrix,
36
+ getScaleDenominatorResolution,
37
+ validateMetersPerUnit
38
+ } from './lib/tile-grid';
39
+
40
+ /** Options for a WMTS tile source. */
41
+ export type WMTSSourceLoaderOptions = DataSourceOptions &
42
+ ImageLoaderOptions & {
43
+ wmts?: {
44
+ /** WMTS layer identifier. */
45
+ layer?: string;
46
+ /** WMTS tile matrix set identifier. */
47
+ tileMatrixSet?: string;
48
+ /** WMTS style identifier. */
49
+ style?: string;
50
+ /** Tile MIME type. */
51
+ format?: string;
52
+ /** REST template containing `{TileMatrix}`, `{TileRow}`, and `{TileCol}`. */
53
+ urlTemplate?: string;
54
+ /** Feature-info MIME type; defaults to the first advertised format. */
55
+ infoFormat?: string;
56
+ /** Explicit KVP feature-info endpoint, overriding advertised operation metadata. */
57
+ featureInfoUrl?: string;
58
+ /** REST feature-info template containing tile coordinates and pixel placeholders {I}/{J}. */
59
+ featureInfoUrlTemplate?: string;
60
+ /** Dimension overrides and extra parameters. Generated request fields take precedence. */
61
+ parameters?: Record<string, string>;
62
+ /** Capabilities document or URL used to derive layer and tile matrix options. */
63
+ capabilities?: WMTSCapabilities;
64
+ /** URL used to load capabilities before async tile requests. */
65
+ capabilitiesUrl?: string;
66
+ /** Preferred coordinate reference system for matrix-set selection. */
67
+ crs?: ServiceCRS;
68
+ /**
69
+ * Length of one CRS unit in meters, used to convert scale denominators to resolutions for
70
+ * CRSs whose unit is not built in, such as UTM (`1`). EPSG:4326, CRS:84 and Web Mercator
71
+ * always use their own units, whichever matrix set is selected.
72
+ */
73
+ metersPerUnit?: number | null;
74
+ };
75
+ };
76
+
77
+ /** Tile and zero-based pixel coordinates for a WMTS GetFeatureInfo query. */
78
+ export type WMTSGetFeatureInfoParameters = GetTileParameters & {
79
+ /** Pixel column within the tile (OGC I), independent of screen coordinates. */
80
+ pixelColumn: number;
81
+ /** Pixel row within the tile (OGC J), independent of screen coordinates. */
82
+ pixelRow: number;
83
+ /** Per-request feature-info MIME type, overriding the configured or advertised default. */
84
+ infoFormat?: string;
85
+ };
86
+
87
+ /** A WMTS source that fetches image tiles and feature information through REST or KVP requests. */
88
+ export class WMTSImageTileSource
89
+ extends DataSource<string, WMTSSourceLoaderOptions>
90
+ implements TileSource
91
+ {
92
+ /** MIME type rendered by the generic deck.gl tile adapter. */
93
+ readonly mimeType = 'image/png';
94
+
95
+ /** In-flight or successful capability request. */
96
+ private _capabilitiesPromise: Promise<WMTSCapabilities | null> | null = null;
97
+ /** Parsed capabilities used by synchronous URL generation. */
98
+ private _capabilities: WMTSCapabilities | null = null;
99
+
100
+ /** Creates a WMTS source. */
101
+ constructor(url: string, options: WMTSSourceLoaderOptions = {}, coreApi?: CoreAPI) {
102
+ super(url, options, WMTSSourceLoader.defaultOptions, coreApi);
103
+ validateMetersPerUnit(options.wmts?.metersPerUnit, 'WMTS');
104
+ this._capabilities = options.wmts?.capabilities || null;
105
+ this.getTileData = this.getTileData.bind(this);
106
+ }
107
+
108
+ /** Returns metadata available from source options. */
109
+ async getMetadata(): Promise<TileSourceMetadata> {
110
+ const capabilities = await this._loadCapabilities();
111
+ const layer = this._getLayer(capabilities);
112
+ const wmts = this.options.wmts || {};
113
+ const matrixSet = this._getTileMatrixSet(layer);
114
+ const grid = toTileGrid(matrixSet, wmts.metersPerUnit);
115
+ const limits = layer?.tileMatrixSetLinks.find(
116
+ link => link.tileMatrixSet === matrixSet?.identifier
117
+ )?.limits;
118
+ if (grid && limits !== undefined) {
119
+ validateTileMatrixLimits(limits);
120
+ grid.limits = limits.map(limit => ({
121
+ tileMatrix: limit.tileMatrix,
122
+ minTileColumn: limit.minimumTileColumn,
123
+ maxTileColumn: limit.maximumTileColumn,
124
+ minTileRow: limit.minimumTileRow,
125
+ maxTileRow: limit.maximumTileRow
126
+ }));
127
+ }
128
+ return {
129
+ format: wmts.format || layer?.formats[0] || 'image/png',
130
+ name: wmts.layer || layer?.identifier || '',
131
+ title: layer?.title,
132
+ abstract: layer?.abstract || capabilities?.serviceIdentification?.abstract,
133
+ boundingBox: layer?.bounds
134
+ ? [
135
+ [layer.bounds[0], layer.bounds[1]],
136
+ [layer.bounds[2], layer.bounds[3]]
137
+ ]
138
+ : undefined,
139
+ layer: {name: wmts.layer || layer?.identifier || '', layers: []},
140
+ tileGrid: grid
141
+ };
142
+ }
143
+
144
+ /** Fetches and decodes one tile; returns null outside advertised coverage without a tile fetch. */
145
+ async getTile(parameters: GetTileParameters, signal?: AbortSignal): Promise<ImageType | null> {
146
+ validateTileIndices(parameters);
147
+ await this._loadCapabilities();
148
+ if (!this.isTileAvailable(parameters)) return null;
149
+ const requestSignal = signal || parameters.signal;
150
+ const response = await this.fetch(
151
+ this.getTileURL(parameters),
152
+ requestSignal ? {signal: requestSignal} : undefined
153
+ );
154
+ if (!response.ok) {
155
+ throw new Error(`WMTS tile request failed: ${response.status} ${response.statusText}`);
156
+ }
157
+ return (await this.coreApi.parse(
158
+ await response.arrayBuffer(),
159
+ ImageLoader,
160
+ this.loadOptions
161
+ )) as ImageType;
162
+ }
163
+
164
+ /** Fetches a tile using the deck.gl-compatible request shape. */
165
+ async getTileData(parameters: GetTileDataParameters): Promise<ImageType | null> {
166
+ return this.getTile(
167
+ {...parameters.index, tileMatrix: parameters.tileMatrix, signal: parameters.signal},
168
+ parameters.signal
169
+ );
170
+ }
171
+
172
+ /**
173
+ * Tests the selected layer's advertised tile coverage, not the existence of a tile on the server.
174
+ * Await getMetadata() first when capabilities are supplied by URL. Invalid indices throw.
175
+ * Missing limits use full matrix dimensions; no capabilities means coverage is unknown/allowed.
176
+ */
177
+ isTileAvailable(parameters: GetTileParameters): boolean {
178
+ validateTileIndices(parameters);
179
+ const layerName = parameters.layers ? String(parameters.layers) : this.options.wmts?.layer;
180
+ const layer = this._getLayer(this._capabilities, layerName);
181
+ const tileMatrixSet = this._getTileMatrixSet(layer);
182
+ if (!tileMatrixSet) return true;
183
+ const matrix = getTileMatrix(tileMatrixSet, parameters);
184
+ if (!matrix) return false;
185
+ for (const size of [matrix.matrixWidth, matrix.matrixHeight]) {
186
+ if (size !== undefined && (!Number.isSafeInteger(size) || size < 1))
187
+ throw new Error('WMTS matrix dimensions require positive safe integers');
188
+ }
189
+ const limits = layer?.tileMatrixSetLinks.find(
190
+ link => link.tileMatrixSet === tileMatrixSet.identifier
191
+ )?.limits;
192
+ if (limits !== undefined) {
193
+ validateTileMatrixLimits(limits);
194
+ const limit = limits.find(candidate => candidate.tileMatrix === matrix.identifier);
195
+ if (!limit) return false;
196
+ if (
197
+ (matrix.matrixWidth !== undefined && limit.maximumTileColumn >= matrix.matrixWidth) ||
198
+ (matrix.matrixHeight !== undefined && limit.maximumTileRow >= matrix.matrixHeight)
199
+ )
200
+ throw new Error('WMTS tile matrix limits exceed matrix dimensions');
201
+ if (
202
+ parameters.x < limit.minimumTileColumn ||
203
+ parameters.x > limit.maximumTileColumn ||
204
+ parameters.y < limit.minimumTileRow ||
205
+ parameters.y > limit.maximumTileRow
206
+ )
207
+ return false;
208
+ }
209
+ return (
210
+ (matrix.matrixWidth === undefined || parameters.x < matrix.matrixWidth) &&
211
+ (matrix.matrixHeight === undefined || parameters.y < matrix.matrixHeight)
212
+ );
213
+ }
214
+
215
+ /** Builds a REST or KVP URL with dimension defaults; throws outside advertised tile coverage. */
216
+ getTileURL(parameters: GetTileParameters): string {
217
+ if (!this.isTileAvailable(parameters))
218
+ throw new RangeError('WMTS tile is outside advertised coverage');
219
+ return this._getRequestURL(parameters);
220
+ }
221
+
222
+ /**
223
+ * Builds a feature-info URL for an available tile and valid pixel. Load URL-based metadata first.
224
+ * Advertised per-level tile dimensions bound I/J; unknown dimensions are not guessed.
225
+ */
226
+ getFeatureInfoURL(parameters: WMTSGetFeatureInfoParameters): string {
227
+ validateFeatureInfoIndices(parameters);
228
+ if (!this.isTileAvailable(parameters))
229
+ throw new RangeError('WMTS tile is outside advertised coverage');
230
+ const layer = this._getLayer(
231
+ this._capabilities,
232
+ parameters.layers ? String(parameters.layers) : undefined
233
+ );
234
+ const tileMatrixSet = this._getTileMatrixSet(layer);
235
+ const matrix = tileMatrixSet ? getTileMatrix(tileMatrixSet, parameters) : undefined;
236
+ for (const [value, size] of [
237
+ [parameters.pixelColumn, matrix?.tileWidth],
238
+ [parameters.pixelRow, matrix?.tileHeight]
239
+ ]) {
240
+ if (size !== undefined) {
241
+ if (!Number.isSafeInteger(size) || size < 1)
242
+ throw new Error('WMTS tile dimensions require positive safe integers');
243
+ if (value! >= size)
244
+ throw new RangeError('WMTS feature-info pixel is outside tile dimensions');
245
+ }
246
+ }
247
+ return this._getRequestURL(parameters, this._getFeatureInfoFormat(parameters, layer));
248
+ }
249
+
250
+ /** Returns native JSON for JSON formats, or unchanged response text for other formats. */
251
+ async getFeatureInfo(
252
+ parameters: WMTSGetFeatureInfoParameters,
253
+ signal?: AbortSignal
254
+ ): Promise<unknown | null> {
255
+ const result = await this._getFeatureInfoResponse(parameters, signal);
256
+ if (result === null) return null;
257
+ const format = result.infoFormat.split(';')[0].trim().toLowerCase();
258
+ return format === 'application/json' || format.endsWith('+json')
259
+ ? JSON.parse(result.text)
260
+ : result.text;
261
+ }
262
+
263
+ /** Fetches feature-info text, forwarding cancellation; unavailable tiles return null without a query. */
264
+ async getFeatureInfoText(
265
+ parameters: WMTSGetFeatureInfoParameters,
266
+ signal?: AbortSignal
267
+ ): Promise<string | null> {
268
+ return (await this._getFeatureInfoResponse(parameters, signal))?.text ?? null;
269
+ }
270
+
271
+ /** Captures the negotiated format before fetching so later source-option updates cannot change decoding. */
272
+ private async _getFeatureInfoResponse(
273
+ parameters: WMTSGetFeatureInfoParameters,
274
+ signal?: AbortSignal
275
+ ): Promise<{
276
+ /** Format sent with this request. */
277
+ infoFormat: string;
278
+ /** Unmodified service response text. */
279
+ text: string;
280
+ } | null> {
281
+ validateFeatureInfoIndices(parameters);
282
+ await this._loadCapabilities();
283
+ if (!this.isTileAvailable(parameters)) return null;
284
+ const url = this.getFeatureInfoURL(parameters);
285
+ const layer = this._getLayer(
286
+ this._capabilities,
287
+ parameters.layers ? String(parameters.layers) : undefined
288
+ );
289
+ const infoFormat = this._getFeatureInfoFormat(parameters, layer);
290
+ const requestSignal = signal || parameters.signal;
291
+ const response = await this.fetch(url, requestSignal ? {signal: requestSignal} : undefined);
292
+ const text = await response.text();
293
+ checkFeatureInfoException(text);
294
+ if (!response.ok)
295
+ throw new Error(
296
+ 'WMTS feature-info request failed: ' + response.status + ' ' + response.statusText
297
+ );
298
+ return {text, infoFormat};
299
+ }
300
+
301
+ /** Selects an explicit or advertised format without silently substituting an unsupported format. */
302
+ private _getFeatureInfoFormat(
303
+ parameters: WMTSGetFeatureInfoParameters,
304
+ layer: WMTSLayer | undefined
305
+ ): string {
306
+ const format =
307
+ parameters.infoFormat ||
308
+ this.options.wmts?.infoFormat ||
309
+ layer?.infoFormats?.[0] ||
310
+ layer?.resourceURLs.find(resource => resource.resourceType === 'FeatureInfo')?.format;
311
+ if (!format)
312
+ throw new Error(
313
+ 'Missing WMTS feature-info format; configure or load queryable layer metadata'
314
+ );
315
+ if (layer?.infoFormats?.length && !layer.infoFormats.includes(format))
316
+ throw new Error('Unsupported WMTS feature-info format: ' + format);
317
+ return format;
318
+ }
319
+
320
+ /** Shares tile identity, dimensions, and authoritative request parameters between both operations. */
321
+ private _getRequestURL(
322
+ parameters: GetTileParameters | WMTSGetFeatureInfoParameters,
323
+ infoFormat?: string
324
+ ): string {
325
+ const featureInfo = infoFormat ? (parameters as WMTSGetFeatureInfoParameters) : undefined;
326
+ const wmts = this.options.wmts || {};
327
+ const layerName = parameters.layers ? String(parameters.layers) : wmts.layer;
328
+ const layer = this._getLayer(this._capabilities, layerName);
329
+ const format = parameters.format || wmts.format || layer?.formats[0] || 'image/png';
330
+ const style =
331
+ wmts.style ||
332
+ layer?.styles.find(candidate => candidate.isDefault)?.identifier ||
333
+ layer?.styles[0]?.identifier ||
334
+ 'default';
335
+ const resourceURL = layer?.resourceURLs.find(
336
+ resource =>
337
+ (featureInfo
338
+ ? resource.resourceType === 'FeatureInfo'
339
+ : !resource.resourceType || resource.resourceType === 'tile') &&
340
+ (!resource.format || resource.format === (infoFormat || format))
341
+ );
342
+ const urlTemplate =
343
+ (featureInfo ? wmts.featureInfoUrlTemplate : wmts.urlTemplate) || resourceURL?.template;
344
+ const tileMatrixSet = this._getTileMatrixSet(layer);
345
+ // Without a known matrix set, an explicit identifier is used verbatim, otherwise `z`.
346
+ const tileMatrixIdentifier =
347
+ (tileMatrixSet && getTileMatrix(tileMatrixSet, parameters)?.identifier) ||
348
+ parameters.tileMatrix ||
349
+ String(parameters.z);
350
+ const dimensionParameters = this._getDimensionParameters(layer);
351
+ if (urlTemplate) {
352
+ const replacements = mergeRequestParameters(dimensionParameters, {
353
+ Layer: layerName || layer?.identifier || '',
354
+ Style: style,
355
+ Format: format,
356
+ ...(featureInfo
357
+ ? {
358
+ InfoFormat: infoFormat!,
359
+ I: String(featureInfo.pixelColumn),
360
+ J: String(featureInfo.pixelRow)
361
+ }
362
+ : {}),
363
+ TileMatrix: tileMatrixIdentifier,
364
+ TileRow: String(parameters.y),
365
+ TileCol: String(parameters.x),
366
+ TileMatrixSet: tileMatrixSet?.identifier || wmts.tileMatrixSet || ''
367
+ });
368
+ const expandedURL = urlTemplate.replace(/\{([^{}]+)\}/g, (placeholder, key: string) => {
369
+ const value = getRequestParameter(replacements, key);
370
+ if (value === undefined) throw new Error(`Missing WMTS template parameter: ${key}`);
371
+ return encodeURIComponent(value);
372
+ });
373
+ return featureInfo ? new URL(expandedURL, this.url).toString() : expandedURL;
374
+ }
375
+ if (featureInfo && !wmts.featureInfoUrl && this._capabilities?.featureInfoUrl === null)
376
+ throw new Error(
377
+ 'WMTS metadata advertises no KVP feature-info endpoint; configure a query URL or REST template'
378
+ );
379
+ const endpoint = featureInfo
380
+ ? wmts.featureInfoUrl || this._capabilities?.featureInfoUrl || this.url
381
+ : this.url;
382
+ const url = new URL(endpoint, this.url);
383
+ const searchParameters = new URLSearchParams(
384
+ mergeRequestParameters(dimensionParameters, {
385
+ SERVICE: 'WMTS',
386
+ REQUEST: featureInfo ? 'GetFeatureInfo' : 'GetTile',
387
+ VERSION: '1.0.0',
388
+ LAYER: layerName || layer?.identifier || '',
389
+ STYLE: style,
390
+ TILEMATRIXSET: tileMatrixSet?.identifier || wmts.tileMatrixSet || '',
391
+ TILEMATRIX: tileMatrixIdentifier,
392
+ TILEROW: String(parameters.y),
393
+ TILECOL: String(parameters.x),
394
+ FORMAT: format,
395
+ ...(featureInfo
396
+ ? {
397
+ INFOFORMAT: infoFormat!,
398
+ I: String(featureInfo.pixelColumn),
399
+ J: String(featureInfo.pixelRow)
400
+ }
401
+ : {})
402
+ })
403
+ );
404
+ for (const [key, value] of searchParameters) {
405
+ for (const existingKey of [...url.searchParams.keys()]) {
406
+ if (existingKey.toUpperCase() === key.toUpperCase()) url.searchParams.delete(existingKey);
407
+ }
408
+ url.searchParams.set(key, value);
409
+ }
410
+ return url.toString();
411
+ }
412
+
413
+ /** Applies explicit options, then endpoint dimensions, then advertised defaults. */
414
+ private _getDimensionParameters(layer: WMTSLayer | undefined): Record<string, string> {
415
+ let parameters = mergeRequestParameters(this.options.wmts?.parameters || {});
416
+ const endpointParameters = Object.fromEntries(new URL(this.url).searchParams);
417
+ for (const dimension of layer?.dimensions || []) {
418
+ const value =
419
+ getRequestParameter(parameters, dimension.identifier) ??
420
+ getRequestParameter(endpointParameters, dimension.identifier) ??
421
+ dimension.default;
422
+ if (!dimension.identifier || value === undefined || !value.trim())
423
+ throw new Error('Missing WMTS dimension value: ' + (dimension.identifier || '(unnamed)'));
424
+ parameters = mergeRequestParameters(parameters, {[dimension.identifier]: value});
425
+ }
426
+ return parameters;
427
+ }
428
+
429
+ /** Loads and caches capabilities; failed requests can be retried. */
430
+ private async _loadCapabilities(): Promise<WMTSCapabilities | null> {
431
+ if (this._capabilitiesPromise) return this._capabilitiesPromise;
432
+ const configuredCapabilities = this.options.wmts?.capabilities;
433
+ const capabilitiesUrl = this.options.wmts?.capabilitiesUrl;
434
+ this._capabilitiesPromise = configuredCapabilities
435
+ ? Promise.resolve(configuredCapabilities)
436
+ : capabilitiesUrl
437
+ ? this.fetch(capabilitiesUrl).then(async response => {
438
+ if (!response.ok)
439
+ throw new Error(`WMTS capabilities request failed: ${response.status}`);
440
+ return parseWMTSCapabilities(await response.text());
441
+ })
442
+ : Promise.resolve(null);
443
+ try {
444
+ this._capabilities = await this._capabilitiesPromise;
445
+ return this._capabilities;
446
+ } catch (error) {
447
+ this._capabilitiesPromise = null;
448
+ throw error;
449
+ }
450
+ }
451
+
452
+ /** Resolves the requested layer and rejects unknown identifiers. */
453
+ private _getLayer(
454
+ capabilities: WMTSCapabilities | null,
455
+ layerName: string | undefined = this.options.wmts?.layer
456
+ ): WMTSLayer | undefined {
457
+ const layer = capabilities?.contents.layers.find(
458
+ candidate => !layerName || candidate.identifier === layerName
459
+ );
460
+ if (capabilities && layerName && !layer) throw new Error(`Unknown WMTS layer: ${layerName}`);
461
+ return layer;
462
+ }
463
+
464
+ /** Selects a linked tile matrix set using an explicit identifier or compatible CRS. */
465
+ private _getTileMatrixSet(layer: WMTSLayer | undefined) {
466
+ const capabilities = this._capabilities;
467
+ const wmts = this.options.wmts || {};
468
+ const linkedIdentifiers = layer?.tileMatrixSetLinks.map(link => link.tileMatrixSet) || [];
469
+ const candidates =
470
+ capabilities?.contents.tileMatrixSets.filter(tileMatrixSet =>
471
+ linkedIdentifiers.includes(tileMatrixSet.identifier)
472
+ ) || [];
473
+ const requestedCRS = wmts.crs;
474
+ if (wmts.tileMatrixSet) {
475
+ const selected = candidates.find(candidate => candidate.identifier === wmts.tileMatrixSet);
476
+ if (capabilities && !selected)
477
+ throw new Error(`WMTS matrix set is not linked to layer: ${wmts.tileMatrixSet}`);
478
+ if (
479
+ selected &&
480
+ requestedCRS !== undefined &&
481
+ !areServiceCRSEquivalent(requestedCRS, selected.supportedCRS)
482
+ ) {
483
+ throw new Error(`WMTS matrix set does not support ${requestedCRS}`);
484
+ }
485
+ return selected;
486
+ }
487
+ if (requestedCRS !== undefined && capabilities) {
488
+ const selected = candidates.find(candidate =>
489
+ areServiceCRSEquivalent(requestedCRS, candidate.supportedCRS)
490
+ );
491
+ if (!selected) throw new Error(`No linked WMTS matrix set supports ${requestedCRS}`);
492
+ return selected;
493
+ }
494
+ if (candidates.length) return candidates[0];
495
+ return undefined;
496
+ }
497
+ }
498
+
499
+ /** Converts a WMTS matrix set into the shared tile-grid metadata shape. */
500
+ function toTileGrid(
501
+ tileMatrixSet: WMTSTileMatrixSet | undefined,
502
+ metersPerUnit?: number | null
503
+ ): TileGrid | undefined {
504
+ if (!tileMatrixSet) return undefined;
505
+ // Also checked here, since `setProps()` can change the option after construction.
506
+ validateMetersPerUnit(metersPerUnit, 'WMTS');
507
+ const crs = tileMatrixSet.supportedCRS;
508
+ const unitMeters = getMetersPerUnit(crs, metersPerUnit);
509
+ const swapAxes = getServiceCRSAxisOrder(crs) === 'yx';
510
+ return createTileGrid(
511
+ crs,
512
+ tileMatrixSet.matrices.map(matrix => toTileGridMatrix(matrix, swapAxes, unitMeters))
513
+ );
514
+ }
515
+
516
+ /** Converts one WMTS matrix, keeping only the fields the service advertises. */
517
+ function toTileGridMatrix(
518
+ matrix: WMTSTileMatrix,
519
+ swapAxes: boolean,
520
+ metersPerUnit: number | undefined
521
+ ): TileGridMatrix {
522
+ return createTileGridMatrix({
523
+ id: matrix.identifier,
524
+ resolution: getScaleDenominatorResolution(matrix.scaleDenominator, metersPerUnit),
525
+ point: matrix.topLeftCorner,
526
+ swapAxes,
527
+ tileWidth: matrix.tileWidth,
528
+ tileHeight: matrix.tileHeight,
529
+ matrixWidth: matrix.matrixWidth,
530
+ matrixHeight: matrix.matrixHeight
531
+ });
532
+ }
533
+
534
+ /** Selects the requested matrix; see `getRequestedTileMatrix()`. */
535
+ function getTileMatrix(
536
+ tileMatrixSet: WMTSTileMatrixSet,
537
+ parameters: Pick<GetTileParameters, 'z' | 'tileMatrix'>
538
+ ): WMTSTileMatrix | undefined {
539
+ return getRequestedTileMatrix(tileMatrixSet.matrices, matrix => matrix.identifier, parameters);
540
+ }
541
+
542
+ /** Rejects invalid indices before URL generation or network access; tiles never wrap implicitly. */
543
+ function validateTileIndices(parameters: GetTileParameters): void {
544
+ for (const [name, value] of Object.entries({x: parameters.x, y: parameters.y, z: parameters.z})) {
545
+ if (!Number.isSafeInteger(value) || value < 0)
546
+ throw new RangeError('WMTS ' + name + ' must be a nonnegative safe integer');
547
+ }
548
+ }
549
+
550
+ /** Rejects invalid tile/pixel coordinates before capabilities or feature-info fetches. */
551
+ function validateFeatureInfoIndices(parameters: WMTSGetFeatureInfoParameters): void {
552
+ validateTileIndices(parameters);
553
+ for (const value of [parameters.pixelColumn, parameters.pixelRow]) {
554
+ if (!Number.isSafeInteger(value) || value < 0)
555
+ throw new RangeError('WMTS feature-info pixels require nonnegative safe integers');
556
+ }
557
+ }
558
+
559
+ /** Recognizes OWS exception reports even when the service responds with HTTP 200. */
560
+ function checkFeatureInfoException(text: string): void {
561
+ const rootOffset = getExceptionReportRootOffset(text);
562
+ if (rootOffset === undefined) return;
563
+ const parsed = parseXMLTextSync(text.slice(rootOffset), {
564
+ xml: {
565
+ _parser: 'internal',
566
+ removeNSPrefix: true,
567
+ uncapitalizeKeys: true,
568
+ textNodeName: '#text',
569
+ _fastXML: {parseTagValue: false}
570
+ }
571
+ });
572
+ const report = parsed.exceptionReport;
573
+ if (report === undefined) return;
574
+ const exceptions = Array.isArray(report?.exception) ? report.exception : [report?.exception];
575
+ const messages = exceptions.map((exception: any) => {
576
+ const values = Array.isArray(exception?.exceptionText)
577
+ ? exception.exceptionText
578
+ : [exception?.exceptionText];
579
+ return (
580
+ values
581
+ .map((value: any) => (typeof value === 'object' ? value?.['#text'] : value))
582
+ .filter(Boolean)
583
+ .join('; ') ||
584
+ exception?.exceptionCode ||
585
+ 'server error'
586
+ );
587
+ });
588
+ throw new Error('WMTS feature-info: ' + messages.join('; '));
589
+ }
590
+
591
+ /** Returns the exception root offset after a linear scan of XML whitespace, comments and instructions. */
592
+ function getExceptionReportRootOffset(text: string): number | undefined {
593
+ let offset = 0;
594
+ while (offset < text.length) {
595
+ while (offset < text.length && /\s/.test(text[offset])) offset++;
596
+ const terminator = text.startsWith('<?', offset)
597
+ ? '?>'
598
+ : text.startsWith('<!--', offset)
599
+ ? '-->'
600
+ : undefined;
601
+ if (!terminator) {
602
+ return /^<(?:[^\s<>:]+:)?ExceptionReport(?:\s|\/?>)/.test(text.slice(offset))
603
+ ? offset
604
+ : undefined;
605
+ }
606
+ const ending = text.indexOf(terminator, offset + (terminator === '?>' ? 2 : 4));
607
+ if (ending === -1) return undefined;
608
+ offset = ending + terminator.length;
609
+ }
610
+ return undefined;
611
+ }
612
+
613
+ /** Merges case-insensitive KVP names so generated request fields cannot be overridden by extras. */
614
+ function mergeRequestParameters(...groups: Record<string, string>[]): Record<string, string> {
615
+ const result: Record<string, string> = {};
616
+ for (const group of groups) {
617
+ for (const [name, value] of Object.entries(group)) {
618
+ for (const existingName of Object.keys(result))
619
+ if (existingName.toUpperCase() === name.toUpperCase()) delete result[existingName];
620
+ result[name] = value;
621
+ }
622
+ }
623
+ return result;
624
+ }
625
+
626
+ /** Looks up a dimension or template parameter without changing its value's case. */
627
+ function getRequestParameter(parameters: Record<string, string>, name: string): string | undefined {
628
+ return Object.entries(parameters).find(([key]) => key.toUpperCase() === name.toUpperCase())?.[1];
629
+ }
630
+
631
+ /** Source loader for WMTS image tiles. */
632
+ export const WMTSSourceLoader = {
633
+ dataType: null as unknown as WMTSImageTileSource,
634
+ batchType: null as never,
635
+ name: 'Web Map Tile Service (OGC WMTS)',
636
+ id: 'wmts',
637
+ module: 'ogc',
638
+ version: '0.0.0',
639
+ extensions: [],
640
+ mimeTypes: [],
641
+ type: 'wmts',
642
+ fromUrl: true,
643
+ fromBlob: false,
644
+ options: {wmts: {}},
645
+ defaultOptions: {wmts: {}},
646
+ testURL: (url: string): boolean => /wmts|GetTile/i.test(url),
647
+ createDataSource: (url: string, options: WMTSSourceLoaderOptions = {}, coreApi?: CoreAPI) =>
648
+ new WMTSImageTileSource(url, options, coreApi)
649
+ } as const satisfies SourceLoader<WMTSImageTileSource>;