@handijit/ui 0.0.0-stage → 2.0.0

package/build/types/chat/ToolCall/index.d.ts

@@ -0,0 +1,41 @@
+import { type FC, type ReactNode } from 'react';
+export type ToolCallStatus = 'running' | 'ok' | 'error' | 'aborted' | 'interrupted';
+type Props = {
+    /** Aracın ikonu. */
+    icon?: ReactNode;
+    /** Aracın adı — çağrı yerine özgü ("bash", "araştır"). */
+    name: string;
+    /** Tek satırlık özet (komut, sorgu); teknik fontta, taşan kesilir. */
+    summary?: string;
+    status: ToolCallStatus;
+    /** Sağdaki ikincil bilgi (süre). */
+    meta?: ReactNode;
+    isDefaultOpen?: boolean;
+    /**
+     * Kontrollü açılış — `onOpenChange` ile. Örn. çalışırken açık, bitince (kullanıcı dokunmadıysa)
+     * kapalı bir terminal kartı.
+     */
+    isOpen?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    /** Gövde — `ToolCallSection`lar. */
+    children?: ReactNode;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Araç çağrısı kartı — ikon, ad, özet, durum noktası ve süre; açılınca bölümleri.
+ *
+ * Durum hem noktayla hem OKUNAN metinle bildirilir (`labels.chat.toolStatus`): renk tek başına
+ * anlam taşımaz. Çalışan çağrının noktası nabız atar ve NÖTRDÜR — süren iş marka yüzeyi değil.
+ */
+declare const ToolCall: FC<Props>;
+type SectionProps = {
+    /** Bölümün başlığı ("Girdi", "Çıktı", "Hata") — overline. */
+    label: string;
+    children: ReactNode;
+    className?: string;
+};
+/** Araç çağrısının bir bölümü — başlık + gövde. */
+export declare const ToolCallSection: FC<SectionProps>;
+declare const _default: typeof ToolCall;
+export default _default;

package/build/types/chat/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @handijit/ui/chat — sohbet ve uygulama bileşenleri. Dışa verilen her ad bir SÖZLEŞMEDİR.
+ *
+ * ⚠ Ana girişe ait HER ŞEY (bileşenler, `useUi`, kancalar) paket adıyla alınır:
+ * `import { … } from '@handijit/ui'`. Göreli yol yalnızca durumsuz yardımcılar (`cx`,
+ * `named`, metin çözümü) ve SCSS içindir. Nöbetçi `__tests__/subentry-boundary.test.ts`.
+ * Stiller `@handijit/ui/chat.css` — `styles.css`ten AYRI ve ONDAN SONRA içe aktarılır.
+ */
+export { default as ChatThread } from './ChatThread';
+export { default as ChatMessage, type ChatMessageAuthor } from './ChatMessage';
+export { default as PromptInput } from './PromptInput';
+export { default as PromptSuggestions, type PromptSuggestion } from './PromptSuggestions';
+export { default as Prose } from './Prose';
+export { default as CodeBlock } from './CodeBlock';
+export { default as ReasoningBlock } from './ReasoningBlock';
+export { default as ReasoningText } from './ReasoningText';
+export { default as ToolCall, ToolCallSection, type ToolCallStatus } from './ToolCall';
+export { default as TerminalOutput, type TerminalChunk } from './TerminalOutput';
+export { default as SourceList, type SourceItem } from './SourceList';
+export { default as Citation } from './Citation';
+export { default as MessageActions } from './MessageActions';
+export { default as AppBar } from './AppBar';
+export { default as ActionList, ActionListItem } from './ActionList';
+export { default as SegmentBar, type SegmentBarMarker, type SegmentBarSegment } from './SegmentBar';
+export { default as Legend, type LegendItem, type LegendTone } from './Legend';
+export { default as DescriptionList, type DescriptionItem } from './DescriptionList';

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

@@ -0,0 +1,49 @@
+import { ReactNode } from 'react';
+export type ComboboxOption<T extends string = string> = {
+    value: T;
+    label: string;
+    /** İkincil satır: kod, numara, ayırt edici bilgi. */
+    description?: string;
+    isDisabled?: boolean;
+};
+/** Bileşenin çizdiği metinler. */
+export type ComboboxLabels = {
+    /** Seçim yokken tetikleyicide ve alt sayfa başlığında görünen metin. */
+    placeholder: string;
+    /** Arama kutusunun yer tutucusu ve erişilebilir adı. */
+    searchPlaceholder?: string;
+    /** Liste boşken gösterilen metin. */
+    emptyMessage?: string;
+    /** Arama sürerken liste yerine gösterilen metin. */
+    loadingMessage?: string;
+    /** Seçimi kaldıran çarpının erişilebilir adı. */
+    clearLabel?: string;
+    /** Alt sayfanın kapatma düğmesinin erişilebilir adı. */
+    closeLabel?: string;
+};
+export type ComboboxProps<T extends string> = {
+    options: ComboboxOption<T>[];
+    value: T | null;
+    onChange: (value: T | null) => void;
+    labels: ComboboxLabels;
+    /**
+     * Verilirse arama sunucuda yapılır: bileşen listeyi kendisi filtrelemez, yazılanı 300 ms bekleyip
+     * buraya bildirir.
+     */
+    onSearch?: (query: string) => void;
+    isLoading?: boolean;
+    isDisabled?: boolean;
+    /** Seçimi kaldıran çarpı düğmesi gösterilir. */
+    isClearable?: boolean;
+    /** Arama kutusu GİZLENİR. */
+    isSearchHidden?: boolean;
+    /** Tetikleyicinin solundaki ikon. */
+    icon?: ReactNode;
+    id?: string;
+    /** Zorunluluk — `Field`in `FieldChildProps` sözleşmesi. */
+    required?: boolean;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean;
+    className?: string;
+    testId?: string;
+};

package/build/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/helpers/class-name.helper.d.ts

@@ -0,0 +1,3 @@
+import { ClassValue } from '@/types/common-element-props.type';
+/** Sınıf adı birleştirici. */
+export declare const cx: (...values: ClassValue[]) => string;

package/build/types/helpers/component.helper.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DevTools adı — modül düzeyinde YAN ETKİ bırakmadan.
+ *
+ * ⚠ `X.displayName = 'X'` KULLANILMAZ: modül düzeyindeki özellik ataması
+ * bundler için yan etkidir ve hedefinin tüm bağımlılık zincirini ayakta tutar.
+ * Ölçüldü: yalnızca `Badge` import eden uygulama 20,7 kB indiriyordu (paketin
+ * tamamı 21,8 kB). Atama çağrıya dönüşünce `#__PURE__` işaretlenebiliyor →
+ * `Badge` 2,71 kB. Nöbetçi `.size-limit.json`.
+ *
+ * @example
+ * export default memo(named(Button, 'Button')) as typeof Button;
+ */
+export declare const named: <TComponent extends object>(component: TComponent, displayName: string) => TComponent;

package/build/types/helpers/label.helper.d.ts

@@ -0,0 +1,12 @@
+/** Metin çözümlemesi: prop → sağlayıcı config'i → geliştirme uyarısı. */
+import type { Formatter } from '@/types/theme.type';
+/** Uyarı durumu testler arasında sızmamalı; her test kendi durumundan başlar. */
+export declare const resetLabelWarnings: () => void;
+/**
+ * Verilen metni çözer.
+ * @param key Uyarıda gösterilecek yol (`Modal.closeLabel`).
+ * @param values Öncelik sırasına göre adaylar: prop önce, config sonra.
+ */
+export declare const resolveLabel: (key: string, ...values: (string | undefined)[]) => string;
+/** Biçimlendirici çözümü — değere bağlı metinler için. */
+export declare const resolveFormatter: <TArgs extends unknown[]>(key: string, formatter: Formatter<TArgs> | undefined, ...args: TArgs) => string;

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.type.d.ts

@@ -0,0 +1,181 @@
+import { ThemeName, ThemePreference } from '@handijit/design';
+import { UiLinkComponent } from './link.type';
+/**
+ * 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;
+/**
+ * The user's CHOICE. `system` = no explicit choice, the operating system's setting is followed.
+ * The same union as `ThemePreference` of `@handijit/design`.
+ */
+export type UiColorPreference = ThemePreference;
+/** The RESOLVED theme — the one actually drawn. The same union as design's `ThemeName`. */
+export type UiColorScheme = ThemeName;
+export type UiContextValue = {
+    /** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
+    linkComponent?: UiLinkComponent;
+    /**
+     * 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?: UiLabels;
+};
+export type UiLabels = 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 (`@handijit/ui/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 UiThemeState = {
+    /**
+     * ÇÖZÜLMÜŞ tema — ekranda çizili olan. `preference` `system` iken bu alan işletim sisteminin o
+     * anki tercihini taşır.
+     */
+    scheme: UiColorScheme;
+    /** Kullanıcının SEÇİMİ. */
+    preference: UiColorPreference;
+    /** `'system'` verildiğinde AÇIK seçim silinir ve sistem tercihi izlenir. */
+    setScheme: (preference: UiColorPreference) => 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;
+};

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 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/types/theme.type.d.ts

@@ -0,0 +1,181 @@
+import type { ThemeName, ThemePreference } from '@handijit/design';
+import type { UiLinkComponent } from '@/types/link.type';
+/**
+ * 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;
+/**
+ * The user's CHOICE. `system` = no explicit choice, the operating system's setting is followed.
+ * The same union as `ThemePreference` of `@handijit/design`.
+ */
+export type UiColorPreference = ThemePreference;
+/** The RESOLVED theme — the one actually drawn. The same union as design's `ThemeName`. */
+export type UiColorScheme = ThemeName;
+export type UiContextValue = {
+    /** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
+    linkComponent?: UiLinkComponent;
+    /**
+     * 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?: UiLabels;
+};
+export type UiLabels = 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 (`@handijit/ui/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 UiThemeState = {
+    /**
+     * ÇÖZÜLMÜŞ tema — ekranda çizili olan. `preference` `system` iken bu alan işletim sisteminin o
+     * anki tercihini taşır.
+     */
+    scheme: UiColorScheme;
+    /** Kullanıcının SEÇİMİ. */
+    preference: UiColorPreference;
+    /** `'system'` verildiğinde AÇIK seçim silinir ve sistem tercihi izlenir. */
+    setScheme: (preference: UiColorPreference) => 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;
+};