@loaders.gl/geospatial 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 (421) hide show
  1. package/README.md +8 -2
  2. package/dist/dbf-worker.js +17055 -0
  3. package/dist/dbf.d.ts +2 -0
  4. package/dist/dbf.d.ts.map +1 -0
  5. package/dist/dbf.js +5 -0
  6. package/dist/dbf.js.map +1 -0
  7. package/dist/flatgeobuf/bundled.d.ts +3 -0
  8. package/dist/flatgeobuf/bundled.d.ts.map +1 -0
  9. package/dist/flatgeobuf/bundled.js +5 -0
  10. package/dist/flatgeobuf/bundled.js.map +1 -0
  11. package/dist/flatgeobuf/flatgeobuf-format.d.ts +12 -0
  12. package/dist/flatgeobuf/flatgeobuf-format.d.ts.map +1 -0
  13. package/dist/flatgeobuf/flatgeobuf-format.js +15 -0
  14. package/dist/flatgeobuf/flatgeobuf-format.js.map +1 -0
  15. package/dist/flatgeobuf/flatgeobuf-loader-types.d.ts +104 -0
  16. package/dist/flatgeobuf/flatgeobuf-loader-types.d.ts.map +1 -0
  17. package/dist/flatgeobuf/flatgeobuf-loader-types.js +36 -0
  18. package/dist/flatgeobuf/flatgeobuf-loader-types.js.map +1 -0
  19. package/dist/flatgeobuf/flatgeobuf-loader.d.ts +59 -0
  20. package/dist/flatgeobuf/flatgeobuf-loader.d.ts.map +1 -0
  21. package/dist/flatgeobuf/flatgeobuf-loader.js +38 -0
  22. package/dist/flatgeobuf/flatgeobuf-loader.js.map +1 -0
  23. package/dist/flatgeobuf/flatgeobuf-source-loader.d.ts +105 -0
  24. package/dist/flatgeobuf/flatgeobuf-source-loader.d.ts.map +1 -0
  25. package/dist/flatgeobuf/flatgeobuf-source-loader.js +240 -0
  26. package/dist/flatgeobuf/flatgeobuf-source-loader.js.map +1 -0
  27. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.d.ts +4 -0
  28. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.d.ts.map +1 -0
  29. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.js +12 -0
  30. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.js.map +1 -0
  31. package/dist/flatgeobuf/index.cjs +5552 -0
  32. package/dist/flatgeobuf/index.cjs.map +6 -0
  33. package/dist/flatgeobuf/index.d.ts +9 -0
  34. package/dist/flatgeobuf/index.d.ts.map +1 -0
  35. package/dist/flatgeobuf/index.js +11 -0
  36. package/dist/flatgeobuf/index.js.map +1 -0
  37. package/dist/flatgeobuf/lib/flatgeobuf-reader.d.ts +97 -0
  38. package/dist/flatgeobuf/lib/flatgeobuf-reader.d.ts.map +1 -0
  39. package/dist/flatgeobuf/lib/flatgeobuf-reader.js +577 -0
  40. package/dist/flatgeobuf/lib/flatgeobuf-reader.js.map +1 -0
  41. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.d.ts +8 -0
  42. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.d.ts.map +1 -0
  43. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.js +44 -0
  44. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.js.map +1 -0
  45. package/dist/flatgeobuf/lib/parse-flatgeobuf.d.ts +36 -0
  46. package/dist/flatgeobuf/lib/parse-flatgeobuf.d.ts.map +1 -0
  47. package/dist/flatgeobuf/lib/parse-flatgeobuf.js +269 -0
  48. package/dist/flatgeobuf/lib/parse-flatgeobuf.js.map +1 -0
  49. package/dist/flatgeobuf/unbundled.d.ts +3 -0
  50. package/dist/flatgeobuf/unbundled.d.ts.map +1 -0
  51. package/dist/flatgeobuf/unbundled.js +5 -0
  52. package/dist/flatgeobuf/unbundled.js.map +1 -0
  53. package/dist/flatgeobuf-worker.js +31367 -0
  54. package/dist/flatgeobuf.d.ts +3 -0
  55. package/dist/flatgeobuf.d.ts.map +1 -0
  56. package/dist/flatgeobuf.js +5 -0
  57. package/dist/flatgeobuf.js.map +1 -0
  58. package/dist/geopackage/bundled.d.ts +3 -0
  59. package/dist/geopackage/bundled.d.ts.map +1 -0
  60. package/dist/geopackage/bundled.js +5 -0
  61. package/dist/geopackage/bundled.js.map +1 -0
  62. package/dist/geopackage/geopackage-format.d.ts +11 -0
  63. package/dist/geopackage/geopackage-format.d.ts.map +1 -0
  64. package/dist/geopackage/geopackage-format.js +14 -0
  65. package/dist/geopackage/geopackage-format.js.map +1 -0
  66. package/dist/geopackage/geopackage-loader-options.d.ts +5 -0
  67. package/dist/geopackage/geopackage-loader-options.d.ts.map +1 -0
  68. package/dist/geopackage/geopackage-loader-options.js +12 -0
  69. package/dist/geopackage/geopackage-loader-options.js.map +1 -0
  70. package/dist/geopackage/geopackage-loader-types.d.ts +72 -0
  71. package/dist/geopackage/geopackage-loader-types.d.ts.map +1 -0
  72. package/dist/geopackage/geopackage-loader-types.js +30 -0
  73. package/dist/geopackage/geopackage-loader-types.js.map +1 -0
  74. package/dist/geopackage/geopackage-loader.d.ts +26 -0
  75. package/dist/geopackage/geopackage-loader.d.ts.map +1 -0
  76. package/dist/geopackage/geopackage-loader.js +12 -0
  77. package/dist/geopackage/geopackage-loader.js.map +1 -0
  78. package/dist/geopackage/geopackage-source-loader.d.ts +99 -0
  79. package/dist/geopackage/geopackage-source-loader.d.ts.map +1 -0
  80. package/dist/geopackage/geopackage-source-loader.js +258 -0
  81. package/dist/geopackage/geopackage-source-loader.js.map +1 -0
  82. package/dist/geopackage/index.cjs +4443 -0
  83. package/dist/geopackage/index.cjs.map +6 -0
  84. package/dist/geopackage/index.d.ts +7 -0
  85. package/dist/geopackage/index.d.ts.map +1 -0
  86. package/dist/geopackage/index.js +7 -0
  87. package/dist/geopackage/index.js.map +1 -0
  88. package/dist/geopackage/lib/geopackage-tile-metadata.d.ts +22 -0
  89. package/dist/geopackage/lib/geopackage-tile-metadata.d.ts.map +1 -0
  90. package/dist/geopackage/lib/geopackage-tile-metadata.js +105 -0
  91. package/dist/geopackage/lib/geopackage-tile-metadata.js.map +1 -0
  92. package/dist/geopackage/lib/parse-geopackage.d.ts +39 -0
  93. package/dist/geopackage/lib/parse-geopackage.d.ts.map +1 -0
  94. package/dist/geopackage/lib/parse-geopackage.js +485 -0
  95. package/dist/geopackage/lib/parse-geopackage.js.map +1 -0
  96. package/dist/geopackage/lib/types.d.ts +216 -0
  97. package/dist/geopackage/lib/types.d.ts.map +1 -0
  98. package/dist/geopackage/lib/types.js +5 -0
  99. package/dist/geopackage/lib/types.js.map +1 -0
  100. package/dist/geopackage/unbundled.d.ts +3 -0
  101. package/dist/geopackage/unbundled.d.ts.map +1 -0
  102. package/dist/geopackage/unbundled.js +5 -0
  103. package/dist/geopackage/unbundled.js.map +1 -0
  104. package/dist/geopackage.d.ts +3 -0
  105. package/dist/geopackage.d.ts.map +1 -0
  106. package/dist/geopackage.js +5 -0
  107. package/dist/geopackage.js.map +1 -0
  108. package/dist/gpx.d.ts +2 -0
  109. package/dist/gpx.d.ts.map +1 -0
  110. package/dist/gpx.js +5 -0
  111. package/dist/gpx.js.map +1 -0
  112. package/dist/index.cjs +15221 -0
  113. package/dist/index.cjs.map +6 -0
  114. package/dist/index.d.ts +27 -0
  115. package/dist/index.d.ts.map +1 -0
  116. package/dist/index.js +20 -0
  117. package/dist/index.js.map +1 -0
  118. package/dist/kml/bundled.d.ts +13 -0
  119. package/dist/kml/bundled.d.ts.map +1 -0
  120. package/dist/kml/bundled.js +10 -0
  121. package/dist/kml/bundled.js.map +1 -0
  122. package/dist/kml/gpx-loader-types.d.ts +61 -0
  123. package/dist/kml/gpx-loader-types.d.ts.map +1 -0
  124. package/dist/kml/gpx-loader-types.js +25 -0
  125. package/dist/kml/gpx-loader-types.js.map +1 -0
  126. package/dist/kml/gpx-loader.d.ts +56 -0
  127. package/dist/kml/gpx-loader.d.ts.map +1 -0
  128. package/dist/kml/gpx-loader.js +62 -0
  129. package/dist/kml/gpx-loader.js.map +1 -0
  130. package/dist/kml/index.cjs +11444 -0
  131. package/dist/kml/index.cjs.map +6 -0
  132. package/dist/kml/index.d.ts +18 -0
  133. package/dist/kml/index.d.ts.map +1 -0
  134. package/dist/kml/index.js +13 -0
  135. package/dist/kml/index.js.map +1 -0
  136. package/dist/kml/kml-format.d.ts +50 -0
  137. package/dist/kml/kml-format.d.ts.map +1 -0
  138. package/dist/kml/kml-format.js +62 -0
  139. package/dist/kml/kml-format.js.map +1 -0
  140. package/dist/kml/kml-loader-types.d.ts +61 -0
  141. package/dist/kml/kml-loader-types.d.ts.map +1 -0
  142. package/dist/kml/kml-loader-types.js +25 -0
  143. package/dist/kml/kml-loader-types.js.map +1 -0
  144. package/dist/kml/kml-loader.d.ts +56 -0
  145. package/dist/kml/kml-loader.d.ts.map +1 -0
  146. package/dist/kml/kml-loader.js +60 -0
  147. package/dist/kml/kml-loader.js.map +1 -0
  148. package/dist/kml/kml-parser.d.ts +98 -0
  149. package/dist/kml/kml-parser.d.ts.map +1 -0
  150. package/dist/kml/kml-parser.js +461 -0
  151. package/dist/kml/kml-parser.js.map +1 -0
  152. package/dist/kml/kml-writer.d.ts +64 -0
  153. package/dist/kml/kml-writer.d.ts.map +1 -0
  154. package/dist/kml/kml-writer.js +202 -0
  155. package/dist/kml/kml-writer.js.map +1 -0
  156. package/dist/kml/kmz-archive.d.ts +19 -0
  157. package/dist/kml/kmz-archive.d.ts.map +1 -0
  158. package/dist/kml/kmz-archive.js +72 -0
  159. package/dist/kml/kmz-archive.js.map +1 -0
  160. package/dist/kml/kmz-loader-types.d.ts +58 -0
  161. package/dist/kml/kmz-loader-types.d.ts.map +1 -0
  162. package/dist/kml/kmz-loader-types.js +24 -0
  163. package/dist/kml/kmz-loader-types.js.map +1 -0
  164. package/dist/kml/kmz-loader.d.ts +29 -0
  165. package/dist/kml/kmz-loader.d.ts.map +1 -0
  166. package/dist/kml/kmz-loader.js +41 -0
  167. package/dist/kml/kmz-loader.js.map +1 -0
  168. package/dist/kml/kmz-source.d.ts +62 -0
  169. package/dist/kml/kmz-source.d.ts.map +1 -0
  170. package/dist/kml/kmz-source.js +177 -0
  171. package/dist/kml/kmz-source.js.map +1 -0
  172. package/dist/kml/lib/feature-collection-to-arrow.d.ts +90 -0
  173. package/dist/kml/lib/feature-collection-to-arrow.d.ts.map +1 -0
  174. package/dist/kml/lib/feature-collection-to-arrow.js +181 -0
  175. package/dist/kml/lib/feature-collection-to-arrow.js.map +1 -0
  176. package/dist/kml/sports-track-parser.d.ts +6 -0
  177. package/dist/kml/sports-track-parser.d.ts.map +1 -0
  178. package/dist/kml/sports-track-parser.js +411 -0
  179. package/dist/kml/sports-track-parser.js.map +1 -0
  180. package/dist/kml/tcx-loader-types.d.ts +61 -0
  181. package/dist/kml/tcx-loader-types.d.ts.map +1 -0
  182. package/dist/kml/tcx-loader-types.js +25 -0
  183. package/dist/kml/tcx-loader-types.js.map +1 -0
  184. package/dist/kml/tcx-loader.d.ts +56 -0
  185. package/dist/kml/tcx-loader.d.ts.map +1 -0
  186. package/dist/kml/tcx-loader.js +62 -0
  187. package/dist/kml/tcx-loader.js.map +1 -0
  188. package/dist/kml/unbundled.d.ts +13 -0
  189. package/dist/kml/unbundled.d.ts.map +1 -0
  190. package/dist/kml/unbundled.js +10 -0
  191. package/dist/kml/unbundled.js.map +1 -0
  192. package/dist/kml.d.ts +3 -0
  193. package/dist/kml.d.ts.map +1 -0
  194. package/dist/kml.js +5 -0
  195. package/dist/kml.js.map +1 -0
  196. package/dist/kmz.d.ts +2 -0
  197. package/dist/kmz.d.ts.map +1 -0
  198. package/dist/kmz.js +5 -0
  199. package/dist/kmz.js.map +1 -0
  200. package/dist/shapefile/bundled.d.ts +7 -0
  201. package/dist/shapefile/bundled.d.ts.map +1 -0
  202. package/dist/shapefile/bundled.js +7 -0
  203. package/dist/shapefile/bundled.js.map +1 -0
  204. package/dist/shapefile/dbf-format.d.ts +12 -0
  205. package/dist/shapefile/dbf-format.d.ts.map +1 -0
  206. package/dist/shapefile/dbf-format.js +15 -0
  207. package/dist/shapefile/dbf-format.js.map +1 -0
  208. package/dist/shapefile/dbf-loader-types.d.ts +15 -0
  209. package/dist/shapefile/dbf-loader-types.d.ts.map +1 -0
  210. package/dist/shapefile/dbf-loader-types.js +34 -0
  211. package/dist/shapefile/dbf-loader-types.js.map +1 -0
  212. package/dist/shapefile/dbf-loader.d.ts +48 -0
  213. package/dist/shapefile/dbf-loader.d.ts.map +1 -0
  214. package/dist/shapefile/dbf-loader.js +39 -0
  215. package/dist/shapefile/dbf-loader.js.map +1 -0
  216. package/dist/shapefile/index.cjs +5750 -0
  217. package/dist/shapefile/index.cjs.map +6 -0
  218. package/dist/shapefile/index.d.ts +16 -0
  219. package/dist/shapefile/index.d.ts.map +1 -0
  220. package/dist/shapefile/index.js +18 -0
  221. package/dist/shapefile/index.js.map +1 -0
  222. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.d.ts +18 -0
  223. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.d.ts.map +1 -0
  224. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.js +129 -0
  225. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.js.map +1 -0
  226. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.d.ts +12 -0
  227. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.d.ts.map +1 -0
  228. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.js +206 -0
  229. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.js.map +1 -0
  230. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.d.ts +26 -0
  231. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.d.ts.map +1 -0
  232. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.js +347 -0
  233. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.js.map +1 -0
  234. package/dist/shapefile/lib/parsers/parse-dbf.d.ts +14 -0
  235. package/dist/shapefile/lib/parsers/parse-dbf.d.ts.map +1 -0
  236. package/dist/shapefile/lib/parsers/parse-dbf.js +352 -0
  237. package/dist/shapefile/lib/parsers/parse-dbf.js.map +1 -0
  238. package/dist/shapefile/lib/parsers/parse-shapefile.d.ts +50 -0
  239. package/dist/shapefile/lib/parsers/parse-shapefile.d.ts.map +1 -0
  240. package/dist/shapefile/lib/parsers/parse-shapefile.js +306 -0
  241. package/dist/shapefile/lib/parsers/parse-shapefile.js.map +1 -0
  242. package/dist/shapefile/lib/parsers/parse-shp-geometry.d.ts +50 -0
  243. package/dist/shapefile/lib/parsers/parse-shp-geometry.d.ts.map +1 -0
  244. package/dist/shapefile/lib/parsers/parse-shp-geometry.js +384 -0
  245. package/dist/shapefile/lib/parsers/parse-shp-geometry.js.map +1 -0
  246. package/dist/shapefile/lib/parsers/parse-shp-header.d.ts +26 -0
  247. package/dist/shapefile/lib/parsers/parse-shp-header.d.ts.map +1 -0
  248. package/dist/shapefile/lib/parsers/parse-shp-header.js +43 -0
  249. package/dist/shapefile/lib/parsers/parse-shp-header.js.map +1 -0
  250. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.d.ts +5 -0
  251. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.d.ts.map +1 -0
  252. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.js +130 -0
  253. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.js.map +1 -0
  254. package/dist/shapefile/lib/parsers/parse-shp.d.ts +24 -0
  255. package/dist/shapefile/lib/parsers/parse-shp.d.ts.map +1 -0
  256. package/dist/shapefile/lib/parsers/parse-shp.js +194 -0
  257. package/dist/shapefile/lib/parsers/parse-shp.js.map +1 -0
  258. package/dist/shapefile/lib/parsers/parse-shx.d.ts +10 -0
  259. package/dist/shapefile/lib/parsers/parse-shx.d.ts.map +1 -0
  260. package/dist/shapefile/lib/parsers/parse-shx.js +28 -0
  261. package/dist/shapefile/lib/parsers/parse-shx.js.map +1 -0
  262. package/dist/shapefile/lib/parsers/types.d.ts +85 -0
  263. package/dist/shapefile/lib/parsers/types.d.ts.map +1 -0
  264. package/dist/shapefile/lib/parsers/types.js +5 -0
  265. package/dist/shapefile/lib/parsers/types.js.map +1 -0
  266. package/dist/shapefile/lib/shapefile-worker-transport.d.ts +10 -0
  267. package/dist/shapefile/lib/shapefile-worker-transport.d.ts.map +1 -0
  268. package/dist/shapefile/lib/shapefile-worker-transport.js +46 -0
  269. package/dist/shapefile/lib/shapefile-worker-transport.js.map +1 -0
  270. package/dist/shapefile/lib/streaming/binary-chunk-reader.d.ts +2 -0
  271. package/dist/shapefile/lib/streaming/binary-chunk-reader.d.ts.map +1 -0
  272. package/dist/shapefile/lib/streaming/binary-chunk-reader.js +5 -0
  273. package/dist/shapefile/lib/streaming/binary-chunk-reader.js.map +1 -0
  274. package/dist/shapefile/lib/streaming/binary-reader.d.ts +32 -0
  275. package/dist/shapefile/lib/streaming/binary-reader.d.ts.map +1 -0
  276. package/dist/shapefile/lib/streaming/binary-reader.js +55 -0
  277. package/dist/shapefile/lib/streaming/binary-reader.js.map +1 -0
  278. package/dist/shapefile/lib/streaming/zip-batch-iterators.d.ts +11 -0
  279. package/dist/shapefile/lib/streaming/zip-batch-iterators.d.ts.map +1 -0
  280. package/dist/shapefile/lib/streaming/zip-batch-iterators.js +67 -0
  281. package/dist/shapefile/lib/streaming/zip-batch-iterators.js.map +1 -0
  282. package/dist/shapefile/shapefile-arrow-loader.d.ts +8 -0
  283. package/dist/shapefile/shapefile-arrow-loader.d.ts.map +1 -0
  284. package/dist/shapefile/shapefile-arrow-loader.js +316 -0
  285. package/dist/shapefile/shapefile-arrow-loader.js.map +1 -0
  286. package/dist/shapefile/shapefile-loader-types.d.ts +80 -0
  287. package/dist/shapefile/shapefile-loader-types.d.ts.map +1 -0
  288. package/dist/shapefile/shapefile-loader-types.js +29 -0
  289. package/dist/shapefile/shapefile-loader-types.js.map +1 -0
  290. package/dist/shapefile/shapefile-loader.d.ts +57 -0
  291. package/dist/shapefile/shapefile-loader.d.ts.map +1 -0
  292. package/dist/shapefile/shapefile-loader.js +29 -0
  293. package/dist/shapefile/shapefile-loader.js.map +1 -0
  294. package/dist/shapefile/shp-format.d.ts +27 -0
  295. package/dist/shapefile/shp-format.d.ts.map +1 -0
  296. package/dist/shapefile/shp-format.js +31 -0
  297. package/dist/shapefile/shp-format.js.map +1 -0
  298. package/dist/shapefile/shp-loader-types.d.ts +28 -0
  299. package/dist/shapefile/shp-loader-types.d.ts.map +1 -0
  300. package/dist/shapefile/shp-loader-types.js +31 -0
  301. package/dist/shapefile/shp-loader-types.js.map +1 -0
  302. package/dist/shapefile/shp-loader.d.ts +53 -0
  303. package/dist/shapefile/shp-loader.d.ts.map +1 -0
  304. package/dist/shapefile/shp-loader.js +38 -0
  305. package/dist/shapefile/shp-loader.js.map +1 -0
  306. package/dist/shapefile/unbundled.d.ts +7 -0
  307. package/dist/shapefile/unbundled.d.ts.map +1 -0
  308. package/dist/shapefile/unbundled.js +7 -0
  309. package/dist/shapefile/unbundled.js.map +1 -0
  310. package/dist/shapefile.d.ts +3 -0
  311. package/dist/shapefile.d.ts.map +1 -0
  312. package/dist/shapefile.js +5 -0
  313. package/dist/shapefile.js.map +1 -0
  314. package/dist/shp-worker.js +20183 -0
  315. package/dist/shp.d.ts +2 -0
  316. package/dist/shp.d.ts.map +1 -0
  317. package/dist/shp.js +5 -0
  318. package/dist/shp.js.map +1 -0
  319. package/dist/tcx.d.ts +2 -0
  320. package/dist/tcx.d.ts.map +1 -0
  321. package/dist/tcx.js +5 -0
  322. package/dist/tcx.js.map +1 -0
  323. package/dist/workers/dbf-worker.d.ts +2 -0
  324. package/dist/workers/dbf-worker.d.ts.map +1 -0
  325. package/dist/workers/dbf-worker.js +7 -0
  326. package/dist/workers/dbf-worker.js.map +1 -0
  327. package/dist/workers/flatgeobuf-worker.d.ts +2 -0
  328. package/dist/workers/flatgeobuf-worker.d.ts.map +1 -0
  329. package/dist/workers/flatgeobuf-worker.js +7 -0
  330. package/dist/workers/flatgeobuf-worker.js.map +1 -0
  331. package/dist/workers/geopackage-worker.d.ts +2 -0
  332. package/dist/workers/geopackage-worker.d.ts.map +1 -0
  333. package/dist/workers/geopackage-worker.js +7 -0
  334. package/dist/workers/geopackage-worker.js.map +1 -0
  335. package/dist/workers/shp-worker.d.ts +2 -0
  336. package/dist/workers/shp-worker.d.ts.map +1 -0
  337. package/dist/workers/shp-worker.js +7 -0
  338. package/dist/workers/shp-worker.js.map +1 -0
  339. package/package.json +286 -4
  340. package/src/dbf.ts +5 -0
  341. package/src/flatgeobuf/LICENSE +9 -0
  342. package/src/flatgeobuf/bundled.ts +9 -0
  343. package/src/flatgeobuf/flatgeobuf-format.ts +17 -0
  344. package/src/flatgeobuf/flatgeobuf-loader-types.ts +70 -0
  345. package/src/flatgeobuf/flatgeobuf-loader.ts +66 -0
  346. package/src/flatgeobuf/flatgeobuf-source-loader.ts +338 -0
  347. package/src/flatgeobuf/flatgeobuf-table-query-capabilities.ts +14 -0
  348. package/src/flatgeobuf/index.ts +24 -0
  349. package/src/flatgeobuf/lib/flatgeobuf-reader.ts +719 -0
  350. package/src/flatgeobuf/lib/flatgeobuf-worker-transport.ts +63 -0
  351. package/src/flatgeobuf/lib/parse-flatgeobuf.ts +383 -0
  352. package/src/flatgeobuf/unbundled.ts +6 -0
  353. package/src/flatgeobuf.ts +6 -0
  354. package/src/geopackage/bundled.ts +6 -0
  355. package/src/geopackage/geopackage-format.ts +16 -0
  356. package/src/geopackage/geopackage-loader-options.ts +13 -0
  357. package/src/geopackage/geopackage-loader-types.ts +58 -0
  358. package/src/geopackage/geopackage-loader.ts +21 -0
  359. package/src/geopackage/geopackage-source-loader.ts +364 -0
  360. package/src/geopackage/index.ts +16 -0
  361. package/src/geopackage/lib/geopackage-tile-metadata.ts +156 -0
  362. package/src/geopackage/lib/parse-geopackage.ts +679 -0
  363. package/src/geopackage/lib/types.ts +293 -0
  364. package/src/geopackage/unbundled.ts +6 -0
  365. package/src/geopackage.ts +6 -0
  366. package/src/gpx.ts +5 -0
  367. package/src/index.ts +30 -0
  368. package/src/kml/bundled.ts +21 -0
  369. package/src/kml/gpx-loader-types.ts +50 -0
  370. package/src/kml/gpx-loader.ts +101 -0
  371. package/src/kml/index.ts +39 -0
  372. package/src/kml/kml-format.ts +70 -0
  373. package/src/kml/kml-loader-types.ts +46 -0
  374. package/src/kml/kml-loader.ts +98 -0
  375. package/src/kml/kml-parser.ts +593 -0
  376. package/src/kml/kml-writer.ts +252 -0
  377. package/src/kml/kmz-archive.ts +92 -0
  378. package/src/kml/kmz-loader-types.ts +37 -0
  379. package/src/kml/kmz-loader.ts +56 -0
  380. package/src/kml/kmz-source.ts +234 -0
  381. package/src/kml/lib/feature-collection-to-arrow.ts +231 -0
  382. package/src/kml/sports-track-parser.ts +426 -0
  383. package/src/kml/tcx-loader-types.ts +50 -0
  384. package/src/kml/tcx-loader.ts +101 -0
  385. package/src/kml/unbundled.ts +21 -0
  386. package/src/kml.ts +6 -0
  387. package/src/kmz.ts +5 -0
  388. package/src/shapefile/bundled.ts +18 -0
  389. package/src/shapefile/dbf-format.ts +17 -0
  390. package/src/shapefile/dbf-loader-types.ts +51 -0
  391. package/src/shapefile/dbf-loader.ts +79 -0
  392. package/src/shapefile/index.ts +25 -0
  393. package/src/shapefile/lib/parsers/build-geoarrow-geometry-arrow.ts +172 -0
  394. package/src/shapefile/lib/parsers/build-wkb-geometry-arrow.ts +340 -0
  395. package/src/shapefile/lib/parsers/parse-dbf-to-arrow.ts +429 -0
  396. package/src/shapefile/lib/parsers/parse-dbf.ts +422 -0
  397. package/src/shapefile/lib/parsers/parse-shapefile.ts +417 -0
  398. package/src/shapefile/lib/parsers/parse-shp-geometry.ts +527 -0
  399. package/src/shapefile/lib/parsers/parse-shp-header.ts +64 -0
  400. package/src/shapefile/lib/parsers/parse-shp-to-arrow.ts +184 -0
  401. package/src/shapefile/lib/parsers/parse-shp.ts +245 -0
  402. package/src/shapefile/lib/parsers/parse-shx.ts +39 -0
  403. package/src/shapefile/lib/parsers/types.ts +96 -0
  404. package/src/shapefile/lib/shapefile-worker-transport.ts +72 -0
  405. package/src/shapefile/lib/streaming/binary-chunk-reader.ts +8 -0
  406. package/src/shapefile/lib/streaming/binary-reader.ts +60 -0
  407. package/src/shapefile/lib/streaming/zip-batch-iterators.ts +78 -0
  408. package/src/shapefile/shapefile-arrow-loader.ts +448 -0
  409. package/src/shapefile/shapefile-loader-types.ts +68 -0
  410. package/src/shapefile/shapefile-loader.ts +76 -0
  411. package/src/shapefile/shp-format.ts +34 -0
  412. package/src/shapefile/shp-loader-types.ts +60 -0
  413. package/src/shapefile/shp-loader.ts +80 -0
  414. package/src/shapefile/unbundled.ts +12 -0
  415. package/src/shapefile.ts +6 -0
  416. package/src/shp.ts +5 -0
  417. package/src/tcx.ts +5 -0
  418. package/src/workers/dbf-worker.ts +8 -0
  419. package/src/workers/flatgeobuf-worker.ts +8 -0
  420. package/src/workers/geopackage-worker.ts +8 -0
  421. package/src/workers/shp-worker.ts +8 -0
