@handijit/ui 0.0.0-stage → 1.0.0

package/build/types/hook.type.d.ts

@@ -0,0 +1,36 @@
+import { KeyboardEvent, RefObject } from 'react';
+export type VirtualRange = {
+    /** Çizilecek ilk öğenin dizini. */
+    start: number;
+    /** Çizilecek son öğenin dizini (dahil DEĞİL). */
+    end: number;
+    /** Listenin gerçek toplam yüksekliği — kaydırma çubuğu doğru boyda olmalı. */
+    totalHeight: number;
+    /** Görünen ilk öğenin üstünde bırakılacak boşluk. */
+    offset: number;
+};
+/** Duyurunun aciliyeti. */
+export type AnnouncePoliteness = 'polite' | 'assertive';
+export type ListboxNavigation<T extends HTMLElement = HTMLElement> = {
+    activeIndex: number;
+    setActiveIndex: (index: number) => void;
+    /** Etkin seçeneği görünür alanda tutmak için LİSTEYE bağlanır. */
+    listRef: RefObject<T | null>;
+    handleKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
+};
+export type ListboxNavigationOptions = {
+    /** Seçenek sayısı. */
+    count: number;
+    isOpen: boolean;
+    /** Açılışta etkin olacak dizin — genellikle seçili olan. */
+    initialIndex?: number;
+    /** `Enter` / `Space` ile seçildiğinde. */
+    onSelect: (index: number) => void;
+    onClose: () => void;
+};
+export type StickToBottom = {
+    /** Kutu sonda mı (pay dahilinde). `false` iken "en yeniye in" düğmesi gösterilir. */
+    isAtEnd: boolean;
+    /** Sona kaydırır ve yeniden yapışır. */
+    scrollToEnd: () => void;
+};

package/build/types/link.type.d.ts

@@ -0,0 +1,14 @@
+import { AnchorHTMLAttributes, ComponentType, ReactNode } from 'react';
+/** Kütüphanenin bir bağlantı bileşenine geçirdiği props. */
+export type UiLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    children?: ReactNode;
+    [key: string]: unknown;
+};
+/** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
+export type UiLinkComponent = ComponentType<UiLinkProps>;
+/**
+ * Bileşenden yönlendiriciye geçirilecek ek props.
+ * @example // Next.js App Router: sayfa numarasına basınca liste yukarı sıçramasın.…
+ */
+export type UiLinkExtraProps = Record<string, unknown>;

package/build/types/positioning.type.d.ts

@@ -0,0 +1,38 @@
+export type PositioningRect = {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+};
+export type PositioningState = {
+    /** Yüzeye uygulanacak stil — `position: fixed` + hesaplanmış koordinat. */
+    style: {
+        position: 'fixed';
+        top: number;
+        left: number;
+    };
+    /** ÇÖZÜLMÜŞ kenar: çarpışma yüzünden tercih edilenin karşıtı olabilir. */
+    side: PositionSide;
+    /**
+     * Tetikleyicinin ölçülen genişliği (px) — açılır listeler panelin genişliğini buna bağlıyor.
+     * ⚠ ÖLÇÜM BURADA, ÇAĞIRANDA DEĞİL. `Combobox` ve `Select` bu değeri render sırasında
+     * `triggerRef.current?.offsetWidth` ile okuyordu
+     */
+    anchorWidth: number;
+    /** İlk ölçüm yapıldı mı. */
+    isPositioned: boolean;
+};
+export type PositioningOptions = {
+    side?: PositionSide;
+    align?: PositionAlign;
+    /** Tetikleyici ile yüzey arasındaki boşluk (px). */
+    offset?: number;
+    /** Görünüm alanının kenarından bırakılacak asgari pay (px). */
+    padding?: number;
+    /** Kapalıyken ölçüm yapılmaz ve dinleyici kurulmaz. */
+    isOpen: boolean;
+};
+/** Tercih edilen kenar boyunca hizalama. */
+export type PositionAlign = 'start' | 'center' | 'end';
+/** Yüzeyin tercih ettiği kenar. */
+export type PositionSide = 'top' | 'bottom' | 'left' | 'right';

