@ahmetilhn/hanui 4.0.0 → 5.3.0

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

@@ -0,0 +1,14 @@
+import { type CartesianChartProps } from '../core/CartesianChart';
+import type { ChartSeries } from '../core/series';
+type Props = Omit<CartesianChartProps, 'series' | 'orientation'> & {
+    series: readonly ChartSeries[];
+};
+/**
+ * Alan grafiği — çizginin altı dolu; `isStacked` ile seriler üst üste (bütünün parçaları).
+ * Taban SIFIR: alanın yüksekliği değerin kendisi, kırpılmış bir eksen alanı yanlış oranda gösterir.
+ *
+ * Klavye: `←`/`→` önceki/sonraki x · `Home`/`End` · `Escape`.
+ */
+declare const AreaChart: ({ series, ...rest }: Props) => import("react").JSX.Element;
+declare const _default: typeof AreaChart;
+export default _default;

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

@@ -0,0 +1,16 @@
+import { type CartesianChartProps } from '../core/CartesianChart';
+import type { ChartSeries } from '../core/series';
+type Props = Omit<CartesianChartProps, 'series' | 'curve' | 'hasPoints'> & {
+    series: readonly ChartSeries[];
+};
+/**
+ * Çubuk / sütun grafiği — kategoriler arası karşılaştırma. Birden çok seri yan yana (gruplu) ya da
+ * `isStacked` ile üst üste; `orientation="horizontal"` uzun kategori adları için (etiket kesilmez,
+ * sığmazsa "…" ile kısalır, tam adı ipucu ve tabloda).
+ * Eksi değer sıfırın ALTINA iner; yığında artı ve eksi ayrı birikir.
+ *
+ * Klavye: `←`/`→` (ya da `↑`/`↓`) önceki/sonraki kategori · `Home`/`End` · `Escape`.
+ */
+declare const BarChart: ({ series, ...rest }: Props) => import("react").JSX.Element;
+declare const _default: typeof BarChart;
+export default _default;

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

