@handijit/ui 0.0.0-stage → 1.0.0

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,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;
+ * 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;

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;