package/build/types/theme/palette.d.ts

@@ -0,0 +1,219 @@
+/**
+ * HAM PALET — kütüphanenin TEK hex kaynağı; değerler OKLCH'te türetilir.
+ * ⚠ ÜRETİLMİŞ DOSYA: `scripts/lib/palette-recipe.mjs` tarifini değiştir, `npm run tokens`.
+ * ⚠ Dört ankor sabit: marka için `pine` / `mint`, nötr eksen için `ink` / `canvas`.
+ *   Geri kalan her şey onlardan türer.
+ */
+/**
+ * MARKA — kılavuzun iki ankoru ve arayüzün mürekkebi.
+ * ⚠ `mint` AÇIK ZEMİNDE METİN OLAMAZ (krem üzerinde 1,24:1).
+ */
+export declare const BRAND: {
+    readonly pine: "#00322a";
+    readonly mint: "#43ff9c";
+    readonly ink: "#141413";
+};
+/**
+ * KURUMSAL YARDIMCI RENKLER — kâğıt / slate / sis, MARKA EKSENİNDE.
+ * ⚠ Yalnızca marka şeridinde (`band-*`) yaşar; arayüz nötrleri sıcak mürekkep merdivenidir.
+ */
+export declare const CORPORATE: {
+    readonly paper: "#e9f7ed";
+    readonly slate: "#325a4d";
+    readonly mist: "#8abaa1";
+};
+/**
+ * NÖTR EKSEN — SICAK MÜREKKEP: açık uç krem kâğıt (`n25` = canvas), koyu uç siyah (`n900` = ink).
+ * ⚠ Marka ekseninde DEĞİL: 4.x'te öyleydi ve arayüzün her yüzeyi yeşil çiziliyordu.
+ * ⚠ `n0` kartın zemini — sayfadan bir kademe açık, saf beyaz değil.
+ */
+export declare const NEUTRAL: {
+    readonly n0: "#fffefc";
+    readonly n25: "#faf9f5";
+    readonly n50: "#f5f0e8";
+    readonly n100: "#efe9de";
+    readonly n150: "#e8e0d3";
+    readonly n200: "#e4dfd8";
+    readonly n250: "#ded8d0";
+    readonly n300: "#d0c8bd";
+    readonly n400: "#b4b1a9";
+    readonly n500: "#8e8b82";
+    readonly n550: "#67655e";
+    readonly n600: "#4d4b46";
+    readonly n700: "#3d3d3a";
+    readonly n800: "#252523";
+    readonly n900: "#141413";
+};
+/** BANT — üst bant, alt bilgi, tablo başlıkları ve BİRİNCİL EYLEM; tabanı `pine`. */
+export declare const BAND: {
+    readonly base: "#00322a";
+    readonly two: "#154c3d";
+    readonly three: "#225f4d";
+    readonly dark: "#00322a";
+    readonly darkLine: "#143f34";
+    readonly fgThree: "#79a790";
+};
+/**
+ * KOYU TEMA YÜZEYLERİ — sıcak siyah.
+ * ⚠ Kademeler arası fark bilinçle küçük (1,03-1,14:1); derinliği kenarlık kurar.
+ */
+export declare const SURFACE_DARK: {
+    readonly page: "#141413";
+    readonly surface: "#181715";
+    readonly surfaceTwo: "#1f1e1b";
+    readonly surfaceThree: "#2a2925";
+    readonly inset: "#0e0e0d";
+    readonly border: "#33312d";
+    readonly borderStrong: "#4a4843";
+    readonly text: "#faf9f5";
+    readonly textTwo: "#b4b1a9";
+    readonly textThree: "#8e8b82";
+    readonly actionSoft: "#4a4843";
+};
+/**
+ * BİRİNCİL EYLEMİN SINIRI — dolgunun kendisi değil, KENARI.
+ * ⚠ Koyu temada çam dolgu kaybolur; mint saç çizgisi grafik eşiğini her zeminde geçer.
+ */
+export declare const ACTION_LINE: {
+    readonly light: "#00322a";
+    readonly dark: "#43ff9c";
+};
+/**
+ * DÖNÜŞÜM EYLEMİ ("sepete ekle") — ekrandaki tek PARLAK yeşil.
+ * ⚠ Birincil eylemden ayrımı TON AÇISI DEĞİL AYDINLIK.
+ * ⚠ Etkileşim yönü açık temada TERS: hover AÇILIR, active KOYULUR.
+ */
+export declare const CART: {
+    readonly base: "#1ba055";
+    readonly hover: "#20b360";
+    readonly active: "#19934e";
+    readonly soft: "#84cb97";
+    readonly dark: "#37c971";
+    readonly darkHover: "#4cdd82";
+    readonly darkActive: "#30b464";
+    readonly darkSoft: "#466e51";
+    readonly on: "#021407";
+};
+/**
+ * BAĞLANTI VE ODAK — 4.x `role` ailesinin yeşil kalan yarısı.
+ * ⚠ Seçim, ilerleme, onay kutusu ve anahtar bu aileyi KULLANMAZ; mürekkep merdivenindedir.
+ * ⚠ TON AÇISI GÖZLE ÖLÇÜLDÜ: H 162 ilk kesin yeşil, yukarı çekilmez.
+ */
+export declare const LINK: {
+    readonly base: "#1f7b56";
+    readonly hover: "#176446";
+    readonly text: "#17704e";
+    readonly dark: "#60d4a1";
+    readonly darkHover: "#76eab5";
+};
+/** ANKORLAR — halka ve vurgu renklerinin türediği iki uç. */
+export declare const ANCHOR: {
+    readonly red: "#de1b2c";
+    readonly green: "#18904c";
+};
+/**
+ * DURUM AİLELERİ — altı aile tek şablondan çıkar; değişen tek şey ton açısı.
+ * ⚠ TINT ZEMİNLERİ AYDINLIKTA BİR KADEME DÜŞÜK: L .95'te chroma çok küçük.
+ */
+export declare const STATUS: {
+    readonly okBg: "#c2f6cf";
+    readonly okFg: "#166e3a";
+    readonly okLine: "#7eda99";
+    readonly okBgDark: "#132d1b";
+    readonly okFgDark: "#56d682";
+    readonly okLineDark: "#2c5137";
+    readonly warnBg: "#f9dcb9";
+    readonly warnFg: "#7c5212";
+    readonly warnLine: "#e8b97f";
+    readonly warnBgDark: "#322311";
+    readonly warnFgDark: "#eeaa4c";
+    readonly warnLineDark: "#594327";
+    readonly offBg: "#dcdad6";
+    readonly offFg: "#5b5851";
+    readonly offLine: "#c5c2bb";
+    readonly offBgDark: "#2f2e2a";
+    readonly offFgDark: "#bcb9b0";
+    readonly offLineDark: "#494743";
+    readonly badBg: "#f9d8d5";
+    readonly badFg: "#a91922";
+    readonly badLine: "#e9b3ae";
+    readonly badBgDark: "#431514";
+    readonly badFgDark: "#f2a099";
+    readonly badLineDark: "#732f2c";
+    readonly oemBg: "#a7f7c8";
+    readonly oemFg: "#0c5d3a";
+    readonly oemLine: "#6ace97";
+    readonly oemBgDark: "#0f291b";
+    readonly oemFgDark: "#43c485";
+    readonly oemLineDark: "#224b35";
+    readonly altBg: "#e5dcf9";
+    readonly altFg: "#751dc8";
+    readonly altLine: "#c9bae7";
+    readonly altBgDark: "#2e184c";
+    readonly altFgDark: "#c3aaf1";
+    readonly altLineDark: "#533281";
+};
+/** YIKICI EYLEM DOLGUSU — üzerine açık metin gelir, aydınlığı bu yüzden sınırlı. */
+export declare const DANGER_SOLID: {
+    readonly base: "#c21625";
+    readonly hover: "#a2111d";
+    readonly dark: "#f53039";
+    readonly darkHover: "#f26a64";
+    readonly onDark: "#1b0102";
+};
+/** İKON VURGUSU — WCAG 1.4.11, 3:1 grafik eşiği; metin katmanından bir kademe açık. */
+export declare const ACCENT: {
+    readonly red: "#de1b2c";
+    readonly redDark: "#f64f4e";
+    readonly green: "#18904c";
+    readonly greenDark: "#37c971";
+    readonly greenHover: "#12783e";
+    readonly greenHoverDark: "#4cdd82";
+    readonly onGreen: "#021407";
+};
+/** İNDİRİM ETİKETİ — olumlu durum ailesiyle aynı; ayrı bir yeşil değil. */
+export declare const SALE: {
+    readonly bg: "#c2f6cf";
+    readonly fg: "#166e3a";
+    readonly bgDark: "#132d1b";
+    readonly fgDark: "#56d682";
+};
+/** YILDIZ ALTINI — puan sayısının yanında durduğu için metin eşiğini de geçer. */
+export declare const STAR: {
+    readonly light: "#846310";
+    readonly dark: "#ebb737";
+};
+/**
+ * KATEGORİK PALET — grafik serileri ve kategori işaretleri.
+ * ⚠ Marka yeşilleri seri rengi OLMAZ; `cat3` orta aydınlıkta bir kategori yeşili.
+ */
+export declare const CATEGORY: {
+    readonly cat1: "#2774cd";
+    readonly cat1Dark: "#7eaeeb";
+    readonly cat2: "#b75225";
+    readonly cat2Dark: "#ec8f6b";
+    readonly cat3: "#2c8761";
+    readonly cat3Dark: "#58c393";
+    readonly cat4: "#8b7126";
+    readonly cat4Dark: "#c7a74f";
+    readonly cat5: "#c02f8f";
+    readonly cat5Dark: "#ed81c1";
+    readonly series2: "#8f3beb";
+    readonly series2Dark: "#b699eb";
+};
+/**
+ * SÖZDİZİMİ — `CodeBlock`ın vurgulayıcısı; kategorik tonlar METİN aydınlığında (≥4,5:1).
+ * ⚠ Yeşil yok: fark satırının yeşili bir durum (`ok-fg`), sözdizimi rengi değil.
+ */
+export declare const SYNTAX: {
+    readonly keyword: "#a4277a";
+    readonly keywordDark: "#f691cc";
+    readonly string: "#9d451f";
+    readonly stringDark: "#f59e7c";
+    readonly number: "#7b2dcd";
+    readonly numberDark: "#c2a7f5";
+    readonly name: "#2063b0";
+    readonly nameDark: "#8dbaf5";
+    readonly type: "#76611f";
+    readonly typeDark: "#d9b341";
+};

