@ahmetilhn/hanui 4.0.0 → 5.3.0

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

@@ -0,0 +1,203 @@
+/**
+ * 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";
+};

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

@@ -0,0 +1,208 @@
+import { HanuiFonts } 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>;
+/** Ö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-hanui-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<HanuiFonts>;

package/build/types/types/common-element-props.type.d.ts

@@ -0,0 +1,8 @@
+/** Her bileşenin kabul ettiği ortak kanca noktaları. */
+export type CommonElementProps = Partial<{
+    className: string;
+    id: string;
+    testId: string;
+}>;
+/** Sınıf birleştiricinin kabul ettiği değerler. */
+export type ClassValue = string | false | null | undefined;

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

@@ -0,0 +1,14 @@
+import type { AnchorHTMLAttributes, ComponentType, ReactNode } from 'react';
+/** Kütüphanenin bir bağlantı bileşenine geçirdiği props. */
+export type HanuiLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    children?: ReactNode;
+    [key: string]: unknown;
+};
+/** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
+export type HanuiLinkComponent = ComponentType<HanuiLinkProps>;
+/**
+ * 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 HanuiLinkExtraProps = Record<string, unknown>;

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

@@ -0,0 +1,223 @@
+import type { HanuiLinkComponent } from '@/types/link.type';
+import { LIGHT_THEME, METRIC_TOKENS } from '@/theme/tokens';
+/**
+ * Sayı biçimlendiricileri: değere bağlı metinler dizeyle verilemez.
+ * ⚠ `helpers/label.helper.ts` de aynı imzayı ELLE taşıyordu.
+ */
+export type Formatter<TArgs extends unknown[]> = (...args: TArgs) => string;
+/**
+ * Dışarıdan verilebilecek tema yapılandırması.
+ * @example initHanui({ theme: { light: { link: '#0a58ca', 'ring-color': '#0d6efd' }, dark: {…
+ */
+export type HanuiThemeConfig = Partial<{
+    light: HanuiThemeTokens;
+    dark: HanuiThemeTokens;
+    fonts: HanuiFonts;
+    /**
+     * Ölçü ezmeleri — yarıçap, boşluk, punto, süre.
+     * @example initHanui({ theme: { metrics: { 'radius-md': '2px', 'radius-lg': '4px' } } });
+     */
+    metrics: HanuiMetrics;
+}>;
+/** Yazı tipi ailesi sözleşmesi. */
+export type HanuiFonts = Partial<{
+    heading: string;
+    body: string;
+    mono: string;
+}>;
+/**
+ * Kullanıcının SEÇİMİ. `system` = açık bir seçim yok, işletim sistemi tercihi izlenir
+ * (`prefers-color-scheme`).
+ */
+export type HanuiColorPreference = HanuiColorScheme | 'system';
+/** ÇÖZÜLMÜŞ tema — ekranda gerçekten hangisi çizili. */
+export type HanuiColorScheme = 'light' | 'dark';
+/** Bir temanın TAM eşlemesi. */
+export type HanuiResolvedTokens = Record<HanuiToken, string>;
+/** Bir temanın token → değer eşlemesi. */
+export type HanuiThemeTokens = Partial<Record<HanuiToken, string>>;
+/** Bilgi yoğunluğu. `default` vitrin, `compact` operasyon paneli. */
+export type HanuiDensity = 'default' | 'compact';
+/** Ölçü ezmeleri. */
+export type HanuiMetrics = Partial<Record<HanuiMetricToken, string>>;
+/** Ölçü token adları — `METRIC_TOKENS`ten türetilir. */
+export type HanuiMetricToken = keyof typeof METRIC_TOKENS;
+/** Token adları — `LIGHT_THEME`den türetilir, elle listelenmez. */
+export type HanuiToken = keyof typeof LIGHT_THEME;
+export type HanuiContextValue = {
+    /** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
+    linkComponent?: HanuiLinkComponent;
+    /** Uygulanan tema ezmeleri. */
+    theme?: HanuiThemeConfig;
+    /**
+     * Arayüz metinleri.
+     * ⚠ Referans bir dönem `theme/labels.ts`yi gösteriyordu; o dosya yalnızca tek satırlık bir başlık
+     * yorumu taşıyordu (sıfır export, sıfır…
+     */
+    labels?: HanuiLabels;
+};
+export type HanuiLabels = Partial<{
+    /** Kip pencere ve alt sayfanın kapatma düğmesi. `Modal`, `BottomSheet`. */
+    close: string;
+    /**
+     * Bildirim yığınının bölge adı ("Bildirimler"). `ToastHub`.
+     * ⚠ Yığın bir `role="region"` ve `aria-live` bölgesi; adsız bir bölge ekran okuyucuda yalnızca
+     * "bölge" diye okunur.
+     */
+    notifications: string;
+    /** Vazgeçme eylemi. `ConfirmDialog`, `PromptDialog`. */
+    cancel: string;
+    /** Kaydetme/gönderme eylemi. `PromptDialog`. */
+    submit: string;
+    /** Bekleme göstergesinin ekran okuyucu metni. `Spinner`. */
+    loading: string;
+    /** Zorunlu alanın yıldızının yanındaki okunabilir karşılık. `Field`. */
+    required: string;
+    /** Filtre şeridinin erişilebilir adı. `FilterBar`. */
+    filters: string;
+    /** Kırıntı yolunun gezinme bölgesi adı. `Breadcrumb`. */
+    breadcrumb: string;
+    /** Alfabe atlama şeridinin gezinme bölgesi adı. `DirectoryJump`. */
+    directoryJump: string;
+    /** Seçim yokken `Select` tetikleyicisinde görünen metin. */
+    selectPlaceholder: string;
+    /** Şifreyi görünür kılan düğmenin erişilebilir adı. `PasswordInput`. */
+    passwordShow: string;
+    /** Şifreyi gizleyen düğmenin erişilebilir adı. `PasswordInput`. */
+    passwordHide: string;
+    /** Baş harf büyütmesinde kullanılacak dil etiketi. `Avatar`. */
+    locale: string;
+    /** Para birimi simgesi ya da kodu. `Price`. */
+    currency: string;
+    combobox: Partial<{
+        searchPlaceholder: string;
+        emptyMessage: string;
+        loadingMessage: string;
+        clearLabel: string;
+    }>;
+    pagination: Partial<{
+        /** Gezinme bölgesinin adı ("Sayfalar"). */
+        label: string;
+        previous: string;
+        next: string;
+    }>;
+    quantity: Partial<{
+        label: string;
+        decrease: string;
+        increase: string;
+    }>;
+    range: Partial<{
+        /** Alt kulbun ad eki ("En az"). */
+        min: string;
+        /** Üst kulbun ad eki ("En çok"). */
+        max: string;
+    }>;
+    dataTable: Partial<{
+        empty: string;
+        loading: string;
+    }>;
+    /**
+     * Sohbet bileşenleri (`@ahmetilhn/hanui/chat`). Çağrı yerine ÖZGÜ metinler buraya girmez:
+     * `PromptInput.placeholder`, `ReasoningBlock.summary`, `ToolCall.name`.
+     */
+    chat: Partial<{
+        /** Sohbet akışının bölge adı ("Sohbet"). `ChatThread`. */
+        thread: string;
+        /** Gönder düğmesi. `PromptInput`. */
+        send: string;
+        /** Akışı durdur düğmesi. `PromptInput`. */
+        stop: string;
+        /** Kullanıcı yukarı kaydırınca beliren düğme ("En yeniye in"). `ChatThread`. */
+        scrollToLatest: string;
+        /** Yanıt tamamlandığında duyurulan cümle ("Yanıt hazır"). `ChatThread`. */
+        replyReady: string;
+        /** Mesaj eylemleri araç çubuğunun adı. `MessageActions`. */
+        messageActions: string;
+        /** Kaynak listesinin adı ("Kaynaklar"). `SourceList`. */
+        sources: string;
+        /** Atıf numarasının okunan adı, örn. `n => 'Kaynak ' + n`. `Citation`. */
+        citation: Formatter<[index: number]>;
+        /** stderr satırının önündeki gizli işaret ("hata çıktısı"): renk tek başına anlam taşımaz. */
+        stderr: string;
+        /** Araç çağrısının durum metinleri. `ToolCall`. */
+        toolStatus: Partial<Record<'running' | 'ok' | 'error' | 'aborted' | 'interrupted', string>>;
+        /** Kod bloğunu kopyalama düğmesi, örn. `language => language + ' kodunu kopyala'`. `CodeBlock`. */
+        codeCopy: Formatter<[language: string]>;
+        /** Kopyalandıktan sonra duyurulan cümle. `CodeBlock`. */
+        codeCopied: string;
+    }>;
+    copyField: Partial<{
+        /** Kopyalama düğmesinin adı. */
+        copy: Formatter<[value: string]>;
+        copied: Formatter<[value: string]>;
+        announcement: string;
+    }>;
+    /**
+     * Dosya yukleme.
+     * ⚠ `tooLarge` bir BICIMLENDIRICI: mesaj dosya adini ve siniri TASIMALI.
+     */
+    fileUpload: Partial<{
+        tooLarge: Formatter<[name: string, max: string]>;
+        /** Yukleme sirasindaki ekran okuyucu duyurusu. */
+        uploading: Formatter<[name: string]>;
+        /** Dosya secildiginde yapilan duyuru. */
+        added: Formatter<[count: number]>;
+    }>;
+    /**
+     * Sayisal gostergenin YON metni.
+     * ⚠ Uc deger de SR-ONLY: ok isareti gorsel bir sinyal ve ekran okuyucuya hicbir sey soylemiyor.
+     */
+    stat: Partial<{
+        increase: string;
+        decrease: string;
+        unchanged: string;
+    }>;
+    /** Adim gostergesinin DURUM metinleri — hepsi sr-only. */
+    steps: Partial<{
+        completed: string;
+        current: string;
+        upcoming: string;
+    }>;
+    /** Zaman cizelgesinin DURUM metinleri — hepsi sr-only. */
+    timeline: Partial<{
+        completed: string;
+        current: string;
+        failed: string;
+    }>;
+    /** Etiket girisi. `removed` bir bicimlendirici: hangi etiketin kalktigi. */
+    tagInput: Partial<{
+        added: Formatter<[value: string]>;
+        removed: Formatter<[value: string]>;
+    }>;
+    rating: Partial<{
+        /** Yıldızların ekran okuyucu karşılığı ("5 üzerinden 4,5 — 12 değerlendirme"). */
+        srLabel: Formatter<[value: number, count: number | undefined]>;
+        /** Puan girişinde yıldız sayısı ("4 yıldız"). */
+        starCount: Formatter<[star: number]>;
+        /** Beş puanın anlamı. */
+        scale: Record<1 | 2 | 3 | 4 | 5, string>;
+    }>;
+}>;
+export type InitHanuiOptions = Partial<{
+    /** Tema ve ölçü ezmeleri. */
+    theme: HanuiThemeConfig;
+    /** Başlangıç şeması. */
+    colorScheme: HanuiColorScheme;
+    /** Bilgi yoğunluğu. */
+    density: HanuiDensity;
+}>;
+export type HanuiThemeState = {
+    /**
+     * ÇÖZÜLMÜŞ tema — ekranda çizili olan. `preference` `system` iken bu alan işletim sisteminin o
+     * anki tercihini taşır.
+     */
+    scheme: HanuiColorScheme;
+    /** Kullanıcının SEÇİMİ. */
+    preference: HanuiColorPreference;
+    /** `'system'` verildiğinde AÇIK seçim silinir ve sistem tercihi izlenir. */
+    setScheme: (preference: HanuiColorPreference) => void;
+    /** Açık ↔ koyu. `system` iken ÇÖZÜLMÜŞ değerin tersine geçer. */
+    toggle: () => void;
+    /** Sunucu çıktısında ve hidrasyondan önceki ilk karede `false`. */
+    isReady: boolean;
+};