@handijit/ui 0.0.0-stage → 1.0.0

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

@@ -0,0 +1,36 @@
+import { type ValueFormat } from '../core/format';
+import { type ChartTone } from '../core/palette';
+export type PieSlice = {
+    id: string;
+    label: string;
+    value: number;
+    tone?: ChartTone;
+};
+type Props = {
+    label: string;
+    description?: string;
+    data: readonly PieSlice[];
+    /** `donut` ortası boş halka; ortaya `centerLabel` / `centerValue` yazılır. */
+    variant?: 'pie' | 'donut';
+    /** Halkanın ortasındaki büyük değer (toplam); verilmezse görünür dilimlerin toplamı. */
+    centerValue?: string;
+    /** Halkanın ortasındaki küçük yazı ("Toplam"). */
+    centerLabel?: string;
+    /** Değerin adı (tablo sütunu). */
+    valueLabel: string;
+    height?: number;
+    width?: number;
+    formatValue?: ValueFormat;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Pasta / halka grafiği — bir bütünün parçaları. Dilim sırası verinin sırası (saat 12'den, saat
+ * yönünde). Sıfır ve eksi değer dilim açmaz (bütünün parçası olamaz); tabloda görünür.
+ * ⚠ Altıdan çok dilim okunmaz — kategorik palet altı tonda döner; uzun kuyruğu "Diğer"de toplayın.
+ *
+ * Klavye: `←`/`→` önceki/sonraki dilim · `Home`/`End` · `Escape`.
+ */
+declare const PieChart: ({ label, description, data, variant, centerValue, centerLabel, valueLabel, height, width: fixedWidth, formatValue, className, testId, }: Props) => import("react").JSX.Element;
+declare const _default: typeof PieChart;
+export default _default;

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

@@ -0,0 +1,40 @@
+import { type ValueFormat } from '../core/format';
+import { type ChartTone } from '../core/palette';
+export type RadarAxis = {
+    key: string;
+    label: string;
+};
+export type RadarSeries = {
+    id: string;
+    label: string;
+    /** Eksen anahtarı → değer. Eksik ya da `null` değer merkezde çizilir, ipucunda "—" okunur. */
+    values: Readonly<Record<string, number | null | undefined>>;
+    tone?: ChartTone;
+};
+type Props = {
+    label: string;
+    description?: string;
+    /** Saat 12'den saat yönünde dizilen eksenler. ⚠ Üçten az eksen bir alan çizmez. */
+    axes: readonly RadarAxis[];
+    series: readonly RadarSeries[];
+    /**
+     * Ortak ölçeğin üst ucu. Verilmezse en büyük değerden "güzel" bir sayıya yuvarlanır.
+     * ⚠ Bütün eksenler AYNI ölçeği paylaşır: birimleri farklı eksenleri önce normalleştirin (0-100).
+     */
+    max?: number;
+    height?: number;
+    width?: number;
+    formatValue?: ValueFormat;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Radar (örümcek) grafiği — birkaç serinin aynı eksen takımında karşılaştırılması. Izgara
+ * ÇOKGEN (çember değil): değer eksen üzerinde okunur, eksenler arası eğri bir değer vaat etmez.
+ *
+ * Etkileşim EKSEN başınadır: işaretçi en yakın ekseni seçer ve ipucu o eksendeki bütün serileri
+ * okur. Klavye: `←`/`→` önceki/sonraki eksen · `Home`/`End` · `Escape`.
+ */
+declare const RadarChart: ({ label, description, axes, series, max, height, width: fixedWidth, formatValue, className, testId, }: Props) => import("react").JSX.Element;
+declare const _default: typeof RadarChart;
+export default _default;

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

@@ -0,0 +1,41 @@
+import { type ValueFormat } from '../core/format';
+import { type ChartTone } from '../core/palette';
+export type ScatterPoint = {
+    x: number;
+    y: number;
+    /** Balon grafiği: noktanın büyüklüğü (alanla orantılı). */
+    size?: number;
+    /** Noktanın adı (ipucu ve tablo). */
+    label?: string;
+};
+export type ScatterSeries = {
+    id: string;
+    label: string;
+    tone?: ChartTone;
+    data: readonly ScatterPoint[];
+};
+type Props = {
+    label: string;
+    description?: string;
+    series: readonly ScatterSeries[];
+    /** Eksen ve tablo başlıkları. */
+    xLabel: string;
+    yLabel: string;
+    /** Balon grafiğinde büyüklüğün adı ("Nüfus"); verilmezse ipucunda büyüklük satırı yok. */
+    sizeLabel?: string;
+    height?: number;
+    width?: number;
+    formatX?: ValueFormat;
+    formatY?: ValueFormat;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Saçılım grafiği — iki sayısal değişkenin ilişkisi; `size` ile balon grafiği.
+ * İsabet: mekânsal kova (her harekette tüm noktalar taranmaz). Klavye noktaları x sırasıyla gezer.
+ *
+ * Klavye: `←`/`→` önceki/sonraki nokta · `Home`/`End` · `Escape`.
+ */
+declare const ScatterPlot: ({ label, description, series, xLabel, yLabel, sizeLabel, height, width: fixedWidth, formatX, formatY, className, testId, }: Props) => import("react").JSX.Element;
+declare const _default: typeof ScatterPlot;
+export default _default;

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

@@ -0,0 +1,43 @@
+import { type CartesianSeries, type Orientation } from './cartesian';
+import { type ValueFormat } from './format';
+import type { Curve } from './path';
+/** Veri satırı — x alanı ve seri alanları; eksik değer `null`. */
+export type ChartRow = Record<string, string | number | null | undefined>;
+export type CartesianChartProps = {
+    /** Grafiğin okunan adı. */
+    label: string;
+    /** Okunan ek açıklama — eğilimi bir cümleyle söyler. */
+    description?: string;
+    data: readonly ChartRow[];
+    /** Satırdaki x alanının adı. */
+    xKey: string;
+    /** Veri tablosunun ilk sütun başlığı; verilmezse `xKey`. */
+    xLabel?: string;
+    series: readonly (CartesianSeries & {
+        format?: ValueFormat;
+    })[];
+    /** Yükseklik (px). Genişlik kapsayıcıdan ölçülür. */
+    height?: number;
+    /** Sabit genişlik (px) — ölçüm yapılmaz. */
+    width?: number;
+    isStacked?: boolean;
+    orientation?: Orientation;
+    curve?: Curve;
+    /** Çizgi üzerinde her veri noktası. Çok noktalı seride kapalı tutun. */
+    hasPoints?: boolean;
+    /** x değerinin yazısı (eksen, ipucu, tablo). */
+    formatX?: (value: string | number) => string;
+    /** Değerin yazısı (ipucu, tablo); seri kendi `format`ını verebilir. Eksen kısa gösterimde. */
+    formatValue?: ValueFormat;
+    /** Sol değer ekseninin sabit uçları. */
+    domain?: readonly [number | undefined, number | undefined];
+    className?: string;
+    testId?: string;
+};
+/**
+ * Kartezyen grafik — Çizgi, Alan, Çubuk ve Bileşik grafiğin ortak gövdesi. Dışa `LineChart`,
+ * `AreaChart`, `BarChart`, `ComposedChart` olarak verilir.
+ */
+declare const CartesianChart: ({ label, description, data, xKey, xLabel, series, height, width: fixedWidth, isStacked, orientation, curve, hasPoints, formatX, formatValue, domain, className, testId, }: CartesianChartProps) => import("react").JSX.Element;
+declare const _default: typeof CartesianChart;
+export default _default;

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

@@ -0,0 +1,55 @@
+import { type ReactNode, type RefObject } from 'react';
+import type { ChartTable, LegendEntry, TooltipContent } from './types';
+export type ChartFrameProps = {
+    /** Grafiğin okunan adı. */
+    label: string;
+    /** Okunan ek açıklama — eğilimi bir cümleyle söyler ("Ekimde %12 artış"). */
+    description?: string;
+    containerRef: RefObject<HTMLDivElement | null>;
+    width: number;
+    height: number;
+    /** Ağır çizim — BELLEĞE ALINMIŞ öğe; üzerine gelindiğinde yeniden çizilmez. */
+    plot: ReactNode;
+    /** Etkin öğenin vurgusu (kılavuz çizgi, halka, nokta) — çizimin ÜSTÜNDE. */
+    overlay: (active: number) => ReactNode;
+    /** Çizimin ALTINDAKİ vurgu (çubuk bandının zemini): üstte olsaydı çubuğun rengini değiştirirdi. */
+    underlay?: (active: number) => ReactNode;
+    /** Klavye ve işaretçiyle gezilen öğe sayısı. */
+    itemCount: number;
+    /** Izgarada gezinme (ısı haritası): satır uzunluğu. Verilirse ↑/↓ satır atlar. */
+    columns?: number;
+    /** İşaretçi → öğe; isabet yoksa `null`. Koordinatlar çizim kutusuna göre. */
+    pick: (x: number, y: number) => number | null;
+    tooltip: (index: number) => TooltipContent;
+    /** İpucunun bağlandığı nokta. */
+    anchor: (index: number) => {
+        x: number;
+        y: number;
+    };
+    /**
+     * İpucunun noktanın hangi yanında açılacağı. `inward` (kartezyen): merkeze bakan yan — kenardaki
+     * nokta ipucunu kutunun dışına itmez. `outward` (pasta, radar): merkezden uzak yan — içeride
+     * çizimin kendisini (halkanın ortasındaki toplamı) örtüyordu. `inward` sığmayınca öteki yana
+     * çevrilir, `outward` kutunun kenarına kırpılır.
+     */
+    tooltipSide?: 'inward' | 'outward';
+    /** Klavyeyle gelinen öğenin okunan özeti. */
+    announce: (index: number) => string;
+    table: ChartTable;
+    legend?: {
+        entries: LegendEntry[];
+        hidden: ReadonlySet<string>;
+        onToggle: (id: string) => void;
+    };
+    className?: string;
+    testId?: string;
+};
+/**
+ * Grafik çerçevesi — ölçüm kutusu, SVG, ipucu, lejant ve gizli veri tablosu.
+ *
+ * Klavye (grafik tek bir sekme durağı): `→`/`↓` sonraki öğe · `←`/`↑` önceki öğe (ızgarada `↑`/`↓`
+ * satır) · `Home`/`End` ilk/son · `Escape` vurguyu kaldırır. Gelinen öğe duyurulur.
+ * İşaretçi: tek bir dinleyici, kare başına bir isabet hesabı (`requestAnimationFrame`).
+ */
+declare const ChartFrame: ({ label, description, containerRef, width, height, plot, overlay, underlay, itemCount, columns, pick, tooltip, anchor, tooltipSide, announce, table, legend, className, testId, }: ChartFrameProps) => import("react").JSX.Element;
+export default ChartFrame;

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

@@ -0,0 +1,37 @@
+import type { TickFormat } from './format';
+import type { PlotArea } from './types';
+export type Tick = {
+    /** Eksen boyunca konum (px). */
+    position: number;
+    label: string;
+};
+/** Bölme değerlerini konumlu bölmelere çevirir. Yazılar LİSTE olarak biçimlenir — basamak tüm bölmelerden. */
+export declare const placeTicks: (values: readonly number[], scale: (value: number) => number, format: TickFormat) => Tick[];
+/** Bir karakterin yaklaşık genişliği (px) — 11 px eksen yazısında ölçülmüş ortalama. */
+export declare const CHAR_WIDTH = 6.4;
+/** Etiketin kaplayacağı yaklaşık genişlik. Ölçüm (DOM) yerine tahmin: sunucuda da çalışır. */
+export declare const labelWidth: (label: string) => number;
+/**
+ * Üst üste binecek etiketleri SEYRELTİR: her `k`. etiket kalır. Bölme çizgisi ve veri yerinde;
+ * yalnızca yazı atlanır.
+ */
+export declare const thinTicks: (ticks: readonly Tick[], minGap?: number) => Tick[];
+/** Metni yaklaşık genişliğe sığdırır (yatay çubuk grafiğinin kategori etiketleri). */
+export declare const fitLabel: (label: string, width: number) => string;
+type ValueAxisProps = {
+    area: PlotArea;
+    ticks: readonly Tick[];
+    side: 'left' | 'right' | 'bottom';
+    /** Izgara çizgileri — yalnızca bir eksen çizer (sol ya da alt), iki ızgara üst üste binmesin. */
+    hasGrid?: boolean;
+};
+/** Değer ekseni: bölme yazıları + ızgara. Eksen ÇİZGİSİ yok — ızgara yeter, mürekkep tasarrufu. */
+export declare const ValueAxis: ({ area, ticks, side, hasGrid }: ValueAxisProps) => import("react").JSX.Element;
+type CategoryAxisProps = {
+    area: PlotArea;
+    ticks: readonly Tick[];
+    side: 'bottom' | 'left';
+};
+/** Kategori ekseni: taban çizgisi + yazılar (seyreltilmiş). */
+export declare const CategoryAxis: ({ area, ticks, side }: CategoryAxisProps) => import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,80 @@
+/** KARTEZYEN GEOMETRİ — Çizgi, Alan, Çubuk ve Bileşik grafiğin ortak, saf (DOM'suz) motoru. */
+import { type Tick } from './axes';
+import type { TickFormat } from './format';
+import { type ChartTone } from './palette';
+import { type Curve, type MaybePoint } from './path';
+import type { PlotArea } from './types';
+export type CartesianSeriesType = 'line' | 'area' | 'bar';
+export type CartesianSeries = {
+    /** Satırdaki alanın adı. */
+    key: string;
+    label: string;
+    type: CartesianSeriesType;
+    tone?: ChartTone;
+    /** İkinci değer ekseni (sağ) — farklı birimdeki seri. */
+    axis?: 'left' | 'right';
+};
+export type Orientation = 'vertical' | 'horizontal';
+export type CartesianInput = {
+    rows: readonly Record<string, unknown>[];
+    xKey: string;
+    /** Yalnızca GÖRÜNÜR seriler, tonları çözülmüş. */
+    series: readonly (CartesianSeries & {
+        tone: ChartTone;
+    })[];
+    width: number;
+    height: number;
+    isStacked: boolean;
+    orientation: Orientation;
+    curve: Curve;
+    formatX: (value: unknown) => string;
+    /** Değer ekseni bölmeleri — basamak listeden çıktığı için LİSTE alır. */
+    formatLeft: TickFormat;
+    formatRight: TickFormat;
+    /** Değer ekseninin sabit uçları; verilmeyen uç veriden. */
+    domain?: readonly [number | undefined, number | undefined];
+};
+export type BarShape = {
+    key: string;
+    index: number;
+    tone: ChartTone;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type CartesianGeometry = {
+    area: PlotArea;
+    /** Kategori ekseni boyunca her satırın merkezi (px). */
+    centers: number[];
+    /** Kategori bandının genişliği; sürekli eksende 0. */
+    bandwidth: number;
+    isContinuous: boolean;
+    categoryTicks: Tick[];
+    leftTicks: Tick[];
+    rightTicks: Tick[];
+    hasRightAxis: boolean;
+    lines: {
+        key: string;
+        tone: ChartTone;
+        d: string;
+    }[];
+    areas: {
+        key: string;
+        tone: ChartTone;
+        d: string;
+    }[];
+    bars: BarShape[];
+    /** Seri → dizin → çizgi/alan noktası (vurgu halkası için). */
+    points: Record<string, MaybePoint[]>;
+    /** Dizin → ipucunun bağlanacağı en üst değer noktası. */
+    anchors: {
+        x: number;
+        y: number;
+    }[];
+    /** Sol değer ekseninde SIFIRIN konumu — yalnızca tanım aralığı eksiye indiğinde (yoksa `null`). */
+    zero: number | null;
+};
+/** Sayıya çevirir; sonlu olmayan değer `null` (eksik veri). */
+export declare const toNumber: (value: unknown) => number | null;
+export declare const cartesianGeometry: (input: CartesianInput) => CartesianGeometry;

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

@@ -0,0 +1,19 @@
+/** SAYI BİÇİMİ — eksen ve ipucu metni. Dil `labels.locale`ten, verilmezse tarayıcının dili. */
+export type ValueFormat = (value: number) => string;
+/** Eksen bölmelerinin yazısı — tek değerden değil LİSTEDEN: gereken basamak bölmelerin hepsinden çıkar. */
+export type TickFormat = (values: readonly number[]) => string[];
+/**
+ * Eksen bölmeleri: KISA gösterim ("12 B", "1,2 Mn"). Uzun bir sayı dar bir eksende üst üste biniyor;
+ * tam değer ipucunda ve veri tablosunda okunur.
+ *
+ * Basamak sayısı bölmelerin HEPSİNİ tam yazan en az basamak: en küçük anlamlı basamağı en ince olan
+ * bölme belirler, her bölme o basamağa kadar yazılır. 0,005 adımlı eksen "0 · 0,005 · 0,01 · 0,015",
+ * 50 adımlı "12 B · 12,05 B · 12,1 B".
+ *
+ * ⚠ Eskiden sabit "en çok bir ondalık" yazıyordu ve adımı 0,1'in altında kalan HER eksen sıfıra
+ * çöküyordu: 0,001-0,014 USD'lik maliyet grafiği "0 · 0 · 0 · 0" okunuyordu (ölçüldü: tüketicide).
+ * Kısa gösterimde de aynı hata vardı — 12 050 ile 12 100 ikisi de "12,1 B".
+ */
+export declare const tickLabels: (locale?: string) => TickFormat;
+/** İpucu ve tablo: tam değer, en çok iki ondalık. */
+export declare const fullNumber: (locale?: string) => ValueFormat;

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

@@ -0,0 +1,9 @@
+import type { PlotArea } from './types';
+/** Çizim alanı — sol kenar en uzun sol bölme yazısı kadar, alt kenar x yazıları için. */
+export declare const plotArea: (width: number, height: number, leftLabels: readonly string[], { top, right, bottom }?: {
+    top?: number | undefined;
+    right?: number | undefined;
+    bottom?: number | undefined;
+}) => PlotArea;
+/** Eksen başına bölme sayısı: yatayda ~90 px, dikeyde ~48 px'te bir. */
+export declare const tickCount: (length: number, horizontal: boolean) => number;

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

@@ -0,0 +1,13 @@
+/**
+ * SERİ RENKLERİ — ui kategorik paleti (`cat-1…5`, `series-2`). Her ton iki temanın üç
+ * yüzeyinde ≥3:1 (`check:contrast`) ve iki ton arasında ΔE ≥ 8 (palet üreteci).
+ * ⚠ Marka yeşilleri (çam, mint) seri rengi OLMAZ: yeşil eylemin rengi. `cat-3` orta aydınlıkta bir
+ * kategori yeşili.
+ */
+export type ChartTone = 'cat-1' | 'cat-2' | 'cat-3' | 'cat-4' | 'cat-5' | 'series-1' | 'series-2' | 'muted';
+/** Sıra: ilk iki seri en uzak iki ton (mavi, kil) — iki serili grafik en sık durum. */
+export declare const TONE_ORDER: readonly ChartTone[];
+/** Verilmeyen tonu sıradan alır; altıdan fazla seride döner (lejant adı ayırt eder). */
+export declare const toneAt: (index: number, tone?: ChartTone) => ChartTone;
+/** CSS rengi — tema değişince yeniden çizim gerekmez, değişken çözülür. */
+export declare const toneColor: (tone: ChartTone) => string;

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

@@ -0,0 +1,24 @@
+/** SVG YOLLARI — dize üretimi; DOM'a dokunmaz, saf fonksiyon (test edilebilir, sunucuda çalışır). */
+export type Point = {
+    x: number;
+    y: number;
+};
+/** `null` boşluk demektir: çizgi orada KESİLİR, sıfıra inmez (eksik veri ≠ sıfır). */
+export type MaybePoint = Point | null;
+export type Curve = 'linear' | 'monotone';
+/** Çizgi yolu; `null` noktalarda kesilir. */
+export declare const linePath: (points: readonly MaybePoint[], curve?: Curve) => string;
+/**
+ * Alan yolu: üst çizgi + taban çizgisi (yığılmış alanda bir alttaki serinin üstü). Her kesintisiz
+ * parça kendi kapalı şekli.
+ */
+export declare const areaPath: (top: readonly MaybePoint[], base: readonly MaybePoint[], curve?: Curve) => string;
+/** Kutupsal → kartezyen; açı radyan, 0 = saat 12 yönü, saat yönünde artar. */
+export declare const polar: (cx: number, cy: number, radius: number, angle: number) => Point;
+/**
+ * Halka / pasta dilimi. `inner` 0 ise pasta. ⚠ Tam tur (2π) TEK bir yay olarak çizilemez (başlangıç
+ * ve bitiş aynı nokta, yay kaybolur); iki yarım yaya bölünür.
+ */
+export declare const arcPath: (cx: number, cy: number, outer: number, inner: number, start: number, end: number) => string;
+/** Kapalı çokgen (radar). */
+export declare const polygonPath: (points: readonly Point[]) => string;

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

@@ -0,0 +1,40 @@
+/** ÖLÇEKLER — değer → piksel. Grafik kütüphanesi bağımlılığı yok; davranış testlerde sabit. */
+export type LinearScale = {
+    (value: number): number;
+    domain: readonly [number, number];
+    range: readonly [number, number];
+    invert: (pixel: number) => number;
+};
+export type BandScale = {
+    /** Kategorinin bandının BAŞLANGICI (px). Bilinmeyen kategori `NaN`. */
+    (key: string): number;
+    domain: readonly string[];
+    range: readonly [number, number];
+    /** Bandın genişliği — çubuğun kalınlığı. */
+    bandwidth: number;
+    /** İki bant başlangıcı arası. */
+    step: number;
+    /** Piksele en yakın kategorinin dizini (`-1`: boş ölçek). */
+    indexAt: (pixel: number) => number;
+};
+/** Doğrusal ölçek. Sıfır genişlikli tanım aralığı aralığın ortasına eşlenir (bölme hatası yok). */
+export declare const scaleLinear: (domain: readonly [number, number], range: readonly [number, number]) => LinearScale;
+/**
+ * Kategorik (band) ölçek. `paddingInner` bantlar arası boşluğun adıma oranı, `paddingOuter` iki
+ * uçtaki boşluğun adıma oranı.
+ */
+export declare const scaleBand: (domain: readonly string[], range: readonly [number, number], { paddingInner, paddingOuter }?: {
+    paddingInner?: number | undefined;
+    paddingOuter?: number | undefined;
+}) => BandScale;
+/** 1-2-5 × 10ⁿ adımı — "güzel" eksen bölmesi. */
+export declare const tickStep: (min: number, max: number, count: number) => number;
+/**
+ * Tanım aralığını adımın katlarına genişletir — eksen "güzel" bir sayıda başlar ve biter.
+ * ⚠ Tek değerli (ya da boş) aralık genişletilir: 0 → [0, 1], 5 → [0, 8]; aksi hâlde ölçek çöker.
+ */
+export declare const niceDomain: (min: number, max: number, count?: number) => [number, number];
+/** Aralığı kapsayan bölme değerleri; uçlar dahil. */
+export declare const ticks: (min: number, max: number, count?: number) => number[];
+/** Sıralı dizide değere en yakın öğenin dizini — işaretçi isabeti için ikili arama. */
+export declare const nearestIndex: (sorted: readonly number[], value: number) => number;

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

@@ -0,0 +1,11 @@
+import type { CartesianSeries } from './cartesian';
+import type { ValueFormat } from './format';
+/** Türü sarmalayıcının sabitlediği seri: Çizgi, Alan, Çubuk. */
+export type ChartSeries = Omit<CartesianSeries, 'type'> & {
+    /** Bu serinin değer yazısı (ipucu, tablo) — birimi farklı seri. */
+    format?: ValueFormat;
+};
+/** Bileşik grafiğin serisi: türü seri başına. */
+export type ComposedSeries = CartesianSeries & {
+    format?: ValueFormat;
+};

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;