import type { IdentifiedGeoJSONFeature } from "./geojson-types.js";
import type { FeatureId, FeatureSourceListener, ReadonlyFeatureSource, SourceSnapshot } from "./source-types.js";
export type FeatureCollectionInput<TFeature extends IdentifiedGeoJSONFeature> = {
    type: "FeatureCollection";
    features: TFeature[];
    bbox?: number[];
};
export type FeatureSourceInput<TFeature extends IdentifiedGeoJSONFeature> = TFeature | FeatureCollectionInput<TFeature> | Iterable<TFeature>;
export type FeatureUpdate<TFeature extends IdentifiedGeoJSONFeature> = TFeature | Partial<Omit<TFeature, "type" | "id">>;
/** Reactive, renderer-independent GeoJSON feature storage. */
export declare class FeatureSource<TFeature extends IdentifiedGeoJSONFeature = IdentifiedGeoJSONFeature> implements ReadonlyFeatureSource<TFeature> {
    #private;
    constructor(input?: FeatureSourceInput<TFeature> | null);
    get size(): number;
    get version(): number;
    has(id: FeatureId): boolean;
    get(id: FeatureId): TFeature | undefined;
    getSnapshot(): SourceSnapshot<TFeature>;
    /** Return only the feature collection, without the snapshot version. */
    getFeatures(): readonly TFeature[];
    toGeoJSON(): FeatureCollectionInput<TFeature>;
    add(feature: TFeature): this;
    addMany(features: Iterable<TFeature>): this;
    /**
     * Shallow-merge a full feature or a patch into an existing id.
     * Both overloads preserve unspecified optional fields from the current value.
     */
    update(feature: TFeature): this;
    update(id: FeatureId, update: FeatureUpdate<TFeature>): this;
    remove(id: FeatureId | Iterable<FeatureId>): this;
    replace(input: FeatureSourceInput<TFeature>): this;
    clear(): this;
    /** Run synchronous nested mutations as one versioned `batch` (or `reset`). */
    batch(callback: () => void): this;
    subscribe(listener: FeatureSourceListener<TFeature>): () => void;
}
export declare function featureSource<TFeature extends IdentifiedGeoJSONFeature = IdentifiedGeoJSONFeature>(input?: FeatureSourceInput<TFeature> | null): FeatureSource<TFeature>;
export type { IdentifiedGeoJSONFeature } from "./geojson-types.js";
export type { FeatureId, FeatureSourceChange, FeatureSourceDelta, FeatureSourceListener, ReadonlyFeatureSource, SourceSnapshot } from "./source-types.js";
//# sourceMappingURL=feature-source.d.ts.map