ofs-object 0.1.3 → 0.1.5

package/docs/API.md

@@ -11,14 +11,22 @@
 `OFSDataSource` ทำหน้าที่เป็น **Single Source of Truth** จัดเก็บข้อมูล Layer, Feature และสถานะการเลือก (Selection) ทั้งหมด พร้อมระบบ Event Bus แบบ Reactive
 
 ```typescript
+// Buffer: ผลเป็น polygon เสมอ — ต้นทางเป็น polygon ลงเลเยอร์เดิม, เป็นเส้น/จุดลงเลเยอร์ `<id>_buffer`
+// (สร้างให้ครั้งแรก) · ระบุ targetLayerId ที่ไม่ใช่ polygon → throw · คืน feature ที่เก็บแล้ว (มี id)
+// ofs.dataSource.buffer('canals', 'c1', 10)  →  เลเยอร์ 'canals_buffer'
+
 // การเพิ่ม Layer
 const layer = ofs.dataSource.addLayer({
   id: 'canals',
   name: 'คลองส่งน้ำ',
   type: 'line',
   zIndex: 2,
+  color: '#0ea5e9', // ไม่ใส่ก็ได้ — จะได้สีที่ต่างจากเลเยอร์ที่อยู่บนแผนที่อย่างชัดเจน (สุ่ม)
 });
 
+// สีที่อ่านไม่ออก เช่น 'greenish' → throw OFSError ก่อนเพิ่มเลเยอร์
+// อยากได้สีเดิมทุกครั้ง (เทสต์ / screenshot): new OFSThematicEngine({ random: seededFn })
+
 // เพิ่ม Feature พร้อม Undo Record อัตโนมัติ
 ofs.dataSource.addFeature('canals', lineGeoJsonFeature);
 
@@ -59,6 +67,22 @@ ofs.dataSource.on('layer:updated', ({ layer }) => { ... });
 
 เครื่องมือวาดเรขาคณิตความแม่นยำสูงระดับ CAD มาพร้อมระบบช่วยจับเส้น/จุดอัตโนมัติ และระบบเลือกวัตถุ (Selection System)
 
+**Event `draw:complete`** — สิ่งที่ควรรู้ก่อนผูก handler:
+
+```typescript
+ofs.drawTools.on('draw:complete', ({ mode, feature, layerId }) => {
+  if (mode === 'modify') return;            // ① ยิงตอนจบการแก้ด้วย grips ด้วย — กรองด้วย mode
+  openAttributeForm(layerId, feature.id);   // ② feature คือตัวที่เก็บลง dataSource แล้ว มี id เสมอ
+  ofs.drawTools.setMode('polygon');         // ③ ออกจากโหมดแล้วก่อนยิง event จึงเริ่มวาดต่อในนี้ได้
+});
+```
+
+- ② ก่อน 29 ก.ย. 2026 `feature` เป็น object ก่อนเก็บ **ไม่มี `id`** — ค่าที่ `finishDrawing()`,
+  `drawPointByCoords` / `drawLineByCoords` / `drawPolygonByCoords`, offset แบบ copy และ `dataSource.buffer()`
+  คืนมาก็เป็นแบบนั้น ตอนนี้คืนตัวที่เก็บแล้วทั้งหมด
+- ④ รูปที่วาด**บันทึก undo ไปแล้ว**ตอน event ยิง — ถ้า handler แก้ feature ต่อ (เช่นเติม property) จะเป็น undo อีกขั้น
+  ใช้ `ofs.dataSource.runTransaction()` ครอบถ้าต้องการให้ undo ทีเดียว
+
 ```typescript
 // เปิดโหมดการวาดและเลือกวัตถุ
 ofs.drawTools.setMode('polygon'); // 'point' | 'line' | 'polygon' | 'circle' | 'rectangle' | 'select' | 'select-box' | 'select-polygon' | 'modify'