package/build/types/theme/tokens.d.ts

@@ -0,0 +1,225 @@
+import { UiFonts } from '@/types/theme.type';
+/** AÇIK TEMA — varsayılan. */
+export declare const LIGHT_THEME: {
+    readonly page: "#faf9f5";
+    readonly surface: "#fffefc";
+    readonly 'surface-2': "#efe9de";
+    readonly 'surface-3': "#e8e0d3";
+    /** Girinti sayfanın ALTINA iner (arama kutusu, kod bloğu, pasif girdi). */
+    readonly 'surface-inset': "#f5f0e8";
+    readonly border: "#ded8d0";
+    readonly 'border-strong': "#d0c8bd";
+    readonly text: "#141413";
+    readonly 'text-2': "#4d4b46";
+    readonly 'text-3': "#67655e";
+    readonly shell: "#181715";
+    readonly 'shell-2': "#1f1e1b";
+    readonly 'shell-3': "#2a2925";
+    readonly 'on-shell': "#faf9f5";
+    readonly 'on-shell-2': "#b4b1a9";
+    /** Mürekkep üzerinde hata metni (terminalin stderr'i). Açık temanın `bad-fg`i burada 2:1'in altında. */
+    readonly 'on-shell-danger': "#f2a099";
+    /** Koyu temada kabuk sayfadan 1,03:1 ayrışıyor; görünür kılan bu çizgi. */
+    readonly 'shell-line': "#33312d";
+    readonly action: "#00322a";
+    readonly 'action-hover': "#154c3d";
+    readonly 'action-active': "#225f4d";
+    readonly 'on-action': "#fffefc";
+    /** Dolgunun SINIRI; açık temada dolgunun kendisi (bkz. `ACTION_LINE`). */
+    readonly 'action-line': "#00322a";
+    /** Pasif dolgu; saydamlık DEĞİL kendi rengi (bkz. */
+    readonly 'action-soft': "#d0c8bd";
+    /** PASİF DOLGU ÜZERİNDEKİ METİN. */
+    readonly 'on-action-soft': "#3d3d3a";
+    readonly cart: "#1ba055";
+    readonly 'cart-hover': "#20b360";
+    readonly 'cart-active': "#19934e";
+    readonly 'cart-soft': "#84cb97";
+    readonly 'on-cart': "#021407";
+    readonly selected: "#141413";
+    readonly 'selected-hover': "#252523";
+    readonly 'selected-active': "#3d3d3a";
+    readonly 'on-selected': "#faf9f5";
+    /** Seçili satır / seçenek zemini — kenarlık ya da işaretle BİRLİKTE (seçim yalnız zeminle verilmez). */
+    readonly 'selected-tint': "#e8e0d3";
+    readonly 'selected-line': "#141413";
+    readonly link: "#17704e";
+    readonly 'link-hover': "#176446";
+    readonly 'ok-bg': "#c2f6cf";
+    readonly 'ok-fg': "#166e3a";
+    readonly 'ok-line': "#7eda99";
+    readonly 'warn-bg': "#f9dcb9";
+    readonly 'warn-fg': "#7c5212";
+    readonly 'warn-line': "#e8b97f";
+    readonly 'off-bg': "#dcdad6";
+    readonly 'off-fg': "#5b5851";
+    readonly 'off-line': "#c5c2bb";
+    readonly 'bad-bg': "#f9d8d5";
+    readonly 'bad-fg': "#a91922";
+    readonly 'bad-line': "#e9b3ae";
+    readonly 'oem-bg': "#a7f7c8";
+    readonly 'oem-fg': "#0c5d3a";
+    readonly 'oem-line': "#6ace97";
+    readonly 'alt-bg': "#e5dcf9";
+    readonly 'alt-fg': "#751dc8";
+    readonly 'alt-line': "#c9bae7";
+    readonly 'sale-bg': "#c2f6cf";
+    readonly 'sale-fg': "#166e3a";
+    readonly 'red-accent': "#de1b2c";
+    readonly 'green-accent': "#18904c";
+    readonly 'green-accent-hover': "#12783e";
+    readonly 'on-green': "#021407";
+    readonly star: "#846310";
+    readonly 'danger-solid': "#c21625";
+    readonly 'danger-solid-hover': "#a2111d";
+    readonly 'on-danger': "#fffefc";
+    readonly 'nav-bg': "#faf9f5";
+    readonly 'nav-bg-2': "#efe9de";
+    readonly 'nav-fg': "#141413";
+    readonly 'nav-fg-2': "#4d4b46";
+    readonly 'nav-fg-3': "#67655e";
+    readonly 'nav-line': "#e4dfd8";
+    readonly 'nav-line-strong': "#d0c8bd";
+    readonly 'nav-hover': "#efe9de";
+    readonly 'footer-bg': "#efe9de";
+    readonly 'band-bg': "#00322a";
+    readonly 'band-fg': "#e9f7ed";
+    readonly 'band-fg-2': "#8abaa1";
+    /**
+     * Bandın ÜÇÜNCÜ metin kademesi ve imza vurgusu. Panelin kenar çubuğu rayı bu ikisini bir dönem
+     * SABİT HEX olarak taşıyordu (`#799a8f`, `#43ff9c`)
+     */
+    readonly 'band-fg-3': "#79a790";
+    readonly 'band-accent': "#43ff9c";
+    readonly 'band-line': "#143f34";
+    readonly 'band-hover': string;
+    readonly 'shadow-xs': `0 1px 2px ${string}`;
+    readonly 'shadow-sm': `0 1px 2px ${string}, 0 1px 3px ${string}`;
+    readonly 'shadow-md': `0 2px 4px ${string}, 0 6px 16px ${string}`;
+    readonly 'shadow-lg': `0 4px 8px ${string}, 0 16px 32px ${string}`;
+    readonly 'shadow-xl': `0 8px 16px ${string}, 0 28px 56px ${string}`;
+    /** Yapışkan alt bar; gölge YUKARI düşer. */
+    readonly 'shadow-up': `0 -2px 4px ${string}, 0 -8px 24px ${string}`;
+    /** Odak halkası BAĞLANTI YEŞİLİ: odak bir gezinme olayıdır. Çam DEĞİL — birincil dolguyla aynı ton. */
+    readonly ring: `0 0 0 3px ${string}`;
+    readonly 'ring-color': "#1f7b56";
+    readonly 'ring-danger': `0 0 0 3px ${string}`;
+    readonly 'ring-ok': `0 0 0 4px ${string}`;
+    readonly scrim: string;
+    readonly 'scrim-soft': string;
+    readonly glass: string;
+    readonly 'glass-solid': "#fffefc";
+    readonly 'on-scrim': "#fffefc";
+    readonly 'skeleton-a': "#efe9de";
+    readonly 'skeleton-b': "#faf9f5";
+    readonly track: string;
+    /** Görsel yer tutucu (medya yoksa). */
+    readonly 'media-bg': "#efe9de";
+    readonly 'glow-1': string;
+    readonly 'glow-2': string;
+    readonly 'glow-cart': string;
+    readonly 'cat-1': "#2774cd";
+    readonly 'cat-2': "#b75225";
+    readonly 'cat-3': "#2c8761";
+    readonly 'cat-4': "#8b7126";
+    readonly 'cat-5': "#c02f8f";
+    readonly 'series-1': "#252523";
+    readonly 'series-2': "#8f3beb";
+};
+/** KOYU TEMA. */
+export declare const DARK_THEME: Record<keyof typeof LIGHT_THEME, string>;
+/**
+ * SÖZDİZİMİ TOKEN'LARI — `CodeBlock`ın vurgulayıcısı. Kategorik tonlar METİN aydınlığında: kod
+ * gövdesinde (`surface-inset`) ve üç yüzeyde ≥4,5:1. Yorum `text-3`, noktalama `text-2` — ayrı
+ * token değil. `syntax-name`: işlev çağrısı, özellik/anahtar, öznitelik, değişken.
+ * ⚠ Temaya bağlı ama ANA TABLODA DEĞİL. Yalnızca sohbet girişi kullanıyor; `LIGHT_THEME`e
+ * girdiklerinde çalışma zamanı tablosuyla HER bileşenin paketine biniyorlardı (ölçüldü: yalnızca
+ * `Button` alan uygulama 5,12 → 5,28 kB, `styles.css` +0,1 kB). Değişkenleri `chat.css` taşır
+ * (`_syntax.generated.scss`); ezme CSS'te (`--ui-syntax-*`), `UiProvider theme`inde değil.
+ */
+export declare const SYNTAX_LIGHT_THEME: {
+    readonly 'syntax-keyword': "#a4277a";
+    readonly 'syntax-string': "#9d451f";
+    readonly 'syntax-number': "#7b2dcd";
+    readonly 'syntax-name': "#2063b0";
+    readonly 'syntax-type': "#76611f";
+};
+export declare const SYNTAX_DARK_THEME: Record<keyof typeof SYNTAX_LIGHT_THEME, string>;
+/** ÖLÇÜ TOKEN'LARI — temadan bağımsız, çalışma zamanında EZİLEBİLİR. */
+export declare const METRIC_TOKENS: {
+    readonly 'radius-xs': "4px";
+    readonly 'radius-sm': "6px";
+    readonly 'radius-md': "8px";
+    readonly 'radius-lg': "12px";
+    readonly 'radius-xl': "16px";
+    readonly 'radius-pill': "999px";
+    /** YOĞUNLUK ÇARPANLARI — akışkan ölçeğin üzerine binen tek ayar. */
+    readonly 'type-scale': "1";
+    readonly 'space-scale': "1";
+    readonly 'space-0': "0";
+    readonly 'space-1': "4px";
+    readonly 'space-2': "8px";
+    readonly 'space-3': string;
+    readonly 'space-4': string;
+    readonly 'space-5': string;
+    readonly 'space-6': string;
+    readonly 'space-7': string;
+    readonly 'space-8': string;
+    readonly 'space-9': string;
+    readonly 'font-size-2xs': string;
+    readonly 'font-size-xs': string;
+    readonly 'font-size-sm': string;
+    readonly 'font-size-base': string;
+    readonly 'font-size-body': string;
+    readonly 'font-size-lg': string;
+    readonly 'font-size-xl': string;
+    readonly 'font-size-2xl': string;
+    readonly 'font-size-3xl': string;
+    readonly 'font-size-4xl': string;
+    /** FORM DENETİMİ PUNTOSU — ölçekten AYRI ve 16px'in altına inmez. */
+    readonly 'font-size-control': `max(16px, ${string})`;
+    readonly 'leading-none': "1";
+    readonly 'leading-tight': "1.16";
+    readonly 'leading-snug': "1.35";
+    readonly 'leading-normal': "1.62";
+    readonly 'leading-relaxed': "1.75";
+    readonly 'icon-xs': "14px";
+    readonly 'icon-sm': "16px";
+    readonly 'icon-md': "18px";
+    readonly 'icon-lg': "20px";
+    readonly 'icon-xl': "24px";
+    readonly 'duration-instant': "80ms";
+    readonly 'duration-fast': "140ms";
+    readonly 'duration-normal': "200ms";
+    readonly 'duration-slow': "320ms";
+    readonly 'ease-out': "cubic-bezier(0.22, 1, 0.36, 1)";
+    readonly 'ease-in-out': "cubic-bezier(0.4, 0, 0.2, 1)";
+    readonly 'ease-spring': "cubic-bezier(0.34, 1.4, 0.64, 1)";
+    readonly 'duration-spin': "700ms";
+    readonly 'duration-shimmer': "1400ms";
+    /** Durum noktasının nabzı — "çalışıyor / bağlanıyor"; 700 ms telaş, 2 sn ölü gibi okunuyordu. */
+    readonly 'duration-pulse': "1600ms";
+};
+/** YOĞUN (compact) KİP — `<html data-ui-density="compact">`. */
+export declare const COMPACT_DENSITY: {
+    readonly 'type-scale': "0.93";
+    readonly 'space-scale': "0.88";
+};
+/** DAR EKRAN KADEMELERİ — `@media (max-width: 640px)`. */
+export declare const NARROW_METRICS: {
+    readonly 'radius-lg': "10px";
+    readonly 'radius-xl': "13px";
+    readonly 'icon-xs': "13px";
+    readonly 'icon-sm': "15px";
+    readonly 'icon-md': "16px";
+    readonly 'icon-lg': "18px";
+    readonly 'icon-xl': "20px";
+    readonly 'leading-tight': "1.18";
+    readonly 'leading-snug': "1.38";
+    readonly 'leading-normal': "1.52";
+    readonly 'leading-relaxed': "1.62";
+};
+/** `NARROW_METRICS`in devreye girdiği genişlik — `$breakpoint-mobile` ile aynı. */
+export declare const NARROW_BREAKPOINT = "640px";
+/** Kütüphanenin varsayılan font yığınları — hepsi sistem fontlarına iner. */
+export declare const DEFAULT_FONTS: Required<UiFonts>;