@@ -0,0 +1,231 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {
6
+ ArrowTable,
7
+ Feature,
8
+ Field,
9
+ Geometry,
10
+ GeoJsonProperties,
11
+ Schema
12
+ } from '@loaders.gl/core/schema';
13
+ import type {GeoArrowEncodingPreference} from '@loaders.gl/core/schema';
14
+ import {convertFeaturesToGeoArrowTable} from '@loaders.gl/arrow-geometry/feature-table';
15
+ import {
16
+ encodeWKBGeometryValue,
17
+ getCoordinateDimensions as getCoordinateDimensionsFromGeometry,
18
+ getGeometrySampleCoordinates as getGeometrySampleCoordinatesFromGeometry,
19
+ getGeometryWKBOptions as getGeometryWKBOptionsFromGeometry,
20
+ inferGeoParquetGeometryTypes,
21
+ makeWKBGeometryField,
22
+ setWKBGeometrySchemaMetadata
23
+ } from '@loaders.gl/arrow-geometry/geometry-field';
24
+ import {ArrowTableBuilder, getDataTypeFromArray} from '@loaders.gl/core/schema-utils';
25
+
26
+ const GEOMETRY_COLUMN_NAME = 'geometry';
27
+
28
+ /**
29
+ * Converts GeoJSON features into a loaders.gl Arrow table with WKB geometry metadata.
30
+ *
31
+ * @param features - Parsed GeoJSON features.
32
+ * @returns Arrow table preserving properties and storing geometry as WKB bytes.
33
+ */
34
+ export function convertFeatureCollectionToArrowTable(
35
+ features: Feature[],
36
+ options: {encodingPreference?: GeoArrowEncodingPreference} = {}
37
+ ): ArrowTable {
38
+ if (options.encodingPreference && options.encodingPreference !== 'geoarrow.wkb') {
39
+ return convertFeaturesToGeoArrowTable(features, options);
40
+ }
41
+ const propertyRows = features.map(feature => normalizeProperties(feature.properties));
42
+ const propertySchema = getPropertySchema(propertyRows);
43
+ const schema = buildFeatureArrowSchema(propertySchema, features);
44
+ const arrowTableBuilder = new ArrowTableBuilder(schema);
45
+
46
+ for (let featureIndex = 0; featureIndex < features.length; featureIndex++) {
47
+ arrowTableBuilder.addObjectRow(
48
+ makeFeatureArrowRow(propertyRows[featureIndex], features[featureIndex])
49
+ );
50
+ }
51
+
52
+ return arrowTableBuilder.finishTable();
53
+ }
54
+
55
+ /**
56
+ * Builds the output Arrow schema for a feature table with a WKB geometry column.
57
+ *
58
+ * @param propertySchema - Schema inferred from feature properties.
59
+ * @param features - Features used to infer geometry metadata.
60
+ * @returns Output schema with appended geometry field and geo metadata.
61
+ */
62
+ export function buildFeatureArrowSchema(propertySchema: Schema, features: Feature[]): Schema {
63
+ const geometryField: Field = makeWKBGeometryField(GEOMETRY_COLUMN_NAME);
64
+ const schema: Schema = {
65
+ fields: [...propertySchema.fields, geometryField],
66
+ metadata: {...(propertySchema.metadata || {})}
67
+ };
68
+
69
+ setWKBGeometrySchemaMetadata(schema, {
70
+ geometryColumnName: GEOMETRY_COLUMN_NAME,
71
+ geometryTypes: inferGeoParquetGeometryTypes(features.map(feature => feature.geometry))
72
+ });
73
+
74
+ return schema;
75
+ }
76
+
77
+ /**
78
+ * Builds a feature-table schema from GeoJSON feature properties.
79
+ *
80
+ * @param features - Parsed GeoJSON features.
81
+ * @returns Schema inferred from feature properties.
82
+ */
83
+ export function buildFeatureTableSchema(features: Feature[]): Schema {
84
+ const propertyRows = features.map(feature => normalizeProperties(feature.properties));
85
+ return getPropertySchema(propertyRows);
86
+ }
87
+
88
+ /**
89
+ * Converts one feature into an object row suitable for `ArrowTableBuilder`.
90
+ *
91
+ * @param properties - Normalized feature properties.
92
+ * @param feature - Feature containing optional geometry.
93
+ * @returns Object row with a WKB geometry column.
94
+ */
95
+ export function makeFeatureArrowRow(
96
+ properties: Record<string, unknown>,
97
+ feature: Feature
98
+ ): Record<string, unknown> {
99
+ return {
100
+ ...properties,
101
+ [GEOMETRY_COLUMN_NAME]: encodeWKBGeometryValue(feature.geometry)
102
+ };
103
+ }
104
+
105
+ /**
106
+ * Infers GeoParquet geometry type strings from a feature collection.
107
+ *
108
+ * @param features - Features to inspect.
109
+ * @returns Unique geometry type strings in encounter order.
110
+ */
111
+ export function inferFeatureGeometryTypes(features: Feature[]): string[] {
112
+ return inferGeoParquetGeometryTypes(features.map(feature => feature.geometry));
113
+ }
114
+
115
+ /**
116
+ * Normalizes nullable GeoJSON properties to a plain object.
117
+ *
118
+ * @param properties - Feature properties value.
119
+ * @returns Plain object safe for schema deduction and Arrow row building.
120
+ */
121
+ export function normalizeProperties(properties: GeoJsonProperties): Record<string, unknown> {
122
+ if (!properties || typeof properties !== 'object') {
123
+ return {};
124
+ }
125
+
126
+ const normalizedProperties: Record<string, unknown> = {};
127
+ for (const [propertyName, propertyValue] of Object.entries(properties)) {
128
+ normalizedProperties[propertyName] = normalizePropertyValue(propertyValue);
129
+ }
130
+ return normalizedProperties;
131
+ }
132
+
133
+ /**
134
+ * Deduces a property-only schema from normalized object rows.
135
+ *
136
+ * @param propertyRows - Normalized property rows.
137
+ * @returns Property schema or an empty schema when no rows are present.
138
+ */
139
+ export function getPropertySchema(propertyRows: Record<string, unknown>[]): Schema {
140
+ if (propertyRows.length === 0) {
141
+ return {fields: [], metadata: {}};
142
+ }
143
+
144
+ const fieldNames = getFieldNames(propertyRows);
145
+ return {
146
+ metadata: {},
147
+ fields: fieldNames.map((fieldName): Field => {
148
+ const inferredType = getDataTypeFromArray(
149
+ propertyRows.map(propertyRow => propertyRow[fieldName])
150
+ );
151
+ return {
152
+ name: fieldName,
153
+ type: inferredType.type === 'float32' ? 'float64' : inferredType.type,
154
+ nullable: inferredType.nullable
155
+ };
156
+ })
157
+ };
158
+ }
159
+
160
+ /**
161
+ * Selects WKB dimensional flags based on the geometry coordinate dimensionality.
162
+ *
163
+ * @param geometry - Geometry to serialize.
164
+ * @returns WKB options preserving Z and M ordinates when present.
165
+ */
166
+ export function getGeometryWKBOptions(geometry: Geometry): {hasZ?: boolean; hasM?: boolean} {
167
+ return getGeometryWKBOptionsFromGeometry(geometry);
168
+ }
169
+
170
+ /**
171
+ * Returns the coordinate dimensionality of a representative geometry coordinate tuple.
172
+ *
173
+ * @param coordinates - Geometry coordinates or nested coordinate arrays.
174
+ * @returns Coordinate tuple length, defaulting to `2`.
175
+ */
176
+ export function getCoordinateDimensions(coordinates: unknown): number {
177
+ return getCoordinateDimensionsFromGeometry(coordinates);
178
+ }
179
+
180
+ /**
181
+ * Extracts one representative coordinate payload from a geometry.
182
+ *
183
+ * @param geometry - Geometry to sample.
184
+ * @returns Representative coordinates or `undefined` when the geometry is empty.
185
+ */
186
+ export function getGeometrySampleCoordinates(geometry: Geometry): unknown {
187
+ return getGeometrySampleCoordinatesFromGeometry(geometry);
188
+ }
189
+
190
+ /**
191
+ * Normalizes one property value to an Arrow-friendly scalar representation.
192
+ *
193
+ * Arrays and plain objects are preserved as JSON strings so nested content is not dropped by
194
+ * schema inference.
195
+ *
196
+ * @param propertyValue - Original GeoJSON property value.
197
+ * @returns Arrow-friendly scalar value.
198
+ */
199
+ export function normalizePropertyValue(propertyValue: unknown): unknown {
200
+ if (
201
+ propertyValue === null ||
202
+ propertyValue === undefined ||
203
+ typeof propertyValue === 'string' ||
204
+ typeof propertyValue === 'number' ||
205
+ typeof propertyValue === 'boolean'
206
+ ) {
207
+ return propertyValue ?? null;
208
+ }
209
+
210
+ if (propertyValue instanceof Date) {
211
+ return propertyValue.toISOString();
212
+ }
213
+
214
+ return JSON.stringify(propertyValue);
215
+ }
216
+
217
+ /**
218
+ * Collects stable field names in first-seen order across property rows.
219
+ *
220
+ * @param propertyRows - Normalized property rows.
221
+ * @returns Field names in encounter order.
222
+ */
223
+ function getFieldNames(propertyRows: Record<string, unknown>[]): string[] {
224
+ const fieldNames = new Set<string>();
225
+ for (const propertyRow of propertyRows) {
226
+ for (const fieldName of Object.keys(propertyRow)) {
227
+ fieldNames.add(fieldName);
228
+ }
229
+ }
230
+ return [...fieldNames];
231
+ }
@@ -0,0 +1,426 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {Feature, FeatureCollection, Position} from '@loaders.gl/core/schema';
6
+ import {parseXMLSync} from '@loaders.gl/xml';
7
+
8
+ interface XMLValueArray extends Array<XMLValue> {}
9
+ interface XMLObject {
10
+ [key: string]: XMLValue;
11
+ }
12
+ type XMLValue = string | number | boolean | XMLObject | XMLValueArray;
13
+
14
+ type ParsedPoint = {
15
+ coordinates: Position;
16
+ time?: string;
17
+ heartRate?: number;
18
+ extendedValues: Array<[string, string | number]>;
19
+ };
20
+
21
+ type ParsedLine = {
22
+ line: Position[];
23
+ times: string[];
24
+ heartRates: number[];
25
+ extendedProperties: Record<string, Array<string | number | null>>;
26
+ };
27
+
28
+ /** Parses GPX XML text into a GeoJSON feature collection. */
29
+ export function parseGPXTextToFeatureCollection(text: string): FeatureCollection {
30
+ const root = parseSportsXML(text, 'gpx');
31
+ const features: Feature[] = [];
32
+
33
+ for (const track of getDescendants(root, 'trk')) {
34
+ const feature = parseGPXTrack(track);
35
+ if (feature) features.push(feature);
36
+ }
37
+ for (const route of getDescendants(root, 'rte')) {
38
+ const feature = parseGPXRoute(route);
39
+ if (feature) features.push(feature);
40
+ }
41
+ for (const waypoint of getDescendants(root, 'wpt')) {
42
+ features.push(parseGPXWaypoint(waypoint));
43
+ }
44
+
45
+ return {type: 'FeatureCollection', features};
46
+ }
47
+
48
+ /** Parses TCX XML text into a GeoJSON feature collection. */
49
+ export function parseTCXTextToFeatureCollection(text: string): FeatureCollection {
50
+ const root = parseSportsXML(text, 'TrainingCenterDatabase');
51
+ const features: Feature[] = [];
52
+
53
+ for (const lap of getDescendants(root, 'Lap')) {
54
+ const feature = parseTCXLap(lap);
55
+ if (feature) features.push(feature);
56
+ }
57
+ for (const courses of getDescendants(root, 'Courses')) {
58
+ const feature = parseTCXTrackContainer(courses);
59
+ if (feature) features.push(feature);
60
+ }
61
+
62
+ return {type: 'FeatureCollection', features};
63
+ }
64
+
65
+ function parseSportsXML(text: string, rootName: string): XMLObject {
66
+ const parsed = parseXMLSync(text, {
67
+ removeNSPrefix: true,
68
+ textNodeName: '#text',
69
+ _fastXML: {parseTagValue: false, parseAttributeValue: false}
70
+ }) as XMLObject;
71
+ const root = asObject(parsed[rootName]);
72
+ if (!root) throw new Error(`Invalid ${rootName} document`);
73
+ return root;
74
+ }
75
+
76
+ function parseGPXTrack(node: XMLObject): Feature | undefined {
77
+ const lines: ParsedLine[] = [];
78
+ for (const segment of getDescendants(node, 'trkseg')) {
79
+ const line = parseGPXPoints(segment, 'trkpt');
80
+ if (line) lines.push(line);
81
+ }
82
+ if (!lines.length) return undefined;
83
+
84
+ const multi = lines.length > 1;
85
+ const coordinateProperties: Record<string, unknown> = {};
86
+ const times = lines.filter(line => line.times.length).map(line => line.times);
87
+ if (times.length) coordinateProperties.times = multi ? times : times[0];
88
+
89
+ const properties: Record<string, unknown> = {
90
+ ...parseGPXProperties(node),
91
+ ...parseGPXLineStyle(node),
92
+ _gpxType: 'trk'
93
+ };
94
+ for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
95
+ for (const [name, values] of Object.entries(lines[lineIndex].extendedProperties)) {
96
+ if (multi) {
97
+ if (!coordinateProperties[name]) {
98
+ coordinateProperties[name] = lines.map(line => new Array(line.line.length).fill(null));
99
+ }
100
+ (coordinateProperties[name] as Array<Array<string | number | null>>)[lineIndex] = values;
101
+ } else {
102
+ coordinateProperties[name] = values;
103
+ }
104
+ }
105
+ }
106
+ if (Object.keys(coordinateProperties).length)
107
+ properties.coordinateProperties = coordinateProperties;
108
+
109
+ const coordinates = lines.map(line => line.line);
110
+ return {
111
+ type: 'Feature',
112
+ properties,
113
+ geometry: multi
114
+ ? {type: 'MultiLineString', coordinates}
115
+ : {type: 'LineString', coordinates: coordinates[0]}
116
+ } as Feature;
117
+ }
118
+
119
+ function parseGPXRoute(node: XMLObject): Feature | undefined {
120
+ const line = parseGPXPoints(node, 'rtept');
121
+ if (!line) return undefined;
122
+ return {
123
+ type: 'Feature',
124
+ properties: {...parseGPXProperties(node), ...parseGPXLineStyle(node), _gpxType: 'rte'},
125
+ geometry: {type: 'LineString', coordinates: line.line}
126
+ } as Feature;
127
+ }
128
+
129
+ function parseGPXWaypoint(node: XMLObject): Feature {
130
+ const point = parseGPXPoint(node);
131
+ return {
132
+ type: 'Feature',
133
+ properties: {...parseGPXProperties(node), ...getSingleProperty(node, 'sym')},
134
+ geometry: {type: 'Point', coordinates: point.coordinates}
135
+ } as Feature;
136
+ }
137
+
138
+ function parseGPXPoints(node: XMLObject, pointName: string): ParsedLine | undefined {
139
+ const points = getDescendants(node, pointName);
140
+ if (points.length < 2) return undefined;
141
+
142
+ const line: Position[] = [];
143
+ const times: string[] = [];
144
+ const extendedProperties: Record<string, Array<string | number | null>> = {};
145
+ for (let index = 0; index < points.length; index++) {
146
+ const point = parseGPXPoint(points[index]);
147
+ line.push(point.coordinates);
148
+ if (point.time) times.push(point.time);
149
+ for (const [name, value] of point.extendedValues) {
150
+ const propertyName = name === 'heart' ? name : `${name.replace(/^gpxtpx:/, '')}s`;
151
+ extendedProperties[propertyName] ||= new Array(points.length).fill(null);
152
+ extendedProperties[propertyName][index] = value;
153
+ }
154
+ }
155
+ return {line, times, heartRates: [], extendedProperties};
156
+ }
157
+
158
+ function parseGPXPoint(node: XMLObject): ParsedPoint {
159
+ const longitude = parseNumber(getAttribute(node, 'lon')) ?? Number.NaN;
160
+ const latitude = parseNumber(getAttribute(node, 'lat')) ?? Number.NaN;
161
+ const coordinates: Position = [longitude, latitude];
162
+ const elevation = parseNumber(getText(node, 'ele'));
163
+ if (elevation !== undefined) coordinates.push(elevation);
164
+ const time = getText(node, 'time');
165
+ return {coordinates, time, extendedValues: parseGPXExtensions(node)};
166
+ }
167
+
168
+ function parseGPXProperties(node: XMLObject): Record<string, unknown> {
169
+ const properties: Record<string, unknown> = {};
170
+ for (const name of ['name', 'cmt', 'desc', 'type', 'time', 'keywords']) {
171
+ const value = getText(node, name);
172
+ if (value !== undefined) properties[name] = value;
173
+ }
174
+ for (const [name, value] of getDirectExtensionProperties(node)) properties[name] = value;
175
+ const links = getDescendants(node, 'link');
176
+ if (links.length) {
177
+ properties.links = links.map(link => ({
178
+ href: getAttribute(link, 'href'),
179
+ ...getSingleProperty(link, 'text'),
180
+ ...getSingleProperty(link, 'type')
181
+ }));
182
+ }
183
+ return properties;
184
+ }
185
+
186
+ function parseGPXLineStyle(node: XMLObject): Record<string, unknown> {
187
+ const line = getFirstObject(getFirstObject(node, 'extensions'), 'line');
188
+ if (!line) return {};
189
+ const style: Record<string, unknown> = {};
190
+ const color = getText(line, 'color');
191
+ const opacity = parseNumber(getText(line, 'opacity'));
192
+ const width = parseNumber(getText(line, 'width'));
193
+ if (color) style.stroke = color;
194
+ if (opacity !== undefined) style['stroke-opacity'] = opacity;
195
+ if (width !== undefined) style['stroke-width'] = (width * 96) / 25.4;
196
+ return style;
197
+ }
198
+
199
+ function parseGPXExtensions(node: XMLObject): Array<[string, string | number]> {
200
+ const extensions = getFirstObject(node, 'extensions');
201
+ return extensions ? parseExtensionEntries(extensions) : [];
202
+ }
203
+
204
+ function parseExtensionEntries(node: XMLObject): Array<[string, string | number]> {
205
+ const values: Array<[string, string | number]> = [];
206
+ for (const [name, value] of Object.entries(node)) {
207
+ if (name === '#text') continue;
208
+ const objects = asObjects(value);
209
+ if (name === 'TrackPointExtension' || name === 'gpxtpx:TrackPointExtension') {
210
+ for (const object of objects) values.push(...parseExtensionEntries(object));
211
+ } else if (objects.length) {
212
+ for (const object of objects) {
213
+ const text = getNodeText(object);
214
+ if (text !== undefined) values.push([name, parseStringValue(text)]);
215
+ }
216
+ } else {
217
+ const text = getNodeText(value);
218
+ if (text !== undefined) values.push([name, parseStringValue(text)]);
219
+ }
220
+ }
221
+ return values;
222
+ }
223
+
224
+ function getDirectExtensionProperties(node: XMLObject): Array<[string, string]> {
225
+ const extensions = getFirstObject(node, 'extensions');
226
+ if (!extensions) return [];
227
+ return Object.entries(extensions)
228
+ .filter(([name]) => name !== '#text' && name !== 'TrackPointExtension')
229
+ .flatMap(([name, value]) => {
230
+ const text = getNodeText(value);
231
+ return text === undefined ? [] : [[name.replace(':', '_'), text]];
232
+ });
233
+ }
234
+
235
+ function parseTCXLap(node: XMLObject): Feature | undefined {
236
+ return parseTCXTrackContainer(node, parseTCXLapProperties(node));
237
+ }
238
+
239
+ function parseTCXTrackContainer(
240
+ node: XMLObject,
241
+ properties: Record<string, unknown> = {}
242
+ ): Feature | undefined {
243
+ const tracks = getDescendants(node, 'Track');
244
+ const lines: ParsedLine[] = [];
245
+ const allExtendedProperties: Array<Record<string, Array<string | number | null>>> = [];
246
+ const times: string[][] = [];
247
+ const heartRates: number[][] = [];
248
+
249
+ for (const track of tracks) {
250
+ const line = parseTCXPoints(track);
251
+ if (!line) continue;
252
+ lines.push(line);
253
+ allExtendedProperties.push(line.extendedProperties);
254
+ if (line.times.length) times.push(line.times);
255
+ if (line.heartRates.length) heartRates.push(line.heartRates);
256
+ }
257
+ if (!lines.length) return undefined;
258
+
259
+ const multi = lines.length > 1;
260
+ for (let index = 0; index < allExtendedProperties.length; index++) {
261
+ for (const [name, values] of Object.entries(allExtendedProperties[index])) {
262
+ if (!multi) {
263
+ properties[name] = values;
264
+ } else {
265
+ if (!properties[name]) {
266
+ properties[name] = lines.map(line => new Array(line.line.length).fill(null));
267
+ }
268
+ (properties[name] as Array<Array<string | number | null>>)[index] = values;
269
+ }
270
+ }
271
+ }
272
+ if (times.length || heartRates.length) {
273
+ properties.coordinateProperties = {
274
+ ...(times.length ? {times: multi ? times : times[0]} : {}),
275
+ ...(heartRates.length ? {heart: multi ? heartRates : heartRates[0]} : {})
276
+ };
277
+ }
278
+
279
+ const coordinates = lines.map(line => line.line);
280
+ return {
281
+ type: 'Feature',
282
+ properties,
283
+ geometry: {
284
+ type: multi ? 'MultiLineString' : 'LineString',
285
+ coordinates: multi ? coordinates : coordinates[0]
286
+ }
287
+ } as Feature;
288
+ }
289
+
290
+ function parseTCXPoints(node: XMLObject): ParsedLine | undefined {
291
+ const points = getDescendants(node, 'Trackpoint');
292
+ if (points.length < 2) return undefined;
293
+ const line: Position[] = [];
294
+ const times: string[] = [];
295
+ const heartRates: number[] = [];
296
+ const extendedProperties: Record<string, Array<string | number | null>> = {};
297
+
298
+ for (let index = 0; index < points.length; index++) {
299
+ const point = parseTCXPoint(points[index]);
300
+ if (!point) continue;
301
+ line.push(point.coordinates);
302
+ if (point.time) times.push(point.time);
303
+ if (point.heartRate !== undefined) heartRates.push(point.heartRate);
304
+ for (const [name, value] of point.extendedValues) {
305
+ extendedProperties[name] ||= new Array(points.length).fill(null);
306
+ extendedProperties[name][index] = value;
307
+ }
308
+ }
309
+ return {line, times, heartRates, extendedProperties};
310
+ }
311
+
312
+ function parseTCXPoint(node: XMLObject): ParsedPoint | undefined {
313
+ const longitude = parseNumber(getText(node, 'LongitudeDegrees'));
314
+ const latitude = parseNumber(getText(node, 'LatitudeDegrees'));
315
+ if (longitude === undefined || latitude === undefined) return undefined;
316
+ const coordinates: Position = [longitude, latitude];
317
+ const elevation = parseNumber(getText(node, 'AltitudeMeters'));
318
+ if (elevation !== undefined) coordinates.push(elevation);
319
+ const heartRate = parseNumber(getText(node, 'HeartRateBpm'));
320
+ const extendedValues = parseTCXExtensions(node);
321
+ return {coordinates, time: getText(node, 'Time'), heartRate, extendedValues};
322
+ }
323
+
324
+ function parseTCXExtensions(node: XMLObject): Array<[string, string | number]> {
325
+ const values: Array<[string, string | number]> = [];
326
+ for (const [tag, name] of [
327
+ ['heartRate', 'heartRates'],
328
+ ['Cadence', 'cadences'],
329
+ ['Speed', 'speeds'],
330
+ ['Watts', 'watts']
331
+ ]) {
332
+ const value = parseNumber(getText(node, tag));
333
+ if (value !== undefined) values.push([name, value]);
334
+ }
335
+ return values;
336
+ }
337
+
338
+ function parseTCXLapProperties(node: XMLObject): Record<string, unknown> {
339
+ const properties: Record<string, unknown> = {};
340
+ for (const [tag, name] of [
341
+ ['TotalTimeSeconds', 'totalTimeSeconds'],
342
+ ['DistanceMeters', 'distanceMeters'],
343
+ ['MaximumSpeed', 'maxSpeed'],
344
+ ['AverageHeartRateBpm', 'avgHeartRate'],
345
+ ['MaximumHeartRateBpm', 'maxHeartRate'],
346
+ ['AvgSpeed', 'avgSpeed'],
347
+ ['AvgWatts', 'avgWatts'],
348
+ ['MaxWatts', 'maxWatts']
349
+ ]) {
350
+ const value = parseNumber(getText(node, tag));
351
+ if (value !== undefined) properties[name] = value;
352
+ }
353
+ const name = getText(node, 'Name');
354
+ if (name) properties.name = name;
355
+ return properties;
356
+ }
357
+
358
+ function getSingleProperty(node: XMLObject, name: string): Record<string, string> {
359
+ const value = getText(node, name);
360
+ return value === undefined ? {} : {[name]: value};
361
+ }
362
+
363
+ function getDescendants(node: XMLObject, name: string): XMLObject[] {
364
+ const result: XMLObject[] = [];
365
+ for (const [key, value] of Object.entries(node)) {
366
+ if (key === '#text') continue;
367
+ for (const child of asObjects(value)) {
368
+ if (key === name) result.push(child);
369
+ result.push(...getDescendants(child, name));
370
+ }
371
+ }
372
+ return result;
373
+ }
374
+
375
+ function getFirstObject(node: XMLObject | undefined, name: string): XMLObject | undefined {
376
+ return node ? asObjects(node[name])[0] : undefined;
377
+ }
378
+
379
+ function asObjects(value: XMLValue | undefined): XMLObject[] {
380
+ if (value === undefined || value === null) return [];
381
+ const values = Array.isArray(value) ? value : [value];
382
+ return values.filter(
383
+ (item): item is XMLObject => typeof item === 'object' && !Array.isArray(item)
384
+ );
385
+ }
386
+
387
+ function asObject(value: XMLValue | undefined): XMLObject | undefined {
388
+ return typeof value === 'object' && !Array.isArray(value) ? value : undefined;
389
+ }
390
+
391
+ function getText(node: XMLObject | undefined, name: string): string | undefined {
392
+ if (!node) return undefined;
393
+ const directValue = getNodeText(node[name]);
394
+ if (directValue !== undefined) return directValue;
395
+ for (const [key, value] of Object.entries(node)) {
396
+ if (key === '#text') continue;
397
+ if (key === name) return getNodeText(value);
398
+ for (const child of asObjects(value)) {
399
+ const descendantValue = getText(child, name);
400
+ if (descendantValue !== undefined) return descendantValue;
401
+ }
402
+ }
403
+ return undefined;
404
+ }
405
+
406
+ function getNodeText(value: XMLValue | undefined): string | undefined {
407
+ if (value === undefined || value === null) return undefined;
408
+ if (typeof value !== 'object') return String(value);
409
+ if (Array.isArray(value)) return getNodeText(value[0]);
410
+ return getNodeText(value['#text']);
411
+ }
412
+
413
+ function getAttribute(node: XMLObject | undefined, name: string): string | undefined {
414
+ return node ? getNodeText(node[name]) : undefined;
415
+ }
416
+
417
+ function parseNumber(value: string | undefined): number | undefined {
418
+ if (value === undefined || value === '') return undefined;
419
+ const number = Number(value);
420
+ return Number.isFinite(number) ? number : undefined;
421
+ }
422
+
423
+ function parseStringValue(value: string): string | number {
424
+ const number = parseNumber(value);
425
+ return number === undefined ? value : number;
426
+ }
@@ -0,0 +1,50 @@
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 {
7
+ GeoJSONTable,
8
+ ObjectRowTable,
9
+ BinaryFeatureCollection,
10
+ ArrowTable,
11
+ GeoArrowEncodingPreference
12
+ } from '@loaders.gl/core/schema';
13
+ import {TCXFormat} from './kml-format';
14
+
15
+ // __VERSION__ is injected by babel-plugin-version-inline
16
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
17
+ const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
18
+
19
+ export type TCXLoaderOptions = LoaderOptions & {
20
+ /** Preferred encoding for Arrow geometry output. */
21
+ geoarrow?: {encodingPreference?: GeoArrowEncodingPreference};
22
+ tcx?: {
23
+ shape?: 'object-row-table' | 'geojson-table' | 'arrow-table' | 'binary-geometry' | 'raw';
24
+ geoarrow?: {encodingPreference?: GeoArrowEncodingPreference};
25
+ };
26
+ };
27
+
28
+ /** Preloads the parser-bearing TCX loader implementation. */
29
+ async function preloadTCXLoader() {
30
+ const {TCXLoaderWithParser} = await import('@loaders.gl/geospatial/tcx');
31
+ return TCXLoaderWithParser;
32
+ }
33
+
34
+ /** Metadata-only loader for TCX (Training Center XML). */
35
+ export const TCXLoader = {
36
+ dataType: null as unknown as ObjectRowTable | GeoJSONTable | BinaryFeatureCollection | ArrowTable,
37
+ batchType: null as never,
38
+
39
+ ...TCXFormat,
40
+ version: VERSION,
41
+ options: {
42
+ tcx: {shape: 'arrow-table'},
43
+ gis: {}
44
+ },
45
+ preload: preloadTCXLoader
46
+ } as const satisfies Loader<
47
+ ObjectRowTable | GeoJSONTable | BinaryFeatureCollection | ArrowTable,
48
+ never,
49
+ TCXLoaderOptions
50
+ >;