@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.45

package/dist/knowledge/connectDataBind.js

@@ -291,7 +291,7 @@ function unsortableReason(kind) {
  * Girdi + kabiliyet + bağlanabilir prop kaydından tanım. Block bulgusu varsa tanım yine döner
  * (dryRun'da görülsün) ama çağıran yazmaz.
  */
-export function buildDefinition(input, describe, connectable, connectablePaths = [], itemProps = []) {
+export function buildDefinition(input, describe, connectable, connectablePaths = [], itemProps = [], platform = 'web') {
     const findings = [];
     const block = (ruleId, message) => { findings.push({ ruleId, severity: 'block', message }); };
     const warn = (ruleId, message) => { findings.push({ ruleId, severity: 'warn', message }); };
@@ -401,9 +401,18 @@ export function buildDefinition(input, describe, connectable, connectablePaths =
             block('CD-002', `'${slug}' aranamaz: arama yalnız korumasız, içerir (icontains) işleci olan metin alanında çalışır — platform bu alanı aramada YOK SAYAR (geçerli hiç alan kalmazsa 422 ConnectDataFilterNotAllowed). Aranabilir bir metin alanı seçin.`);
         }
     }
-    const rootLookup = input.lookup !== undefined
+    const givenLookup = input.lookup !== undefined
         ? input.lookup
         : connectable?.lookup && input.source.kind === 'entity' ? { fields: [], mode: 'modal' } : null;
+    const isMobile = platform === 'mobile';
+    // Telefon satırının varsayılan başlığı: lookup label alanını gösteriyorsa (ya da alanlar türetiliyorsa) o, yoksa ilk alan
+    // (screen-builder `defaultMobileRow` aynası).
+    const lookupSlugs = (givenLookup?.fields ?? []).map(item => item.slug).filter(slug => slug?.trim());
+    const rowTitle = roles.label && (lookupSlugs.length === 0 || lookupSlugs.includes(roles.label)) ? roles.label : lookupSlugs[0];
+    const rootLookup = givenLookup && isMobile
+        ? { ...givenLookup, mobileMode: givenLookup.mobileMode ?? 'sheet', ...(givenLookup.mobileRow || !rowTitle ? {} : { mobileRow: { title: rowTitle } }) }
+        : givenLookup;
+    const mobile = input.mobile !== undefined ? input.mobile : isMobile && (isListComponent || rootLookup) ? { infiniteScroll: true } : undefined;
     const definition = {
         version: 1,
         source: { kind: input.source.kind, id: input.source.id, ...(input.source.slug ?? describe.source?.slug ? { slug: input.source.slug ?? describe.source?.slug } : {}) },
@@ -423,11 +432,27 @@ export function buildDefinition(input, describe, connectable, connectablePaths =
                 defaults: input.edit?.defaults ?? {},
                 writeMode: input.edit?.writeMode ?? 'atomic'
             },
-            refresh: { afterWrite: input.refresh?.afterWrite ?? 'reload', poll: input.refresh?.poll ?? null }
+            refresh: { afterWrite: input.refresh?.afterWrite ?? 'reload', poll: input.refresh?.poll ?? null },
+            ...(mobile ? { mobile } : {}),
+            ...(input.mobileCard ? { mobileCard: input.mobileCard } : {})
         },
         ...(input.params && Object.keys(input.params).length > 0 ? { params: input.params } : {}),
-        ...(rootLookup ? { lookup: rootLookup } : {})
+        ...(rootLookup ? { lookup: rootLookup } : {}),
+        ...(input.grouping ? { grouping: input.grouping } : {})
     };
+    const groups = (connectable?.wizardSteps ?? []).includes('grouping');
+    if (groups && !input.grouping) {
+        block('CD-019', `Bu bileşen satırları bölümlere ayırır: gruplama alanı seçin — grouping: { by: '<alan>', sectionOrder: 'asc' | 'desc' | 'asis', dateBucket?: 'day' | 'week' | 'month' } verin. Sunucu sırayı gruplama alanıyla başlatır; date alanında gün/hafta/ay kovası satıra __section olarak yazılır, datetime alanında cihaz yerel günden kovalar.`);
+    }
+    if (groups && input.grouping?.dateBucket && !describe.fields.find(item => item.slug === input.grouping?.by)?.dateBuckets?.length) {
+        block('CD-019', `grouping.dateBucket '${input.grouping.dateBucket}': '${input.grouping.by}' tarih alanı değil (describe dateBuckets yok) — platform 422 grouping.dateBucket döner. Tarih/tarih-saat alanı seçin ya da dateBucket'ı kaldırın.`);
+    }
+    if (groups && input.grouping && input.grouping.sectionOrder !== 'asis' && describe.fields.find(item => item.slug === input.grouping?.by)?.sortable === false) {
+        block('CD-019', `grouping.by '${input.grouping.by}' bu kaynakta sıralanamaz (describe sortable yok): sunucu gruplu listeyi gruplama alanıyla sıralar — platform kaydı 422 connect-data-grouping-not-sortable döner. Sıralanabilir bir alan seçin ya da sectionOrder: 'asis' verin.`);
+    }
+    if (!groups && input.grouping) {
+        block('CD-020', `grouping yalnız satırları bölümleyen bileşende (component_get.connectData.props.<prop>.wizardSteps 'grouping' — mobilde grouped-list) yazılır; bu bileşen gruplamayı okumaz. grouping'i kaldırın.`);
+    }
     const declaredParameters = (describe.source?.parameters ?? []).map(parameter => parameter.name);
     for (const name of Object.keys(input.params ?? {}).filter(item => !declaredParameters.some(declared => declared.toLowerCase() === item.toLowerCase()))) {
         block('CD-013', `params.${name}: '${describe.source?.slug ?? describe.source?.id}' böyle bir parametre almaz. Alınanlar: ${declaredParameters.join(' · ') || '(yok)'} (describe source.parameters; sayfalama, sıralama, dinamik filtre ve dil parametreleri motorundur).`);
@@ -559,6 +584,9 @@ export function inputFromExisting(input, existing) {
         pageSize: input.pageSize ?? existing.page?.limit,
         params: input.params ?? (existing.params && Object.keys(existing.params).length > 0 ? { ...existing.params } : undefined),
         lookup: input.lookup !== undefined ? input.lookup : existing.lookup ?? null,
+        mobile: input.mobile !== undefined ? input.mobile : existing.behavior?.mobile ?? undefined,
+        mobileCard: input.mobileCard !== undefined ? input.mobileCard : existing.behavior?.mobileCard ?? undefined,
+        grouping: input.grouping !== undefined ? input.grouping : existing.grouping ?? undefined,
         language: input.language ?? existing.language ?? undefined,
         filterable: input.filterable ?? [...(existing.behavior?.filterable ?? [])],
         searchable: input.searchable ?? [...(existing.behavior?.searchable ?? [])],
@@ -644,10 +672,12 @@ export function renameDefinitionPaths(definition, renames) {
                                 ...(edit.defaults ? { defaults: Object.fromEntries(Object.entries(edit.defaults).map(([path, value]) => [rename(path), value])) } : {})
                             }
                         }
-                        : {})
+                        : {}),
+                    ...(definition.behavior.mobileCard ? { mobileCard: renameMobileParts(definition.behavior.mobileCard, rename) } : {})
                 }
             }
             : {}),
