Mark geoparquet package as deprecated

Author: platypii

README.md

@@ -1,5 +1,3 @@
-# GeoParquet
-
 ![GeoParquet parakeets gathered around a map](geoparquet.jpg)
 
 [![npm](https://img.shields.io/npm/v/geoparquet)](https://www.npmjs.com/package/geoparquet)
@@ -9,6 +7,29 @@
 ![coverage](https://img.shields.io/badge/Coverage-95-darkred)
 [![dependencies](https://img.shields.io/badge/Dependencies-1-blueviolet)](https://www.npmjs.com/package/geoparquet?activeTab=dependencies)
 
+# GeoParquet is DEPRECATED
+
+This GeoParquet JS library has been deprecated in favor of native support for GeoParquet in [hyparquet](https://github.com/hyparam/hyparquet).
+
+We recommend using hyparquet directly for reading GeoParquet files:
+
+```javascript
+const { asyncBufferFromUrl, parquetReadObjects } = await import('hyparquet')
+
+const file = await asyncBufferFromUrl({ url: 'example.parquet' })
+const data = await parquetReadObjects({ file })
+const geojson = {
+  type: 'FeatureCollection',
+  features: data.map(({ geometry, ...properties }) => ({
+    type: 'Feature',
+    geometry,
+    properties,
+  }))
+}
+```
+
+# GeoParquet
+
 **GeoParquet** provides a pure JavaScript workflow to read and convert [GeoParquet](https://github.com/opengeospatial/geoparquet) files into [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946). Under the hood, it uses the [hyparquet](https://github.com/hyparam/hyparquet) library for efficient in-browser parquet parsing, enabling minimal overhead and fast loading.
 
 ## Why GeoParquet?
@@ -19,17 +40,6 @@
 - **Faster loading:** Pure JavaScript parsing of Parquet files in the browser, with tiny package size means fast page load times.
 - **Seamless integration:** GeoParquet is based on well-established standards (GeoJSON, Parquet), ensuring broad compatibility and extensibility.
 
-## Usage
-
-Convert a GeoParquet file to GeoJSON:
-
-```javascript
-const { asyncBufferFromUrl, toGeoJson } = await import('geoparquet')
-
-const file = asyncBufferFromUrl({ url: 'example.parquet' })
-const geoJson = toGeoJson({ file })
-```
-
 ## Demo
 
 Check out the [live demo](https://hyparam.github.io/geoparquet/) to see GeoParquet in action.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "geoparquet",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A library for reading geospatial data in Apache Parquet format",
   "author": "Hyperparam",
   "homepage": "https://hyperparam.app",