@mari-ui/components 0.0.0-stage → 0.1.1

package/dist/types/input-number/types.d.ts

@@ -0,0 +1,53 @@
+import type React from "react";
+import type { ColorRole, Size } from "@mari-ui/core";
+import type { SkeletonableProps } from "../lib/skeleton";
+import type { InputShape, InputVariant } from "../input/types";
+export interface InputNumberProps extends SkeletonableProps {
+    /** Değer; boş alan `null`. */
+    value?: number | null;
+    defaultValue?: number | null;
+    /**
+     * Her geçerli değişiklikte (yazarken, adımda, temizlenince `null`). Yazarken
+     * min/max dışına çıkan değer de bildirilir; alandan çıkınca (blur/Enter)
+     * sınıra çekilip yeniden bildirilir.
+     */
+    onChange?: (value: number | null) => void;
+    min?: number;
+    max?: number;
+    /** Artır/azalt adımı. Shift ya da PageUp/PageDown ile 10 katı. Varsayılan: `1`. */
+    step?: number;
+    /** Sabit ondalık basamak (ör. para için 2). Verilmezse yazılan kadar. */
+    precision?: number;
+    /** Binlik ayıracı (1.234.567). Varsayılan: `true`. */
+    grouping?: boolean;
+    /** Biçimlendirme yereli. Varsayılan: `"tr-TR"` (virgül ondalık, nokta binlik). */
+    locale?: string;
+    /** Solda sabit metin/ikon, ör. `"₺"`. Ekran okuyucuya değerle birlikte okunur (düz metinse). */
+    prefix?: React.ReactNode;
+    /** Sağda sabit metin/ikon, ör. `"%"`, `"kg"`. */
+    suffix?: React.ReactNode;
+    /** Artır/azalt düğmeleri. Varsayılan: `true`. */
+    controls?: boolean;
+    /** Düğmelerin erişilebilir adları. Varsayılan: "Artır" / "Azalt". */
+    incrementLabel?: string;
+    decrementLabel?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    size?: Size;
+    variant?: InputVariant;
+    shape?: InputShape;
+    /** Doğrulama durumu (`error`/`warning`) ya da vurgu rengi — Input'la aynı kural. */
+    color?: ColorRole;
+    id?: string;
+    name?: string;
+    required?: boolean;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    onBlur?: (e: React.FocusEvent<HTMLInputElement>) => void;
+    onFocus?: (e: React.FocusEvent<HTMLInputElement>) => void;
+    onPressEnter?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    className?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/input-number/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/input-number/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,iDAAiD;IACjD,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,oFAAoF;IACpF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC1D,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/input-number/utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Faz 16.1 — InputNumber'ın saf sayı mantığı (DOM'suz, ayrıca test edilir).
+ *
+ * Neden `type="number"` değil: tarayıcı Türkçe ondalık virgülü ve binlik
+ * ayıracını (1.234,56) göstermez/kabul etmez, min/max'ı yazarken sınırlamaz,
+ * bazı tarayıcılarda harf yazılabilir ve değer boşken `""` ile "geçersiz"i
+ * ayırt ettirmez. Burada metin alanı + kendi ayrıştırma/biçimlendirmemiz var.
+ */
+export interface NumberFormatConfig {
+    locale: string;
+    /** Ondalık basamak sayısı (sabit). Verilmezse değerin kendi basamakları (en fazla 20). */
+    precision?: number;
+    /** Binlik ayıracı. Varsayılan: `true`. */
+    grouping: boolean;
+}
+/** Yerelin ondalık ve binlik karakterleri (tr-TR: "," ve "."). */
+export declare function getSeparators(locale: string): {
+    decimal: string;
+    group: string;
+};
+/** Kayan nokta artıklarını temizleyerek yuvarlar (0.1 + 0.2 → 0.3). */
+export declare function roundTo(value: number, precision: number | undefined): number;
+export declare function clamp(value: number, min: number | undefined, max: number | undefined): number;
+/** Ekranda gösterilen biçim (odak dışı): "1.234,56". */
+export declare function formatNumber(value: number | null, { locale, precision, grouping }: NumberFormatConfig): string;
+/** Düzenlerken gösterilen biçim (odakta): binlik ayıracı yok, yerelin ondalığı — "1234,56". */
+export declare function formatForEditing(value: number | null, config: NumberFormatConfig): string;
+/**
+ * Kullanıcı metnini sayıya çevirir; boş → `null`, anlamsız → `undefined`.
+ *
+ * Türkçede "." binlik, "," ondalıktır — ama kullanıcı alışkanlıkla "12.5"
+ * de yazar. Kural: metinde yerelin ondalığı (",") VARSA "." binlik sayılıp
+ * atılır. Yoksa "." yalnız GEÇERLİ binlik gruplaması gibi duruyorsa
+ * ("1.234", "1.234.567") binlik; aksi halde ("12.5", "3.14") ondalık kabul
+ * edilir.
+ */
+export declare function parseNumber(text: string, locale: string): number | null | undefined;
+/** Yazarken izin verilen karakterler (rakam, işaret, ayraçlar) — harf vb. hiç girmesin. */
+export declare function isAllowedInput(text: string, locale: string): boolean;
+/** `step` adımı sonrası değer: boş alanda min'den (yoksa 0'dan) başlar, sınırlar ve yuvarlar. */
+export declare function stepValue(current: number | null, direction: 1 | -1, step: number, min: number | undefined, max: number | undefined, precision: number | undefined): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/input-number/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/input-number/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMhF;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI5E;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7F;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,MAAM,CAO9G;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAmBnF;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAIpE;AAED,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM1K"}

