@richpods/tiny-geojson-tool 0.2.0 → 0.3.0

package/README.md

@@ -72,6 +72,52 @@ Initial map view priority on load:
 2. Otherwise, bounds are calculated from `modelValue.features`.
 3. If no bounds can be determined (empty map), `center` and `zoom` are used.
 
+## Accessing the MapLibre Instance
+
+Both components expose a `getMap()` method via template ref that returns the underlying MapLibre GL JS `Map` instance (or `null` before the map is initialized). This lets you call MapLibre methods directly — add controls, fly to coordinates, query features, etc.
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+import { GeoJsonEditor } from "@richpods/tiny-geojson-tool";
+import "@richpods/tiny-geojson-tool/styles";
+import type { EditorFeatureCollection } from "@richpods/tiny-geojson-tool";
+
+const editorRef = ref<InstanceType<typeof GeoJsonEditor> | null>(null);
+const geojson = ref<EditorFeatureCollection>({
+    type: "FeatureCollection",
+    features: [],
+});
+
+function flyToVienna() {
+    editorRef.value?.getMap()?.flyTo({ center: [16.37, 48.21], zoom: 12 });
+}
+</script>
+
+<template>
+    <button @click="flyToVienna">Fly to Vienna</button>
+    <GeoJsonEditor
+        ref="editorRef"
+        v-model="geojson"
+        pmtilesUrl="https://example.com/tiles.pmtiles" />
+</template>
+```
+
+The same works for `GeoJsonViewer`:
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+import { GeoJsonViewer } from "@richpods/tiny-geojson-tool";
+
+const viewerRef = ref<InstanceType<typeof GeoJsonViewer> | null>(null);
+</script>
+
+<template>
+    <GeoJsonViewer ref="viewerRef" :modelValue="geojson" pmtilesUrl="https://example.com/tiles.pmtiles" />
+</template>
+```
+
 ## Drawing Tools
 
 The editor toolbar provides six modes:

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

@@ -1,3 +1,4 @@
+import { type Map as MaplibreMap } from "maplibre-gl";
 import type { EditorFeatureCollection, EditorFeature, Position, ToolMode, BboxPadding } from "../types";
 type __VLS_Props = {
     modelValue: EditorFeatureCollection;
@@ -8,7 +9,10 @@ type __VLS_Props = {
     zoom?: number;
     bboxPadding?: BboxPadding;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+declare function getMap(): MaplibreMap | null;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    getMap: typeof getMap;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     "update:modelValue": (value: EditorFeatureCollection) => any;
     featureClick: (feature: EditorFeature | null) => any;
     featureDelete: (id: string) => any;

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

@@ -1,3 +1,4 @@
+import type { Map as MaplibreMap } from "maplibre-gl";
 import type { EditorFeatureCollection, Position, BboxPadding } from "../types";
 import type { EditorLocale } from "../l10n";
 type __VLS_Props = {
@@ -8,11 +9,14 @@ type __VLS_Props = {
     bboxPadding?: BboxPadding;
     l10n?: Partial<EditorLocale>;
 };
+declare function getMap(): MaplibreMap | null;
 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, {
+    getMap: typeof getMap;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: EditorFeatureCollection) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: EditorFeatureCollection) => any) | undefined;

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

@@ -1,3 +1,4 @@
+import { type Map as MaplibreMap } from "maplibre-gl";
 import type { EditorFeatureCollection, Position, BboxPadding } from "../types";
 type __VLS_Props = {
     modelValue?: EditorFeatureCollection;
@@ -6,7 +7,10 @@ type __VLS_Props = {
     zoom?: number;
     bboxPadding?: BboxPadding;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare function getMap(): MaplibreMap | null;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    getMap: typeof getMap;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     modelValue: EditorFeatureCollection;
     bboxPadding: BboxPadding;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;