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

package/dist/shadcn-bridge-hsl.css

@@ -0,0 +1,22 @@
+/* shadcn-vue köprüsü (Tailwind v3: değişkenler HSL üçlüsü, ör. "0 0% 100%"). tokens.css'ten SONRA yükleyin.
+   Eşleme shadcn-bridge.css ile aynıdır; her değişken hsl(var(--x)) ile sarılır. */
+:root,
+.dark,
+[data-theme='light'],
+[data-theme='dark'] {
+  --dt-canvas: hsl(var(--background));
+  --dt-surface: hsl(var(--card));
+  --dt-surface-2: color-mix(in oklab, hsl(var(--muted)) 45%, hsl(var(--card)));
+  --dt-surface-3: hsl(var(--muted));
+  --dt-line: hsl(var(--border));
+  --dt-line-2: hsl(var(--input));
+  --dt-line-3: color-mix(in oklab, hsl(var(--muted-foreground)) 45%, hsl(var(--border)));
+  --dt-text: hsl(var(--foreground));
+  --dt-text-2: color-mix(in oklab, hsl(var(--foreground)) 70%, hsl(var(--muted-foreground)));
+  --dt-text-3: hsl(var(--muted-foreground));
+  --dt-ink: hsl(var(--primary));
+  --dt-on-ink: hsl(var(--primary-foreground));
+  --dt-focus: hsl(var(--ring));
+  --dt-r-dot: hsl(var(--destructive));
+  --dt-r-fg: hsl(var(--destructive));
+}

package/dist/shadcn-bridge.css

@@ -0,0 +1,23 @@
+/* shadcn-vue köprüsü (Tailwind v4: değişkenler tam renk, ör. oklch(...)). tokens.css'ten SONRA yükleyin.
+   Yalnızca yüzey, çizgi, metin, birincil buton, odak ve yıkıcı renkler devralınır; accent ve tonlar paketin kendi değerleridir (02).
+   shadcn'in --accent değişkeni hover grisidir, --dt-accent ona bağlanmaz. */
+:root,
+.dark,
+[data-theme='light'],
+[data-theme='dark'] {
+  --dt-canvas: var(--background);
+  --dt-surface: var(--card);
+  --dt-surface-2: color-mix(in oklab, var(--muted) 45%, var(--card));
+  --dt-surface-3: var(--muted);
+  --dt-line: var(--border);
+  --dt-line-2: var(--input);
+  --dt-line-3: color-mix(in oklab, var(--muted-foreground) 45%, var(--border));
+  --dt-text: var(--foreground);
+  --dt-text-2: color-mix(in oklab, var(--foreground) 70%, var(--muted-foreground));
+  --dt-text-3: var(--muted-foreground);
+  --dt-ink: var(--primary);
+  --dt-on-ink: var(--primary-foreground);
+  --dt-focus: var(--ring);
+  --dt-r-dot: var(--destructive);
+  --dt-r-fg: var(--destructive);
+}

package/dist/sheet.d.ts

@@ -0,0 +1,623 @@
+import { Component } from 'vue';
+import { ComputedRef } 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 compact (02 · Yoğunluk). */
+        density?: Density;
+        entityName?: Plural;
+        /** Upsert anahtarı olan sütun (ör. "sku"). Yüklenmiş satırlarda salt okunur; `rowKey`'den ayrıdır. */
+        keyColumn: string;
+        /** Uygulama satırları yüklerken; sayaç verilirse "Loading… 6,200 of 10,000". Düzenleme false olunca açılır. */
+        loading?: Progress;
+        /** `@save` sonrası uygulama kaydederken: grid salt okunur, ilerleme şeridi (07 §14). */
+        saving?: Progress;
+        /** Add row ile oluşan satırın başlangıç değerleri. */
+        newRowDefaults?: () => Partial<Row>;
+        /** Import: dosyayı uygulama ayrıştırır ve ham satırları verir (07 §13). Verilmezse paketin okuyucusu (.xlsx, .csv; D46). */
+        parseFile?: (file: File) => Promise<ParsedWorkbook>;
+        /** Import düğmesi (D46). Varsayılan açık. */
+        importable?: boolean;
+        /** Export menüsü (D46). Varsayılan açık; `false` gizler (ör. yetki). */
+        exportable?: boolean;
+        /** Aşılırsa ilk `maxRows` satır kullanılır ve şerit uyarır (07 §15); yapıştırma ve ekleme bu sınırı aşamaz. */
+        maxRows?: number;
+        /** Bu genişliğin altında veya yalnızca dokunmatikte salt okunur (D14); karar açılışta. */
+        readOnlyBelow?: number;
+    } & {
+        onSave?: ((changes: SheetChanges) => any) | undefined;
+        onExport?: ((payload: {
+            format: "csv" | "xlsx";
+            scope: "all" | "visible";
+            columns: string[];
+            rows: Row[];
+        }) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: ShallowUnwrapRef<{
+        status: ComputedRef<SheetStatus>;
+        isDirty: () => boolean;
+        getChanges: () => SheetChanges;
+        applyResult: (results: Array<SheetRowResult<Row>>) => void;
+        reset: () => void;
+        undo: () => void;
+        redo: () => void;
+        goToNextError: () => void;
+    }>) => void;
+    attrs: any;
+    slots: {
+        empty?: () => unknown;
+    };
+    emit: ((evt: "save", changes: SheetChanges) => void) & ((evt: "export", payload: {
+        format: "csv" | "xlsx";
+        scope: "all" | "visible";
+        columns: string[];
+        rows: Row[];
+    }) => 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 const DataSheet: typeof __VLS_export;
+
+/** 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;
+}
+
+/** 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';
+
+/**
+ * Başlık satırı: ilk 20 satır içinde, boş olmayan hücre sayısı en yüksek ve hücrelerinin çoğu metin olan ilk satır;
+ * eşitlikte ilk boş olmayan satır. Hiç aday yoksa 0.
+ */
+export declare function detectHeaderRow(rows: unknown[][]): number;
+
+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';
+
+/** ISO tarih ("2026-10-24") veya tarih-saat ("2026-10-24T09:42:00Z"). */
+export declare type IsoDate = string;
+
+/**
+ * Otomatik eşleme: başlık normalize edilerek sütunun `header`, `id` ya da `importAliases` değerlerinden biriyle aynıysa
+ * ve yalnızca tek bir sütuna uyuyorsa. Eşleşmeyen ya da birden fazla sütuna uyan başlık haritada yoktur.
+ */
+export declare function matchColumns(headers: string[], columns: Array<Pick<ColumnDef<any>, 'id' | 'header' | 'importAliases'>>): Record<number, string>;
+
+/** `user` filtrelerinde oturumdaki kullanıcı. Sunucuda çözülür. */
+export declare const ME: "@me";
+
+export declare type Messages = Record<string, MessageValue>;
+
+/** Parametreli metinler fonksiyon olabilir. */
+export declare type MessageValue = string | ((params: Record<string, string | number>) => string);
+
+export declare const normalizeHeader: (s: string) => 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';
+
+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 { }