+        ...(definition.grouping ? { grouping: { ...definition.grouping, by: rename(definition.grouping.by) } } : {}),
         ...(definition.lookup
             ? {
                 lookup: {
@@ -662,7 +692,8 @@ export function renameDefinitionPaths(definition, renames) {
                             }
                         }
                         : {}),
-                    ...(definition.lookup.sort ? { sort: definition.lookup.sort.map(item => ({ ...item, field: rename(item.field) })) } : {})
+                    ...(definition.lookup.sort ? { sort: definition.lookup.sort.map(item => ({ ...item, field: rename(item.field) })) } : {}),
+                    ...(definition.lookup.mobileRow ? { mobileRow: renameMobileParts(definition.lookup.mobileRow, rename) } : {})
                 }
             }
             : {})
@@ -706,6 +737,10 @@ export function capabilityUnderRecordedNames(describe) {
     return Object.keys(recorded).length === 0 ? describe : { ...describe, fields: describe.fields.map(field => ({ ...field, slug: renamePath(field.slug, recorded) })) };
 }
 /** Bind girdisindeki yolları (alanlar, roller, expand, filtre, sıralama, filterable/searchable, edit) yeniden adlandırır. */
+/** Telefon satırı/kartı parçalarının (`title`, `subtitle`, `trailing`, `fields`) yollarını çevirir. */
+function renameMobileParts(parts, rename) {
+    return Object.fromEntries(Object.entries(parts).map(([part, value]) => [part, typeof value === 'string' ? rename(value) : Array.isArray(value) ? value.map(item => rename(String(item))) : value]));
+}
 export function renameBindInput(input, renames) {
     if (Object.keys(renames).length === 0)
         return input;
@@ -724,6 +759,8 @@ export function renameBindInput(input, renames) {
         ...(input.sort ? { sort: input.sort.map(item => ({ ...item, field: rename(item.field) })) } : {}),
         ...(input.filterable ? { filterable: input.filterable.map(rename) } : {}),
         ...(input.searchable ? { searchable: input.searchable.map(rename) } : {}),
+        ...(input.mobileCard ? { mobileCard: renameMobileParts(input.mobileCard, rename) } : {}),
+        ...(input.grouping ? { grouping: { ...input.grouping, by: rename(input.grouping.by) } } : {}),
         ...(input.edit
             ? {
                 edit: {

package/dist/knowledge/connectDataDefinition.js

@@ -27,6 +27,35 @@ const filterSchema = z.lazy(() => z.object({
 }).strict());
 const sortSchema = z.object({ field: z.string(), ascending: z.boolean(), rawSql: z.null().optional() }).strict();
 const pageSchema = z.object({ mode: z.enum(['offset', 'cursor', 'client']), limit: z.number().int() }).strict();
+/** Telefonda lookup yüzeyi; yoksa `sheet` (backend `ConnectDataDefinitionValidator.LookupMobileModes`). */
+export const CONNECT_DATA_LOOKUP_MOBILE_MODES = ['sheet', 'fullscreen'];
+const mobileRowSchema = z.object({ title: z.string(), subtitle: z.string().nullable().optional(), trailing: z.string().nullable().optional() }).strict();
+/** Backend `ConnectDataMobileBehaviorModel`: telefon "Telefonda" kutusunun anahtarları; sunucu okumaz. */
+export const mobileBehaviorSchema = z.object({
+    search: z.boolean().nullable().optional(),
+    infiniteScroll: z.boolean().nullable().optional(),
+    pullToRefresh: z.boolean().nullable().optional(),
+    recentSelections: z.boolean().nullable().optional(),
+    filterChips: z.boolean().nullable().optional(),
+    swipeDelete: z.boolean().nullable().optional()
+}).strict();
+/** Backend `ConnectDataMobileCardModel`: datatable kart görünümü telefonda (seçili yollar). */
+export const mobileCardSchema = z.object({ title: z.string(), fields: z.array(z.string()).nullable().optional(), trailing: z.string().nullable().optional() }).strict();
+/** Backend `ConnectDataRules.GroupingDateBuckets` / `GroupingSectionOrders` (kök ADR 0019). */
+export const CONNECT_DATA_GROUPING_DATE_BUCKETS = ['day', 'week', 'month'];
+export const CONNECT_DATA_GROUPING_SECTION_ORDERS = ['asc', 'desc', 'asis'];
+/**
+ * Backend `ConnectDataGroupingModel`: gruplu listenin bölümlemesi. Sunucu sırayı `by` ile başlatır (`asis` hariç),
+ * `dateBucket` varsa `date` alanında satıra `__section` yazar (`datetime` cihazda kovalanır). Değerler metin olarak alınır, kural `connectDataShapeIssues`'ta.
+ */
+export const groupingSchema = z.object({
+    by: z.string(),
+    dateBucket: z.string().nullable().optional(),
+    sectionOrder: z.string().nullable().optional(),
+    otherSectionTitle: z.string().nullable().optional(),
+    stickyHeaders: z.boolean().nullable().optional(),
+    showCounts: z.boolean().nullable().optional()
+}).strict();
 const behaviorSchema = z.object({
     filterable: z.array(z.string()).nullable().optional(),
     searchable: z.array(z.string()).nullable().optional(),
@@ -40,14 +69,18 @@ const behaviorSchema = z.object({
         defaults: z.record(z.unknown()).nullable().optional(),
         writeMode: z.enum(['atomic', 'partial']).optional()
     }).strict().nullable().optional(),
-    refresh: z.object({ afterWrite: z.string().nullable().optional(), poll: z.number().nullable().optional() }).strict().nullable().optional()
+    refresh: z.object({ afterWrite: z.string().nullable().optional(), poll: z.number().nullable().optional() }).strict().nullable().optional(),
+    mobile: mobileBehaviorSchema.nullable().optional(),
+    mobileCard: mobileCardSchema.nullable().optional()
 }).strict();
 export const lookupSchema = z.lazy(() => z.object({
     fields: z.array(fieldSchema).nullable().optional(),
     behavior: behaviorSchema.nullable().optional(),
     sort: z.array(sortSchema).nullable().optional(),
     page: pageSchema.nullable().optional(),
-    mode: z.string().nullable().optional()
+    mode: z.string().nullable().optional(),
+    mobileMode: z.string().nullable().optional(),
+    mobileRow: mobileRowSchema.nullable().optional()
 }).strict());
 const fieldSchema = z.lazy(() => z.object({
     id: z.string().uuid().nullable().optional(),
@@ -67,7 +100,8 @@ export const connectDataDefinitionSchema = z.object({
     behavior: behaviorSchema.nullable().optional(),
     params: z.record(z.unknown()).nullable().optional(),
     expressions: z.record(z.string()).nullable().optional(),
-    lookup: lookupSchema.nullable().optional()
+    lookup: lookupSchema.nullable().optional(),
+    grouping: groupingSchema.nullable().optional()
 }).strict();
 /** Tanımın seçtiği yollar: `ad`, `sube`, `sube.ad`; expand iki seviyeye kadar. */
 export function selectedPaths(definition) {
@@ -203,6 +237,31 @@ export function connectDataShapeIssues(ref, path = 'ref') {
         shape('connect-data-enum-invalid', `${path}.behavior.edit.saveMode`, "saveMode yalnız 'row', 'cell' ya da 'batch'.");
     if (behavior?.refresh?.afterWrite && !['reload', 'merge'].includes(behavior.refresh.afterWrite))
         shape('connect-data-enum-invalid', `${path}.behavior.refresh.afterWrite`, "afterWrite yalnız 'reload' ya da 'merge'.");
+    const mobileCard = behavior?.mobileCard;
+    if (mobileCard) {
+        const cardParts = [['title', mobileCard.title ?? ''], ...(mobileCard.fields ?? []).map((field) => ['fields', field]), ...(mobileCard.trailing != null ? [['trailing', mobileCard.trailing]] : [])];
+        const reported = new Set();
+        for (const [part, field] of cardParts.filter(([, field]) => !paths.includes(field))) {
+            if (reported.has(part))
+                continue;
+            reported.add(part);
+            subset('connect-data-mobile-field-not-selected', `${path}.behavior.mobileCard.${part}`, `Telefon kartında (${part}) '${field}' seçili değil. Seçili: ${paths.join(' · ')}`);
+        }
+    }
+    const grouping = definition.grouping;
+    if (grouping) {
+        if (kind && kind !== 'entity')
+            issues.push({ code: 'CD-013', rule: 'connect-data-source-feature-unsupported', path: `${path}.grouping`, message: `${kind} kaynağında gruplama yok: sunucu sırası ve gün/hafta/ay kovası yalnız entity kaynağında.` });
+        if (!grouping.by.trim() || !paths.includes(grouping.by))
+            subset('connect-data-grouping-not-selected', `${path}.grouping.by`, `Gruplama alanı '${grouping.by}' seçili değil. Seçili: ${paths.join(' · ')}`);
+        if (grouping.dateBucket && !CONNECT_DATA_GROUPING_DATE_BUCKETS.includes(grouping.dateBucket))
+            shape('connect-data-enum-invalid', `${path}.grouping.dateBucket`, "grouping.dateBucket yalnız 'day', 'week' ya da 'month' (alan date/datetime olmalı).");
+        if (grouping.sectionOrder && !CONNECT_DATA_GROUPING_SECTION_ORDERS.includes(grouping.sectionOrder))
+            shape('connect-data-enum-invalid', `${path}.grouping.sectionOrder`, "grouping.sectionOrder yalnız 'asc', 'desc' ya da 'asis'.");
+        if (grouping.sectionOrder !== 'asis' && definition.page?.mode === 'cursor' && (definition.sort ?? []).length > 0) {
+            issues.push({ code: 'CD-013', rule: 'connect-data-source-feature-unsupported', path: `${path}.sort`, message: 'Gruplama + cursor sayfalamada sıra gruplama alanı ve anahtardır: sort verilemez — sort\'u kaldırın ya da offset sayfalayın.' });
+        }
+    }
     for (const [role, fieldPath] of Object.entries(definition.mapping?.roles ?? {})) {
         if (fieldPath?.trim() && !paths.includes(fieldPath))
             subset('connect-data-role-not-selected', `${path}.mapping.roles.${role}`, `'${role}' rolü seçili olmayan '${fieldPath}' alanına eşlenmiş.`);
@@ -216,8 +275,20 @@ export function connectDataShapeIssues(ref, path = 'ref') {
             issues.push({ code: 'CD-011', rule: 'connect-data-lookup-nested', path: lookupPath, message: `'${owner}' lookup'ı içinde başka lookup olamaz.` });
         if (lookup.mode && !['drawer', 'modal'].includes(lookup.mode))
             shape('connect-data-enum-invalid', `${lookupPath}.mode`, "lookup.mode yalnız 'drawer' ya da 'modal'.");
+        if (lookup.mobileMode && !CONNECT_DATA_LOOKUP_MOBILE_MODES.includes(lookup.mobileMode))
+            shape('connect-data-enum-invalid', `${lookupPath}.mobileMode`, "lookup.mobileMode yalnız 'sheet' (alt sayfa, varsayılan) ya da 'fullscreen' (tam ekran).");
         if (lookup.page && (lookup.page.limit < 1 || lookup.page.limit > CONNECT_DATA_PAGE_LIMIT_MAX))
             shape('connect-data-page-limit', `${lookupPath}.page.limit`, `lookup.page.limit 1…${CONNECT_DATA_PAGE_LIMIT_MAX} arasında olmalı.`);
+        if (lookup.mobileRow) {
+            const lookupPaths = selectedPaths({ ...definition, fields: lookup.fields ?? [] });
+            const rowParts = [['title', lookup.mobileRow.title ?? ''], ['subtitle', lookup.mobileRow.subtitle], ['trailing', lookup.mobileRow.trailing]];
+            for (const [part, field] of rowParts) {
+                const isBlankTitle = part === 'title' && !field?.trim();
+                const isOutside = typeof field === 'string' && lookupPaths.length > 0 && !lookupPaths.includes(field);
+                if (isBlankTitle || isOutside)
+                    subset('connect-data-mobile-field-not-selected', `${lookupPath}.mobileRow.${part}`, `Telefon satırında (${part}) '${field ?? ''}' '${owner}' lookup'ının alanı değil${isBlankTitle ? ' (başlık zorunlu)' : ''}. Lookup alanları: ${lookupPaths.join(' · ') || '(türetilir)'}`);
+            }
+        }
     }
     return issues;
 }

package/dist/knowledge/connectDataRules.js

@@ -124,5 +124,19 @@ export const connectDataRuleCatalog = [
         rule: "Dosya alanı (describe type 'file') edit.editable'a konamaz: bağlı bileşen dosyayı satır içinde yazmaz. edit açıkken editable verilmezse gateway'in önerdiği yazılabilir alanlar da dosya alanını dışarıda bırakır.",
         enforcedBy: 'connect_data_bind — buildDefinition (dryRun dahil, istek gitmeden)',
         source: "38/M-4; ConnectDataService.ValidateSourcesAsync ConnectDataRules.EditableFile 'connect-data-editable-file' (422, kayıtta)"
+    },
+    {
+        id: 'CD-019',
+        severity: 'block',
+        rule: "Satırları bölümleyen bileşen (connectData.props.<prop>.wizardSteps 'grouping' — mobilde grouped-list) tanımda grouping ister: by seçili ve (asis dışında) sıralanabilir bir alan, sectionOrder asc · desc · asis; dateBucket (day · week · month) yalnız date/datetime alanda (describe dateBuckets).",
+        enforcedBy: 'connect_data_bind — buildDefinition (istek gitmeden); şekil ve alt küme connectDataShapeIssues (connect-data-grouping-not-selected, connect-data-enum-invalid)',
+        source: "kök ADR 0019 (plan mobil-tasarimci-kabuk-ekranlari K8, b-32); ConnectDataDefinitionValidator connect-data-grouping-not-selected, ConnectDataService 422 grouping.dateBucket ve ValidateSourcesAsync connect-data-grouping-bucket-not-date ve connect-data-grouping-not-sortable"
+    },
+    {
+        id: 'CD-020',
+        severity: 'block',
+        rule: "grouping yalnız satırları bölümleyen bileşende yazılır; gruplama adımı bildirmeyen bileşen (datatable, repeater, seçim bileşenleri…) onu okumaz.",
+        enforcedBy: 'connect_data_bind — buildDefinition (connectable.wizardSteps)',
+        source: 'kök ADR 0019; Studio Veri bağla sihirbazı gruplama adımını yalnız bildiren bileşende çizer (wizard-step-registry)'
     }
 ];