ofs-object 0.1.4 → 0.1.6

package/docs/API.md

@@ -11,6 +11,10 @@
 `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',
@@ -63,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'
@@ -178,6 +198,8 @@ ofs.legendTools.setThematicSimple('parcels', '#0284c7');
 // 2. จำแนกข้อมูลแบบกลุ่มข้อความ (Categorical / Unique Values)
 // เหมาะสำหรับประเภทพืช, พันธุ์ข้าว, ชนิดดิน
 ofs.legendTools.setThematicCategorical('parcels', 'crop', 'category10');
+// ตารางสีตายตัว: เก็บหมวดที่ยังไม่มีข้อมูลไว้ตอน reclassify (สีเดิม, count 0) แทนการลบทิ้ง
+ofs.legendTools.setThematicCategorical('parcels', 'crop', 'category10', { keepEmptyCategories: true });
 
 // 3. จำแนกข้อมูลแบบชั้นปริมาณ (Graduated / Choropleth)
 // เหมาะสำหรับค่า NDVI, ผลผลิต (kg/ไร่), ความชื้น
@@ -327,7 +349,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 ตร.ม.) |
@@ -349,7 +371,15 @@ 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
+// basemap แบบ raster (ดาวเทียม, OSM) ไม่มีป้ายให้อ่านฟอนต์ → กำหนดฟอนต์สำรองที่ glyph server มีจริง:
+//   new OFSObject({ fallbackFont: ['Noto Sans Regular'] })   หรือ   ofs.mapAdapter.setFallbackFont([...])
+// ลำดับ: ฟอนต์ที่ระบุเอง → ฟอนต์ป้ายของ basemap → fallbackFont → ค่า default ของ engine
 
 // วัดระยะ / พื้นที่ / มุม (ระยะบนพื้นจริง)
 import { measureDistance, measureArea, measureAngle, formatArea } from 'ofs-object';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofs-object",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "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.",