@medyat/vue-data-table 0.0.0-stage → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,716 @@
+import { Component } from 'vue';
+import { InjectionKey } from 'vue';
+import { Plugin as Plugin_2 } from 'vue';
+import { PublicProps } from 'vue';
+import { ShallowUnwrapRef } from 'vue';
+import { VNode } from 'vue';
+import { VNodeChild } from 'vue';
+
+declare const __VLS_export: <Row extends object>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: PublicProps & __VLS_PrettifyLocal<{
+        tableId: TableId;
+        columns: Array<ColumnDef<Row>>;
+        rows: Row[];
+        rowKey?: string;
+        /** Verilmezse tercihten (Display › Density), o da yoksa standard. */
+        density?: Density;
+        entityName?: Plural;
+        /** Tek harfli kısayollar (/, F, R). Oklar, Enter, Space, Esc ve Alt←/→ her zaman. */
+        shortcuts?: boolean;
+        /** client: tüm satırlar verilir, arama/sıralama/sayfalama yerelde. server: `@request` ile uygulama çeker. */
+        mode?: "client" | "server";
+        loading?: boolean;
+        error?: TableError;
+        /** Sunucu modu: sonraki sayfa var mı (Laravel `next_page_url !== null`). */
+        hasMore?: boolean;
+        /** Biliniyorsa toplam; istemci modunda otomatik. */
+        total?: number;
+        /** Sunucu modu: footer'da "Count total" → `@count`. */
+        countable?: boolean;
+        /** Her talepte `query.fields`'e eklenecek ek alanlar. */
+        fields?: string[];
+        /** Yeni görünen sütunun yolu son talepte yoksa `reason: 'columns'` talebi (400 ms birleştirme). */
+        requestOnColumnChange?: boolean;
+        /** auto: yapılandırılana göre yuvalar; minimal: yalnızca arama + `#toolbar-end`; false: toolbar yok. */
+        toolbar?: "auto" | "minimal" | false;
+        searchPlaceholder?: string;
+        /** Varsayılan 100; tercih varsa o. */
+        pageSize?: number;
+        pageSizes?: number[];
+        /** Saniye. Verilmezse More menüsünde Auto-refresh görünmez. */
+        autoRefresh?: number;
+        /** Kodla tanımlı görünümler (kind: 'system'); adapter'daki kişisel görünümlerle birleştirilir (04 §7). */
+        views?: View[];
+        /** Seçim sütunu; seçim sayfa kapsamlıdır (D19). */
+        selectable?: boolean;
+        /** Seçim çubuğu: yüzer (varsayılan) ya da toolbar'ın yerine. */
+        selectionBar?: "floating" | "toolbar";
+        bulkActions?: Array<BulkAction<Row>>;
+        /** Satır menüsü (⋯, sağ tık, ⇧F10): Open / Copy yerleşik + bunlar. */
+        rowActions?: Array<RowAction<Row>>;
+        /** Satır gövdesine tıklama (D6). Varsayılan 'none'. */
+        rowClick?: RowClickMode;
+        expand?: boolean | ExpandOptions<Row>;
+        /** Satır hatası (D35): metin/metin listesi → `--dt-r-bg` + ⋯ hücresinde uyarı ikonu + satırda tooltip. Harita uygulamanın. */
+        rowError?: (row: Row) => string | string[] | null | undefined;
+        /** More › Export (D46). Varsayılan açık; `false` gizler (ör. yetki). */
+        exportable?: boolean;
+    } & {
+        onCount?: ((request: CountRequest) => any) | undefined;
+        "onRow-click"?: ((payload: {
+            row: Row;
+            event: MouseEvent;
+        }) => any) | undefined;
+        "onRow-open"?: ((payload: {
+            row: Row;
+            href: string;
+            event: MouseEvent;
+        }) => any) | undefined;
+        onExport?: ((payload: {
+            format: "csv" | "xlsx";
+            query: QueryWithoutPage;
+            selection: Row[];
+            rows: Row[];
+            visibleColumns: string[];
+        }) => any) | undefined;
+        onImport?: (() => any) | undefined;
+        onPrint?: ((payload: {
+            query: QueryWithoutPage;
+            visibleColumns: string[];
+        }) => any) | undefined;
+        onRequest?: ((request: TableRequest) => any) | undefined;
+        "onSelection-change"?: ((rows: Row[]) => any) | undefined;
+        "onView-change"?: ((payload: {
+            id: string;
+            kind: View["kind"];
+        }) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: ShallowUnwrapRef<{
+        refresh: () => void;
+        clearSelection: () => {};
+    }>) => void;
+    attrs: any;
+    slots: {
+        empty?: () => unknown;
+        'toolbar-end'?: (props: {
+            compact: boolean;
+        }) => unknown;
+        /** Satır detayı; veriyi slot bileşeni çeker (05 §7). */
+        expanded?: (props: {
+            row: Row;
+            close: () => void;
+        }) => unknown;
+        /** bulkActions yerine özel seçim çubuğu içeriği. */
+        'selection-actions'?: (props: {
+            rows: Row[];
+            clear: () => void;
+        }) => unknown;
+    };
+    emit: ((evt: "count", request: CountRequest) => void) & ((evt: "row-click", payload: {
+        row: Row;
+        event: MouseEvent;
+    }) => void) & ((evt: "row-open", payload: {
+        row: Row;
+        href: string;
+        event: MouseEvent;
+    }) => void) & ((evt: "export", payload: {
+        format: "csv" | "xlsx";
+        query: QueryWithoutPage;
+        selection: Row[];
+        rows: Row[];
+        visibleColumns: string[];
+    }) => void) & ((evt: "import") => void) & ((evt: "print", payload: {
+        query: QueryWithoutPage;
+        visibleColumns: string[];
+    }) => void) & ((evt: "request", request: TableRequest) => void) & ((evt: "selection-change", rows: Row[]) => void) & ((evt: "view-change", payload: {
+        id: string;
+        kind: View["kind"];
+    }) => void);
+}>) => VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+
+declare type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};
+
+export declare interface BaseColumn<Row, V = unknown> {
+    /** Kararlı kimlik; `accessor` verilmezse değer bu yoldan okunur ('customer.title' → row.customer?.title). */
+    id: Path<Row> | string;
+    /** Header metni (uygulama i18n'den verir). */
+    header: string;
+    /** Dar alanlarda (telefon) kısa header. */
+    headerShort?: string;
+    /** Sütun açıklaması: header tooltip'inde ad altında ikinci satır, Columns dialog'unda ad altında; hücrede gösterilmez. */
+    description?: string;
+    /** Hesaplanan değer. Verilirse `fields` ile sunucudan istenecek alanlar bildirilir. */
+    accessor?: (row: Row) => V;
+    fields?: string[];
+    /** string → header'da soluk son ek ("pcs", "d"). Fonksiyon → hücrede, satır bazında. */
+    unit?: string | ((row: Row) => string);
+    align?: 'left' | 'right' | 'center';
+    /** px. Varsayılan tipe göre (05 · Sütun genişlikleri). Sabit sütunlar her zaman px. */
+    width?: number;
+    /** px. Varsayılan 80. */
+    minWidth?: number;
+    maxWidth?: number;
+    hidden?: boolean;
+    /** Gizlenemez. Birincil ve `required` sütun için otomatik true. */
+    alwaysVisible?: boolean;
+    /** Birincil hücre: gerçek <a href> (D6); her zaman sola sabit (D45). Tabloda en fazla bir tane. */
+    primary?: boolean;
+    /** Birincil hücre veya `id`/`ajax` tipi için kayıt linki. */
+    href?: (row: Row) => string | undefined;
+    /** İkinci satır (yalnızca Comfortable). */
+    secondary?: (row: Row) => string | null | undefined;
+    /** Boş değer metni. Varsayılan "—". */
+    emptyText?: string;
+    sortable?: boolean;
+    filterable?: boolean;
+    filter?: ColumnFilterOptions;
+    searchable?: boolean;
+    suggested?: boolean;
+    filterNoun?: Plural;
+    priority?: number;
+    cell?: CellRender<Row, V>;
+    actions?: Array<CellAction<Row>>;
+    editable?: boolean | ((row: Row, ctx: {
+        isNew: boolean;
+    }) => boolean);
+    editor?: CellEditor;
+    required?: boolean;
+    validate?: Validator<Row>;
+    warn?: Validator<Row>;
+    importAliases?: string[];
+    hint?: string;
+}
+
+/** Toplu aksiyon. Seçim sayfa kapsamlıdır (D19): `rows` o anda seçili, yüklü satırlardır. */
+export declare interface BulkAction<Row = any> {
+    id: string;
+    label: string;
+    /** Bar düğmesinde tooltip, ⋯ menüsünde ikinci satır (gerekçe varsa o) (D36). */
+    description?: string;
+    icon?: Component;
+    /** Bar'da görünür; değilse ⋯ menüsünde. Bar'da en fazla 3. */
+    inBar?: boolean;
+    destructive?: boolean;
+    /** Yetkiye bağlı: false → bar'da ve menüde yok (D36). Duruma bağlı pasiflik için `disabled`. */
+    when?: (rows: Row[]) => boolean;
+    disabled?: (rows: Row[]) => boolean | string;
+    run: (rows: Row[]) => void | Promise<void>;
+}
+
+/** Hücre aksiyonu: paket sağ kenarda overlay olarak çizer (metin yerleşimi değişmez), ≤ 2 ikon + ⋯ menüsü. */
+export declare interface CellAction<Row> {
+    id: string;
+    label: string;
+    icon: Component;
+    /** 'hover': hover ve focus-within'de görünür (varsayılan). 'always': her zaman. */
+    reveal?: 'hover' | 'always';
+    /** Değere bağlı aksiyon: false → gösterilmez. */
+    when?: (row: Row) => boolean;
+    disabled?: (row: Row) => boolean | string;
+    destructive?: boolean;
+    /** Alt menü (⋯ olarak çizilir). */
+    menu?: Array<Omit<CellAction<Row>, 'reveal' | 'menu'>>;
+    run?: (row: Row) => void | Promise<void>;
+}
+
+/** Özel hücre içeriğine verilen bağlam. `value` tipe göre daralır (int → number | null, select → string | number | null …). */
+export declare interface CellContext<Row, V = unknown> {
+    row: Row;
+    value: V;
+    /** Tipin varsayılan biçimlendirmesi ("12,400", "Oct 24"); özel içerik bunu sarabilir. */
+    formatted: string;
+    column: {
+        id: string;
+        type: ColumnType;
+    };
+    density: Density;
+}
+
+/** Özel editör (DataSheet). Sözleşme: props { modelValue, row, column }, emit 'update:modelValue'; portallı içeriğin kökü `dt-sheet-layer` (07 §5). */
+export declare type CellEditor = Component;
+
+/**
+ * Özel hücre içeriği: yalnızca fonksiyon formu. Bileşen `h(Comp, props)` ile verilir.
+ * Tipin kabuğu (hizalama, kesme, boş değer, yoğunluk, hover) korunur; yalnızca içerik değişir.
+ */
+export declare type CellRender<Row, V = unknown> = (ctx: CellContext<Row, V>) => VNodeChild;
+
+export declare type ColumnDef<Row = any> = (BaseColumn<Row, number | null> & {
+    type: 'int';
+}) | (BaseColumn<Row, number | null> & {
+    type: 'float';
+    decimalPlaces?: number;
+}) | (BaseColumn<Row, number | null> & {
+    type: 'percentage';
+    display?: 'text' | 'bar';
+    decimalPlaces?: number;
+}) | (BaseColumn<Row, number | null> & {
+    type: 'star';
+    max?: number;
+}) | (BaseColumn<Row, number | null> & {
+    type: 'currency';
+    /** Sabit ISO kodu veya satırdan okuma. */
+    currency: string | ((row: Row) => string);
+    decimalPlaces?: number;
+}) | (BaseColumn<Row, string | null> & {
+    type: 'string' | 'text' | 'uppercase' | 'lowercase' | 'email' | 'url' | 'id';
+}) | (BaseColumn<Row, string | null> & {
+    type: 'phone';
+}) | (BaseColumn<Row, string | null> & {
+    type: 'color';
+    display?: 'swatch' | 'fill';
+    palette?: string[];
+}) | (BaseColumn<Row, boolean | null> & {
+    type: 'boolean';
+    falseTone?: 'neutral' | 'destructive';
+}) | (BaseColumn<Row, string | number | null> & {
+    type: 'select';
+    options: OptionDef[];
+    optionEnabled?: OptionEnabled<Row>;
+}) | (BaseColumn<Row, Array<string | number> | null> & {
+    type: 'multiselect';
+    options: OptionDef[];
+    optionEnabled?: OptionEnabled<Row>;
+}) | (BaseColumn<Row, string | number | null> & {
+    type: 'ajax';
+    remote: RemoteOptions;
+}) | (BaseColumn<Row, string | number | Array<string | number> | null> & {
+    type: 'user';
+    remote?: RemoteOptions<UserOption>;
+    options?: UserOption[];
+    /** Birden çok kişi (avatar yığını). */
+    multiple?: boolean;
+}) | (BaseColumn<Row, IsoDate | Date | null> & {
+    type: 'date';
+    overdue?: boolean | ((row: Row) => boolean);
+}) | (BaseColumn<Row, IsoDate | Date | null> & {
+    type: 'datetime';
+    relative?: boolean;
+    overdue?: boolean | ((row: Row) => boolean);
+}) | (BaseColumn<Row, unknown> & {
+    type: 'object';
+    summary?: (value: unknown, row: Row) => string;
+}) | (BaseColumn<Row, unknown[] | null> & {
+    type: 'array';
+    itemType?: 'string' | 'int' | 'float' | 'id';
+});
+
+export declare interface ColumnFilterOptions {
+    /** Tipin listesinden alt küme. */
+    operators?: FilterOp[];
+    defaultOperator?: FilterOp;
+}
+
+export declare interface ColumnLayout {
+    /** Görünür + gizli tüm sütunların sırası. */
+    order: string[];
+    /** Tanımlıysa beyaz liste: burada olmayan (sonradan eklenen) sütun gizlidir. */
+    visible: string[];
+    /** Yalnızca varsayılandan farklı genişlikler. */
+    widths: Record<string, number>;
+    pinned: {
+        left: string[];
+        right: string[];
+    };
+}
+
+/** 23 tip. `type` zorunludur; veriden çıkarsama yoktur. */
+export declare type ColumnType = 'int' | 'float' | 'percentage' | 'star' | 'currency' | 'string' | 'text' | 'uppercase' | 'lowercase' | 'phone' | 'color' | 'email' | 'url' | 'id' | 'boolean' | 'select' | 'multiselect' | 'ajax' | 'user' | 'date' | 'datetime' | 'object' | 'array';
+
+/** `countable` tablolarda "Count total" → `@count`; uygulama `total` prop'unu verir. */
+export declare interface CountRequest {
+    query: QueryWithoutPage;
+    signal: AbortSignal;
+}
+
+export declare function createContext(options?: DataTableOptions): DataTableContext;
+
+/** app.use(createDataTable({ locale: 'tr', viewsAdapter, preferences })) */
+export declare function createDataTable(options?: DataTableOptions): Plugin_2;
+
+export declare function createI18n(options?: {
+    locale?: string;
+    messages?: Partial<Messages>;
+}): I18n;
+
+export declare function createLocalStoragePreferences(options: {
+    scope: string;
+}): PreferencesAdapter;
+
+export declare function createLocalStorageViews(options: {
+    scope: string;
+}): ViewsAdapter;
+
+export declare const DATA_TABLE_KEY: InjectionKey<DataTableContext>;
+
+/** useTemplateRef<DataSheetHandle>('sheet'). */
+export declare interface DataSheetHandle {
+    status: Readonly<SheetStatus>;
+    /** Yönlendirici koruması için. */
+    isDirty: () => boolean;
+    /** `@save` ile aynı yük; uygulamanın kendi kaydetme düğmesi için. */
+    getChanges: () => SheetChanges;
+    /**
+     * Kayıt sonuçlarını işler (parça parça çağrılabilir): created/updated → işaretler kalkar, `row` verildiyse değerler onunla
+     * güncellenir; error → değişiklikler kalır, hatalar hücrelere yazılır. Undo/redo yığını temizlenir.
+     */
+    applyResult: (results: Array<SheetRowResult<unknown>>) => void;
+    /** Discard: tüm satırlar yüklendiği hale döner; yığın temizlenir. */
+    reset: () => void;
+    undo: () => void;
+    redo: () => void;
+    /** F8 ile aynı. */
+    goToNextError: () => void;
+}
+
+export declare const DataTable: typeof __VLS_export;
+
+export declare interface DataTableContext {
+    locale: string;
+    i18n: I18n;
+    /** null → yalnızca `views` prop'undaki görünümler, kaydetme yok (01 · plugin). */
+    viewsAdapter: ViewsAdapter | null;
+    /** null → tercihler oturumluk; arayüz "kaydedildi" demez. */
+    preferences: PreferencesAdapter | null;
+}
+
+/** Uygulama genelinde bir kez: app.use(createDataTable({ … })) */
+export declare interface DataTableOptions {
+    /** Varsayılan navigator.language. Sayı/tarih biçimi ve metin karşılaştırması bu locale ile. */
+    locale?: string;
+    messages?: Partial<Messages>;
+    /** Yoksa yalnızca `views` prop'undaki görünümler; kaydetme yok. */
+    viewsAdapter?: ViewsAdapter;
+    /** Yoksa tercihler oturumluk (kalıcı değil) ve arayüz bunu "kaydedildi" gibi sunmaz. */
+    preferences?: PreferencesAdapter;
+}
+
+export declare type DatePreset = 'today' | 'this_week' | 'next_7_days' | 'this_month' | 'last_30_days' | 'this_quarter' | 'overdue';
+
+export declare type Density = 'comfortable' | 'standard' | 'compact';
+
+export declare interface ExpandOptions<Row = any> {
+    /** Bu satırın detayı var mı? Yoksa chevron yerinde boşluk kalır. */
+    canExpand?: (row: Row) => boolean;
+}
+
+/** Operatöre göre ayrışan koşul. `currency` sütununda değer düz sayıdır; para birimi `currency` alanıyla gelir. */
+export declare type FilterCondition = {
+    column: string;
+    op: 'is_empty' | 'is_not_empty';
+} | {
+    column: string;
+    op: 'eq' | 'neq';
+    value: string | number | boolean;
+} | {
+    column: string;
+    op: 'contains' | 'not_contains' | 'starts_with' | 'ends_with';
+    value: string;
+} | {
+    column: string;
+    op: 'gt' | 'gte' | 'lt' | 'lte';
+    value: number;
+    currency?: string;
+}
+/** Uçlar dahil; tek taraflıysa biri null. */
+| {
+    column: string;
+    op: 'between';
+    value: [number | null, number | null];
+    currency?: string;
+} | {
+    column: string;
+    op: 'in' | 'not_in';
+    value: Array<string | number>;
+} | {
+    column: string;
+    op: 'before' | 'after';
+    value: IsoDate | {
+        preset: 'today';
+    };
+} | {
+    column: string;
+    op: 'within';
+    value: {
+        preset: DatePreset;
+    } | {
+        from: IsoDate;
+        to: IsoDate;
+    };
+};
+
+/** 18 operatör (04). Çok değerli hücrelerde (multiselect) `in` "şunlardan birini içerir" anlamındadır. */
+export declare type FilterOp = 'is_empty' | 'is_not_empty' | 'eq' | 'neq' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'in' | 'not_in' | 'before' | 'after' | 'within';
+
+export declare interface I18n {
+    readonly locale: string;
+    /** Anahtar yoksa anahtarın kendisini döndürür; geliştirme modunda bir kez uyarır. */
+    t: (key: string, params?: MessageParams) => string;
+    has: (key: string) => boolean;
+}
+
+/** ISO tarih ("2026-10-24") veya tarih-saat ("2026-10-24T09:42:00Z"). */
+export declare type IsoDate = string;
+
+/** `user` filtrelerinde oturumdaki kullanıcı. Sunucuda çözülür. */
+export declare const ME: "@me";
+
+/** `{name}` düz değer, `{entity.one}` nokta yolu (09 · kurallar). `count` çoğul seçimini de yönetir. */
+export declare type MessageParams = Record<string, string | number | boolean | null | undefined | Record<string, string> | Plural>;
+
+export declare type Messages = Record<string, MessageValue>;
+
+/** Parametreli metinler fonksiyon olabilir. */
+export declare type MessageValue = string | ((params: Record<string, string | number>) => string);
+
+export declare interface OptionDef {
+    value: string | number;
+    label: string;
+    /** Hazır ton veya tema başına açık renk. Verilmezse 'gray'. */
+    tone?: Tone | {
+        light: string;
+        dark: string;
+    };
+    description?: string;
+}
+
+/**
+ * Satıra göre kapalı seçenek (DataSheet). `options` tam liste kalır (etiket, filtre, dışa aktarma); kapalı seçenekler
+ * editör listesinde görünmez, yapıştırma/doldurma ile gelirse "isn't an option" hatası — yalnızca **değişen** hücrede
+ * (mevcut değer kural değişince hata olmaz). Satırın taslak halini alır.
+ */
+export declare type OptionEnabled<Row> = (option: OptionDef, row: Row) => boolean;
+
+/** `parseFile` sonucu: biçimden bağımsız ham satırlar; başlık tespiti ve eşleme paketindir (07 §13). */
+export declare interface ParsedWorkbook {
+    sheets: Array<{
+        name: string;
+        rows: unknown[][];
+    }>;
+}
+
+/** Nokta yolu: 'customer.title'. Gerçek koşullu tip Faz 2'de (api-draft: src/types/path.ts). */
+export declare type Path<Row> = string & {
+    __row?: Row;
+};
+
+/** Çoğul biçimli metin: { one: 'status', other: 'statuses' } */
+export declare interface Plural {
+    one: string;
+    other: string;
+}
+
+export declare interface Preferences {
+    density: Density;
+    verticalLines: boolean;
+    pageSize: number;
+    /** Kullanıcının "Set as default" seçtiği görünüm (system veya personal). */
+    defaultViewId: string | null;
+}
+
+export declare interface PreferencesAdapter {
+    get: (tableId: TableId) => Partial<Preferences> | Promise<Partial<Preferences>>;
+    set: (tableId: TableId, prefs: Partial<Preferences>) => void | Promise<void>;
+}
+
+/** İlerleme: boolean ya da sayaç ("Loading products… 6,200 of 10,000"). */
+export declare type Progress = boolean | {
+    done: number;
+    total: number;
+};
+
+export declare type QueryWithoutPage = Omit<TableQuery, 'page'>;
+
+/** `ajax` ve `user` sütunlarının seçenek kaynağı (sütunun kendi verisi; metin filtresi önerisi değildir). */
+export declare interface RemoteOptions<O extends OptionDef = OptionDef> {
+    /** Yazdıkça arama. Varsayılan sayfa boyutu 20. */
+    search: (q: string, page: number, ctx: {
+        signal: AbortSignal;
+    }) => Promise<{
+        items: O[];
+        hasMore: boolean;
+    }>;
+    /** Kayıtlı filtre değerlerinin, yapıştırılan değerlerin ve hücre değerlerinin etiketlerini çözer. */
+    resolve: (values: Array<string | number>, ctx: {
+        signal: AbortSignal;
+    }) => Promise<O[]>;
+    pageSize?: number;
+}
+
+export declare type RequestReason = 'initial' | 'query' | 'page' | 'columns' | 'refresh';
+
+export declare interface RowAction<Row = any> {
+    id: string;
+    label: string;
+    /** Menüde etiketin altında ikinci satır (gerekçe varsa o gösterilir); inline düğmede tooltip "Label — description" (D36). */
+    description?: string;
+    icon?: Component;
+    /** Gösterim için ("⌘↵"); paket kısayol bağlamaz, yalnızca Open yerleşiktir. */
+    shortcut?: string;
+    /** Yetkiye bağlı: false → ne menüde ne inline (D34). Duruma bağlı pasiflik için `disabled`. */
+    when?: (row: Row) => boolean;
+    /** ⋯'nın solunda 28 px ikon düğmesi olarak çizilir (`icon` zorunlu); çizildiği satırın menüsünde yer almaz. Satır başına ilk 2 (D36). */
+    inline?: boolean;
+    /** true veya gerekçe metni ("Already running") → pasif, gerekçe ikinci satırda. */
+    disabled?: (row: Row) => boolean | string;
+    destructive?: boolean;
+    /** Menüde üstündeki ayırıcı. */
+    separatorBefore?: boolean;
+    /** Onay, toast ve refresh uygulamanın işidir; paket sonucu beklemez (D20). */
+    run: (row: Row) => void | Promise<void>;
+}
+
+/** Satır gövdesine tıklama. Varsayılan 'none': metin seçilip kopyalanabilir, seçim ve açma yapmaz (D6). */
+export declare type RowClickMode = 'none' | 'open' | 'expand';
+
+export declare type RowKey = string | number;
+
+/** `@save` yükündeki bir satır. */
+export declare interface SheetChangeRow {
+    /** Paketin satıra verdiği geçici kimlik; `applyResult` bununla eşleşir. */
+    clientId: string;
+    /** Anahtar sütunun değeri (ör. SKU). */
+    key: string;
+    /**
+     * Değişen alanlar + `required` sütunlar + anahtar (sütun id'leriyle). Eklenen satırda boş değer gitmez. Sunucu anahtara
+     * göre upsert eder (D11, D47); paket kaydın sunucuda olup olmadığını bilmez.
+     */
+    values: Record<string, unknown>;
+}
+
+export declare interface SheetChanges {
+    /** Yalnızca yeni + değişmiş satırlar; hatalı satırlar ve listeden çıkarılanlar yoktur (D11, D12). */
+    rows: SheetChangeRow[];
+}
+
+export declare type SheetFilterMode = 'all' | 'changed' | 'errors';
+
+export declare interface SheetRowResult<Row> {
+    clientId: string;
+    status: 'created' | 'updated' | 'error';
+    /** Sütun id → mesaj. Hücrede kırmızı gösterilir. */
+    fieldErrors?: Record<string, string>;
+    /** Belirli bir alana bağlanamayan hata: satır başında gösterilir. */
+    rowError?: string;
+    /** Sunucunun kaydettiği hali; verilirse satır bununla güncellenir. */
+    row?: Row;
+}
+
+export declare interface SheetStatus {
+    phase: 'loading' | 'ready' | 'saving' | 'saved' | 'partly-saved';
+    changedCells: number;
+    changedRows: number;
+    newRows: number;
+    errorRows: number;
+    warningRows: number;
+}
+
+export declare interface SortRule {
+    column: string;
+    dir: 'asc' | 'desc';
+}
+
+/** `true` genel hata; string mesaj; nesne: mesaj + hata kimliği ("Copy error ID"). */
+export declare type TableError = boolean | string | {
+    message?: string;
+    id?: string;
+};
+
+/** Tablo örneğinin kalıcı kimliği: görünümler ve tercihler bununla saklanır (ör. "production-orders"). */
+export declare type TableId = string;
+
+export declare interface TableQuery {
+    search: string;
+    filters: FilterCondition[];
+    /** Öncelik sırasıyla, en fazla 3. */
+    sort: SortRule[];
+    /** Sayfa numarası 1'den başlar (Laravel simplePaginate ile aynı). */
+    page: {
+        number: number;
+        size: number;
+    };
+    /** Görünür sütun id'leri. */
+    columns: string[];
+    /** Sunucudan istenen alan yolları: görünür sütunların yolları + sütunların `fields`'i + tablonun `fields` prop'u. */
+    fields: string[];
+}
+
+/**
+ * `@request` olayının yükü. Paket veri çekmez: uygulama bu sorguyla kendi HTTP'sini atar ve
+ * `rows`, `hasMore`, `loading`, `error` prop'larını günceller. Her yeni talepte öncekinin `signal`'i abort edilir.
+ */
+export declare interface TableRequest {
+    query: TableQuery;
+    reason: RequestReason;
+    signal: AbortSignal;
+}
+
+export declare type Tone = 'gray' | 'blue' | 'green' | 'amber' | 'red' | 'violet' | 'pink' | 'teal';
+
+/** Bileşen içinden bağlam. Plugin kurulmamışsa varsayılanlar: navigator.language, paket metinleri, adapter yok. */
+export declare function useDataTableContext(): DataTableContext;
+
+export declare interface UserOption extends OptionDef {
+    avatarUrl?: string;
+    /** Avatar yoksa gösterilecek baş harfler; verilmezse label'dan üretilir. */
+    initials?: string;
+}
+
+export declare interface ValidationContext<Row> {
+    row: Row;
+    isNew: boolean;
+    original: unknown;
+}
+
+/** null/undefined/'' → geçerli; string → hata veya uyarı metni (i18n'lenmiş). */
+export declare type Validator<Row> = (value: unknown, ctx: ValidationContext<Row>) => string | null | undefined;
+
+/** Tek görünüm tipi (D4, D30). system: kodla tanımlı, değiştirilemez (Duplicate, Set as default). personal: yalnızca sahibine. */
+export declare interface View {
+    id: string;
+    name: string;
+    kind: 'system' | 'personal';
+    state: ViewPatch;
+    /** Ekranın varsayılanı (system içinde en fazla bir tane). Kullanıcı varsayılanı tercihlerde (`defaultViewId`). */
+    default?: boolean;
+    updatedAt?: IsoDate;
+    /** Sunucu sürüm numarası (çakışma tespiti için, opsiyonel). */
+    v?: number;
+}
+
+/** Kısmi görünüm (system view tanımı ve adapter'dan gelen kayıtlar). Eksik alanlar tablonun varsayılanlarıyla tamamlanır. */
+export declare interface ViewPatch {
+    filters?: FilterCondition[];
+    sort?: SortRule[];
+    columns?: Partial<ColumnLayout>;
+}
+
+export declare interface ViewsAdapter {
+    list: (tableId: TableId) => Promise<View[]>;
+    create: (tableId: TableId, input: {
+        name: string;
+        state: ViewState;
+    }) => Promise<View>;
+    update: (tableId: TableId, id: string, patch: {
+        name?: string;
+        state?: ViewState;
+    }) => Promise<View>;
+    remove: (tableId: TableId, id: string) => Promise<void>;
+}
+
+/** D5: görünüm = filtre + sıralama + sütun düzeni. Arama, yoğunluk, tema, sayfa yazılmaz. Kaydedilen tam snapshot. */
+export declare interface ViewState {
+    filters: FilterCondition[];
+    sort: SortRule[];
+    columns: ColumnLayout;
+}
+
+export { }