preview map editor 60%

lib/lineEngine.ts

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