@ahmetilhn/hanui 4.1.0 → 5.3.0

package/build/types/charts/core/stats.d.ts

@@ -0,0 +1,34 @@
+/** İSTATİSTİK — kutu grafiği ve histogram. Sonlu olmayan değerler (`NaN`, `±Infinity`) atılır. */
+export declare const finite: (values: readonly (number | null | undefined)[]) => number[];
+/** `[en küçük, en büyük]`; boş girdide `[0, 0]`. Dizi YAYILMAZ: büyük veride çağrı yığını taşmaz. */
+export declare const extent: (values: readonly number[]) => [number, number];
+/** Sıralı dizide çeyreklik — doğrusal ara değer (R tip 7 / Excel / NumPy varsayılanı). */
+export declare const quantile: (sorted: readonly number[], probability: number) => number;
+export type BoxStats = {
+    count: number;
+    min: number;
+    q1: number;
+    median: number;
+    q3: number;
+    max: number;
+    /** Bıyıkların ucu: 1,5 × IQR içindeki en uç GÖZLEM (Tukey). */
+    whiskerLow: number;
+    whiskerHigh: number;
+    /** Bıyık dışında kalan gözlemler. */
+    outliers: number[];
+};
+/** Beş sayı özeti + Tukey bıyıkları. Boş girdide `null`. */
+export declare const boxStats: (values: readonly number[]) => BoxStats | null;
+export type Bin = {
+    /** Dahil alt sınır. */
+    from: number;
+    /** Hariç üst sınır — SON bölme dahil. */
+    to: number;
+    count: number;
+};
+/**
+ * Histogram bölmeleri. Bölme sayısı verilmezse Sturges (`⌈log₂ n⌉ + 1`); sınırlar "güzel" bir adıma
+ * oturur, yani bölmeler 0-10-20 gibi okunur.
+ * ⚠ Son bölme üst ucu DAHİL eder: en büyük değer dışarıda kalmaz.
+ */
+export declare const histogram: (values: readonly number[], binCount?: number) => Bin[];

package/build/types/charts/core/types.d.ts

@@ -0,0 +1,31 @@
+import type { ChartTone } from './palette';
+/** İpucunun bir satırı — renk karesi + ad + değer. */
+export type TooltipRow = {
+    id: string;
+    label: string;
+    value: string;
+    tone?: ChartTone;
+};
+export type TooltipContent = {
+    title?: string;
+    rows: TooltipRow[];
+};
+/** Görsel olarak gizli veri tablosu — ekran okuyucu grafiği TABLO olarak da okur. */
+export type ChartTable = {
+    columns: string[];
+    rows: string[][];
+};
+export type LegendEntry = {
+    id: string;
+    label: string;
+    tone: ChartTone;
+};
+/** Grafiğin çizim alanı — eksenler kenar boşluklarında. */
+export type PlotArea = {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+};

package/build/types/charts/core/useChartWidth.d.ts

@@ -0,0 +1,7 @@
+import { type RefObject } from 'react';
+/**
+ * Kapsayıcının genişliği — `ResizeObserver` ile, BOYAMADAN ÖNCE ölçülür (ilk karede yanlış boyutta
+ * çizilip zıplamasın). `fixed` verilirse ölçüm yapılmaz.
+ */
+declare const useChartWidth: (fixed?: number) => [RefObject<HTMLDivElement | null>, number];
+export default useChartWidth;

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

@@ -0,0 +1,21 @@
+/**
+ * @ahmetilhn/hanui/charts — SVG grafikleri, sıfır bağımlılık. Dışa verilen her ad bir SÖZLEŞMEDİR.
+ *
+ * ⚠ Ana girişe ait her şey paket adıyla alınır (`@ahmetilhn/hanui`); göreli yol yalnızca durumsuz
+ * yardımcılar ve SCSS içindir. Nöbetçi `__tests__/subentry-boundary.test.ts`.
+ * Stiller `@ahmetilhn/hanui/charts.css` — `styles.css`ten SONRA içe aktarılır.
+ */
+export { default as LineChart } from './LineChart';
+export { default as AreaChart } from './AreaChart';
+export { default as BarChart } from './BarChart';
+export { default as ComposedChart } from './ComposedChart';
+export { default as PieChart, type PieSlice } from './PieChart';
+export { default as ScatterPlot, type ScatterPoint, type ScatterSeries } from './ScatterPlot';
+export { default as Heatmap } from './Heatmap';
+export { default as BoxPlot, type BoxPlotGroup, type BoxPlotLabels } from './BoxPlot';
+export { default as Histogram } from './Histogram';
+export { default as RadarChart, type RadarAxis, type RadarSeries } from './RadarChart';
+export type { ChartRow } from './core/CartesianChart';
+export type { ChartSeries, ComposedSeries } from './core/series';
+export type { ChartTone } from './core/palette';
+export type { ValueFormat } from './core/format';

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

