@loaders.gl/geospatial 0.0.0-stage → 5.0.0-alpha.14

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 (422) hide show
  1. package/LICENSE +52 -0
  2. package/README.md +8 -2
  3. package/dist/dbf-worker.js +17099 -0
  4. package/dist/dbf.d.ts +2 -0
  5. package/dist/dbf.d.ts.map +1 -0
  6. package/dist/dbf.js +5 -0
  7. package/dist/dbf.js.map +1 -0
  8. package/dist/flatgeobuf/bundled.d.ts +3 -0
  9. package/dist/flatgeobuf/bundled.d.ts.map +1 -0
  10. package/dist/flatgeobuf/bundled.js +5 -0
  11. package/dist/flatgeobuf/bundled.js.map +1 -0
  12. package/dist/flatgeobuf/flatgeobuf-format.d.ts +12 -0
  13. package/dist/flatgeobuf/flatgeobuf-format.d.ts.map +1 -0
  14. package/dist/flatgeobuf/flatgeobuf-format.js +15 -0
  15. package/dist/flatgeobuf/flatgeobuf-format.js.map +1 -0
  16. package/dist/flatgeobuf/flatgeobuf-loader-types.d.ts +104 -0
  17. package/dist/flatgeobuf/flatgeobuf-loader-types.d.ts.map +1 -0
  18. package/dist/flatgeobuf/flatgeobuf-loader-types.js +36 -0
  19. package/dist/flatgeobuf/flatgeobuf-loader-types.js.map +1 -0
  20. package/dist/flatgeobuf/flatgeobuf-loader.d.ts +59 -0
  21. package/dist/flatgeobuf/flatgeobuf-loader.d.ts.map +1 -0
  22. package/dist/flatgeobuf/flatgeobuf-loader.js +38 -0
  23. package/dist/flatgeobuf/flatgeobuf-loader.js.map +1 -0
  24. package/dist/flatgeobuf/flatgeobuf-source-loader.d.ts +105 -0
  25. package/dist/flatgeobuf/flatgeobuf-source-loader.d.ts.map +1 -0
  26. package/dist/flatgeobuf/flatgeobuf-source-loader.js +240 -0
  27. package/dist/flatgeobuf/flatgeobuf-source-loader.js.map +1 -0
  28. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.d.ts +4 -0
  29. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.d.ts.map +1 -0
  30. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.js +12 -0
  31. package/dist/flatgeobuf/flatgeobuf-table-query-capabilities.js.map +1 -0
  32. package/dist/flatgeobuf/index.cjs +5543 -0
  33. package/dist/flatgeobuf/index.cjs.map +6 -0
  34. package/dist/flatgeobuf/index.d.ts +9 -0
  35. package/dist/flatgeobuf/index.d.ts.map +1 -0
  36. package/dist/flatgeobuf/index.js +11 -0
  37. package/dist/flatgeobuf/index.js.map +1 -0
  38. package/dist/flatgeobuf/lib/flatgeobuf-reader.d.ts +97 -0
  39. package/dist/flatgeobuf/lib/flatgeobuf-reader.d.ts.map +1 -0
  40. package/dist/flatgeobuf/lib/flatgeobuf-reader.js +577 -0
  41. package/dist/flatgeobuf/lib/flatgeobuf-reader.js.map +1 -0
  42. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.d.ts +8 -0
  43. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.d.ts.map +1 -0
  44. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.js +44 -0
  45. package/dist/flatgeobuf/lib/flatgeobuf-worker-transport.js.map +1 -0
  46. package/dist/flatgeobuf/lib/parse-flatgeobuf.d.ts +36 -0
  47. package/dist/flatgeobuf/lib/parse-flatgeobuf.d.ts.map +1 -0
  48. package/dist/flatgeobuf/lib/parse-flatgeobuf.js +269 -0
  49. package/dist/flatgeobuf/lib/parse-flatgeobuf.js.map +1 -0
  50. package/dist/flatgeobuf/unbundled.d.ts +3 -0
  51. package/dist/flatgeobuf/unbundled.d.ts.map +1 -0
  52. package/dist/flatgeobuf/unbundled.js +5 -0
  53. package/dist/flatgeobuf/unbundled.js.map +1 -0
  54. package/dist/flatgeobuf-worker.js +32891 -0
  55. package/dist/flatgeobuf.d.ts +2 -0
  56. package/dist/flatgeobuf.d.ts.map +1 -0
  57. package/dist/flatgeobuf.js +5 -0
  58. package/dist/flatgeobuf.js.map +1 -0
  59. package/dist/geopackage/bundled.d.ts +3 -0
  60. package/dist/geopackage/bundled.d.ts.map +1 -0
  61. package/dist/geopackage/bundled.js +5 -0
  62. package/dist/geopackage/bundled.js.map +1 -0
  63. package/dist/geopackage/geopackage-format.d.ts +11 -0
  64. package/dist/geopackage/geopackage-format.d.ts.map +1 -0
  65. package/dist/geopackage/geopackage-format.js +14 -0
  66. package/dist/geopackage/geopackage-format.js.map +1 -0
  67. package/dist/geopackage/geopackage-loader-options.d.ts +5 -0
  68. package/dist/geopackage/geopackage-loader-options.d.ts.map +1 -0
  69. package/dist/geopackage/geopackage-loader-options.js +12 -0
  70. package/dist/geopackage/geopackage-loader-options.js.map +1 -0
  71. package/dist/geopackage/geopackage-loader-types.d.ts +72 -0
  72. package/dist/geopackage/geopackage-loader-types.d.ts.map +1 -0
  73. package/dist/geopackage/geopackage-loader-types.js +30 -0
  74. package/dist/geopackage/geopackage-loader-types.js.map +1 -0
  75. package/dist/geopackage/geopackage-loader.d.ts +26 -0
  76. package/dist/geopackage/geopackage-loader.d.ts.map +1 -0
  77. package/dist/geopackage/geopackage-loader.js +12 -0
  78. package/dist/geopackage/geopackage-loader.js.map +1 -0
  79. package/dist/geopackage/geopackage-source-loader.d.ts +99 -0
  80. package/dist/geopackage/geopackage-source-loader.d.ts.map +1 -0
  81. package/dist/geopackage/geopackage-source-loader.js +258 -0
  82. package/dist/geopackage/geopackage-source-loader.js.map +1 -0
  83. package/dist/geopackage/index.cjs +4433 -0
  84. package/dist/geopackage/index.cjs.map +6 -0
  85. package/dist/geopackage/index.d.ts +7 -0
  86. package/dist/geopackage/index.d.ts.map +1 -0
  87. package/dist/geopackage/index.js +7 -0
  88. package/dist/geopackage/index.js.map +1 -0
  89. package/dist/geopackage/lib/geopackage-tile-metadata.d.ts +22 -0
  90. package/dist/geopackage/lib/geopackage-tile-metadata.d.ts.map +1 -0
  91. package/dist/geopackage/lib/geopackage-tile-metadata.js +105 -0
  92. package/dist/geopackage/lib/geopackage-tile-metadata.js.map +1 -0
  93. package/dist/geopackage/lib/parse-geopackage.d.ts +39 -0
  94. package/dist/geopackage/lib/parse-geopackage.d.ts.map +1 -0
  95. package/dist/geopackage/lib/parse-geopackage.js +485 -0
  96. package/dist/geopackage/lib/parse-geopackage.js.map +1 -0
  97. package/dist/geopackage/lib/types.d.ts +216 -0
  98. package/dist/geopackage/lib/types.d.ts.map +1 -0
  99. package/dist/geopackage/lib/types.js +5 -0
  100. package/dist/geopackage/lib/types.js.map +1 -0
  101. package/dist/geopackage/unbundled.d.ts +3 -0
  102. package/dist/geopackage/unbundled.d.ts.map +1 -0
  103. package/dist/geopackage/unbundled.js +5 -0
  104. package/dist/geopackage/unbundled.js.map +1 -0
  105. package/dist/geopackage.d.ts +2 -0
  106. package/dist/geopackage.d.ts.map +1 -0
  107. package/dist/geopackage.js +5 -0
  108. package/dist/geopackage.js.map +1 -0
  109. package/dist/gpx.d.ts +2 -0
  110. package/dist/gpx.d.ts.map +1 -0
  111. package/dist/gpx.js +5 -0
  112. package/dist/gpx.js.map +1 -0
  113. package/dist/index.cjs +15191 -0
  114. package/dist/index.cjs.map +6 -0
  115. package/dist/index.d.ts +27 -0
  116. package/dist/index.d.ts.map +1 -0
  117. package/dist/index.js +20 -0
  118. package/dist/index.js.map +1 -0
  119. package/dist/kml/bundled.d.ts +13 -0
  120. package/dist/kml/bundled.d.ts.map +1 -0
  121. package/dist/kml/bundled.js +10 -0
  122. package/dist/kml/bundled.js.map +1 -0
  123. package/dist/kml/gpx-loader-types.d.ts +61 -0
  124. package/dist/kml/gpx-loader-types.d.ts.map +1 -0
  125. package/dist/kml/gpx-loader-types.js +25 -0
  126. package/dist/kml/gpx-loader-types.js.map +1 -0
  127. package/dist/kml/gpx-loader.d.ts +56 -0
  128. package/dist/kml/gpx-loader.d.ts.map +1 -0
  129. package/dist/kml/gpx-loader.js +62 -0
  130. package/dist/kml/gpx-loader.js.map +1 -0
  131. package/dist/kml/index.cjs +11435 -0
  132. package/dist/kml/index.cjs.map +6 -0
  133. package/dist/kml/index.d.ts +18 -0
  134. package/dist/kml/index.d.ts.map +1 -0
  135. package/dist/kml/index.js +13 -0
  136. package/dist/kml/index.js.map +1 -0
  137. package/dist/kml/kml-format.d.ts +50 -0
  138. package/dist/kml/kml-format.d.ts.map +1 -0
  139. package/dist/kml/kml-format.js +62 -0
  140. package/dist/kml/kml-format.js.map +1 -0
  141. package/dist/kml/kml-loader-types.d.ts +61 -0
  142. package/dist/kml/kml-loader-types.d.ts.map +1 -0
  143. package/dist/kml/kml-loader-types.js +25 -0
  144. package/dist/kml/kml-loader-types.js.map +1 -0
  145. package/dist/kml/kml-loader.d.ts +56 -0
  146. package/dist/kml/kml-loader.d.ts.map +1 -0
  147. package/dist/kml/kml-loader.js +60 -0
  148. package/dist/kml/kml-loader.js.map +1 -0
  149. package/dist/kml/kml-parser.d.ts +98 -0
  150. package/dist/kml/kml-parser.d.ts.map +1 -0
  151. package/dist/kml/kml-parser.js +461 -0
  152. package/dist/kml/kml-parser.js.map +1 -0
  153. package/dist/kml/kml-writer.d.ts +64 -0
  154. package/dist/kml/kml-writer.d.ts.map +1 -0
  155. package/dist/kml/kml-writer.js +202 -0
  156. package/dist/kml/kml-writer.js.map +1 -0
  157. package/dist/kml/kmz-archive.d.ts +19 -0
  158. package/dist/kml/kmz-archive.d.ts.map +1 -0
  159. package/dist/kml/kmz-archive.js +72 -0
  160. package/dist/kml/kmz-archive.js.map +1 -0
  161. package/dist/kml/kmz-loader-types.d.ts +58 -0
  162. package/dist/kml/kmz-loader-types.d.ts.map +1 -0
  163. package/dist/kml/kmz-loader-types.js +24 -0
  164. package/dist/kml/kmz-loader-types.js.map +1 -0
  165. package/dist/kml/kmz-loader.d.ts +29 -0
  166. package/dist/kml/kmz-loader.d.ts.map +1 -0
  167. package/dist/kml/kmz-loader.js +41 -0
  168. package/dist/kml/kmz-loader.js.map +1 -0
  169. package/dist/kml/kmz-source.d.ts +62 -0
  170. package/dist/kml/kmz-source.d.ts.map +1 -0
  171. package/dist/kml/kmz-source.js +177 -0
  172. package/dist/kml/kmz-source.js.map +1 -0
  173. package/dist/kml/lib/feature-collection-to-arrow.d.ts +90 -0
  174. package/dist/kml/lib/feature-collection-to-arrow.d.ts.map +1 -0
  175. package/dist/kml/lib/feature-collection-to-arrow.js +181 -0
  176. package/dist/kml/lib/feature-collection-to-arrow.js.map +1 -0
  177. package/dist/kml/sports-track-parser.d.ts +6 -0
  178. package/dist/kml/sports-track-parser.d.ts.map +1 -0
  179. package/dist/kml/sports-track-parser.js +411 -0
  180. package/dist/kml/sports-track-parser.js.map +1 -0
  181. package/dist/kml/tcx-loader-types.d.ts +61 -0
  182. package/dist/kml/tcx-loader-types.d.ts.map +1 -0
  183. package/dist/kml/tcx-loader-types.js +25 -0
  184. package/dist/kml/tcx-loader-types.js.map +1 -0
  185. package/dist/kml/tcx-loader.d.ts +56 -0
  186. package/dist/kml/tcx-loader.d.ts.map +1 -0
  187. package/dist/kml/tcx-loader.js +62 -0
  188. package/dist/kml/tcx-loader.js.map +1 -0
  189. package/dist/kml/unbundled.d.ts +13 -0
  190. package/dist/kml/unbundled.d.ts.map +1 -0
  191. package/dist/kml/unbundled.js +10 -0
  192. package/dist/kml/unbundled.js.map +1 -0
  193. package/dist/kml.d.ts +2 -0
  194. package/dist/kml.d.ts.map +1 -0
  195. package/dist/kml.js +5 -0
  196. package/dist/kml.js.map +1 -0
  197. package/dist/kmz.d.ts +2 -0
  198. package/dist/kmz.d.ts.map +1 -0
  199. package/dist/kmz.js +5 -0
  200. package/dist/kmz.js.map +1 -0
  201. package/dist/shapefile/bundled.d.ts +7 -0
  202. package/dist/shapefile/bundled.d.ts.map +1 -0
  203. package/dist/shapefile/bundled.js +7 -0
  204. package/dist/shapefile/bundled.js.map +1 -0
  205. package/dist/shapefile/dbf-format.d.ts +12 -0
  206. package/dist/shapefile/dbf-format.d.ts.map +1 -0
  207. package/dist/shapefile/dbf-format.js +15 -0
  208. package/dist/shapefile/dbf-format.js.map +1 -0
  209. package/dist/shapefile/dbf-loader-types.d.ts +15 -0
  210. package/dist/shapefile/dbf-loader-types.d.ts.map +1 -0
  211. package/dist/shapefile/dbf-loader-types.js +34 -0
  212. package/dist/shapefile/dbf-loader-types.js.map +1 -0
  213. package/dist/shapefile/dbf-loader.d.ts +49 -0
  214. package/dist/shapefile/dbf-loader.d.ts.map +1 -0
  215. package/dist/shapefile/dbf-loader.js +39 -0
  216. package/dist/shapefile/dbf-loader.js.map +1 -0
  217. package/dist/shapefile/index.cjs +5742 -0
  218. package/dist/shapefile/index.cjs.map +6 -0
  219. package/dist/shapefile/index.d.ts +16 -0
  220. package/dist/shapefile/index.d.ts.map +1 -0
  221. package/dist/shapefile/index.js +18 -0
  222. package/dist/shapefile/index.js.map +1 -0
  223. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.d.ts +18 -0
  224. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.d.ts.map +1 -0
  225. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.js +129 -0
  226. package/dist/shapefile/lib/parsers/build-geoarrow-geometry-arrow.js.map +1 -0
  227. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.d.ts +12 -0
  228. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.d.ts.map +1 -0
  229. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.js +206 -0
  230. package/dist/shapefile/lib/parsers/build-wkb-geometry-arrow.js.map +1 -0
  231. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.d.ts +26 -0
  232. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.d.ts.map +1 -0
  233. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.js +347 -0
  234. package/dist/shapefile/lib/parsers/parse-dbf-to-arrow.js.map +1 -0
  235. package/dist/shapefile/lib/parsers/parse-dbf.d.ts +14 -0
  236. package/dist/shapefile/lib/parsers/parse-dbf.d.ts.map +1 -0
  237. package/dist/shapefile/lib/parsers/parse-dbf.js +352 -0
  238. package/dist/shapefile/lib/parsers/parse-dbf.js.map +1 -0
  239. package/dist/shapefile/lib/parsers/parse-shapefile.d.ts +50 -0
  240. package/dist/shapefile/lib/parsers/parse-shapefile.d.ts.map +1 -0
  241. package/dist/shapefile/lib/parsers/parse-shapefile.js +306 -0
  242. package/dist/shapefile/lib/parsers/parse-shapefile.js.map +1 -0
  243. package/dist/shapefile/lib/parsers/parse-shp-geometry.d.ts +50 -0
  244. package/dist/shapefile/lib/parsers/parse-shp-geometry.d.ts.map +1 -0
  245. package/dist/shapefile/lib/parsers/parse-shp-geometry.js +384 -0
  246. package/dist/shapefile/lib/parsers/parse-shp-geometry.js.map +1 -0
  247. package/dist/shapefile/lib/parsers/parse-shp-header.d.ts +26 -0
  248. package/dist/shapefile/lib/parsers/parse-shp-header.d.ts.map +1 -0
  249. package/dist/shapefile/lib/parsers/parse-shp-header.js +43 -0
  250. package/dist/shapefile/lib/parsers/parse-shp-header.js.map +1 -0
  251. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.d.ts +5 -0
  252. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.d.ts.map +1 -0
  253. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.js +130 -0
  254. package/dist/shapefile/lib/parsers/parse-shp-to-arrow.js.map +1 -0
  255. package/dist/shapefile/lib/parsers/parse-shp.d.ts +24 -0
  256. package/dist/shapefile/lib/parsers/parse-shp.d.ts.map +1 -0
  257. package/dist/shapefile/lib/parsers/parse-shp.js +194 -0
  258. package/dist/shapefile/lib/parsers/parse-shp.js.map +1 -0
  259. package/dist/shapefile/lib/parsers/parse-shx.d.ts +10 -0
  260. package/dist/shapefile/lib/parsers/parse-shx.d.ts.map +1 -0
  261. package/dist/shapefile/lib/parsers/parse-shx.js +28 -0
  262. package/dist/shapefile/lib/parsers/parse-shx.js.map +1 -0
  263. package/dist/shapefile/lib/parsers/types.d.ts +85 -0
  264. package/dist/shapefile/lib/parsers/types.d.ts.map +1 -0
  265. package/dist/shapefile/lib/parsers/types.js +5 -0
  266. package/dist/shapefile/lib/parsers/types.js.map +1 -0
  267. package/dist/shapefile/lib/shapefile-worker-transport.d.ts +10 -0
  268. package/dist/shapefile/lib/shapefile-worker-transport.d.ts.map +1 -0
  269. package/dist/shapefile/lib/shapefile-worker-transport.js +46 -0
  270. package/dist/shapefile/lib/shapefile-worker-transport.js.map +1 -0
  271. package/dist/shapefile/lib/streaming/binary-chunk-reader.d.ts +2 -0
  272. package/dist/shapefile/lib/streaming/binary-chunk-reader.d.ts.map +1 -0
  273. package/dist/shapefile/lib/streaming/binary-chunk-reader.js +5 -0
  274. package/dist/shapefile/lib/streaming/binary-chunk-reader.js.map +1 -0
  275. package/dist/shapefile/lib/streaming/binary-reader.d.ts +32 -0
  276. package/dist/shapefile/lib/streaming/binary-reader.d.ts.map +1 -0
  277. package/dist/shapefile/lib/streaming/binary-reader.js +55 -0
  278. package/dist/shapefile/lib/streaming/binary-reader.js.map +1 -0
  279. package/dist/shapefile/lib/streaming/zip-batch-iterators.d.ts +11 -0
  280. package/dist/shapefile/lib/streaming/zip-batch-iterators.d.ts.map +1 -0
  281. package/dist/shapefile/lib/streaming/zip-batch-iterators.js +67 -0
  282. package/dist/shapefile/lib/streaming/zip-batch-iterators.js.map +1 -0
  283. package/dist/shapefile/shapefile-arrow-loader.d.ts +8 -0
  284. package/dist/shapefile/shapefile-arrow-loader.d.ts.map +1 -0
  285. package/dist/shapefile/shapefile-arrow-loader.js +316 -0
  286. package/dist/shapefile/shapefile-arrow-loader.js.map +1 -0
  287. package/dist/shapefile/shapefile-loader-types.d.ts +80 -0
  288. package/dist/shapefile/shapefile-loader-types.d.ts.map +1 -0
  289. package/dist/shapefile/shapefile-loader-types.js +29 -0
  290. package/dist/shapefile/shapefile-loader-types.js.map +1 -0
  291. package/dist/shapefile/shapefile-loader.d.ts +57 -0
  292. package/dist/shapefile/shapefile-loader.d.ts.map +1 -0
  293. package/dist/shapefile/shapefile-loader.js +29 -0
  294. package/dist/shapefile/shapefile-loader.js.map +1 -0
  295. package/dist/shapefile/shp-format.d.ts +27 -0
  296. package/dist/shapefile/shp-format.d.ts.map +1 -0
  297. package/dist/shapefile/shp-format.js +31 -0
  298. package/dist/shapefile/shp-format.js.map +1 -0
  299. package/dist/shapefile/shp-loader-types.d.ts +28 -0
  300. package/dist/shapefile/shp-loader-types.d.ts.map +1 -0
  301. package/dist/shapefile/shp-loader-types.js +31 -0
  302. package/dist/shapefile/shp-loader-types.js.map +1 -0
  303. package/dist/shapefile/shp-loader.d.ts +54 -0
  304. package/dist/shapefile/shp-loader.d.ts.map +1 -0
  305. package/dist/shapefile/shp-loader.js +38 -0
  306. package/dist/shapefile/shp-loader.js.map +1 -0
  307. package/dist/shapefile/unbundled.d.ts +7 -0
  308. package/dist/shapefile/unbundled.d.ts.map +1 -0
  309. package/dist/shapefile/unbundled.js +7 -0
  310. package/dist/shapefile/unbundled.js.map +1 -0
  311. package/dist/shapefile.d.ts +2 -0
  312. package/dist/shapefile.d.ts.map +1 -0
  313. package/dist/shapefile.js +5 -0
  314. package/dist/shapefile.js.map +1 -0
  315. package/dist/shp-worker.js +20232 -0
  316. package/dist/shp.d.ts +2 -0
  317. package/dist/shp.d.ts.map +1 -0
  318. package/dist/shp.js +5 -0
  319. package/dist/shp.js.map +1 -0
  320. package/dist/tcx.d.ts +2 -0
  321. package/dist/tcx.d.ts.map +1 -0
  322. package/dist/tcx.js +5 -0
  323. package/dist/tcx.js.map +1 -0
  324. package/dist/workers/dbf-worker.d.ts +2 -0
  325. package/dist/workers/dbf-worker.d.ts.map +1 -0
  326. package/dist/workers/dbf-worker.js +7 -0
  327. package/dist/workers/dbf-worker.js.map +1 -0
  328. package/dist/workers/flatgeobuf-worker.d.ts +2 -0
  329. package/dist/workers/flatgeobuf-worker.d.ts.map +1 -0
  330. package/dist/workers/flatgeobuf-worker.js +7 -0
  331. package/dist/workers/flatgeobuf-worker.js.map +1 -0
  332. package/dist/workers/geopackage-worker.d.ts +2 -0
  333. package/dist/workers/geopackage-worker.d.ts.map +1 -0
  334. package/dist/workers/geopackage-worker.js +7 -0
  335. package/dist/workers/geopackage-worker.js.map +1 -0
  336. package/dist/workers/shp-worker.d.ts +2 -0
  337. package/dist/workers/shp-worker.d.ts.map +1 -0
  338. package/dist/workers/shp-worker.js +7 -0
  339. package/dist/workers/shp-worker.js.map +1 -0
  340. package/package.json +291 -4
  341. package/src/dbf.ts +5 -0
  342. package/src/flatgeobuf/LICENSE +9 -0
  343. package/src/flatgeobuf/bundled.ts +9 -0
  344. package/src/flatgeobuf/flatgeobuf-format.ts +17 -0
  345. package/src/flatgeobuf/flatgeobuf-loader-types.ts +70 -0
  346. package/src/flatgeobuf/flatgeobuf-loader.ts +66 -0
  347. package/src/flatgeobuf/flatgeobuf-source-loader.ts +338 -0
  348. package/src/flatgeobuf/flatgeobuf-table-query-capabilities.ts +14 -0
  349. package/src/flatgeobuf/index.ts +24 -0
  350. package/src/flatgeobuf/lib/flatgeobuf-reader.ts +719 -0
  351. package/src/flatgeobuf/lib/flatgeobuf-worker-transport.ts +63 -0
  352. package/src/flatgeobuf/lib/parse-flatgeobuf.ts +383 -0
  353. package/src/flatgeobuf/unbundled.ts +6 -0
  354. package/src/flatgeobuf.ts +5 -0
  355. package/src/geopackage/bundled.ts +6 -0
  356. package/src/geopackage/geopackage-format.ts +16 -0
  357. package/src/geopackage/geopackage-loader-options.ts +13 -0
  358. package/src/geopackage/geopackage-loader-types.ts +60 -0
  359. package/src/geopackage/geopackage-loader.ts +21 -0
  360. package/src/geopackage/geopackage-source-loader.ts +364 -0
  361. package/src/geopackage/index.ts +16 -0
  362. package/src/geopackage/lib/geopackage-tile-metadata.ts +156 -0
  363. package/src/geopackage/lib/parse-geopackage.ts +679 -0
  364. package/src/geopackage/lib/types.ts +293 -0
  365. package/src/geopackage/unbundled.ts +6 -0
  366. package/src/geopackage.ts +5 -0
  367. package/src/gpx.ts +5 -0
  368. package/src/index.ts +30 -0
  369. package/src/kml/bundled.ts +21 -0
  370. package/src/kml/gpx-loader-types.ts +50 -0
  371. package/src/kml/gpx-loader.ts +101 -0
  372. package/src/kml/index.ts +39 -0
  373. package/src/kml/kml-format.ts +70 -0
  374. package/src/kml/kml-loader-types.ts +46 -0
  375. package/src/kml/kml-loader.ts +98 -0
  376. package/src/kml/kml-parser.ts +593 -0
  377. package/src/kml/kml-writer.ts +252 -0
  378. package/src/kml/kmz-archive.ts +92 -0
  379. package/src/kml/kmz-loader-types.ts +37 -0
  380. package/src/kml/kmz-loader.ts +56 -0
  381. package/src/kml/kmz-source.ts +234 -0
  382. package/src/kml/lib/feature-collection-to-arrow.ts +231 -0
  383. package/src/kml/sports-track-parser.ts +426 -0
  384. package/src/kml/tcx-loader-types.ts +50 -0
  385. package/src/kml/tcx-loader.ts +101 -0
  386. package/src/kml/unbundled.ts +21 -0
  387. package/src/kml.ts +5 -0
  388. package/src/kmz.ts +5 -0
  389. package/src/shapefile/bundled.ts +18 -0
  390. package/src/shapefile/dbf-format.ts +17 -0
  391. package/src/shapefile/dbf-loader-types.ts +51 -0
  392. package/src/shapefile/dbf-loader.ts +79 -0
  393. package/src/shapefile/index.ts +25 -0
  394. package/src/shapefile/lib/parsers/build-geoarrow-geometry-arrow.ts +172 -0
  395. package/src/shapefile/lib/parsers/build-wkb-geometry-arrow.ts +340 -0
  396. package/src/shapefile/lib/parsers/parse-dbf-to-arrow.ts +429 -0
  397. package/src/shapefile/lib/parsers/parse-dbf.ts +422 -0
  398. package/src/shapefile/lib/parsers/parse-shapefile.ts +417 -0
  399. package/src/shapefile/lib/parsers/parse-shp-geometry.ts +527 -0
  400. package/src/shapefile/lib/parsers/parse-shp-header.ts +64 -0
  401. package/src/shapefile/lib/parsers/parse-shp-to-arrow.ts +184 -0
  402. package/src/shapefile/lib/parsers/parse-shp.ts +245 -0
  403. package/src/shapefile/lib/parsers/parse-shx.ts +39 -0
  404. package/src/shapefile/lib/parsers/types.ts +96 -0
  405. package/src/shapefile/lib/shapefile-worker-transport.ts +72 -0
  406. package/src/shapefile/lib/streaming/binary-chunk-reader.ts +8 -0
  407. package/src/shapefile/lib/streaming/binary-reader.ts +60 -0
  408. package/src/shapefile/lib/streaming/zip-batch-iterators.ts +78 -0
  409. package/src/shapefile/shapefile-arrow-loader.ts +448 -0
  410. package/src/shapefile/shapefile-loader-types.ts +70 -0
  411. package/src/shapefile/shapefile-loader.ts +76 -0
  412. package/src/shapefile/shp-format.ts +34 -0
  413. package/src/shapefile/shp-loader-types.ts +60 -0
  414. package/src/shapefile/shp-loader.ts +80 -0
  415. package/src/shapefile/unbundled.ts +12 -0
  416. package/src/shapefile.ts +5 -0
  417. package/src/shp.ts +5 -0
  418. package/src/tcx.ts +5 -0
  419. package/src/workers/dbf-worker.ts +8 -0
  420. package/src/workers/flatgeobuf-worker.ts +8 -0
  421. package/src/workers/geopackage-worker.ts +8 -0
  422. package/src/workers/shp-worker.ts +8 -0
