@richpods/tiny-geojson-tool 0.1.0 → 0.1.1

package/README.md

@@ -78,6 +78,20 @@ The editor toolbar provides six modes:
 
 Right-click or press Escape to cancel drawing.
 
+## Bounding Box
+
+The GeoJSON `bbox` member ([RFC 7946 §5](https://datatracker.ietf.org/doc/html/rfc7946#section-5)) can be used to store and restore a map view. `GeoJsonEditor` exposes a `saveBbox` method via template ref, and both components respect an existing `bbox` on load.
+
+```javascript
+// Save the current map view as bbox
+editorRef.value.saveBbox();
+
+// Or provide a custom bbox [west, south, east, north]
+editorRef.value.saveBbox([-74.1, 40.6, -73.8, 40.9]);
+```
+
+When a `bbox` is present on the feature collection, both `GeoJsonEditor` and `GeoJsonViewer` will fit the map to that bounding box on load (instead of auto-fitting to features). Explicit `center`/`zoom` props still take priority over `bbox`.
+
 ## Style Properties
 
 Features support [simplestyle-spec 1.1.0](https://github.com/mapbox/simplestyle-spec) properties:
@@ -129,6 +143,20 @@ See `EditorLocale` for the full list of keys and `DEFAULT_LOCALE` for the Englis
 
 All styles use CSS custom properties prefixed with `--tge-`. Override them to customize the look.
 
+## Utilities
+
+The library exports helper functions for working with GeoJSON data outside of the components.
+
+| Function | Description |
+|----------|-------------|
+| `computeBbox(fc)` | Compute a `BBox` (`[west, south, east, north]`) from a feature collection. Returns `undefined` if there are no features. |
+
+```ts
+import { computeBbox } from "@richpods/tiny-geojson-tool";
+
+const bbox = computeBbox(geojson.value);
+```
+
 ## Base Map
 
 The base map expects vector tiles served from a PMTiles archive. We recommend the [Shortbread](https://shortbread-tiles.org/) schema for your tiles. You must provide the `pmtilesUrl` prop pointing to your own tile source.

package/dist/components/EditorMap.vue.d.ts

@@ -1,4 +1,4 @@
-import type { EditorFeatureCollection, EditorFeature, Position, ToolMode } from "../types";
+import type { BBox, EditorFeatureCollection, EditorFeature, Position, ToolMode } from "../types";
 type __VLS_Props = {
     modelValue: EditorFeatureCollection;
     activeTool: ToolMode;
@@ -7,16 +7,21 @@ type __VLS_Props = {
     center?: Position;
     zoom?: number;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+declare function saveBbox(bbox?: BBox): void;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    saveBbox: typeof saveBbox;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     "update:modelValue": (value: EditorFeatureCollection) => any;
     featureClick: (feature: EditorFeature | null) => any;
     featureDelete: (id: string) => any;
     toolDone: (featureId: string) => any;
+    moveend: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: EditorFeatureCollection) => any) | undefined;
     onFeatureClick?: ((feature: EditorFeature | null) => any) | undefined;
     onFeatureDelete?: ((id: string) => any) | undefined;
     onToolDone?: ((featureId: string) => any) | undefined;
+    onMoveend?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/GeoJsonEditor.vue.d.ts

@@ -1,4 +1,4 @@
-import type { EditorFeatureCollection, Position } from "../types";
+import type { BBox, EditorFeatureCollection, Position } from "../types";
 import type { EditorLocale } from "../l10n";
 type __VLS_Props = {
     pmtilesUrl: string;
@@ -7,14 +7,20 @@ type __VLS_Props = {
     zoom?: number;
     l10n?: Partial<EditorLocale>;
 };
+declare function saveBbox(bbox?: BBox): void;
 type __VLS_ModelProps = {
     modelValue?: EditorFeatureCollection;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
+    saveBbox: typeof saveBbox;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: EditorFeatureCollection) => any;
+} & {
+    moveend: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: EditorFeatureCollection) => any) | undefined;
+    onMoveend?: (() => any) | undefined;
 }>, {
     pointRadius: number;
     l10n: Partial<EditorLocale>;

package/dist/index.d.ts

@@ -9,7 +9,8 @@ export { useMapStyle } from "./composables/useMapStyle";
 export { getFeatureLayers, getFeatureLayerIds, getQueryableLayerIds, getVerticesLayer, reconcileFeatureLayers, getDrawingLayers, } from "./utils/layers";
 export type { GeomType, FeatureSummary } from "./utils/layers";
 export { loadIcon, loadIconsForFeatures, getIconUrl, COMMON_ICONS } from "./utils/icons";
+export { computeBbox } from "./utils/mapView";
 export { DEFAULT_LOCALE } from "./l10n";
 export type { EditorLocale } from "./l10n";
 export { SOURCE_ID, LAYER_IDS, DEFAULTS, MARKER_SIZE_SCALE } from "./constants";
-export type { EditorFeatureCollection, EditorFeature, EditorPolygonFeature, EditorLineStringFeature, EditorPointFeature, EditorMarkerFeature, EditorProperties, BaseProperties, FillStyleProperties, StrokeStyleProperties, MarkerStyleProperties, PointStyleProperties, LabelProperties, Position, ToolMode, EditorProps, ViewerProps, } from "./types";
+export type { EditorFeatureCollection, EditorFeature, EditorPolygonFeature, EditorLineStringFeature, EditorPointFeature, EditorMarkerFeature, EditorProperties, BaseProperties, FillStyleProperties, StrokeStyleProperties, MarkerStyleProperties, PointStyleProperties, LabelProperties, BBox, Position, ToolMode, EditorProps, ViewerProps, } from "./types";