@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.8

package/dist/knowledge/componentEvents.js

@@ -6,10 +6,17 @@ export const componentEventContracts = {
         pagination: { payload: { offset: 'number', limit: 'number' } },
         filter: { payload: { filters: 'Array<{ field, operator, value, filterType, conditionType }>', offset: 'number' } },
         sort: { payload: { sortField: 'string (kolonun name alanı)', sortType: "'asc' | 'desc' | '' (temizlendi)", offset: 'number' } },
-        select: { payload: {}, reads: 'self.selectedRow' },
-        selectionChange: { payload: {}, reads: 'self.selectedRows (dizi) + self.selectedRow' },
+        search: {
+            payload: {
+                searchText: 'string (kutuya yazılan metin, KIRPILMAZ; kutu temizlenince "")',
+                offset: 'number (0’a döner)'
+            },
+            reads: 'isSearchable:true iken araç çubuğundaki kutudan: yazmaya ara verince (400 ms), Enter’da ve kutu boşaltılınca hemen yayılır; aynı metin ikinci kez yayılmaz (Enter dahil). Enter formu göndermez. Tablo satırları kendisi SÜZMEZ — akış self.searchText ile sorguyu yeniden çalıştırıp rows’u yazar'
+        },
+        select: { payload: {}, reads: 'self.selectedRow — satır tıklaması rowSelection:none dahil HER kipte yazar ve bu olayı çalıştırır; isReadonly:true iken hiç çalışmaz' },
+        selectionChange: { payload: {}, reads: 'self.selectedRows (dizi) + self.selectedRow — yalnız multi kipindeki onay kutularından (satır tıklaması tetiklemez)' },
         doubleClick: { payload: {}, reads: 'self.selectedRow' },
-        rowChange: { payload: {}, reads: 'self.rows (düzenlenen satır yerinde güncellenir)' }
+        rowChange: { payload: {}, reads: 'self.selectedRow (düzenlenen satır, YENİ değeriyle) — satır nesnesi self.rows içinde de yerinde güncellenir; değer gerçekten değişmediyse olay çalışmaz' }
     },
     datatable: {
         mount: { payload: {}, reads: 'self.filters · self.sortField · self.sortType · self.offset · self.limit' }
@@ -32,8 +39,23 @@ export const componentEventContracts = {
     },
     phoneinput: {
         mount: NO_DATA,
-        change: { payload: { value: 'string (E.164, ör. +905321234567)' }, reads: "setter: self.value da yazılır. DEĞER DEĞİŞMEDİYSE YAYILMAZ — hane sınırına çarpan tuşlar ve süzülen harfler akış tetiklemez (PhoneInput.svelte:66)" },
-        blur: { payload: { value: 'string (E.164)' }, reads: 'change’in aksine her odak kaybında yayılır, değer aynı olsa bile; setter DEĞİLDİR' }
+        change: {
+            payload: {
+                value: 'string (E.164, ör. +905321234567)',
+                formattedValue: 'string (kullanıcının gördüğü satır: "+90 532 123 45 67"; boş alanda "")',
+                isValid: 'boolean (numara seçili ülke için TAM mı — boş alan false; zorunluluk kararı validations.required’ın işi)'
+            },
+            reads: "self’e yazılan tek anahtar `value`dur; `formattedValue` ve `isValid` düğüme YAZILMAZ, yalnız event.data’dadır (params). DEĞER DEĞİŞMEDİYSE YAYILMAZ — hane sınırına çarpan tuşlar ve süzülen harfler akış tetiklemez"
+        },
+        enter: {
+            payload: { value: 'string (E.164)', formattedValue: 'string', isValid: 'boolean' },
+            reads: 'Enter tuşu; change ile aynı yük. self.value’yu bu da yazar (platform emisyonun data’sını koşulsuz yazıyor, ARC-067) ama değer zaten change’in yazdığıdır — "gönder" kancası olarak kullan'
+        },
+        focus: NO_DATA,
+        blur: {
+            payload: { value: 'string (E.164)', formattedValue: 'string', isValid: 'boolean' },
+            reads: 'focus/blur SATIR düzeyindedir: numara alanı ile ülke seçicisi arasında gezinmek olay yaymaz, yalnız alanın tamamına girip çıkmak yayar. blur change’in aksine değer aynı olsa da yayılır ve yayılmış bir focus’un karşılığı alan sonradan donsa bile gelir; yükü self.value’yu yine yazar (ARC-067)'
+        }
     },
     filterbuilder: {
         mount: NO_DATA,
@@ -62,24 +84,81 @@ export const componentEventContracts = {
     },
     'layout-region': { mount: NO_DATA },
     navigations: { mount: NO_DATA },
-    textinput: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    textarea: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    password: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    // `change` ve `changed` AYNI anda yayılır (NumberInput.svelte:199-200) ve ikisi de setter'dır;
-    // `changed` eski akışlarla uyum için duruyor — yeni akışı `change`'e bağla, ikisine birden değil.
-    numberinput: { mount: NO_DATA, change: valueChange('number'), changed: valueChange('number'), blur: NO_DATA },
+    // `change` her tuşta (input), `changed` değer kesinleşince (native change: blur/Enter) yayılır;
+    // ikisi de setter'dır — pahalı akışı (sorgu, kayıt) `changed`'e bağla.
+    textinput: {
+        mount: NO_DATA,
+        change: valueChange('string'),
+        changed: valueChange('string (blur/Enter ile kesinleşen değer)'),
+        enter: { payload: { value: 'string (Enter anındaki değer)' }, reads: "form içindeyse Enter formun submit akışını da çalıştırır — kaydı forma bağla, enter'a değil" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    textarea: { mount: NO_DATA, change: valueChange('string'), changed: valueChange('string (blur ile kesinleşen değer)'), focus: NO_DATA, blur: NO_DATA },
+    password: {
+        mount: NO_DATA,
+        change: valueChange('string'),
+        changed: valueChange('string (blur/Enter ile kesinleşen değer)'),
+        enter: { payload: { value: 'string (Enter anındaki değer)' }, reads: "form içindeyse Enter formun submit akışını da çalıştırır — girişi forma bağla, enter'a değil" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    // `change` her tuşta ve artı/eksi düğmesinde, `changed` değer kesinleşince (blur/Enter, düğme)
+    // yayılır; ikisi de setter'dır — pahalı akışı `changed`'e bağla. Boşaltılan alan 0 yayar (K-3).
+    numberinput: {
+        mount: NO_DATA,
+        change: valueChange('number (aralığa kırpılmış)'),
+        changed: valueChange('number (blur/Enter/artı-eksi ile kesinleşen değer)'),
+        enter: { payload: { value: 'number (Enter anında kesinleşen, kırpılmış değer)' }, reads: "form içindeyse Enter formun submit akışını da çalıştırır — kaydı forma bağla, enter'a değil" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     incrementalinput: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    texteditor: { onMount: NO_DATA, onChange: valueChange('string (HTML)') },
-    checkbox: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
-    switch: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
+    // Adlar 2026-09-11'de `on` önekinden kurtuldu: şema onMount/onChange diyordu, runtime
+    // mount/change yayıyordu ve flow-machine eşleşmeyi ADLA yaptığı için bu bileşene bağlanan
+    // hiçbir akış çalışmıyordu.
+    texteditor: {
+        mount: NO_DATA,
+        change: { payload: { value: "string (HTML; boş editörde boş metin)" }, reads: "setter: self.value da yazılır. HER TUŞTA yayılır — pahalı akışı changed'e bağla" },
+        changed: { payload: { value: "string (HTML; boş editörde boş metin)" }, reads: "setter: self.value da yazılır; yalnız odak çıkışında ve değer gerçekten değiştiyse yayılır" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    checkbox: {
+        mount: NO_DATA,
+        change: { payload: { value: 'boolean' }, reads: "setter: self.value da yazılır. Her tıkta İKİ olay yayılır — change ve (yeni duruma göre) checked ya da unchecked; ikisini birden bağlarsan akış iki kez koşar" },
+        checked: { payload: { value: 'boolean (true)' }, reads: 'setter: self.value da yazılır; change ile AYNI tıkta yayılır' },
+        unchecked: { payload: { value: 'boolean (false)' }, reads: 'setter: self.value da yazılır; change ile AYNI tıkta yayılır' },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    switch: {
+        mount: NO_DATA,
+        change: { payload: { value: 'boolean' }, reads: "setter: self.value da yazılır. Her flip'te İKİ olay yayılır — change ve (yeni duruma göre) checked ya da unchecked; ikisini birden bağlarsan akış iki kez koşar" },
+        checked: { payload: { value: 'boolean (true)' }, reads: 'setter: self.value da yazılır; change ile AYNI flip’te yayılır' },
+        unchecked: { payload: { value: 'boolean (false)' }, reads: 'setter: self.value da yazılır; change ile AYNI flip’te yayılır' },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     radio: { change: valueChange('string') },
-    dropdown: { mount: NO_DATA, change: valueChange('seçilen option değeri'), search: { payload: { searchText: 'string' } }, focus: NO_DATA },
-    'multi-select': { mount: NO_DATA, change: valueChange('değer dizisi'), search: { payload: { searchText: 'string' } }, focus: NO_DATA },
-    'tag-input': { mount: NO_DATA, change: valueChange('etiket dizisi'), focus: NO_DATA },
+    dropdown: { mount: NO_DATA, change: { payload: { value: 'seçilen option değeri', selectedLabel: "seçilen option'ın label metni (temizlemede '')" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
+    'multi-select': { mount: NO_DATA, change: { payload: { value: "seçilen değerlerin dizisi: [{ value, label, id, text }] — id/text, value/label'ın eski adlı ikizleridir" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
+    'tag-input': { mount: NO_DATA, change: { payload: { value: 'etiket dizisi: [{ value, color? }] — renk verilmemiş etikette color anahtarı HİÇ bulunmaz' } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
     datepicker: { mount: NO_DATA, change: { payload: { value: 'string (tarih)', HH: 'string', mm: 'string' } } },
     datetimepicker: { mount: NO_DATA, change: { payload: {}, reads: 'self.value' } },
     daterangepicker: { mount: NO_DATA, change: { payload: { valueFrom: 'string', valueTo: 'string', HH: 'string', mm: 'string' } } },
-    datetimerangepicker: { mount: NO_DATA, change: { payload: { valueFrom: 'string', valueTo: 'string', HH: 'string', mm: 'string' } } },
+    datetimerangepicker: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                valueFrom: "string 'yyyy-MM-ddTHH:mm:ss' | null (yerel duvar saati, dilim eki yok; yarı boşaltılınca null)",
+                valueTo: "string 'yyyy-MM-ddTHH:mm:ss' | null"
+            },
+            reads: "ikisi de düğümün prop'una yazılır: self.valueFrom / self.valueTo. Bir yarı yalnız tarih+saat ikisi de seçilince yayar. HH/mm anahtarları YOKTUR (2026-09-12'de kayıttan çıkarıldı — runtime hiç göndermiyordu)."
+        },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     fileUpload: { change: { payload: {}, reads: 'self.value' } },
     fileInput: { change: { payload: { value: 'Array<{ type, value }>', fileName: 'string' } } },
     filebutton: { change: { payload: { value: 'Array<{ type, value }>', fileName: 'string' } } },
@@ -118,9 +197,18 @@ export const componentEventContracts = {
     // 2026-08-25c, `docs/20-komponent-bilgi-katmani.md` §9).
     autocomplete: {
         mount: NO_DATA,
-        change: valueChange('string (YAZILAN metin — option değeri değil)'),
-        select: { payload: { value: "seçilen option'ın değeri", label: "seçilen option'ın etiketi" }, reads: 'self.value etiketi taşır; id gerekiyorsa bu olaydaki value' },
-        search: { payload: { searchText: 'string' } },
+        change: {
+            payload: { value: 'string (YAZILAN metin — option değeri değil)' },
+            reads: "setter: self.value da yazılır. Temizleme (×) ve strict geri alma aynı olayı { value: '', selectedValue: '', selectedLabel: '' } ile yayar — alan boşalınca seçim durumu da boşalır"
+        },
+        select: {
+            payload: {
+                selectedValue: "seçilen option'ın değeri",
+                selectedLabel: "seçilen option'ın etiketi"
+            },
+            reads: "self.value etiketi taşır; option'ın değeri için self.selectedValue (2026-09-11'e kadar yükün adları value/label idi ve alanın kendi prop'larını eziyordu)"
+        },
+        search: { payload: { searchText: 'string' }, reads: 'self.searchText' },
         enter: { payload: { value: 'string (Enter anındaki metin; vurgulu öneri yokken)' } },
         focus: NO_DATA,
         blur: NO_DATA
@@ -191,13 +279,20 @@ export const componentEventContracts = {
         blur: NO_DATA
     },
     statcard: { mount: NO_DATA, click: NO_DATA, footerClick: { payload: {}, reads: "footerFlow zaten doğrudan çalışır; footerHref varsa tıklama ona gider" } },
-    switcher: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
+    switcher: {
+        mount: NO_DATA,
+        change: { payload: { value: 'boolean' }, reads: "setter: self.value da yazılır. Her geçişte İKİ olay yayılır — change ve (yeni duruma göre) checked ya da unchecked; ikisini birden bağlarsan akış iki kez koşar" },
+        checked: { payload: { value: 'boolean (true)' }, reads: 'setter: self.value da yazılır; change ile AYNI geçişte yayılır' },
+        unchecked: { payload: { value: 'boolean (false)' }, reads: 'setter: self.value da yazılır; change ile AYNI geçişte yayılır' },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     timeline: {
         mount: NO_DATA,
         clickItem: { payload: { currentItem: 'tıklanan olay öğesi', index: 'number' }, reads: "öğenin kendi flow'u da doğrudan çalışır" },
         showMore: NO_DATA
     },
-    timepicker: { mount: NO_DATA, change: valueChange("string 'HH:mm' (temizlenince '')"), focus: NO_DATA, blur: NO_DATA },
+    timepicker: { mount: NO_DATA, change: { payload: { value: "string 'HH:mm' (temizlenince '')", selectedLabel: "seçilen saatin gösterilen metni — 12h kipinde '01:00 PM' (temizlenince '')" } }, focus: NO_DATA, blur: NO_DATA },
     toast: {
         open: NO_DATA,
         close: NO_DATA,
@@ -270,9 +365,9 @@ export const componentEventContracts = {
         mount: NO_DATA,
         change: {
             payload: { value: "string (PNG data-URL ya da HAM SVG işaretlemesi; temizlemede '')" },
-            reads: 'setter: self.value da güncellenir, event.data.value da dolu gelir; her tamamlanan çizgide bir kez yayılır'
+            reads: "setter: self.value da güncellenir, event.data.value da dolu gelir; her tamamlanan çizgide bir kez yayılır. Ayrıca outputFormat/penColor/penWidth değişince mevcut vuruşlar yeniden dışa aktarılır ve change bir kez daha yayılır. Akış value'yu setter ile yazdığında ped sıfırlanır ama change YAYILMAZ — kendi yazdığın değer geri gelmez"
         },
-        clear: { payload: {}, reads: "temizlemede önce change('') yayılır, sonra clear — değeri change'ten oku" }
+        clear: { payload: {}, reads: "yalnız kullanıcı Clear düğmesine bastığında yayılır; önce change('') gelir, sonra clear — değeri change'ten oku. Akıştan value'yu '' yapmak pedi temizler ama hiçbir olay yaymaz" }
     },
     stepper: {
         mount: NO_DATA,

package/dist/knowledge/functionGuards.js

@@ -0,0 +1,134 @@
+export const FUNCTIONS_NAMESPACE = 'Functions';
+const NAME_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/** JavaScript ayrılmış sözcükleri — `GlobalFunctionRules.ReservedWordNames` ile aynı liste. */
+export const RESERVED_WORDS = new Set([
+    'await', 'break', 'case', 'catch', 'class', 'const', 'continue', 'debugger', 'default', 'delete',
+    'do', 'else', 'enum', 'export', 'extends', 'false', 'finally', 'for', 'function', 'if',
+    'implements', 'import', 'in', 'instanceof', 'interface', 'let', 'new', 'null', 'package', 'private',
+    'protected', 'public', 'return', 'static', 'super', 'switch', 'this', 'throw', 'true', 'try',
+    'typeof', 'var', 'void', 'while', 'with', 'yield'
+]);
+/**
+ * Workflow motorunun global adları — `GlobalFunctionRules.WorkflowReservedNames` ile birebir.
+ * `source:'workflow'` fonksiyonu bu adı alırsa motorun kendi nesnesini ezerdi (platform 422).
+ */
+export const WORKFLOW_RESERVED_NAMES = new Set([
+    'Authorized', 'body', 'convert', 'ConvertToCsv', 'ConvertToPdf', 'cookie', 'crypto', 'DecodeQr', 'DeepEqual', 'error', 'file',
+    'GenerateAccessToken', 'GenerateGuid', 'GenerateJwt', 'GeneratePKCE', 'Hash', 'header', 'input', 'log', 'Log', 'Now',
+    'queryString', 'request', 'RequestPathAndQuery', 'RequestUrl', 'route', 'system', 'Today', 'ToTimeZone', 'UtcNow', 'ValidateAccessToken'
+]);
+export function sourceOf(definition) {
+    return definition.source === 'workflow' ? 'workflow' : 'studio';
+}
+export function isValidParameterName(name) {
+    return typeof name === 'string' && NAME_PATTERN.test(name) && !RESERVED_WORDS.has(name);
+}
+export function isValidFunctionName(name, source = 'studio') {
+    return isValidParameterName(name) && (source === 'workflow' ? !WORKFLOW_RESERVED_NAMES.has(name) : name !== FUNCTIONS_NAMESPACE);
+}
+/** Geçersiz adın NEDENİ — mesaj kullanıcıya hangi kuralı bozduğunu söylesin diye. */
+export function nameProblem(name, source = 'studio') {
+    if (typeof name !== 'string' || name.trim() === '')
+        return 'boş';
+    if (!NAME_PATTERN.test(name))
+        return `JS tanımlayıcısı değil (${NAME_PATTERN.source})`;
+    if (RESERVED_WORDS.has(name))
+        return 'JavaScript ayrılmış sözcüğü';
+    if (source === 'workflow' && WORKFLOW_RESERVED_NAMES.has(name))
+        return `workflow motorunun global adı ('${name}' — system, input, Now… ezilemez)`;
+    if (source === 'studio' && name === FUNCTIONS_NAMESPACE)
+        return `'${FUNCTIONS_NAMESPACE}' ad alanının kendisi (ayrılmış ad, K1)`;
+    return undefined;
+}
+/** Çağrı biçimi: studio `Functions.<ad>`, workflow çıplak `<ad>`. */
+export function callPrefix(source) {
+    return source === 'workflow' ? '' : `${FUNCTIONS_NAMESPACE}.`;
+}
+/**
+ * Studio'nun canlı imza önizlemesiyle aynı biçim: `Functions.toplamHesapla(fiyat, adet = 1)`;
+ * workflow kaynağında öneksiz `toplamHesapla(fiyat, adet = 1)`. Varsayılanı olmayan ve zorunlu
+ * olmayan parametre `ad?` yazılır.
+ */
+export function functionSignature(definition) {
+    const parameters = Array.isArray(definition.parameters) ? definition.parameters : [];
+    const rendered = parameters
+        .filter(parameter => parameter && typeof parameter === 'object')
+        .map(parameter => {
+        const name = String(parameter.name ?? '?');
+        if (parameter.defaultValue !== undefined && parameter.defaultValue !== null)
+            return `${name} = ${JSON.stringify(parameter.defaultValue)}`;
+        return parameter.required === true ? name : `${name}?`;
+    });
+    return `${callPrefix(sourceOf(definition))}${String(definition.name ?? '?')}(${rendered.join(', ')})`;
+}
+const CALL_PATTERN = /\bFunctions\s*\.\s*([A-Za-z_$][\w$]*)\s*\(/g;
+/**
+ * Bir ifadedeki `Functions.<ad>(` çağrılarını ve KABA argüman sayısını döner. Sayım parantez
+ * dengesiyle üst düzey virgülleri sayar; string/şablon ve iç içe çağrı içindeki virgül
+ * sayılmaz. Yine de yaklaşıktır — çağıran yalnız FAZLA argümanda uyarır, eksik argümanı
+ * `required` kuralına bırakır (K5: eşleme konumsaldır, `undefined` → varsayılan).
+ */
+export function functionCallRefs(expression) {
+    const refs = [];
+    let match;
+    CALL_PATTERN.lastIndex = 0;
+    while ((match = CALL_PATTERN.exec(expression)) !== null) {
+        refs.push({ name: match[1] ?? '', argCount: countArguments(expression, match.index + match[0].length), index: match.index });
+    }
+    return refs.filter(ref => ref.name !== '');
+}
+function countArguments(source, start) {
+    let depth = 0;
+    let commas = 0;
+    let quote;
+    let sawToken = false;
+    for (let index = start; index < source.length; index++) {
+        const char = source[index];
+        if (quote !== undefined) {
+            if (char === '\\') {
+                index++;
+                continue;
+            }
+            if (char === quote)
+                quote = undefined;
+            continue;
+        }
+        if (char === '\'' || char === '"' || char === '`') {
+            quote = char;
+            sawToken = true;
+            continue;
+        }
+        if (char === '(' || char === '[' || char === '{') {
+            depth++;
+            sawToken = true;
+            continue;
+        }
+        if (char === ')' || char === ']' || char === '}') {
+            if (depth === 0)
+                return sawToken ? commas + 1 : 0;
+            depth--;
+            continue;
+        }
+        if (char === ',' && depth === 0) {
+            commas++;
+            continue;
+        }
+        if (!/\s/.test(char))
+            sawToken = true;
+    }
+    return sawToken ? commas + 1 : 0;
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Çıplak `<ad>(` çağrısı — backend `GlobalFunction.IsCalledIn`'in workflow kalıbıyla aynı sınırlar. */
+export function callsBareName(name, expression) {
+    return name !== '' && new RegExp(`(?<![A-Za-z0-9_$.])${escapeRegex(name)}\\s*\\(`).test(expression);
+}
+/** Gövde kendi adını çağırıyor mu — studio `Functions.<ad>(`, workflow çıplak `<ad>(` (özyineleme, FN-003). */
+export function callsItself(name, body, source = 'studio') {
+    return source === 'workflow' ? callsBareName(name, body) : functionCallRefs(body).some(ref => ref.name === name);
+}
+export function mentionsAwait(body) {
+    return /\bawait\b/.test(body);
+}