@handijit/ui 0.0.0-stage → 2.0.0

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

@@ -0,0 +1,12 @@
+/**
+ * MEKÂNSAL KOVA — işaretçiye en yakın noktayı her harekette TÜM noktaları taramadan bulur.
+ * Noktalar sabit boyutlu piksel hücrelerine dağıtılır; arama yalnızca komşu hücrelerde.
+ */
+export type SpatialIndex = {
+    /** `(x, y)`ye `radius` içindeki en yakın noktanın dizini; yoksa `null`. */
+    nearest: (x: number, y: number, radius: number) => number | null;
+};
+export declare const spatialIndex: (points: readonly {
+    x: number;
+    y: number;
+}[], cell?: number) => SpatialIndex;

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 @@
+/**
+ * @handijit/ui/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 (`@handijit/ui`); göreli yol yalnızca durumsuz
+ * yardımcılar ve SCSS içindir. Nöbetçi `__tests__/subentry-boundary.test.ts`.
+ * Stiller `@handijit/ui/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 `--ui-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/format.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Kod bloğunun biçimlendiricisi. Her dilde başındaki ve sonundaki boş satırları atar (çitli
+ * bloğun son `\n`i gövdede boş bir satır çiziyordu); JSON'u yeniden girintiler.
+ * ⚠ Girinti başka hiçbir dilde DEĞİŞTİRİLMEZ: bir dosyadan alınmış parçanın girintisi o dosyadaki
+ * derinliği anlatıyor ve Python'da anlamın kendisi.
+ */
+export declare const formatCode: (code: string, language: string | undefined) => string;

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

@@ -0,0 +1,44 @@
+/**
+ * DİL TANIMLARI — yerleşik vurgulayıcının (`highlight.ts`) kuralları.
+ *
+ * Her dil SIRALI bir kural listesidir: aynı konumda eşleşen İLK kural kazanır. Kurallar tek bir
+ * düzenli ifadede birleşir (`gm` bayraklı), bu yüzden:
+ * - kural ifadeleri bayrak TAŞIMAZ ve YAKALAYAN GRUP içermez (`(?:…)` yazılır) — eşleşen kuralı
+ *   grubun sırası söyler;
+ * - geriye bakış (`(?<=…)`) KULLANILMAZ: Safari 16.4 öncesinde ifade kurulurken `SyntaxError`
+ *   atıyor ve kod bloğu çizilemiyordu. Önceki karaktere bağlı kurallar `reject` ile yazılır.
+ *
+ * ⚠ Kapanmamış yorum ve dize metnin SONUNA kadar uzanır (`(?![\s\S])`): akan yanıtta blok henüz
+ * bitmemişken renk doğru tarafta kalır.
+ *
+ * Kurallar ve kelime kümeleri ilk kullanımda kurulur (fabrika): modül düzeyinde çağrı yok, sohbet
+ * girişinden yalnızca başka bir bileşen alan uygulamaya vurgulayıcı inmez.
+ */
+/** Vurgulanan parçanın türü; her biri bir renk token'ına bağlanır (`index.module.scss`). */
+export type CodeTokenType = 'comment' | 'keyword' | 'string' | 'number' | 'name' | 'type' | 'punctuation' | 'inserted' | 'deleted';
+/**
+ * Kuralın türü. Bir `CodeTokenType` eşleşmeyi olduğu gibi boyar; ötekiler ek karar ister:
+ * - `word` — tanıtıcı; anahtar kelime / sabit / tip / çağrı ayrımını `classify` yapar
+ * - `tag` — `<ad` ya da `</ad`: ayraç noktalama, ad etiket (büyük harfle başlıyorsa bileşen → tip)
+ * - `markup` — işaretleme etiketinin tamamı; içi `MARKUP_TAG` ile ayrıca vurgulanır
+ * - `regex` — JS düzenli ifade değişmezi; `/` bölme işareti de olabildiği için bağlama bakılır
+ */
+export type RuleKind = CodeTokenType | 'word' | 'tag' | 'markup' | 'regex';
+/** `[tür, ifade, reject?]` — `reject` eşleşmeden ÖNCEKİ karaktere uyarsa eşleşme reddedilir. */
+export type Rule = readonly [kind: RuleKind, pattern: RegExp, reject?: RegExp];
+export type Grammar = {
+    rules: readonly Rule[];
+    keywords?: ReadonlySet<string>;
+    /** Sabit değişmezler (`true`, `null`, `None`) — sayıyla aynı renk. */
+    literals?: ReadonlySet<string>;
+    /** Yerleşik tipler (`string`, `int`, `varchar`). */
+    types?: ReadonlySet<string>;
+    /** Büyük harfle başlayan ad tiptir (`Button`); TAMAMI büyük harf olan sabittir (`MAX_SIZE`). */
+    hasCapitalTypes?: boolean;
+    /** SQL: anahtar kelime ve tip kümesi küçük harfle yazılır, kelime küçültülerek aranır. */
+    isCaseInsensitive?: boolean;
+};
+/** İşaretleme etiketinin İÇİ (`markup` kuralının eşleşmesi): ad, öznitelik, değer. */
+export declare const MARKUP_TAG: () => Grammar;
+/** Dil adı (küçük harf) → dil. Takma adlar aynı fabrikayı gösterir; önbellek fabrikaya bağlı. */
+export declare const GRAMMARS: Readonly<Record<string, () => Grammar>>;

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

