@sametalmdr/word-editor 0.2.0-alpha → 0.3.0-alpha

package/CHANGELOG.md

@@ -1,70 +1,108 @@
-# Değişiklik günlüğü
-
-## 0.2.0-alpha — 2026-10-26 (yayını sahip yapar)
-
-### Eklenenler
-
-- **Çok satırlı değer** ([ADR-0039](./docs/adr/0039-multi-line-values.md)) —
-  `fillTemplate(bytes, data, {expectedTags?, multiline?})` ve
-  `validateTemplate(bytes, {expectedTags, multiline?})`. `multiline`'ın adlandırdığı etikette LF bir
-  satır sonudur: satırlar etiketin kendi run'ında, aralarında `w:br`; run'ın biçimi her satırda.
-  Okuma-geri `w:t` + `w:br` dizisini karşılaştırır. Şablonda olmayan ad `UNKNOWN_MULTILINE_TAG`.
-  Word'de (masaüstü 16) KR09'un iki uzun kutusunda ölçüldü: Calibri 8,5 pt'de 3 ve 2 satır sığıyor,
-  fazlası kırpılıyor.
-
-### Değişenler
-
-- Satır sonu kuralı: tek satırlı etikette LF de, her etikette CR, CRLF, U+2028 ve U+2029 eskisi gibi
-  `VALUE_LINE_BREAK`. Motor değeri normalleştirmez.
-
-### Bilinen sınırlar
-
-- `importDocx` `w:br`'yi okumuyor: çok satırlı bir değer editörde tek satıra birleşir; düzenlenip
-  export edilirse satır sonları kaybolur (FR4).
-- Kutuya sığmayan değer Word'de sessizce kırpılır; sığma denetimi bugün çağıranın işi (FR4).
-
-Paketin dışında (repo içi, `files`'a girmez): şablon tarifleri, bağlama manifesti ve alan kaydı v0
-(`templates/`, ADR-0040/0041) — PeriKont'un KR09 şablonu bunlarla üretilir. Şablonun kendisi
-`templates/kr09/KR09-template.docx`'te commit'li.
-
-## 0.1.0-alpha — 2026-10-17 (yayını sahip yapar)
-
-İlk açık alfa. Editörün kendi yüzeyi (`.`, `./element`, `./react`) değişmedi ve 1.0
-öncesi.
-
-### Eklenenler
-
-- **`/docx` alt yolu** — DOM'suz; Node'da ve Deno'da (ör. Supabase Edge Functions) sınandı,
-  tarayıcı için de yazıldı (Chrome 152'de yalnız incelendi). Hiçbir ağ isteği atmaz.
-  - `fillTemplate(bytes, data, {expectedTags?})` — bir `.docx` şablonunun `{etiket}`lerini
-    doldurur. `{bytes, documentXml, report}` döndürür.
-  - `inspectTemplate(bytes)` — şablondaki etiketler (kutunun `wp:docPr` kimliği ve sayfasıyla),
-    doldurmayı durduracak sorunlar ve uyarılar. Şablon sorununda atmaz.
-  - `validateTemplate(bytes, {expectedTags})` — bağlama listesini tam küme olarak denetler.
-  - `TemplateError` — `problems` dizisi; her sorunun `code`'u sözleşmedir.
-  - `ENGINE_VERSION`.
-  - `importDocx`, `exportDocx` — editörün kendi IO'su; şekilleri alfa boyunca kararsız.
-
-### Doldurma kuralları (ADR-0037, ADR-0038)
-
-- Etiket bir `w:t`'nin metninin tamamıdır: `{firma_adi}`, ad `[a-z][a-z0-9_]*`.
-- Etiketler yalnız metin kutularında (`mc:AlternateContent`). Kutunun iki kopyası
-  (`mc:Choice` ve `mc:Fallback`) birlikte yazılır; önceden yapısal olarak eşit değillerse
-  reddedilir, sonra eşitlikleri yeniden denetlenir.
-- Eksik anahtar doldurmayı durdurur; eksiklerin hepsi tek hatada raporlanır. `null`, `""` ve
-  yalnız boşluktan oluşan değer **boştur**: serbesttir, `report.empty`'de listelenir.
-- Değer string olmalı. Satır sonu, sekme ve XML'in kabul etmediği karakterler reddedilir.
-- Rapor, sorunlar ve hata mesajları hiçbir değeri taşımaz.
-- Yalnız `word/document.xml` yeniden yazılır; başka her parçanın baytları aynen kopyalanır.
-
-### Bilinen sınırlar
-
-- Yalnız ana belge doldurulur. Üst/alt bilgi, dipnot, son not, yorum, grafik ya da
-  `docProps` metnindeki bir parantez hata verir.
-- Döngü (`{#…}`), koşul, görsel (`{%…}`), bölünmüş etiket, gövde paragrafındaki etiket yok.
-- Çok satırlı değer yok (satır sonu reddedilir); politika FR3'te.
-- Sıkıştırılmış `.docx` baytları çalışma ortamına göre değişir; ortamlar arasında
-  karşılaştırmayı `documentXml`'in özetiyle yapın.
-- Gereken platform API'leri: `TextEncoder`/`TextDecoder` ve
-  `CompressionStream`/`DecompressionStream("deflate-raw")` — Node 20.12+ ya da 21.2+, Deno,
-  güncel tarayıcılar. Sınanan: Node 24.13.1, Deno 2.1.4.
+# Değişiklik günlüğü
+
+## 0.3.0-alpha — 2026-10-26 (yayını sahip yapar)
+
+### Eklenenler
+
+- **`checkFit(bytes, data, {expectedTags?, multiline?, capacity?})`** — `/docx`'ten
+  ([ADR-0042](./docs/adr/0042-dom-free-fit-check.md)).
+  - **Ne yapar:** doldurmadan önce her değerin satırını şablonun kendi kutusuyla karşılaştırır. Tarayıcı
+    gerekmez.
+  - **Durumlar:** `fits`, `overflows`, `unknown` ya da `empty`; en dar satırın genişliği, yeri ve payı (pt).
+    `unknown`'ın nedeni kapalı bir listeden gelir.
+  - **Doğrulama:** `fillTemplate`'in reddettiğini aynı `TemplateError` ile reddeder; hiçbir şey yazmaz.
+    Rapor değer taşımaz.
+  - **Çok satırlı değer** `capacity` ister. Bağlama manifesti onu `fit` bloğunda taşır:
+    `checkFit(b, d, {...m.options, ...m.fit})`.
+  - **Word'e karşı:** masaüstü 16'da ön kayıtlı kapıyla sınandı (FR4-WORD-FIT2). 210 satırın hepsi
+    `checkFit`'in dediği gibi dizildi: KR09'un bütün kutuları bandın iki yanında, ayrıca 14 kalibrasyon dalı.
+- **Calibri genişlik tablosu** — `dist/fonts/calibri-metrics.js`.
+  - Carlito 1.104'ten (SIL OFL-1.1, ayrılmış ad "Carlito"); lisans metni yanında
+    (`dist/fonts/OFL-Carlito.txt`).
+  - Yalnız Calibri 6.23 ile eşit olduğu 344 kod noktası, dört kesim. Tabloda olmayan karakter `unknown`
+    (örneğin ₺).
+
+### Değişenler
+
+- Bağlama manifesti (repo içi, `templates/`) `fit: {capacity}` kazandı. `fillTemplate` ve `validateTemplate`
+  `capacity`'yi bilinmeyen seçenek saymayı sürdürür.
+
+### Bilinen sınırlar
+
+- **Yalnız Calibri** (tablo) ve yalnız sınanan kutu ve paragraf biçimleri ölçülür; geri kalanı `unknown`.
+  Başka Calibri yapıları (Mac, Word web) ve `compatibilityMode` 15 doğrulanmadı (ADR-0042 DOĞRULANMALI).
+- **Çok satırlı değerde** taşan bir satırın kaç satır alacağını tarayıcı söyler (FR4b). Kapasitenin
+  sığabileceği durumda sonuç `unknown(WRAPS)`.
+- **Word'de sınanmayan dallar `unknown`:** sondaki boşlukların belirlediği satır (`TRAILING_SPACE`, U+0020
+  dahil), iç boşluklu kutuda ya da sola dayalı olmayan satırda sekme (`TAB_INSET`, `TAB_ALIGNMENT`), şablonda
+  olmayan paragraf stili (`STYLE_MISSING`), `xml:space` korunmayan kenar boşluğu (`WHITESPACE_UNPRESERVED`).
+  KR09'un örneklerinde hiçbiri yok (0 `unknown`).
+
+## 0.2.0-alpha — 2026-10-26 (yayınlandı)
+
+### Eklenenler
+
+- **Çok satırlı değer** ([ADR-0039](./docs/adr/0039-multi-line-values.md)) —
+  `fillTemplate(bytes, data, {expectedTags?, multiline?})` ve
+  `validateTemplate(bytes, {expectedTags, multiline?})`. `multiline`'ın adlandırdığı etikette LF bir
+  satır sonudur: satırlar etiketin kendi run'ında, aralarında `w:br`; run'ın biçimi her satırda.
+  Okuma-geri `w:t` + `w:br` dizisini karşılaştırır. Şablonda olmayan ad `UNKNOWN_MULTILINE_TAG`.
+  Word'de (masaüstü 16) KR09'un iki uzun kutusunda ölçüldü: Calibri 8,5 pt'de 3 ve 2 satır sığıyor,
+  fazlası kırpılıyor.
+
+### Değişenler
+
+- Satır sonu kuralı: tek satırlı etikette LF de, her etikette CR, CRLF, U+2028 ve U+2029 eskisi gibi
+  `VALUE_LINE_BREAK`. Motor değeri normalleştirmez.
+
+### Bilinen sınırlar
+
+- `importDocx` `w:br`'yi okumuyor: çok satırlı bir değer editörde tek satıra birleşir; düzenlenip
+  export edilirse satır sonları kaybolur (FR4).
+- Kutuya sığmayan değer Word'de sessizce kırpılır; sığma denetimi bugün çağıranın işi (FR4).
+
+Paketin dışında (repo içi, `files`'a girmez): şablon tarifleri, bağlama manifesti ve alan kaydı v0
+(`templates/`, ADR-0040/0041) — PeriKont'un KR09 şablonu bunlarla üretilir. Şablonun kendisi
+`templates/kr09/KR09-template.docx`'te commit'li.
+
+## 0.1.0-alpha — 2026-10-17 (yayını sahip yapar)
+
+İlk açık alfa. Editörün kendi yüzeyi (`.`, `./element`, `./react`) değişmedi ve 1.0
+öncesi.
+
+### Eklenenler
+
+- **`/docx` alt yolu** — DOM'suz; Node'da ve Deno'da (ör. Supabase Edge Functions) sınandı,
+  tarayıcı için de yazıldı (Chrome 152'de yalnız incelendi). Hiçbir ağ isteği atmaz.
+  - `fillTemplate(bytes, data, {expectedTags?})` — bir `.docx` şablonunun `{etiket}`lerini
+    doldurur. `{bytes, documentXml, report}` döndürür.
+  - `inspectTemplate(bytes)` — şablondaki etiketler (kutunun `wp:docPr` kimliği ve sayfasıyla),
+    doldurmayı durduracak sorunlar ve uyarılar. Şablon sorununda atmaz.
+  - `validateTemplate(bytes, {expectedTags})` — bağlama listesini tam küme olarak denetler.
+  - `TemplateError` — `problems` dizisi; her sorunun `code`'u sözleşmedir.
+  - `ENGINE_VERSION`.
+  - `importDocx`, `exportDocx` — editörün kendi IO'su; şekilleri alfa boyunca kararsız.
+
+### Doldurma kuralları (ADR-0037, ADR-0038)
+
+- Etiket bir `w:t`'nin metninin tamamıdır: `{firma_adi}`, ad `[a-z][a-z0-9_]*`.
+- Etiketler yalnız metin kutularında (`mc:AlternateContent`). Kutunun iki kopyası
+  (`mc:Choice` ve `mc:Fallback`) birlikte yazılır; önceden yapısal olarak eşit değillerse
+  reddedilir, sonra eşitlikleri yeniden denetlenir.
+- Eksik anahtar doldurmayı durdurur; eksiklerin hepsi tek hatada raporlanır. `null`, `""` ve
+  yalnız boşluktan oluşan değer **boştur**: serbesttir, `report.empty`'de listelenir.
+- Değer string olmalı. Satır sonu, sekme ve XML'in kabul etmediği karakterler reddedilir.
+- Rapor, sorunlar ve hata mesajları hiçbir değeri taşımaz.
+- Yalnız `word/document.xml` yeniden yazılır; başka her parçanın baytları aynen kopyalanır.
+
+### Bilinen sınırlar
+
+- Yalnız ana belge doldurulur. Üst/alt bilgi, dipnot, son not, yorum, grafik ya da
+  `docProps` metnindeki bir parantez hata verir.
+- Döngü (`{#…}`), koşul, görsel (`{%…}`), bölünmüş etiket, gövde paragrafındaki etiket yok.
+- Çok satırlı değer yok (satır sonu reddedilir); politika FR3'te.
+- Sıkıştırılmış `.docx` baytları çalışma ortamına göre değişir; ortamlar arasında
+  karşılaştırmayı `documentXml`'in özetiyle yapın.
+- Gereken platform API'leri: `TextEncoder`/`TextDecoder` ve
+  `CompressionStream`/`DecompressionStream("deflate-raw")` — Node 20.12+ ya da 21.2+, Deno,
+  güncel tarayıcılar. Sınanan: Node 24.13.1, Deno 2.1.4.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Samet Alemdaroğlu
-
-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.
+MIT License
+
+Copyright (c) 2026 Samet Alemdaroğlu
+
+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.