preview map editor 60%

lib/pathEngine.ts

@@ -8,6 +8,7 @@ const EMPTY_PREVIEW: GeoJSON.FeatureCollection = {
     features: [],
 };
 
+// Khởi tạo engine vẽ path (gấp khúc, sẽ render có mũi tên ở layer path).
 export function initPath(
     map: maplibregl.Map,
     getMode: ModeGetter,
@@ -15,12 +16,14 @@ export function initPath(
 ) {
     let coords: [number, number][] = [];
 
+    // Xóa dữ liệu preview path.
     const clearPreview = () => {
         (map.getSource("draw-path-preview") as maplibregl.GeoJSONSource | undefined)?.setData(
             EMPTY_PREVIEW
         );
     };
 
+    // Cập nhật path preview theo danh sách tọa độ tạm.
     const updatePreview = (lineCoords: [number, number][]) => {
         if (lineCoords.length < 2) {
             clearPreview();
@@ -42,6 +45,7 @@ export function initPath(
         });
     };
 
+    // Chốt path khi đủ số đỉnh tối thiểu.
     const finishPath = () => {
         if (getMode() !== "add-path" || coords.length < 2) return;
 
@@ -55,17 +59,20 @@ export function initPath(
         clearPreview();
     };
 
+    // Hủy phiên vẽ path hiện tại.
     const cancelPath = () => {
         coords = [];
         clearPreview();
     };
 
+    // Xóa đỉnh cuối cùng của path đang vẽ.
     const removeLastVertex = () => {
         if (coords.length === 0) return;
         coords = coords.slice(0, -1);
         updatePreview(coords);
     };
 
+    // Thêm một đỉnh path khi click map.
     const onClick = (e: maplibregl.MapLayerMouseEvent) => {
         if (getMode() !== "add-path") return;
 
@@ -73,6 +80,7 @@ export function initPath(
         updatePreview(coords);
     };
 
+    // Cập nhật preview path động theo vị trí chuột.
     const onMove = (e: maplibregl.MapLayerMouseEvent) => {
         const canvas = map.getCanvas();
 
@@ -92,6 +100,7 @@ export function initPath(
         updatePreview([...coords, [e.lngLat.lng, e.lngLat.lat]]);
     };
 
+    // Xử lý phím nóng Enter/Escape/Backspace cho chế độ vẽ path.
     const onKeyDown = (e: KeyboardEvent) => {
         if (getMode() !== "add-path") return;