@zwishing/emap 0.1.3 → 0.2.0

package/dist/source/topology-source.d.ts

@@ -2,7 +2,7 @@ import { EventDispatcher } from '../core/events';
 import { TopologySource as ITopologySource } from './source';
 import { Bounds } from '../geo/bounds';
 import { DisplayArcs } from './display-arcs';
-import type { MapshaperDataset } from '../types/mapshaper-types';
+import type { MapshaperDataset, MapshaperLayer } from '../types/mapshaper-types';
 import type { ExportOptions } from './source';
 import { type MapshaperRunner } from './mapshaper-runner';
 export type TopologySourceData = string | {
@@ -63,6 +63,13 @@ export declare class TopologySource extends EventDispatcher implements ITopology
     private _data;
     private _loadVersion;
     private _abortController;
+    /**
+     * Deferred backing the {@link setData} promise. Settled by the matching
+     * `_loadVersion`'s `_updateData` run (resolve on `data`, reject on `error`).
+     * A superseding `setData` resolves it early — last-write-wins, the newer
+     * call owns the next outcome.
+     */
+    private _pending;
     /**
      * Sticky simplification floor. mapshaper's `-simplify` writes a
      * `retainedInterval` into the resulting `ArcCollection`; we cache that
@@ -95,12 +102,24 @@ export declare class TopologySource extends EventDispatcher implements ITopology
      * layer in one dataset — same behaviour as mapshaper's
      * `-i FILE1 FILE2 ...` CLI invocation).
      *
+     * Returns a promise that resolves with the source once the import
+     * completes and rejects if it fails — `await source.setData(...)` is the
+     * canonical way to wait for the dataset. The `data` / `error` events still
+     * fire for event-driven consumers.
+     *
      * Last-write-wins: rapid back-to-back calls supersede each other. Only the
      * latest call's outcome fires `data` / `error`; in-flight URL fetches from
-     * superseded calls are aborted.
+     * superseded calls are aborted. A superseded call's promise resolves early
+     * (the newer call owns the next outcome) so awaiting it never hangs.
      */
-    setData(data: TopologySourceInput): this;
+    setData(data: TopologySourceInput): Promise<TopologySource>;
     private _updateData;
+    /**
+     * Settle the {@link setData} deferred for the given load version. Ignored
+     * if a newer call has already replaced it (the superseding `setData`
+     * resolved the old deferred early).
+     */
+    private _settlePending;
     private _hasSupportedExtension;
     private _filenameFromContentType;
     getDataset(): MapshaperDataset | undefined;
@@ -150,7 +169,12 @@ export declare class TopologySource extends EventDispatcher implements ITopology
      * Single-file formats use the first entry directly; shapefile is zipped.
      */
     private _filesToBlob;
-    getLayers(): any[];
+    /**
+     * The dataset's layers, or `[]` before the first successful import.
+     * Each entry is a {@link MapshaperLayer} (`name`, optional `geometry_type`
+     * — `'polygon' | 'polyline' | 'point'`, absent for data-only layers).
+     */
+    getLayers(): MapshaperLayer[];
     private _isZipFile;
     private _extractZip;
     private _isTextFile;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zwishing/emap",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "A modern, decoupled rendering engine for mapshaper data",
   "main": "dist/emap.mjs",
   "module": "dist/emap.mjs",