package/dist/types/lib/AnimationDemo.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+/**
+ * YALNIZ STORY'LER İÇİN — giriş animasyonu (`animated`) olan bileşenlerin
+ * "Animasyon" story'si: "Tekrar oynat" bileşeni yeniden bağlar (key), giriş
+ * animasyonu baştan çalışır. Paket girişlerinden import edilmez.
+ */
+export declare function AnimationDemo({ children, className }: Readonly<{
+    children: React.ReactNode;
+    className?: string;
+}>): React.JSX.Element;
+/** "Animasyon" story'lerinin ortak açıklaması. */
+export declare const ANIMATION_STORY_DOC: string;
+//# sourceMappingURL=AnimationDemo.d.ts.map

package/dist/types/lib/AnimationDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationDemo.d.ts","sourceRoot":"","sources":["../../../src/lib/AnimationDemo.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAIxC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,qBAYjH;AAED,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAE4D,CAAC"}

package/dist/types/lib/ContentSkeleton.d.ts

@@ -0,0 +1,21 @@
+import React from "react";
+export interface ContentSkeletonProps {
+    on: boolean;
+    /** Ölçülecek içerik yoksa (veri henüz gelmedi) gösterilecek genel iskelet. */
+    fallback: React.ReactNode;
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Faz 15.6 — serbest içeriğin (Drawer/Modal gövdesi) KENDİ şeklinde iskeleti.
+ * Gerçek içerik görünmez olarak yerinde çizilir (yükseklik korunur, yüklenince
+ * zıplama olmaz), sonra her metin satırının ve her kontrolün (input, düğme,
+ * checkbox kutusu…) kutusu ölçülüp üstüne bir blok konur. Genel "6 satır
+ * paragraf" iskeleti bir formun yanında yarım kalmış görünüyordu.
+ *
+ * Ölçülecek bir şey yoksa (içerik boş ya da jsdom gibi yerleşimsiz ortam)
+ * `fallback` gösterilir. Boyut değişince (pencere, çekmece genişliği)
+ * `ResizeObserver` ile yeniden ölçülür.
+ */
+export declare function ContentSkeleton({ on, fallback, className, children }: Readonly<ContentSkeletonProps>): React.JSX.Element;
+//# sourceMappingURL=ContentSkeleton.d.ts.map

package/dist/types/lib/ContentSkeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentSkeleton.d.ts","sourceRoot":"","sources":["../../../src/lib/ContentSkeleton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyD,MAAM,OAAO,CAAC;AA8F9E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,8EAA8E;IAC9E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,oBAAoB,CAAC,qBAyCpG"}

package/dist/types/lib/FloatingArrow.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+import type { Side } from "./floating";
+/**
+ * Yüzey renkli yüzen panellerin (Dropdown, Popover, Popconfirm) ortak ölçüleri
+ * ve oku — Faz 16.2'de DropdownContent'ten taşındı.
+ *
+ * Yapısal ölçüler ant.design'ın canlı Dropdown sayfasından `getComputedStyle`
+ * ile alındı: ok yokken tetikleyiciyle panel arasında 4px, okluyken 12px
+ * (8px'lik ok kutusu + 4px); ok, panelin hizalandığı kenardan 12px içeride
+ * başlayan 16px'lik bir kutu, yani ORTASI kenardan 20px. GÖRÜNÜM (gölge,
+ * kenarlık, renk) ant'tan değil kendi token'larımızdan gelir.
+ */
+export declare const FLOATING_GAP_PX = 4;
+export declare const FLOATING_ARROW_GAP_PX = 12;
+export declare const FLOATING_ARROW_INSET_PX = 20;
+/** Panel viewport kenarına YAPIŞMASIN diye bırakılan minimum boşluk. */
+export declare const FLOATING_EDGE_PX = 8;
+export declare function FloatingArrow({ side, offset }: Readonly<{
+    side: Side;
+    offset: number;
+}>): React.JSX.Element;
+//# sourceMappingURL=FloatingArrow.d.ts.map

package/dist/types/lib/FloatingArrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingArrow.d.ts","sourceRoot":"","sources":["../../../src/lib/FloatingArrow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AA2BlC,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,qBAiBvF"}

package/dist/types/lib/SkeletonDemo.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+/**
+ * YALNIZ STORY'LER İÇİN — her bileşenin "İskelet" story'si aynı düzende:
+ * üstte İskelet / Yüklendi geçişi, altta bileşen. İki hal arasında geçince
+ * yerleşimin kaymadığı görülür (Faz 15 sözleşmesi). Paket girişlerinden
+ * import edilmez.
+ */
+export declare function SkeletonDemo({ children, className }: Readonly<{
+    children: (skeleton: boolean) => React.ReactNode;
+    className?: string;
+}>): React.JSX.Element;
+/** "İskelet" story'lerinin ortak açıklaması. */
+export declare const SKELETON_STORY_DOC: string;
+//# sourceMappingURL=SkeletonDemo.d.ts.map

package/dist/types/lib/SkeletonDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkeletonDemo.d.ts","sourceRoot":"","sources":["../../../src/lib/SkeletonDemo.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAGxC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,qBAiBvI;AAED,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,QAEQ,CAAC"}

package/dist/types/lib/SkeletonSlot.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+export interface SkeletonSlotProps {
+    on: boolean;
+    placeholder: React.ReactNode;
+    /**
+     * Bölgenin YÜKLÜ hâldeki akışı: flex bir ebeveynin (aksiyon hücresi, extra)
+     * içeriği flex öğesidir, blok ebeveyninki satır kutusuna girer. Görünmez
+     * kopya aynı akışta çizilmezse yükseklik 3-4px kayar (Card'da ölçüldü).
+     */
+    flow?: "block" | "flex";
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * Faz 15 — iskelette bir bölgeyi yer tutucuya çevirir: gerçek içerik
+ * `invisible` olarak aynı grid hücresinde kalır (yükseklik/genişlik korunur,
+ * tab sırasından çıkar), yer tutucu üstüne biner. İçerik yoksa (veri henüz
+ * gelmedi) kutuyu yer tutucu belirler — her iki durumda da yüklenince zıplama
+ * olmaz. Serbest içerik taşıyan component'lerin (Card, Carousel…) ortak aracı.
+ */
+export declare function SkeletonSlot({ on, placeholder, flow, className, children }: Readonly<SkeletonSlotProps>): React.JSX.Element;
+//# sourceMappingURL=SkeletonSlot.d.ts.map

package/dist/types/lib/SkeletonSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkeletonSlot.d.ts","sourceRoot":"","sources":["../../../src/lib/SkeletonSlot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,iBAAiB,CAAC,qBAQjH"}

package/dist/types/lib/colorClasses.d.ts

@@ -0,0 +1,57 @@
+import { type ColorRole, type ColorVariantStyle } from "@mari-ui/core";
+/**
+ * `@mari-ui/tokens`'ın ürettiği `--color-mari-*` CSS değişkenlerine karşılık
+ * gelen Tailwind utility class'ları.
+ *
+ * ÖNEMLİ: Her class ismi burada HARFİ HARFİNE, literal string olarak
+ * yazılıdır — `` `bg-mari-${role}-solid` `` gibi bir template literal
+ * KULLANILMAZ. Sebebi: Tailwind'in derleme-zamanı tarayıcısı kaynak
+ * dosyanın METNİNİ okur, kodu çalıştırmaz. `${role}` içeren bir satır
+ * çalışma zamanında "bg-mari-primary-solid" olur ama tarayıcı bunu asla
+ * göremez — kaynak metinde hâlâ kesik bir template literal olarak durur.
+ * Bu repoda `Skeleton`/`Tag`/`Loading`'i sessizce bozan hata tam olarak
+ * buydu (bkz. plan Faz 3); burada aynı hatayı tekrarlamamak için tabloyu
+ * elle, tam string'lerle yazıyoruz.
+ */
+export declare const bgSolidClass: Record<ColorRole, string>;
+export declare const bgSolidHoverClass: Record<ColorRole, string>;
+/** Dolgu üzerindeki ikon/anahtar topu, solidContrast ile aynı kontrastı korur. */
+export declare const bgSolidContrastClass: Record<ColorRole, string>;
+export declare const textSolidContrastClass: Record<ColorRole, string>;
+export declare const bgSubtleClass: Record<ColorRole, string>;
+export declare const textSubtleContrastClass: Record<ColorRole, string>;
+export declare const textClass: Record<ColorRole, string>;
+/** `textClass`in `hover:` varyantı — örn. Menu öğelerinde primary rengi SADECE hover metin rengi olarak uygulamak için. */
+export declare const textHoverClass: Record<ColorRole, string>;
+export declare const borderColorClass: Record<ColorRole, string>;
+/** Rolün KENDİ rengiyle (açık `-border` tonuyla değil) çizilen kenarlık — `outline` varyantı bunu kullanır. */
+export declare const borderStrongColorClass: Record<ColorRole, string>;
+/** `bgSubtleClass`in `hover:` varyantı — outline/ghost butonların hover dolgusu. */
+export declare const bgSubtleHoverClass: Record<ColorRole, string>;
+/** `borderColorClass`in `hover:` varyantı. */
+export declare const borderColorHoverClass: Record<ColorRole, string>;
+/** SVG `fill`/`stroke` için — örn. Tooltip'in ok işareti. */
+export declare const fillSolidClass: Record<ColorRole, string>;
+export declare const strokeSolidClass: Record<ColorRole, string>;
+/** `soft` varyantlı yüzeyler (örn. Tooltip'in soft rengi) için — arka planla eşleşsin diye SVG `fill`. */
+export declare const fillSubtleClass: Record<ColorRole, string>;
+export declare const strokeSubtleClass: Record<ColorRole, string>;
+/**
+ * `resolveColorVariant()`'ın döndürdüğü soyut token referanslarını gerçek
+ * Tailwind class'larına çevirir. Web renderer'ının (bu paketin) tek görevi
+ * budur — aynı soyut çıktı, `@mari-ui/native`'de `StyleSheet` objesine
+ * çevrilir.
+ */
+export declare function colorVariantToClassName(style: ColorVariantStyle): string;
+/**
+ * Faz 15 — işaretlenebilir kontroller (Checkbox/Radio) için `checked:` önekli
+ * literal tablolar. Önek runtime'da birleştirilmez (Tailwind taraması).
+ * Kenarlık dolguyla AYNI (`-solid`): eskiden açık `-border` tonuydu, dolu
+ * kutunun etrafında soluk bir hare gibi duruyordu ve 3:1'i geçmiyordu.
+ */
+export declare const checkedBgSolidClass: Record<ColorRole, string>;
+export declare const checkedBgSolidHoverClass: Record<ColorRole, string>;
+export declare const checkedBorderSolidClass: Record<ColorRole, string>;
+/** Radio'nun dış halkası seçiliyken rol rengi (outline varyantı — içi boş, nokta ayrı). */
+export declare const checkedBorderStrongClass: Record<ColorRole, string>;
+//# sourceMappingURL=colorClasses.d.ts.map

package/dist/types/lib/colorClasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorClasses.d.ts","sourceRoot":"","sources":["../../../src/lib/colorClasses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQlD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQvD,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ5D,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQnD,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ7D,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ/C,CAAC;AAEF,2HAA2H;AAC3H,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQpD,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQtD,CAAC;AAEF,+GAA+G;AAC/G,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ5D,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQxD,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ3D,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQpD,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQtD,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQrD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQvD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA2BxE;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQzD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ9D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ7D,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAQ9D,CAAC"}

package/dist/types/lib/date/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Faz 16.5 — Calendar / DatePicker / TimePicker'ın ortak tarih motoru.
+ * Bağımlılık yok: yerel `Date` + `Intl` (varsayılan yerel `tr-TR`). Tüm
+ * hesaplar YEREL saatte; gün karşılaştırmaları saat bileşenini yok sayar.
+ */
+export declare const DEFAULT_LOCALE = "tr-TR";
+/** Haftanın ilk günü: 1 = Pazartesi (Türkiye), 0 = Pazar. */
+export type WeekStart = 0 | 1;
+export declare const startOfDay: (d: Date) => Date;
+export declare const startOfMonth: (d: Date) => Date;
+export declare const daysInMonth: (year: number, month: number) => number;
+export declare function addDays(d: Date, n: number): Date;
+/** Ay ekler; hedef ayda o gün yoksa ayın son gününe çeker (31 Ocak + 1 ay = 28/29 Şubat). */
+export declare function addMonths(d: Date, n: number): Date;
+export declare const addYears: (d: Date, n: number) => Date;
+export declare const isSameDay: (a: Date | null | undefined, b: Date | null | undefined) => boolean;
+export declare const isSameMonth: (a: Date | null | undefined, b: Date | null | undefined) => boolean;
+export declare const isSameYear: (a: Date | null | undefined, b: Date | null | undefined) => boolean;
+/** Gün düzeyinde karşılaştırma: <0, 0, >0. */
+export declare const compareDay: (a: Date, b: Date) => number;
+/** `d`, `a` ile `b` arasında mı (gün düzeyinde, uçlar dahil, sıra fark etmez). */
+export declare function isBetweenDays(d: Date, a: Date, b: Date): boolean;
+export declare function startOfWeek(d: Date, weekStart?: WeekStart): Date;
+export declare const endOfWeek: (d: Date, weekStart?: WeekStart) => Date;
+/** Ay görünümü: her zaman 6 hafta × 7 gün (yükseklik aydan aya zıplamasın). */
+export declare function getMonthGrid(year: number, month: number, weekStart?: WeekStart): Date[][];
+/** ISO 8601 hafta numarası (Pazartesi başlangıç; yılın ilk Perşembesini içeren hafta 1). */
+export declare function getISOWeek(d: Date): number;
+export declare function monthNames(locale?: string, width?: "long" | "short"): string[];
+/** Haftanın günleri, `weekStart`tan başlayarak. */
+export declare function weekdayNames(locale?: string, weekStart?: WeekStart, width?: "long" | "short" | "narrow"): string[];
+/** Ekran okuyucu için tam tarih: "1 Ekim 2026 Perşembe". */
+export declare function fullDateLabel(d: Date, locale?: string): string;
+export declare function formatDate(d: Date, pattern: string, locale?: string): string;
+/**
+ * Sayısal desenle yazılmış metni çözer (ay/gün adı içeren desen çözülmez).
+ * Kesin: 31.02.2026 gibi var olmayan tarih `null`. Desende olmayan alanlar
+ * `reference`tan (varsayılan: bugün 00:00) alınır. Ayraç olarak `.`, `/`, `-`
+ * birbirinin yerine kabul edilir; tek haneli gün/ay (1.2.2026) da olur.
+ */
+export declare function parseDate(text: string, pattern: string, reference?: Date): Date | null;
+/**
+ * ←/→ gün, ↑/↓ hafta, Home/End haftanın başı/sonu, PageUp/PageDown ay
+ * (Shift ile yıl). Tanınmayan tuş → `null`.
+ */
+export declare function dayGridKeyStep(d: Date, key: string, shift: boolean, weekStart?: WeekStart): Date | null;
+/** Ay/yıl ızgarası (3 sütun): ←/→ ±1, ↑/↓ ±3, Home/End satır başı/sonu. Değer bir indekstir. */
+export declare function cellGridKeyStep(index: number, key: string, columns?: number): number | null;
+/** Sınırlar içinde mi (gün düzeyinde). */
+export declare function isWithin(d: Date, min?: Date | null, max?: Date | null): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/date/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/date/index.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/elevationClass.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `foundations/Elevation.mdx`'te vaat edilen tablo: `shadow-mari-*` + ince
+ * `border-mari-border` kombinasyonu birlikte kullanılır. Koyu temada saf
+ * siyah-alfa gölge tek başına neredeyse görünmez — yükseklik hissi asıl
+ * kenarlıktan gelir, gölge sadece üstüne biner. Faz 13 öncesi component'ler
+ * (Card, Carousel) `shadow-md`/`shadow` gibi tokensız Tailwind built-in'lerini
+ * kullanıyordu; bu tablo onların yerini alır.
+ */
+export declare const elevationClass: Record<"sm" | "md" | "lg" | "xl", string>;
+//# sourceMappingURL=elevationClass.d.ts.map

package/dist/types/lib/elevationClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevationClass.d.ts","sourceRoot":"","sources":["../../../src/lib/elevationClass.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,MAAM,CAKpE,CAAC"}

package/dist/types/lib/fieldContext.d.ts

@@ -0,0 +1,61 @@
+import type React from "react";
+import type { ColorRole } from "@mari-ui/core";
+/**
+ * Faz 16.1 — `Field`in içindeki kontrole geçirdiği bağlantılar. `lib`te
+ * duruyor (field/ klasöründe değil) çünkü her kontrol bunu import eder;
+ * tsup ortak parçaya (chunk) koyar, tek bir context örneği olur.
+ */
+export interface FieldContextValue {
+    /** Kontrolün id'si — `<label htmlFor>` buna bağlı. */
+    controlId: string;
+    labelId: string;
+    /** İpucu ve/veya hata metninin id'leri (boşlukla ayrılmış); yoksa `undefined`. */
+    describedBy: string | undefined;
+    invalid: boolean;
+    required: boolean;
+    disabled: boolean;
+    /** Grup kontrolleri (RadioGroup, Segmented, OtpInput) çağırır: etiket `<label for>` değil grubun adı olur. */
+    markGroup: () => void;
+    /** Kontrol kendi `id`sini verdiyse etiketin `htmlFor`u ona dönsün. */
+    setControlId: (id: string | undefined) => void;
+    /** Field iskelette: içindeki kontrol de iskelet çizer (tek prop kuralı). */
+    skeleton: boolean;
+}
+export declare const FieldContext: React.Context<FieldContextValue | null>;
+export interface FieldControlProps {
+    id?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: Exclude<React.AriaAttributes["aria-invalid"], undefined>;
+    required?: boolean;
+    disabled?: boolean;
+    color?: ColorRole;
+    skeleton?: boolean;
+}
+/**
+ * Tek bir alanı olan kontroller (Input, Select, InputNumber…) için. Field
+ * içinde değilse verilen prop'ları olduğu gibi döner. İçindeyse eksikleri
+ * Field'dan tamamlar — kontrole AÇIKÇA verilen prop her zaman kazanır;
+ * `aria-describedby` ise birleştirilir (ikisi de okunsun).
+ */
+export declare function useFieldControl<P extends FieldControlProps>(props: P): P & FieldControlProps;
+/**
+ * Grup kontrolleri (RadioGroup, Segmented, OtpInput, Transfer) için: kontrolün
+ * kendi `skeleton`u verilmediyse Field'ınki geçerli.
+ */
+export declare function useFieldSkeleton(own: boolean | undefined): boolean;
+export interface FieldGroupProps {
+    "aria-labelledby"?: string;
+    "aria-label"?: string;
+    "aria-describedby"?: string;
+    disabled?: boolean;
+}
+/**
+ * Grup kontrolleri için: Field'ın etiketi grubun adı olur (`aria-labelledby`)
+ * — grup tek bir odaklanabilir alan olmadığından `<label htmlFor>` bağlanamaz.
+ * Kontrol kendi `aria-label`/`aria-labelledby`sini verdiyse o kazanır.
+ */
+export declare function useFieldGroup<P extends FieldGroupProps>(props: P, enabled?: boolean): P & FieldGroupProps & {
+    "aria-invalid"?: true;
+    "aria-required"?: true;
+};
+//# sourceMappingURL=fieldContext.d.ts.map

package/dist/types/lib/fieldContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldContext.d.ts","sourceRoot":"","sources":["../../../src/lib/fieldContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,8GAA8G;IAC9G,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,sEAAsE;IACtE,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/C,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,YAAY,yCAAgD,CAAC;AAI1E,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAoB5F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAGlE;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,UAAO,GAAG,CAAC,GAAG,eAAe,GAAG;IAAE,cAAc,CAAC,EAAE,IAAI,CAAC;IAAC,eAAe,CAAC,EAAE,IAAI,CAAA;CAAE,CAc1J"}

package/dist/types/lib/floating.d.ts

@@ -0,0 +1,46 @@
+import type { Placement } from "@mari-ui/core";
+/**
+ * Yüzen paneller (Dropdown, Tooltip) için ortak konumlandırma — Faz 15'te
+ * `dropdown/utils.ts`'ten taşındı; Tooltip'in kendi 4-yönlü, kıstırmasız
+ * hesabının yerini aldı (mobilde ekrandan taşıyordu).
+ */
+export type Side = "top" | "bottom" | "left" | "right";
+type Align = "start" | "center" | "end";
+/** 12 değerli `Placement`i ana yön + hizaya ayırır (`bottom-end` → `{ side: "bottom", align: "end" }`). */
+export declare function parsePlacement(placement: Placement): {
+    side: Side;
+    align: Align;
+};
+export interface Box {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export interface ArrowOptions {
+    /** Okun ORTASININ panelin hizalandığı kenardan uzaklığı (ant.design: 12px kenar boşluğu + 8px yarım genişlik). */
+    inset: number;
+    /** `true`: panel, okun ortası TETİKLEYİCİNİN ortasına gelecek şekilde kayar (ant.design `arrow.pointAtCenter`). */
+    pointAtCenter: boolean;
+}
+/**
+ * Panelin sol-üst köşesinin (viewport koordinatlarında) nereye gelmesi
+ * gerektiğini hesaplar: tercih edilen yönde sığmıyor ama karşı yönde
+ * sığıyorsa yönü çevirir (flip), sonra iki eksende de viewport içinde
+ * kelepçeler. `side` (flip sonrası gerçek yön) ve `arrowOffset` (okun ortasının
+ * panelin kenarı boyunca konumu) da döner. Saf fonksiyon — DOM'a dokunmaz.
+ */
+export declare function computePanelPosition(anchor: Box, panel: {
+    width: number;
+    height: number;
+}, placement: Placement, viewport: {
+    width: number;
+    height: number;
+}, gap: number, edge: number, arrow?: ArrowOptions): {
+    top: number;
+    left: number;
+    side: Side;
+    arrowOffset: number;
+};
+export {};
+//# sourceMappingURL=floating.d.ts.map

package/dist/types/lib/floating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating.d.ts","sourceRoot":"","sources":["../../../src/lib/floating.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AACvD,KAAK,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExC,2GAA2G;AAC3G,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAGjF;AAID,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,kHAAkH;IAClH,KAAK,EAAE,MAAM,CAAC;IACd,mHAAmH;IACnH,aAAa,EAAE,OAAO,CAAC;CACxB;AASD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,GAAG,EACX,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,YAAY,GACnB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA4DhE"}

package/dist/types/lib/infiniteScroll.d.ts

@@ -0,0 +1,36 @@
+import React from "react";
+/**
+ * Faz 16.3 — List ve Masonry'nin ortak sonsuz kaydırma sözleşmesi.
+ *
+ * Erişilebilirlik: yalnız kaydırmaya bağlı yükleme klavye kullanıcısını
+ * sayfa sonuna (alt bilgiye) hiç ulaştırmayabilir. Bu yüzden işaretçinin
+ * yanında her zaman odaklanabilir bir "Daha fazla yükle" düğmesi de olur
+ * (fare kullanıcısı için kendiliğinden, klavye için düğmeyle). Yükleme ve
+ * "hepsi bu kadar" durumu `role="status"` ile duyurulur.
+ */
+export interface InfiniteScrollOptions {
+    /** Yüklenecek kayıt kaldı mı. `false` olunca işaretçi kalkar, `endMessage` görünür. */
+    hasMore: boolean;
+    /** Sonraki sayfa yüklenirken `true` verin — bu sırada yeni istek tetiklenmez. */
+    loading?: boolean;
+    /** Liste sonu görünüme girince (ya da düğmeyle) çağrılır. */
+    onLoadMore: () => void;
+    /** İşaretçinin görünüme ne kadar erken sayılacağı. Varsayılan: `"200px"` (sona gelmeden yükler). */
+    rootMargin?: string;
+    /** Tüm kayıtlar yüklenince. Varsayılan: "Hepsi bu kadar". `null` gizler. */
+    endMessage?: React.ReactNode;
+    /** Düğme metni. Varsayılan: "Daha fazla yükle". */
+    loadMoreLabel?: string;
+}
+/**
+ * İşaretçi görünüme girince `onLoadMore`. Yükleme bitip işaretçi hâlâ
+ * görünürse (içerik ekranı doldurmadıysa) gözlem yeniden kurulur ve bir
+ * sonraki sayfa da istenir — ekran dolana kadar.
+ */
+export declare function useInfiniteScroll(sentinel: React.RefObject<HTMLElement | null>, { hasMore, loading, onLoadMore, rootMargin }: InfiniteScrollOptions): void;
+/** Liste sonu: gözlenen işaretçi + durum + klavye için düğme. */
+export declare function InfiniteScrollFooter({ options, className }: Readonly<{
+    options: InfiniteScrollOptions;
+    className?: string;
+}>): React.JSX.Element;
+//# sourceMappingURL=infiniteScroll.d.ts.map

package/dist/types/lib/infiniteScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infiniteScroll.d.ts","sourceRoot":"","sources":["../../../src/lib/infiniteScroll.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAIjD;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,OAAe,EAAE,UAAU,EAAE,UAAoB,EAAE,EAAE,qBAAqB,QAcrK;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC;IAAE,OAAO,EAAE,qBAAqB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,qBA8B5H"}

package/dist/types/lib/linkBehavior.d.ts

@@ -0,0 +1,38 @@
+import React from "react";
+/** HTML `target` değerleri; isimli bir çerçeve/pencere adı da verilebilir. */
+export type LinkTarget = "_self" | "_blank" | "_parent" | "_top" | (string & {});
+/**
+ * Faz 15.5 — bir linkin router'a (`onNavigate`) devredilip devredilmeyeceğini
+ * belirleyen ortak alanlar (menü öğeleri, Breadcrumb, DropdownItem).
+ */
+export interface LinkBehaviorProps {
+    /** Linkin açılacağı yer. `_blank` → yeni sekme (`rel="noopener noreferrer"` otomatik). */
+    target?: LinkTarget;
+    /**
+     * Aynı sekmede ama router'ı ATLAYARAK tam sayfa yükleme: `onNavigate`
+     * verilmiş olsa bile tarayıcı sayfayı baştan yükler. Aynı domain'de ama
+     * uygulamanın parçası olmayan sayfalar (`/blog` ayrı bir site) ya da
+     * sunucunun yönlendirdiği adresler (`/logout`) için.
+     */
+    reloadDocument?: boolean;
+}
+/** `https:`, `mailto:`, `tel:` gibi şemalı ya da `//` ile başlayan adresler — router bunlara gidemez. */
+export declare function isExternalHref(href: string): boolean;
+/** Bu link tarayıcıya mı bırakılmalı (router'a devredilmemeli)? */
+export declare function bypassesRouter(href: string, { target, reloadDocument }: LinkBehaviorProps): boolean;
+/** Değiştirici tuşsuz, sol tuşla yapılan tıklama — yalnızca bu router'a devredilir (⌘/Ctrl/Shift/orta tık tarayıcının). */
+export declare function isPlainLeftClick(event: React.MouseEvent): boolean;
+/** `<a>`ya yayılacak `target` + `rel` (yeni bağlamda açılan linkler açanın `window.opener`ına erişemesin). */
+export declare function getLinkAttrs(target: LinkTarget | undefined): {
+    target?: string;
+    rel?: string;
+};
+/**
+ * Yeni sekmede açılan linkin görsel + sesli işareti: küçük bir dış bağlantı
+ * ikonu ve ekran okuyucu için "(yeni sekmede açılır)". WCAG 3.2.5 — bağlam
+ * değişikliği önceden bildirilmeli.
+ */
+export declare function NewTabHint({ target }: Readonly<{
+    target?: LinkTarget;
+}>): React.JSX.Element | null;
+//# sourceMappingURL=linkBehavior.d.ts.map

package/dist/types/lib/linkBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkBehavior.d.ts","sourceRoot":"","sources":["../../../src/lib/linkBehavior.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAEnG;AAED,2HAA2H;AAC3H,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,GAAG,OAAO,CAEjE;AAED,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAG9F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,4BAQvE"}

package/dist/types/lib/overlay.d.ts

@@ -0,0 +1,55 @@
+import { type RefObject } from "react";
+/**
+ * Kenardan açılan modal katmanların (Drawer, NavDrawer) ortak davranışı.
+ * Faz 13.6'dan önce bu mantık yalnız `menu/_shared/NavDrawer.tsx`'te vardı;
+ * `Drawer`da HİÇBİRİ yoktu (odak tuzağı, Escape, kaydırma kilidi, portal) —
+ * kapalı Drawer DOM'da kalıyor, içindeki düğmeler Tab ile odaklanabiliyordu.
+ * Artık tek yerde.
+ */
+export declare const FOCUSABLE_SELECTOR = "button:not([disabled]), a[href], input:not([disabled]):not([type=\"hidden\"]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";
+/**
+ * Gerçekten odaklanabilen öğeler. `aria-hidden`/`inert` bir atanın içindekiler
+ * elenir: iskelette gerçek içerik `SkeletonSlot` ile görünmez kopya olarak
+ * DOM'da kalır (`visibility: hidden` → `focus()` sessizce başarısız olur);
+ * bunlar sayılırsa odak tuzağının ilk/son öğesi görünmez bir düğme olur ve
+ * Tab takılır.
+ */
+export declare function getFocusables(root: ParentNode): HTMLElement[];
+export declare function firstFocusable(root: ParentNode): HTMLElement | null;
+/** Öğe var ve iskeletin görünmez kopyasında (aria-hidden/inert) değilse kendisi. */
+export declare function reachable(el: HTMLElement | null | undefined): HTMLElement | null;
+/**
+ * İskelet → içerik geldi: iskelette odak "Kapat"a (ya da panele) düşer;
+ * içerik gelince odak hâlâ orada ise normal ilk odağa taşınır. Kullanıcı
+ * bu arada odağı başka yere taşıdıysa dokunulmaz.
+ */
+export declare function useRefocusAfterSkeleton(open: boolean, skeleton: boolean, panelRef: RefObject<HTMLElement | null>, getInitialFocus: (panel: HTMLElement) => HTMLElement | null | undefined, closeSelector: string): void;
+/**
+ * Açılışta hemen mount; kapanışta `exitMs` (çıkış animasyonu) bitince
+ * unmount. `mounted` false iken hiç render etmeyin.
+ */
+export declare function usePresence(open: boolean, exitMs: number): boolean;
+export interface ModalBehaviorOptions {
+    /** Escape kapatsın mı. Varsayılan: `true`. */
+    closeOnEscape?: boolean;
+    /** Sayfa kaydırmasını kilitle. Varsayılan: `true`. */
+    lockScroll?: boolean;
+    /**
+     * Açılışta odaklanacak öğeyi seçer. Verilmezse: `[data-autofocus]` → ilk
+     * odaklanabilir → panelin kendisi.
+     */
+    getInitialFocus?: (panel: HTMLElement) => HTMLElement | null | undefined;
+}
+/** `[data-autofocus]` — kendisi odaklanabilir değilse (bileşen data-* iletmiyorsa) içindeki ilk odaklanabilir. */
+export declare function findAutofocus(root: ParentNode): HTMLElement | null;
+/**
+ * Açıkken:
+ * - sayfa kaydırması kilitlenir (kaydırma çubuğu genişliği kadar sağ dolgu
+ *   eklenir — kilitlenince içerik yana kaymasın),
+ * - odak panelin ilk odaklanabilir öğesine (yoksa panelin kendisine) taşınır
+ *   ve Tab/Shift+Tab ile panel içinde döner,
+ * - Escape `onClose` çağırır,
+ * - kapanınca odak açılıştan önceki öğeye (genelde tetikleyici) döner.
+ */
+export declare function useModalBehavior(open: boolean, panelRef: RefObject<HTMLElement | null>, onClose: () => void, { closeOnEscape, lockScroll, getInitialFocus }?: ModalBehaviorOptions): void;
+//# sourceMappingURL=overlay.d.ts.map