/**
 * OSM entity to GeoJSON Feature conversion.
 *
 * Converts OSM nodes, ways, and relations into GeoJSON Features with
 * appropriate geometry types and preserved properties.
 *
 * @module
 */
import type { OsmReader } from "@osmix/core/contracts";
import type { OsmEntity, OsmNode, OsmRelation, OsmWay } from "@osmix/types";
import type { GeometryCollection, LineString, MultiLineString, MultiPoint, MultiPolygon, Point, Polygon } from "geojson";
import type { OsmGeoJSONFeature } from "./types.ts";
/**
 * Convert an OSM node to a GeoJSON Point feature.
 *
 * @param node - OSM node with id, lon, lat, and optional tags.
 * @returns GeoJSON Point Feature with OSM properties.
 *
 * @example
 * ```ts
 * const feature = nodeToFeature({ id: 1, lon: -122.4, lat: 47.6, tags: { name: "Seattle" } })
 * // { type: "Feature", geometry: { type: "Point", coordinates: [-122.4, 47.6] }, ... }
 * ```
 */
export declare function nodeToFeature(node: OsmNode): OsmGeoJSONFeature<Point>;
/**
 * Convert an OSM way to a GeoJSON LineString or Polygon feature.
 *
 * Geometry type is determined by the `wayIsArea` helper, which checks for
 * area-indicating tags (building, landuse, etc.) and ring closure.
 *
 * @param way - OSM way with id, refs, and optional tags.
 * @param refToPosition - Function to resolve node ID to coordinates, or null for a missing node.
 * @returns GeoJSON LineString or Polygon Feature with OSM properties.
 *
 * @example
 * ```ts
 * const feature = wayToFeature(way, (ref) => osm.nodes.getNodeLonLat({ id: ref }))
 * ```
 */
export declare function wayToFeature(way: OsmWay, refToPosition: (id: number) => [number, number] | null | undefined): OsmGeoJSONFeature<LineString | Polygon>;
/**
 * Convert an OSM relation to a GeoJSON feature.
 *
 * Geometry type is determined by relation type and tags:
 * - **Multipolygon/boundary**: MultiPolygon or Polygon
 * - **Route/multilinestring**: MultiLineString or LineString
 * - **Site/collection**: MultiPoint or Point
 * - **Other**: GeometryCollection (empty for logical relations)
 *
 * @param relation - OSM relation with id, members, and optional tags.
 * @param refToPosition - Function to resolve node ID to coordinates, or null for a missing node.
 * @param getWay - Optional function to resolve way ID to OsmWay (required for polygons/lines).
 * @returns GeoJSON Feature with appropriate geometry type.
 *
 * @example
 * ```ts
 * const feature = relationToFeature(
 *   relation,
 *   (ref) => osm.nodes.getNodeLonLat({ id: ref }),
 *   (ref) => osm.ways.getById(ref)
 * )
 * ```
 */
export declare function relationToFeature(relation: OsmRelation, refToPosition: (id: number) => [number, number] | null | undefined, getWay?: (wayId: number) => OsmWay | null): OsmGeoJSONFeature<Polygon | MultiPolygon | LineString | MultiLineString | Point | MultiPoint | GeometryCollection>;
/**
 * Convert any OSM entity to a GeoJSON feature using an Osm index.
 *
 * Convenience function that handles entity type detection and coordinate
 * resolution automatically using the provided Osm index.
 *
 * @param osm - Osm index for coordinate lookups.
 * @param entity - Any OSM entity (node, way, or relation).
 * @returns GeoJSON Feature with appropriate geometry.
 * @throws If entity type is unknown.
 *
 * @example
 * ```ts
 * for (const way of osm.ways) {
 *   const feature = osmEntityToGeoJSONFeature(osm, way)
 *   features.push(feature)
 * }
 * ```
 */
export declare function osmEntityToGeoJSONFeature(osm: OsmReader, entity: OsmEntity): OsmGeoJSONFeature<GeoJSON.Point | GeoJSON.LineString | GeoJSON.Polygon | GeoJSON.MultiPolygon | GeoJSON.MultiLineString | GeoJSON.MultiPoint | GeoJSON.GeometryCollection>;
//# sourceMappingURL=entity-to-feature.d.ts.map