@@ -0,0 +1,22 @@
+import { type CodeTokenType } from './grammars';
+export type { CodeTokenType } from './grammars';
+/** Vurgulanmış bir parça; `type` yoksa düz metin. */
+export type CodeToken = {
+    text: string;
+    type?: CodeTokenType;
+};
+/**
+ * Bu boyun üstündeki kod VURGULANMAZ, düz çizilir.
+ * ⚠ Maliyet çözümlemede DEĞİL, `<span>` sayısında. Ölçüldü (chromium, galeri sunucusu, React
+ * geliştirme kipi): 50 000 karakterlik TypeScript 8,5 ms'de 4 333 parçaya ayrılıyor, ama yalnızca
+ * DOM kurulumu + yerleşim 66 ms, React'in ilk çizimi 590 ms ve akan yanıtta her güncelleme 173 ms.
+ * 20 000 karakterde aynı ölçüm 3,8 ms · 1 555 parça · 17 ms · 139 ms · 78 ms. Sınırın altında renk,
+ * üstünde akıcılık; ~500 satırdan uzun bir sohbet bloğu zaten istisna.
+ */
+export declare const HIGHLIGHT_LIMIT = 20000;
+/**
+ * Kodu renk parçalarına ayırır — bağımlılıksız, tek geçişlik bir sözcük çözümleyici.
+ * Bir dilbilgisi ÇÖZÜMLEYİCİSİ değil: Shiki düzeyinde doğruluk gerekiyorsa vurgulanmış HTML
+ * `CodeBlock`a `html` olarak verilir.
+ */
+export declare const highlight: (code: string, language: string | undefined) => CodeToken[];

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

@@ -0,0 +1,33 @@
+import { type FC } from 'react';
+type Props = {
+    /** Ham kod. `html` yoksa biçimlendirilip vurgulanır; kopyalanan metin ekranda görünendir. */
+    code: string;
+    /**
+     * Dil adı (`ts`, `json`, `bash`, `diff`…); başlık şeridinde, kopyalama düğmesinin adında ve
+     * vurgulayıcının seçiminde. Tanınmayan dil düz çizilir.
+     */
+    language?: string;
+    /**
+     * ÖNCEDEN VURGULANMIŞ HTML (Shiki çıktısı) — yerleşik vurgulayıcının yerine geçer; `code`
+     * biçimlendirilmez ve olduğu gibi kopyalanır.
+     * ⚠ 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.
+ *
+ * Yerleşik vurgulayıcı ve biçimlendirici (bağımlılıksız): renkler `syntax-*` token'larından,
+ * yani temayla döner ve kontrastı derlemede ölçülür. JSON yeniden girintilenir, kenarlardaki boş
+ * satırlar atılır. Shiki düzeyinde doğruluk gerekiyorsa `html` verilir; Shiki'nin çift tema
+ * çıktısı (`--shiki-light` / `--shiki-dark`) burada temaya bağlanır.
+ * 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,21 @@
+import { type FC } from 'react';
+/** The data series tokens of `@handijit/design` (`chart-1…6`) + `muted` for a waiting or empty part. */
+export type LegendTone = 'chart-1' | 'chart-2' | 'chart-3' | 'chart-4' | 'chart-5' | 'chart-6' | 'muted';
+export type LegendItem = {
+    id: string;
+    label: string;
+    tone: LegendTone;
+};
+type Props = {
+    items: LegendItem[];
+    className?: string;
+    testId?: string;
+};
+export declare const legendToneColor: (tone: LegendTone) => 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;
+ * ui 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ı, sohbet kullanmayan tüketicinin 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;