@medyat/react-data-table 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,736 @@
+import { ComponentType } from 'react';
+import { Dispatch } from 'react';
+import { JSX } from 'react';
+import { MouseEvent as MouseEvent_2 } from 'react';
+import { ReactNode } from 'react';
+import { SetStateAction } from 'react';
+
+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 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>>;
+}
+
+/** 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?: IconComponent;
+    /** 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: IconComponent;
+    /** '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 hücre içeriği: bağlamdan ReactNode döndüren fonksiyon. Hook çağıran içerik bir bileşene sarılır
+ * (`cell: (ctx) => <Owner {...ctx} />`): fonksiyon her satır için düz çağrılır.
+ * 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>) => ReactNode;
+
+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[];
+}) | (BaseColumn<Row, Array<string | number> | null> & {
+    type: 'multiselect';
+    options: OptionDef[];
+}) | (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[];
+    };
+}
+
+/** Dialog taslağı: sıra, görünürler ve konumsal sabitleme (ilk `start`, son `end` görünür sütun). */
+declare interface ColumnsDraft {
+    order: string[];
+    visible: string[];
+    start: number;
+    end: number;
+}
+
+/** 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';
+
+export declare function createLocalStoragePreferences(options: {
+    scope: string;
+}): PreferencesAdapter;
+
+export declare function createLocalStorageViews(options: {
+    scope: string;
+}): ViewsAdapter;
+
+export declare function DataTable<Row extends object>({ table, result, label, empty, toolbar, toolbarEnd, notice, searchPlaceholder, autoRefresh, onPrint, exportable, onExport, shortcuts, onRowClick, rowClick, onRowOpen, rowActions, selectable, selectionBar, bulkActions, selectionActions, onSelectionChange, renderExpanded, canExpand, rowError, }: {
+    table: DataTableInstance<Row>;
+    /** Sunucu modu: `useQuery` sonucu, dönüştürmeden (R4). İstemci modunda verilmez. */
+    result?: DataTableResult<Row>;
+    /** Izgaranın erişilebilir adı. Verilmezse `entityName.other`. */
+    label?: string;
+    /** Hiç satır yokken (filtre ve arama yokken) gövdede; verilmezse "No {entity} yet". */
+    empty?: ReactNode;
+    /** auto: yapılandırılana göre yuvalar; minimal: yalnızca arama (3a) + `toolbarEnd`; false: araç çubuğu yok. */
+    toolbar?: 'auto' | 'minimal' | false;
+    /** Ekrana özgü birincil aksiyon, araç çubuğunun sonunda (ör. "New order"). */
+    toolbarEnd?: ReactNode;
+    /**
+     * Araç çubuğu ile sütun başlıkları arasında uygulamanın şeridi (R16): listenin bağlamını anlatır
+     * ("Yalnızca arşivlenmiş kayıtlar"). İçerik ve rolü uygulamanındır; paket yer ve hizayı verir.
+     */
+    notice?: ReactNode;
+    /** Verilmezse "Search {entity}…". */
+    searchPlaceholder?: string;
+    /** Saniye. Verilirse ⋯ menüsünde Auto-refresh; açıkken footer "Live". */
+    autoRefresh?: number;
+    /** Verilirse ⋯ › Print. Sorgu sayfasızdır. */
+    onPrint?: (payload: {
+        query: QueryWithoutPage;
+        visibleColumns: string[];
+    }) => void;
+    /** ⋯ › Export (D46). Varsayılan açık; `false` gizler (ör. yetki). */
+    exportable?: boolean;
+    /** Verilirse paket dosya yazmaz; `rows` paketin yazacağı satırlardır (seçim varsa seçili, yoksa sayfadaki). */
+    onExport?: (payload: {
+        format: 'csv' | 'xlsx';
+        query: QueryWithoutPage;
+        selection: Row[];
+        rows: Row[];
+        visibleColumns: string[];
+    }) => void;
+    /** Tek harfli kısayollar (/ arama, F filtre, R yenile, V görünümler) ve ⌘S. Alt←/→ her zaman çalışır. */
+    shortcuts?: boolean;
+    /** Satır gövdesine düz tık; hücredeki düğme, link ve metin seçimi tetiklemez (05 §7). `rowClick`'ten bağımsız. */
+    onRowClick?: (row: Row, event: MouseEvent_2) => void;
+    /** Satır gövdesine tıklama (D6): 'open' birincil linki açar, 'expand' detayı açıp kapatır. Varsayılan 'none'. */
+    rowClick?: RowClickMode;
+    /** Birincil linke düz sol tık, menüde Open, `rowClick="open"`. Paket gezinmeyi durdurmaz: `event.preventDefault()` dinleyicide. */
+    onRowOpen?: (payload: {
+        row: Row;
+        href: string;
+        event: MouseEvent_2;
+    }) => void;
+    /** Satır menüsü (⋯): Open / Copy yerleşik + bunlar. */
+    rowActions?: Array<RowAction<Row>>;
+    /** Seçim sütunu; seçim sayfa kapsamlıdır (D19), durum `table.selection`'da. */
+    selectable?: boolean;
+    /** Seçim çubuğu: yüzer (varsayılan) ya da araç çubuğunun yerine. */
+    selectionBar?: 'floating' | 'toolbar';
+    bulkActions?: Array<BulkAction<Row>>;
+    /** `bulkActions` yerine seçim çubuğunun içeriği. */
+    selectionActions?: (props: {
+        rows: Row[];
+        clear: () => void;
+    }) => ReactNode;
+    /** Seçim her değiştiğinde; sayfadaki seçili satırlar (D19). */
+    onSelectionChange?: (rows: Row[]) => void;
+    /** Satır detayı (05 §7): birincil hücrede chevron; veriyi detay bileşeni çeker. */
+    renderExpanded?: (props: {
+        row: Row;
+        close: () => void;
+    }) => ReactNode;
+    /** Bu satırın detayı var mı? Yoksa chevron yerinde boşluk kalır. */
+    canExpand?: (row: Row) => boolean;
+    /** Satır hatası (D35): metin ya da metin listesi → hata zemini, ⋯ hücresinde uyarı ikonu, satırda tooltip. Harita
+     * uygulamanın: paket hata saklamaz, temizlemez. */
+    rowError?: (row: Row) => string | string[] | null | undefined;
+}): JSX.Element;
+
+export declare interface DataTableContext {
+    locale: string;
+    i18n: I18n;
+    /** null → yalnızca `views` seçeneğindeki görünümler, kaydetme yok (01 · plugin). */
+    viewsAdapter: ViewsAdapter | null;
+    /** null → tercihler oturumluk; arayüz "kaydedildi" demez. */
+    preferences: PreferencesAdapter | null;
+}
+
+export declare type DataTableInstance<Row extends object> = ReturnType<typeof useDataTable<Row>>;
+
+/** Uygulama genelinde bir kez: `<DataTableProvider locale="tr" viewsAdapter={…}>` (R7). */
+export declare interface DataTableOptions {
+    /** Varsayılan navigator.language. Sayı/tarih biçimi ve metin karşılaştırması bu locale ile. */
+    locale?: string;
+    /** Sabit bir nesne verin (modül düzeyinde): her çizimde yeni nesne, bağlamı ve tüm tabloyu yeniden kurar. */
+    messages?: Partial<Messages>;
+    /** Yoksa yalnızca `views` seçeneğindeki görünümler; kaydetme yok. */
+    viewsAdapter?: ViewsAdapter;
+    /** Yoksa tercihler oturumluk (kalıcı değil) ve arayüz bunu "kaydedildi" gibi sunmaz. */
+    preferences?: PreferencesAdapter;
+}
+
+/** Vue'daki `createDataTable` plugin'inin karşılığı (R7). İç içe kullanılırsa en yakın sağlayıcı geçerlidir. */
+export declare function DataTableProvider({ children, locale, messages, viewsAdapter, preferences, }: DataTableOptions & {
+    children: ReactNode;
+}): JSX.Element;
+
+/**
+ * Sorgu sonucu: TanStack Query'nin `UseQueryResult`'ının yapısal alt kümesi; `useQuery` sonucu dönüştürülmeden verilir (R4).
+ * `placeholderData: keepPreviousData` önerilir: yoksa her sorgu değişiminde gövde iskelete döner.
+ */
+export declare interface DataTableResult<Row extends object> {
+    status: 'pending' | 'error' | 'success';
+    data?: {
+        rows: Row[];
+        /** Sonraki sayfa var mı (Laravel `next_page_url !== null`). */
+        hasMore?: boolean;
+        /** Biliniyorsa toplam. */
+        total?: number;
+    };
+    /** `message` ve `id` alanları okunur: hata ekranı ve "Copy error ID". */
+    error?: unknown;
+    isFetching?: boolean;
+    isPlaceholderData?: boolean;
+    dataUpdatedAt?: number;
+    /** Refresh, Retry ve `R` bunu çağırır; yoksa görünmezler. */
+    refetch?: () => unknown;
+}
+
+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';
+
+/** 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;
+}
+
+/** İkon bileşeni: Phosphor ikonları doğrudan verilir; paket `size`, `weight` ve `aria-hidden` geçirir. */
+export declare type IconComponent = ComponentType<{
+    size?: number | string;
+    weight?: 'thin' | 'light' | 'regular' | 'bold' | 'fill' | 'duotone';
+    className?: string;
+    'aria-hidden'?: boolean | 'true' | 'false';
+}>;
+
+/** ISO tarih ("2026-10-24") veya tarih-saat ("2026-10-24T09:42:00Z"). */
+export declare type IsoDate = string;
+
+/** Izgaranın çizdiği, TanStack'ten bağımsız sütun görünümü. Genişlik burada değil, `cols()`/`offsets()`'ta. */
+declare interface LayoutColumn<Row extends object = object> {
+    id: string;
+    def: ColumnDef<Row>;
+    pinned: PinSide;
+    /** Bölgenin kenarındaki sabit sütun: kaydırma gölgesini bu taşır. */
+    pinEdge: boolean;
+    /** Sabit hücrelerin sticky ofsetini taşıyan CSS değişkeni (`--dt-off-…`). */
+    offsetVar: string;
+    canHide: boolean;
+    /** Resize tutamacının TanStack işleyicisi (fare ve dokunma). */
+    resizeHandler: (event: unknown) => void;
+}
+
+/** `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;
+}
+
+/** Columns dialog'unun satırı (05 §5, D45): tüm sütunlar ekran sırasıyla. */
+declare interface PanelColumn<Row extends object = object> {
+    id: string;
+    def: ColumnDef<Row>;
+    visible: boolean;
+    pinned: PinSide;
+    canHide: boolean;
+    /** Her zaman sola sabit (birincil): listede kilitli, taşınmaz, gizlenmez. */
+    fixed: boolean;
+}
+
+/** 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;
+};
+
+declare type PinSide = 'start' | 'end' | null;
+
+/** Ç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>;
+}
+
+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;
+}
+
+/** Satır aksiyonu (05 §4, D34, D36): ⋯ menüsünde; `inline` ise ⋯'nın solunda ikon düğmesi. */
+export declare interface RowAction<Row = any> {
+    id: string;
+    label: string;
+    /** Menüde etiketin altında ikinci satır (gerekçe varsa o); inline düğmede tooltip "Label — description" (D36). */
+    description?: string;
+    icon?: IconComponent;
+    /** Gösterim için ("⌘↵"); paket kısayol bağlamaz. */
+    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 (`icon` zorunlu); o 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;
+
+export declare interface SortRule {
+    column: string;
+    dir: 'asc' | 'desc';
+}
+
+/** Tablo örneğinin kalıcı kimliği: görünümler ve tercihler bununla saklanır (ör. "production-orders"). */
+export declare type TableId = string;
+
+/**
+ * `table.request` (R4): uygulama bunu sorgu anahtarına koyar ve isteğini bununla kurar. Sütun taşımak, gizlemek ya da
+ * genişletmek isteği değiştirmez; yalnızca yeni görünen bir sütunun alanı listede yoksa `fields` büyür.
+ */
+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;
+    };
+    /** Sunucudan istenen alan yolları: satır anahtarı + görünür sütunların yolları ve `fields`'i + tablonun `fields`'i, koddaki sırayla. */
+    fields: string[];
+}
+
+/** Uygulamanın açabildiği durum (R5). Her alan ayrı ayrı controlled olabilir: `state`'te olan alan dışarıdan okunur. */
+export declare interface TableState {
+    /** Aktif görünümün kimliği (04 §7); `null`: görünüm yok ya da hiçbiri seçili değil. Verilmezse varsayılan görünüm açılır. */
+    view: string | null;
+    /** Toolbar araması (D3): filtre değildir, görünüme girmez. */
+    search: string;
+    /** Yalnızca tam koşullar; değeri seçilmemiş çip ekranda kalır, buraya girmez (04 §1). */
+    filters: FilterCondition[];
+    sort: SortRule[];
+    /** 1 tabanlı. */
+    page: number;
+    pageSize: number;
+}
+
+export declare type Tone = 'gray' | 'blue' | 'green' | 'amber' | 'red' | 'violet' | 'pink' | 'teal';
+
+export declare function useDataTable<Row extends object>(options: UseDataTableOptions<Row>): {
+    id: string;
+    columns: ColumnDef<Row>[];
+    entityName: Plural;
+    /** Sunucu modunda `useQuery` anahtarına ve isteğe girer (R4). */
+    request: TableQuery;
+    state: TableState;
+    /** İstemci modu: verilen tüm satırlar (filtre öncesi). Sunucu modunda undefined. */
+    allRows: Row[] | undefined;
+    /** İstemci modu: sayfadaki satırlar ve toplam. Sunucu modunda undefined. */
+    rows: Row[] | undefined;
+    total: number | undefined;
+    density: Density;
+    /** Uygulama `density` verdiyse kullanıcının seçimi etkisiz; Display'de seçici gösterilmez. */
+    densityFixed: boolean;
+    prefs: {
+        prefs: Preferences;
+        set: (patch: Partial< Preferences>) => void;
+        reset: () => void;
+        persistent: boolean;
+        ready: boolean;
+    };
+    views: {
+        all: View[];
+        sections: {
+            system: View[];
+            personal: View[];
+        };
+        active: View | null;
+        edited: boolean;
+        hasViews: boolean;
+        canSave: boolean;
+        hasDraft: (id: string) => boolean;
+        writable: (v: View | null) => boolean;
+        select: (id: string) => void;
+        saveChanges: () => Promise<void>;
+        discard: () => void;
+        create: (input: {
+            name: string;
+            state: ViewState;
+            makeDefault: boolean;
+            fromCurrent: boolean;
+        }) => Promise<void>;
+        rename: (id: string, name: string) => Promise<void>;
+        remove: (id: string) => Promise<void>;
+    };
+    /** Görünümün kayıtlı (kısmi) durumu → tam durum (Duplicate dialog'unun özeti). */
+    resolveView: (v: {
+        state: ViewPatch;
+    }) => ViewState;
+    /** Display › Reset: tercihler ve sütun düzeni aktif görünümün kayıtlı haline döner; filtre ve sıralama kalır (04 §8). */
+    resetDisplay: () => void;
+    /** Seçili satır anahtarları (05 §6). Satırların kendisi `DataTable`'ın `onSelectionChange`'inde. */
+    selection: Record<string, true>;
+    setSelection: (ids: Record<string, true>) => void;
+    clearSelection: () => void;
+    pageSizes: number[];
+    count: ((query: QueryWithoutPage, signal: AbortSignal) => Promise<number>) | undefined;
+    rowId: (row: Row) => string;
+    layout: {
+        columns: LayoutColumn<Row>[];
+        start: LayoutColumn<Row>[];
+        center: LayoutColumn<Row>[];
+        end: LayoutColumn<Row>[];
+        scale: number;
+        setScale: Dispatch<SetStateAction<number>>;
+        phone: boolean;
+        setPhone: Dispatch<SetStateAction<boolean>>;
+        cols: () => string;
+        offsets: () => Record<string, string>;
+        minWidth: () => number;
+        resizing: () => {
+            id: string;
+            size: number;
+        } | null;
+        subscribeSizing: (listener: () => void) => () => void;
+        move: (id: string, delta: -1 | 1) => void;
+        panel: PanelColumn<Row>[];
+        counts: {
+            shown: number;
+            total: number;
+        };
+        state: () => ColumnLayout;
+        resolve: (l: Partial< ColumnLayout> | undefined) => ColumnLayout;
+        arrange: (d: ColumnsDraft) => void;
+        reset: (l?: Partial< ColumnLayout> | undefined) => void;
+        widthOf: (id: string) => number;
+        setWidth: (id: string, px: number) => void;
+        setVisible: (id: string, visible: boolean) => void | undefined;
+    };
+    /** Header tıklaması ve ⇧ ile ikincil sıralama; sayfa 1'e döner. */
+    toggleSort: (column: string, multi: boolean) => void;
+    setSort: (column: string, dir: "asc" | "desc" | null) => void;
+    /** Arama ve filtre değişince sayfa 1'e döner (D19). */
+    setSearch: (search: string) => void;
+    setFilters: (filters: FilterCondition[]) => void;
+    /** Filtre ve sıralama tek istekte (telefon Filters › Show results, ⋯ › Sort); sayfa 1. */
+    setQuery: (patch: {
+        filters?: FilterCondition[];
+        sort?: SortRule[];
+    }) => void;
+    setPage: (page: number) => void;
+    setPageSize: (pageSize: number) => void;
+};
+
+/** Sağlayıcı yoksa varsayılanlar: navigator.language, paket metinleri, adapter yok. */
+export declare function useDataTableContext(): DataTableContext;
+
+export declare interface UseDataTableOptions<Row extends object> {
+    /** Kalıcı kimlik: görünümler ve tercihler bununla saklanır (ör. "production-orders"). */
+    id: string;
+    columns: Array<ColumnDef<Row>>;
+    /** İstemci modu: satırlar burada verilir, paket sıralar ve sayfalar; `request` kullanılmaz (R4). */
+    rows?: Row[];
+    /** Satır kimliği yolu. Varsayılan 'id'. */
+    rowKey?: string;
+    /** Verilmezse tercihten (Display › Density), o da yoksa standard. */
+    density?: Density;
+    /** Boş durum, hata ve sayfa metinlerinde: { one: 'order', other: 'orders' }. Verilmezse `id`. */
+    entityName?: Plural;
+    /** Controlled alanlar (R5). */
+    state?: Partial<TableState>;
+    /** Uncontrolled başlangıç. */
+    initialState?: Partial<TableState>;
+    /** Her değişimde tam durum; controlled alanlar burada güncellenir. */
+    onStateChange?: (state: TableState) => void;
+    /** Tercih yoksa sayfa boyutu. Varsayılan 100. */
+    pageSize?: number;
+    /** Varsayılan [50, 100, 250, 500]. */
+    pageSizes?: number[];
+    /** System görünümler (04 §7, D4): kodda tanımlı, herkes görür; kişisel görünümler provider'ın `viewsAdapter`'ından. */
+    views?: View[];
+    /** Her istekte `fields`'e eklenen alanlar. */
+    fields?: string[];
+    /** Sunucu modu: footer'da "Count total". Sayı sorgu değişene kadar geçerli; `signal` sorgu değişince iptal edilir. */
+    count?: (query: QueryWithoutPage, signal: AbortSignal) => Promise<number>;
+}
+
+export declare interface UserOption extends OptionDef {
+    avatarUrl?: string;
+    /** Avatar yoksa gösterilecek baş harfler; verilmezse label'dan üretilir. */
+    initials?: string;
+}
+
+/** 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 { }