tamga-ui 0.1.0

package/dist/components/live-scope.d.ts

@@ -0,0 +1,15 @@
+export declare function LiveScope({ children }: {
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Ask to pulse. Returns whether this element won.
+ *
+ * `severity === null` means the state does not qualify at all (healthy, silenced)
+ * and never enters the contest.
+ *
+ * With no LiveScope above it, the answer is yes: a lone beacon in a Storybook
+ * story has nothing to compete with, and a hook that returned false without a
+ * provider would make every story look broken.
+ */
+export declare function useLiveClaim(severity: number | null): boolean;
+//# sourceMappingURL=live-scope.d.ts.map

package/dist/components/live-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-scope.d.ts","sourceRoot":"","sources":["../../src/components/live-scope.tsx"],"names":[],"mappings":"AA0BA,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,+BAuCpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAe7D"}

package/dist/components/live-scope.js

@@ -0,0 +1,67 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useId, useMemo, useState, } from "react";
+const LiveContext = createContext(null);
+export function LiveScope({ children }) {
+    const [claims, setClaims] = useState({});
+    const claim = useCallback((id, severity) => {
+        setClaims((prev) => (prev[id] === severity ? prev : { ...prev, [id]: severity }));
+    }, []);
+    const release = useCallback((id) => {
+        setClaims((prev) => {
+            if (!(id in prev))
+                return prev;
+            const next = { ...prev };
+            delete next[id];
+            return next;
+        });
+    }, []);
+    const winner = useMemo(() => {
+        let best = null;
+        let bestSeverity = -Infinity;
+        /* Object key order is insertion order, and claims are registered in effect
+           order — which is tree order. So a strict `>` keeps the FIRST of equals,
+           and "first" means highest on the page. That is question 2's answer
+           (SETTLED 2026-08-19, Ercüment: first of equals wins), and it lives here
+           rather than in a doc nobody reads. The reasoning: the presence of the
+           signal matters more than which row carries it, and every alternative
+           (timestamp, domain priority) buys a nicer tie-break by making call sites
+           thread data they do not otherwise need. */
+        for (const [id, severity] of Object.entries(claims)) {
+            if (severity > bestSeverity) {
+                best = id;
+                bestSeverity = severity;
+            }
+        }
+        return best;
+    }, [claims]);
+    const value = useMemo(() => ({ claim, release, winner }), [claim, release, winner]);
+    return _jsx(LiveContext.Provider, { value: value, children: children });
+}
+/**
+ * Ask to pulse. Returns whether this element won.
+ *
+ * `severity === null` means the state does not qualify at all (healthy, silenced)
+ * and never enters the contest.
+ *
+ * With no LiveScope above it, the answer is yes: a lone beacon in a Storybook
+ * story has nothing to compete with, and a hook that returned false without a
+ * provider would make every story look broken.
+ */
+export function useLiveClaim(severity) {
+    const arbiter = useContext(LiveContext);
+    const id = useId();
+    useEffect(() => {
+        if (!arbiter || severity === null)
+            return;
+        arbiter.claim(id, severity);
+        return () => arbiter.release(id);
+        /* claim/release are stable; winner deliberately is not a dependency, or
+           every re-election would re-register and start another one */
+    }, [arbiter, id, severity]);
+    if (severity === null)
+        return false;
+    if (!arbiter)
+        return true;
+    return arbiter.winner === id;
+}

package/dist/components/log-view.d.ts

@@ -0,0 +1,34 @@
+import { type Tone } from "./tone.js";
+/**
+ * Log görüntüleyici.
+ *
+ * Gerekçe: docs/gerekce/02-veri-ve-liste.md
+ */
+export type LogLine = {
+    id: string;
+    /**
+     * Pre-formatted; the kit knows no time format. TR: Önceden biçimlendirilmiş; kit saat biçimi
+     * bilmez.
+     */
+    time?: string;
+    text: string;
+    tone?: Tone;
+};
+export declare function LogView({ lines, label, height, follow, wrap, className, }: {
+    lines: readonly LogLine[];
+    /**
+     * The region's name; it shows in the landmark list for keyboard navigation. TR: Bölgenin adı;
+     * klavyeyle gezinende landmark listesinde görünür.
+     */
+    label: string;
+    height?: number;
+    /** Scroll to the bottom when a new line arrives. TR: Yeni satır geldiğinde en alta kay. */
+    follow?: boolean;
+    /**
+     * Wrap long lines. Off, it scrolls horizontally. TR: Uzun satırları sar. Kapalıyken yatay
+     * kayar.
+     */
+    wrap?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=log-view.d.ts.map

package/dist/components/log-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-view.d.ts","sourceRoot":"","sources":["../../src/components/log-view.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;GAIG;AAEH,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAEF,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,KAAK,EACL,MAAY,EACZ,MAAa,EACb,IAAY,EACZ,SAAS,GACV,EAAE;IACD,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAmDA"}

package/dist/components/log-view.js

@@ -0,0 +1,30 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { cn } from "../lib/cn.js";
+import { toneOf } from "./tone.js";
+export function LogView({ lines, label, height = 320, follow = true, wrap = false, className, }) {
+    const box = useRef(null);
+    useEffect(() => {
+        if (!follow)
+            return;
+        const el = box.current;
+        if (!el)
+            return;
+        /* SADECE ZATEN ALTTAYSA kaydır. Yukarıda bir şey okuyan kişiyi aşağı
+           fırlatmak, bu bileşenin yapabileceği en can sıkıcı şey — ve "hep en
+           alta git" davranışının varsayılan olduğu her log görüntüleyicide
+           yaşanır. 32px'lik tolerans, tam altta olmayı beklemeden çalışsın diye. */
+        const atBottom = el.scrollHeight - el.scrollTop - el.clientHeight < 32;
+        if (atBottom)
+            el.scrollTop = el.scrollHeight;
+    }, [lines, follow]);
+    return (_jsx("div", { ref: box, className: cn("tamga-surface overflow-y-auto p-3 font-mono text-caption", className), style: { height }, 
+        /* `log` rolü: ekran okuyucu bunu bir günlük olarak tanır ve — kritik
+           olarak — `aria-live` OLMADAN sessiz kalır. Akan bir bölgeyi
+           duyurmak sesli okuyucuyu boğar; kullanıcı isterse kendisi okur. */
+        role: "log", "aria-label": label, tabIndex: 0, children: lines.map((l) => {
+            const c = l.tone ? toneOf(l.tone) : null;
+            return (_jsxs("div", { className: cn("flex gap-3 py-0.5", wrap ? "break-words" : "whitespace-nowrap"), children: [l.time ? (_jsx("span", { className: "w-20 shrink-0 text-ink-faint tabular-nums", children: l.time })) : null, _jsx("span", { className: "min-w-0", style: c ? { color: c.mark } : undefined, children: l.text })] }, l.id));
+        }) }));
+}

package/dist/components/number-input.d.ts

@@ -0,0 +1,26 @@
+/**
+ * NumberInput — fiyat, stok, ağırlık.
+ *
+ * Gerekçe: docs/gerekce/01-form-ve-girdi.md
+ */
+export declare function NumberInput({ value, onChange, min, max, step, 
+/** Değerin sonuna yapışan birim: "₺", "kg", "%" */
+suffix, disabled, invalid, full, 
+/** Artır/azalt düğmelerinin erişilebilir adları. Kit çeviri çekmez. */
+labels, className, }: {
+    value: number | null;
+    onChange?: (next: number | null) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    suffix?: string;
+    disabled?: boolean;
+    invalid?: boolean;
+    full?: boolean;
+    labels: {
+        increase: string;
+        decrease: string;
+    };
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=number-input.d.ts.map

package/dist/components/number-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-input.d.ts","sourceRoot":"","sources":["../../src/components/number-input.tsx"],"names":[],"mappings":"AAOA;;;;GAIG;AAEH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,GAAG,EACH,GAAG,EACH,IAAQ;AACR,mDAAmD;AACnD,MAAM,EACN,QAAgB,EAChB,OAAe,EACf,IAAY;AACZ,uEAAuE;AACvE,MAAM,EACN,SAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAoFA"}

package/dist/components/number-input.js

@@ -0,0 +1,57 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+import { cn } from "../lib/cn.js";
+import { Icon } from "./icon.js";
+import { CaretDown } from "./icons.js";
+/**
+ * NumberInput — fiyat, stok, ağırlık.
+ *
+ * Gerekçe: docs/gerekce/01-form-ve-girdi.md
+ */
+export function NumberInput({ value, onChange, min, max, step = 1, 
+/** Değerin sonuna yapışan birim: "₺", "kg", "%" */
+suffix, disabled = false, invalid = false, full = false, 
+/** Artır/azalt düğmelerinin erişilebilir adları. Kit çeviri çekmez. */
+labels, className, }) {
+    const id = useId();
+    const clamp = (n) => {
+        if (min !== undefined && n < min)
+            return min;
+        if (max !== undefined && n > max)
+            return max;
+        return n;
+    };
+    const bump = (dir) => {
+        if (disabled)
+            return;
+        const base = value ?? min ?? 0;
+        /* Kayan nokta toplamasının `0.1 + 0.2 = 0.30000000000000004` üretmesini
+           engellemek için adım hassasiyetinde yuvarlanıyor. */
+        const decimals = (String(step).split(".")[1] ?? "").length;
+        onChange?.(clamp(Number((base + dir * step).toFixed(decimals))));
+    };
+    const atMin = min !== undefined && value !== null && value <= min;
+    const atMax = max !== undefined && value !== null && value >= max;
+    return (_jsxs("span", { className: cn("relative inline-flex items-center", full && "w-full", className), children: [_jsx("input", { id: id, type: "text", inputMode: "decimal", value: value ?? "", disabled: disabled, "aria-invalid": invalid || undefined, onChange: (e) => {
+                    const raw = e.target.value.replace(",", ".").trim();
+                    if (raw === "")
+                        return onChange?.(null);
+                    const n = Number(raw);
+                    if (!Number.isNaN(n))
+                        onChange?.(n);
+                }, onBlur: () => value !== null && onChange?.(clamp(value)), onKeyDown: (e) => {
+                    if (e.key === "ArrowUp") {
+                        e.preventDefault();
+                        bump(1);
+                    }
+                    if (e.key === "ArrowDown") {
+                        e.preventDefault();
+                        bump(-1);
+                    }
+                }, 
+                /* Sağ boşluk spinner'ın genişliği (22px) artı kenar payı; birim varsa
+                   onun yeri de eklenir. Elle sayı yazmak yerine hesaplanıyor, çünkü
+                   birim "₺" da olabilir "adet" de. */
+                className: cn("tamga-input w-full tabular-nums", invalid && "tamga-input-invalid"), style: { paddingRight: suffix ? 76 : 32 } }), suffix ? (_jsx("span", { className: "pointer-events-none absolute right-8 font-mono text-small text-ink-faint", children: suffix })) : null, _jsxs("span", { className: "tamga-stepper", children: [_jsx("button", { type: "button", "aria-label": labels.increase, "aria-controls": id, disabled: disabled || atMax, onClick: () => bump(1), children: _jsx(Icon, { icon: CaretDown, size: "xs", className: "rotate-180" }) }), _jsx("button", { type: "button", "aria-label": labels.decrease, "aria-controls": id, disabled: disabled || atMin, onClick: () => bump(-1), children: _jsx(Icon, { icon: CaretDown, size: "xs" }) })] })] }));
+}

package/dist/components/overlay.d.ts

@@ -0,0 +1,257 @@
+import type { Tone } from "./tone.js";
+export type MenuItem = {
+    kind?: "item";
+    label: string;
+    icon?: React.ReactNode;
+    disabled?: boolean;
+    state?: Tone;
+    onSelect?: () => void;
+    /**
+     * The menu is a CHOICE, and this row is the one currently chosen.
+     *
+     * Set it and the row wears the kit's existing chosen treatment (`.tamga-option[data-selected]` —
+     * wash plus a left rule, the same one the Select overlay uses) and reports itself as
+     * `menuitemradio` / `aria-checked` instead of `menuitem`. Leave it undefined and the menu is
+     * a list of ACTIONS, which is what most menus are — a plain `menuitem` with no state to
+     * announce. The distinction is not decoration: a screen reader given six identical menu
+     * items has no way to learn which language it is already in.
+     */
+    checked?: boolean;
+} | {
+    kind: "separator";
+} | {
+    kind: "label";
+    label: string;
+};
+export declare function DropdownMenu({ trigger, items, align, width, loading, loadingRows, openOnHover, }: {
+    trigger: React.ReactNode;
+    items: MenuItem[];
+    align?: "start" | "end";
+    width?: number;
+    /**
+     * Opens when the pointer arrives, not only on click. TR: İşaretçi geldiğinde de açılır, yalnız
+     * tıklamayla değil.
+     *
+     * FOR A MENU THAT IS THE ONLY THING IN ITS CORNER: an account avatar, a toolbar overflow. There
+     * the hover costs nothing, because there is nothing beside it to open by accident.
+     *
+     * CLICK AND FOCUS STILL OPEN IT. Hover is an ADDITION, never the only way in: a touch screen
+     * has no hover at all, and a keyboard reaches the trigger by focus. A menu that opens only on
+     * hover is invisible to both. TR: Tıklama ve odak da açıyor. Hover bir EK, tek yol değil:
+     * dokunmatik ekranda hover diye bir şey yok, klavye tetikleyiciye odakla geliyor. Yalnız
+     * hover'da açılan bir menü ikisine de görünmez.
+     */
+    openOnHover?: boolean;
+    /**
+     * contents not in yet; the panel holds its shape instead of showing a spinner TR: içerik
+     * henüz gelmedi; panel bir dönen simge göstermek yerine şeklini koruyor
+     */
+    loading?: boolean;
+    /**
+     * How many skeleton rows to hold while `loading`. SETTLED 2026-08-19 (open question 4): this
+     * is never a taste value; it is the number of records that are actually coming, because the
+     * whole point of the skeleton is that the panel does not resize when they land. Where that
+     * number comes from (api-kontrati.html A7, KİLİTLİ): · paginated list → the request's
+     * `page_size` (DRF default 25, max 100) · last page → `meta.count - (page - 1) * page_size` ·
+     * cursor list → `page_size` (no `count` is returned, by design) · known-size menu → the item
+     * count the caller already knows The default of 4 fits a menu, not a list. A list that leaves
+     * it at 4 is a bug that looks like a design choice. TR: `loading` sürerken kaç iskelet satırı
+     * tutulacağı. 2026-08-19'da KARARA BAĞLANDI (açık soru 4): bu asla bir zevk değeri değil;
+     * gerçekten gelmekte olan kayıt sayısı, çünkü iskeletin bütün amacı kayıtlar geldiğinde
+     * panelin yeniden boyutlanmaması. O sayının nereden geldiği (api-kontrati.html A7, KİLİTLİ):
+     * · sayfalı liste → isteğin `page_size` değeri (DRF varsayılanı 25, en çok 100) · son sayfa →
+     * `meta.count - (page - 1) * page_size` · imleçli liste → `page_size` (tasarım gereği `count`
+     * dönmüyor) · boyu bilinen menü → çağıranın zaten bildiği öğe sayısı Varsayılan 4 bir menüye
+     * uyuyor, bir listeye değil. 4'te bırakılmış bir liste, tasarım kararı gibi görünen bir
+     * hatadır.
+     */
+    loadingRows?: number;
+}): import("react").JSX.Element;
+export declare function Popover({ trigger, title, children, footer, width, align, loading, loadingBlock, closeLabel, }: {
+    trigger: React.ReactNode;
+    title?: string;
+    /**
+     * Accessible name for the close control, supplied by the caller (docs/08 rule 5). TR: Kapatma
+     * kontrolünün erişilebilir adı, çağıran veriyor (docs/08 kural 5).
+     */
+    closeLabel: string;
+    children: React.ReactNode;
+    footer?: React.ReactNode;
+    width?: number;
+    align?: "start" | "end";
+    /**
+     * contents not in yet; the panel holds its shape instead of showing a spinner TR: içerik
+     * henüz gelmedi; panel bir dönen simge göstermek yerine şeklini koruyor
+     */
+    loading?: boolean;
+    /**
+     * height of a leading block, if the panel's real body opens with one TR: panelin gerçek
+     * gövdesi bir blokla açılıyorsa o baştaki bloğun yüksekliği
+     */
+    loadingBlock?: number;
+}): import("react").JSX.Element;
+declare const placements: {
+    readonly top: "bottom-[var(--overlay-above)] left-1/2 -translate-x-1/2";
+    readonly bottom: "top-[var(--overlay-below)] left-1/2 -translate-x-1/2";
+    readonly left: "right-[var(--overlay-below)] top-1/2 -translate-y-1/2";
+    readonly right: "left-[var(--overlay-below)] top-1/2 -translate-y-1/2";
+};
+/**
+ * KABARCIK `fixed`, `absolute` DEĞİL.
+ *
+ * Ölçülen hata: dar bir kenar çubuğunda ipucu hiç görünmüyordu. Sebep
+ * `overflow`du — menü kaydırılabilir olduğu için (`overflow-y: auto`, ki yatayı
+ * da `auto` yapıyor) ipucu doğuyor, çiziliyor ve kabın dışında kaldığı için
+ * tamamen kırpılıyordu. Bu, kitin üç kez karşılaştığı aynı tuzağın üçüncü yüzü
+ * (kart, ray, şimdi ipucu).
+ *
+ * Z-index çözmüyor: hiçbir yığın sırası bir `overflow` kırpmasını aşamaz.
+ * Çözüm kabarcığı akıştan çıkarmak. `fixed` bir eleman en yakın kaydırma
+ * kabına değil GÖRÜNTÜ ALANINA göre yerleşiyor, yani hiçbir kap onu kesemiyor.
+ *
+ * KONUM HOVER'DA ÖLÇÜLÜYOR, çünkü `fixed` bir elemanın CSS ile tetikleyiciye
+ * hizalanmasının yolu yok. Ölçüm yalnız ipucu açılırken yapılıyor: kapalıyken
+ * hiçbir maliyeti yok.
+ */
+export declare function Tooltip({ label, placement, children, }: {
+    label: string;
+    placement?: keyof typeof placements;
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+export type ToastTone = Tone;
+export declare function Toast({ tone, title, description, action, onDismiss, dismissLabel, }: {
+    tone?: ToastTone;
+    title: string;
+    description?: string;
+    action?: React.ReactNode;
+    onDismiss?: () => void;
+    /**
+     * Accessible name for the dismiss control, supplied by the caller (docs/08 rule 5). TR:
+     * Kapatma kontrolünün erişilebilir adı, çağıran veriyor (docs/08 kural 5).
+     */
+    dismissLabel: string;
+}): import("react").JSX.Element;
+/**
+ * Where toasts land. Top-right is the default: it is the one corner that
+ * never covers a table's actions column or a form's footer buttons.
+ */
+declare const corners: {
+    readonly "top-right": "top-6 right-6 items-end";
+    readonly "top-left": "top-6 left-6 items-start";
+    readonly "bottom-right": "bottom-6 right-6 items-end";
+    readonly "bottom-left": "bottom-6 left-6 items-start";
+};
+export declare function ToastViewport({ position, children, }: {
+    position?: keyof typeof corners;
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * The modal shell. Hooks cannot run behind an early return, so the trap lives
+ * here and the surface below stays a plain component.
+ */
+/**
+ * Diyalog genişliği. Bir VARYANT, ayrı bir bileşen değil (kitin kuralı: adı
+ * bölünen şey bileşen, ayarlanan şey prop).
+ *
+ * `wide` bir ÖNİZLEME için var: bir bloğu ya da tam bir ekran şablonunu 448
+ * pikselde göstermek, gösterdiğini gizlemek olur. `md` hâlâ varsayılan, çünkü
+ * bir diyaloğun asıl işi bir KARAR sormak ve geniş bir karar kutusu, kararı
+ * daha kolay yapmıyor.
+ *
+ * `full` BİR ÇALIŞMA YÜZEYİ için: bir görsel düzenleyici, bir tuval, bir harita
+ * seçici. Bunlar bir karar kutusu değil bir EKRAN, ve `wide` bile onlara az
+ * geliyor — kalan kenar boşluğu tuvalden çalınan alan. Bu boyutta panelin
+ * kenarı, yarıçapı ve kaydırma gölgesi de kalkıyor: yükseltilecek bir zemin
+ * kalmadığında yükselme işareti de anlamsız. Nadir olması gerekiyor; bir formu
+ * tam ekran açmak, formu daha kolay doldurmuyor.
+ */
+declare const DIALOG_GENISLIK: {
+    readonly md: "max-w-md";
+    readonly lg: "max-w-3xl";
+    readonly wide: "max-w-(--dialog-wide)";
+    readonly full: "max-w-none";
+};
+export type DialogSize = keyof typeof DIALOG_GENISLIK;
+/**
+ * Yıkıcı bir eylemin önündeki kapı.
+ *
+ * NEDEN AYRI BİR BİLEŞEN. `Dialog` zaten var ve bu onun üstüne kurulu; ama
+ * "emin misin" diyaloğu her seferinde elle kurulduğunda üç şey kayıyor ve
+ * üçü de güvenlikle ilgili:
+ *
+ *   1. ONAY DÜĞMESİ FİİLİ TAŞIR, "Tamam"ı değil. Bir kullanıcı diyaloğun
+ *      metnini okumadan düğmeye basar; okuduğu tek şey düğmenin üstündeki
+ *      kelimedir. "Tamam" hiçbir şey söylemez, "Sil" söyler.
+ *   2. ODAK VAZGEÇ'TE AÇILIR. Yıkıcı bir diyalogda odağın onay düğmesinde
+ *      olması, Enter'a basan birinin kaydı silmesi demek. Güvenli olan
+ *      varsayılan olmalı.
+ *   3. GERİ ALINAMAZLIK YAZILIR. Gövde metni ne olacağını değil NEYİN GERİ
+ *      GELMEYECEĞİNİ söyler; kullanıcının kararı buna bağlı.
+ *
+ * KELİMELER ÇAĞIRANIN. Kit hiçbir dil bilmiyor: başlık, gövde ve iki düğmenin
+ * etiketi dışarıdan geliyor.
+ */
+export declare function ConfirmDialog({ open, onClose, onConfirm, title, children, confirmLabel, cancelLabel, closeLabel, tone, busy, confirmDisabled, }: {
+    open: boolean;
+    onClose: () => void;
+    onConfirm: () => void;
+    title: string;
+    children: React.ReactNode;
+    /**
+     * The VERB of the thing that will happen: "Delete", "Unpublish". Never "OK". TR: Yapılacak
+     * işin FİİLİ: "Sil", "Yayından kaldır". Asla "Tamam".
+     */
+    confirmLabel: string;
+    cancelLabel: string;
+    closeLabel: string;
+    /**
+     * `danger` an irreversible loss, `primary` a step that only asks for attention. TR: `danger`
+     * geri alınamaz bir kayıp, `primary` yalnızca dikkat isteyen bir adım.
+     */
+    tone?: "danger" | "primary";
+    /**
+     * While the operation runs: both buttons lock, so nothing is submitted twice. TR: İşlem
+     * sürerken: iki düğme de kilitleniyor, çift gönderim olmuyor.
+     */
+    busy?: boolean;
+    /**
+     * Disables the confirm button: the dialog OPENS but the action cannot be taken. WHY IT IS
+     * NEEDED. Some destructive actions have a precondition ("a customer with orders cannot be
+     * deleted") and that condition is only known by looking at the record. There are two ways:
+     * let the click through and take an error from the server, or write the rule in the dialog
+     * and close the confirm. The second does not spend the user's time and TEACHES the rule. The
+     * body text has to say the reason; a disabled button is not a reason on its own. TR: Onay
+     * düğmesini kapatır: diyalog AÇILIR ama işlem yapılamaz. NEDEN GEREKLİ. Bazı yıkıcı
+     * işlemlerin bir ön koşulu var ("siparişi olan müşteri silinemez") ve o koşul ancak kayda
+     * bakınca bilinir. İki yol var: düğmeyi tıklatıp sunucudan hata almak, ya da kuralı diyalogda
+     * yazıp onayı kapatmak. İkincisi kullanıcının zamanını almıyor ve kuralı ÖĞRETİYOR. Gövde
+     * metni sebebi söylemek zorunda; kapalı bir düğme tek başına sebep değildir.
+     */
+    confirmDisabled?: boolean;
+}): import("react").JSX.Element;
+export declare function Dialog({ open, onClose, title, children, footer, loading, closeLabel, size, }: {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    children: React.ReactNode;
+    footer?: React.ReactNode;
+    /**
+     * contents not in yet; the panel holds its shape instead of showing a spinner TR: içerik
+     * henüz gelmedi; panel bir dönen simge göstermek yerine şeklini koruyor
+     */
+    loading?: boolean;
+    /**
+     * Accessible name for the close control, supplied by the caller (docs/08 rule 5). TR: Kapatma
+     * kontrolünün erişilebilir adı, çağıran veriyor (docs/08 kural 5).
+     */
+    closeLabel: string;
+    /**
+     * `md` decides, `lg` decides with a table beside it, `wide` previews a whole screen, `full` is a
+     * work surface (an image editor, a canvas). TR: `md` karar sorar, `lg` kararın yanında bir tablo
+     * taşır, `wide` tam bir ekranı önizler, `full` ise bir çalışma yüzeyidir (görsel düzenleyici,
+     * tuval).
+     */
+    size?: DialogSize;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=overlay.d.ts.map

package/dist/components/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/components/overlay.tsx"],"names":[],"mappings":"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"}