@@ -0,0 +1,46 @@
+import { type FC, type ReactNode } from 'react';
+type ListProps = {
+    /** Listenin erişilebilir adı ("Bağlam haritası"). */
+    label: string;
+    /** `ActionListItem` öğeleri. */
+    children: ReactNode;
+    /**
+     * Verilirse liste SANALLAŞTIRILIR: yalnızca görünen satırlar çizilir. Satır yüksekliği SABİT
+     * olmalı (px).
+     */
+    rowHeight?: number;
+    /** Sanal listede görünen alanın yüksekliği (px). */
+    maxHeight?: number;
+    className?: string;
+    testId?: string;
+};
+type ItemProps = {
+    children: ReactNode;
+    /** Satırın başında duran öğe (kimlik, ikon). */
+    start?: ReactNode;
+    /** Satırın sonunda duran öğe (tur numarası, süre). */
+    end?: ReactNode;
+    onClick?: () => void;
+    href?: string;
+    /** Verilirse satır bir SEÇİMDİR (`aria-pressed`); verilmezse düz bir eylem. */
+    isSelected?: boolean;
+    /** Geri planda kalan satır (gizlenmiş, eski) — renkle, saydamlıkla değil. */
+    isMuted?: boolean;
+    testId?: string;
+    /** Sanal listenin kendisi yazar: satırın gerçek konumu ve listenin gerçek boyu. */
+    'aria-posinset'?: number;
+    'aria-setsize'?: number;
+};
+/**
+ * Çerçeveli satır listesi — her satır bir EYLEM (açar, gider) ya da bir SEÇİM (ayrıntıyı gösterir).
+ *
+ * ⚠ Seçim mi eylem mi satır başına `isSelected` ile söylenir: verilirse satır bir aç/kapa düğmesidir
+ * (`aria-pressed`), verilmezse düz bir eylem. Eylemi seçim gibi sunmak kalıcı bir durum vaat ediyordu.
+ * ⚠ Sanal listede ekran okuyucu yalnızca çizilen satırları görür; gerçek konumu `aria-posinset` /
+ * `aria-setsize` söyler.
+ */
+declare const ActionList: FC<ListProps>;
+/** `ActionList` satırı — kendi `li`sini taşır. */
+export declare const ActionListItem: FC<ItemProps>;
+declare const _default: typeof ActionList;
+export default _default;

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