@@ -0,0 +1,43 @@
+import { type ValueFormat } from '../core/format';
+import { type ChartTone } from '../core/palette';
+export type BoxPlotGroup = {
+    id: string;
+    label: string;
+    /** Ham gözlemler — beş sayı özeti ve aykırılar bileşende hesaplanır (Tukey, 1,5 × IQR). */
+    values: readonly number[];
+    tone?: ChartTone;
+};
+/** Özetin okunan adları — metin kütüphaneden gelmez. */
+export type BoxPlotLabels = {
+    min: string;
+    q1: string;
+    median: string;
+    q3: string;
+    max: string;
+    outliers: string;
+    count: string;
+};
+type Props = {
+    label: string;
+    description?: string;
+    groups: readonly BoxPlotGroup[];
+    /** Grup ekseninin ve tablonun ilk sütun başlığı. */
+    groupLabel: string;
+    labels: BoxPlotLabels;
+    height?: number;
+    width?: number;
+    formatValue?: ValueFormat;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Kutu grafiği — grupların dağılımını karşılaştırır: kutu Q1–Q3, çizgi medyan, bıyıklar 1,5 × IQR
+ * içindeki en uç gözlem, dışarıdakiler nokta (aykırı).
+ * ⚠ Bıyık ucu bir HESAP değil bir GÖZLEM: Q3 + 1,5 × IQR'ye kadar çizmek, verinin hiç ulaşmadığı
+ * bir değeri gösterirdi.
+ *
+ * Klavye: `←`/`→` önceki/sonraki grup · `Home`/`End` · `Escape`.
+ */
+declare const BoxPlot: ({ label, description, groups, groupLabel, labels: summaryLabels, height, width: fixedWidth, formatValue, className, testId, }: Props) => import("react").JSX.Element;
+declare const _default: typeof BoxPlot;
+export default _default;

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

@@ -0,0 +1,16 @@
+import { type CartesianChartProps } from '../core/CartesianChart';
+import type { ComposedSeries } from '../core/series';
+type Props = Omit<CartesianChartProps, 'series' | 'orientation'> & {
+    /** Seri başına tür (`line` / `area` / `bar`) ve eksen (`left` / `right`). */
+    series: readonly ComposedSeries[];
+};
+/**
+ * Bileşik grafik — çubuk, çizgi ve alan aynı x ekseninde; farklı birimdeki seri SAĞ eksene
+ * (`axis: 'right'`). Çizim sırası: alan → çubuk → çizgi (çizgi her zaman görünür kalır).
+ * ⚠ İki eksen okuyucuyu yanıltabilir: sağ eksendeki seri `format` ile kendi birimini söylemeli.
+ *
+ * Klavye: `←`/`→` önceki/sonraki x · `Home`/`End` · `Escape`.
+ */
+declare const ComposedChart: (props: Props) => import("react").JSX.Element;
+declare const _default: typeof ComposedChart;
+export default _default;

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

@@ -0,0 +1,30 @@
+import { type ValueFormat } from '../core/format';
+import { type ChartTone } from '../core/palette';
+type Props = {
+    label: string;
+    description?: string;
+    /** Sütun adları (x). */
+    columns: readonly string[];
+    /** Satır adları (y). */
+    rows: readonly string[];
+    /** `values[satır][sütun]`; `null` boş hücre (veri yok — sıfır değil). */
+    values: readonly (readonly (number | null)[])[];
+    /** Hücre değerinin adı ("Sipariş"). */
+    valueLabel: string;
+    tone?: ChartTone;
+    height?: number;
+    width?: number;
+    formatValue?: ValueFormat;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Isı haritası — iki kategorik boyutta bir değerin yoğunluğu. Renk TEK TONUN yoğunluğu
+ * (sıralı ölçek): çok renkli bir ölçek düşük-yüksek sırasını okutmuyordu.
+ * Değer renk tek başına okunmaz: ipucu, duyuru ve veri tablosu sayıyı söyler.
+ *
+ * Klavye: `←`/`→` sütun · `↑`/`↓` satır · `Home`/`End` ilk/son hücre · `Escape`.
+ */
+declare const Heatmap: ({ label, description, columns, rows, values, valueLabel, tone, height, width: fixedWidth, formatValue, className, testId, }: Props) => import("react").JSX.Element;
+declare const _default: typeof Heatmap;
+export default _default;

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

@@ -0,0 +1,29 @@
+import { type ValueFormat } from '../core/format';
+import { type ChartTone } from '../core/palette';
+type Props = {
+    label: string;
+    description?: string;
+    /** Ham gözlemler; bölmeleri bileşen hesaplar. Sonlu olmayan değerler atılır. */
+    values: readonly number[];
+    /** Hedef bölme sayısı; verilmezse Sturges. Sınırlar "güzel" adıma oturur, sayı yaklaşık. */
+    bins?: number;
+    /** Değişkenin adı (x ekseni, tablo). */
+    valueLabel: string;
+    /** Sıklığın adı ("Sipariş sayısı"). */
+    countLabel: string;
+    tone?: ChartTone;
+    height?: number;
+    width?: number;
+    formatValue?: ValueFormat;
+    className?: string;
+    testId?: string;
+};
+/**
+ * Histogram — tek değişkenin dağılımı. x ekseni SÜREKLİ (bölme sınırları), sütunlar bitişik.
+ * Bölme: `[alt, üst)`, son bölme üst ucu DAHİL eder (en büyük değer dışarıda kalmaz).
+ *
+ * Klavye: `←`/`→` önceki/sonraki bölme · `Home`/`End` · `Escape`.
+ */
+declare const Histogram: ({ label, description, values, bins: binCount, valueLabel, countLabel, tone, height, width: fixedWidth, formatValue, className, testId, }: Props) => import("react").JSX.Element;
+declare const _default: typeof Histogram;
+export default _default;

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

@@ -0,0 +1,14 @@
+import { type CartesianChartProps } from '../core/CartesianChart';
+import type { ChartSeries } from '../core/series';
+type Props = Omit<CartesianChartProps, 'series' | 'isStacked' | 'orientation'> & {
+    series: readonly ChartSeries[];
+};
+/**
+ * Çizgi grafiği — bir ya da daha çok serinin x boyunca değişimi. Sayısal x sürekli eksen, metin x
+ * kategorik eksen. `null` değer çizgiyi KESER (eksik veri sıfır değildir).
+ *
+ * Klavye: grafiğe sekmeyle gelinir · `←`/`→` önceki/sonraki x · `Home`/`End` · `Escape`.
+ */
+declare const LineChart: ({ series, ...rest }: Props) => import("react").JSX.Element;
+declare const _default: typeof LineChart;
+export default _default;

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,34 @@
+import type { PlotArea } from './types';
+export type Tick = {
+    /** Eksen boyunca konum (px). */
+    position: number;
+    label: string;
+};
+/** 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,79 @@
+/** KARTEZYEN GEOMETRİ — Çizgi, Alan, Çubuk ve Bileşik grafiğin ortak, saf (DOM'suz) motoru. */
+import { type Tick } from './axes';
+import type { ValueFormat } 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;
+    formatLeft: ValueFormat;
+    formatRight: ValueFormat;
+    /** 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,9 @@
+/** 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ölmesi: 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.
+ */
+export declare const compactNumber: (locale?: string) => ValueFormat;
+/** İ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İ — hanui 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;