gta-v-map 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Raul202
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# GTA V MAP LEAFLET 
+GTA V MAP LEAFLET is a MAP  based on LEAFLET.
+
+**[Documentation](https://docs.ricearaul.com/gta-v-map/)**
+
+## Features
+
+* Easy to use
+* Custom Icons
+* 3 Map Style(Atlas,Satellite,Grid)
+
+## Dependencies
+Map Styles
+```
+  https://mega.nz/file/UKo0wI4A#hDZV1RE-KU0rF2BePRjaKQfwWVBvWbsBVAFmM7yWvo8
+```
+Leaflet
+```
+ https://leafletjs.com/
+```
+## Install
+```
+  Extract map styles in source folder
+```
+## How to use
+Create blip
+The coordinates are inverted X will be Y and Y will be X.
+```
+var X  = 0;
+var Y = 0;
+L.marker([Y,X], {icon: customIcon(1)}).addTo(Icons["Example"]).bindPopup("I am here.");
+```
+How use CustomIcon
+The parameter in the customIcon function is the name of the .png picture in the blips folder
+```
+For /blips/1.png we will use customIcon(1)}
+```
+## Screenshots
+| Atlas         |   Grid        |    Satellite    | 
+| ------------- | ------------- | ----------------| 
+| !["Atlas Screenshot"](https://cdn.discordapp.com/attachments/691276350962794496/908677027530407966/unknown.png)  | !["Grid Screebshot"](https://cdn.discordapp.com/attachments/691276350962794496/908677312109764608/unknown.png)  |    !["Satellite Screenshot"](https://cdn.discordapp.com/attachments/691276350962794496/908676688043454495/unknown.png)             | 
+
+Custom blip
+!["Customblip Screnshot"](https://cdn.discordapp.com/attachments/691276350962794496/908677500069109800/unknown.png)
+## License
+
+GTA V MAP LEAFLET is licensed under MIT License.

package/dist/components/gta-v-map.d.ts

@@ -0,0 +1,126 @@
+import { LitElement, type PropertyValues } from 'lit';
+import L from 'leaflet';
+import 'leaflet.markercluster';
+import 'leaflet.heat';
+import type { GtaMarker, GtaMarkerEntry, GtaShape, GtaShapeEntry, MapStyle, LatLngBoundsTuple } from '../types/index.js';
+/**
+ * `<gta-v-map>` -- a Lit web component that renders an interactive GTA V map
+ * using Leaflet with support for markers, shapes, heatmaps, and layer controls.
+ *
+ * @fires map-ready - Emitted once the Leaflet map is initialized.
+ * @fires map-click - Emitted when the map background is clicked.
+ * @fires marker-click - Emitted when a marker is clicked.
+ * @fires marker-placed - Emitted in place-mode when a position is selected.
+ */
+export declare class GtaVMap extends LitElement {
+    static readonly styles: import("lit").CSSResult[];
+    /** URL to the Leaflet CSS stylesheet. Override to use a local copy. */
+    leafletCssUrl: string;
+    private _crs?;
+    /** Custom Leaflet CRS. When unset, the built-in GTA V CRS is used. */
+    get crs(): L.CRS | undefined;
+    set crs(value: L.CRS | undefined);
+    /** Base URL path for tile image folders. */
+    tileBaseUrl: string;
+    /** Override URL template for the satellite tile layer. */
+    satelliteUrl?: string;
+    /** Override URL template for the atlas tile layer. */
+    atlasUrl?: string;
+    /** Override URL template for the grid tile layer. */
+    gridUrl?: string;
+    /** Active map style (satellite, atlas, or grid). */
+    defaultStyle: MapStyle;
+    /** Current zoom level. */
+    zoom: number;
+    /** Minimum allowed zoom level. */
+    minZoom: number;
+    /** Maximum allowed zoom level. */
+    maxZoom: number;
+    /** Optional bounding box that restricts panning. Set to null to disable. */
+    maxBounds: LatLngBoundsTuple | null;
+    /** How strongly the map snaps back when dragged beyond max bounds (0..1). */
+    maxBoundsViscosity: number;
+    /** Base URL path for blip icon sprites (e.g. `blips/1.png`). */
+    blipsUrl: string;
+    /** When true, displays a Leaflet layer control for toggling base layers and overlays. */
+    showLayerControl: boolean;
+    /** When true, markers are added to plain layer groups instead of MarkerClusterGroups. */
+    disableClustering: boolean;
+    /** When true, clicking the map emits a `marker-placed` event with the clicked coordinates. */
+    placeMode: boolean;
+    /** Declarative list of markers. Changes trigger a full re-sync. */
+    markers: GtaMarker[];
+    /** Declarative list of shapes. Changes trigger a full re-sync. */
+    shapes: GtaShape[];
+    /** When true, renders a heatmap layer derived from all marker positions. */
+    showHeatmap: boolean;
+    private _map?;
+    private readonly _markerEntries;
+    private readonly _shapeEntries;
+    private readonly _overlayGroups;
+    private _tileLayers;
+    private _layerControl?;
+    private _heatLayer?;
+    /**
+     * Adds or updates a marker on the map.
+     * @param marker - Marker definition to add or update.
+     * @returns The marker's unique id.
+     */
+    addMarker(marker: GtaMarker): string;
+    /**
+     * Removes a marker by id.
+     * @param id - The marker's unique id.
+     * @returns `true` if the marker was found and removed.
+     */
+    removeMarker(id: string): boolean;
+    /** Returns a snapshot of all marker entries (without internal Leaflet references). */
+    getMarkers(): ReadonlyArray<Omit<GtaMarkerEntry, '_leaflet'>>;
+    /** Removes all markers from the map. */
+    clearMarkers(): void;
+    /**
+     * Adds or updates a shape on the map.
+     * @param shape - Shape definition to add or update.
+     * @returns The shape's unique id.
+     */
+    addShape(shape: GtaShape): string;
+    private _removeShapeFromGroup;
+    /**
+     * Removes a shape by id.
+     * @param id - The shape's unique id.
+     * @returns `true` if the shape was found and removed.
+     */
+    removeShape(id: string): boolean;
+    /** Returns a snapshot of all shape entries (without internal Leaflet references). */
+    getShapes(): ReadonlyArray<Omit<GtaShapeEntry, '_leaflet' | '_labelMarker'>>;
+    /** Removes all shapes from the map. */
+    clearShapes(): void;
+    render(): import("lit-html").TemplateResult<1>;
+    private _onCssLoad;
+    firstUpdated(): void;
+    private _initMap;
+    updated(changed: PropertyValues): void;
+    private _bindMapEvents;
+    private _getOrCreateOverlayGroup;
+    private _resolveTileUrl;
+    private _buildTileLayers;
+    private _switchTileLayer;
+    private _addLayerControl;
+    private _rebuildLayerControl;
+    private _toggleLayerControl;
+    private _createIcon;
+    private _addLeafletMarker;
+    private _syncMarkers;
+    private _addLeafletShape;
+    private _syncShapes;
+    private _getHeatmapData;
+    private _enableHeatmap;
+    private _disableHeatmap;
+    private _updateHeatmap;
+    private _dispatch;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'gta-v-map': GtaVMap;
+    }
+}
+//# sourceMappingURL=gta-v-map.d.ts.map

package/dist/components/gta-v-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gta-v-map.d.ts","sourceRoot":"","sources":["../../src/components/gta-v-map.ts"],"names":[],"mappings":"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"}

package/dist/components/gta-v-map.styles.d.ts

@@ -0,0 +1,3 @@
+/** Scoped styles for the `<gta-v-map>` web component. */
+export declare const gtaVMapStyles: import("lit").CSSResult;
+//# sourceMappingURL=gta-v-map.styles.d.ts.map

package/dist/components/gta-v-map.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gta-v-map.styles.d.ts","sourceRoot":"","sources":["../../src/components/gta-v-map.styles.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,eAAO,MAAM,aAAa,yBAoBzB,CAAC"}

package/dist/components/index.d.ts

@@ -0,0 +1,2 @@
+export { GtaVMap } from './gta-v-map.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/constants/crs.constants.d.ts

@@ -0,0 +1,9 @@
+/** Transformation parameters for converting GTA V game coordinates to Leaflet CRS. */
+export declare const GTA_CRS_CONFIG: {
+    readonly centerX: 117.3;
+    readonly centerY: 172.8;
+    readonly scaleX: 0.02072;
+    readonly scaleY: 0.0205;
+    readonly ln2: number;
+};
+//# sourceMappingURL=crs.constants.d.ts.map

package/dist/constants/crs.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs.constants.d.ts","sourceRoot":"","sources":["../../src/constants/crs.constants.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC"}

package/dist/constants/index.d.ts

@@ -0,0 +1,5 @@
+export { WATER_COLOR, WATER_TILE_DATA_URI } from './water.constants.js';
+export { TILE_CONFIGS, STYLE_LABELS, MAP_STYLES } from './tile.constants.js';
+export { GTA_CRS_CONFIG } from './crs.constants.js';
+export { DEFAULT_MAP_CONFIG } from './map.constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/constants/map.constants.d.ts

@@ -0,0 +1,14 @@
+import type { MapStyle, LatLngBoundsTuple } from '../types/index.js';
+/** Default configuration values for the map component. */
+export declare const DEFAULT_MAP_CONFIG: {
+    readonly zoom: 3;
+    readonly minZoom: 1;
+    readonly maxZoom: 5;
+    readonly center: [number, number];
+    readonly maxBounds: LatLngBoundsTuple;
+    readonly maxBoundsViscosity: 1;
+    readonly tileBaseUrl: "mapStyles";
+    readonly blipsUrl: "blips";
+    readonly defaultStyle: MapStyle;
+};
+//# sourceMappingURL=map.constants.d.ts.map

package/dist/constants/map.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.constants.d.ts","sourceRoot":"","sources":["../../src/constants/map.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErE,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB;;;;qBAIX,CAAC,MAAM,EAAE,MAAM,CAAC;wBACW,iBAAiB;;;;2BAIjC,QAAQ;CAC7B,CAAC"}

package/dist/constants/tile.constants.d.ts

@@ -0,0 +1,8 @@
+import type { MapStyle, TileConfig } from '../types/index.js';
+/** Zoom range, file extension, and folder name for each map style. */
+export declare const TILE_CONFIGS: Record<MapStyle, Omit<TileConfig, 'url'>>;
+/** Human-readable labels shown in the layer control for each style. */
+export declare const STYLE_LABELS: Record<MapStyle, string>;
+/** Ordered list of all available map styles. */
+export declare const MAP_STYLES: readonly MapStyle[];
+//# sourceMappingURL=tile.constants.d.ts.map

package/dist/constants/tile.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.constants.d.ts","sourceRoot":"","sources":["../../src/constants/tile.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9D,sEAAsE;AACtE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAIzD,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAIxC,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAA4C,CAAC"}

package/dist/constants/water.constants.d.ts

@@ -0,0 +1,5 @@
+/** CSS color used for the ocean / map background. */
+export declare const WATER_COLOR: "#1a3a4a";
+/** 1x1 ocean-colored PNG as data URI for missing/error tiles */
+export declare const WATER_TILE_DATA_URI = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGOQsvICAAEQAJ+lYp46AAAAAElFTkSuQmCC";
+//# sourceMappingURL=water.constants.d.ts.map

package/dist/constants/water.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"water.constants.d.ts","sourceRoot":"","sources":["../../src/constants/water.constants.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,eAAO,MAAM,WAAW,EAAG,SAAkB,CAAC;AAE9C,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,uHACsF,CAAC"}