@@ -0,0 +1,21 @@
+import { type FC, type ReactNode } from 'react';
+type Props = {
+    /** Sol baştaki marka (logo + ad). */
+    brand: ReactNode;
+    /** Markanın yanında, esneyen orta bölge (model, bağlantı durumu). */
+    start?: ReactNode;
+    /** Sağdaki eylem kümesi. */
+    end?: ReactNode;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Uygulamanın üst bandı — sayfaya yapışık, sayfanın devamı (bant sayfayı ÖRTMEZ: `nav-*`).
+ *
+ * Kendi yüksekliğini ölçüp `--hanui-header-height`e yazar. README bu `ResizeObserver` kodunu her
+ * tüketiciye elle yazdırıyordu; sabit bir sayı yazan da vardı ve bant mobilde iki satıra düştüğünde
+ * yapışkan başlıklar altında kalıyordu.
+ */
+declare const AppBar: FC<Props>;
+declare const _default: typeof AppBar;
+export default _default;

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

@@ -0,0 +1,24 @@
+import { type FC, type ReactNode } from 'react';
+export type ChatMessageAuthor = 'user' | 'assistant';
+type Props = {
+    author: ChatMessageAuthor;
+    children: ReactNode;
+    /** Asistan mesajının avatarı (`Avatar tone="brand"`); ilk satır hizasında durur. */
+    avatar?: ReactNode;
+    /** Mesajın altındaki eylem çubuğu (`MessageActions`). */
+    actions?: ReactNode;
+    /** Yanıt hâlâ akıyor — `aria-busy`: ekran okuyucu yarım metni okumaz. */
+    isStreaming?: boolean;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Sohbet mesajı. Kullanıcı mesajı sağa yaslı bir balon (`surface-2`, satır sonları korunur);
+ * asistan mesajı tam genişlik, avatar sol üstte.
+ *
+ * ⚠ Eylemler hover'da VE `:focus-within`de belirginleşir: klavye kullanıcısı da görmeli. Gizlenmez,
+ * yalnızca sessizleşir — `opacity` değil renk (soluklaştırma yasak).
+ */
+declare const ChatMessage: FC<Props>;
+declare const _default: typeof ChatMessage;
+export default _default;

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

@@ -0,0 +1,24 @@
+import { type FC, type ReactNode } from 'react';
+type Props = {
+    /** Mesajlar (`ChatMessage`). */
+    children: ReactNode;
+    /** Alt dok — yazma alanı (`PromptInput`) ve ipucu satırı. */
+    dock?: ReactNode;
+    /** Yanıt akıyor. Akış bittiğinde "yanıt hazır" duyurulur. */
+    isStreaming?: boolean;
+    /** Bölgenin adı; verilmezse `labels.chat.thread`. */
+    label?: string;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Sohbet iskeleti — kaydırma alanı, ortalanmış sütun ve alt dok.
+ *
+ * - Sona yapışık kalır; kullanıcı yukarı kaydırınca bırakır ve "en yeniye in" düğmesi belirir.
+ * - ⚠ Akan belirteçler OKUNMAZ (`aria-live` yok, `role="log"` değil): her belirteci duyuran bir bölge
+ *   ekran okuyucuyu kullanılamaz kılıyordu. Yanıt BİTTİĞİNDE tek bir cümle duyurulur.
+ * - Dok sayfanın dibine yapışır ve `safe-area` payını taşır; iOS'ta klavye açıkken görünür kalır.
+ */
+declare const ChatThread: FC<Props>;
+declare const _default: typeof ChatThread;
+export default _default;

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

@@ -0,0 +1,15 @@
+import { type FC } from 'react';
+type Props = {
+    /** Kaynağın numarası — `SourceList`teki sırayla eşleşir (1'den başlar). */
+    index: number;
+    href?: string;
+    onClick?: () => void;
+    className?: string;
+};
+/**
+ * Metin içi atıf — "[3]". Okunan adı `labels.chat.citation(3)` ("Kaynak 3"): görünen rakam tek
+ * başına ekran okuyucuda "üç" diye, bağlamsız okunuyordu.
+ */
+declare const Citation: FC<Props>;
+declare const _default: typeof Citation;
+export default _default;

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

@@ -0,0 +1,27 @@
+import { type FC } from 'react';
+type Props = {
+    /** Ham kod — kopyalanan ve `html` yokken çizilen metin. */
+    code: string;
+    /** Dil adı; başlık şeridinde ve kopyalama düğmesinin adında. */
+    language?: string;
+    /**
+     * ÖNCEDEN VURGULANMIŞ HTML (Shiki çıktısı). Verilmezse düz `<pre>` çizilir.
+     * ⚠ GÜVENLİK ÇAĞIRANIN: bu dize olduğu gibi DOM'a yazılır. Yalnızca kendi vurgulayıcınızın
+     * ürettiği çıktıyı verin; kullanıcı girdisini asla doğrudan geçirmeyin.
+     */
+    html?: string;
+    /** Gövdenin tavanı (px); uzun kod kendi içinde kayar. */
+    maxHeight?: number;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Kod bloğu — başlık şeridi (dil + kopyala) ve kod gövdesi.
+ *
+ * ⚠ Vurgulayıcı İÇERMEZ (Shiki tüketicide). Shiki'nin çift tema çıktısı (`--shiki-light` /
+ * `--shiki-dark` değişkenleri) burada temaya bağlanır; vurgusuz kod da aynı kutuda okunur.
+ * Kod satırları SARILMAZ: dar ekranda kutu yatay kayar (kodun girintisi anlamdır).
+ */
+declare const CodeBlock: FC<Props>;
+declare const _default: typeof CodeBlock;
+export default _default;

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

@@ -0,0 +1,16 @@
+import { type FC, type ReactNode } from 'react';
+export type DescriptionItem = {
+    term: ReactNode;
+    description: ReactNode;
+    /** Değer teknik bir kimlik (kod, yol, karma): teknik fontta ve satır içinde bölünebilir. */
+    isTechnical?: boolean;
+};
+type Props = {
+    items: DescriptionItem[];
+    className?: string;
+    testId?: string;
+};
+/** Terim–değer listesi — yerel `<dl>`; ekran okuyucu terimi değeriyle birlikte okur. */
+declare const DescriptionList: FC<Props>;
+declare const _default: typeof DescriptionList;
+export default _default;

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

@@ -0,0 +1,20 @@
+import { type FC } from 'react';
+/** Kategorik paletin adları (`cat-*`, `series-*`) + bekleme/boşluk için `muted`. */
+export type LegendTone = 'cat-1' | 'cat-2' | 'cat-3' | 'cat-4' | 'cat-5' | 'series-1' | 'series-2' | 'muted';
+export type LegendItem = {
+    id: string;
+    label: string;
+    tone: LegendTone;
+};
+type Props = {
+    items: LegendItem[];
+    className?: string;
+    testId?: string;
+};
+/**
+ * Grafik lejantı — renk karesi + ad. Renk yalnızca kategorik paletten gelir (iki temanın üç
+ * yüzeyinde ≥3:1); ad her zaman metin olarak yazılır, renk tek başına anlam taşımaz.
+ */
+declare const Legend: FC<Props>;
+declare const _default: typeof Legend;
+export default _default;

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

@@ -0,0 +1,21 @@
+import { type FC, type ReactNode } from 'react';
+type Props = {
+    /** `IconButton` / `Button size={UISize.XSMALL}` öğeleri. */
+    children: ReactNode;
+    /** Araç çubuğunun sonunda duran okunan bilgi (süre, belirteç, maliyet). */
+    meta?: ReactNode;
+    /** Araç çubuğunun adı; verilmezse `labels.chat.messageActions`. */
+    label?: string;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Mesajın eylem çubuğu — kopyala, yeniden dene, ayrıntı.
+ *
+ * Klavye (`role="toolbar"`, tek sekme durağı değil — her düğme sekme sırasında kalır):
+ * `ArrowRight` / `ArrowLeft` sonraki / önceki eylem · `Home` / `End` ilk / son.
+ * ⚠ Satır içi araç çubuğu: ok tuşu yalnızca odak ÇUBUKTAYKEN çalışır, sayfayı kaydırmaz.
+ */
+declare const MessageActions: FC<Props>;
+declare const _default: typeof MessageActions;
+export default _default;

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

@@ -0,0 +1,47 @@
+import { type ReactNode } from 'react';
+type Props = {
+    value: string;
+    onChange: (value: string) => void;
+    /** Enter ya da gönder düğmesi. Boş (yalnızca boşluk) metinde çağrılmaz. */
+    onSubmit: () => void;
+    /** Akışı durdurur — `isBusy` iken düğme ve `Escape`. */
+    onStop?: () => void;
+    /** Yanıt akıyor: gönder yerine durdur düğmesi. */
+    isBusy?: boolean;
+    /** Alanın tamamı pasif — yazılamaz. */
+    isDisabled?: boolean;
+    /**
+     * Yazmaya izin var ama GÖNDERİM kapalı (bağlantı yok, oturum hazırlanıyor). Kullanıcı mesajını
+     * yazabilir; gönder düğmesi ve `Enter` bekler.
+     */
+    isSubmitDisabled?: boolean;
+    /** Yer tutucu — çağrı yerine ÖZGÜ metin, `labels`a girmez. */
+    placeholder: string;
+    /** Alanın erişilebilir adı; verilmezse yer tutucu. */
+    label?: string;
+    /** Otomatik büyümenin tavanı (satır). */
+    maxRows?: number;
+    /** Alanın altındaki ipucu satırı (`Kbd` ile kısayollar). */
+    hint?: ReactNode;
+    /** Alanın solunda (ek dosya, model seçici). */
+    start?: ReactNode;
+    /** Gönder düğmesinin solunda. */
+    end?: ReactNode;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Sohbet yazma alanı — çerçevesiz `Textarea` + yuvarlak gönder / durdur düğmesi.
+ *
+ * Klavye: `Enter` gönderir · `Shift+Enter` yeni satır · `Escape` (akış sürerken) durdurur.
+ * - ⚠ IME yazımı sırasında (`isComposing`, Türkçe dışı klavyeler) `Enter` GÖNDERMEZ: harf seçimini
+ *   onaylıyor, mesajı değil.
+ * - ⚠ `Escape` açık bir yüzey (modal, menü, bildirim) varken DOKUNMAZ (`hasOpenSurface`): kullanıcı
+ *   yalnızca o yüzeyi kapatmak istiyordu, arkadaki akış da duruyordu.
+ * - Gönder düğmesi ekranın TEK birincil eylemi: çam dolgu, koyu temada mint sınır.
+ * - Odak göstergesini çerçeve çizer (`:focus-within`); alan çerçevesiz (`variant="bare"`).
+ * - `ref` metin alanına iletilir: gönderimden ya da bir öneri seçildikten sonra odağı geri vermek için.
+ */
+declare const PromptInput: import("react").ForwardRefExoticComponent<Props & import("react").RefAttributes<HTMLTextAreaElement>>;
+declare const _default: typeof PromptInput;
+export default _default;

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

@@ -0,0 +1,25 @@
+import { type FC } from 'react';
+export type PromptSuggestion = {
+    id: string;
+    /** Gönderilecek istem ya da kısa adı. */
+    label: string;
+    /** İkinci satır — neyi sorduğu. */
+    description?: string;
+};
+type Props = {
+    /** Grubun erişilebilir adı ("Örnek istemler"). */
+    label: string;
+    items: PromptSuggestion[];
+    onPick: (item: PromptSuggestion) => void;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Hazır istem önerileri — boş sohbetin başlangıç kartları.
+ *
+ * ⚠ Bunlar EYLEM, seçim değil: `ChipGroup` (seçim) yerine düğme ızgarası. Basmak bir şey seçmez,
+ * istemi gönderir ya da yazma alanına koyar.
+ */
+declare const PromptSuggestions: FC<Props>;
+declare const _default: typeof PromptSuggestions;
+export default _default;

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

@@ -0,0 +1,15 @@
+import { type FC, type HTMLAttributes } from 'react';
+type Props = HTMLAttributes<HTMLDivElement> & {
+    testId?: string;
+};
+/**
+ * Uzun metin kabı — markdown çıktısının (başlık, paragraf, liste, alıntı, tablo, satır içi kod,
+ * bağlantı, formül) tipografisi.
+ *
+ * ⚠ AYRIŞTIRICI İÇERMEZ: `react-markdown`, `remark`/`rehype` eklentileri ve KaTeX tüketicide kalır;
+ * hanui yalnızca çıktının nasıl göründüğünü verir (`linkComponent` ile aynı desen). Bir UI paketinin
+ * markdown ayrıştırıcısı taşıması, Hanparça'nın hiç kullanmadığı yüzlerce kB demek.
+ */
+declare const Prose: FC<Props>;
+declare const _default: typeof Prose;
+export default _default;

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

@@ -0,0 +1,24 @@
+import { type FC, type ReactNode } from 'react';
+type Props = {
+    /** Başlık — çağrı yerine ÖZGÜ ("Düşündü · 3 araç · 2,4 sn"), `labels`a girmez. */
+    summary: ReactNode;
+    /** Tur sürüyor: blok AÇIK durur ve gösterge döner. */
+    isRunning?: boolean;
+    /** Süren işin göstergesi; verilmezse `Spinner`. Marka yükleyicisi buraya geçer. */
+    indicator?: ReactNode;
+    /** Kapalı bir turda açılış durumu. */
+    isDefaultOpen?: boolean;
+    /** Gövde: `ReasoningText`, ara metinler, `ToolCall`lar. */
+    children: ReactNode;
+    className?: string;
+    testId?: string;
+};
+/**
+ * "Model ne yaptı" bloğu — akıl yürütme, ara metinler, araç çağrıları.
+ *
+ * Tur sürerken AÇIK durur, bitince kapanır. ⚠ Kullanıcı bloğu elle açtıysa ya da kapattıysa o
+ * tercihe DOKUNULMAZ: tur bittiğinde okuduğu bloğun elinden çekilmesi en sık şikâyetti.
+ */
+declare const ReasoningBlock: FC<Props>;
+declare const _default: typeof ReasoningBlock;
+export default _default;

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

@@ -0,0 +1,14 @@
+import { type FC } from 'react';
+type Props = {
+    text: string;
+    /** Kaydırılabildiğinde bölgenin okunan adı ("Akıl yürütme"). */
+    label: string;
+    /** Kutunun tavanı (px); akan metin bu yükseklikte sona yapışık kayar. */
+    maxHeight?: number;
+    className?: string;
+    testId?: string;
+};
+/** Akıl yürütme metni — yüksekliği sınırlı, akarken sona yapışık (`ScrollArea isFollowingEnd`). */
+declare const ReasoningText: FC<Props>;
+declare const _default: typeof ReasoningText;
+export default _default;

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

@@ -0,0 +1,46 @@
+import { type FC } from 'react';
+import type { LegendTone } from '../Legend';
+export type SegmentBarSegment = {
+    id: string;
+    /** Parçanın okunan adı, değeriyle: "Önek · 12,4 B". Özet adın parçası olur. */
+    label: string;
+    tone: LegendTone;
+} & ({
+    /** Yığılmış çubukta parçanın büyüklüğü — parçalar sırayla dizilir. */
+    value: number;
+    from?: never;
+    to?: never;
+} | {
+    /** Zaman çizelgesinde parçanın başlangıcı ve bitişi (aynı ölçekte). */
+    from: number;
+    to: number;
+    value?: never;
+});
+export type SegmentBarMarker = {
+    id: string;
+    /** Konum, `max` ile aynı ölçekte. */
+    at: number;
+    label: string;
+    tone?: 'neutral' | 'danger';
+};
+type Props = {
+    /** Grafiğin adı ("Bağlam bileşimi"); parçaların ve işaretlerin adlarıyla birlikte okunur. */
+    label: string;
+    /** Ölçeğin tavanı. */
+    max: number;
+    segments: SegmentBarSegment[];
+    /** Dikey çizgi işaretleri — bütçe sınırı, hedef. */
+    markers?: SegmentBarMarker[];
+    className?: string;
+    testId?: string;
+};
+/**
+ * Parçalı çubuk — yığılmış bileşim (`value`) ya da zaman çizelgesi (`from`/`to`).
+ *
+ * Erişilebilirlik: çubuk TEK bir görseldir (`role="img"`); adı grafiğin adı + her parçanın ve
+ * işaretin okunan adıdır. Parça başına odaklanılabilir öğe çizilmez — bir çubuğun içinde sekme
+ * durağı dizmek, okunan özetten daha az bilgi verip daha çok tuş istiyordu.
+ */
+declare const SegmentBar: FC<Props>;
+declare const _default: typeof SegmentBar;
+export default _default;

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

@@ -0,0 +1,25 @@
+import { type FC } from 'react';
+export type SourceItem = {
+    id: string;
+    title: string;
+    /** Dış kaynak — yeni sekmede açılır. */
+    url?: string;
+    /** Kaynağın alan adı ("tr.wikipedia.org") — başlığın altında. */
+    domain?: string;
+    /** Uygulama içinde açılan kaynak (yan panel, kip pencere). `url` ile birlikte verilmez. */
+    onSelect?: () => void;
+};
+type Props = {
+    items: SourceItem[];
+    /** Listenin adı; verilmezse `labels.chat.sources`. */
+    label?: string;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Yanıtın kaynakları — numaralı liste; numara yanıttaki `Citation` ile eşleşir.
+ * Dış bağlantı yeni sekmede açılır ve `noopener` taşır; uygulama içi kaynak bir düğmedir.
+ */
+declare const SourceList: FC<Props>;
+declare const _default: typeof SourceList;
+export default _default;

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

@@ -0,0 +1,25 @@
+import { type FC } from 'react';
+export type TerminalChunk = {
+    stream: 'stdout' | 'stderr';
+    text: string;
+};
+type Props = {
+    /** Çalıştırılan komut — `$` istemiyle ilk satırda. */
+    command?: string;
+    chunks: TerminalChunk[];
+    /** Kaydırılabildiğinde bölgenin okunan adı ("Komut çıktısı"). */
+    label: string;
+    /** Gövdenin tavanı (px). */
+    maxHeight?: number;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Terminal çıktısı — MÜREKKEP yüzey, iki temada da koyu (`shell*`). Akarken sona yapışık kalır.
+ *
+ * ⚠ stderr satırı renkten başka bir işaret de taşır: görsel olarak gizli bir önek
+ * (`labels.chat.stderr`, "hata çıktısı"). Kırmızı tek başına anlam taşıyamaz (1.4.1).
+ */
+declare const TerminalOutput: FC<Props>;
+declare const _default: typeof TerminalOutput;
+export default _default;

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 @@
+/**
+ * @ahmetilhn/hanui/chat — sohbet ve uygulama bileşenleri. Dışa verilen her ad bir SÖZLEŞMEDİR.
+ *
+ * ⚠ Ana girişe ait HER ŞEY (bileşenler, `useHanui`, kancalar) paket adıyla alınır:
+ * `import { … } from '@ahmetilhn/hanui'`. 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 `@ahmetilhn/hanui/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/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;