@@ -323,7 +347,7 @@ ofs.attributes.statistics('plots', 'yield');             // count, min, max, sum
 
 | กลุ่ม | ตัวอย่าง |
 |---|---|
-| ฟิลด์ / ข้อความ | `crop`, `"ชื่อ มีเว้นวรรค"`, `'ข้าว'` |
+| ฟิลด์ / ข้อความ | `crop`, `"ชื่อ มีเว้นวรรค"`, `'ข้าว'` · ในข้อความ: `\n` ขึ้นบรรทัดใหม่, `\t`, `\\`, `\'` หรือ `''` = quote (แบบ QGIS) — backslash หน้าตัวอื่นคงไว้ตามเดิม |
 | ตัวดำเนินการ | `= <> < <= > >= + - * / % ^ \|\|` · `AND OR NOT` · `IN ('ข้าว','อ้อย')` · `LIKE 'A%'` / `ILIKE` · `IS NULL` |
 | ค่าเรขาคณิต | `$area` (ตร.ม.), `$perimeter`, `$length`, `$x`, `$y`, `$id`, `area('rai')`, `perimeter('km')` |
 | หน่วยไทย | `area('rai')`, `area('ngan')`, `area('wa')`, `rai_ngan_wa()` → `"3-2-45.5"` (1 ไร่ = 4 งาน = 400 ตร.วา = 1,600 ตร.ม.) |
@@ -345,7 +369,12 @@ ofs.attributes.statistics('plots', 'yield');             // count, min, max, sum
 // Label จากฟิลด์ หรือจากนิพจน์ (คำนวณให้ก่อนส่งเข้าแผนที่ จึงใช้ $area / rai_ngan_wa() ได้)
 ofs.legendTools.setLabel('plots', { field: 'owner', size: 13, haloColor: '#fff', minZoom: 14 });
 ofs.legendTools.setLabel('plots', { expression: "concat(owner, ' ', rai_ngan_wa())" });
+ofs.legendTools.setLabel('plots', { expression: "\"owner\" || '\\n' || rai_ngan_wa()" }); // 2 บรรทัด
 ofs.legendTools.setLabel('plots', null);         // เอาป้ายออก
+// ฟอนต์: ไม่ระบุ → ใช้ฟอนต์เดียวกับป้ายของ basemap (มีบน glyph server ของ style นั้นแน่นอน เช่น Noto Sans
+// บน OpenFreeMap) · ระบุเองด้วย { font: ['Noto Sans Bold'] } · เปลี่ยน renderer (Single/Categorized/
+// Graduated) แล้ว label ไม่หาย
+// เส้นช่วยขณะวาด: ofs.drawTools.setGuides({ font: ['Noto Sans Regular'] }) มีผลทันที · null = ตาม basemap
 
 // วัดระยะ / พื้นที่ / มุม (ระยะบนพื้นจริง)
 import { measureDistance, measureArea, measureAngle, formatArea } from 'ofs-object';
@@ -414,6 +443,8 @@ await mapAdapter.init('map-div', { maplibregl, center: [100.5, 13.7], zoom: 14 }
 
 // หรือสำหรับ Mapbox GL JS
 const mapAdapter = new MapboxAdapter();
+// เลเยอร์ที่ ≤ 5,000 feature ส่งเฉพาะส่วนที่เปลี่ยน (Mapbox ≥ 3.4) เลเยอร์ใหญ่กว่าส่งทั้งชุด
+// ปรับได้: mapAdapter.dynamicSourceMaxFeatures = 2000   (0 = ส่งทั้งชุดเสมอ)
 await mapAdapter.init('map-div', {
   mapboxgl,
   accessToken: 'YOUR_MAPBOX_TOKEN',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofs-object",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Framework-agnostic TypeScript Library for GIS Map Tools (Data Adapter, Draw Tools, Legend & Thematic Symbology, Map Adapters, Web CLI & AI Bridge)",
   "license": "MIT",
   "author": "On-Farm Solution Co.,Ltd.",