@@ -0,0 +1,252 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {WriterWithEncoder, WriterOptions} from '@loaders.gl/core/loader-utils';
6
+ import type {
7
+ Feature,
8
+ FeatureCollection,
9
+ Geometry,
10
+ GeoJSONTable,
11
+ ObjectRowTable,
12
+ Position
13
+ } from '@loaders.gl/core/schema';
14
+ import {KMLFormat, KMZFormat} from './kml-format';
15
+ import {ZipWriter} from '@loaders.gl/archives/zip';
16
+
17
+ // __VERSION__ is injected by babel-plugin-version-inline
18
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
19
+ const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
20
+
21
+ /** Supported feature-oriented input values for KML writing. */
22
+ export type KMLWriterData = FeatureCollection | GeoJSONTable | ObjectRowTable;
23
+
24
+ /** Options for KML document serialization. */
25
+ export type KMLWriterOptions = WriterOptions & {
26
+ kml?: {
27
+ name?: string;
28
+ description?: string;
29
+ coordinateReferenceSystem?: 'OGC:CRS84' | 'EPSG:4326';
30
+ };
31
+ };
32
+
33
+ /** Writer for core KML geometry and feature properties. */
34
+ export const KMLWriter = {
35
+ ...KMLFormat,
36
+ version: VERSION,
37
+ text: true,
38
+ options: {
39
+ kml: {
40
+ coordinateReferenceSystem: 'OGC:CRS84'
41
+ }
42
+ },
43
+ encode: async (data: KMLWriterData, options?: KMLWriterOptions) =>
44
+ new TextEncoder().encode(encodeKMLText(data, options)).buffer,
45
+ encodeTextSync: (data: KMLWriterData, options?: KMLWriterOptions) => encodeKMLText(data, options)
46
+ } as const satisfies WriterWithEncoder<KMLWriterData, never, KMLWriterOptions>;
47
+
48
+ /** Options for KMZ archive serialization. */
49
+ export type KMZWriterOptions = WriterOptions & {
50
+ kmz?: {
51
+ kmlFileName?: string;
52
+ files?: Record<string, ArrayBuffer | string | Uint8Array>;
53
+ };
54
+ kml?: KMLWriterOptions['kml'];
55
+ };
56
+
57
+ /** Writer that serializes core KML features and packages them with optional resources. */
58
+ export const KMZWriter = {
59
+ ...KMZFormat,
60
+ version: VERSION,
61
+ options: {
62
+ kmz: {kmlFileName: 'doc.kml', files: {}}
63
+ },
64
+ encode: async (data: KMLWriterData, options?: KMZWriterOptions) => {
65
+ const kmlFileName = options?.kmz?.kmlFileName || 'doc.kml';
66
+ const files: Record<string, ArrayBuffer> = {
67
+ [kmlFileName]: new TextEncoder().encode(encodeKMLText(data, options)).buffer
68
+ };
69
+ for (const [fileName, fileData] of Object.entries(options?.kmz?.files || {})) {
70
+ files[fileName] = toArrayBuffer(fileData);
71
+ }
72
+ return await ZipWriter.encode(files, options);
73
+ }
74
+ } as const satisfies WriterWithEncoder<KMLWriterData, never, KMZWriterOptions>;
75
+
76
+ /** Serializes a feature collection or feature table as a KML document. */
77
+ export function encodeKMLText(data: KMLWriterData, options?: KMLWriterOptions): string {
78
+ const coordinateReferenceSystem =
79
+ options?.kml?.coordinateReferenceSystem || KMLWriter.options.kml.coordinateReferenceSystem;
80
+ if (coordinateReferenceSystem !== 'OGC:CRS84' && coordinateReferenceSystem !== 'EPSG:4326') {
81
+ throw new Error(`KML only supports WGS84 coordinates, received ${coordinateReferenceSystem}`);
82
+ }
83
+
84
+ const features = getFeatures(data);
85
+ const name = options?.kml?.name || 'KML Document';
86
+ const description = options?.kml?.description;
87
+ return [
88
+ '<?xml version="1.0" encoding="UTF-8"?>',
89
+ '<kml xmlns="http://www.opengis.net/kml/2.2">',
90
+ ' <Document>',
91
+ ` <name>${escapeXML(name)}</name>`,
92
+ description === undefined ? '' : ` <description>${escapeXML(description)}</description>`,
93
+ ...features.map(feature => indent(encodeFeature(feature), 4)),
94
+ ' </Document>',
95
+ '</kml>',
96
+ ''
97
+ ]
98
+ .filter(Boolean)
99
+ .join('\n');
100
+ }
101
+
102
+ function getFeatures(data: KMLWriterData): Feature[] {
103
+ if ('type' in data && data.type === 'FeatureCollection') return data.features;
104
+ if ('shape' in data && data.shape === 'geojson-table') return data.features;
105
+ if ('data' in data) return data.data as Feature[];
106
+ throw new Error('KML writer requires a FeatureCollection or feature table');
107
+ }
108
+
109
+ function encodeFeature(feature: Feature): string {
110
+ const properties = feature.properties || {};
111
+ const lines = ['<Placemark>'];
112
+ if (properties.name !== undefined)
113
+ lines.push(` <name>${escapeXML(String(properties.name))}</name>`);
114
+ if (properties.description !== undefined) {
115
+ lines.push(` <description>${escapeXML(String(properties.description))}</description>`);
116
+ }
117
+ for (const propertyName of ['visibility', 'open', 'address', 'phoneNumber']) {
118
+ const value = properties[propertyName];
119
+ if (value !== undefined)
120
+ lines.push(` <${propertyName}>${escapeXML(String(value))}</${propertyName}>`);
121
+ }
122
+ if (properties.styleUrl !== undefined) {
123
+ lines.push(` <styleUrl>${escapeXML(String(properties.styleUrl))}</styleUrl>`);
124
+ }
125
+
126
+ const extendedData = Object.entries(properties).filter(
127
+ ([name, value]) =>
128
+ ![
129
+ 'name',
130
+ 'description',
131
+ 'visibility',
132
+ 'open',
133
+ 'address',
134
+ 'phoneNumber',
135
+ 'styleUrl',
136
+ 'kml'
137
+ ].includes(name) && value !== undefined
138
+ );
139
+ if (extendedData.length) {
140
+ lines.push(' <ExtendedData>');
141
+ for (const [name, value] of extendedData) {
142
+ lines.push(
143
+ ` <Data name="${escapeXML(name)}"><value>${escapeXML(stringifyValue(value))}</value></Data>`
144
+ );
145
+ }
146
+ lines.push(' </ExtendedData>');
147
+ }
148
+ if (feature.geometry) {
149
+ lines.push(...indent(encodeGeometry(feature.geometry, properties.kml), 2));
150
+ }
151
+ lines.push('</Placemark>');
152
+ return lines.join('\n');
153
+ }
154
+
155
+ function encodeGeometry(geometry: Geometry, metadata: any = {}): string[] {
156
+ const altitudeMode = metadata?.altitudeMode;
157
+ const extrude = metadata?.extrude;
158
+ const tessellate = metadata?.tessellate;
159
+ const modifiers = [
160
+ altitudeMode === undefined
161
+ ? ''
162
+ : ` <altitudeMode>${escapeXML(String(altitudeMode))}</altitudeMode>`,
163
+ extrude === undefined ? '' : ` <extrude>${extrude ? 1 : 0}</extrude>`,
164
+ tessellate === undefined ? '' : ` <tessellate>${tessellate ? 1 : 0}</tessellate>`
165
+ ].filter(Boolean);
166
+ if (geometry.type === 'GeometryCollection') {
167
+ return [
168
+ '<MultiGeometry>',
169
+ ...geometry.geometries.flatMap(child => indent(encodeGeometry(child), 2)),
170
+ '</MultiGeometry>'
171
+ ];
172
+ }
173
+ if (geometry.type === 'Point')
174
+ return [
175
+ '<Point>',
176
+ ...modifiers,
177
+ ` <coordinates>${encodeCoordinates([geometry.coordinates])}</coordinates>`,
178
+ '</Point>'
179
+ ];
180
+ if (geometry.type === 'LineString')
181
+ return [
182
+ '<LineString>',
183
+ ...modifiers,
184
+ ` <coordinates>${encodeCoordinates(geometry.coordinates)}</coordinates>`,
185
+ '</LineString>'
186
+ ];
187
+ if (geometry.type === 'Polygon') {
188
+ const rings = geometry.coordinates
189
+ .map((ring, index) => [
190
+ ` <${index === 0 ? 'outerBoundaryIs' : 'innerBoundaryIs'}>`,
191
+ ' <LinearRing>',
192
+ ` <coordinates>${encodeCoordinates(ring)}</coordinates>`,
193
+ ' </LinearRing>',
194
+ ` </${index === 0 ? 'outerBoundaryIs' : 'innerBoundaryIs'}>`
195
+ ])
196
+ .flat();
197
+ return ['<Polygon>', ...modifiers, ...rings, '</Polygon>'];
198
+ }
199
+ if (
200
+ geometry.type === 'MultiLineString' ||
201
+ geometry.type === 'MultiPolygon' ||
202
+ geometry.type === 'MultiPoint'
203
+ ) {
204
+ return [
205
+ '<MultiGeometry>',
206
+ ...geometry.coordinates.flatMap(coordinates => {
207
+ const child =
208
+ geometry.type === 'MultiPoint'
209
+ ? {type: 'Point', coordinates}
210
+ : geometry.type === 'MultiLineString'
211
+ ? {type: 'LineString', coordinates}
212
+ : {type: 'Polygon', coordinates};
213
+ return indent(encodeGeometry(child as Geometry), 2);
214
+ }),
215
+ '</MultiGeometry>'
216
+ ];
217
+ }
218
+ throw new Error(`Unsupported KML geometry: ${(geometry as {type: string}).type}`);
219
+ }
220
+
221
+ function encodeCoordinates(coordinates: Position[]): string {
222
+ return coordinates.map(coordinate => coordinate.map(value => String(value)).join(',')).join(' ');
223
+ }
224
+
225
+ function indent(lines: string | string[], spaces: number): string[] {
226
+ const values = Array.isArray(lines) ? lines : lines.split('\n');
227
+ return values.map(line => `${' '.repeat(spaces)}${line}`);
228
+ }
229
+
230
+ function escapeXML(value: string): string {
231
+ return value
232
+ .replace(/&/g, '&amp;')
233
+ .replace(/</g, '&lt;')
234
+ .replace(/>/g, '&gt;')
235
+ .replace(/"/g, '&quot;')
236
+ .replace(/'/g, '&apos;');
237
+ }
238
+
239
+ function stringifyValue(value: unknown): string {
240
+ return typeof value === 'object' ? JSON.stringify(value) : String(value);
241
+ }
242
+
243
+ function toArrayBuffer(value: ArrayBuffer | string | Uint8Array): ArrayBuffer {
244
+ if (typeof value === 'string') return new TextEncoder().encode(value).buffer;
245
+ if (value instanceof Uint8Array) {
246
+ if (value.byteOffset === 0 && value.byteLength === value.buffer.byteLength) {
247
+ return value.buffer as ArrayBuffer;
248
+ }
249
+ return value.slice().buffer;
250
+ }
251
+ return value;
252
+ }
@@ -0,0 +1,92 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import {HttpFile} from '@loaders.gl/core/loader-utils';
6
+ import {ZipFileSystem} from '@loaders.gl/archives/zip';
7
+ import type {KMLDocument} from './kml-parser';
8
+ import {parseKMLDocument} from './kml-parser';
9
+
10
+ /** An opened KMZ archive with lazy access to its entries. */
11
+ export type KMZArchive = {
12
+ /** Name of the primary KML document inside the archive. */
13
+ readonly kmlFileName: string;
14
+ /** Names of all non-directory archive entries. */
15
+ readonly fileNames: string[];
16
+ /** Parsed primary KML document. */
17
+ readonly document: KMLDocument;
18
+ /** Reads an archive entry by its path relative to the primary KML file. */
19
+ getResource(path: string): Promise<ArrayBuffer>;
20
+ /** Closes the archive's underlying file handle. */
21
+ close(): Promise<void>;
22
+ };
23
+
24
+ /** Opens a KMZ URL, Blob, or ArrayBuffer and parses its primary KML document. */
25
+ export async function openKMZArchive(
26
+ data: string | Blob | ArrayBuffer,
27
+ fetch?: (url: string, options?: RequestInit) => Promise<Response>
28
+ ): Promise<KMZArchive> {
29
+ const file =
30
+ typeof data === 'string'
31
+ ? new HttpFile(data, fetch ? {fetch} : {})
32
+ : (data as Blob | ArrayBuffer);
33
+ const zipFileSystem = new ZipFileSystem(file as Blob | ArrayBuffer | HttpFile);
34
+ try {
35
+ const fileNames = (await zipFileSystem.readdir()).filter(fileName => !fileName.endsWith('/'));
36
+ const kmlFileName = findPrimaryKMLFile(fileNames);
37
+ const response = await zipFileSystem.fetch(kmlFileName);
38
+ const document = parseKMLDocument(await response.text());
39
+
40
+ return {
41
+ kmlFileName,
42
+ fileNames,
43
+ document,
44
+ getResource: async path => {
45
+ const resourceName = resolveKMZResourcePath(kmlFileName, path);
46
+ if (!resourceName) throw new Error(`KMZ resource is external: ${path}`);
47
+ return await (await zipFileSystem.fetch(resourceName)).arrayBuffer();
48
+ },
49
+ close: () => zipFileSystem.destroy()
50
+ };
51
+ } catch (error) {
52
+ await zipFileSystem.destroy();
53
+ throw error;
54
+ }
55
+ }
56
+
57
+ function findPrimaryKMLFile(fileNames: string[]): string {
58
+ const rootDocument = fileNames.find(fileName => fileName.toLowerCase() === 'doc.kml');
59
+ if (rootDocument) return rootDocument;
60
+
61
+ const rootKMLFiles = fileNames.filter(
62
+ fileName => !fileName.includes('/') && fileName.toLowerCase().endsWith('.kml')
63
+ );
64
+ if (rootKMLFiles.length) return rootKMLFiles[0];
65
+
66
+ const anyKMLFile = fileNames.find(fileName => fileName.toLowerCase().endsWith('.kml'));
67
+ if (anyKMLFile) return anyKMLFile;
68
+ throw new Error('KMZ archive does not contain a KML document');
69
+ }
70
+
71
+ /** Resolves a KML href relative to the primary KML document within the archive. */
72
+ export function resolveKMZResourcePath(kmlFileName: string, href: string): string | null {
73
+ const trimmedHref = href.trim();
74
+ if (!trimmedHref || /^[a-z][a-z\d+.-]*:/i.test(trimmedHref) || trimmedHref.startsWith('//')) {
75
+ return null;
76
+ }
77
+
78
+ const hrefWithoutQuery = trimmedHref.split(/[?#]/, 1)[0];
79
+ const baseParts = kmlFileName.split('/').slice(0, -1);
80
+ const pathParts = [...baseParts, ...decodeURIComponent(hrefWithoutQuery).split('/')];
81
+ const normalizedParts: string[] = [];
82
+ for (const part of pathParts) {
83
+ if (!part || part === '.') continue;
84
+ if (part === '..') {
85
+ if (!normalizedParts.length) return null;
86
+ normalizedParts.pop();
87
+ } else {
88
+ normalizedParts.push(part);
89
+ }
90
+ }
91
+ return normalizedParts.join('/');
92
+ }
@@ -0,0 +1,37 @@
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 {GeoJSONTable, ObjectRowTable, ArrowTable} from '@loaders.gl/core/schema';
7
+ import {KMZFormat} from './kml-format';
8
+
9
+ // __VERSION__ is injected by babel-plugin-version-inline
10
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
11
+ const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
12
+
13
+ export type KMZLoaderOptions = LoaderOptions & {
14
+ kmz?: {
15
+ shape?: 'object-row-table' | 'geojson-table' | 'arrow-table';
16
+ includeKMLMetadata?: boolean;
17
+ };
18
+ };
19
+
20
+ /** Preloads the parser-bearing KMZ loader implementation. */
21
+ async function preload() {
22
+ return (await import('@loaders.gl/geospatial/kmz')).KMZLoaderWithParser;
23
+ }
24
+
25
+ /** Metadata-only loader for KMZ archives containing KML documents. */
26
+ export const KMZLoader = {
27
+ dataType: null as unknown as ObjectRowTable | GeoJSONTable | ArrowTable,
28
+ batchType: null as never,
29
+
30
+ ...KMZFormat,
31
+ version: VERSION,
32
+ options: {
33
+ kmz: {shape: 'arrow-table', includeKMLMetadata: false},
34
+ gis: {}
35
+ },
36
+ preload
37
+ } as const satisfies Loader<ObjectRowTable | GeoJSONTable | ArrowTable, never, KMZLoaderOptions>;
@@ -0,0 +1,56 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {LoaderWithParser} from '@loaders.gl/core/loader-utils';
6
+ import type {GeoJSONTable, ObjectRowTable, ArrowTable} from '@loaders.gl/core/schema';
7
+ import {
8
+ buildFeatureTableSchema,
9
+ convertFeatureCollectionToArrowTable
10
+ } from './lib/feature-collection-to-arrow';
11
+ import {convertKMLDocumentToFeatureCollection} from './kml-parser';
12
+ import {KMZLoader as KMZLoaderMetadata, type KMZLoaderOptions} from './kmz-loader-types';
13
+ import {openKMZArchive} from './kmz-archive';
14
+
15
+ const {preload: _KMZLoaderPreload, ...KMZLoaderMetadataWithoutPreload} = KMZLoaderMetadata;
16
+
17
+ /** Parser-bearing loader for KMZ archives containing KML documents. */
18
+ export const KMZLoaderWithParser = {
19
+ ...KMZLoaderMetadataWithoutPreload,
20
+ parse: async (arrayBuffer, options?: KMZLoaderOptions) =>
21
+ parseKMZArrayBuffer(arrayBuffer, options)
22
+ } as const satisfies LoaderWithParser<
23
+ ObjectRowTable | GeoJSONTable | ArrowTable,
24
+ never,
25
+ KMZLoaderOptions
26
+ >;
27
+
28
+ /** Parses a KMZ archive into the requested public table shape. */
29
+ export async function parseKMZArrayBuffer(
30
+ arrayBuffer: ArrayBuffer,
31
+ options?: KMZLoaderOptions
32
+ ): Promise<ObjectRowTable | GeoJSONTable | ArrowTable> {
33
+ const archive = await openKMZArchive(arrayBuffer);
34
+ try {
35
+ const document = convertKMLDocumentToFeatureCollection(archive.document, {
36
+ includeKMLMetadata: options?.kmz?.includeKMLMetadata
37
+ });
38
+ const shape = options?.kmz?.shape || KMZLoaderWithParser.options.kmz.shape;
39
+ switch (shape) {
40
+ case 'object-row-table':
41
+ return {shape, data: document.features};
42
+ case 'arrow-table':
43
+ return convertFeatureCollectionToArrowTable(document.features);
44
+ case 'geojson-table':
45
+ default:
46
+ return {
47
+ shape: 'geojson-table',
48
+ schema: buildFeatureTableSchema(document.features),
49
+ type: 'FeatureCollection',
50
+ features: document.features
51
+ };
52
+ }
53
+ } finally {
54
+ await archive.close();
55
+ }
56
+ }
@@ -0,0 +1,234 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {Feature, GeoJSONTable, Schema} from '@loaders.gl/core/schema';
6
+ import type {
7
+ CoreAPI,
8
+ DataSourceOptions,
9
+ GetFeaturesParameters,
10
+ SourceLoader,
11
+ VectorSource,
12
+ VectorSourceData,
13
+ VectorSourceLayer,
14
+ VectorSourceMetadata
15
+ } from '@loaders.gl/core/loader-utils';
16
+ import {DataSource} from '@loaders.gl/core/loader-utils';
17
+ import {
18
+ buildFeatureTableSchema,
19
+ convertFeatureCollectionToArrowTable
20
+ } from './lib/feature-collection-to-arrow';
21
+ import {KMZFormat} from './kml-format';
22
+ import {openKMZArchive, type KMZArchive} from './kmz-archive';
23
+ import type {KMLFolder} from './kml-parser';
24
+
25
+ // __VERSION__ is injected by babel-plugin-version-inline
26
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
27
+ const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
28
+
29
+ export type KMZSourceOptions = DataSourceOptions & {
30
+ kmz?: {
31
+ format?: 'geojson' | 'arrow';
32
+ };
33
+ };
34
+
35
+ /** Source loader for KMZ archives containing one primary KML document. */
36
+ export const KMZSourceLoader = {
37
+ dataType: null as unknown as KMZVectorSource,
38
+ batchType: null as never,
39
+ ...KMZFormat,
40
+ version: VERSION,
41
+ type: 'kmz',
42
+ fromUrl: true,
43
+ fromBlob: true,
44
+ options: {kmz: {format: 'arrow'}},
45
+ defaultOptions: {kmz: {format: 'arrow'}},
46
+ testURL: (url: string): boolean => /\.kmz($|[?#])/i.test(url),
47
+ testData: (data: Blob): boolean =>
48
+ ['application/vnd.google-earth.kmz', 'application/vnd.google-earth.kmz+zip'].includes(
49
+ data.type.toLowerCase()
50
+ ),
51
+ createDataSource: (data: string | Blob, options: KMZSourceOptions, coreApi?: CoreAPI) =>
52
+ new KMZVectorSource(data, options, coreApi)
53
+ } as const satisfies SourceLoader<KMZVectorSource>;
54
+
55
+ /** Lazy vector source backed by a KMZ archive. */
56
+ export class KMZVectorSource
57
+ extends DataSource<string | Blob, KMZSourceOptions>
58
+ implements VectorSource
59
+ {
60
+ protected readonly archivePromise: Promise<KMZArchive>;
61
+
62
+ /** Creates a source from a KMZ URL, Blob, or File. */
63
+ constructor(data: string | Blob, options: KMZSourceOptions, coreApi?: CoreAPI) {
64
+ super(data, options, KMZSourceLoader.defaultOptions, coreApi);
65
+ this.archivePromise = openKMZArchive(data, this.fetch);
66
+ }
67
+
68
+ /** Opens the archive and parses its primary KML document. */
69
+ async initialize(): Promise<void> {
70
+ await this.archivePromise;
71
+ }
72
+
73
+ /** Releases the archive's underlying file handle. */
74
+ async close(): Promise<void> {
75
+ const archive = await this.archivePromise;
76
+ await archive.close();
77
+ }
78
+
79
+ /** Returns the schema inferred from Placemark properties. */
80
+ async getSchema(): Promise<Schema> {
81
+ const archive = await this.archivePromise;
82
+ return buildFeatureTableSchema(archive.document.features);
83
+ }
84
+
85
+ /** Returns normalized KMZ metadata, including the archive entry names when requested. */
86
+ async getMetadata(
87
+ options: {formatSpecificMetadata?: boolean} = {}
88
+ ): Promise<VectorSourceMetadata> {
89
+ const archive = await this.archivePromise;
90
+ const metadata: VectorSourceMetadata = {
91
+ name: archive.document.name || archive.kmlFileName,
92
+ title: archive.document.name,
93
+ abstract: archive.document.description,
94
+ keywords: [],
95
+ layers: [makeRootLayer(archive.document.features, archive.document.folders)]
96
+ };
97
+ if (options.formatSpecificMetadata) {
98
+ metadata.formatSpecificMetadata = {
99
+ kmlFileName: archive.kmlFileName,
100
+ fileNames: archive.fileNames,
101
+ coordinateReferenceSystem: archive.document.coordinateReferenceSystem,
102
+ overlays: omitRawMetadata(archive.document.overlays),
103
+ networkLinks: omitRawMetadata(archive.document.networkLinks),
104
+ models: omitRawMetadata(archive.document.models),
105
+ styles: archive.document.styles
106
+ };
107
+ }
108
+ return metadata;
109
+ }
110
+
111
+ /** Returns lazily decoded bytes for a resource referenced by the primary KML document. */
112
+ async getResource(path: string): Promise<ArrayBuffer> {
113
+ const archive = await this.archivePromise;
114
+ return archive.getResource(path);
115
+ }
116
+
117
+ /** Returns all matching Placemark features, optionally filtered by a WGS84 bounding box. */
118
+ async getFeatures(parameters: GetFeaturesParameters): Promise<VectorSourceData> {
119
+ const archive = await this.archivePromise;
120
+ const features = parameters.boundingBox
121
+ ? archive.document.features.filter(feature =>
122
+ featureIntersectsBounds(feature, parameters.boundingBox)
123
+ )
124
+ : archive.document.features;
125
+ const format = parameters.format || this.options.kmz?.format || 'arrow';
126
+ if (format === 'arrow') return convertFeatureCollectionToArrowTable(features);
127
+ if (format === 'binary') {
128
+ throw new Error('KMZVectorSource does not yet support binary geometry output');
129
+ }
130
+ const table: GeoJSONTable = {
131
+ shape: 'geojson-table',
132
+ schema: buildFeatureTableSchema(features),
133
+ type: 'FeatureCollection',
134
+ features
135
+ };
136
+ return table;
137
+ }
138
+ }
139
+
140
+ /** Removes DOM nodes from metadata exposed through the serializable source API. */
141
+ function omitRawMetadata<T extends {raw: unknown}>(values: readonly T[]): Array<Omit<T, 'raw'>> {
142
+ return values.map(({raw: _raw, ...value}) => value);
143
+ }
144
+
145
+ function makeRootLayer(
146
+ features: readonly Feature[],
147
+ folders: readonly KMLFolder[]
148
+ ): VectorSourceLayer {
149
+ const bounds = getFeatureBounds(features);
150
+ return {
151
+ name: 'default',
152
+ title: 'KML features',
153
+ crs: ['OGC:CRS84'],
154
+ boundingBox: bounds,
155
+ layers: folders.map(folder => ({
156
+ name: folder.path.join('/'),
157
+ title: folder.name,
158
+ crs: ['OGC:CRS84'],
159
+ boundingBox: getFeatureBounds(folder.features)
160
+ }))
161
+ };
162
+ }
163
+
164
+ function featureIntersectsBounds(
165
+ feature: Feature,
166
+ bounds: GetFeaturesParameters['boundingBox']
167
+ ): boolean {
168
+ const featureBounds = getGeometryBounds(feature.geometry);
169
+ if (!featureBounds) return false;
170
+ return !(
171
+ featureBounds[1][0] < bounds[0][0] ||
172
+ featureBounds[0][0] > bounds[1][0] ||
173
+ featureBounds[1][1] < bounds[0][1] ||
174
+ featureBounds[0][1] > bounds[1][1]
175
+ );
176
+ }
177
+
178
+ function getFeatureBounds(
179
+ features: readonly Feature[]
180
+ ): [[number, number], [number, number]] | undefined {
181
+ const bounds = features.map(feature => getGeometryBounds(feature.geometry)).filter(Boolean);
182
+ if (!bounds.length) return undefined;
183
+ return [
184
+ [
185
+ Math.min(...bounds.map(bound => bound![0][0])),
186
+ Math.min(...bounds.map(bound => bound![0][1]))
187
+ ],
188
+ [Math.max(...bounds.map(bound => bound![1][0])), Math.max(...bounds.map(bound => bound![1][1]))]
189
+ ];
190
+ }
191
+
192
+ function getGeometryBounds(
193
+ geometry: Feature['geometry']
194
+ ): [[number, number], [number, number]] | undefined {
195
+ if (!geometry) return undefined;
196
+ const bounds = {minX: Infinity, minY: Infinity, maxX: -Infinity, maxY: -Infinity};
197
+ visitGeometryCoordinates(geometry, bounds);
198
+ if (bounds.minX === Infinity) return undefined;
199
+ return [
200
+ [bounds.minX, bounds.minY],
201
+ [bounds.maxX, bounds.maxY]
202
+ ];
203
+ }
204
+
205
+ function visitGeometryCoordinates(
206
+ geometry: Feature['geometry'],
207
+ bounds: {minX: number; minY: number; maxX: number; maxY: number}
208
+ ): void {
209
+ if (!geometry) return;
210
+ if ('coordinates' in geometry) {
211
+ visitCoordinates(geometry.coordinates, bounds);
212
+ } else {
213
+ for (const child of geometry.geometries) visitGeometryCoordinates(child, bounds);
214
+ }
215
+ }
216
+
217
+ function visitCoordinates(
218
+ coordinates: unknown,
219
+ bounds: {minX: number; minY: number; maxX: number; maxY: number}
220
+ ): void {
221
+ if (!Array.isArray(coordinates)) return;
222
+ if (typeof coordinates[0] === 'number') {
223
+ const x = Number(coordinates[0]);
224
+ const y = Number(coordinates[1]);
225
+ if (Number.isFinite(x) && Number.isFinite(y)) {
226
+ bounds.minX = Math.min(bounds.minX, x);
227
+ bounds.minY = Math.min(bounds.minY, y);
228
+ bounds.maxX = Math.max(bounds.maxX, x);
229
+ bounds.maxY = Math.max(bounds.maxY, y);
230
+ }
231
+ return;
232
+ }
233
+ for (const child of coordinates) visitCoordinates(child, bounds);
234
+ }