@ahmetilhn/hanui 5.3.2 → 5.5.0

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

@@ -1,11 +1,15 @@
 import { type FC } from 'react';
 type Props = {
-    /** Ham kod — kopyalanan ve `html` yokken çizilen metin. */
+    /** Ham kod. `html` yoksa biçimlendirilip vurgulanır; kopyalanan metin ekranda görünendir. */
     code: string;
-    /** Dil adı; başlık şeridinde ve kopyalama düğmesinin adında. */
+    /**
+     * 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ı). Verilmezse düz `<pre>` çizilir.
+     * Ö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.
      */
@@ -18,8 +22,10 @@ type Props = {
 /**
  * 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.
+ * 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>;

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

@@ -201,3 +201,19 @@ export declare const CATEGORY: {
     readonly series2: "#8f3beb";
     readonly series2Dark: "#b699eb";
 };
+/**
+ * SÖZDİZİMİ — `CodeBlock`ın vurgulayıcısı; kategorik tonlar METİN aydınlığında (≥4,5:1).
+ * ⚠ Yeşil yok: fark satırının yeşili bir durum (`ok-fg`), sözdizimi rengi değil.
+ */
+export declare const SYNTAX: {
+    readonly keyword: "#a4277a";
+    readonly keywordDark: "#f691cc";
+    readonly string: "#9d451f";
+    readonly stringDark: "#f59e7c";
+    readonly number: "#7b2dcd";
+    readonly numberDark: "#c2a7f5";
+    readonly name: "#2063b0";
+    readonly nameDark: "#8dbaf5";
+    readonly type: "#76611f";
+    readonly typeDark: "#d9b341";
+};

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

@@ -128,6 +128,23 @@ export declare const LIGHT_THEME: {
 };
 /** KOYU TEMA. */
 export declare const DARK_THEME: Record<keyof typeof LIGHT_THEME, string>;
+/**
+ * SÖZDİZİMİ TOKEN'LARI — `CodeBlock`ın vurgulayıcısı. Kategorik tonlar METİN aydınlığında: kod
+ * gövdesinde (`surface-inset`) ve üç yüzeyde ≥4,5:1. Yorum `text-3`, noktalama `text-2` — ayrı
+ * token değil. `syntax-name`: işlev çağrısı, özellik/anahtar, öznitelik, değişken.
+ * ⚠ Temaya bağlı ama ANA TABLODA DEĞİL. Yalnızca sohbet girişi kullanıyor; `LIGHT_THEME`e
+ * girdiklerinde çalışma zamanı tablosuyla HER bileşenin paketine biniyorlardı (ölçüldü: yalnızca
+ * `Button` alan uygulama 5,12 → 5,28 kB, `styles.css` +0,1 kB). Değişkenleri `chat.css` taşır
+ * (`_syntax.generated.scss`); ezme CSS'te (`--hanui-syntax-*`), `HanuiProvider theme`inde değil.
+ */
+export declare const SYNTAX_LIGHT_THEME: {
+    readonly 'syntax-keyword': "#a4277a";
+    readonly 'syntax-string': "#9d451f";
+    readonly 'syntax-number': "#7b2dcd";
+    readonly 'syntax-name': "#2063b0";
+    readonly 'syntax-type': "#76611f";
+};
+export declare const SYNTAX_DARK_THEME: Record<keyof typeof SYNTAX_LIGHT_THEME, string>;
 /** ÖLÇÜ TOKEN'LARI — temadan bağımsız, çalışma zamanında EZİLEBİLİR. */
 export declare const METRIC_TOKENS: {
     readonly 'radius-xs': "4px";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahmetilhn/hanui",
-  "version": "5.3.2",
+  "version": "5.5.0",
   "description": "Accessible, theme-driven React component library built on SCSS Modules. Bootstrap Icons for shell iconography, two built-in themes and a fully overridable design-token contract.",
   "author": "Ahmet ilhan <ahmetilhan.dev@gmail.com>",
   "license": "MIT",